Deployment Stacks - List At Management Group

Servicio:: Resource Management

Versión de la API:: 2022-08-01-preview

Enumera las pilas de implementación en el ámbito especificado.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
managementGroupId	path	True	string minLength: 1	Identificador del grupo de administración.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	DeploymentStackListResult	La operación de Azure se completó correctamente.
Other Status Codes	ErrorResponse	Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	Suplantar su cuenta de usuario

Ejemplos

List management group Deployment stacks

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 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"
      }
    }
  ]
}

Definiciones

Nombre	Description
ActionOnUnmanage	Define el comportamiento de los recursos que ya no se administran después de actualizar o eliminar la pila.
createdByType	Tipo de identidad que creó el recurso.
DenySettings	Define cómo se bloquean los recursos implementados por la pila de implementación.
DenySettingsMode	denySettings Modo que define acciones denegadas.
DenyStatusMode	denyAssignment configuración aplicada al recurso.
DeploymentParameter	Parámetro de implementación de la plantilla.
DeploymentStack	Objeto de pila de implementación.
DeploymentStackListResult	Respuesta de una operación de lista DeploymentStack.
DeploymentStackProvisioningState	Estado de la pila de implementación.
DeploymentStacksDebugSetting	Configuración de depuración.
DeploymentStacksParametersLink	Entidad que representa la referencia a los parámetros de implementación.
DeploymentStacksTemplateLink	Entidad que representa la referencia a la plantilla.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
KeyVaultParameterReference	Referencia de parámetros de Azure Key Vault.
KeyVaultReference	Referencia de Azure Key Vault.
ManagedResourceReference	Modelo de recursos administrados.
ResourceReference	El modelo resourceId.
ResourceReferenceExtended	El modelo extendido resourceId. Esto se usa para documentar recursos con errores con un resourceId y un error correspondiente.
ResourceStatusMode	Estado de administración actual del recurso en la pila de implementación.
systemData	Metadatos relativos a la creación y última modificación del recurso.
UnmanageActionManagementGroupMode	Especifica una acción para un recurso recién no administrado.
UnmanageActionResourceGroupMode	Especifica una acción para un grupo de recursos recién no gestionado.
UnmanageActionResourceMode	Especifica una acción para un recurso recién no administrado.

ActionOnUnmanage

Objeto

Define el comportamiento de los recursos que ya no se administran después de actualizar o eliminar la pila.

Nombre	Tipo	Description
managementGroups	UnmanageActionManagementGroupMode	Especifica una acción para un grupo de gestión de recursos recién no gestionado.
resourceGroups	UnmanageActionResourceGroupMode	Especifica una acción para un grupo de recursos recién no gestionado.
resources	UnmanageActionResourceMode	Especifica una acción para un recurso recién no administrado.

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DenySettings

Objeto

Define cómo se bloquean los recursos implementados por la pila de implementación.

Nombre	Tipo	Description
applyToChildScopes	boolean	DenySettings se aplicará a los ámbitos de recursos secundarios de cada recurso administrado con una asignación de denegación.
excludedActions	string[]	Lista de operaciones de administración basadas en roles que se excluyen de denySettings. Se permiten hasta 200 acciones. Si el modo denySetting se establece en "denyWriteAndDelete", las siguientes acciones se anexan automáticamente a "excludedActions": "*/read" y "Microsoft.Authorization/locks/delete". Si el modo denySetting se establece en "denyDelete", las siguientes acciones se anexan automáticamente a "excludedActions": "Microsoft.Authorization/locks/delete". Se quitarán las acciones duplicadas.
excludedPrincipals	string[]	Lista de identificadores de entidad de seguridad de AAD excluidos del bloqueo. Se permiten hasta 5 entidades de seguridad.
mode	DenySettingsMode	denySettings Modo que define acciones denegadas.

DenySettingsMode

Enumeración

denySettings Modo que define acciones denegadas.

Valor	Description
denyDelete	Los usuarios autorizados pueden leer y modificar los recursos, pero no se pueden eliminar.
denyWriteAndDelete	Los usuarios autorizados pueden leer desde un recurso, pero no pueden modificarlo ni eliminarlo.
none	No se ha aplicado denyAssignments.

DenyStatusMode

Enumeración

denyAssignment configuración aplicada al recurso.

Valor	Description
denyDelete	Los usuarios autorizados pueden leer y modificar los recursos, pero no se pueden eliminar.
notSupported	El tipo de recurso no admite denyAssignments.
inapplicable	denyAssignments no se admite en recursos fuera del ámbito de la pila de implementación.
denyWriteAndDelete	Los usuarios autorizados solo pueden leer desde un recurso, pero no pueden modificarlo ni eliminarlo.
removedBySystem	Azure ha quitado la asignación de denegación debido a un cambio de administración de recursos (movimiento de grupo de administración, etc.)
none	No se ha aplicado denyAssignments.

