az reservations reservation-order

참고 항목

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

명령 그룹 '예약'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

예약 예약 주문.

명령

Name Description 형식 상태
az reservations reservation-order calculate

를 배치하기 위한 가격을 계산합니다 ReservationOrder.

내선 번호 미리 보기
az reservations reservation-order calculate-refund

정책 오류가 없는 경우 반환 Reservations 가격을 계산합니다.

내선 번호 미리 보기
az reservations reservation-order change-directory

디렉터리(테넌트)와 그 아래의 ReservationOrder 모든 Reservation 디렉터리를 지정된 테넌트 ID로 변경합니다.

내선 번호 미리 보기
az reservations reservation-order list

사용자가 현재 테넌트에서 액세스할 수 있는 모든 ReservationOrder항목의 목록입니다.

내선 번호 미리 보기
az reservations reservation-order purchase

지정된 URI에서 리소스를 만들고 ReservationOrder 만듭니다.

내선 번호 미리 보기
az reservations reservation-order return

예약을 반환합니다.

내선 번호 미리 보기
az reservations reservation-order show

의 세부 정보를 ReservationOrder가져옵니다.

내선 번호 미리 보기
az reservations reservation-order wait

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

내선 번호 미리 보기

az reservations reservation-order calculate

미리 보기

명령 그룹 '예약'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

를 배치하기 위한 가격을 계산합니다 ReservationOrder.

az reservations reservation-order calculate [--applied-scope]
                                            [--applied-scope-property]
                                            [--applied-scope-type {ManagementGroup, Shared, Single}]
                                            [--billing-plan {Monthly, Upfront}]
                                            [--billing-scope]
                                            [--display-name]
                                            [--instance-flexibility {Off, On}]
                                            [--location]
                                            [--quantity]
                                            [--renew {0, 1, f, false, n, no, t, true, y, yes}]
                                            [--reserved-resource-type {AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines}]
                                            [--review-date-time]
                                            [--sku]
                                            [--term {P1Y, P3Y, P5Y}]

예제

가격 계산

az reservations reservation-order calculate --applied-scope-type Shared --billing-scope 50000000-aaaa-bbbb-cccc-100000000002 --display-name name1 --quantity 1 --reserved-resource-type VirtualMachines --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus

선택적 매개 변수

--applied-scope

혜택이 적용될 구독입니다. --applied-scope-type이 Single인 경우 필요합니다. --applied-scope-type이 Shared인지 지정하지 마세요. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--applied-scope-property

적용된 범위 유형과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. Required and need and provide tenantId and managementGroupId if AppliedScopeType is ManagementGroup Support shorthand-syntax, json-file and yaml-file. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--applied-scope-type

적용된 범위의 형식입니다.

허용되는 값: ManagementGroup, Shared, Single
--billing-plan

청구 계획을 나타냅니다.

허용되는 값: Monthly, Upfront
--billing-scope

예약 구매에 대한 요금이 청구되는 구독입니다.

--display-name

예약의 이름입니다.

--instance-flexibility

이 기능을 켜면 동일한 VM 크기 그룹의 다른 VM에 예약 할인이 적용됩니다. VirtualMachines 예약 리소스 종류에 대해서만 지정합니다.

허용되는 값: Off, On
--location

예약된 리소스가 있는 Azure 지역입니다.

--quantity

예약의 일부인 SKU의 수량입니다.

--renew

이를 true로 설정하면 만료 날짜 시간에 새 예약이 자동으로 구매됩니다.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
기본값: False
--reserved-resource-type

예약 중인 리소스의 형식입니다.

허용되는 값: AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines
--review-date-time

Azure 하이브리드 혜택을 검토해야 하는 날짜-시간입니다.

--sku

구매를 위한 SKU 이름입니다.

--term

예약 기간을 나타냅니다.

허용되는 값: P1Y, P3Y, P5Y
전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az reservations reservation-order calculate-refund

미리 보기

명령 그룹 '예약'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

정책 오류가 없는 경우 반환 Reservations 가격을 계산합니다.

az reservations reservation-order calculate-refund --reservation-order-id
                                                   [--id]
                                                   [--quantity]
                                                   [--reservation-id]
                                                   [--scope]

예제

환불 계산

