az changesafety changerecord

메모

이 참조는 Azure CLI(버전 2.75.0 이상)에 대한 azure-changesafety 확장의 일부입니다. az changesafety changerecord 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

대상에서 계획된 변경 내용을 설명하는 ChangeRecord 리소스를 관리합니다.

명령

Name Description 형식 상태
az changesafety changerecord create

ChangeRecord 리소스를 만듭니다.

 Extension GA
az changesafety changerecord delete

ChangeRecord 리소스를 삭제합니다.

 Extension GA
az changesafety changerecord list

ChangeRecord 리소스를 나열합니다.

 Extension GA
az changesafety changerecord show

ChangeRecord 리소스에 대한 세부 정보를 표시합니다.

 Extension GA
az changesafety changerecord update

기존 ChangeRecord 리소스를 업데이트합니다.

 Extension GA

az changesafety changerecord create

ChangeRecord 리소스를 만듭니다.

하나 이상의 대상 정의를 제공하여 ChangeRecord가 영향을 줄 리소스 또는 작업을 설명합니다. 대상은 resourceId=RESOURCE_ID,operation=DELETE와 같이 쉼표 또는 세미콜론으로 구분된 key=value 쌍으로 표현됩니다. 이 명령은 별칭을 통해서도 사용할 수 있습니다 az changesafety changerecord. 예약 플래그를 생략하면 예상 시작 시간은 기본적으로 현재로 설정되고 예상 종료 시간은 기본적으로 8시간 후(UTC)로 설정됩니다.

az changesafety changerecord create --change-record-name --name
                                    [--acquire-policy-token]
                                    [--additional-data]
                                    [--anticipated-end-time]
                                    [--anticipated-start-time]
                                    [--change-definition]
                                    [--change-reference]
                                    [--change-type {AppDeployment, Config, ManualTouch, PolicyDeployment}]
                                    [--comments]
                                    [--description]
                                    [--links]
                                    [--orchestration-tool]
                                    [--parameters]
                                    [--release-label]
                                    [--resource-group]
                                    [--rollout-type {Emergency, Hotfix, Normal}]
                                    [--stage-map]
                                    [--stage-map-name --stagemap-name]
                                    [--targets]

예제

Traffic Manager 프로필을 삭제하기 위한 ChangeRecord 만들기

az changesafety changerecord create -g MyResourceGroup -n delete-trafficmanager --change-type ManualTouch --rollout-type Hotfix --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Network/trafficManagerProfiles/myProfile,operation=DELETE" --description "Delete Traffic Manager profile"

이름으로 StageMap 참조

az changesafety changerecord create -g MyResourceGroup -n changerecord003 --change-type ManualTouch --rollout-type Normal --stagemap-name rolloutStageMap --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm,operation=DELETE"

StageMap 참조 및 상태 링크를 사용하여 만들기

az changesafety changerecord create -g MyResourceGroup -n changerecord002 --change-type ManualTouch --rollout-type Normal --stage-map "{resource-id:/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ChangeSafety/stageMaps/rolloutStageMap}" --targets "resourceId=/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/MyResourceGroup/providers/Microsoft.Compute/virtualMachines/myVm,operation=PATCH" --links "[{name:status,uri:'https://contoso.com/change/rollout-002'}]"
az changesafety changerecord delete -g MyResourceGroup -n changerecord002 --yes

구독 범위에서 만들기(리소스 그룹 없음)

az changesafety changerecord create -n changerecord-sub-scope --change-type AppDeployment --rollout-type Normal --stagemap-name rolloutStageMap --targets "subscriptionId=00000000-0000-0000-0000-000000000000"

필수 매개 변수

--change-record-name --name -n

ChangeRecord 리소스의 이름입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성 값
매개 변수 그룹: Global Policy Arguments
--additional-data

다양한 오케스트레이션 도구에 필요한 변경에 대한 추가 메타데이터입니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

속성 값
매개 변수 그룹: Properties Arguments
--anticipated-end-time

ISO 8601 형식의 예상 완료 시간입니다. 기본값은 생략된 예상 시작 시간 이후 8시간으로 설정됩니다.

속성 값
매개 변수 그룹: Properties Arguments
--anticipated-start-time

ISO 8601 형식의 예상 시작 시간입니다. 생략된 경우 기본값은 현재 UTC 시간입니다.

속성 값
매개 변수 그룹: Properties Arguments
--change-definition

대상 리소스를 식별하는 데 사용되는 요청 본문 및/또는 리소스 선택 조건을 변경합니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

속성 값
매개 변수 그룹: Properties Arguments
--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성 값
매개 변수 그룹: Global Policy Arguments
--change-type

AppDeployment, Config, ManualTouch 또는 PolicyDeployment와 같은 변경 사항을 분류합니다.

