다음을 통해 공유


az resource

Azure 리소스를 관리합니다.

명령

Name Description 형식 상태
az resource create

리소스를 만듭니다.

핵심 GA
az resource delete

리소스 삭제

핵심 GA
az resource invoke-action

리소스에 대한 작업을 호출합니다.

핵심 GA
az resource link

리소스 간의 링크를 관리합니다.

핵심 GA
az resource link create

리소스 간에 새 링크를 만듭니다.

핵심 GA
az resource link delete

리소스 간의 링크를 삭제합니다.

핵심 GA
az resource link list

리소스 링크를 나열합니다.

핵심 GA
az resource link show

지정된 ID가 있는 리소스 링크를 가져옵니다.

핵심 GA
az resource link update

리소스 간 링크를 업데이트합니다.

핵심 GA
az resource list

리소스를 나열합니다.

핵심 GA
az resource lock

Azure 리소스 수준 잠금을 관리합니다.

핵심 GA
az resource lock create

리소스 수준 잠금을 만듭니다.

핵심 GA
az resource lock delete

리소스 수준 잠금을 삭제합니다.

핵심 GA
az resource lock list

리소스 수준에서 잠금 정보를 나열합니다.

핵심 GA
az resource lock show

리소스 수준 잠금의 세부 정보를 표시합니다.

핵심 GA
az resource lock update

리소스 수준 잠금을 업데이트합니다.

핵심 GA
az resource move

리소스를 한 리소스 그룹에서 다른 리소스 그룹으로 이동합니다(다른 구독에 있을 수 있습니다).

핵심 GA
az resource patch

PATCH 요청에 따라 리소스를 업데이트합니다.

핵심 GA
az resource show

리소스의 세부 정보를 가져옵니다.

핵심 GA
az resource tag

리소스에 태그를 지정합니다.

핵심 GA
az resource update

PUT 요청별로 리소스를 업데이트합니다.

핵심 GA
az resource wait

리소스 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

핵심 GA

az resource create

리소스를 만듭니다.

az resource create --properties
                   [--api-version]
                   [--id]
                   [--is-full-object]
                   [--latest-include-preview]
                   [--location]
                   [--name]
                   [--namespace]
                   [--parent]
                   [--resource-group]
                   [--resource-type]

예제

전체 JSON 구성을 제공하여 API 앱을 만듭니다.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites \
    --is-full-object --properties "{ \"kind\": \"api\", \"location\": \
        \"West US\", \"properties\": { \"serverFarmId\": \
            \"/subscriptions/{SubID}/resourcegroups/{ResourceGroup} \
                /providers/Microsoft.Web/serverfarms/{ServicePlan}\" } }"

파일에서 JSON 구성을 로드하여 리소스를 만듭니다.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites --is-full-object --properties @jsonConfigFile

필요한 최소 구성 정보를 사용하여 웹앱을 만듭니다.

az resource create -g myRG -n myWeb --resource-type Microsoft.web/sites \
    --properties "{ \"serverFarmId\":\"/subscriptions/{SubID}/resourcegroups/ \
        {ResourceGroup}/providers/Microsoft.Web/serverfarms/{ServicePlan}\" }"

이 버전이 미리 보기 버전인지 여부에 관계없이 최신 api-version을 사용하여 리소스를 만듭니다.

az resource create -g myRG -n myApiApp --resource-type Microsoft.web/sites --is-full-object --properties @jsonConfigFile --latest-include-preview

웹앱에 대한 사이트 확장 만들기

az resource create -g myRG --api-version "2018-02-01" \
    --name "{sitename+slot}/siteextensions/Contrast.NetCore.Azure.SiteExtension"  \
        --resource-type Microsoft.Web/sites/siteextensions --is-full-object \
            --properties "{ \"id\": \"Contrast.NetCore.Azure.SiteExtension\", \
                \"location\": \"West US\", \"version\": \"1.9.0\" }"

필수 매개 변수

--properties -p

리소스 속성을 포함하는 JSON 형식 문자열입니다.

선택적 매개 변수

--api-version