az reservations reservation-order calculate-refund --reservation-order-id 0000000-aaaa-bbbb-cccc-20000000001 --id /providers/microsoft.capacity/reservationOrders/0000000-aaaa-bbbb-cccc-20000000001 --scope Reservation --quantity 1 --reservation-id /providers/microsoft.capacity/reservationOrders/0000000-aaaa-bbbb-cccc-20000000001/reservations/50000000-aaaa-bbbb-cccc-200000000000

필수 매개 변수

--reservation-order-id

예약의 주문 ID입니다.

선택적 매개 변수

--id

반환되는 예약 주문의 정규화된 식별자입니다.

--quantity

반환할 수량입니다. 0보다 커야 합니다.

--reservation-id

반환되는 예약의 정규화된 식별자입니다.

--scope

환불 범위(예: 예약)입니다.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az reservations reservation-order change-directory

미리 보기

명령 그룹 '예약'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

디렉터리(테넌트)와 그 아래의 ReservationOrder 모든 Reservation 디렉터리를 지정된 테넌트 ID로 변경합니다.

az reservations reservation-order change-directory --reservation-order-id
                                                   [--destination-tenant-id]

예제

예약 순서를 다른 테넌트로 변경

az reservations reservation-order change-directory --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000000 --destination-tenant-id 10000000-aaaa-bbbb-cccc-200000000011

필수 매개 변수

--reservation-order-id

예약의 주문 ID입니다.

선택적 매개 변수

--destination-tenant-id

예약 주문을 전송할 테넌트 ID GUID입니다.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az reservations reservation-order list

미리 보기

명령 그룹 '예약'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

사용자가 현재 테넌트에서 액세스할 수 있는 모든 ReservationOrder항목의 목록입니다.

az reservations reservation-order list [--max-items]
                                       [--next-token]

예제

사용자가 현재 테넌트에서 액세스할 수 있는 모든 예약 주문 목록입니다.

az reservations reservation-order list

선택적 매개 변수

--max-items

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

--next-token

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

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az reservations reservation-order purchase

미리 보기

명령 그룹 '예약'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

지정된 URI에서 리소스를 만들고 ReservationOrder 만듭니다.

az reservations reservation-order purchase --reservation-order-id
                                           [--applied-scope]
                                           [--applied-scope-property]
                                           [--applied-scope-type {ManagementGroup, Shared, Single}]
                                           [--billing-plan {Monthly, Upfront}]
                                           [--billing-scope]
                                           [--display-name]
                                           [--instance-flexibility {Off, On}]
                                           [--location]
                                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--quantity]
                                           [--renew {0, 1, f, false, n, no, t, true, y, yes}]
                                           [--reserved-resource-type {AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines}]
                                           [--review-date-time]
                                           [--sku]
                                           [--term {P1Y, P3Y, P5Y}]

예제

단일 범위 예약 구매

az reservations reservation-order purchase --reservation-order-id 40000000-aaaa-bbbb-cccc-200000000005 --applied-scope-type Single --billing-scope 50000000-aaaa-bbbb-cccc-200000000005 --reserved-resource-type VirtualMachines --display-name name1 --quantity 1 --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus --applied-scope 50000000-aaaa-bbbb-cccc-200000000010

리소스 그룹 예약을 사용하여 단일 범위 구매

az reservations reservation-order purchase --reservation-order-id 40000000-aaaa-bbbb-cccc-200000000005 --applied-scope-type Single --billing-scope 50000000-aaaa-bbbb-cccc-200000000005 --reserved-resource-type VirtualMachines --display-name testername1 --quantity 1 --sku Standard_B1s --term P1Y --billing-plan Monthly --location eastus --applied-scope '/subscriptions/50000000-aaaa-bbbb-cccc-200000000005/resourceGroups/rg1' --instance-flexibility Off

필수 매개 변수

--reservation-order-id

예약의 주문 ID입니다.

선택적 매개 변수

--applied-scope

혜택이 적용될 구독입니다. --applied-scope-type이 Single인 경우 필요합니다. --applied-scope-type이 Shared인지 지정하지 마세요. 약식 구문, json-file 및 yaml-file을 지원합니다. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--applied-scope-property

적용된 범위 유형과 관련된 속성입니다. 해당되지 않는 경우 필요하지 않습니다. Required and need and provide tenantId and managementGroupId if AppliedScopeType is ManagementGroup Support shorthand-syntax, json-file and yaml-file. 더 많은 것을 표시하려면 "??"를 시도해 보세요.

