Compartilhar via

Implantações do Microsoft.Resources 2018-05-01

Observações

Para o Bicep, considere usar módulos em vez desse tipo de recurso.

Definição de recurso do Bicep

O tipo de recurso de implantações pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Resources/deployments, adicione o Bicep a seguir ao seu modelo.

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 da propriedade

Microsoft.Resources/deployments

Nome Descrição Valor
local O local para armazenar os dados de implantação. cadeia
nome O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 64
Padrão = ^[-\w\._\(\)]+$ (obrigatório)
propriedades As propriedades de implantação. DeploymentPropertiesOrDeploymentPropertiesExtended (obrigatório)
escopo Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .

Configuração de depuração

Nome Descrição Valor
detailLevel Especifica o tipo de informação a ser registrada em log para depuração. Os valores permitidos são none, requestContent, responseContent ou requestContent e responseContent separados por uma vírgula. O padrão é nenhum. Ao definir esse valor, considere cuidadosamente o tipo de informação que você está passando durante a implantação. Ao registrar em log informações sobre a solicitação ou resposta, você pode potencialmente expor dados confidenciais recuperados por meio das operações de implantação. cadeia

DeploymentPropertiesOrDeploymentPropertiesExtended

Nome Descrição Valor
configuração de depuração A configuração de depuração da implantação. Configuração de depuração
modo O modo usado para implantar recursos. Esse valor pode ser Incremental ou Concluído. No modo incremental, os recursos são implantados sem excluir recursos existentes que não estão incluídos no modelo. No modo Completo, os recursos são implantados e os recursos existentes no grupo de recursos que não estão incluídos no modelo são excluídos. Tenha cuidado ao usar o modo Completo, pois você pode excluir recursos sem querer. 'Completo'
'Incremental' (obrigatório)
onErrorDeployment A implantação no comportamento de erro. OnErrorDeploymentOrOnErrorDeploymentExtended
parâmetros Pares de nome e valor que definem os parâmetros de implantação para o modelo. Use esse elemento quando quiser fornecer os valores de parâmetro diretamente na solicitação em vez de vincular a um arquivo de parâmetro existente. Use a propriedade parametersLink ou a propriedade parameters, mas não ambos. Pode ser um JObject ou uma cadeia de caracteres JSON bem formada. qualquer
parâmetrosLink O URI do arquivo de parâmetros. Use esse elemento para vincular a um arquivo de parâmetros existente. Use a propriedade parametersLink ou a propriedade parameters, mas não ambos. ParâmetroLink
modelo O conteúdo do modelo. Use esse elemento quando quiser passar a sintaxe do modelo diretamente na solicitação em vez de vincular a um modelo existente. Pode ser uma cadeia de caracteres JObject ou JSON bem formada. Use a propriedade templateLink ou a propriedade de modelo, mas não ambos. qualquer
link de modelo O URI do modelo. Use a propriedade templateLink ou a propriedade de modelo, mas não ambos. Link do modelo

OnErrorDeploymentOrOnErrorDeploymentExtended

Nome Descrição Valor
nome_da_implantação A implantação a ser usada no caso de erro. cadeia
tipo A implantação no tipo de comportamento de erro. Os valores possíveis são LastSuccessful e SpecificDeployment. 'Último sucesso'
'Implantação específica'
Nome Descrição Valor
contentVersion Se incluído, deverá corresponder ao ContentVersion no modelo. cadeia
URI O URI do arquivo de parâmetros. cadeia de caracteres (obrigatório)
Nome Descrição Valor
contentVersion Se incluído, deverá corresponder ao ContentVersion no modelo. cadeia
URI O URI do modelo a ser implantado. cadeia de caracteres (obrigatório)

Definição de recurso de modelo do ARM

O tipo de recurso de implantações pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Resources/deployments, adicione o JSON a seguir ao seu modelo.

