Compartir a través de

Deployments - Create Or Update

Servicio:
Resource Management
Versión de la API:
2025-04-01

Implementa recursos en un grupo de recursos.
Puede proporcionar la plantilla y los parámetros directamente en la solicitud o vínculo a archivos JSON.

PUT 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 en el que se van a implementar los recursos. El nombre distingue mayúsculas de minúsculas. El grupo de recursos ya debe existir.
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.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
properties True

DeploymentProperties

Las propiedades de implementación.
identity

DeploymentIdentity

La configuración de identidad administrada para una implementación.
location

string

Ubicación para almacenar los datos de implementación.
tags

object

Etiquetas de implementación

Respuestas

Nombre Tipo Description
200 OK

DeploymentExtended

Aceptar: devuelve información sobre la implementación, incluido el estado de aprovisionamiento.
201 Created

DeploymentExtended

Creado: 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

Ejemplos

Create a deployment that will deploy a template with a uri and queryString
Create a deployment that will deploy a templateSpec with the given resourceId
Create a deployment that will redeploy another deployment on failure
Create a deployment that will redeploy the last successful deployment on failure
Create deployment using external inputs

Create a deployment that will deploy a template with a uri and queryString

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000001/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment?api-version=2025-04-01

{
  "properties": {
    "templateLink": {
      "uri": "https://example.com/exampleTemplate.json",
      "queryString": "sv=2019-02-02&st=2019-04-29T22%3A18%3A26Z&se=2019-04-30T02%3A23%3A26Z&sr=b&sp=rw&sip=168.1.5.60-168.1.5.70&spr=https&sig=xxxxxxxx0xxxxxxxxxxxxx%2bxxxxxxxxxxxxxxxxxxxx%3d"
    },
    "parameters": {},
    "mode": "Incremental"
  }
}

Respuesta de muestra

status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "properties": {
    "templateLink": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1",
      "contentVersion": "1.0.0.0"
    },
    "templateHash": "0000000000000000000",
    "parameters": {},
    "mode": "Incremental",
    "provisioningState": "Succeeded",
    "timestamp": "2020-06-05T01:20:01.723776Z",
    "duration": "PT22.8356799S",
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "providers": [
      {
        "namespace": "Microsoft.Storage",
        "resourceTypes": [
          {
            "resourceType": "storageAccounts",
            "locations": [
              "eastus"
            ]
          }
        ]
      }
    ],
    "dependencies": [],
    "outputResources": [
      {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Storage/storageAccounts/my-storage-account"
      }
    ]
  }
}
status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "properties": {
    "templateLink": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1",
      "contentVersion": "1.0.0.0"
    },
    "templateHash": "0000000000000000000",
    "parameters": {},
    "mode": "Incremental",
    "provisioningState": "Accepted",
    "timestamp": "2020-06-05T01:20:01.723776Z",
    "duration": "PT22.8356799S",
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "providers": [
      {
        "namespace": "Microsoft.Storage",
        "resourceTypes": [
          {
            "resourceType": "storageAccounts",
            "locations": [
              "eastus"
            ]
          }
        ]
      }
    ],
    "dependencies": []
  }
}

Create a deployment that will deploy a templateSpec with the given resourceId

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000001/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment?api-version=2025-04-01

{
  "properties": {
    "templateLink": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1"
    },
    "parameters": {},
    "mode": "Incremental"
  }
}

Respuesta de muestra