리소스의 api 버전입니다(안정적인 최신 버전은 생략).

--id

리소스 ID입니다.

--is-full-object

속성 개체에 위치, 태그, sku 및/또는 계획과 같은 다른 옵션이 포함되어 있음을 나타냅니다.

Default value: False
--latest-include-preview -v
미리 보기

최신 api-version이 미리 보기 버전(예: 2020-01-01-preview)인지 여부에 관계없이 사용됨을 나타냅니다. 예를 들어 지원되는 리소스 공급자의 api-version이 2020-01-01-preview 및 2019-01-01인 경우 이 매개 변수를 전달할 때 최신 버전 2020-01-01-preview가 사용되며, 그렇지 않으면 이 매개 변수를 전달하지 않고 안정적인 최신 버전 2019-01-01을 사용합니다.

Default value: False
--location -l

위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--name -n

리소스 이름입니다. (예: myC).

--namespace

공급자 네임스페이스(예: 'Microsoft.Provider').

--parent

부모 경로(예: 'resA/myA/resB/myB')입니다.

--resource-group -g

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

--resource-type

리소스 종류(예: 'resC')입니다. 네임스페이스/형식 형식(예: 'Microsoft.Provider/resC')도 수락할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az resource delete

리소스 삭제

az resource delete [--api-version]
                   [--ids]
                   [--latest-include-preview]
                   [--name]
                   [--namespace]
                   [--no-wait]
                   [--parent]
                   [--resource-group]
                   [--resource-type]

예제

'MyVm'이라는 가상 머신을 삭제합니다.

az resource delete -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

리소스 식별자를 사용하여 웹앱을 삭제합니다.

az resource delete --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/MyWebapp

리소스 식별자를 사용하여 서브넷을 삭제합니다.

az resource delete --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet

이 버전이 미리 보기 버전인지 여부를 최신 api-version을 사용하여 'MyVm'이라는 가상 머신을 삭제합니다.

az resource delete -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

선택적 매개 변수

--api-version

리소스의 api 버전입니다(안정적인 최신 버전은 생략).

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. 제공된 경우 다른 "리소스 ID" 인수를 지정하지 않아야 합니다.

--latest-include-preview -v
미리 보기

최신 api-version이 미리 보기 버전(예: 2020-01-01-preview)인지 여부에 관계없이 사용됨을 나타냅니다. 예를 들어 지원되는 리소스 공급자의 api-version이 2020-01-01-preview 및 2019-01-01인 경우 이 매개 변수를 전달할 때 최신 버전 2020-01-01-preview가 사용되며, 그렇지 않으면 이 매개 변수를 전달하지 않고 안정적인 최신 버전 2019-01-01을 사용합니다.

Default value: False
--name -n

리소스 이름입니다. (예: myC).

--namespace

공급자 네임스페이스(예: 'Microsoft.Provider').

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--parent

부모 경로(예: 'resA/myA/resB/myB')입니다.

--resource-group -g

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

--resource-type

리소스 종류(예: 'resC')입니다. 네임스페이스/형식 형식(예: 'Microsoft.Provider/resC')도 수락할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az resource invoke-action

리소스에 대한 작업을 호출합니다.

리소스에 해당하는 가능한 작업 목록은 .에서 https://docs.microsoft.com/rest/api/찾을 수 있습니다. 모든 POST 요청은 호출할 수 있는 작업이며 URI 경로의 끝에 지정됩니다. 예를 들어 VM을 중지하려면 요청 URI가 https://management.azure.com/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VM}/powerOff?api-version={APIVersion} 해당 작업 powerOff입니다. 이 내용은 .에서 https://docs.microsoft.com/rest/api/compute/virtualmachines/virtualmachines-stop찾을 수 있습니다.

az resource invoke-action --action
                          [--api-version]
                          [--ids]
                          [--latest-include-preview]
                          [--name]
                          [--namespace]
                          [--no-wait]
                          [--parent]
                          [--request-body]
                          [--resource-group]
                          [--resource-type]

예제

ID로 지정된 vm의 전원을 끕니다.

