Partilhar via

Implantações Microsoft.Resources

  • Artigo

Comentários

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

Definição de recursos do bíceps

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

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

Formato do recurso

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

resource symbolicname 'Microsoft.Resources/deployments@2024-11-01' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    debugSetting: {
      detailLevel: 'string'
    }
    expressionEvaluationOptions: {
      scope: 'string'
    }
    mode: 'string'
    onErrorDeployment: {
      deploymentName: 'string'
      type: 'string'
    }
    parameters: {
      {customized property}: {
        reference: {
          keyVault: {
            id: 'string'
          }
          secretName: 'string'
          secretVersion: 'string'
        }
        value: any(Azure.Bicep.Types.Concrete.AnyType)
      }
    }
    parametersLink: {
      contentVersion: 'string'
      uri: 'string'
    }
    template: any(Azure.Bicep.Types.Concrete.AnyType)
    templateLink: {
      contentVersion: 'string'
      id: 'string'
      queryString: 'string'
      relativePath: 'string'
      uri: 'string'
    }
    validationLevel: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Valores de propriedade

DepuraçãoConfiguração

Designação Descrição Valor
nível de detalhe Especifica o tipo de informação a ser registrada para depuração. Os valores permitidos são none, requestContent, responseContent ou ambos 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 informações sobre a solicitação ou resposta, você pode expor dados confidenciais recuperados por meio das operações de implantação. string

DeploymentParameter

Designação Descrição Valor
referência Referência de parâmetro do Azure Key Vault. KeyVaultParameterReference
valor Valor de entrada para o parâmetro . qualquer

DeploymentPropertiesOrDeploymentPropertiesExtended

Designação Descrição Valor
debugSetting A configuração de depuração da implantação. DebugSetting
expressionEvaluationOptions Especifica se as expressões de modelo são avaliadas dentro do escopo do modelo pai ou aninhado. Aplicável apenas a modelos aninhados. Se não for especificado, o valor padrão será externo. ExpressionEvaluationOptions
modo O modo usado para implantar recursos. Esse valor pode ser Incremental ou Completo. No modo Incremental, os recursos são implantados sem excluir os 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 involuntariamente. '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 ambas. Pode ser um JObject ou uma cadeia de caracteres JSON bem formada. DeploymentPropertiesParameters
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 ambas. ParametersLink
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 um JObject ou uma cadeia de caracteres JSON bem formada. Use a propriedade templateLink ou a propriedade template, mas não ambas. qualquer
modeloLink O URI do modelo. Use a propriedade templateLink ou a propriedade template, mas não ambas. TemplateLink
validationLevel O nível de validação da implantação 'Fornecedor'
'ProviderNoRbac'
'Modelo'

DeploymentPropertiesParameters

Designação Descrição Valor

DeploymentTags

Designação Descrição Valor

ExpressionEvaluationOptions

Designação Descrição Valor
Âmbito de aplicação O escopo a ser usado para avaliação de parâmetros, variáveis e funções em um modelo aninhado. 'Interior'
'Não especificado'
'Exterior'

KeyVaultParameterReference

Designação Descrição Valor
keyVault [en] Referência do Azure Key Vault. KeyVaultReference (obrigatório)
secretName Nome secreto do Azure Key Vault. string (obrigatório)
secretVersion Versão secreta do Azure Key Vault. string

KeyVaultReference

Designação Descrição Valor
ID ID do recurso do Azure Key Vault. string (obrigatório)

Microsoft.Resources/implantações

Designação Descrição Valor
Localização O local para armazenar os dados de implantação. string
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1
Padrão = ^[-\w\._\(\)]+$ (obrigatório)
propriedades As propriedades de implantação. DeploymentPropertiesOrDeploymentPropertiesExtended (obrigatório)
Âmbito de aplicação 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 .
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos

OnErrorDeploymentOrOnErrorDeploymentExtended

Designação Descrição Valor
deploymentName A implantação a ser usada em caso de erro. string
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'
Designação Descrição Valor
contentVersion Se incluído, deve corresponder ao ContentVersion no modelo. string
URI O URI do arquivo de parâmetros. string (obrigatório)
Designação Descrição Valor
contentVersion Se incluído, deve corresponder ao ContentVersion no modelo. string
ID Use a propriedade id ou uri, mas não ambas. string
queryString A cadeia de caracteres de consulta (por exemplo, um token SAS) a ser usada com o URI templateLink. string
relativePath A propriedade relativePath pode ser usada para implantar um modelo vinculado em um local relativo ao pai. Se o modelo pai foi vinculado a um TemplateSpec, isso fará referência a um artefato no TemplateSpec. Se o pai foi vinculado a um URI, a implantação filho será uma combinação dos URIs pai e relativePath string
URI O URI do modelo a ser implantado. Use a propriedade uri ou id, mas não ambas. string

Definição de recurso de modelo ARM

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

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

