Развертывания Microsoft.Resources 2021-04-01

2025-05-08

Замечания

Для Bicep рекомендуется использовать модули вместо этого типа ресурсов.

Определение ресурсов Bicep

Тип ресурса развертывания можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Resources/deployments, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.Resources/deployments@2021-04-01' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    debugSetting: {
      detailLevel: 'string'
    }
    expressionEvaluationOptions: {
      scope: 'string'
    }
    mode: 'string'
    onErrorDeployment: {
      deploymentName: 'string'
      type: 'string'
    }
    parameters: any(...)
    parametersLink: {
      contentVersion: 'string'
      uri: 'string'
    }
    template: any(...)
    templateLink: {
      contentVersion: 'string'
      id: 'string'
      queryString: 'string'
      relativePath: 'string'
      uri: 'string'
    }
  }
  tags: {
    {customized property}: 'string'
  }
}

Значения свойств

Microsoft.Resources/развертывания

Имя	Описание	Ценность
расположение	Расположение для хранения данных развертывания.	струна
имя	имя ресурса.	струна Ограничения целостности: Минимальная длина = 1 Максимальная длина = 64 Pattern = `^[-\w\._]+$` (обязательно)
свойства	Свойства развертывания.	DeploymentPropertiesOrDeploymentPropertiesExtended (обязательно)
охват	Используется при создании ресурса в области, отличной от области развертывания.	Задайте для этого свойства символьное имя ресурса, чтобы применить ресурс расширения.
Теги	Теги ресурсов	Словарь имен и значений тегов. См . теги в шаблонах

Настройка отладки

Имя	Описание	Ценность
Уровень детализации	Указывает тип сведений для входа в журнал для отладки. Допустимые значения не имеют значения, requestContent, responseContent или requestContent и responseContent, разделенные запятой. Значение по умолчанию — нет. При настройке этого значения внимательно рассмотрите тип информации, которую вы передаете во время развертывания. Ведение журнала сведений о запросе или ответе может потенциально предоставлять конфиденциальные данные, полученные с помощью операций развертывания.	струна

DeploymentPropertiesOrDeploymentPropertiesExtended

Имя	Описание	Ценность
debugSetting	Параметр отладки развертывания.	Настройка отладки
expressionEvaluationOptions	Указывает, оцениваются ли выражения шаблона в области родительского шаблона или вложенного шаблона. Применимо только к вложенным шаблонам. Если не указано, значением по умолчанию является outer.	ExpressionEvaluationOptions (Параметры оценки)
режим	Режим, используемый для развертывания ресурсов. Это значение может быть добавочным или завершенным. В добавочном режиме ресурсы развертываются без удаления существующих ресурсов, не включенных в шаблон. В полном режиме ресурсы развертываются и существующие ресурсы в группе ресурсов, не включенные в шаблон, удаляются. Будьте осторожны при использовании режима завершения, так как вы можете непреднамеренно удалить ресурсы.	"Завершено" "Добавочный" (обязательный)
onErrorDeployment	Развертывание по поведению ошибок.	OnErrorDeploymentOrOnErrorDeploymentExtended
Параметры	Пары имен и значений, определяющие параметры развертывания для шаблона. Этот элемент используется для предоставления значений параметров непосредственно в запросе, а не ссылки на существующий файл параметров. Используйте свойство parametersLink или свойство параметров, но не оба. Это может быть JObject или хорошо сформированная строка JSON.	любой
параметрыСсылка	Универсальный код ресурса (URI) файла параметров. Этот элемент используется для связывания с существующим файлом параметров. Используйте свойство parametersLink или свойство параметров, но не оба.	ПараметрыСсылка
шаблон	Содержимое шаблона. Этот элемент используется при передаче синтаксиса шаблона непосредственно в запросе, а не ссылки на существующий шаблон. Это может быть строка JObject или хорошо сформированная строка JSON. Используйте свойство templateLink или свойство шаблона, но не оба.	любой
шаблонСсылка	Универсальный код ресурса (URI) шаблона. Используйте свойство templateLink или свойство шаблона, но не оба.	Ссылка на шаблон

DeploymentTags

Имя	Описание	Ценность

ExpressionEvaluationOptions (Параметры оценки)

Имя	Описание	Ценность
охват	Область видимости, используемая для вычисления параметров, переменных и функций во вложенном шаблоне.	«Внутренний» "NotSpecified" «Внешний»

OnErrorDeploymentOrOnErrorDeploymentExtended

Имя	Описание	Ценность
имя_развертывания	Развертывание, используемое в случае ошибки.	струна
тип	Развертывание по типу поведения ошибки. Возможные значения: LastSuccessful и SpecificDeployment.	"LastSuccessful" "SpecificDeployment"