az resource invoke-action --action powerOff \
  --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Compute/virtualMachines/{VMName}

중지된 vm에 대한 정보를 캡처합니다.

az resource invoke-action --action capture \
  --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/ \
    Microsoft.Compute/virtualMachines/{VMName} \
  --request-body "{ \"vhdPrefix\": \"myPrefix\", \"destinationContainerName\": \
    \"myContainer\", \"overwriteVhds\": true }"

리소스에 대한 작업을 호출합니다. (자동 생성됨)

az resource invoke-action --action capture --name MyResource --resource-group MyResourceGroup --resource-type Microsoft.web/sites

필수 매개 변수

--action

지정된 리소스에서 호출될 작업입니다.

선택적 매개 변수

--api-version

리소스의 api 버전입니다(안정적인 최신 버전은 생략).

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. 제공된 경우 다른 "리소스 ID" 인수를 지정하지 않아야 합니다.

--latest-include-preview -v
미리 보기

최신 api-version이 미리 보기 버전(예: 2020-01-01-preview)인지 여부에 관계없이 사용됨을 나타냅니다. 예를 들어 지원되는 리소스 공급자의 api-version이 2020-01-01-preview 및 2019-01-01인 경우 이 매개 변수를 전달할 때 최신 버전 2020-01-01-preview가 사용되며, 그렇지 않으면 이 매개 변수를 전달하지 않고 안정적인 최신 버전 2019-01-01을 사용합니다.

Default value: False
--name -n

리소스 이름입니다. (예: myC).

--namespace

공급자 네임스페이스(예: 'Microsoft.Provider').

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

Default value: False
--parent

부모 경로(예: 'resA/myA/resB/myB')입니다.

--request-body

요청 후 본문에 전달될 작업에 대한 JSON 인코딩 매개 변수 인수입니다. @{file}을(를) 사용하여 파일에서 로드합니다.

--resource-group -g

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

--resource-type

리소스 종류(예: 'resC')입니다. 네임스페이스/형식 형식(예: 'Microsoft.Provider/resC')도 수락할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az resource list

리소스를 나열합니다.

az resource list [--location]
                 [--name]
                 [--namespace]
                 [--resource-group]
                 [--resource-type]
                 [--tag]

예제

미국 서부 지역의 모든 리소스를 나열합니다.

az resource list --location westus

이름이 'resourceName'인 모든 리소스를 나열합니다.

az resource list --name 'resourceName'

태그가 'test'인 모든 리소스를 나열합니다.

az resource list --tag test

'test'로 시작하는 태그가 있는 모든 리소스를 나열합니다.

az resource list --tag 'test*'

값이 'example'인 태그가 'test'인 모든 리소스를 나열합니다.

az resource list --tag test=example

선택적 매개 변수

--location -l

위치. 값: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--name -n

리소스 이름입니다. (예: myC).

--namespace

공급자 네임스페이스(예: 'Microsoft.Provider').

--resource-group -g

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

--resource-type

리소스 종류(예: 'resC')입니다. 네임스페이스/형식 형식(예: 'Microsoft.Provider/resC')도 수락할 수 있습니다.

--tag

'key[=value]' 형식의 단일 태그입니다. ""를 사용하여 기존 태그를 지웁니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az resource move

리소스를 한 리소스 그룹에서 다른 리소스 그룹으로 이동합니다(다른 구독에 있을 수 있습니다).

az resource move --destination-group
                 --ids
                 [--destination-subscription-id]

예제

대상 구독에서 대상 리소스 그룹으로 여러 리소스 이동

az resource move --destination-group ResourceGroup --destination-subscription-id SubscriptionId --ids "ResourceId1" "ResourceId2" "ResourceId3"

필수 매개 변수

--destination-group

대상 리소스 그룹 이름입니다.

--ids

이동할 공백으로 구분된 리소스 ID입니다.

선택적 매개 변수

--destination-subscription-id

대상 구독 식별자입니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az resource patch

PATCH 요청에 따라 리소스를 업데이트합니다.