--applied-scope-type

적용된 범위의 형식입니다.

허용되는 값: ManagementGroup, Shared, Single
--billing-plan

청구 계획을 나타냅니다.

허용되는 값: Monthly, Upfront
--billing-scope

예약 구매에 대한 요금이 청구되는 구독입니다.

--display-name

예약의 이름입니다.

--instance-flexibility

이 기능을 켜면 동일한 VM 크기 그룹의 다른 VM에 예약 할인이 적용됩니다. VirtualMachines 예약 리소스 종류에 대해서만 지정합니다.

허용되는 값: Off, On
--location

예약된 리소스가 있는 Azure 지역입니다.

--no-wait

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

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--quantity

예약의 일부인 SKU의 수량입니다.

--renew

이를 true로 설정하면 만료 날짜 시간에 새 예약이 자동으로 구매됩니다.

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
기본값: False
--reserved-resource-type

예약 중인 리소스의 형식입니다.

허용되는 값: AVS, AppService, AzureDataExplorer, AzureFiles, BlockBlob, CosmosDb, DataFactory, Databricks, DedicatedHost, ManagedDisk, MariaDb, MySql, NetAppStorage, PostgreSql, RedHat, RedHatOsa, RedisCache, SapHana, SqlAzureHybridBenefit, SqlDataWarehouse, SqlDatabases, SqlEdge, SuseLinux, VMwareCloudSimple, VirtualMachineSoftware, VirtualMachines
--review-date-time

Azure 하이브리드 혜택을 검토해야 하는 날짜-시간입니다.

--sku

구매를 위한 SKU 이름입니다.

--term

예약 기간을 나타냅니다.

허용되는 값: P1Y, P3Y, P5Y
전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az reservations reservation-order return

미리 보기

명령 그룹 '예약'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

예약을 반환합니다.

az reservations reservation-order return --reservation-order-id
                                         [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                         [--quantity]
                                         [--reservation-id]
                                         [--return-reason]
                                         [--scope]
                                         [--session-id]

예제

예약 반환

az reservations reservation-order return --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000000 --return-reason mockReason --scope Reservation --quantity 1 --reservation-id /providers/microsoft.capacity/reservationOrders/50000000-aaaa-bbbb-cccc-200000000000/reservations/30000000-aaaa-bbbb-cccc-200000000011 --session-id 40000000-aaaa-bbbb-cccc-200000000020

필수 매개 변수

--reservation-order-id

예약의 주문 ID입니다.

선택적 매개 변수

--no-wait

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

허용되는 값: 0, 1, f, false, n, no, t, true, y, yes
--quantity

반환할 수량입니다. 0보다 커야 합니다.

--reservation-id

반환되는 예약의 정규화된 식별자입니다.

--return-reason

예약을 반환하는 이유입니다.

--scope

환불 범위(예: 예약)입니다.

--session-id

CalculateRefund API에서 반환된 SessionId입니다.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az reservations reservation-order show

미리 보기

명령 그룹 '예약'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

의 세부 정보를 ReservationOrder가져옵니다.

az reservations reservation-order show --reservation-order-id
                                       [--expand]

예제

예약 주문의 세부 정보 가져오기

az reservations reservation-order show --reservation-order-id 50000000-aaaa-bbbb-cccc-200000000005

필수 매개 변수

--reservation-order-id

예약의 주문 ID입니다.

선택적 매개 변수

--expand

planInformation을 확장하는 데 사용할 수 있습니다.

전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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

az reservations reservation-order wait

미리 보기

명령 그룹 '예약'은 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

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

az reservations reservation-order wait --reservation-order-id
                                       [--created]
                                       [--custom]
                                       [--deleted]
                                       [--exists]
                                       [--expand]
                                       [--interval]
                                       [--timeout]
                                       [--updated]

필수 매개 변수

--reservation-order-id

예약의 주문 ID입니다.

선택적 매개 변수

--created

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

기본값: False
--custom

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

--deleted

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

기본값: False
--exists

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

기본값: False
--expand

planInformation을 확장하는 데 사용할 수 있습니다.

--interval

폴링 간격(초)입니다.

기본값: 30
--timeout

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

기본값: 3600
--updated

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

기본값: False
전역 매개 변수
--debug

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

--help -h

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

--only-show-errors

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

--output -o

출력 형식입니다.

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

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

--subscription

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

--verbose

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