Deployment Stacks - List At Management Group

Service:: Resource Management

API-versie:: 2022-08-01-preview

Geeft een lijst met implementatiestacks binnen het opgegeven bereik.

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/{managementGroupId}/providers/Microsoft.Resources/deploymentStacks?api-version=2022-08-01-preview

URI-parameters

Name	In	Vereist	Type	Description
managementGroupId	path	True	string minLength: 1	De id van de beheergroep.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	DeploymentStackListResult	Azure-bewerking is voltooid.
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

List management group Deployment stacks

Voorbeeldaanvraag

HTTP

GET https://management.azure.com/providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks?api-version=2022-08-01-preview

Voorbeeldrespons

Statuscode:: 200

{
  "value": [
    {
      "id": "/providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks/simpleDeploymentStack",
      "type": "Microsoft.Resources/deploymentStacks",
      "name": "simpleDeploymentStack",
      "location": "eastus",
      "tags": {
        "tagkey": "tagVal"
      },
      "systemData": {
        "createdBy": "string",
        "createdByType": "Application",
        "createdAt": "2020-02-01T01:01:01.1075056Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "Application",
        "lastModifiedAt": "2020-02-02T02:03:01.1974346Z"
      },
      "properties": {
        "actionOnUnmanage": {
          "resources": "delete",
          "resourceGroups": "delete",
          "managementGroups": "detach"
        },
        "denySettings": {
          "mode": "denyDelete",
          "excludedPrincipals": [
            "principal"
          ],
          "excludedActions": [
            "action"
          ],
          "applyToChildScopes": false
        },
        "parameters": {
          "parameter1": {
            "value": "a string"
          }
        },
        "outputs": {
          "myOut": "myVal"
        },
        "duration": "PT1D12H"
      }
    },
    {
      "id": "/providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deploymentStacks/simpleDeploymentStack2",
      "type": "Microsoft.Resources/deploymentStacks",
      "name": "simpleDeploymentStack2",
      "location": "eastus",
      "tags": {
        "tagkey": "tagVal"
      },
      "systemData": {
        "createdBy": "string",
        "createdByType": "Application",
        "createdAt": "2020-02-01T01:01:01.1075056Z",
        "lastModifiedBy": "string",
        "lastModifiedByType": "Application",
        "lastModifiedAt": "2020-02-02T02:03:01.1974346Z"
      },
      "properties": {
        "deploymentId": "/providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/deployments/simpleDeploymentStack2-20210301-3f41c",
        "provisioningState": "SucceededWithFailures",
        "resources": [
          {
            "id": "/providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Resources/templateSpecs/templateSpec/versions/1.0",
            "status": "managed",
            "denyStatus": "denyDelete"
          },
          {
            "id": "/providers/Microsoft.Management/managementGroups/myMg/providers/Microsoft.Storage/storageAccounts/myStorageAccount",
            "status": "managed",
            "denyStatus": "denyDelete"
          }
        ],
        "actionOnUnmanage": {
          "resources": "delete",
          "resourceGroups": "delete",
          "managementGroups": "detach"
        },
        "denySettings": {
          "mode": "denyDelete",
          "excludedPrincipals": [
            "principal"
          ],
          "excludedActions": [
            "action"
          ],
          "applyToChildScopes": false
        },
        "parameters": {
          "parameter1": {
            "value": "a string"
          }
        },
        "outputs": {
          "myOut": "myVal"
        },
        "duration": "PT1D12H"
      }
    }
  ]
}

Definities

Name	Description
ActionOnUnmanage	Definieert het gedrag van resources die niet meer worden beheerd nadat de stack is bijgewerkt of verwijderd.
createdByType	Het type identiteit waarmee de resource is gemaakt.
DenySettings	Hiermee definieert u hoe resources die door de implementatiestack worden geïmplementeerd, worden vergrendeld.
DenySettingsMode	denySettings-modus die geweigerde acties definieert.
DenyStatusMode	denyAssignment-instellingen die zijn toegepast op de resource.
DeploymentParameter	Implementatieparameter voor de sjabloon.
DeploymentStack	Implementatiestackobject.
DeploymentStackListResult	Het antwoord van een DeploymentStack-lijstbewerking.
DeploymentStackProvisioningState	Status van de implementatiestack.
DeploymentStacksDebugSetting	De instelling voor foutopsporing.
DeploymentStacksParametersLink	Entiteit die de verwijzing naar de implementatieparameters vertegenwoordigt.
DeploymentStacksTemplateLink	Entiteit die de verwijzing naar de sjabloon vertegenwoordigt.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
KeyVaultParameterReference	Azure Key Vault parameterverwijzing.
KeyVaultReference	Azure Key Vault-referentie.
ManagedResourceReference	Het beheerde resourcemodel.
ResourceReference	Het resourceId-model.
ResourceReferenceExtended	Het uitgebreide resourceId-model. Dit wordt gebruikt om mislukte resources te documenteren met een resourceId en een bijbehorende fout.
ResourceStatusMode	Huidige beheerstatus van de resource in de implementatiestack.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
UnmanageActionManagementGroupMode	Hiermee geeft u een actie op voor een nieuwe niet-beheerde resource.
UnmanageActionResourceGroupMode	Specificeert een actie voor een nieuw niet-beheerde resourcegroep.
UnmanageActionResourceMode	Hiermee geeft u een actie op voor een nieuwe niet-beheerde resource.