ПараметрыСсылка

Имя	Описание	Ценность
версия содержимого	Если этот параметр включен, должен соответствовать ContentVersion в шаблоне.	струна
УРИ	URI файла параметров.	строка (обязательно)

Ссылка на шаблон

Имя	Описание	Ценность
версия содержимого	Если этот параметр включен, должен соответствовать ContentVersion в шаблоне.	струна
идентификатор	Идентификатор ресурса спецификации шаблона. Используйте свойство идентификатора или URI, но не оба.	струна
queryString	Строка запроса (например, маркер SAS), используемая с универсальным кодом ресурса (URI) templateLink.	струна
relativePath	Свойство relativePath можно использовать для развертывания связанного шаблона в расположении относительно родительского элемента. Если родительский шаблон связан с TemplateSpec, это будет ссылаться на артефакт в TemplateSpec. Если родительский объект связан с универсальным кодом ресурса (URI), дочернее развертывание будет сочетанием родительских и относительных URIPath.	струна
УРИ	Универсальный код ресурса (URI) шаблона для развертывания. Используйте URI или свойство id, но не оба.	струна

Определение ресурса шаблона ARM

Тип ресурса развертывания можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Resources/deployments, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.Resources/deployments",
  "apiVersion": "2021-04-01",
  "name": "string",
  "location": "string",
  "properties": {
    "debugSetting": {
      "detailLevel": "string"
    },
    "expressionEvaluationOptions": {
      "scope": "string"
    },
    "mode": "string",
    "onErrorDeployment": {
      "deploymentName": "string",
      "type": "string"
    },
    "parameters": {},
    "parametersLink": {
      "contentVersion": "string",
      "uri": "string"
    },
    "template": {},
    "templateLink": {
      "contentVersion": "string",
      "id": "string",
      "queryString": "string",
      "relativePath": "string",
      "uri": "string"
    }
  },
  "tags": {
    "{customized property}": "string"
  }
}

Значения свойств

Microsoft.Resources/развертывания

Имя	Описание	Ценность
apiVersion	Версия API	'2021-04-01'
расположение	Расположение для хранения данных развертывания.	струна
имя	имя ресурса.	струна Ограничения целостности: Минимальная длина = 1 Максимальная длина = 64 Pattern = `^[-\w\._]+$` (обязательно)
свойства	Свойства развертывания.	DeploymentPropertiesOrDeploymentPropertiesExtended (обязательно)
Теги	Теги ресурсов	Словарь имен и значений тегов. См . теги в шаблонах
тип	Тип ресурса	"Microsoft.Resources/deployments"

Настройка отладки

Имя	Описание	Ценность
Уровень детализации	Указывает тип сведений для входа в журнал для отладки. Допустимые значения не имеют значения, requestContent, responseContent или requestContent и responseContent, разделенные запятой. Значение по умолчанию — нет. При настройке этого значения внимательно рассмотрите тип информации, которую вы передаете во время развертывания. Ведение журнала сведений о запросе или ответе может потенциально предоставлять конфиденциальные данные, полученные с помощью операций развертывания.	струна

DeploymentPropertiesOrDeploymentPropertiesExtended

Имя	Описание	Ценность
debugSetting	Параметр отладки развертывания.	Настройка отладки
expressionEvaluationOptions	Указывает, оцениваются ли выражения шаблона в области родительского шаблона или вложенного шаблона. Применимо только к вложенным шаблонам. Если не указано, значением по умолчанию является outer.	ExpressionEvaluationOptions (Параметры оценки)
режим	Режим, используемый для развертывания ресурсов. Это значение может быть добавочным или завершенным. В добавочном режиме ресурсы развертываются без удаления существующих ресурсов, не включенных в шаблон. В полном режиме ресурсы развертываются и существующие ресурсы в группе ресурсов, не включенные в шаблон, удаляются. Будьте осторожны при использовании режима завершения, так как вы можете непреднамеренно удалить ресурсы.	"Завершено" "Добавочный" (обязательный)
onErrorDeployment	Развертывание по поведению ошибок.	OnErrorDeploymentOrOnErrorDeploymentExtended
Параметры	Пары имен и значений, определяющие параметры развертывания для шаблона. Этот элемент используется для предоставления значений параметров непосредственно в запросе, а не ссылки на существующий файл параметров. Используйте свойство parametersLink или свойство параметров, но не оба. Это может быть JObject или хорошо сформированная строка JSON.	любой
параметрыСсылка	Универсальный код ресурса (URI) файла параметров. Этот элемент используется для связывания с существующим файлом параметров. Используйте свойство parametersLink или свойство параметров, но не оба.	ПараметрыСсылка
шаблон	Содержимое шаблона. Этот элемент используется при передаче синтаксиса шаблона непосредственно в запросе, а не ссылки на существующий шаблон. Это может быть строка JObject или хорошо сформированная строка JSON. Используйте свойство templateLink или свойство шаблона, но не оба.	любой
шаблонСсылка	Универсальный код ресурса (URI) шаблона. Используйте свойство templateLink или свойство шаблона, но не оба.	Ссылка на шаблон

