Deployments - Get

Servicio:: Resource Management

Versión de la API:: 2025-04-01

Obtiene una implementación.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}?api-version=2025-04-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
deploymentName	path	True	string minLength: 1 maxLength: 64 pattern: ^[-\w\._]+$	Nombre del despliegue.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string	Identificador de suscripción de Microsoft Azure.
api-version	query	True	string	Versión de la API que se va a usar para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	DeploymentExtended	Aceptar: devuelve información sobre la implementación, incluido el estado de aprovisionamiento.
Other Status Codes	CloudError	Respuesta de error que describe por qué se produjo un error en la operación.

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 la cuenta de usuario

Definiciones

Nombre	Description
Alias	Tipo de alias.
AliasPath	Tipo de las rutas de acceso para alias.
AliasPathAttributes	Atributos del token al que hace referencia la ruta de acceso del alias.
AliasPathMetadata
AliasPathTokenType	Tipo del token al que hace referencia la ruta de acceso del alias.
AliasPattern	Tipo del patrón para una ruta de acceso de alias.
AliasPatternType	Tipo de patrón de alias
AliasType	Tipo del alias.
ApiProfile
BasicDependency	Información de dependencia de implementación.
CloudError	Respuesta de error para una solicitud de administración de recursos.
DebugSetting	Configuración de depuración.
Dependency	Información de dependencia de implementación.
DeploymentDiagnosticsDefinition
DeploymentExtended	Información de implementación.
DeploymentExtensionConfigItem
DeploymentExtensionDefinition
DeploymentMode	Modo que se usa para implementar recursos. Este valor puede ser Incremental o Completado. En modo incremental, los recursos se implementan sin eliminar los recursos existentes que no se incluyen en la plantilla. En modo completo, los recursos se implementan y se eliminan los recursos existentes del grupo de recursos que no se incluyen en la plantilla. Tenga cuidado al usar el modo Completo, ya que puede eliminar accidentalmente los recursos.
DeploymentPropertiesExtended	Propiedades de implementación con detalles adicionales.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorResponse	Respuesta de error
ExtensionConfigPropertyType
KeyVaultParameterReference	Referencia de parámetros de Azure Key Vault.
KeyVaultReference	Referencia de Azure Key Vault.
Level	Indica el nivel de respuesta adicional.
OnErrorDeploymentExtended	Implementación en el comportamiento del error con detalles adicionales.
OnErrorDeploymentType	La implementación en el tipo de comportamiento de error. Los valores posibles son LastSuccessful y SpecificDeployment.
ParametersLink	Entidad que representa la referencia a los parámetros de implementación.
Provider	Información del proveedor de recursos.
ProviderAuthorizationConsentState	Estado de consentimiento de autorización del proveedor.
ProviderExtendedLocation	Ubicación extendida del proveedor.
ProviderResourceType	Tipo de recurso administrado por el proveedor de recursos.
ProvisioningState	Indica el estado del aprovisionamiento.
ResourceReference	Modelo de identificador de recurso.
TemplateLink	Entidad que representa la referencia a la plantilla.
ValidationLevel	El nivel de validación realizado en la implementación.
ZoneMapping

Alias

Object

Tipo de alias.

Nombre	Tipo	Description
defaultMetadata	AliasPathMetadata	Metadatos de ruta de acceso de alias predeterminados. Se aplica a la ruta de acceso predeterminada y a cualquier ruta de acceso de alias que no tenga metadatos.
defaultPath	string	Ruta de acceso predeterminada para un alias.
defaultPattern	AliasPattern	Patrón predeterminado para un alias.
name	string	Nombre del alias.
paths	AliasPath[]	Rutas de acceso de un alias.
type	AliasType	Tipo del alias.

AliasPath

Object

Tipo de las rutas de acceso para alias.

Nombre	Tipo	Description
apiVersions	string[]	Las versiones de la API.
metadata	AliasPathMetadata	Metadatos de la ruta de acceso de alias. Si falta, vuelva a los metadatos predeterminados del alias.
path	string	Ruta de acceso de un alias.
pattern	AliasPattern	Patrón de una ruta de acceso de alias.

