如何校正服務執行個體的有效期間 - Compute Nest

本文為您介紹如何通過介面CheckOutLicense校正服務執行個體有效期間。

使用限制

需滿足以下任意一個。

計算巢服務配置了自訂售賣。
計算巢服務上架在雲市場。

校正原理

對於計算巢建立的資源，計算巢會將服務執行個體ID（ServiceInstanceId）、服務ID（ServiceId）等標籤打在資源上，CheckOutLicense通過資源所屬標籤判斷所屬服務執行個體。

服務商需從控制台擷取對應計算巢服務執行個體的ServiceId。
調用CheckOutLicense時將ServiceId作為參數發送給計算巢，由計算巢判斷傳入的內容與資源中的是否一致。

介面調用樣本

本樣本是在符合使用限制的前提下，建立的ECS執行個體並調用CheckOutLicense。

擷取ECS地區資訊
在調用CheckOutLicense前，您需要擷取應用部署的ECS地區（regionld）資訊。擷取到的地區資訊會在後續步驟中使用，因此需要服務商記錄。
1. 訪問如下網址，獲得地區資訊。
```
curl http://100.100.100.200/latest/meta-data/region-id
```
2. 地區返回樣本。
```
cn-hangzhou
```
在控制台擷取ServiceId。

請求樣本

此處以在杭州地區發起調用為例，實際調用時應替換地區資訊。

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

返回樣本

{
    "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\"}