使用限制

需滿足以下任意一個。

• 計算巢服務配置了自定義售賣。

• 計算巢服務上架在云市場。

校驗原理

對于計算巢創建的資源，計算巢會將服務實例ID（ServiceInstanceId）、服務ID（ServiceId）等標簽打在資源上，CheckOutLicense通過資源所屬標簽判斷所屬服務實例。

1. 服務商需從控制臺獲取對應計算巢服務實例的ServiceId。

2. 調用CheckOutLicense時將ServiceId作為參數發送給計算巢，由計算巢判斷傳入的內容與資源中的是否一致。

接口調用示例

本示例是在符合使用限制的前提下，創建的ECS實例并調用CheckOutLicense。

1. 獲取ECS地域信息

   在調用CheckOutLicense前，您需要獲取應用部署的ECS地域（regionld）信息。獲取到的地域信息會在后續步驟中使用，因此需要服務商記錄。

   1. 訪問如下網址，獲得地域信息。

      curl http://100.100.100.200/latest/meta-data/region-id

   2. 地域返回示例。

      cn-hangzhou

2. 在控制臺獲取ServiceId。

   

3. 請求示例

   此處以在杭州地域發起調用為例，實際調用時應替換地域信息。

   # 將ServiceId對應的值按實際情況替換。
   curl -H "Content-Type: application/json" -XPOST https://cn-hangzhou.axt.aliyun.com/computeNest/license/check_out_license -d '{"ServiceId":"service-8fff945fe6844906****"}'

4. 返回示例

   {
       "code":200,
       "requestId":"6af1efb7-c59c-4cee-9094-e1e3bbefb639",
       "instanceId":"i-0jl957dfri612gxxxxxx",
       "result":{
           "RequestId":"B22723B7-FC31-18F5-A33E-1AF4C82736AA",
           "ServiceInstanceId":"si-0f14037f30c14292****",
           "LicenseMetadata":"{\"TemplateName\":\"Custom_Image_Ecs\",\"SpecificationName\":\"\",\"CustomData\":\"xxxx\"}",
           "TrialType":"NotTrial",
           "Token":"58d4574bd0d967bb431cd8936b5e80c4",
           "ExpireTime":"2024-08-28T06:27:08Z",
           "ServiceId":"service-8fff945fe6844906****",
           "Components":"{\"package_version\":\"yuncode55xxxxxxxx\",\"SystemDiskSize\":\"40\",\"DataDiskSize\":\"100\"}"
       }
    }

   主要參數解釋如下。

   參數	描述	示例值
   ServiceInstanceId	服務實例ID。	si-0f14037f30c14292****
   ServiceId	服務ID。	service-8fff945fe6844906****
   ExpireTime	服務實例的到期時間。	2024-08-28T06:27:08Z
   LicenseMetadata	元數據。 需要在自定義售賣配置中定義該數據。	{\"TemplateName\":\"Custom_Image_Ecs\",\"SpecificationName\":\"\",\"CustomData\":\"xxxx\"}
   Components	云市場額外計費項信息。	{\"package_version\":\"yuncode55xxxxxxxx\",\"SystemDiskSize\":\"40\",\"DataDiskSize\":\"100\"}