JSON 형식 문자열을 사용하여 리소스 업데이트를 지원합니다. 패치 작업이 실패하면 'az resource update'를 대신 실행해 보세요.

az resource patch --properties
                  [--api-version]
                  [--ids]
                  [--is-full-object]
                  [--latest-include-preview]
                  [--name]
                  [--namespace]
                  [--parent]
                  [--resource-group]
                  [--resource-type]

예제

이 버전이 미리 보기 버전인지 여부를 최신 api-version을 사용하여 웹앱을 업데이트합니다.

az resource patch --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} \
  --latest-include-preview --is-full-object --properties "{ \"tags\": { \"key\": \"value\" } }"

파일에서 JSON 구성을 사용하여 리소스를 업데이트합니다.

az resource patch --name MyResource --resource-group MyResourceGroup --resource-type Microsoft.web/sites \
  --is-full-object --properties @jsonConfigFile

JSON 구성을 제공하여 API 앱을 업데이트합니다.

az resource patch --name MyApiApp --resource-group MyResourceGroup --resource-type Microsoft.web/sites \
    --is-full-object --properties "{ \"kind\": \"api\", \"properties\": { \"serverFarmId\": \
            \"/subscriptions/{SubID}/resourcegroups/{ResourceGroup} \
                /providers/Microsoft.Web/serverfarms/{ServicePlan}\" } }"

필수 매개 변수

--properties -p

리소스 속성을 포함하는 JSON 형식 문자열입니다.

선택적 매개 변수

--api-version

리소스의 api 버전입니다(안정적인 최신 버전은 생략).

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. 제공된 경우 다른 "리소스 ID" 인수를 지정하지 않아야 합니다.

--is-full-object

속성 개체에 위치, 태그, sku 및/또는 계획과 같은 다른 옵션이 포함되어 있음을 나타냅니다.

Default value: False
--latest-include-preview -v
미리 보기

최신 api-version이 미리 보기 버전(예: 2020-01-01-preview)인지 여부에 관계없이 사용됨을 나타냅니다. 예를 들어 지원되는 리소스 공급자의 api-version이 2020-01-01-preview 및 2019-01-01인 경우 이 매개 변수를 전달할 때 최신 버전 2020-01-01-preview가 사용되며, 그렇지 않으면 이 매개 변수를 전달하지 않고 안정적인 최신 버전 2019-01-01을 사용합니다.

Default value: False
--name -n

리소스 이름입니다. (예: myC).

--namespace

공급자 네임스페이스(예: 'Microsoft.Provider').

--parent

부모 경로(예: 'resA/myA/resB/myB')입니다.

--resource-group -g

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

--resource-type

리소스 종류(예: 'resC')입니다. 네임스페이스/형식 형식(예: 'Microsoft.Provider/resC')도 수락할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az resource show

리소스의 세부 정보를 가져옵니다.

az resource show [--api-version]
                 [--ids]
                 [--include-response-body {false, true}]
                 [--latest-include-preview]
                 [--name]
                 [--namespace]
                 [--parent]
                 [--resource-group]
                 [--resource-type]

예제

'MyVm'이라는 가상 머신 리소스를 표시합니다.

az resource show -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

리소스 식별자를 사용하여 웹앱을 표시합니다.

az resource show --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Web/sites/MyWebapp

서브넷을 표시합니다.

az resource show -g MyResourceGroup -n MySubnet --namespace Microsoft.Network --parent virtualnetworks/MyVnet --resource-type subnets

리소스 식별자를 사용하여 서브넷을 표시합니다.

az resource show --ids /subscriptions/0b1f6471-1bf0-4dda-aec3-111111111111/resourceGroups/MyResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet

애플리케이션 게이트웨이 경로 규칙을 표시합니다.

az resource show -g MyResourceGroup --namespace Microsoft.Network --parent applicationGateways/ag1/urlPathMaps/map1 --resource-type pathRules -n rule1

이 버전이 미리 보기 버전인지 여부를 최신 api-version을 사용하여 'MyVm'이라는 가상 머신 리소스를 표시합니다.

az resource show -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

선택적 매개 변수

--api-version

