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

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

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

시작하기 전에

구매하려는 오퍼 식별

지출 기반 약정을 구매하려면 구매하려는 제품 및 할인 조건을 나타내는 오퍼 이름을 사용합니다. Cloud Billing 계정의 모델과 일치하는 오퍼 이름을 사용해야 합니다.

구매할 수 있는 오퍼는 다음과 같으며 새로운 가격 모델 (직접 할인, 크레딧 없음)을 따릅니다.

제품 용어 범위 오퍼 이름 필수 매개변수
PostgreSQL용 AlloyDB 1년 전역 services/alloydb.googleapis.com/standardOffers/ff04ec3e-278c-4ec8-8278-12f875a8cea2 commitment_amount (권장)
또는 hourly_commit
PostgreSQL용 AlloyDB 3년 전역 services/alloydb.googleapis.com/standardOffers/9522b4d8-bff7-4141-81d6-b71d9113c69a commitment_amount (권장)
또는 hourly_commit
백업 및 DR (Oracle) 1년 전역 services/backupdr.googleapis.com/standardOffers/16e6132e-8a72-4a7f-8941-bf52246afc82 commitment_amount (권장)
또는 hourly_commit
백업 및 DR (Oracle) 3년 전역 services/backupdr.googleapis.com/standardOffers/1e028b05-4344-4bca-87e7-235ee3536354 commitment_amount (권장)
또는 hourly_commit
BigQuery 1년 리전 services/bigqueryreservation.googleapis.com/standardOffers/d73ae4d8-d096-4c9b-9c20-cd92c3c53724 commitment_amount (권장)
또는 hourly_commit,

region
BigQuery 3년 리전 services/bigqueryreservation.googleapis.com/standardOffers/f43d480d-3e77-4079-946c-e1b2ab640a8a commitment_amount (권장)
또는 hourly_commit,

region
Bigtable 1년 전역 services/bigtable.googleapis.com/standardOffers/c0bf8ba5-65ee-4f7d-9e1e-3953433cf193 commitment_amount (권장)
또는 hourly_commit
Bigtable 3년 전역 services/bigtable.googleapis.com/standardOffers/460fb2ef-456d-4263-a070-4f993fa37996 commitment_amount (권장)
또는 hourly_commit
Cloud Run 3년 리전 services/run.googleapis.com/standardOffers/88a5fc51-d63b-4865-bf3b-c49e05a8c5c0 commitment_amount (권장)
또는 hourly_commit,

region
Cloud Run 년 리전 services/run.googleapis.com/standardOffers/392802d4-e57b-40d3-9684-a1e8cdca6fb5 commitment_amount (권장)
또는 hourly_commit,

region
Cloud SQL 1년 리전 services/cloudsql.googleapis.com/standardOffers/d31cf078-36a2-4a8a-a2e6-b23caec0e7a3 commitment_amount (권장)
또는 hourly_commit,

region
Cloud SQL 3년 리전 services/cloudsql.googleapis.com/standardOffers/48960309-1646-4fa2-9bf8-d7e72090d2b8 commitment_amount (권장)
또는 hourly_commit,

region
Compute Engine 유연한 약정 1년 전역 services/compute.googleapis.com/standardOffers/1b2601a4-9d76-462d-bd5b-5b835d245f93 commitment_amount (권장)
또는 hourly_commit
Compute Engine 유연한 약정 3년 전역 services/compute.googleapis.com/standardOffers/61612674-a9a9-4687-8449-baca71fbd0d1 commitment_amount (권장)
또는 hourly_commit
Dataflow 1년 전역 services/dataflow.googleapis.com/standardOffers/127d79e4-1d52-48b0-9f31-8ba02586ff95 commitment_amount (권장)
또는 hourly_commit
Dataflow 3년 전역 services/dataflow.googleapis.com/standardOffers/03f4d3b1-44b8-4e88-9e75-b1d4e2d04573 commitment_amount (권장)
또는 hourly_commit
Firestore 1년 전역 services/firestore.googleapis.com/standardOffers/de6aa077-3170-4250-89b6-0ccd470f9e21 commitment_amount (권장)
또는 hourly_commit
Firestore 3년 전역 services/firestore.googleapis.com/standardOffers/e8f59240-c088-4a22-87c3-e58722cca300 commitment_amount (권장)
또는 hourly_commit
Gemini Enterprise 유연한 절감 계획 1년 전역 services/aiplatform.googleapis.com/standardOffers/740fd2e8-ff1d-4304-9e85-61c0f8d75811 commitment_amount
Gemini Enterprise 유연한 절감 계획 3년 전역 services/aiplatform.googleapis.com/standardOffers/4733352d-24b5-4609-b3ff-d2a694f51654 commitment_amount
Google Kubernetes Engine 1년 리전 services/container.googleapis.com/standardOffers/2f48e468-a86a-452d-88df-edacd94a3c44 commitment_amount (권장)
또는 hourly_commit,