ActionOnUnmanage

Object

Definieert het gedrag van resources die niet meer worden beheerd nadat de stack is bijgewerkt of verwijderd.

Name	Type	Description
managementGroups	UnmanageActionManagementGroupMode	Specificeert een actie voor een nieuw niet-beheerde resource managementgroep.
resourceGroups	UnmanageActionResourceGroupMode	Specificeert een actie voor een nieuw niet-beheerde resourcegroep.
resources	UnmanageActionResourceMode	Hiermee geeft u een actie op voor een nieuwe niet-beheerde resource.

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

DenySettings

Object

Hiermee definieert u hoe resources die door de implementatiestack worden geïmplementeerd, worden vergrendeld.

Name	Type	Description
applyToChildScopes	boolean	DenySettings wordt toegepast op onderliggende resourcebereiken van elke beheerde resource met een weigeringstoewijzing.
excludedActions	string[]	Lijst met beheerbewerkingen op basis van rollen die zijn uitgesloten van denySettings. Maximaal 200 acties zijn toegestaan. Als de denySetting-modus is ingesteld op denyWriteAndDelete, worden de volgende acties automatisch toegevoegd aan 'excludedActions': '*/read' en 'Microsoft.Authorization/locks/delete'. Als de denySetting-modus is ingesteld op DenyDelete, worden de volgende acties automatisch toegevoegd aan 'excludedActions': 'Microsoft.Authorization/locks/delete'. Dubbele acties worden verwijderd.
excludedPrincipals	string[]	Lijst met AAD-principal-id's die zijn uitgesloten van de vergrendeling. Maximaal 5 principals zijn toegestaan.
mode	DenySettingsMode	denySettings-modus die geweigerde acties definieert.

DenySettingsMode

Opsomming

denySettings-modus die geweigerde acties definieert.

Waarde	Description
denyDelete	Geautoriseerde gebruikers kunnen de resources lezen en wijzigen, maar kunnen ze niet verwijderen.
denyWriteAndDelete	Geautoriseerde gebruikers kunnen lezen uit een bron, maar kunnen deze niet wijzigen of verwijderen.
none	Er zijn geen denyAssignments toegepast.

DenyStatusMode

Opsomming

denyAssignment-instellingen die zijn toegepast op de resource.

Waarde	Description
denyDelete	Geautoriseerde gebruikers kunnen de resources lezen en wijzigen, maar kunnen ze niet verwijderen.
notSupported	Resourcetype biedt geen ondersteuning voor denyAssignments.
inapplicable	denyAssignments worden niet ondersteund voor resources buiten het bereik van de implementatiestack.
denyWriteAndDelete	Geautoriseerde gebruikers kunnen alleen lezen uit een resource, maar kunnen deze niet wijzigen of verwijderen.
removedBySystem	Toewijzing weigeren is verwijderd door Azure vanwege een wijziging in resourcebeheer (verplaatsing van beheergroep, enzovoort)
none	Er zijn geen denyAssignments toegepast.

DeploymentParameter

Object

Implementatieparameter voor de sjabloon.

Name	Type	Description
reference	KeyVaultParameterReference	Azure Key Vault parameterverwijzing.
type	string	Type van de waarde.
value		Voer de waarde in voor de parameter.

DeploymentStack

Object