AliasPathAttributes

Enumeración

Atributos del token al que hace referencia la ruta de acceso del alias.

Valor	Description
None	El token al que hace referencia la ruta de acceso del alias no tiene atributos.
Modifiable	El token al que hace referencia la ruta de acceso del alias es modificable mediante directivas con efecto "modify".

AliasPathMetadata

Object

Nombre	Tipo	Description
attributes	AliasPathAttributes	Atributos del token al que hace referencia la ruta de acceso del alias.
type	AliasPathTokenType	Tipo del token al que hace referencia la ruta de acceso del alias.

AliasPathTokenType

Enumeración

Tipo del token al que hace referencia la ruta de acceso del alias.

Valor	Description
NotSpecified	No se especifica el tipo de token.
Any	El tipo de token puede ser cualquier cosa.
String	El tipo de token es string.
Object	El tipo de token es object.
Array	El tipo de token es array.
Integer	El tipo de token es entero.
Number	El tipo de token es number.
Boolean	El tipo de token es booleano.

AliasPattern

Object

Tipo del patrón para una ruta de acceso de alias.

Nombre	Tipo	Description
phrase	string	Frase de patrón de alias.
type	AliasPatternType	Tipo de patrón de alias
variable	string	Variable de patrón de alias.

AliasPatternType

Enumeración

Tipo de patrón de alias

Valor	Description
NotSpecified	No se permite NotSpecified.
Extract	Extract es el único valor permitido.

AliasType

Enumeración

Tipo del alias.

Valor	Description
NotSpecified	El tipo de alias es desconocido (igual que no proporciona el tipo de alias).
PlainText	El valor del alias no es secreto.
Mask	El valor del alias es secreto.

ApiProfile

Object

Nombre	Tipo	Description
apiVersion	string	Versión de la API.
profileVersion	string	La versión del perfil.

BasicDependency

Object

Información de dependencia de implementación.

Nombre	Tipo	Description
id	string	Identificador de la dependencia.
resourceName	string	Nombre del recurso de dependencia.
resourceType	string	Tipo de recurso de dependencia.

CloudError

Object

Respuesta de error para una solicitud de administración de recursos.

Nombre	Tipo	Description
error	ErrorResponse	Respuesta de error Respuesta de error común para todas las API de Azure Resource Manager para devolver los detalles de error de las operaciones con errores. (Esto también sigue el formato de respuesta de error de OData).

DebugSetting

Object

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 está pasando durante la implementación. Al registrar información sobre la solicitud o respuesta, podría exponer datos confidenciales que se recuperan a través de las operaciones de implementación.

Dependency

Object

Información de dependencia de implementación.

Nombre	Tipo	Description
dependsOn	BasicDependency[]	Lista de dependencias.
id	string	Identificador de la dependencia.
resourceName	string	Nombre del recurso de dependencia.
resourceType	string	Tipo de recurso de dependencia.

DeploymentDiagnosticsDefinition

Object

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
level	Level	Indica el nivel de respuesta adicional.
message	string	El mensaje de error.
target	string	Destino del error.

DeploymentExtended

Object

Información de implementación.

Nombre	Tipo	Description
id	string	Identificador de la implementación.
location	string	la ubicación de la implementación.
name	string	Nombre del despliegue.
properties	DeploymentPropertiesExtended	Propiedades de implementación.
tags	object	Etiquetas de implementación
type	string	Tipo de la implementación.

DeploymentExtensionConfigItem

Object

Nombre	Tipo	Description
keyVaultReference	KeyVaultParameterReference	La referencia de Azure Key Vault que se usa para recuperar el valor secreto de la propiedad config de la extensión.
type	ExtensionConfigPropertyType	Tipo de valor de la propiedad config de la extensión.
value		Valor de la propiedad config de la extensión.

DeploymentExtensionDefinition

Object