status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "properties": {
    "templateLink": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1",
      "contentVersion": "1.0.0.0"
    },
    "templateHash": "0000000000000000000",
    "parameters": {},
    "mode": "Incremental",
    "provisioningState": "Succeeded",
    "timestamp": "2020-06-05T01:20:01.723776Z",
    "duration": "PT22.8356799S",
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "providers": [
      {
        "namespace": "Microsoft.Storage",
        "resourceTypes": [
          {
            "resourceType": "storageAccounts",
            "locations": [
              "eastus"
            ]
          }
        ]
      }
    ],
    "dependencies": [],
    "outputResources": [
      {
        "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Storage/storageAccounts/my-storage-account"
      }
    ]
  }
}
status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "properties": {
    "templateLink": {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/TemplateSpecs/TemplateSpec-Name/versions/v1",
      "contentVersion": "1.0.0.0"
    },
    "templateHash": "0000000000000000000",
    "parameters": {},
    "mode": "Incremental",
    "provisioningState": "Accepted",
    "timestamp": "2020-06-05T01:20:01.723776Z",
    "duration": "PT22.8356799S",
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "providers": [
      {
        "namespace": "Microsoft.Storage",
        "resourceTypes": [
          {
            "resourceType": "storageAccounts",
            "locations": [
              "eastus"
            ]
          }
        ]
      }
    ],
    "dependencies": []
  }
}

Create a deployment that will redeploy another deployment on failure

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment?api-version=2025-04-01

{
  "properties": {
    "templateLink": {
      "uri": "https://example.com/exampleTemplate.json"
    },
    "parameters": {},
    "mode": "Complete",
    "onErrorDeployment": {
      "type": "SpecificDeployment",
      "deploymentName": "name-of-deployment-to-use"
    }
  }
}

Respuesta de muestra

status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "properties": {
    "templateLink": {
      "uri": "https://example.com/exampleTemplate.json",
      "contentVersion": "1.0.0.0"
    },
    "parameters": {},
    "mode": "Complete",
    "provisioningState": "Accepted",
    "timestamp": "2019-03-01T00:00:00.0000000Z",
    "duration": "PT0.8204881S",
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "providers": [
      {
        "namespace": "Microsoft.Network",
        "resourceTypes": [
          {
            "resourceType": "virtualNetworks",
            "locations": [
              "centralus"
            ]
          },
          {
            "resourceType": "virtualNetworks/subnets",
            "locations": [
              "centralus"
            ]
          }
        ]
      }
    ],
    "dependencies": [
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceType": "Microsoft.Network/virtualNetworks",
            "resourceName": "VNet1"
          }
        ],
        "id": "{resourceid}",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets",
        "resourceName": "VNet1/Subnet1"
      },
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceType": "Microsoft.Network/virtualNetworks",
            "resourceName": "VNet1"
          },
          {
            "id": "{resourceid}",
            "resourceType": "Microsoft.Network/virtualNetworks/subnets",
            "resourceName": "VNet1/Subnet1"
          }
        ],
        "id": "{resourceid}",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets",
        "resourceName": "VNet1/Subnet2"
      }
    ],
    "onErrorDeployment": {
      "type": "SpecificDeployment",
      "deploymentName": "name-of-deployment-to-use"
    }
  }
}
status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "properties": {
    "templateLink": {
      "uri": "https://example.com/exampleTemplate.json",
      "contentVersion": "1.0.0.0"
    },
    "parameters": {},
    "mode": "Complete",
    "provisioningState": "Accepted",
    "timestamp": "2019-03-01T00:00:00.0000000Z",
    "duration": "PT0.8204881S",
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "providers": [
      {
        "namespace": "Microsoft.Network",
        "resourceTypes": [
          {
            "resourceType": "virtualNetworks",
            "locations": [
              "centralus"
            ]
          },
          {
            "resourceType": "virtualNetworks/subnets",
            "locations": [
              "centralus"
            ]
          }
        ]
      }
    ],
    "dependencies": [
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceType": "Microsoft.Network/virtualNetworks",
            "resourceName": "VNet1"
          }
        ],
        "id": "{resourceid}",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets",
        "resourceName": "VNet1/Subnet1"
      },
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceType": "Microsoft.Network/virtualNetworks",
            "resourceName": "VNet1"
          },
          {
            "id": "{resourceid}",
            "resourceType": "Microsoft.Network/virtualNetworks/subnets",
            "resourceName": "VNet1/Subnet1"
          }
        ],
        "id": "{resourceid}",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets",
        "resourceName": "VNet1/Subnet2"
      }
    ],
    "onErrorDeployment": {
      "type": "SpecificDeployment",
      "deploymentName": "name-of-deployment-to-use"
    }
  }
}

