다음을 통해 공유


Deployments - What If

리소스 그룹의 scope 실행되는 경우 배포에서 변경한 내용을 반환합니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.Resources/deployments/{deploymentName}/whatIf?api-version=2021-04-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
deploymentName
path True

string

배포의 이름입니다.

regex 패턴: ^[-\w\._\(\)]+$

resourceGroupName
path True

string

템플릿을 배포할 리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.

regex 패턴: ^[-\w\._\(\)]+$

subscriptionId
path True

string

Microsoft Azure 구독 ID입니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

요청 본문

Name 필수 형식 Description
properties True

DeploymentWhatIfProperties

배포 속성입니다.

location

string

배포 데이터를 저장할 위치입니다.

응답

Name 형식 Description
200 OK

WhatIfOperationResult

OK - What-If 작업 상태 반환합니다.

202 Accepted

수락됨 - 장기 실행 작업 상태 쿼리할 위치 헤더의 URL을 반환합니다.

헤더

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

CloudError

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Predict template changes at resource group scope

샘플 요청

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"
  }
}

샘플 응답

{
  "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
ChangeType

배포가 실행될 때 리소스에 적용할 변경 유형입니다.

CloudError

리소스 관리 요청에 대한 오류 응답입니다.

DebugSetting

디버그 설정입니다.

DeploymentMode

리소스를 배포하는 데 사용되는 모드입니다. 이 값은 증분 또는 완료일 수 있습니다. 증분 모드에서 리소스는 템플릿에 포함되지 않은 기존 리소스를 삭제하지 않고 배포됩니다. 전체 모드에서는 리소스가 배포되고 템플릿에 포함되지 않은 리소스 그룹의 기존 리소스가 삭제됩니다. 의도치 않게 리소스를 삭제할 수 있으므로 완료 모드를 사용할 때는 주의해야 합니다.

DeploymentWhatIf

배포 What-if 작업 매개 변수.

DeploymentWhatIfProperties

배포 What-if 속성.

DeploymentWhatIfSettings

배포 What-If 작업 설정.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorResponse

오류 응답

ExpressionEvaluationOptions

부모 템플릿 또는 중첩된 템플릿의 scope 내에서 템플릿 식을 평가할지 여부를 지정합니다.

ExpressionEvaluationOptionsScopeType

중첩된 템플릿에서 매개 변수, 변수 및 함수를 평가하는 데 사용할 scope.

OnErrorDeployment

오류 동작에 대한 배포입니다.

OnErrorDeploymentType

오류 동작 유형에 대한 배포입니다. 가능한 값은 LastSuccessful 및 SpecificDeployment입니다.

ParametersLink

배포 매개 변수에 대한 참조를 나타내는 엔터티입니다.

PropertyChangeType

속성 변경의 형식입니다.

TemplateLink

템플릿에 대한 참조를 나타내는 엔터티입니다.

WhatIfChange

What-If 작업에서 예측한 단일 리소스 변경에 대한 정보입니다.

WhatIfOperationResult

What-If 작업의 결과입니다. 예측된 변경 내용 목록과 다음 결과 집합에 대한 URL 링크를 포함합니다.

WhatIfPropertyChange

리소스 속성에 대한 예측된 변경 내용입니다.

WhatIfResultFormat

What-If 결과의 형식

ChangeType

배포가 실행될 때 리소스에 적용할 변경 유형입니다.

Name 형식 Description
Create

string

리소스는 현재 상태에 없지만 원하는 상태에 있습니다. 배포가 실행될 때 리소스가 만들어집니다.

Delete

string

리소스가 현재 상태에 있으며 원하는 상태에서 누락되었습니다. 배포가 실행되면 리소스가 삭제됩니다.

Deploy

string

리소스는 현재 상태 및 원하는 상태에 있으며 배포가 실행될 때 다시 배포됩니다. 리소스의 속성은 변경되거나 변경되지 않을 수 있습니다.

Ignore

string

리소스가 현재 상태에 있으며 원하는 상태에서 누락되었습니다. 배포가 실행될 때 리소스가 배포되거나 수정되지 않습니다.

Modify

string

리소스는 현재 상태와 원하는 상태에 있으며 배포가 실행될 때 다시 배포됩니다. 리소스의 속성이 변경됩니다.

NoChange

string

리소스는 현재 상태 및 원하는 상태에 있으며 배포가 실행될 때 다시 배포됩니다. 리소스의 속성은 변경되지 않습니다.

Unsupported

string

리소스는 What-If에서 지원되지 않습니다.

CloudError

리소스 관리 요청에 대한 오류 응답입니다.

Name 형식 Description
error

ErrorResponse

오류 응답
실패한 작업에 대한 오류 세부 정보를 반환하는 모든 Azure Resource Manager API에 대한 일반적인 오류 응답입니다. OData 오류 응답 형식도 따릅니다.

DebugSetting

디버그 설정입니다.

Name 형식 Description
detailLevel

string

디버깅을 위해 기록할 정보의 형식을 지정합니다. 허용되는 값은 none, requestContent, responseContent 또는 requestContent 및 responseContent를 모두 쉼표로 구분합니다. 기본값은 none입니다. 이 값을 설정할 때 배포하는 동안 전달되는 정보 유형을 신중하게 고려합니다. 요청 또는 응답에 대한 정보를 로깅하게 되면 배포 작업을 통해 검색되는 중요한 데이터가 노출될 가능성이 있기 때문입니다.

DeploymentMode

리소스를 배포하는 데 사용되는 모드입니다. 이 값은 증분 또는 완료일 수 있습니다. 증분 모드에서 리소스는 템플릿에 포함되지 않은 기존 리소스를 삭제하지 않고 배포됩니다. 전체 모드에서는 리소스가 배포되고 템플릿에 포함되지 않은 리소스 그룹의 기존 리소스가 삭제됩니다. 의도치 않게 리소스를 삭제할 수 있으므로 완료 모드를 사용할 때는 주의해야 합니다.

Name 형식 Description
Complete

string

Incremental

string

DeploymentWhatIf

배포 What-if 작업 매개 변수.

Name 형식 Description
location

string

배포 데이터를 저장할 위치입니다.

properties

DeploymentWhatIfProperties

배포 속성입니다.

DeploymentWhatIfProperties

배포 What-if 속성.

Name 형식 Description
debugSetting

DebugSetting

배포의 디버그 설정입니다.

expressionEvaluationOptions

ExpressionEvaluationOptions

부모 템플릿 또는 중첩된 템플릿의 scope 내에서 템플릿 식을 평가할지 여부를 지정합니다. 중첩된 템플릿에만 적용됩니다. 지정하지 않으면 기본값은 외부 값입니다.

mode

DeploymentMode

리소스를 배포하는 데 사용되는 모드입니다. 이 값은 증분 또는 완료일 수 있습니다. 증분 모드에서 리소스는 템플릿에 포함되지 않은 기존 리소스를 삭제하지 않고 배포됩니다. 전체 모드에서는 리소스가 배포되고 템플릿에 포함되지 않은 리소스 그룹의 기존 리소스가 삭제됩니다. 의도치 않게 리소스를 삭제할 수 있으므로 완료 모드를 사용할 때는 주의해야 합니다.

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 작업 설정.

Name 형식 Description
resultFormat

WhatIfResultFormat

What-If 결과의 형식

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorResponse

오류 응답

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorResponse[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ExpressionEvaluationOptions

부모 템플릿 또는 중첩된 템플릿의 scope 내에서 템플릿 식을 평가할지 여부를 지정합니다.

Name 형식 Description
scope

ExpressionEvaluationOptionsScopeType

중첩된 템플릿에서 매개 변수, 변수 및 함수를 평가하는 데 사용할 scope.

ExpressionEvaluationOptionsScopeType

중첩된 템플릿에서 매개 변수, 변수 및 함수를 평가하는 데 사용할 scope.

Name 형식 Description
Inner

string

NotSpecified

string

Outer

string

OnErrorDeployment

오류 동작에 대한 배포입니다.

Name 형식 Description
deploymentName

string

오류 사례에 사용할 배포입니다.

type

OnErrorDeploymentType

오류 동작 유형에 대한 배포입니다. 가능한 값은 LastSuccessful 및 SpecificDeployment입니다.

OnErrorDeploymentType

오류 동작 유형에 대한 배포입니다. 가능한 값은 LastSuccessful 및 SpecificDeployment입니다.

Name 형식 Description
LastSuccessful

string

SpecificDeployment

string

배포 매개 변수에 대한 참조를 나타내는 엔터티입니다.

Name 형식 Description
contentVersion

string

포함된 경우 템플릿의 ContentVersion과 일치해야 합니다.

uri

string

매개 변수 파일의 URI입니다.

PropertyChangeType

속성 변경의 형식입니다.

Name 형식 Description
Array

string

속성은 배열이며 중첩된 변경 내용을 포함합니다.

Create

string

속성은 현재 상태에 없지만 원하는 상태에 있습니다. 배포가 실행될 때 속성이 만들어집니다.

Delete

string

속성은 현재 상태에 있으며 원하는 상태에서 누락되었습니다. 배포가 실행되면 삭제됩니다.

Modify

string

속성은 현재 상태와 원하는 상태 모두에 존재하며 다릅니다. 배포가 실행될 때 속성 값이 변경됩니다.

NoEffect

string

속성이 설정되거나 업데이트되지 않습니다.

템플릿에 대한 참조를 나타내는 엔터티입니다.

Name 형식 Description
contentVersion

string

포함된 경우 템플릿의 ContentVersion과 일치해야 합니다.

id

string

템플릿 사양의 리소스 ID입니다. ID 또는 uri 속성을 사용하지만 둘 다 사용하지는 않습니다.

queryString

string

templateLink URI와 함께 사용할 쿼리 문자열(예: SAS 토큰)입니다.

relativePath

string

relativePath 속성을 사용하여 부모에 상대적인 위치에 연결된 템플릿을 배포할 수 있습니다. 부모 템플릿이 TemplateSpec과 연결된 경우 TemplateSpec에서 아티팩트를 참조합니다. 부모가 URI와 연결된 경우 자식 배포는 부모 및 relativePath URI의 조합이 됩니다.

uri

string

배포할 템플릿의 URI입니다. uri 또는 id 속성을 사용하지만 둘 다 사용하지는 않습니다.

WhatIfChange

What-If 작업에서 예측한 단일 리소스 변경에 대한 정보입니다.

Name 형식 Description
after

object

배포가 실행된 후 리소스의 예측 스냅샷.

before

object

배포가 실행되기 전에 리소스의 스냅샷.

changeType

ChangeType

배포가 실행될 때 리소스에 적용할 변경 유형입니다.

delta

WhatIfPropertyChange[]

리소스 속성에 대한 예측된 변경 내용입니다.

resourceId

string

리소스 ID

unsupportedReason

string

What-If에서 리소스를 지원하지 않는 이유에 대한 설명입니다.

WhatIfOperationResult

What-If 작업의 결과입니다. 예측된 변경 내용 목록과 다음 결과 집합에 대한 URL 링크를 포함합니다.

Name 형식 Description
error

ErrorResponse

오류 응답
What-If 작업이 실패할 때 오류가 발생합니다.

properties.changes

WhatIfChange[]

What-If 작업에서 예측한 리소스 변경 내용 목록입니다.

status

string

What-If 작업의 상태입니다.

WhatIfPropertyChange

리소스 속성에 대한 예측된 변경 내용입니다.

Name 형식 Description
after

object

배포가 실행된 후의 속성 값입니다.

before

object

배포가 실행되기 전에 속성의 값입니다.

children

WhatIfPropertyChange[]

중첩된 속성이 변경됩니다.

path

string

속성의 경로입니다.

propertyChangeType

PropertyChangeType

속성 변경의 형식입니다.

WhatIfResultFormat

What-If 결과의 형식

Name 형식 Description
FullResourcePayloads

string

ResourceIdOnly

string