Nombre	Tipo	Description
alias	string	El alias de la extensión tal como se define en la plantilla de implementación.
config	<string, DeploymentExtensionConfigItem>	La configuración de la extensión.
configId	string	El ID de configuración de la extensión. Identifica de forma única un plano de control de implementación dentro de una extensión.
name	string	Nombre de la extensión.
version	string	La versión de la extensión.

DeploymentMode

Enumeración

Modo que se usa para implementar recursos. Este valor puede ser Incremental o Completado. En modo incremental, los recursos se implementan sin eliminar los recursos existentes que no se incluyen en la plantilla. En modo completo, los recursos se implementan y se eliminan los recursos existentes del grupo de recursos que no se incluyen en la plantilla. Tenga cuidado al usar el modo Completo, ya que puede eliminar accidentalmente los recursos.

Valor	Description
Incremental
Complete

DeploymentPropertiesExtended

Object

Propiedades de implementación con detalles adicionales.

Nombre	Tipo	Description
correlationId	string	Identificador de correlación de la implementación.
debugSetting	DebugSetting	Configuración de depuración de la implementación.
dependencies	Dependency[]	Lista de dependencias de implementación.
diagnostics	DeploymentDiagnosticsDefinition[]	Contiene información de diagnóstico recopilada durante el proceso de validación.
duration	string	Duración de la implementación de la plantilla.
error	ErrorResponse	Respuesta de error Error de implementación.
extensions	DeploymentExtensionDefinition[]	Las extensiones utilizadas en esta implementación.
mode	DeploymentMode	Modo de implementación. Los valores posibles son Incremental y Complete.
onErrorDeployment	OnErrorDeploymentExtended	Implementación en el comportamiento del error.
outputResources	ResourceReference[]	Matriz de recursos aprovisionados.
outputs	object	Pares clave-valor que representan la salida de la implementación.
parameters	object	Parámetros de implementación.
parametersLink	ParametersLink	Identificador URI que hace referencia a los parámetros.
providers	Provider[]	Lista de proveedores de recursos necesarios para la implementación.
provisioningState	ProvisioningState	Indica el estado del aprovisionamiento.
templateHash	string	Hash generado para la plantilla.
templateLink	TemplateLink	Identificador URI que hace referencia a la plantilla.
timestamp	string (date-time)	Marca de tiempo de la implementación de la plantilla.
validatedResources	ResourceReference[]	Matriz de recursos validados.
validationLevel	ValidationLevel	El nivel de validación de la implementación

ErrorAdditionalInfo

Object

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.

ErrorResponse

Object

Respuesta de error

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

ExtensionConfigPropertyType

Enumeración

Valor	Description
String	Tipo de propiedad que representa un valor de cadena.
Int	Tipo de propiedad que representa un valor entero.
Bool	Tipo de propiedad que representa un valor booleano.
Array	Tipo de propiedad que representa un valor de matriz.
Object	Tipo de propiedad que representa un valor de objeto.
SecureString	Tipo de propiedad que representa un valor de cadena segura.
SecureObject	Tipo de propiedad que representa un valor de objeto seguro.

KeyVaultParameterReference

Object

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

Object

Referencia de Azure Key Vault.

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

Level

Enumeración

Indica el nivel de respuesta adicional.

Valor	Description
Warning
Info
Error

OnErrorDeploymentExtended

Object

Implementación en el comportamiento del error con detalles adicionales.

Nombre	Tipo	Description
deploymentName	string	Implementación que se va a usar en caso de error.
provisioningState	string	Estado del aprovisionamiento para la implementación de errores.
type	OnErrorDeploymentType	La implementación en el tipo de comportamiento de error. Los valores posibles son LastSuccessful y SpecificDeployment.

OnErrorDeploymentType

Enumeración

La implementación en el tipo de comportamiento de error. Los valores posibles son LastSuccessful y SpecificDeployment.

Valor	Description
LastSuccessful
SpecificDeployment

ParametersLink

Object

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.

Provider

Object

Información del proveedor de recursos.