속성 값
매개 변수 그룹: Properties Arguments
허용되는 값: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

ChangeRecord 리소스에 대한 마지막 업데이트에 대한 주석입니다.

속성 값
매개 변수 그룹: Properties Arguments
--description

수행 중인 변경 내용에 대한 설명입니다.

속성 값
매개 변수 그룹: Properties Arguments
--links

--links name=NAME uri=URL [description=TEXT]를 반복하여 지원 링크를 추가합니다.

속성 값
매개 변수 그룹: Properties Arguments
--orchestration-tool

이 변경 내용의 배포 오케스트레이션에 사용되는 도구입니다.

속성 값
매개 변수 그룹: Properties Arguments
--parameters

각 stageProgression에 대해 제공될 매개 변수의 스키마입니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

속성 값
매개 변수 그룹: Properties Arguments
--release-label

이 변경과 관련된 릴리스의 레이블입니다.

속성 값
매개 변수 그룹: Properties Arguments
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

--rollout-type

롤아웃 유형(Normal, Hotfix 또는 Emergency)을 지정합니다.

속성 값
매개 변수 그룹: Properties Arguments
허용되는 값: Emergency, Hotfix, Normal
--stage-map

resource-id=RESOURCE_ID 및 선택적 매개 변수 키=값 쌍을 사용하여 기존 StageMap 리소스를 참조합니다.

속성 값
매개 변수 그룹: Properties Arguments
--stage-map-name --stagemap-name

현재 구독 범위의 StageMap 이름입니다. 리소스 ID가 작성되었습니다.

속성 값
매개 변수 그룹: Properties Arguments
--targets

하나 이상의 대상 정의가 key=value 쌍으로 표현됩니다(예: resourceId=RESOURCE_ID,operation=DELETE,resourceType=Microsoft.Compute/virtualMachines).

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az changesafety changerecord delete

ChangeRecord 리소스를 삭제합니다.

az changesafety changerecord delete [--acquire-policy-token]
                                    [--change-record-name --name]
                                    [--change-reference]
                                    [--ids]
                                    [--resource-group]
                                    [--subscription]
                                    [--yes]

예제

확인 없이 ChangeRecord 삭제

az changesafety changerecord delete -g MyResourceGroup -n changerecord001 --yes

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성 값
매개 변수 그룹: Global Policy Arguments
--change-record-name --name -n

ChangeRecord 리소스의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성 값
매개 변수 그룹: Global Policy Arguments
--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--yes -y

확인을 묻는 메시지를 표시하지 마세요.

속성 값
Default value: False
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az changesafety changerecord list

ChangeRecord 리소스를 나열합니다.

구독 또는 리소스 그룹의 모든 ChangeRecord 리소스를 나열합니다.

az changesafety changerecord list [--max-items]
                                  [--next-token]
                                  [--resource-group]

예제

현재 구독의 모든 ChangeRecords 나열

az changesafety changerecord list

특정 리소스 그룹의 ChangeRecords 나열

az changesafety changerecord list -g MyResourceGroup

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--max-items

명령의 출력에서 반환할 총 항목 수입니다. 사용 가능한 총 항목 수가 지정된 값보다 많으면 명령의 출력에 토큰이 제공됩니다. 페이지 매김을 다시 시작하려면 후속 명령의 --next-token 인수에 토큰 값을 제공합니다.

속성 값
매개 변수 그룹: Pagination Arguments
--next-token

페이지 매김을 시작할 위치를 지정하는 토큰입니다. 이는 이전에 잘린 응답의 토큰 값입니다.

속성 값
매개 변수 그룹: Pagination Arguments
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az changesafety changerecord show

ChangeRecord 리소스에 대한 세부 정보를 표시합니다.

az changesafety changerecord show [--change-record-name --name]
                                  [--ids]
                                  [--resource-group]
                                  [--subscription]

예제

ChangeRecord 표시

az changesafety changerecord show -g MyResourceGroup -n changerecord001

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--change-record-name --name -n

ChangeRecord 리소스의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False

az changesafety changerecord update

기존 ChangeRecord 리소스를 업데이트합니다.

이 명령을 사용하여 기존 ChangeRecord에 대한 설명이 포함된 메타데이터, 롤아웃 설정 또는 예약을 수정할 수 있습니다. 참고: changeDefinition(대상)은 만든 후에 수정할 수 없습니다.

