[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2024-12-21(UTC)"],[],[],null,["# Purchase a spend-based commitment\n\nThis document describes how to purchase a spend-based commitment by using the Cloud Commerce Consumer Procurement API for Cloud Marketplace purchases.\n\n\u003cbr /\u003e\n\nCurrently, this API only supports purchasing spend-based commitments, not resource-based commitments.\n\nBefore you begin\n----------------\n\n- Enable the\n [Cloud Commerce Consumer Procurement API](https://console.cloud.google.com/apis/api/cloudcommerceconsumerprocurement.googleapis.com)\n for your Google Cloud project.\n\n- Ensure that you have one of the following\n [Identity and Access Management (IAM)](/iam/docs) roles for the Cloud Billing\n account you want to use to purchase the commitment:\n\n - [Billing Administrator](/billing/docs/how-to/billing-access#overview-of-cloud-billing-roles-in-cloud-iam)\n (`roles/billing.admin`) for the target Cloud Billing account *OR* the\n Google Cloud organization where your billing account is located.\n\n - [Consumer Procurement Order Administrator](/marketplace/docs/access-control#roles-permissions)\n (`roles/consumerprocurement.orderAdmin`) for the target Cloud Billing\n account *OR* the Google Cloud organization where your billing\n account is located.\n\nIdentify the Offer you want to purchase\n---------------------------------------\n\nTo purchase a spend-based commitment, use an Offer name which indicates the\nproduct you're purchasing and the discount term.\n| **Important:** This page explains the new and improved committed use discounts (CUDs) program, which applies to any customers who purchase their first *spend-based* CUDs on or after **July 15, 2025** . Customers can opt in now to get the new CUD experience. For more information, see [Spend-based CUDs\n| program improvements](/docs/cuds-multiprice).\n\nThe [new CUD model](/docs/cuds-multiprice) introduces new Offer names for existing CUD products. The table below provides the Offer names both before and after you opt in to the new spend-based CUD model. You must use the Offer name that matches your Cloud Billing account's model.\n\nThe following updated Offers are available for purchase:\n\nThe following Offers are unaffected by the new CUD model and available for purchase:\n\nIdentify the Offer parameters\n-----------------------------\n\nCommitments have two parameters:\n\n- **Commitment amount** (`hourly_commit`): The credit applied to your\n Cloud Billing account each hour after you purchase this commitment.\n\n | In the legacy CUDs program, your commitment amount is the on-demand price instead. For more information about the differences between the legacy and new spend-based CUDs program, see [Spend-based CUDs program improvements](/docs/cuds-multiprice).\n\n \u003cbr /\u003e\n\n- **Region** (`region`): The region for which this commitment's benefits apply.\n\nWhen you purchase a commitment, you must specify both parameters.\n\nPurchase the Offer\n------------------\n\nTo purchase an Offer, call\n[`billingAccounts.orders.place`](/marketplace/docs/reference/consumerprocurement/rest/v1alpha1/billingAccounts.orders/place),\nand supply the following parameters:\n\n- The `hourly_commit` indicating the dollar value of the commitment.\n\n- The `region` to purchase the commitment for.\n\nTo place an order, run the following command: \n\n curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/billingAccounts/\u003cvar translate=\"no\"\u003eBILLING_ACCOUNT_ID\u003c/var\u003e/orders:place' \\\n --header 'Content-Type: application/json' \\\n --header 'Authorization: Bearer \u003cvar translate=\"no\"\u003eACCESS_TOKEN\u003c/var\u003e' \\\n --header 'X-Goog-User-Project: \u003cvar translate=\"no\"\u003eCONSUMER_PROJECT_ID\u003c/var\u003e' \\\n -d '@-' \u003c\u003cEOF\n {\n \"displayName\": \"\u003cvar translate=\"no\"\u003eDISPLAY_NAME\u003c/var\u003e\",\n \"lineItemInfo\": [{\n \"parameters\": [{\n \"name\": \"hourly_commit\",\n \"value\": {\n \"doubleValue\": \u003cvar translate=\"no\"\u003eHOURLY_COMMIT\u003c/var\u003e\n }\n }, {\n \"name\": \"region\",\n \"value\": {\n \"stringValue\": \"\u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e\"\n }\n }],\n \"offer\": \"\u003cvar translate=\"no\"\u003eOFFER_NAME\u003c/var\u003e\"\n }]\n }\n EOF\n\nThis returns the name of a long-running operation: \n\n {\n \"name\": \"\u003cvar translate=\"no\"\u003eOPERATION_NAME\u003c/var\u003e\"\n }\n\nTo verify that the returned long-running operation completed successfully, run\nthe following command: \n\n curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/\u003cvar translate=\"no\"\u003eOPERATION_NAME\u003c/var\u003e' \\\n --header 'Content-Type: application/json' \\\n --header 'Authorization: Bearer \u003cvar translate=\"no\"\u003eACCESS_TOKEN\u003c/var\u003e' \\\n --header 'X-Goog-User-Project: \u003cvar translate=\"no\"\u003eCONSUMER_PROJECT_ID\u003c/var\u003e'\n\nThe long-running operation should complete in less than one second.\n\nView your Order\n---------------\n\nYou can view the current state of a commitment directly in Google Cloud console, or\nby calling\n[`billingAccounts.orders.get`](/marketplace/docs/reference/consumerprocurement/rest/v1alpha1/billingAccounts.orders/get).\nThe `name` field of the created Order specifies the Order name. \n\n### cURL\n\n\nTo view an order, run the following command: \n\n curl 'https://cloudcommerceconsumerprocurement.googleapis.com/v1alpha1/\u003cvar translate=\"no\"\u003eORDER_NAME\u003c/var\u003e' \\\n --header 'Content-Type: application/json' \\\n --header 'Authorization: Bearer \u003cvar translate=\"no\"\u003eACCESS_TOKEN\u003c/var\u003e' \\\n --header 'X-Goog-User-Project: \u003cvar translate=\"no\"\u003eCONSUMER_PROJECT_ID\u003c/var\u003e'\n\n### Console\n\n1. Navigate to \u003chttps://console.cloud.google.com/billing\u003e.\n2. Select your Cloud Billing account.\n3. Select **Commitments** from the sidebar.\n4. Your purchased commitment is visible in the displayed table."]]
