Deployments - What If At Management Group Scope

管理グループのスコープで実行された場合にデプロイによって行われる変更を返します。

POST https://management.azure.com/providers/Microsoft.Management/managementGroups/{groupId}/providers/Microsoft.Resources/deployments/{deploymentName}/whatIf?api-version=2021-04-01

URI パラメーター

名前 / 必須 説明
deploymentName
path True

string

デプロイの名前。

Regex pattern: ^[-\w\._\(\)]+$

groupId
path True

string

管理グループ ID。

api-version
query True

string

この操作に使用する API バージョン。

要求本文

名前 必須 説明
location True

string

デプロイ データを格納する場所。

properties True

DeploymentWhatIfProperties

配置プロパティです。

応答

名前 説明
200 OK

WhatIfOperationResult

OK - 操作の状態 What-If 返します

202 Accepted

受け入れ可能 - 実行時間の長い操作の状態を照会する URL を Location ヘッダーに返します。

Headers

  • Location: string
  • Retry-After: string
Other Status Codes

CloudError

操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名前 説明
user_impersonation ユーザー アカウントの借用

Predict template changes at management group scope

Sample Request

POST https://management.azure.com/providers/Microsoft.Management/managementGroups/myManagementGruop/providers/Microsoft.Resources/deployments/exampleDeploymentName/whatIf?api-version=2021-04-01

{
  "location": "eastus",
  "properties": {
    "templateLink": {
      "uri": "https://example.com/exampleTemplate.json"
    },
    "parameters": {},
    "mode": "Incremental"
  }
}

Sample Response

{
  "status": "Succeeded",
  "properties": {
    "changes": [
      {
        "resourceId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyAssignment",
        "changeType": "Modify",
        "before": {
          "apiVersion": "2019-06-01",
          "id": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyAssignment",
          "type": "Microsoft.Authorization/policyAssignments",
          "name": "myPolicyAssignment",
          "location": "westus2",
          "properties": {
            "policyDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyDefinition",
            "scope": "/subscriptions/00000000-0000-0000-0000-000000000001",
            "enforcementMode": "Default"
          }
        },
        "after": {
          "resourceId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyAssignment",
          "changeType": "Modify",
          "before": {
            "apiVersion": "2019-06-01",
            "id": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyAssignment",
            "type": "Microsoft.Authorization/policyAssignments",
            "name": "myPolicyAssignment",
            "location": "westus2",
            "properties": {
              "policyDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyDefinition",
              "scope": "/subscriptions/00000000-0000-0000-0000-000000000001",
              "enforcementMode": "DoNotEnforce"
            }
          },
          "delta": [
            {
              "path": "properties.enforcementMode",
              "propertyChangeType": "Modify",
              "before": "Default",
              "after": "DoNotEnforce"
            }
          ]
        }
      },
      {
        "resourceId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyAssignment2",
        "changeType": "Create",
        "after": {
          "apiVersion": "2019-06-01",
          "id": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyAssignment2",
          "type": "Microsoft.Authorization/policyAssignments",
          "name": "myPolicyAssignment2",
          "location": "westus2",
          "properties": {
            "policyDefinitionId": "/providers/Microsoft.Management/managementGroups/myManagementGroup/providers/Microsoft.Authorization/policyAssignments/myPolicyDefinition",
            "scope": "/subscriptions/00000000-0000-0000-0000-000000000002",
            "enforcementMode": "Default"
          }
        }
      }
    ]
  }
}
Location: /subscriptions/4d0ca63b-7939-4c9c-afbe-5fafae501724/operationresults/ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ

定義

名前 説明
ChangeType

デプロイの実行時にリソースに対して行われる変更の種類。

CloudError

リソース管理要求のエラー応答。

DebugSetting

デバッグ設定。

DeploymentMode

リソースのデプロイに使用されるモード。 この値には、増分または完了のいずれかを指定できます。 Incremental モードでは、テンプレートに含まれていない既存のリソースを削除することなくリソースがデプロイされます。 完全モードでは、リソースがデプロイされ、テンプレートに含まれていないリソース グループ内の既存のリソースが削除されます。 リソースを意図せずに削除する可能性があるため、Complete モードを使用する場合は注意してください。

DeploymentWhatIfProperties

デプロイの What-if プロパティ。

DeploymentWhatIfSettings

デプロイ What-If 操作の設定。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

ErrorResponse

エラー応答

ExpressionEvaluationOptions

テンプレート式を親テンプレートのスコープ内で評価するか、入れ子になったテンプレートで評価するかを指定します。

ExpressionEvaluationOptionsScopeType

入れ子になったテンプレート内のパラメーター、変数、関数の評価に使用するスコープ。

OnErrorDeployment

エラーの動作に対するデプロイ。

OnErrorDeploymentType

エラー動作の種類でのデプロイ。 指定できる値は LastSuccessful と SpecificDeployment です。