리소스의 api 버전입니다(안정적인 최신 버전은 생략).

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. 제공된 경우 다른 "리소스 ID" 인수를 지정하지 않아야 합니다.

--include-response-body

기본 명령 출력이 모든 속성 데이터를 캡처하지 않는 경우 사용합니다.

허용되는 값: false, true
Default value: False
--latest-include-preview -v
미리 보기

최신 api-version이 미리 보기 버전(예: 2020-01-01-preview)인지 여부에 관계없이 사용됨을 나타냅니다. 예를 들어 지원되는 리소스 공급자의 api-version이 2020-01-01-preview 및 2019-01-01인 경우 이 매개 변수를 전달할 때 최신 버전 2020-01-01-preview가 사용되며, 그렇지 않으면 이 매개 변수를 전달하지 않고 안정적인 최신 버전 2019-01-01을 사용합니다.

Default value: False
--name -n

리소스 이름입니다. (예: myC).

--namespace

공급자 네임스페이스(예: 'Microsoft.Provider').

--parent

부모 경로(예: 'resA/myA/resB/myB')입니다.

--resource-group -g

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

--resource-type

리소스 종류(예: 'resC')입니다. 네임스페이스/형식 형식(예: 'Microsoft.Provider/resC')도 수락할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az resource tag

리소스에 태그를 지정합니다.

az resource tag --tags
                [--api-version]
                [--ids]
                [--is-incremental]
                [--latest-include-preview]
                [--name]
                [--namespace]
                [--parent]
                [--resource-group]
                [--resource-type]

예제

가상 머신 'MyVm'에 'vmlist' 키와 값 'vm1'에 태그를 지정합니다.

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines"

리소스 식별자를 사용하여 'vmlist' 키와 값 'vm1'으로 웹앱에 태그를 지정합니다.

az resource tag --tags vmlist=vm1 --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp}

가상 머신 'MyVm'에 'vmlist' 키와 값 'vm1'에 증분 방식으로 태그를 지정합니다. 기존 태그는 비워 두지 않습니다.

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" -i

이 버전이 미리 보기 버전인지 여부를 최신 api-version을 사용하여 가상 머신 'MyVm'에 키 'vmlist'와 값 'vm1'에 태그를 지정합니다.

az resource tag --tags vmlist=vm1 -g MyResourceGroup -n MyVm --resource-type "Microsoft.Compute/virtualMachines" --latest-include-preview

필수 매개 변수

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

선택적 매개 변수

--api-version

리소스의 api 버전입니다(안정적인 최신 버전은 생략).

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. 제공된 경우 다른 "리소스 ID" 인수를 지정하지 않아야 합니다.

--is-incremental -i

원래 태그를 삭제하지 않고 태그를 증분 방식으로 추가하는 옵션입니다. 새 태그와 원래 태그의 키가 중복되면 원래 값을 덮어씁니다.

--latest-include-preview -v
미리 보기

최신 api-version이 미리 보기 버전(예: 2020-01-01-preview)인지 여부에 관계없이 사용됨을 나타냅니다. 예를 들어 지원되는 리소스 공급자의 api-version이 2020-01-01-preview 및 2019-01-01인 경우 이 매개 변수를 전달할 때 최신 버전 2020-01-01-preview가 사용되며, 그렇지 않으면 이 매개 변수를 전달하지 않고 안정적인 최신 버전 2019-01-01을 사용합니다.

Default value: False
--name -n

리소스 이름입니다. (예: myC).

--namespace

공급자 네임스페이스(예: 'Microsoft.Provider').

--parent

부모 경로(예: 'resA/myA/resB/myB')입니다.

--resource-group -g

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

--resource-type

리소스 종류(예: 'resC')입니다. 네임스페이스/형식 형식(예: 'Microsoft.Provider/resC')도 수락할 수 있습니다.

전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az resource update

PUT 요청별로 리소스를 업데이트합니다.

일반 업데이트(속성 경로 사용)를 지원하여 리소스를 업데이트합니다. 업데이트 작업이 실패하면 'az resource patch'를 대신 실행해 보세요.

