Deployments - What If
Kaynak grubunun kapsamında yürütülürse dağıtım tarafından yapılacak değişiklikleri döndürür.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}/whatIf?api-version=2021-04-01
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
deployment
|
path | True |
string |
Dağıtımın adı. Normal ifade deseni: |
resource
|
path | True |
string |
Şablonun dağıtılacağı kaynak grubunun adı. Ad büyük/küçük harfe duyarlı değildir. Normal ifade deseni: |
subscription
|
path | True |
string |
Microsoft Azure abonelik kimliği. |
api-version
|
query | True |
string |
Bu işlem için kullanılacak API sürümü. |
Name | Gerekli | Tür | Description |
---|---|---|---|
properties | True |
Dağıtım özellikleri. |
|
location |
string |
Dağıtım verilerini depolama konumu. |
Name | Tür | Description |
---|---|---|
200 OK |
Tamam - What-If işlem durumunu döndürür |
|
202 Accepted |
Kabul Edildi - Uzun süre çalışan işlem durumunu sorgulamak için Konum üst bilgisindeki URL'yi döndürür. Üst Bilgiler
|
|
Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan hata yanıtı. |
Azure Active Directory OAuth2 Flow
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Name | Description |
---|---|
user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnek isteği
POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000001/resourcegroups/my-resource-group/providers/Microsoft.Resources/deployments/my-deployment/whatIf?api-version=2021-04-01
{
"properties": {
"templateLink": {
"uri": "https://example.com/exampleTemplate.json"
},
"parameters": {},
"mode": "Incremental"
}
}
Örnek yanıt
{
"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"
}
}
}
]
}
}
Location: /subscriptions/00000000-0000-0000-0000-000000000000/ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ
Name | Description |
---|---|
Change |
Dağıtım yürütürken kaynakta yapılacak değişikliğin türü. |
Cloud |
Kaynak yönetimi isteği için hata yanıtı. |
Debug |
Hata ayıklama ayarı. |
Deployment |
Kaynakları dağıtmak için kullanılan mod. Bu değer Artımlı veya Tamamlandı olabilir. Artımlı modda kaynaklar, şablona dahil edilmeyen mevcut kaynaklar silinmeden dağıtılır. Tamamlandı modunda kaynaklar dağıtılır ve kaynak grubundaki şablona dahil edilmeyen mevcut kaynaklar silinir. Kaynakları istemeden silebildiğinizden, Tamamlama modunu kullanırken dikkatli olun. |
Deployment |
What-if işlemi parametrelerini dağıtma. |
Deployment |
Durum özellikleri dağıtımı. |
Deployment |
Dağıtım What-If işlem ayarları. |
Error |
Kaynak yönetimi hatası ek bilgileri. |
Error |
Hata Yanıtı |
Expression |
Şablon ifadelerinin üst şablon veya iç içe şablon kapsamında değerlendirilip değerlendirilmediğini belirtir. |
Expression |
İç içe bir şablondaki parametrelerin, değişkenlerin ve işlevlerin değerlendirilmesi için kullanılacak kapsam. |
On |
Hata davranışında dağıtım. |
On |
Hata davranışı türünde dağıtım. Olası değerler LastSuccessful ve SpecificDeployment değerleridir. |
Parameters |
Dağıtım parametrelerine başvuruyu temsil eden varlık. |
Property |
Özellik değişikliğinin türü. |
Template |
Şablon başvuruyu temsil eden varlık. |
What |
What-If işlemi tarafından tahmin edilen tek bir kaynak değişikliği hakkında bilgi. |
What |
What-If işleminin sonucu. Tahmin edilen değişikliklerin listesini ve sonraki sonuç kümesine ulaşmak için bir URL bağlantısı içerir. |
What |
Kaynak özelliğinde tahmin edilen değişiklik. |
What |
What-If sonuçlarının biçimi |
Dağıtım yürütürken kaynakta yapılacak değişikliğin türü.
Name | Tür | Description |
---|---|---|
Create |
string |
Kaynak geçerli durumda değil, istenen durumda mevcut. Dağıtım yürütürken kaynak oluşturulur. |
Delete |
string |
Kaynak geçerli durumda var ve istenen durumda yok. Dağıtım yürütürken kaynak silinir. |
Deploy |
string |
Kaynak geçerli durumda ve istenen durumda bulunur ve dağıtım yürütürken yeniden dağıtılır. Kaynağın özellikleri değişebilir veya değişmeyebilir. |
Ignore |
string |
Kaynak geçerli durumda var ve istenen durumda yok. Dağıtım yürütürken kaynak dağıtılmaz veya değiştirilmez. |
Modify |
string |
Kaynak geçerli durumda ve istenen durumda bulunur ve dağıtım yürütürken yeniden dağıtılır. Kaynağın özellikleri değişir. |
NoChange |
string |
Kaynak geçerli durumda ve istenen durumda bulunur ve dağıtım yürütürken yeniden dağıtılır. Kaynağın özellikleri değişmez. |
Unsupported |
string |
Kaynak What-If tarafından desteklenmiyor. |
Kaynak yönetimi isteği için hata yanıtı.
Name | Tür | Description |
---|---|---|
error |
Hata Yanıtı |
Hata ayıklama ayarı.
Name | Tür | Description |
---|---|---|
detailLevel |
string |
Hata ayıklama için günlüğe kaydedilecek bilgi türünü belirtir. İzin verilen değerler hiçbiri, requestContent, responseContent veya hem requestContent hem de responseContent virgülle ayrılmış değerlerdir. Varsayılan değer none'dır. Bu değeri ayarlarken, dağıtım sırasında geçirdiğiniz bilgi türünü dikkatle göz önünde bulundurun. İstek veya yanıt hakkındaki bilgileri günlüğe kaydederek, dağıtım işlemleri aracılığıyla alınan hassas verileri kullanıma sunma olasılığınız vardır. |
Kaynakları dağıtmak için kullanılan mod. Bu değer Artımlı veya Tamamlandı olabilir. Artımlı modda kaynaklar, şablona dahil edilmeyen mevcut kaynaklar silinmeden dağıtılır. Tamamlandı modunda kaynaklar dağıtılır ve kaynak grubundaki şablona dahil edilmeyen mevcut kaynaklar silinir. Kaynakları istemeden silebildiğinizden, Tamamlama modunu kullanırken dikkatli olun.
Name | Tür | Description |
---|---|---|
Complete |
string |
|
Incremental |
string |
What-if işlemi parametrelerini dağıtma.
Name | Tür | Description |
---|---|---|
location |
string |
Dağıtım verilerini depolama konumu. |
properties |
Dağıtım özellikleri. |
Durum özellikleri dağıtımı.
Name | Tür | Description |
---|---|---|
debugSetting |
Dağıtımın hata ayıklama ayarı. |
|
expressionEvaluationOptions |
Şablon ifadelerinin üst şablon veya iç içe şablon kapsamında değerlendirilip değerlendirilmediğini belirtir. Yalnızca iç içe şablonlar için geçerlidir. Belirtilmezse, varsayılan değer dış değerdir. |
|
mode |
Kaynakları dağıtmak için kullanılan mod. Bu değer Artımlı veya Tamamlandı olabilir. Artımlı modda kaynaklar, şablona dahil edilmeyen mevcut kaynaklar silinmeden dağıtılır. Tamamlandı modunda kaynaklar dağıtılır ve kaynak grubundaki şablona dahil edilmeyen mevcut kaynaklar silinir. Kaynakları istemeden silebildiğinizden, Tamamlama modunu kullanırken dikkatli olun. |
|
onErrorDeployment |
Hata davranışında dağıtım. |
|
parameters |
object |
Şablon için dağıtım parametrelerini tanımlayan ad ve değer çiftleri. Parametre değerlerini varolan bir parametre dosyasına bağlamak yerine doğrudan istekte sağlamak istediğinizde bu öğeyi kullanırsınız. parametersLink özelliğini veya parameters özelliğini kullanın, ancak ikisini birden kullanmayın. Bir JObject veya iyi biçimlendirilmiş bir JSON dizesi olabilir. |
parametersLink |
Parametre dosyasının URI'si. Var olan bir parametre dosyasına bağlanmak için bu öğeyi kullanırsınız. parametersLink özelliğini veya parameters özelliğini kullanın, ancak ikisini birden kullanmayın. |
|
template |
object |
Şablon içeriği. Şablon söz dizimini var olan bir şablona bağlamak yerine doğrudan istekte geçirmek istediğinizde bu öğeyi kullanırsınız. JObject veya iyi biçimlendirilmiş bir JSON dizesi olabilir. templateLink özelliğini veya şablon özelliğini kullanın, ancak ikisini birden kullanmayın. |
templateLink |
Şablonun URI'si. templateLink özelliğini veya şablon özelliğini kullanın, ancak ikisini birden kullanmayın. |
|
whatIfSettings |
İsteğe bağlı What-If işlem ayarları. |
Dağıtım What-If işlem ayarları.
Name | Tür | Description |
---|---|---|
resultFormat |
What-If sonuçlarının biçimi |
Kaynak yönetimi hatası ek bilgileri.
Name | Tür | Description |
---|---|---|
info |
object |
Ek bilgiler. |
type |
string |
Ek bilgi türü. |
Hata Yanıtı
Name | Tür | Description |
---|---|---|
additionalInfo |
Hata ek bilgileri. |
|
code |
string |
Hata kodu. |
details |
Hata ayrıntıları. |
|
message |
string |
Hata iletisi. |
target |
string |
Hata hedefi. |
Şablon ifadelerinin üst şablon veya iç içe şablon kapsamında değerlendirilip değerlendirilmediğini belirtir.
Name | Tür | Description |
---|---|---|
scope |
İç içe bir şablondaki parametrelerin, değişkenlerin ve işlevlerin değerlendirilmesi için kullanılacak kapsam. |
İç içe bir şablondaki parametrelerin, değişkenlerin ve işlevlerin değerlendirilmesi için kullanılacak kapsam.
Name | Tür | Description |
---|---|---|
Inner |
string |
|
NotSpecified |
string |
|
Outer |
string |
Hata davranışında dağıtım.
Name | Tür | Description |
---|---|---|
deploymentName |
string |
Hata durumunda kullanılacak dağıtım. |
type |
Hata davranışı türünde dağıtım. Olası değerler LastSuccessful ve SpecificDeployment değerleridir. |
Hata davranışı türünde dağıtım. Olası değerler LastSuccessful ve SpecificDeployment değerleridir.
Name | Tür | Description |
---|---|---|
LastSuccessful |
string |
|
SpecificDeployment |
string |
Dağıtım parametrelerine başvuruyu temsil eden varlık.
Name | Tür | Description |
---|---|---|
contentVersion |
string |
Varsa, şablondaki ContentVersion ile eşleşmelidir. |
uri |
string |
Parametre dosyasının URI'si. |
Özellik değişikliğinin türü.
Name | Tür | Description |
---|---|---|
Array |
string |
özelliği bir dizidir ve iç içe yerleştirilmiş değişiklikler içerir. |
Create |
string |
özelliği geçerli durumda yok, ancak istenen durumda mevcut. Özellik, dağıtım yürütürken oluşturulur. |
Delete |
string |
özelliği geçerli durumda var ve istenen durumda eksik. Dağıtım yürütürken silinir. |
Modify |
string |
özelliği hem geçerli hem de istenen durumda bulunur ve farklıdır. Dağıtım yürütürken özelliğin değeri değişir. |
NoEffect |
string |
Özellik ayarlanmaz veya güncelleştirilmez. |
Şablon başvuruyu temsil eden varlık.
Name | Tür | Description |
---|---|---|
contentVersion |
string |
Varsa, şablondaki ContentVersion ile eşleşmelidir. |
id |
string |
Şablon Belirtiminin kaynak kimliği. Id veya uri özelliğini kullanın, ancak ikisini birden kullanmayın. |
queryString |
string |
templateLink URI'siyle kullanılacak sorgu dizesi (örneğin, sas belirteci). |
relativePath |
string |
RelativePath özelliği, bağlı şablonu üst şablona göre bir konuma dağıtmak için kullanılabilir. Üst şablon bir TemplateSpec ile bağlantılıysa bu, TemplateSpec içindeki bir yapıta başvurur. Üst öğe bir URI ile bağlantılıysa, alt dağıtım üst ve relativePath URI'lerinin bir bileşimi olacaktır |
uri |
string |
Dağıtılacak şablonun URI'si. Uri veya id özelliğini kullanın, ancak ikisini birden kullanmayın. |
What-If işlemi tarafından tahmin edilen tek bir kaynak değişikliği hakkında bilgi.
Name | Tür | Description |
---|---|---|
after |
object |
Dağıtım yürütüldükten sonra kaynağın tahmin edilen anlık görüntüsü. |
before |
object |
Dağıtım yürütülmeden önce kaynağın anlık görüntüsü. |
changeType |
Dağıtım yürütürken kaynakta yapılacak değişikliğin türü. |
|
delta |
Kaynak özelliklerinde tahmin edilen değişiklikler. |
|
resourceId |
string |
Kaynak kimliği |
unsupportedReason |
string |
Kaynağın What-If tarafından neden desteklenmediğiyle ilgili açıklama. |
What-If işleminin sonucu. Tahmin edilen değişikliklerin listesini ve sonraki sonuç kümesine ulaşmak için bir URL bağlantısı içerir.
Name | Tür | Description |
---|---|---|
error |
Hata Yanıtı |
|
properties.changes |
What-If işlemi tarafından tahmin edilen kaynak değişikliklerinin listesi. |
|
status |
string |
What-If işleminin durumu. |
Kaynak özelliğinde tahmin edilen değişiklik.
Name | Tür | Description |
---|---|---|
after |
object |
Dağıtım yürütüldükten sonra özelliğinin değeri. |
before |
object |
Dağıtım yürütülmeden önce özelliğinin değeri. |
children |
İç içe özellik değişiklikleri. |
|
path |
string |
özelliğinin yolu. |
propertyChangeType |
Özellik değişikliğinin türü. |
What-If sonuçlarının biçimi
Name | Tür | Description |
---|---|---|
FullResourcePayloads |
string |
|
ResourceIdOnly |
string |