ParametersLink

デプロイ パラメーターへの参照を表すエンティティ。

PropertyChangeType

プロパティの変更の種類。

ScopedDeploymentWhatIf

デプロイの What-if 操作パラメーター。

TemplateLink

テンプレートへの参照を表すエンティティです。

WhatIfChange

What-If 操作によって予測される 1 つのリソース変更に関する情報。

WhatIfOperationResult

What-If 操作の結果。 予測された変更の一覧と、次の結果セットにアクセスするための URL リンクが含まれます。

WhatIfPropertyChange

リソース プロパティに対する予測された変更。

WhatIfResultFormat

What-If 結果の形式

ChangeType

デプロイの実行時にリソースに対して行われる変更の種類。

名前 説明
Create

string

リソースは現在の状態には存在しませんが、目的の状態にあります。 デプロイの実行時にリソースが作成されます。

Delete

string

リソースは現在の状態にあり、目的の状態にありません。 デプロイの実行時にリソースが削除されます。

Deploy

string

リソースは現在の状態と目的の状態に存在し、デプロイの実行時に再デプロイされます。 リソースのプロパティは、変更される場合と変更されない場合があります。

Ignore

string

リソースは現在の状態にあり、目的の状態にありません。 デプロイの実行時に、リソースはデプロイまたは変更されません。

Modify

string

リソースは現在の状態と目的の状態に存在し、デプロイの実行時に再デプロイされます。 リソースのプロパティが変更されます。

NoChange

string

リソースは現在の状態と目的の状態に存在し、デプロイの実行時に再デプロイされます。 リソースのプロパティは変更されません。

Unsupported

string

リソースは What-If ではサポートされていません。

CloudError

リソース管理要求のエラー応答。

名前 説明
error

ErrorResponse

エラー応答
失敗した操作のエラーの詳細を返す、すべての Azure Resource Manager API に対する一般的なエラー応答 (これは OData エラー応答形式にも従います)。

DebugSetting

デバッグ設定。

名前 説明
detailLevel

string

デバッグのためにログに記録する情報の種類を指定します。 許可される値は none、requestContent、responseContent、または requestContent と responseContent の両方をコンマで区切って指定します。 既定値は none です。 この値を設定するときは、デプロイ時に渡す情報の種類を慎重に検討してください。 要求または応答に関する情報をログ記録すると、デプロイ操作で取得される重要なデータを公開する可能性があります。

DeploymentMode

リソースのデプロイに使用されるモード。 この値には、増分または完了のいずれかを指定できます。 Incremental モードでは、テンプレートに含まれていない既存のリソースを削除することなくリソースがデプロイされます。 完全モードでは、リソースがデプロイされ、テンプレートに含まれていないリソース グループ内の既存のリソースが削除されます。 リソースを意図せずに削除する可能性があるため、Complete モードを使用する場合は注意してください。

名前 説明
Complete

string

Incremental

string

DeploymentWhatIfProperties

デプロイの What-if プロパティ。

名前 説明
debugSetting

DebugSetting

デプロイのデバッグ設定。

expressionEvaluationOptions

ExpressionEvaluationOptions

テンプレート式を親テンプレートのスコープ内で評価するか、入れ子になったテンプレートで評価するかを指定します。 入れ子になったテンプレートにのみ適用されます。 指定しない場合、既定値は outer です。

mode

DeploymentMode

リソースのデプロイに使用されるモード。 この値には、増分または完了のいずれかを指定できます。 Incremental モードでは、テンプレートに含まれていない既存のリソースを削除することなくリソースがデプロイされます。 完全モードでは、リソースがデプロイされ、テンプレートに含まれていないリソース グループ内の既存のリソースが削除されます。 リソースを意図せずに削除する可能性があるため、Complete モードを使用する場合は注意してください。

onErrorDeployment

OnErrorDeployment

エラーの動作に対するデプロイ。

parameters

object

テンプレートのデプロイ パラメーターを定義する名前と値のペア。 この要素は、既存のパラメーター ファイルへのリンクではなく、要求でパラメーター値を直接指定する場合に使用します。 parametersLink プロパティまたは parameters プロパティを使用しますが、両方は使用しません。 JObject または整形式の JSON 文字列を指定できます。

parametersLink

ParametersLink

パラメーター ファイルの URI。 この要素を使用して、既存のパラメーター ファイルにリンクします。 parametersLink プロパティまたは parameters プロパティを使用しますが、両方は使用しません。

template

object

テンプレートの内容。 この要素は、既存のテンプレートへのリンクではなく、要求でテンプレート構文を直接渡す場合に使用します。 JObject または整形式の JSON 文字列を指定できます。 templateLink プロパティまたはテンプレート プロパティを使用しますが、両方は使用しません。

templateLink

TemplateLink

