az changesafety changerecord

Note

Эта ссылка является частью расширения azure-changesafety для Azure CLI (версия 2.75.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az changesafety changerecord . Подробнее о расширениях.

Управление ресурсами ChangeRecord, описывающими запланированные изменения в целевых объектах.

Команды

Имя Описание Тип Состояние
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.

Укажите по крайней мере одно определение целевого объекта, чтобы описать, какие ресурсы или операции будут влиять на ИзменениеRecord. Целевые объекты выражаются как пары "запятая" или "точка с запятой": "ключ=значение", такие как resourceId=RESOURCE_ID,operation=DELETE. Команда также доступна с помощью псевдонима az changesafety changerecord. Если вы опустите флаги планирования, ожидаемое время начала по умолчанию по умолчанию и ожидаемое время окончания по умолчанию по умолчанию составляет восемь часов позже (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]

Примеры

Создание объекта 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. Значение по умолчанию — восемь часов после ожидаемого времени начала, когда опущено.

Свойство Значение
Группа параметров: Properties Arguments
--anticipated-start-time

Ожидаемое время начала в формате ISO 8601. По умолчанию используется текущее время UTC при опущении.

Свойство Значение
Группа параметров: Properties Arguments
--change-definition

Изменение текста запроса и (или) критериев выбора ресурсов, используемых для идентификации целевых ресурсов. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

Свойство Значение
Группа параметров: Properties Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: 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

Схема параметров, которые будут предоставлены для каждого этапаProgression. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

Свойство Значение
Группа параметров: Properties Arguments
--release-label

Метка для выпуска, связанного с этим изменением.

Свойство Значение
Группа параметров: Properties Arguments
--resource-group -g

Имя группы ресурсов. Вы можете настроить группу по умолчанию с помощью az configure --defaults group=<name>.

--rollout-type

Укажите тип развертывания (обычный, исправление или аварийное реагирование).

Свойство Значение
Группа параметров: Properties Arguments
Допустимые значения: Emergency, Hotfix, Normal
--stage-map

Ссылка на существующий ресурс StageMap с помощью пар resource-id=RESOURCE_ID и необязательных параметров key=value.

Свойство Значение
Группа параметров: Properties Arguments
--stage-map-name --stagemap-name

Имя StageMap в текущей области подписки; Идентификатор ресурса создается для вас.

Свойство Значение
Группа параметров: Properties Arguments
--targets

Одно или несколько целевых определений, выраженных как пары key=value (например, resourceId=RESOURCE_ID,operation=DELETE,resourceType=Microsoft.Compute/virtualMachines).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: 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

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--ids

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

Имя группы ресурсов. Вы можете настроить группу по умолчанию с помощью az configure --defaults group=<name>.

Свойство Значение
Группа параметров: Resource Id Arguments
--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Группа параметров: Resource Id Arguments
--yes -y

Не запрашивать подтверждение.

Свойство Значение
Значение по умолчанию: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az changesafety changerecord list

Список ресурсов ChangeRecord.

Список всех ресурсов ChangeRecord в подписке или группе ресурсов.

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

Примеры

Список всех измененийRecords в текущей подписке

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

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: 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

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--resource-group -g

Имя группы ресурсов. Вы можете настроить группу по умолчанию с помощью az configure --defaults group=<name>.

Свойство Значение
Группа параметров: Resource Id Arguments
--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Группа параметров: Resource Id Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az changesafety changerecord update

Обновите существующий ресурс ChangeRecord.

Используйте эту команду для изменения описательных метаданных, параметров развертывания или планирования для существующего объекта ChangeRecord. Примечание. ИзменениеDefinition (целевые объекты) невозможно изменить после создания.

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

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: 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

Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие параметры 'Resource Id'.

Свойство Значение
Группа параметров: Resource Id Arguments
--links

Коллекция связанных ссылок для изменения. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

Свойство Значение
Группа параметров: Properties Arguments
--orchestration-tool

Средство, используемое для оркестрации развертывания этого изменения.

Свойство Значение
Группа параметров: Properties Arguments
--parameters

Схема параметров, которые будут предоставлены для каждого этапаProgression. Поддержка сокращенного синтаксиса, 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

Ссылка на существующий ресурс StageMap с помощью пар resource-id=RESOURCE_ID и необязательных параметров key=value.

Свойство Значение
Группа параметров: Properties Arguments
--stage-map-name --stagemap-name

Имя StageMap в текущей области подписки; Идентификатор ресурса создается для вас.

Свойство Значение
Группа параметров: Properties Arguments
--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

Свойство Значение
Группа параметров: Resource Id Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False