Implementatiestackobject.

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
location	string	De geolocatie waar de bron zich bevindt. Vereist voor stacks met een bereik van abonnementen en beheergroepen. De locatie wordt overgenomen van de resourcegroep voor stacks met resourcegroepbereik.
name	string	De naam van de resource
properties.actionOnUnmanage	ActionOnUnmanage	Definieert het gedrag van resources die niet meer worden beheerd nadat de implementatiestack is bijgewerkt of verwijderd.
properties.debugSetting	DeploymentStacksDebugSetting	De foutopsporingsinstelling van de implementatie.
properties.deletedResources	ResourceReference[]	Een matrix met resources die zijn verwijderd tijdens de meest recente update van de implementatiestack. Verwijderd betekent dat de bron uit de sjabloon is verwijderd en dat relevante verwijderingsbewerkingen zijn opgegeven.
properties.denySettings	DenySettings	Definieert hoe resources die door de stack zijn geïmplementeerd, zijn vergrendeld.
properties.deploymentId	string	De resourceId van de implementatieresource die is gemaakt door de implementatiestack.
properties.deploymentScope	string	Het bereik waarop de eerste implementatie moet worden gemaakt. Als er geen bereik is opgegeven, wordt standaard het bereik van de implementatiestack gebruikt. Geldige bereiken zijn: beheergroep (indeling: /providers/Microsoft.Management/managementGroups/{managementGroupId}), abonnement (indeling: '/subscriptions/{subscriptionId}'), resourcegroep (indeling: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}').
properties.description	string maxLength: 4096	Beschrijving van implementatiestack. Maximale lengte van 4096 tekens.
properties.detachedResources	ResourceReference[]	Een matrix met resources die zijn losgekoppeld tijdens de meest recente update van de implementatiestack. Losgekoppeld betekent dat de bron uit de sjabloon is verwijderd, maar dat er geen relevante verwijderingsbewerkingen zijn opgegeven. De resource bestaat dus nog steeds, maar is niet meer gekoppeld aan de stack.
properties.duration	string	De duur van de laatste geslaagde update van de implementatiestack.
properties.error	ErrorDetail	De foutdetails.
properties.failedResources	ResourceReferenceExtended[]	Een matrix met resources die de doelstatus niet bereikt tijdens de meest recente update. Elke resourceId gaat vergezeld van een foutmelding.
properties.outputs		De uitvoer van de implementatieresource die door de implementatiestack is gemaakt.
properties.parameters	<string, DeploymentParameter>	Naam- en waardeparen waarmee de implementatieparameters voor de sjabloon worden gedefinieerd. Gebruik dit element wanneer u de parameterwaarden rechtstreeks in de aanvraag opgeeft in plaats van een koppeling naar een bestaand parameterbestand. Gebruik de eigenschap parametersLink of de parametereigenschap, maar niet beide.
properties.parametersLink	DeploymentStacksParametersLink	De URI van het parameterbestand. Gebruik dit element om een koppeling te maken naar een bestaand parameterbestand. Gebruik de eigenschap parametersLink of de parametereigenschap, maar niet beide.
properties.provisioningState	DeploymentStackProvisioningState	Status van de implementatiestack.
properties.resources	ManagedResourceReference[]	Een matrix met resources die momenteel worden beheerd door de implementatiestack.
properties.template		De sjablooninhoud. U gebruikt dit element als u de syntaxis van de sjabloon rechtstreeks in de aanvraag wilt doorgeven in plaats van een koppeling naar een bestaande sjabloon. Dit kan een JObject of een goed opgemaakte JSON-tekenreeks zijn. Gebruik de eigenschap templateLink of de sjablooneigenschap, maar niet beide.
properties.templateLink	DeploymentStacksTemplateLink	De URI van de sjabloon. Gebruik de eigenschap templateLink of de sjablooneigenschap, maar niet beide.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object	Resourcetags.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

DeploymentStackListResult

Object

Het antwoord van een DeploymentStack-lijstbewerking.

Name	Type	Description
nextLink	string (uri)	De link naar de volgende pagina met items
value	DeploymentStack[]	De DeploymentStack-items op deze pagina

DeploymentStackProvisioningState

Opsomming

Status van de implementatiestack.

Waarde	Description
creating	De implementatiestack wordt momenteel gemaakt
validating	De implementatiestack wordt momenteel gevalideerd
waiting	De implementatiestack wacht momenteel op
deploying	De implementatiestack wordt momenteel geïmplementeerd
canceling	De implementatiestack wordt geannuleerd
updatingDenyAssignments	De implementatiestack wordt bijgewerkt om opdrachten weigeren
deletingResources	De implementatiestack verwijdert resources
succeeded	De implementatiestack is voltooid
failed	De implementatiestack is mislukt
canceled	De implementatiestack is geannuleerd
deleting	De implementatiestack wordt verwijderd

DeploymentStacksDebugSetting

Object

De instelling voor foutopsporing.

Name	Type	Description
detailLevel	string	Hiermee geeft u het type informatie op dat moet worden vastgelegd voor foutopsporing. De toegestane waarden zijn geen, requestContent, responseContent of zowel requestContent als responseContent, gescheiden door een komma. De standaardwaarde is geen. Houd bij het instellen van deze waarde zorgvuldig rekening met het type informatie dat wordt doorgegeven tijdens de implementatie. Door informatie over de aanvraag of het antwoord te registreren, kunnen gevoelige gegevens die worden opgehaald via de implementatiebewerkingen mogelijk worden weergegeven.