DeploymentTags

Имя	Описание	Ценность

ExpressionEvaluationOptions (Параметры оценки)

Имя	Описание	Ценность
охват	Область видимости, используемая для вычисления параметров, переменных и функций во вложенном шаблоне.	«Внутренний» "NotSpecified" «Внешний»

OnErrorDeploymentOrOnErrorDeploymentExtended

Имя	Описание	Ценность
имя_развертывания	Развертывание, используемое в случае ошибки.	струна
тип	Развертывание по типу поведения ошибки. Возможные значения: LastSuccessful и SpecificDeployment.	"LastSuccessful" "SpecificDeployment"

ПараметрыСсылка

Имя	Описание	Ценность
версия содержимого	Если этот параметр включен, должен соответствовать ContentVersion в шаблоне.	струна
УРИ	URI файла параметров.	строка (обязательно)

Ссылка на шаблон

Имя	Описание	Ценность
версия содержимого	Если этот параметр включен, должен соответствовать ContentVersion в шаблоне.	струна
идентификатор	Идентификатор ресурса спецификации шаблона. Используйте свойство идентификатора или URI, но не оба.	струна
queryString	Строка запроса (например, маркер SAS), используемая с универсальным кодом ресурса (URI) templateLink.	струна
relativePath	Свойство relativePath можно использовать для развертывания связанного шаблона в расположении относительно родительского элемента. Если родительский шаблон связан с TemplateSpec, это будет ссылаться на артефакт в TemplateSpec. Если родительский объект связан с универсальным кодом ресурса (URI), дочернее развертывание будет сочетанием родительских и относительных URIPath.	струна
УРИ	Универсальный код ресурса (URI) шаблона для развертывания. Используйте URI или свойство id, но не оба.	струна

Примеры использования

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса развертывания можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Resources/deployments, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Resources/deployments@2021-04-01"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      debugSetting = {
        detailLevel = "string"
      }
      expressionEvaluationOptions = {
        scope = "string"
      }
      mode = "string"
      onErrorDeployment = {
        deploymentName = "string"
        type = "string"
      }
      parameters = ?
      parametersLink = {
        contentVersion = "string"
        uri = "string"
      }
      template = ?
      templateLink = {
        contentVersion = "string"
        id = "string"
        queryString = "string"
        relativePath = "string"
        uri = "string"
      }
    }
  }
}

Значения свойств

Microsoft.Resources/развертывания

Имя	Описание	Ценность
расположение	Расположение для хранения данных развертывания.	струна
имя	имя ресурса.	струна Ограничения целостности: Минимальная длина = 1 Максимальная длина = 64 Pattern = `^[-\w\._]+$` (обязательно)
идентификатор_родителя	Идентификатор ресурса для применения этого ресурса расширения.	строка (обязательно)
свойства	Свойства развертывания.	DeploymentPropertiesOrDeploymentPropertiesExtended (обязательно)
Теги	Теги ресурсов	Словарь имен и значений тегов.
тип	Тип ресурса	"Microsoft.Resources/deployments@2021-04-01"

Настройка отладки

Имя	Описание	Ценность
Уровень детализации	Указывает тип сведений для входа в журнал для отладки. Допустимые значения не имеют значения, requestContent, responseContent или requestContent и responseContent, разделенные запятой. Значение по умолчанию — нет. При настройке этого значения внимательно рассмотрите тип информации, которую вы передаете во время развертывания. Ведение журнала сведений о запросе или ответе может потенциально предоставлять конфиденциальные данные, полученные с помощью операций развертывания.	струна

DeploymentPropertiesOrDeploymentPropertiesExtended