{
  "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 da propriedade

Microsoft.Resources/deployments

Nome Descrição Valor
apiVersion A versão da API '2018-05-01'
local O local para armazenar os dados de implantação. cadeia
nome O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 64
Padrão = ^[-\w\._\(\)]+$ (obrigatório)
propriedades As propriedades de implantação. DeploymentPropertiesOrDeploymentPropertiesExtended (obrigatório)
tipo O tipo de recurso 'Microsoft.Resources/deployments'

Configuração de depuração

Nome Descrição Valor
detailLevel Especifica o tipo de informação a ser registrada em log para depuração. Os valores permitidos são none, requestContent, responseContent ou requestContent e responseContent separados por uma vírgula. O padrão é nenhum. Ao definir esse valor, considere cuidadosamente o tipo de informação que você está passando durante a implantação. Ao registrar em log informações sobre a solicitação ou resposta, você pode potencialmente expor dados confidenciais recuperados por meio das operações de implantação. cadeia

DeploymentPropertiesOrDeploymentPropertiesExtended

Nome Descrição Valor
configuração de depuração A configuração de depuração da implantação. Configuração de depuração
modo O modo usado para implantar recursos. Esse valor pode ser Incremental ou Concluído. No modo incremental, os recursos são implantados sem excluir recursos existentes que não estão incluídos no modelo. No modo Completo, os recursos são implantados e os recursos existentes no grupo de recursos que não estão incluídos no modelo são excluídos. Tenha cuidado ao usar o modo Completo, pois você pode excluir recursos sem querer. 'Completo'
'Incremental' (obrigatório)
onErrorDeployment A implantação no comportamento de erro. OnErrorDeploymentOrOnErrorDeploymentExtended
parâmetros Pares de nome e valor que definem os parâmetros de implantação para o modelo. Use esse elemento quando quiser fornecer os valores de parâmetro diretamente na solicitação em vez de vincular a um arquivo de parâmetro existente. Use a propriedade parametersLink ou a propriedade parameters, mas não ambos. Pode ser um JObject ou uma cadeia de caracteres JSON bem formada. qualquer
parâmetrosLink O URI do arquivo de parâmetros. Use esse elemento para vincular a um arquivo de parâmetros existente. Use a propriedade parametersLink ou a propriedade parameters, mas não ambos. ParâmetroLink
modelo O conteúdo do modelo. Use esse elemento quando quiser passar a sintaxe do modelo diretamente na solicitação em vez de vincular a um modelo existente. Pode ser uma cadeia de caracteres JObject ou JSON bem formada. Use a propriedade templateLink ou a propriedade de modelo, mas não ambos. qualquer
link de modelo O URI do modelo. Use a propriedade templateLink ou a propriedade de modelo, mas não ambos. Link do modelo

OnErrorDeploymentOrOnErrorDeploymentExtended

Nome Descrição Valor
nome_da_implantação A implantação a ser usada no caso de erro. cadeia
tipo A implantação no tipo de comportamento de erro. Os valores possíveis são LastSuccessful e SpecificDeployment. 'Último sucesso'
'Implantação específica'
Nome Descrição Valor
contentVersion Se incluído, deverá corresponder ao ContentVersion no modelo. cadeia
URI O URI do arquivo de parâmetros. cadeia de caracteres (obrigatório)
Nome Descrição Valor
contentVersion Se incluído, deverá corresponder ao ContentVersion no modelo. cadeia
URI O URI do modelo a ser implantado. cadeia de caracteres (obrigatório)

Exemplos de uso

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso de implantações pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Resources/deployments, adicione o Terraform a seguir ao seu modelo.

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 da propriedade

Microsoft.Resources/deployments

Nome Descrição Valor
local O local para armazenar os dados de implantação. cadeia
nome O nome do recurso cadeia de caracteres

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 64
Padrão = ^[-\w\._\(\)]+$ (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. cadeia de caracteres (obrigatório)
propriedades As propriedades de implantação. DeploymentPropertiesOrDeploymentPropertiesExtended (obrigatório)
tipo O tipo de recurso "Microsoft.Resources/deployments@2018-05-01"

Configuração de depuração

Nome Descrição Valor
detailLevel Especifica o tipo de informação a ser registrada em log para depuração. Os valores permitidos são none, requestContent, responseContent ou requestContent e responseContent separados por uma vírgula. O padrão é nenhum. Ao definir esse valor, considere cuidadosamente o tipo de informação que você está passando durante a implantação. Ao registrar em log informações sobre a solicitação ou resposta, você pode potencialmente expor dados confidenciais recuperados por meio das operações de implantação. cadeia

DeploymentPropertiesOrDeploymentPropertiesExtended

Nome Descrição Valor
configuração de depuração A configuração de depuração da implantação. Configuração de depuração
modo O modo usado para implantar recursos. Esse valor pode ser Incremental ou Concluído. No modo incremental, os recursos são implantados sem excluir recursos existentes que não estão incluídos no modelo. No modo Completo, os recursos são implantados e os recursos existentes no grupo de recursos que não estão incluídos no modelo são excluídos. Tenha cuidado ao usar o modo Completo, pois você pode excluir recursos sem querer. 'Completo'
'Incremental' (obrigatório)
onErrorDeployment A implantação no comportamento de erro. OnErrorDeploymentOrOnErrorDeploymentExtended
parâmetros Pares de nome e valor que definem os parâmetros de implantação para o modelo. Use esse elemento quando quiser fornecer os valores de parâmetro diretamente na solicitação em vez de vincular a um arquivo de parâmetro existente. Use a propriedade parametersLink ou a propriedade parameters, mas não ambos. Pode ser um JObject ou uma cadeia de caracteres JSON bem formada. qualquer
parâmetrosLink O URI do arquivo de parâmetros. Use esse elemento para vincular a um arquivo de parâmetros existente. Use a propriedade parametersLink ou a propriedade parameters, mas não ambos. ParâmetroLink
modelo O conteúdo do modelo. Use esse elemento quando quiser passar a sintaxe do modelo diretamente na solicitação em vez de vincular a um modelo existente. Pode ser uma cadeia de caracteres JObject ou JSON bem formada. Use a propriedade templateLink ou a propriedade de modelo, mas não ambos. qualquer
link de modelo O URI do modelo. Use a propriedade templateLink ou a propriedade de modelo, mas não ambos. Link do modelo

OnErrorDeploymentOrOnErrorDeploymentExtended

Nome Descrição Valor
nome_da_implantação A implantação a ser usada no caso de erro. cadeia
tipo A implantação no tipo de comportamento de erro. Os valores possíveis são LastSuccessful e SpecificDeployment. 'Último sucesso'
'Implantação específica'
Nome Descrição Valor
contentVersion Se incluído, deverá corresponder ao ContentVersion no modelo. cadeia
URI O URI do arquivo de parâmetros. cadeia de caracteres (obrigatório)
Nome Descrição Valor
contentVersion Se incluído, deverá corresponder ao ContentVersion no modelo. cadeia
URI O URI do modelo a ser implantado. cadeia de caracteres (obrigatório)

Exemplos de uso

Exemplos do Terraform

Um exemplo básico de implantação de Implantação de Modelo.

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