Compartir a través de

Implementaciones de Microsoft.Resources 2018-05-01

Observaciones

Para Bicep, considere la posibilidad de usar módulos en lugar de este tipo de recurso.

Definición de recursos de Bicep

El tipo de recurso deployments se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Resources/deployments, agregue el siguiente bicep a la plantilla.

resource symbolicname 'Microsoft.Resources/deployments@2018-05-01' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    debugSetting: {
      detailLevel: 'string'
    }
    mode: 'string'
    onErrorDeployment: {
      deploymentName: 'string'
      type: 'string'
    }
    parameters: any(...)
    parametersLink: {
      contentVersion: 'string'
      uri: 'string'
    }
    template: any(...)
    templateLink: {
      contentVersion: 'string'
      uri: 'string'
    }
  }
}

Valores de propiedad

Microsoft.Resources/deployments

Nombre Descripción Importancia
ubicación Ubicación para almacenar los datos de implementación. cuerda / cadena
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 64
Patrón = ^[-\w\._\(\)]+$ (obligatorio)
Propiedades Las propiedades de implementación. DeploymentPropertiesOrDeploymentPropertiesExtended (obligatorio)
scope Use al crear un recurso en un ámbito diferente del ámbito de implementación. Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión .

DebugSetting

Nombre Descripción Importancia
detailLevel 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. cuerda / cadena

DeploymentPropertiesOrDeploymentPropertiesExtended

Nombre Descripción Importancia
debugSetting Configuración de depuración de la implementación. debugSetting
modo 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. "Completado"
'Incremental' (obligatorio)
onErrorDeployment Implementación en el comportamiento del error. OnErrorDeploymentOrOnErrorDeploymentExtended
parámetros 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. cualquiera
parámetrosEnlace 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. ParámetrosEnlace
plantilla 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. cualquiera
templateLink Identificador URI de la plantilla. Use la propiedad templateLink o la propiedad template, pero no ambas. PlantillaEnlace

OnErrorDeploymentOrOnErrorDeploymentExtended

Nombre Descripción Importancia
deploymentName Implementación que se va a usar en caso de error. cuerda / cadena
tipo La implementación en el tipo de comportamiento de error. Los valores posibles son LastSuccessful y SpecificDeployment. 'LastSuccessful'
"SpecificDeployment"
Nombre Descripción Importancia
contentVersion Si se incluye, debe coincidir con ContentVersion en la plantilla. cuerda / cadena
Uri Identificador URI del archivo de parámetros. string (obligatorio)
Nombre Descripción Importancia
contentVersion Si se incluye, debe coincidir con ContentVersion en la plantilla. cuerda / cadena
Uri Identificador URI de la plantilla que se va a implementar. string (obligatorio)

Definición de recursos de plantilla de ARM

El tipo de recurso deployments se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Resources/deployments, agregue el siguiente JSON a la plantilla.

{
  "type": "Microsoft.Resources/deployments",
  "apiVersion": "2018-05-01",
  "name": "string",
  "location": "string",
  "properties": {
    "debugSetting": {
      "detailLevel": "string"
    },
    "mode": "string",
    "onErrorDeployment": {
      "deploymentName": "string",
      "type": "string"
    },
    "parameters": {},
    "parametersLink": {
      "contentVersion": "string",
      "uri": "string"
    },
    "template": {},
    "templateLink": {
      "contentVersion": "string",
      "uri": "string"
    }
  }
}

Valores de propiedad

Microsoft.Resources/deployments

Nombre Descripción Importancia
apiVersion La versión de api '2018-05-01'
ubicación Ubicación para almacenar los datos de implementación. cuerda / cadena
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 64
Patrón = ^[-\w\._\(\)]+$ (obligatorio)
Propiedades Las propiedades de implementación. DeploymentPropertiesOrDeploymentPropertiesExtended (obligatorio)
tipo El tipo de recurso "Microsoft.Resources/deployments"

DebugSetting

Nombre Descripción Importancia
detailLevel 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. cuerda / cadena

DeploymentPropertiesOrDeploymentPropertiesExtended

Nombre Descripción Importancia
debugSetting Configuración de depuración de la implementación. debugSetting
modo 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. "Completado"
'Incremental' (obligatorio)
onErrorDeployment Implementación en el comportamiento del error. OnErrorDeploymentOrOnErrorDeploymentExtended
parámetros 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. cualquiera
parámetrosEnlace 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. ParámetrosEnlace
plantilla 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. cualquiera
templateLink Identificador URI de la plantilla. Use la propiedad templateLink o la propiedad template, pero no ambas. PlantillaEnlace

OnErrorDeploymentOrOnErrorDeploymentExtended