Имя	Описание	Ценность
debugSetting	Параметр отладки развертывания.	Настройка отладки
expressionEvaluationOptions	Указывает, оцениваются ли выражения шаблона в области родительского шаблона или вложенного шаблона. Применимо только к вложенным шаблонам. Если не указано, значением по умолчанию является outer.	ExpressionEvaluationOptions (Параметры оценки)
режим	Режим, используемый для развертывания ресурсов. Это значение может быть добавочным или завершенным. В добавочном режиме ресурсы развертываются без удаления существующих ресурсов, не включенных в шаблон. В полном режиме ресурсы развертываются и существующие ресурсы в группе ресурсов, не включенные в шаблон, удаляются. Будьте осторожны при использовании режима завершения, так как вы можете непреднамеренно удалить ресурсы.	"Завершено" "Добавочный" (обязательный)
onErrorDeployment	Развертывание по поведению ошибок.	OnErrorDeploymentOrOnErrorDeploymentExtended
Параметры	Пары имен и значений, определяющие параметры развертывания для шаблона. Этот элемент используется для предоставления значений параметров непосредственно в запросе, а не ссылки на существующий файл параметров. Используйте свойство parametersLink или свойство параметров, но не оба. Это может быть JObject или хорошо сформированная строка JSON.	любой
параметрыСсылка	Универсальный код ресурса (URI) файла параметров. Этот элемент используется для связывания с существующим файлом параметров. Используйте свойство parametersLink или свойство параметров, но не оба.	ПараметрыСсылка
шаблон	Содержимое шаблона. Этот элемент используется при передаче синтаксиса шаблона непосредственно в запросе, а не ссылки на существующий шаблон. Это может быть строка JObject или хорошо сформированная строка JSON. Используйте свойство templateLink или свойство шаблона, но не оба.	любой
шаблонСсылка	Универсальный код ресурса (URI) шаблона. Используйте свойство templateLink или свойство шаблона, но не оба.	Ссылка на шаблон

DeploymentTags

Имя	Описание	Ценность

ExpressionEvaluationOptions (Параметры оценки)

Имя	Описание	Ценность
охват	Область видимости, используемая для вычисления параметров, переменных и функций во вложенном шаблоне.	«Внутренний» "NotSpecified" «Внешний»

OnErrorDeploymentOrOnErrorDeploymentExtended

Имя	Описание	Ценность
имя_развертывания	Развертывание, используемое в случае ошибки.	струна
тип	Развертывание по типу поведения ошибки. Возможные значения: LastSuccessful и SpecificDeployment.	"LastSuccessful" "SpecificDeployment"

ПараметрыСсылка

Имя	Описание	Ценность
версия содержимого	Если этот параметр включен, должен соответствовать ContentVersion в шаблоне.	струна
УРИ	URI файла параметров.	строка (обязательно)

Ссылка на шаблон

Имя	Описание	Ценность
версия содержимого	Если этот параметр включен, должен соответствовать ContentVersion в шаблоне.	струна
идентификатор	Идентификатор ресурса спецификации шаблона. Используйте свойство идентификатора или URI, но не оба.	струна
queryString	Строка запроса (например, маркер SAS), используемая с универсальным кодом ресурса (URI) templateLink.	струна
relativePath	Свойство relativePath можно использовать для развертывания связанного шаблона в расположении относительно родительского элемента. Если родительский шаблон связан с TemplateSpec, это будет ссылаться на артефакт в TemplateSpec. Если родительский объект связан с универсальным кодом ресурса (URI), дочернее развертывание будет сочетанием родительских и относительных URIPath.	струна
УРИ	Универсальный код ресурса (URI) шаблона для развертывания. Используйте URI или свойство id, но не оба.	струна

Поделиться через

Развертывания Microsoft.Resources 2021-04-01

Замечания

Определение ресурсов Bicep

Формат ресурса

Значения свойств

Microsoft.Resources/развертывания

Настройка отладки

DeploymentPropertiesOrDeploymentPropertiesExtended

DeploymentTags

ExpressionEvaluationOptions (Параметры оценки)

OnErrorDeploymentOrOnErrorDeploymentExtended

ПараметрыСсылка

Ссылка на шаблон

Определение ресурса шаблона ARM

Формат ресурса

Значения свойств

Microsoft.Resources/развертывания

Настройка отладки

DeploymentPropertiesOrDeploymentPropertiesExtended

DeploymentTags

ExpressionEvaluationOptions (Параметры оценки)

OnErrorDeploymentOrOnErrorDeploymentExtended

ПараметрыСсылка

Ссылка на шаблон

Примеры использования

Определение ресурса Terraform (поставщик AzAPI)

Формат ресурса

Значения свойств

Microsoft.Resources/развертывания

Настройка отладки

DeploymentPropertiesOrDeploymentPropertiesExtended

DeploymentTags

ExpressionEvaluationOptions (Параметры оценки)

OnErrorDeploymentOrOnErrorDeploymentExtended

ПараметрыСсылка

Ссылка на шаблон

Обратная связь

Дополнительные ресурсы