az changesafety changerecord update [--acquire-policy-token]
                                    [--add]
                                    [--additional-data]
                                    [--anticipated-end-time]
                                    [--anticipated-start-time]
                                    [--change-record-name --name]
                                    [--change-reference]
                                    [--change-type {AppDeployment, Config, ManualTouch, PolicyDeployment}]
                                    [--comments]
                                    [--description]
                                    [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                    [--ids]
                                    [--links]
                                    [--orchestration-tool]
                                    [--parameters]
                                    [--release-label]
                                    [--remove]
                                    [--resource-group]
                                    [--rollout-type {Emergency, Hotfix, Normal}]
                                    [--set]
                                    [--stage-map]
                                    [--stage-map-name --stagemap-name]
                                    [--subscription]

예제

롤아웃 유형 조정 및 메모 추가

az changesafety changerecord update -g MyResourceGroup -n changerecord001 --rollout-type Emergency --comments "Escalated to emergency rollout"

일정 업데이트 창

az changesafety changerecord update -g MyResourceGroup -n changerecord001 --anticipated-start-time "2026-09-01T08:00:00Z" --anticipated-end-time "2026-09-01T12:00:00Z"

업데이트 설명

az changesafety changerecord update -g MyResourceGroup -n changerecord001 --description "Updated rollout for production deployment"

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--acquire-policy-token

이 리소스 작업에 대한 Azure Policy 토큰을 자동으로 획득합니다.

속성 값
매개 변수 그룹: Global Policy Arguments
--add

경로 및 키 값 쌍을 지정하여 개체 목록에 개체를 추가합니다. 예: --add property.listProperty <key=value, string or JSON string>.

속성 값
매개 변수 그룹: Generic Update Arguments
--additional-data

다양한 오케스트레이션 도구에 필요한 변경에 대한 추가 메타데이터입니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

속성 값
매개 변수 그룹: Properties Arguments
--anticipated-end-time

예상 완료 시간을 ISO 8601 형식으로 업데이트합니다. 생략하면 현재 값이 유지됩니다.

속성 값
매개 변수 그룹: Properties Arguments
--anticipated-start-time

예상 시작 시간을 ISO 8601 형식으로 업데이트합니다. 생략하면 현재 값이 유지됩니다.

속성 값
매개 변수 그룹: Properties Arguments
--change-record-name --name -n

ChangeRecord 리소스의 이름입니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--change-reference

이 리소스 작업에 대한 관련 변경 참조 ID입니다.

속성 값
매개 변수 그룹: Global Policy Arguments
--change-type

변경의 특성을 설명합니다.

속성 값
매개 변수 그룹: Properties Arguments
허용되는 값: AppDeployment, Config, ManualTouch, PolicyDeployment
--comments

ChangeRecord에 대한 최신 업데이트에 대한 메모를 제공합니다.

속성 값
매개 변수 그룹: Properties Arguments
--description

변경에 대한 설명을 업데이트합니다.

속성 값
매개 변수 그룹: Properties Arguments
--force-string

'set' 또는 'add'를 사용하는 경우 JSON으로 변환하는 대신 문자열 리터럴을 유지합니다.

속성 값
매개 변수 그룹: Generic Update Arguments
허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--ids

하나 이상의 리소스 ID(공백으로 구분). '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--links

변경에 대한 관련 링크의 컬렉션입니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

속성 값
매개 변수 그룹: Properties Arguments
--orchestration-tool

이 변경 내용의 배포 오케스트레이션에 사용되는 도구입니다.

속성 값
매개 변수 그룹: Properties Arguments
--parameters

각 stageProgression에 대해 제공될 매개 변수의 스키마입니다. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

속성 값
매개 변수 그룹: Properties Arguments
--release-label

이 변경과 관련된 릴리스의 레이블입니다.

속성 값
매개 변수 그룹: Properties Arguments
--remove

목록에서 속성 또는 요소를 제거합니다. 예: --remove property.list <indexToRemove> OR --remove propertyToRemove.

속성 값
매개 변수 그룹: Generic Update Arguments
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>사용하여 기본 그룹을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
--rollout-type

변경에 사용되는 롤아웃의 형식을 설명합니다.

속성 값
매개 변수 그룹: Properties Arguments
허용되는 값: Emergency, Hotfix, Normal
--set

설정할 속성 경로와 값을 지정하여 개체를 업데이트합니다. 예: --set property1.property2=<value>.

속성 값
매개 변수 그룹: Generic Update Arguments
--stage-map

resource-id=RESOURCE_ID 및 선택적 매개 변수 키=값 쌍을 사용하여 기존 StageMap 리소스를 참조합니다.

속성 값
매개 변수 그룹: Properties Arguments
--stage-map-name --stagemap-name

현재 구독 범위의 StageMap 이름입니다. 리소스 ID가 작성되었습니다.

속성 값
매개 변수 그룹: Properties Arguments
--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 구독을 구성할 수 있습니다.

속성 값
매개 변수 그룹: Resource Id Arguments
전역 매개 변수
--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성 값
Default value: False
--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성 값
Default value: False
--output -o

출력 형식

속성 값
Default value: json
허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성 값
Default value: False