Create a deployment that will redeploy the last successful deployment on failure

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment?api-version=2025-04-01

{
  "properties": {
    "templateLink": {
      "uri": "https://example.com/exampleTemplate.json"
    },
    "parameters": {},
    "mode": "Complete",
    "onErrorDeployment": {
      "type": "LastSuccessful"
    }
  }
}

Respuesta de muestra

status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "properties": {
    "templateLink": {
      "uri": "https://example.com/exampleTemplate.json",
      "contentVersion": "1.0.0.0"
    },
    "parameters": {},
    "mode": "Complete",
    "provisioningState": "Accepted",
    "timestamp": "2019-03-01T00:00:00.0000000Z",
    "duration": "PT0.8204881S",
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "providers": [
      {
        "namespace": "Microsoft.Network",
        "resourceTypes": [
          {
            "resourceType": "virtualNetworks",
            "locations": [
              "centralus"
            ]
          },
          {
            "resourceType": "virtualNetworks/subnets",
            "locations": [
              "centralus"
            ]
          }
        ]
      }
    ],
    "dependencies": [
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceType": "Microsoft.Network/virtualNetworks",
            "resourceName": "VNet1"
          }
        ],
        "id": "{resourceid}",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets",
        "resourceName": "VNet1/Subnet1"
      },
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceType": "Microsoft.Network/virtualNetworks",
            "resourceName": "VNet1"
          },
          {
            "id": "{resourceid}",
            "resourceType": "Microsoft.Network/virtualNetworks/subnets",
            "resourceName": "VNet1/Subnet1"
          }
        ],
        "id": "{resourceid}",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets",
        "resourceName": "VNet1/Subnet2"
      }
    ],
    "onErrorDeployment": {
      "type": "LastSuccessful",
      "deploymentName": "{nameOfLastSuccesfulDeployment}"
    }
  }
}
status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "properties": {
    "templateLink": {
      "uri": "https://example.com/exampleTemplate.json",
      "contentVersion": "1.0.0.0"
    },
    "parameters": {},
    "mode": "Complete",
    "provisioningState": "Accepted",
    "timestamp": "2019-03-01T00:00:00.0000000Z",
    "duration": "PT0.8204881S",
    "correlationId": "00000000-0000-0000-0000-000000000000",
    "providers": [
      {
        "namespace": "Microsoft.Network",
        "resourceTypes": [
          {
            "resourceType": "virtualNetworks",
            "locations": [
              "centralus"
            ]
          },
          {
            "resourceType": "virtualNetworks/subnets",
            "locations": [
              "centralus"
            ]
          }
        ]
      }
    ],
    "dependencies": [
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceType": "Microsoft.Network/virtualNetworks",
            "resourceName": "VNet1"
          }
        ],
        "id": "{resourceid}",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets",
        "resourceName": "VNet1/Subnet1"
      },
      {
        "dependsOn": [
          {
            "id": "{resourceid}",
            "resourceType": "Microsoft.Network/virtualNetworks",
            "resourceName": "VNet1"
          },
          {
            "id": "{resourceid}",
            "resourceType": "Microsoft.Network/virtualNetworks/subnets",
            "resourceName": "VNet1/Subnet1"
          }
        ],
        "id": "{resourceid}",
        "resourceType": "Microsoft.Network/virtualNetworks/subnets",
        "resourceName": "VNet1/Subnet2"
      }
    ],
    "onErrorDeployment": {
      "type": "LastSuccessful",
      "deploymentName": "{nameOfLastSuccesfulDeployment}"
    }
  }
}