DeploymentStacksParametersLink

Object

Entiteit die de verwijzing naar de implementatieparameters vertegenwoordigt.

Name	Type	Description
contentVersion	string	Indien opgenomen, moet deze overeenkomen met de ContentVersion in de sjabloon.
uri	string	De URI van het parameterbestand.

DeploymentStacksTemplateLink

Object

Entiteit die de verwijzing naar de sjabloon vertegenwoordigt.

Name	Type	Description
contentVersion	string	Indien opgenomen, moet deze overeenkomen met de ContentVersion in de sjabloon.
id	string	De resourceId van een sjabloonspecificatie. Gebruik de eigenschap id of uri, maar niet beide.
queryString	string	De querytekenreeks (bijvoorbeeld een SAS-token) die moet worden gebruikt met de templateLink-URI.
relativePath	string	De relatievePath-eigenschap kan worden gebruikt om een gekoppelde sjabloon te implementeren op een locatie ten opzichte van het bovenliggende item. Als de bovenliggende sjabloon is gekoppeld aan een TemplateSpec, verwijst dit naar een artefact in de TemplateSpec. Als de bovenliggende URI is gekoppeld aan een URI, is de onderliggende implementatie een combinatie van de bovenliggende en relatieve Path-URI's.
uri	string	De URI van de sjabloon die moet worden geïmplementeerd. Gebruik de eigenschap URI of id, maar niet beide.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

KeyVaultParameterReference

Object

Azure Key Vault parameterverwijzing.

Name	Type	Description
keyVault	KeyVaultReference	Azure Key Vault-referentie.
secretName	string	Geheime naam van Azure Key Vault.
secretVersion	string	Geheime versie van Azure Key Vault.

KeyVaultReference

Object

Azure Key Vault-referentie.

Name	Type	Description
id	string	Azure Key Vault-resourceId.

ManagedResourceReference

Object

Het beheerde resourcemodel.

Name	Type	Default value	Description
denyStatus	DenyStatusMode	none	denyAssignment-instellingen die zijn toegepast op de resource.
id	string		De ARM-resource-id van een resource die wordt beheerd door de implementatiestack.
status	ResourceStatusMode	none	Huidige beheerstatus van de resource in de implementatiestack.

ResourceReference

Object

Het resourceId-model.

Name	Type	Description
id	string	De ARM-resource-id van een resource die wordt beheerd door de implementatiestack.

ResourceReferenceExtended

Object

Het uitgebreide resourceId-model. Dit wordt gebruikt om mislukte resources te documenteren met een resourceId en een bijbehorende fout.

Name	Type	Description
error	ErrorDetail	De foutdetails.
id	string	De ARM-resource-id van een resource die wordt beheerd door de implementatiestack.

ResourceStatusMode

Opsomming

Huidige beheerstatus van de resource in de implementatiestack.

Waarde	Description
managed	Deze resource wordt beheerd door de implementatiestack.
removeDenyFailed	Kan de weigeringstoewijzing voor de resource niet verwijderen.
deleteFailed	Kan de resource niet verwijderen uit Azure. De verwijdering wordt opnieuw uitgevoerd bij de volgende stackimplementatie of kan handmatig worden verwijderd.
none	Geen managementstatus.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UnmanageActionManagementGroupMode

Opsomming

Hiermee geeft u een actie op voor een nieuwe niet-beheerde resource.

Waarde	Description
delete	Verwijder de beheergroepen uit Azure.
detach	Houd de beheergroepen in Azure.

UnmanageActionResourceGroupMode

Opsomming

Specificeert een actie voor een nieuw niet-beheerde resourcegroep.

Waarde	Description
delete	Verwijder de resourcegroepen uit Azure.
detach	Houd de resourcegroepen in Azure.

UnmanageActionResourceMode

Opsomming

Hiermee geeft u een actie op voor een nieuwe niet-beheerde resource.

Waarde	Description
delete	Verwijder de resources uit Azure
detach	Bewaar de resources in Azure

Delen via

Deployment Stacks - List At Management Group

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

List management group Deployment stacks

Voorbeeldaanvraag

Voorbeeldrespons

Definities

ActionOnUnmanage

createdByType

DenySettings

DenySettingsMode

DenyStatusMode

DeploymentParameter

DeploymentStack

DeploymentStackListResult

DeploymentStackProvisioningState

DeploymentStacksDebugSetting

DeploymentStacksParametersLink

DeploymentStacksTemplateLink

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

KeyVaultParameterReference

KeyVaultReference

ManagedResourceReference

ResourceReference

ResourceReferenceExtended

ResourceStatusMode

systemData

UnmanageActionManagementGroupMode

UnmanageActionResourceGroupMode

UnmanageActionResourceMode