DeploymentParameter

Objeto

Parámetro de implementación de la plantilla.

Nombre	Tipo	Description
reference	KeyVaultParameterReference	Referencia de parámetros de Azure Key Vault.
type	string	Tipo del valor.
value		Valor de entrada del parámetro.

DeploymentStack

Objeto

Objeto de pila de implementación.

Nombre	Tipo	Description
id	string (arm-id)	Identificador de recurso completo para el recurso. Por ejemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	La ubicación geográfica donde reside el recurso. Necesario para las pilas de ámbito de suscripción y grupo de administración. La ubicación se hereda del grupo de recursos para las pilas con ámbito de grupo de recursos.
name	string	Nombre del recurso
properties.actionOnUnmanage	ActionOnUnmanage	Define el comportamiento de los recursos que ya no se administran después de actualizar o eliminar la pila de implementación.
properties.debugSetting	DeploymentStacksDebugSetting	Configuración de depuración de la implementación.
properties.deletedResources	ResourceReference[]	Matriz de recursos que se eliminaron durante la actualización de la pila de implementación más reciente. Eliminado significa que el recurso se eliminó de la plantilla y se especificaron las operaciones de eliminación pertinentes.
properties.denySettings	DenySettings	Define cómo se bloquean los recursos implementados por la pila.
properties.deploymentId	string	ResourceId del recurso de implementación creado por la pila de implementación.
properties.deploymentScope	string	Ámbito en el que se debe crear la implementación inicial. Si no se especifica un ámbito, el valor predeterminado será el ámbito de la pila de implementación. Los ámbitos válidos son: grupo de administración (formato: '/providers/Microsoft.Management/managementGroups/{managementGroupId}'), suscripción (formato: '/subscriptions/{subscriptionId}'), grupo de recursos (formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}').
properties.description	string maxLength: 4096	Descripción de la pila de implementación. Longitud máxima de 4096 caracteres.
properties.detachedResources	ResourceReference[]	Una matriz de recursos que se desasociaron durante la actualización de la pila de implementación más reciente. Desasociado significa que el recurso se quitó de la plantilla, pero no se especificaron operaciones de eliminación relevantes. Por lo tanto, el recurso sigue existiendo mientras ya no esté asociado con la pila.
properties.duration	string	La duración de la última actualización correcta de la pila de implementación.
properties.error	ErrorDetail	Detalle del error.
properties.failedResources	ResourceReferenceExtended[]	Matriz de recursos que no pudieron alcanzar el estado objetivo durante la actualización más reciente. Cada resourceId va acompañado de un mensaje de error.
properties.outputs		Las salidas del recurso de implementación creado por la pila de implementación.
properties.parameters	<string, DeploymentParameter>	Pares de nombre y valor que definen los parámetros de implementación de la plantilla. Use este elemento al proporcionar los valores de parámetro directamente en la solicitud, en lugar de vincular a un archivo de parámetros existente. Use la propiedad parametersLink o la propiedad parameters, pero no ambas.
properties.parametersLink	DeploymentStacksParametersLink	Identificador URI del archivo de parámetros. Use este elemento para vincular a un archivo de parámetros existente. Use la propiedad parametersLink o la propiedad parameters, pero no ambas.
properties.provisioningState	DeploymentStackProvisioningState	Estado de la pila de implementación.
properties.resources	ManagedResourceReference[]	Matriz de recursos administrados actualmente por la pila de implementación.
properties.template		El contenido de la plantilla. Este elemento se usa cuando desea pasar la sintaxis de plantilla directamente en la solicitud en lugar de vincular a una plantilla existente. Puede ser una cadena JSON con formato correcto o JObject. Use la propiedad templateLink o la propiedad template, pero no ambas.
properties.templateLink	DeploymentStacksTemplateLink	Identificador URI de la plantilla. Use la propiedad templateLink o la propiedad template, pero no ambas.
systemData	systemData	Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object	Etiquetas de recursos.
type	string	Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

DeploymentStackListResult

Objeto

Respuesta de una operación de lista DeploymentStack.

Nombre	Tipo	Description
nextLink	string (uri)	El enlace a la siguiente página de artículos
value	DeploymentStack[]	Los elementos de DeploymentStack de esta página

DeploymentStackProvisioningState

Enumeración

Estado de la pila de implementación.

Valor	Description
creating	La pila de implementación se está creando actualmente
validating	La pila de implementación se está validando actualmente
waiting	La pila de implementación está esperando actualmente
deploying	La pila de implementación se está implementando actualmente
canceling	La pila de implementación se está cancelando
updatingDenyAssignments	La pila de implementación está actualizando las asignaciones de denegación
deletingResources	La pila de implementación está eliminando recursos
succeeded	La pila de implementación se completó correctamente
failed	Se ha producido un error en la pila de implementación
canceled	Se ha cancelado la pila de implementación
deleting	La pila de implementación se está eliminando