Create deployment using external inputs

Solicitud de ejemplo

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000001/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment?api-version=2025-04-01

{
  "properties": {
    "template": {
      "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
      "contentVersion": "1.0.0.0",
      "parameters": {
        "inputObj": {
          "type": "object"
        }
      },
      "resources": [],
      "outputs": {
        "inputObj": {
          "type": "object",
          "value": "[parameters('inputObj')]"
        }
      }
    },
    "parameters": {
      "inputObj": {
        "expression": "[createObject('foo', externalInputs('fooValue'))]"
      }
    },
    "externalInputDefinitions": {
      "fooValue": {
        "kind": "sys.envVar",
        "config": "FOO_VALUE"
      }
    },
    "externalInputs": {
      "fooValue": {
        "value": "baz"
      }
    },
    "mode": "Incremental"
  }
}

Respuesta de muestra

status code:
200 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "properties": {
    "templateHash": "17686481789412793580",
    "parameters": {
      "inputObj": {
        "type": "Object",
        "value": {
          "foo": "baz"
        }
      }
    },
    "mode": "Incremental",
    "provisioningState": "Succeeded",
    "timestamp": "2025-04-09T14:36:48.2047169Z",
    "correlationId": "ef613b6c-f76e-48fd-9da7-28884243c5e5",
    "providers": [],
    "dependencies": [],
    "outputs": {
      "inputObj": {
        "type": "Object",
        "value": {
          "foo": "baz"
        }
      }
    },
    "outputResources": []
  }
}
status code:
201 
{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment",
  "name": "my-deployment",
  "type": "Microsoft.Resources/deployments",
  "properties": {
    "templateHash": "17686481789412793580",
    "parameters": {
      "inputObj": {
        "type": "Object",
        "value": {
          "foo": "baz"
        }
      }
    },
    "mode": "Incremental",
    "provisioningState": "Accepted",
    "timestamp": "2025-04-09T14:36:47.6637583Z",
    "duration": "PT0.0009164S",
    "correlationId": "ef613b6c-f76e-48fd-9da7-28884243c5e5",
    "providers": [],
    "dependencies": []
  }
}

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.
Deployment

Parámetros de la operación de implementación.
DeploymentDiagnosticsDefinition
DeploymentExtended

Información de implementación.
DeploymentExtensionConfigItem
DeploymentExtensionDefinition
DeploymentExternalInput

Entrada externa de implementación para parametrización.
DeploymentExternalInputDefinition

Definición de entrada externa de despliegue para la parametrización.
DeploymentIdentity

La configuración de identidad administrada para una implementación.
DeploymentIdentityType

Tipo de identidad.
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.
DeploymentParameter

Parámetro de implementación de la plantilla.
DeploymentProperties

Propiedades de implementación.
DeploymentPropertiesExtended

Propiedades de implementación con detalles adicionales.
ErrorAdditionalInfo

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

Respuesta de error
ExpressionEvaluationOptions

Especifica si las expresiones de plantilla se evalúan dentro del ámbito de la plantilla primaria o de la plantilla anidada.
ExpressionEvaluationOptionsScopeType

Ámbito que se va a usar para la evaluación de parámetros, variables y funciones en una plantilla anidada.
ExtensionConfigPropertyType
KeyVaultParameterReference

Referencia de parámetros de Azure Key Vault.
KeyVaultReference

Referencia de Azure Key Vault.
Level

Indica el nivel de respuesta adicional.
OnErrorDeployment

Implementación en el comportamiento del error.
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.
UserAssignedIdentity

Propiedades de identidad asignadas por el usuario
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.

Deployment

Object

Parámetros de la operación de implementación.

Nombre Tipo Description
identity

DeploymentIdentity

La configuración de identidad administrada para una implementación.
location

string

Ubicación para almacenar los datos de implementación.
properties

DeploymentProperties