az resource update [--add]
                   [--api-version]
                   [--force-string]
                   [--ids]
                   [--include-response-body {false, true}]
                   [--latest-include-preview]
                   [--name]
                   [--namespace]
                   [--parent]
                   [--remove]
                   [--resource-group]
                   [--resource-type]
                   [--set]

예제

이 버전이 미리 보기 버전인지 여부를 최신 api-version을 사용하여 웹앱을 업데이트합니다.

az resource update --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} --set tags.key=value --latest-include-preview

리소스 업데이트 (자동 생성됨)

az resource update --ids $id --set properties.connectionType=Proxy

리소스 업데이트 (자동 생성됨)

az resource update --name MyResource --resource-group MyResourceGroup --resource-type subnets --set tags.key=value

선택적 매개 변수

--add

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

Default value: []
--api-version

리소스의 api 버전입니다(안정적인 최신 버전은 생략).

--force-string

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

Default value: False
--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. 제공된 경우 다른 "리소스 ID" 인수를 지정하지 않아야 합니다.

--include-response-body

기본 명령 출력이 모든 속성 데이터를 캡처하지 않는 경우 사용합니다.

허용되는 값: false, true
Default value: False
--latest-include-preview -v
미리 보기

최신 api-version이 미리 보기 버전(예: 2020-01-01-preview)인지 여부에 관계없이 사용됨을 나타냅니다. 예를 들어 지원되는 리소스 공급자의 api-version이 2020-01-01-preview 및 2019-01-01인 경우 이 매개 변수를 전달할 때 최신 버전 2020-01-01-preview가 사용되며, 그렇지 않으면 이 매개 변수를 전달하지 않고 안정적인 최신 버전 2019-01-01을 사용합니다.

Default value: False
--name -n

리소스 이름입니다. (예: myC).

--namespace

공급자 네임스페이스(예: 'Microsoft.Provider').

--parent

부모 경로(예: 'resA/myA/resB/myB')입니다.

--remove

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

Default value: []
--resource-group -g

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

--resource-type

리소스 종류(예: 'resC')입니다. 네임스페이스/형식 형식(예: 'Microsoft.Provider/resC')도 수락할 수 있습니다.

--set

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

Default value: []
전역 매개 변수
--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az resource wait

리소스 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

az resource wait [--api-version]
                 [--created]
                 [--custom]
                 [--deleted]
                 [--exists]
                 [--ids]
                 [--include-response-body {false, true}]
                 [--interval]
                 [--name]
                 [--namespace]
                 [--parent]
                 [--resource-group]
                 [--resource-type]
                 [--timeout]
                 [--updated]

예제

리소스 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다. (자동 생성됨)

az resource wait --exists --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp}

리소스 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다. (자동 생성됨)

az resource wait --exists --ids /subscriptions/{SubID}/resourceGroups/{ResourceGroup}/providers/Microsoft.Web/sites/{WebApp} --include-response-body true

리소스 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다. (자동 생성됨)

az resource wait --exists --name MyResource --resource-group MyResourceGroup --resource-type subnets

선택적 매개 변수

--api-version

리소스의 api 버전입니다(안정적인 최신 버전은 생략).

--created

'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.

Default value: False
--custom

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

--deleted

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

Default value: False
--exists

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

Default value: False
--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. 제공된 경우 다른 "리소스 ID" 인수를 지정하지 않아야 합니다.

--include-response-body

기본 명령 출력이 모든 속성 데이터를 캡처하지 않는 경우 사용합니다.

허용되는 값: false, true
Default value: False
--interval

폴링 간격(초)입니다.

Default value: 30
--name -n

리소스 이름입니다. (예: myC).

--namespace

공급자 네임스페이스(예: 'Microsoft.Provider').

--parent

부모 경로(예: 'resA/myA/resB/myB')입니다.

--resource-group -g

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

--resource-type

리소스 종류(예: 'resC')입니다. 네임스페이스/형식 형식(예: 'Microsoft.Provider/resC')도 수락할 수 있습니다.

--timeout

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

Default value: 3600
--updated

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

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

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.