Deployments - What If At Subscription Scope
Возвращает изменения, которые будут внесены развертыванием при выполнении в область подписки.
POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Resources/deployments/{deploymentName}/whatIf?api-version=2021-04-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
deployment
|
path | True |
string |
Имя развертывания. Шаблон регулярного выражения: |
subscription
|
path | True |
string |
Идентификатор подписки Microsoft Azure. |
api-version
|
query | True |
string |
Версия API, используемая для данной операции. |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
properties | True |
Свойства развертывания. |
|
location |
string |
Расположение для хранения данных развертывания. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
ОК. Возвращает состояние операции What-If |
|
202 Accepted |
Принято — возвращает URL-адрес в заголовке Location для запроса состояния длительной операции. Заголовки
|
|
Other Status Codes |
Ответ об ошибке, описывающий причину сбоя операции. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
Имя | Описание |
---|---|
user_impersonation | олицетворения учетной записи пользователя |
Примеры
Predict template changes at subscription scope
Образец запроса
POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000001/providers/Microsoft.Resources/deployments/my-deployment/whatIf?api-version=2021-04-01
{
"location": "westus",
"properties": {
"templateLink": {
"uri": "https://example.com/exampleTemplate.json"
},
"parameters": {},
"mode": "Incremental"
}
}
Пример ответа
{
"status": "Succeeded",
"properties": {
"changes": [
{
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myExistingIdentity",
"changeType": "Modify",
"before": {
"apiVersion": "2018-11-30",
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myExistingIdentity",
"type": "Microsoft.ManagedIdentity/userAssignedIdentities",
"name": "myExistingIdentity",
"location": "westus2"
},
"after": {
"apiVersion": "2018-11-30",
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myExistingIdentity",
"type": "Microsoft.ManagedIdentity/userAssignedIdentities",
"name": "myExistingIdentity",
"location": "westus2",
"tags": {
"myNewTag": "my tag value"
}
},
"delta": [
{
"path": "tags.myNewTag",
"propertyChangeType": "Create",
"after": "my tag value"
}
]
},
{
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myNewIdentity",
"changeType": "Create",
"after": {
"apiVersion": "2018-11-30",
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group/providers/Microsoft.ManagedIdentity/userAssignedIdentities/myNewIdentity",
"type": "Microsoft.ManagedIdentity/userAssignedIdentities",
"name": "myNewIdentity",
"location": "eastus",
"tags": {
"myOtherNewTag": "another new tag value"
}
}
},
{
"resourceId": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group2",
"changeType": "Create",
"after": {
"apiVersion": "2019-03-01",
"id": "/subscriptions/00000000-0000-0000-0000-000000000001/resourceGroups/my-resource-group2",
"type": "Microsoft.Resources/resourceGroups",
"name": "my-resource-group2",
"location": "{location3}"
}
}
]
}
}
Location: /subscriptions/00000000-0000-0000-0000-000000000000/ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
Определения
Имя | Описание |
---|---|
Change |
Тип изменения, которое будет внесено в ресурс при выполнении развертывания. |
Cloud |
Ответ об ошибке для запроса на управление ресурсами. |
Debug |
Параметр отладки. |
Deployment |
Режим, используемый для развертывания ресурсов. Это значение может быть добавочным или завершенным. В инкрементном режиме ресурсы развертываются без удаления существующих ресурсов, не включенных в шаблон. В режиме Завершения ресурсы развертываются, а существующие ресурсы в группе ресурсов, не включенные в шаблон, удаляются. Будьте внимательны при использовании полного режима, так как вы можете непреднамеренно удалить ресурсы. |
Deployment |
Параметры операции развертывания "Что если". |
Deployment |
Свойства развертывания "Что если". |
Deployment |
Параметры операции развертывания What-If. |
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Error |
Сообщение об ошибке |
Expression |
Указывает, вычисляются ли выражения шаблона в область родительского или вложенного шаблона. |
Expression |
Область, используемый для оценки параметров, переменных и функций во вложенном шаблоне. |
On |
Развертывание при поведении ошибки. |
On |
Тип поведения развертывания при ошибке. Возможные значения: LastSuccessful и SpecificDeployment. |
Parameters |
Сущность, представляющая ссылку на параметры развертывания. |
Property |
Тип изменения свойства. |
Template |
Сущность, представляющая ссылку на шаблон. |
What |
Сведения об изменении одного ресурса, прогнозируемом операцией What-If. |
What |
Результат операции What-If. Содержит список прогнозируемых изменений и URL-ссылку для получения следующего набора результатов. |
What |
Прогнозируемое изменение свойства ресурса. |
What |
Формат результатов What-If |
ChangeType
Тип изменения, которое будет внесено в ресурс при выполнении развертывания.
Имя | Тип | Описание |
---|---|---|
Create |
string |
Ресурс не существует в текущем состоянии, но присутствует в нужном состоянии. Ресурс будет создан при выполнении развертывания. |
Delete |
string |
Ресурс существует в текущем состоянии и отсутствует в нужном состоянии. Ресурс будет удален при выполнении развертывания. |
Deploy |
string |
Ресурс существует в текущем и требуемом состоянии и будет повторно развернут при выполнении развертывания. Свойства ресурса могут измениться или остаться без изменений. |
Ignore |
string |
Ресурс существует в текущем состоянии и отсутствует в нужном состоянии. Ресурс не будет развернут или изменен при выполнении развертывания. |
Modify |
string |
Ресурс существует в текущем и требуемом состоянии и будет повторно развернут при выполнении развертывания. Свойства ресурса будут изменены. |
NoChange |
string |
Ресурс существует в текущем и требуемом состоянии и будет повторно развернут при выполнении развертывания. Свойства ресурса не изменяются. |
Unsupported |
string |
Ресурс не поддерживается приложением What-If. |
CloudError
Ответ об ошибке для запроса на управление ресурсами.
Имя | Тип | Описание |
---|---|---|
error |
Сообщение об ошибке |
DebugSetting
Параметр отладки.
Имя | Тип | Описание |
---|---|---|
detailLevel |
string |
Указывает тип сведений для записи в журнал для отладки. Допустимые значения: none, requestContent, responseContent или requestContent и responseContent разделены запятой. Значение по умолчанию — none. При установке этого значения тщательно учитывайте тип данных, которые передаются во время развертывания. При ведении журнала с информацией о запросе или ответе возможно раскрытие конфиденциальных данных, извлекаемых с помощью операций развертывания. |
DeploymentMode
Режим, используемый для развертывания ресурсов. Это значение может быть добавочным или завершенным. В инкрементном режиме ресурсы развертываются без удаления существующих ресурсов, не включенных в шаблон. В режиме Завершения ресурсы развертываются, а существующие ресурсы в группе ресурсов, не включенные в шаблон, удаляются. Будьте внимательны при использовании полного режима, так как вы можете непреднамеренно удалить ресурсы.
Имя | Тип | Описание |
---|---|---|
Complete |
string |
|
Incremental |
string |
DeploymentWhatIf
Параметры операции развертывания "Что если".
Имя | Тип | Описание |
---|---|---|
location |
string |
Расположение для хранения данных развертывания. |
properties |
Свойства развертывания. |
DeploymentWhatIfProperties
Свойства развертывания "Что если".
Имя | Тип | Описание |
---|---|---|
debugSetting |
Параметр отладки развертывания. |
|
expressionEvaluationOptions |
Указывает, вычисляются ли выражения шаблона в область родительского или вложенного шаблона. Применимо только к вложенным шаблонам. Если значение не указано, значение по умолчанию — внешнее. |
|
mode |
Режим, используемый для развертывания ресурсов. Это значение может быть добавочным или завершенным. В инкрементном режиме ресурсы развертываются без удаления существующих ресурсов, не включенных в шаблон. В режиме Завершения ресурсы развертываются, а существующие ресурсы в группе ресурсов, не включенные в шаблон, удаляются. Будьте внимательны при использовании полного режима, так как вы можете непреднамеренно удалить ресурсы. |
|
onErrorDeployment |
Развертывание при поведении ошибки. |
|
parameters |
object |
Пары имен и значений, определяющие параметры развертывания для шаблона. Этот элемент используется, если требуется указать значения параметров непосредственно в запросе, а не ссылаться на существующий файл параметров. Используйте свойство parametersLink или свойство parameters, но не оба. Это может быть JObject или строка JSON правильного формата. |
parametersLink |
Универсальный код ресурса (URI) файла параметров. Этот элемент используется для связывания с существующим файлом параметров. Используйте свойство parametersLink или свойство parameters, но не оба. |
|
template |
object |
Содержимое шаблона. Этот элемент используется, если требуется передать синтаксис шаблона непосредственно в запросе, а не ссылку на существующий шаблон. Это может быть JObject или строка JSON правильного формата. Используйте свойство templateLink или свойство шаблона, но не оба. |
templateLink |
Универсальный код ресурса (URI) шаблона. Используйте свойство templateLink или свойство шаблона, но не оба. |
|
whatIfSettings |
Необязательные параметры операции What-If. |
DeploymentWhatIfSettings
Параметры операции развертывания What-If.
Имя | Тип | Описание |
---|---|---|
resultFormat |
Формат результатов What-If |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Тип дополнительных сведений. |
ErrorResponse
Сообщение об ошибке
Имя | Тип | Описание |
---|---|---|
additionalInfo |
Дополнительные сведения об ошибке. |
|
code |
string |
Код ошибки. |
details |
Сведения об ошибке. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
ExpressionEvaluationOptions
Указывает, вычисляются ли выражения шаблона в область родительского или вложенного шаблона.
Имя | Тип | Описание |
---|---|---|
scope |
Область, используемый для оценки параметров, переменных и функций во вложенном шаблоне. |
ExpressionEvaluationOptionsScopeType
Область, используемый для оценки параметров, переменных и функций во вложенном шаблоне.
Имя | Тип | Описание |
---|---|---|
Inner |
string |
|
NotSpecified |
string |
|
Outer |
string |
OnErrorDeployment
Развертывание при поведении ошибки.
Имя | Тип | Описание |
---|---|---|
deploymentName |
string |
Развертывание, используемое при возникновении ошибки. |
type |
Тип поведения развертывания при ошибке. Возможные значения: LastSuccessful и SpecificDeployment. |
OnErrorDeploymentType
Тип поведения развертывания при ошибке. Возможные значения: LastSuccessful и SpecificDeployment.
Имя | Тип | Описание |
---|---|---|
LastSuccessful |
string |
|
SpecificDeployment |
string |
ParametersLink
Сущность, представляющая ссылку на параметры развертывания.
Имя | Тип | Описание |
---|---|---|
contentVersion |
string |
Если этот параметр включен, должен соответствовать ContentVersion в шаблоне. |
uri |
string |
Универсальный код ресурса (URI) файла параметров. |
PropertyChangeType
Тип изменения свойства.
Имя | Тип | Описание |
---|---|---|
Array |
string |
Свойство является массивом и содержит вложенные изменения. |
Create |
string |
Свойство не существует в текущем состоянии, но присутствует в нужном состоянии. Свойство будет создано при выполнении развертывания. |
Delete |
string |
Свойство существует в текущем состоянии и отсутствует в требуемом состоянии. Он будет удален при выполнении развертывания. |
Modify |
string |
Свойство существует как в текущем, так и в требуемом состоянии и отличается. Значение свойства изменится при выполнении развертывания. |
NoEffect |
string |
Свойство не будет задано или обновлено. |
TemplateLink
Сущность, представляющая ссылку на шаблон.
Имя | Тип | Описание |
---|---|---|
contentVersion |
string |
Если этот параметр включен, должен соответствовать ContentVersion в шаблоне. |
id |
string |
Идентификатор ресурса спецификации шаблона. Используйте свойство id или URI, но не оба. |
queryString |
string |
Строка запроса (например, маркер SAS), используемая с URI templateLink. |
relativePath |
string |
Свойство relativePath можно использовать для развертывания связанного шаблона в расположении относительно родительского элемента. Если родительский шаблон был связан с TemplateSpec, он будет ссылаться на артефакт в TemplateSpec. Если родительский элемент был связан с URI, дочернее развертывание будет сочетанием родительских и относительных URI. |
uri |
string |
Универсальный код ресурса (URI) развертываемого шаблона. Используйте свойство URI или id, но не оба. |
WhatIfChange
Сведения об изменении одного ресурса, прогнозируемом операцией What-If.
Имя | Тип | Описание |
---|---|---|
after |
object |
Прогнозируемое snapshot ресурса после выполнения развертывания. |
before |
object |
Snapshot ресурса перед выполнением развертывания. |
changeType |
Тип изменения, которое будет внесено в ресурс при выполнении развертывания. |
|
delta |
Прогнозируемые изменения свойств ресурса. |
|
resourceId |
string |
Идентификатор ресурса |
unsupportedReason |
string |
Объяснение того, почему ресурс не поддерживается приложением "Что если". |
WhatIfOperationResult
Результат операции What-If. Содержит список прогнозируемых изменений и URL-ссылку для получения следующего набора результатов.
Имя | Тип | Описание |
---|---|---|
error |
Сообщение об ошибке |
|
properties.changes |
Список изменений ресурсов, прогнозируемых What-If операции. |
|
status |
string |
Состояние операции What-If. |
WhatIfPropertyChange
Прогнозируемое изменение свойства ресурса.
Имя | Тип | Описание |
---|---|---|
after |
object |
Значение свойства после выполнения развертывания. |
before |
object |
Значение свойства перед выполнением развертывания. |
children |
Изменения вложенных свойств. |
|
path |
string |
Путь к свойству. |
propertyChangeType |
Тип изменения свойства. |
WhatIfResultFormat
Формат результатов What-If
Имя | Тип | Описание |
---|---|---|
FullResourcePayloads |
string |
|
ResourceIdOnly |
string |