DeploymentStacksDebugSetting

Objeto

Configuración de depuración.

Nombre	Tipo	Description
detailLevel	string	Especifica el tipo de información que se va a registrar para la depuración. Los valores permitidos no son ninguno, requestContent, responseContent o requestContent y responseContent separados por una coma. El valor predeterminado no es ninguno. Al establecer este valor, considere cuidadosamente el tipo de información que se pasa durante la implementación. Al registrar información sobre la solicitud o respuesta, se podrían exponer datos confidenciales que se recuperan a través de las operaciones de implementación.

DeploymentStacksParametersLink

Objeto

Entidad que representa la referencia a los parámetros de implementación.

Nombre	Tipo	Description
contentVersion	string	Si se incluye, debe coincidir con ContentVersion en la plantilla.
uri	string	Identificador URI del archivo de parámetros.

DeploymentStacksTemplateLink

Objeto

Entidad que representa la referencia a la plantilla.

Nombre	Tipo	Description
contentVersion	string	Si se incluye, debe coincidir con ContentVersion en la plantilla.
id	string	El resourceId de una especificación de plantilla. Use la propiedad id o uri, pero no ambas.
queryString	string	Cadena de consulta (por ejemplo, un token de SAS) que se va a usar con el URI templateLink.
relativePath	string	La propiedad relativePath se puede usar para implementar una plantilla vinculada en una ubicación relativa al elemento primario. Si la plantilla primaria estaba vinculada a templateSpec, esto hará referencia a un artefacto en TemplateSpec. Si el elemento primario se vinculó con un URI, la implementación secundaria será una combinación de los URI primarios y relativePath.
uri	string	Identificador URI de la plantilla que se va a implementar. Use la propiedad URI o id, pero no ambas.

ErrorAdditionalInfo

Objeto

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Objeto

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	Mensaje de error.
target	string	Destino del error.

ErrorResponse

Objeto

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

KeyVaultParameterReference

Objeto

Referencia de parámetros de Azure Key Vault.

Nombre	Tipo	Description
keyVault	KeyVaultReference	Referencia de Azure Key Vault.
secretName	string	Nombre del secreto de Azure Key Vault.
secretVersion	string	Versión secreta de Azure Key Vault.

KeyVaultReference

Objeto

Referencia de Azure Key Vault.

Nombre	Tipo	Description
id	string	Resource Id de Azure Key Vault.

ManagedResourceReference

Objeto

Modelo de recursos administrados.

Nombre	Tipo	Valor predeterminado	Description
denyStatus	DenyStatusMode	none	denyAssignment configuración aplicada al recurso.
id	string		Identificador de recurso de ARM de un recurso administrado por la pila de implementación.
status	ResourceStatusMode	none	Estado de administración actual del recurso en la pila de implementación.

ResourceReference

Objeto

El modelo resourceId.

Nombre	Tipo	Description
id	string	Identificador de recurso de ARM de un recurso administrado por la pila de implementación.

ResourceReferenceExtended

Objeto

El modelo extendido resourceId. Esto se usa para documentar recursos con errores con un resourceId y un error correspondiente.

Nombre	Tipo	Description
error	ErrorDetail	Detalle del error.
id	string	Identificador de recurso de ARM de un recurso administrado por la pila de implementación.

ResourceStatusMode

Enumeración

Estado de administración actual del recurso en la pila de implementación.

Valor	Description
managed	La pila de implementación administra este recurso.
removeDenyFailed	No se puede quitar la asignación de denegación en el recurso.
deleteFailed	No se puede eliminar el recurso de Azure. La eliminación se reintentará en la siguiente implementación de pila o se puede eliminar manualmente.
none	Sin estado de administración.

systemData

Objeto

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

UnmanageActionManagementGroupMode

Enumeración

Especifica una acción para un recurso recién no administrado.

Valor	Description
delete	Elimina los grupos de gestión de Azure.
detach	Mantén los grupos de gestión en Azure.

UnmanageActionResourceGroupMode

Enumeración

Especifica una acción para un grupo de recursos recién no gestionado.

Valor	Description
delete	Elimina los grupos de recursos de Azure.
detach	Mantén los grupos de recursos en Azure.

UnmanageActionResourceMode

Enumeración

Especifica una acción para un recurso recién no administrado.

Valor	Description
delete	Eliminar los recursos de Azure
detach	Mantén los recursos en Azure

Compartir a través de

Deployment Stacks - List At Management Group

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

List management group Deployment stacks

Solicitud de ejemplo

Respuesta de muestra

Definiciones

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