Formato do recurso

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

{
  "type": "Microsoft.Resources/deployments",
  "apiVersion": "2024-11-01",
  "name": "string",
  "location": "string",
  "properties": {
    "debugSetting": {
      "detailLevel": "string"
    },
    "expressionEvaluationOptions": {
      "scope": "string"
    },
    "mode": "string",
    "onErrorDeployment": {
      "deploymentName": "string",
      "type": "string"
    },
    "parameters": {
      "{customized property}": {
        "reference": {
          "keyVault": {
            "id": "string"
          },
          "secretName": "string",
          "secretVersion": "string"
        },
        "value": {}
      }
    },
    "parametersLink": {
      "contentVersion": "string",
      "uri": "string"
    },
    "template": {},
    "templateLink": {
      "contentVersion": "string",
      "id": "string",
      "queryString": "string",
      "relativePath": "string",
      "uri": "string"
    },
    "validationLevel": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Valores de propriedade

DepuraçãoConfiguração

Designação Descrição Valor
nível de detalhe Especifica o tipo de informação a ser registrada para depuração. Os valores permitidos são none, requestContent, responseContent ou ambos 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 informações sobre a solicitação ou resposta, você pode expor dados confidenciais recuperados por meio das operações de implantação. string

DeploymentParameter

Designação Descrição Valor
referência Referência de parâmetro do Azure Key Vault. KeyVaultParameterReference
valor Valor de entrada para o parâmetro . qualquer

DeploymentPropertiesOrDeploymentPropertiesExtended

Designação Descrição Valor
debugSetting A configuração de depuração da implantação. DebugSetting
expressionEvaluationOptions Especifica se as expressões de modelo são avaliadas dentro do escopo do modelo pai ou aninhado. Aplicável apenas a modelos aninhados. Se não for especificado, o valor padrão será externo. ExpressionEvaluationOptions
modo O modo usado para implantar recursos. Esse valor pode ser Incremental ou Completo. No modo Incremental, os recursos são implantados sem excluir os 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 involuntariamente. '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 ambas. Pode ser um JObject ou uma cadeia de caracteres JSON bem formada. DeploymentPropertiesParameters
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 ambas. ParametersLink
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 um JObject ou uma cadeia de caracteres JSON bem formada. Use a propriedade templateLink ou a propriedade template, mas não ambas. qualquer
modeloLink O URI do modelo. Use a propriedade templateLink ou a propriedade template, mas não ambas. TemplateLink
validationLevel O nível de validação da implantação 'Fornecedor'
'ProviderNoRbac'
'Modelo'

DeploymentPropertiesParameters

Designação Descrição Valor

DeploymentTags

Designação Descrição Valor

ExpressionEvaluationOptions

Designação Descrição Valor
Âmbito de aplicação O escopo a ser usado para avaliação de parâmetros, variáveis e funções em um modelo aninhado. 'Interior'
'Não especificado'
'Exterior'

KeyVaultParameterReference

Designação Descrição Valor
keyVault [en] Referência do Azure Key Vault. KeyVaultReference (obrigatório)
secretName Nome secreto do Azure Key Vault. string (obrigatório)
secretVersion Versão secreta do Azure Key Vault. string

KeyVaultReference

Designação Descrição Valor
ID ID do recurso do Azure Key Vault. string (obrigatório)

Microsoft.Resources/implantações

Designação Descrição Valor
apiVersion A versão api '2024-11-01'
Localização O local para armazenar os dados de implantação. string
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1
Padrão = ^[-\w\._\(\)]+$ (obrigatório)
propriedades As propriedades de implantação. DeploymentPropertiesOrDeploymentPropertiesExtended (obrigatório)
Etiquetas Tags de recursos Dicionário de nomes e valores de tags. Consulte Tags em modelos
tipo O tipo de recurso 'Microsoft.Resources/deployments'

OnErrorDeploymentOrOnErrorDeploymentExtended

Designação Descrição Valor
deploymentName A implantação a ser usada em caso de erro. string
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'
Designação Descrição Valor
contentVersion Se incluído, deve corresponder ao ContentVersion no modelo. string
URI O URI do arquivo de parâmetros. string (obrigatório)
Designação Descrição Valor
contentVersion Se incluído, deve corresponder ao ContentVersion no modelo. string
ID Use a propriedade id ou uri, mas não ambas. string
queryString A cadeia de caracteres de consulta (por exemplo, um token SAS) a ser usada com o URI templateLink. string
relativePath A propriedade relativePath pode ser usada para implantar um modelo vinculado em um local relativo ao pai. Se o modelo pai foi vinculado a um TemplateSpec, isso fará referência a um artefato no TemplateSpec. Se o pai foi vinculado a um URI, a implantação filho será uma combinação dos URIs pai e relativePath string
URI O URI do modelo a ser implantado. Use a propriedade uri ou id, mas não ambas. string

Definição de recursos Terraform (provedor AzAPI)

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

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

Formato do recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Resources/deployments@2024-11-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      debugSetting = {
        detailLevel = "string"
      }
      expressionEvaluationOptions = {
        scope = "string"
      }
      mode = "string"
      onErrorDeployment = {
        deploymentName = "string"
        type = "string"
      }
      parameters = {
        {customized property} = {
          reference = {
            keyVault = {
              id = "string"
            }
            secretName = "string"
            secretVersion = "string"
          }
          value = ?
        }
      }
      parametersLink = {
        contentVersion = "string"
        uri = "string"
      }
      template = ?
      templateLink = {
        contentVersion = "string"
        id = "string"
        queryString = "string"
        relativePath = "string"
        uri = "string"
      }
      validationLevel = "string"
    }
  })
}