Nombre	Tipo	Description
id	string	Identificador del proveedor.
namespace	string	Espacio de nombres del proveedor de recursos.
providerAuthorizationConsentState	ProviderAuthorizationConsentState	Estado de consentimiento de autorización del proveedor.
registrationPolicy	string	Directiva de registro del proveedor de recursos.
registrationState	string	Estado de registro del proveedor de recursos.
resourceTypes	ProviderResourceType[]	Colección de tipos de recursos de proveedor.

ProviderAuthorizationConsentState

Enumeración

Estado de consentimiento de autorización del proveedor.

Valor	Description
NotSpecified
Required
NotRequired
Consented

ProviderExtendedLocation

Object

Ubicación extendida del proveedor.

Nombre	Tipo	Description
extendedLocations	string[]	Ubicaciones extendidas para la ubicación de Azure.
location	string	Ubicación de Azure.
type	string	Tipo de ubicación extendida.

ProviderResourceType

Object

Tipo de recurso administrado por el proveedor de recursos.

Nombre	Tipo	Description
aliases	Alias[]	Alias admitidos por este tipo de recurso.
apiProfiles	ApiProfile[]	Perfiles de API para el proveedor de recursos.
apiVersions	string[]	Versión de la API.
capabilities	string	Las funcionalidades adicionales que ofrece este tipo de recurso.
defaultApiVersion	string	Versión predeterminada de la API.
locationMappings	ProviderExtendedLocation[]	Asignaciones de ubicación compatibles con este tipo de recurso.
locations	string[]	Colección de ubicaciones donde se puede crear este tipo de recurso.
properties	object	Propiedades.
resourceType	string	Tipo de recurso.
zoneMappings	ZoneMapping[]

ProvisioningState

Enumeración

Indica el estado del aprovisionamiento.

Valor	Description
NotSpecified
Accepted
Running
Ready
Creating
Created
Deleting
Deleted
Canceled
Failed
Succeeded
Updating

ResourceReference

Object

Modelo de identificador de recurso.

Nombre	Tipo	Description
apiVersion	string	La versión de API con la que se implementó el recurso.
extension	DeploymentExtensionDefinition	La extensión con la que se implementó el recurso.
id	string	El identificador de recurso de Azure completo.
identifiers	object	Los identificadores de recursos extensibles.
resourceType	string	Tipo de recurso.

TemplateLink

Object

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	Identificador de recurso 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 estaba vinculado 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.

ValidationLevel

Enumeración

El nivel de validación realizado en la implementación.

Valor	Description
Template	Se realiza un análisis estático de la plantilla.
Provider	Se realiza un análisis estático de la plantilla y se envían declaraciones de recursos a los proveedores de recursos para su validación semántica. Valida que el autor de la llamada tenga permisos de escritura RBAC en cada recurso.
ProviderNoRbac	Se realiza un análisis estático de la plantilla y se envían declaraciones de recursos a los proveedores de recursos para su validación semántica. Omite la validación de que el autor de la llamada tiene permisos de escritura RBAC en cada recurso.

ZoneMapping

Object

Nombre	Tipo	Description
location	string	Ubicación de la asignación de zona.
zones	string[]

Compartir a través de

Deployments - Get

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Definiciones

Alias

AliasPath

AliasPathAttributes

AliasPathMetadata

AliasPathTokenType

AliasPattern

AliasPatternType

AliasType

ApiProfile

BasicDependency

CloudError

DebugSetting

Dependency

DeploymentDiagnosticsDefinition

DeploymentExtended

DeploymentExtensionConfigItem

DeploymentExtensionDefinition

DeploymentMode

DeploymentPropertiesExtended

ErrorAdditionalInfo

ErrorResponse

ExtensionConfigPropertyType

KeyVaultParameterReference

KeyVaultReference

Level

OnErrorDeploymentExtended

OnErrorDeploymentType

ParametersLink

Provider

ProviderAuthorizationConsentState

ProviderExtendedLocation

ProviderResourceType

ProvisioningState

ResourceReference

TemplateLink

ValidationLevel

ZoneMapping