region
Google Kubernetes Engine 3년 리전 services/container.googleapis.com/standardOffers/89027902-6f83-40aa-8861-7c2446b11015 commitment_amount (권장)
또는 hourly_commit,

region
Managed Service for Apache Kafka 1년 전역 services/managedkafka.googleapis.com/standardOffers/647db981-009c-4e95-b62e-6aff19384956 commitment_amount (권장)
또는 hourly_commit
Managed Service for Apache Kafka 3년 전역 services/managedkafka.googleapis.com/standardOffers/9a7ed994-d3df-4680-b4e6-7c3d932add66 commitment_amount (권장)
또는 hourly_commit
Memorystore for Redis 1년 전역 services/redis.googleapis.com/standardOffers/8e0da7cb-196b-4351-bc32-6a6ba94f1456 commitment_amount (권장)
또는 hourly_commit
Memorystore 3년 전역 services/redis.googleapis.com/standardOffers/2a3729ac-1e38-4a34-bc96-bd988028351f commitment_amount (권장)
또는 hourly_commit
Spanner 1년 전역 services/spanner.googleapis.com/standardOffers/359db5c2-8c2c-49e3-a21d-26176c4cd403 commitment_amount (권장)
또는 hourly_commit
Spanner 3년 전역 services/spanner.googleapis.com/standardOffers/a6a32e10-1d76-4df8-8485-eee10d08a1cf commitment_amount (권장)
또는 hourly_commit

구매할 수 있는 오퍼는 다음과 같으며 기존 크레딧 모델 (정가 청구 + 크레딧 상쇄)을 따릅니다.

제품 용어 범위 오퍼 이름 필수 매개변수
백업 및 DR (VMware) 1년 리전 services/backupdr.googleapis.com/standardOffers/30c7e770-724f-4a7d-8369-b726a397b53a hourly_commit,

region
백업 및 DR (VMware) 3년 리전 services/backupdr.googleapis.com/standardOffers/6748e93c-4114-4fa2-bf3e-cb4d3534bb48 hourly_commit,

region
NetApp Volumes 1년 전역 services/netapp.googleapis.com/standardOffers/90520cfa-14b6-42ae-92b9-129671bf2aca hourly_commit
NetApp Volumes 3년 전역 services/netapp.googleapis.com/standardOffers/c852fef8-e699-4524-90f4-e7b89edeb33c hourly_commit

오퍼 매개변수 식별

오퍼를 구매하려면 다음 매개변수를 설정해야 합니다.

  • Commitment_amount (권장) 또는 Hourly_commit:

    • 새 지출 기반 CUD 모델의 약정: commitment_amount (권장) 또는 hourly_commit입니다. hourly_commit 매개변수는 결국 지원 중단되고 향후 새 모델의 약정에 대해 일반적인 commitment_amount 매개변수로 대체됩니다. 일부 CUD는 다른 반복 (시간별, 월별 등)을 지원하며 commitment_amount 매개변수만 지원합니다. 특정 요구사항은 오퍼 표의 '필수 매개변수' 열을 확인하세요.

    • 새 CUD 모델의 영향을 받지 않는 오퍼: hourly_commit을 지정합니다. 이는 매시간 Cloud Billing 계정에 적용되는 크레딧을 나타냅니다. 기존 CUD는 commitment_amount를 지원하지 않습니다.

  • 리전 (region): 이 약정의 혜택이 적용되는 리전입니다.

    • 리전 약정: 대상 리전 (예: us-central1)을 지정합니다. 각 제품의 폴더와 지원되는 리전을 찾으려면 해당 제품의 문서 또는 약정 사용 할인 개요를 참고하세요.
    • 전역 약정: 전역 약정은 모든 리전에 적용되므로 이 매개변수를 생략합니다.

오퍼 구매

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

  • CUD 유형과 일치하는 약정 값 매개변수입니다.

    • 새 지출 기반 CUD 모델의 약정: commitment_amount (권장) 또는 hourly_commit (지원 중단됨, 향후 삭제 예정)을 제공합니다. 새 CUD 오퍼 (예: AI Platform)의 경우 commitment_amount를 지정해야 합니다.
    • 기존 CUD: hourly_commit을 제공합니다.

  • region (리전 약정만 해당) 전역 약정을 구매하는 경우 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": "commitment_amount",
        "value": {
            "doubleValue": COMMITMENT_AMOUNT
        }
        }, {
        "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초 이내에 완료되어야 합니다.

주문 보기

콘솔 Google Cloud 에서 직접 또는 billingAccounts.orders.get을 호출하여 약정의 현재 상태를 볼 수 있습니다. 생성된 주문의 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'

콘솔

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

    Cloud Billing 계정으로 이동

  2. 사이드바에서 약정 사용 할인 (CUD) 을 선택합니다.

  3. 구매한 약정이 표시됩니다.