Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

API를 사용하여 지출 기반 약정 구매

이 문서에서는 Cloud Marketplace 구매를 위해 Cloud Commerce Consumer Procurement API를 사용하여 지출 기반 약정을 구매하는 방법을 설명합니다.

이 API는 리소스 기반 약정이 아닌 지출 기반 약정 구매만 지원합니다.

시작하기 전에

프로젝트에 대해 Cloud Commerce Consumer Procurement API 를 사용 설정합니다. Google Cloud
약정 구매를 위해 사용하려는 Cloud Billing 계정에 대해 다음 Identity and Access Management (IAM) 역할 중 하나가 있는지 확인합니다.
- 결제 관리자 (roles/billing.admin) 대상 Cloud Billing 계정에 대한 또는 결제 계정이 배치된 Google Cloud 조직입니다.
- 소비자 조달 주문 관리자 (roles/consumerprocurement.orderAdmin) 대상 Cloud Billing 계정 또는 결제 계정이 배치된 Google Cloud 조직에 대한 계정입니다.

구매하려는 오퍼 식별

지출 기반 약정을 구매하려면 구매하려는 제품 및 할인 조건을 나타내는 오퍼 이름을 사용합니다.

새로운 CUD 모델은 기존 CUD 제품에 새로운 오퍼 이름을 도입합니다. 다음 표에서는 새로운 지출 기반 CUD 모델로 이전하기 전후의 오퍼 이름을 제공합니다. Cloud Billing 계정의 모델과 일치하는 오퍼 이름을 사용해야 합니다.

다음과 같이 업데이트된 오퍼를 구매할 수 있습니다.

다음 오퍼는 새로운 CUD 모델의 영향을 받지 않으며 구매할 수 있습니다.

제품	용어	오퍼 이름
Backup for GKE	1년	`services/gkebackup.googleapis.com/standardOffers/89852607-f073-4696-94cc-de7ed85f27c7`
Backup for GKE	3년	`services/gkebackup.googleapis.com/standardOffers/25d2877b-2868-4312-b54e-880896a119c5`
백업 및 DR (VMware)	1년	`services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a`
백업 및 DR (VMware)	3년	`services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48`
NetApp Volumes	1년	`services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca`
NetApp Volumes	3년	`services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c`

오퍼 매개변수 식별

약정에는 2개의 매개변수가 있습니다.

약정 금액 (hourly_commit): 이 약정을 구매한 후 매 시간 Cloud Billing 계정에 적용되는 크레딧입니다.
자동 계정 이전 전 기존 CUD 프로그램에서는 약정 금액이 주문형 가격이었습니다. 자세한 내용은 지출 기반 CUD를 참고하세요.
리전 (region): 이 약정의 혜택이 적용되는 리전입니다.

약정을 구매할 때는 매개변수를 둘 다 지정해야 합니다.

오퍼 구매

오퍼를 구매하려면 billingAccounts.orders.place를 호출하고 다음 매개변수를 제공합니다.

약정의 화폐 가치를 나타내는 hourly_commit
약정을 구매할 region

주문하려면 다음 명령어를 실행합니다.

curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/billingAccounts/BILLING_ACCOUNT_ID/orders:place' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID' \
    -d '@-' <<EOF
    {
    "displayName": "DISPLAY_NAME",
    "lineItemInfo": [{
        "parameters": [{
        "name": "hourly_commit",
        "value": {
            "doubleValue": HOURLY_COMMIT
        }
        }, {
        "name": "region",
        "value": {
            "stringValue": "REGION"
        }
        }],
        "offer": "OFFER_NAME"
    }]
    }
EOF

그러면 장기 실행 작업 이름이 반환됩니다.

{
    "name": "OPERATION_NAME"
}

반환된 장기 실행 작업이 성공적으로 완료되었는지 확인하기 위해 다음 명령어를 실행합니다.

curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/OPERATION_NAME' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID'

장기 실행 작업은 1초 이내에 완료되어야 합니다.

주문 보기

콘솔에서 직접 또는 billingAccounts.orders.get을 호출하여 약정의 현재 상태를 볼 수 있습니다. Google Cloud 생성된 주문의 name 필드는 주문 이름을 지정합니다.

cURL

주문을 보려면 다음 명령어를 실행합니다.

curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/ORDER_NAME' \
    --header 'Content-Type: application/json' \
    --header 'Authorization: Bearer ACCESS_TOKEN' \
    --header 'X-Goog-User-Project: CONSUMER_PROJECT_ID'

콘솔

콘솔에서 Cloud Billing 계정으로 이동합니다. Google Cloud

Cloud Billing 계정으로 이동
사이드바에서 약정 사용 할인 (CUD) 을 선택합니다.
구매한 약정이 표시됩니다.