Las propiedades de implementación.
tags

object

Etiquetas de implementación

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.

DeploymentExternalInput

Object

Entrada externa de implementación para parametrización.

Nombre Tipo Description
value

Valor de entrada externa.

DeploymentExternalInputDefinition

Object

Definición de entrada externa de despliegue para la parametrización.

Nombre Tipo Description
config

Configuración de la entrada externa.
kind

string

El tipo de entrada externa.

DeploymentIdentity

Object

La configuración de identidad administrada para una implementación.

Nombre Tipo Description
type

DeploymentIdentityType

Tipo de identidad.
userAssignedIdentities

<string,  UserAssignedIdentity>

Conjunto de identidades asignadas por el usuario asociadas al recurso.

DeploymentIdentityType

Enumeración

Tipo de identidad.

Valor Description
None
UserAssigned

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

DeploymentParameter

Object

Parámetro de implementación de la plantilla.

Nombre Tipo Description
expression

string

Expresión de entrada al parámetro.
reference

KeyVaultParameterReference

Referencia de parámetros de Azure Key Vault.
value

Valor de entrada al parámetro .

DeploymentProperties

Object

Propiedades de implementación.

Nombre Tipo Description
debugSetting

DebugSetting

Configuración de depuración de la implementación.
expressionEvaluationOptions

ExpressionEvaluationOptions

Especifica si las expresiones de plantilla se evalúan dentro del ámbito de la plantilla primaria o de la plantilla anidada. Solo se aplica a las plantillas anidadas. Si no se especifica, el valor predeterminado es externo.
extensionConfigs

object

Las configuraciones que se van a usar para las extensiones de implementación. Las claves de este objeto son alias de extensión de implementación, tal como se definen en la plantilla de implementación.
externalInputDefinitions

<string,  DeploymentExternalInputDefinition>

Definiciones de entrada externa, utilizadas por herramientas externas para definir los valores de entrada externos esperados.
externalInputs

<string,  DeploymentExternalInput>

Valores de entrada externos, utilizados por herramientas externas para la evaluación de parámetros.
mode

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.
onErrorDeployment

OnErrorDeployment

Implementación en el comportamiento del error.
parameters

<string,  DeploymentParameter>

Pares de nombre y valor que definen los parámetros de implementación de la plantilla. Este elemento se usa cuando desea 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. Puede ser un JObject o una cadena JSON bien formada.
parametersLink

ParametersLink

Identificador URI del archivo de parámetros. Este elemento se usa para vincular a un archivo de parámetros existente. Use la propiedad parametersLink o la propiedad parameters, pero no ambas.
template

object

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.
templateLink

TemplateLink

Identificador URI de la plantilla. Use la propiedad templateLink o la propiedad template, pero no ambas.
validationLevel

ValidationLevel

El nivel de validación de la implementación

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.

ExpressionEvaluationOptions

Object

Especifica si las expresiones de plantilla se evalúan dentro del ámbito de la plantilla primaria o de la plantilla anidada.

Nombre Tipo Description
scope

ExpressionEvaluationOptionsScopeType

Ámbito que se va a usar para la evaluación de parámetros, variables y funciones en una plantilla anidada.

ExpressionEvaluationOptionsScopeType

Enumeración

Ámbito que se va a usar para la evaluación de parámetros, variables y funciones en una plantilla anidada.

Valor Description
NotSpecified
Outer
Inner

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

OnErrorDeployment

Object

Implementación en el comportamiento del error.

Nombre Tipo Description
deploymentName

string

Implementación que se va a usar en caso de error.
type

OnErrorDeploymentType

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

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
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.
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.

UserAssignedIdentity

Object

Propiedades de identidad asignadas por el usuario

Nombre Tipo Description
clientId

string (uuid)

Identificador de cliente de la identidad asignada.
principalId

string (uuid)

Identificador de entidad de seguridad de la identidad asignada.

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[]