az group deployment

Azure Resource Manager 배포를 관리합니다.

명령

az group deployment cancel

현재 실행 중인 템플릿 배포를 취소합니다.

az group deployment create

배포를 시작합니다.

az group deployment delete

배포 기록에서 배포를 삭제합니다.

az group deployment export

배포에 사용된 템플릿을 내보냅니다.

az group deployment list

리소스 그룹의 모든 배포를 가져옵니다.

az group deployment operation

배포 작업을 관리 합니다.

az group deployment operation list

배포에 대 한 모든 배포 작업을 가져옵니다.

az group deployment operation show

배포의 작업을 가져옵니다.

az group deployment show

배포를 가져옵니다.

az group deployment validate

템플릿이 구문상 올바른지 확인합니다.

az group deployment wait

배포 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az group deployment cancel

현재 실행 중인 템플릿 배포를 취소합니다.

provisioningState가 수락됨 또는 실행 중인 경우에만 배포를 취소할 수 있습니다. 배포가 취소되면 provisioningState가 Canceled로 설정됩니다. 템플릿 배포를 취소하면 현재 실행 중인 템플릿 배포가 중지되고 리소스 그룹은 부분적으로 배포된 상태를 유지합니다.

az group deployment cancel --name
                           --resource-group
                           [--subscription]

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

선택적 매개 변수

--subscription

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

az group deployment create

배포를 시작합니다.

az group deployment create --resource-group
                           [--aux-subs]
                           [--aux-tenants]
                           [--handle-extended-json-format]
                           [--mode {Complete, Incremental}]
                           [--name]
                           [--no-prompt {false, true}]
                           [--no-wait]
                           [--parameters]
                           [--rollback-on-error]
                           [--subscription]
                           [--template-file]
                           [--template-uri]

예제

로컬 JSON 파일의 매개 변수를 사용하여 원격 템플릿 파일에서 배포를 만듭니다.

az group deployment create -g MyResourceGroup --template-uri https://myresource/azuredeploy.json --parameters @myparameters.json

JSON 문자열의 매개 변수를 사용하여 로컬 템플릿 파일에서 배포를 만듭니다.

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters "{ \"location\": { \"value\": \"westus\" } }"

로컬 매개 변수 파일, 원격 매개 변수 파일을 사용하고 선택적으로 키/값 쌍을 재정의하여 로컬 템플릿에서 배포를 만듭니다.

az group deployment create -g MyResourceGroup --template-file azuredeploy.json \
    --parameters @params.json --parameters https://mysite/params.json --parameters MyValue=This MyArray=@array.json

필수 매개 변수

--resource-group -g

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

선택적 매개 변수

--aux-subs

테넌트 간에 배포하는 동안 사용할 보조 구독입니다.

--aux-tenants

테넌트 간에 배포하는 동안 사용할 보조 테넌트입니다.

--handle-extended-json-format -j

배포에서 여러 선 및 주석을 포함하여 확장된 템플릿 콘텐츠를 처리할 수 있도록 지원합니다.

--mode

증분(리소스 그룹에 리소스만 추가) 또는 완료(리소스 그룹에서 추가 리소스 제거).

허용되는 값: Complete, Incremental
기본값: Incremental
--name -n

배포 이름입니다. 기본값은 템플릿 파일 기본 이름입니다.

--no-prompt

ARM 템플릿에 대한 매개 변수 누락 프롬프트를 사용하지 않도록 설정하는 옵션입니다. 값이 true이면 사용자에게 누락된 매개 변수를 제공하도록 요구하는 프롬프트가 무시됩니다. 기본값은 false입니다.

허용되는 값: false, true
--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--parameters -p

배포 매개 변수 값을 제공 합니다.

--rollback-on-error

오류 발생 시에 롤백할 배포의 이름이거나 플래그로 사용하여 마지막으로 성공한 배포로 롤백합니다.

--subscription

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

--template-file -f

파일 시스템의 템플릿 파일 또는 Bicep 파일에 대한 경로입니다.

--template-uri -u

원격 템플릿 파일에 대한 URI입니다.

az group deployment delete

배포 기록에서 배포를 삭제합니다.

현재 실행 중인 템플릿 배포는 삭제할 수 없습니다. 템플릿 배포를 삭제하면 연결된 배포 작업이 제거됩니다. 템플릿 배포를 삭제해도 리소스 그룹의 상태에는 영향을 주지 않습니다. 템플릿 배포가 성공적으로 삭제될 때까지 202 상태를 반환하는 비동기 작업입니다. 위치 응답 헤더에는 프로세스의 상태를 가져오는 데 사용되는 URI가 포함되어 있습니다. 프로세스가 실행되는 동안 Location 헤더의 URI에 대한 호출은 202의 상태를 반환합니다. 프로세스가 완료되면 Location 헤더의 URI는 성공 시 204의 상태를 반환합니다. 비동기 요청이 실패하면 위치 헤더의 URI가 오류 수준 상태 코드를 반환합니다.