Valores de propriedade

DepuraçãoConfiguração

Designação Descrição Valor
nível de detalhe Especifica o tipo de informação a ser registrada para depuração. Os valores permitidos são none, requestContent, responseContent ou ambos 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 informações sobre a solicitação ou resposta, você pode expor dados confidenciais recuperados por meio das operações de implantação. string

DeploymentParameter

Designação Descrição Valor
referência Referência de parâmetro do Azure Key Vault. KeyVaultParameterReference
valor Valor de entrada para o parâmetro . qualquer

DeploymentPropertiesOrDeploymentPropertiesExtended

Designação Descrição Valor
debugSetting A configuração de depuração da implantação. DebugSetting
expressionEvaluationOptions Especifica se as expressões de modelo são avaliadas dentro do escopo do modelo pai ou aninhado. Aplicável apenas a modelos aninhados. Se não for especificado, o valor padrão será externo. ExpressionEvaluationOptions
modo O modo usado para implantar recursos. Esse valor pode ser Incremental ou Completo. No modo Incremental, os recursos são implantados sem excluir os 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 involuntariamente. '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 ambas. Pode ser um JObject ou uma cadeia de caracteres JSON bem formada. DeploymentPropertiesParameters
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 ambas. ParametersLink
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 um JObject ou uma cadeia de caracteres JSON bem formada. Use a propriedade templateLink ou a propriedade template, mas não ambas. qualquer
modeloLink O URI do modelo. Use a propriedade templateLink ou a propriedade template, mas não ambas. TemplateLink
validationLevel O nível de validação da implantação 'Fornecedor'
'ProviderNoRbac'
'Modelo'

DeploymentPropertiesParameters

Designação Descrição Valor

DeploymentTags

Designação Descrição Valor

ExpressionEvaluationOptions

Designação Descrição Valor
Âmbito de aplicação O escopo a ser usado para avaliação de parâmetros, variáveis e funções em um modelo aninhado. 'Interior'
'Não especificado'
'Exterior'

KeyVaultParameterReference

Designação Descrição Valor
keyVault [en] Referência do Azure Key Vault. KeyVaultReference (obrigatório)
secretName Nome secreto do Azure Key Vault. string (obrigatório)
secretVersion Versão secreta do Azure Key Vault. string

KeyVaultReference

Designação Descrição Valor
ID ID do recurso do Azure Key Vault. string (obrigatório)

Microsoft.Resources/implantações

Designação Descrição Valor
Localização O local para armazenar os dados de implantação. string
Designação O nome do recurso string

Restrições:
Comprimento mínimo = 1
Comprimento máximo = 1
Padrão = ^[-\w\._\(\)]+$ (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. string (obrigatório)
propriedades As propriedades de implantação. DeploymentPropertiesOrDeploymentPropertiesExtended (obrigatório)
Etiquetas Tags de recursos Dicionário de nomes e valores de tags.
tipo O tipo de recurso "Microsoft.Resources/deployments@2024-11-01"

OnErrorDeploymentOrOnErrorDeploymentExtended

Designação Descrição Valor
deploymentName A implantação a ser usada em caso de erro. string
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'
Designação Descrição Valor
contentVersion Se incluído, deve corresponder ao ContentVersion no modelo. string
URI O URI do arquivo de parâmetros. string (obrigatório)
Designação Descrição Valor
contentVersion Se incluído, deve corresponder ao ContentVersion no modelo. string
ID Use a propriedade id ou uri, mas não ambas. string
queryString A cadeia de caracteres de consulta (por exemplo, um token SAS) a ser usada com o URI templateLink. string
relativePath A propriedade relativePath pode ser usada para implantar um modelo vinculado em um local relativo ao pai. Se o modelo pai foi vinculado a um TemplateSpec, isso fará referência a um artefato no TemplateSpec. Se o pai foi vinculado a um URI, a implantação filho será uma combinação dos URIs pai e relativePath string
URI O URI do modelo a ser implantado. Use a propriedade uri ou id, mas não ambas. string