テンプレートの URI。 templateLink プロパティまたはテンプレート プロパティを使用しますが、両方は使用しません。

whatIfSettings

DeploymentWhatIfSettings

オプションの What-If 操作設定。

DeploymentWhatIfSettings

デプロイ What-If 操作の設定。

名前 説明
resultFormat

WhatIfResultFormat

What-If 結果の形式

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前 説明
info

object

追加情報。

type

string

追加情報の種類。

ErrorResponse

エラー応答

名前 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorResponse[]

エラーの詳細です。

message

string

エラー メッセージ。

target

string

エラーのターゲット。

ExpressionEvaluationOptions

テンプレート式を親テンプレートのスコープ内で評価するか、入れ子になったテンプレートで評価するかを指定します。

名前 説明
scope

ExpressionEvaluationOptionsScopeType

入れ子になったテンプレート内のパラメーター、変数、関数の評価に使用するスコープ。

ExpressionEvaluationOptionsScopeType

入れ子になったテンプレート内のパラメーター、変数、関数の評価に使用するスコープ。

名前 説明
Inner

string

NotSpecified

string

Outer

string

OnErrorDeployment

エラーの動作に対するデプロイ。

名前 説明
deploymentName

string

エラーケースで使用するデプロイ。

type

OnErrorDeploymentType

エラー動作の種類でのデプロイ。 指定できる値は LastSuccessful と SpecificDeployment です。

OnErrorDeploymentType

エラー動作の種類でのデプロイ。 指定できる値は LastSuccessful と SpecificDeployment です。

名前 説明
LastSuccessful

string

SpecificDeployment

string

デプロイ パラメーターへの参照を表すエンティティ。

名前 説明
contentVersion

string

含まれている場合は、テンプレート内の ContentVersion と一致する必要があります。

uri

string

パラメーター ファイルの URI。

PropertyChangeType

プロパティの変更の種類。

名前 説明
Array

string

プロパティは配列であり、入れ子になった変更が含まれています。

Create

string

プロパティは現在の状態には存在しませんが、目的の状態にあります。 プロパティは、デプロイの実行時に作成されます。

Delete

string

プロパティは現在の状態に存在し、目的の状態にありません。 デプロイの実行時に削除されます。

Modify

string

プロパティは現在の状態と目的の状態の両方に存在し、異なります。 プロパティの値は、デプロイの実行時に変更されます。

NoEffect

string

プロパティは設定または更新されません。

ScopedDeploymentWhatIf

デプロイの What-if 操作パラメーター。

名前 説明
location

string

デプロイ データを格納する場所。

properties

DeploymentWhatIfProperties

配置プロパティです。

テンプレートへの参照を表すエンティティです。

名前 説明
contentVersion

string

含まれている場合は、テンプレート内の ContentVersion と一致する必要があります。

id

string

テンプレート スペックのリソース ID。id または uri プロパティを使用しますが、両方は使用しないでください。

queryString

string

templateLink URI で使用されるクエリ文字列 (SAS トークンなど)。

relativePath

string

relativePath プロパティを使用すると、親に対する相対位置にリンクされたテンプレートを配置できます。 親テンプレートが TemplateSpec とリンクされている場合、TemplateSpec 内の成果物が参照されます。 親が URI にリンクされている場合、子デプロイは親 URI と relativePath URI の組み合わせになります

uri

string

デプロイするテンプレートの URI。 uri または id プロパティを使用しますが、両方は使用しないでください。

WhatIfChange

What-If 操作によって予測される 1 つのリソース変更に関する情報。

名前 説明
after

object

デプロイの実行後に予測されるリソースのスナップショット。

before

object

デプロイが実行される前のリソースのスナップショット。

changeType

ChangeType

デプロイの実行時にリソースに対して行われる変更の種類。

delta

WhatIfPropertyChange[]

リソース プロパティに対する予測された変更。

resourceId

string

リソース ID

unsupportedReason

string

What-If でリソースがサポートされていない理由に関する説明。

WhatIfOperationResult

What-If 操作の結果。 予測された変更の一覧と、次の結果セットにアクセスするための URL リンクが含まれます。

名前 説明
error

ErrorResponse

エラー応答
What-If 操作が失敗した場合にエラーが発生します。

properties.changes

WhatIfChange[]

What-If 操作によって予測されるリソース変更の一覧。

status

string

What-If 操作の状態。

WhatIfPropertyChange

リソース プロパティに対する予測された変更。

名前 説明
after

object

デプロイの実行後の プロパティの値。

before

object

デプロイが実行される前の プロパティの値。

children

WhatIfPropertyChange[]

入れ子になったプロパティの変更。

path

string

プロパティのパスです。

propertyChangeType

PropertyChangeType

プロパティの変更の種類。

WhatIfResultFormat

What-If 結果の形式

名前 説明
FullResourcePayloads

string

ResourceIdOnly

string