az group deployment delete --name
                           --resource-group
                           [--no-wait]
                           [--subscription]

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--subscription

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

az group deployment export

배포에 사용된 템플릿을 내보냅니다.

az group deployment export --name
                           --resource-group
                           [--subscription]

예제

배포에 사용된 템플릿을 내보냅니다. (자동 생성)

az group deployment export --name MyDeployment --resource-group MyResourceGroup

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

선택적 매개 변수

--subscription

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

az group deployment list

리소스 그룹의 모든 배포를 가져옵니다.

az group deployment list --resource-group
                         [--filter]
                         [--query-examples]
                         [--subscription]
                         [--top]

필수 매개 변수

--resource-group -g

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

선택적 매개 변수

--filter

작업에 적용할 필터입니다. 예를 들어 $filter=provisioningState eq '{state}'를 사용할 수 있습니다.

--query-examples

JMESPath 문자열을 권장합니다. 쿼리 중 하나를 복사하여 큰따옴표 안에 --query 매개 변수를 붙여넣어 결과를 볼 수 있습니다. 이러한 키워드를 기반으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--subscription

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

--top

얻을 결과 수입니다. null이 전달되면 는 모든 배포를 반환합니다.

az group deployment show

배포를 가져옵니다.

az group deployment show --name
                         --resource-group
                         [--query-examples]
                         [--subscription]

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

선택적 매개 변수

--query-examples

JMESPath 문자열을 권장합니다. 쿼리 중 하나를 복사하여 큰따옴표 안에 --query 매개 변수를 붙여넣어 결과를 볼 수 있습니다. 이러한 키워드를 기반으로 제안을 제공할 수 있도록 하나 이상의 위치 키워드를 추가할 수 있습니다.

--subscription

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

az group deployment validate

템플릿이 구문상 올바른지 확인합니다.

az group deployment validate --resource-group
                             [--handle-extended-json-format]
                             [--mode {Complete, Incremental}]
                             [--no-prompt {false, true}]
                             [--parameters]
                             [--rollback-on-error]
                             [--subscription]
                             [--template-file]
                             [--template-uri]

예제

템플릿이 구문상 올바른지 확인합니다. (자동 생성)

az group deployment validate --parameters "{ \"location\": { \"value\": \"westus\" } }" \
    --resource-group MyResourceGroup --template-file storage.json

필수 매개 변수

--resource-group -g

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

선택적 매개 변수

--handle-extended-json-format -j

배포에서 여러 선 및 주석을 포함하여 확장된 템플릿 콘텐츠를 처리할 수 있도록 지원합니다.

--mode

증분(리소스 그룹에 리소스만 추가) 또는 완료(리소스 그룹에서 추가 리소스 제거).

허용되는 값: Complete, Incremental
기본값: Incremental
--no-prompt

ARM 템플릿에 대한 매개 변수 누락 프롬프트를 사용하지 않도록 설정하는 옵션입니다. 값이 true이면 사용자에게 누락된 매개 변수를 제공하도록 요구하는 프롬프트가 무시됩니다. 기본값은 false입니다.

허용되는 값: false, true
--parameters -p

배포 매개 변수 값을 제공 합니다.

--rollback-on-error

오류 발생 시에 롤백할 배포의 이름이거나 플래그로 사용하여 마지막으로 성공한 배포로 롤백합니다.

--subscription

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

--template-file -f

파일 시스템의 템플릿 파일 또는 Bicep 파일에 대한 경로입니다.

--template-uri -u

원격 템플릿 파일에 대한 URI입니다.

az group deployment wait

배포 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az group deployment wait --name
                         --resource-group
                         [--created]
                         [--custom]
                         [--deleted]
                         [--exists]
                         [--interval]
                         [--subscription]
                         [--timeout]
                         [--updated]

예제

배포 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다. (자동 생성)

az group deployment wait --name MyDeployment --resource-group MyResourceGroup --updated

배포 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다. (자동 생성)

az group deployment wait --created --name MyDeployment --resource-group MyResourceGroup

필수 매개 변수

--name -n

배포 이름입니다.

--resource-group -g

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

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 통해 생성될 때까지 기다립니다.

--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예를 들어 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

--exists

리소스가 존재할 때까지 기다립니다.

--interval

폴링 간격(초)입니다.

기본값: 30
--subscription

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

--timeout

최대 대기 시간(초)입니다.

기본값: 3600
--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.