Nombre Descripción Importancia
deploymentName Implementación que se va a usar en caso de error. cuerda / cadena
tipo La implementación en el tipo de comportamiento de error. Los valores posibles son LastSuccessful y SpecificDeployment. 'LastSuccessful'
"SpecificDeployment"
Nombre Descripción Importancia
contentVersion Si se incluye, debe coincidir con ContentVersion en la plantilla. cuerda / cadena
Uri Identificador URI del archivo de parámetros. string (obligatorio)
Nombre Descripción Importancia
contentVersion Si se incluye, debe coincidir con ContentVersion en la plantilla. cuerda / cadena
Uri Identificador URI de la plantilla que se va a implementar. string (obligatorio)

Ejemplos de uso

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso deployments se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.Resources/deployments, agregue el siguiente terraform a la plantilla.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Resources/deployments@2018-05-01"
  name = "string"
  parent_id = "string"
  location = "string"
  body = {
    properties = {
      debugSetting = {
        detailLevel = "string"
      }
      mode = "string"
      onErrorDeployment = {
        deploymentName = "string"
        type = "string"
      }
      parameters = ?
      parametersLink = {
        contentVersion = "string"
        uri = "string"
      }
      template = ?
      templateLink = {
        contentVersion = "string"
        uri = "string"
      }
    }
  }
}

Valores de propiedad

Microsoft.Resources/deployments

Nombre Descripción Importancia
ubicación Ubicación para almacenar los datos de implementación. cuerda / cadena
nombre El nombre del recurso cuerda

Restricciones:
Longitud mínima = 1
Longitud máxima = 64
Patrón = ^[-\w\._\(\)]+$ (obligatorio)
parent_id Identificador del recurso al que se va a aplicar este recurso de extensión. string (obligatorio)
Propiedades Las propiedades de implementación. DeploymentPropertiesOrDeploymentPropertiesExtended (obligatorio)
tipo El tipo de recurso "Microsoft.Resources/deployments@2018-05-01"

DebugSetting

Nombre Descripción Importancia
detailLevel 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. cuerda / cadena

DeploymentPropertiesOrDeploymentPropertiesExtended

Nombre Descripción Importancia
debugSetting Configuración de depuración de la implementación. debugSetting
modo 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. "Completado"
'Incremental' (obligatorio)
onErrorDeployment Implementación en el comportamiento del error. OnErrorDeploymentOrOnErrorDeploymentExtended
parámetros 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. cualquiera
parámetrosEnlace 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. ParámetrosEnlace
plantilla 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. cualquiera
templateLink Identificador URI de la plantilla. Use la propiedad templateLink o la propiedad template, pero no ambas. PlantillaEnlace

OnErrorDeploymentOrOnErrorDeploymentExtended

Nombre Descripción Importancia
deploymentName Implementación que se va a usar en caso de error. cuerda / cadena
tipo La implementación en el tipo de comportamiento de error. Los valores posibles son LastSuccessful y SpecificDeployment. 'LastSuccessful'
"SpecificDeployment"
Nombre Descripción Importancia
contentVersion Si se incluye, debe coincidir con ContentVersion en la plantilla. cuerda / cadena
Uri Identificador URI del archivo de parámetros. string (obligatorio)
Nombre Descripción Importancia
contentVersion Si se incluye, debe coincidir con ContentVersion en la plantilla. cuerda / cadena
Uri Identificador URI de la plantilla que se va a implementar. string (obligatorio)

Ejemplos de uso

Ejemplos de Terraform

Un ejemplo básico de implementación de la implementación de plantillas.

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "deployment" {
  type      = "Microsoft.Resources/deployments@2020-06-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  body = {
    properties = {
      mode = "Complete"
      template = {
        "$schema"      = "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#"
        contentVersion = "1.0.0.0"
        parameters = {
          storageAccountType = {
            allowedValues = [
              "Standard_LRS",
              "Standard_GRS",
              "Standard_ZRS",
            ]
            defaultValue = "Standard_LRS"
            metadata = {
              description = "Storage Account type"
            }
            type = "string"
          }
        }
        resources = [
          {
            apiVersion = "[variables('apiVersion')]"
            location   = "[variables('location')]"
            name       = "[variables('storageAccountName')]"
            properties = {
              accountType = "[parameters('storageAccountType')]"
            }
            type = "Microsoft.Storage/storageAccounts"
          },
          {
            apiVersion = "[variables('apiVersion')]"
            location   = "[variables('location')]"
            name       = "[variables('publicIPAddressName')]"
            properties = {
              dnsSettings = {
                domainNameLabel = "[variables('dnsLabelPrefix')]"
              }
              publicIPAllocationMethod = "[variables('publicIPAddressType')]"
            }
            type = "Microsoft.Network/publicIPAddresses"
          },
        ]
        variables = {
          apiVersion          = "2015-06-15"
          dnsLabelPrefix      = "[concat('terraform-tdacctest', uniquestring(resourceGroup().id))]"
          location            = "[resourceGroup().location]"
          publicIPAddressName = "[concat('myPublicIp', uniquestring(resourceGroup().id))]"
          publicIPAddressType = "Dynamic"
          storageAccountName  = "[concat(uniquestring(resourceGroup().id), 'storage')]"
        }
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}
  • Last updated on