使用OpenApi完成雲伺服器ECS續費管理

本文将涉及到幾個關鍵功能

按照過期時間查詢雲伺服器

續費執行個體

查詢雲伺服器自動續費時間

設定雲伺服器自動續費時間

對于包年包月的雲伺服器的生命周期是非常重要的，如果雲伺服器資源不能按時的續費将可能導緻伺服器被鎖定甚至釋放影響您的業務持續性。是以我們需要api友善的知道和檢查資源的到期時間。同時可以友善的完成續費充值。

本篇您需要關注幾個api

<a href="https://help.aliyun.com/document_detail/25506.html">查詢執行個體清單</a>

<a href="https://help.aliyun.com/document_detail/44393.html">續費執行個體</a>

通過查詢執行個體清單的api通過下面的過濾參數您可以查詢在一定時間範圍内到期的執行個體資訊。通過設定過濾參數的<code>expiredstarttime</code>和<code>expiredendtime</code>，時間參數為 按照 iso8601 标準表示，并需要使用 utc 時間。 格式為：yyyy-mm-ddthh:mmz。

就可以友善的查詢在這個時間内到期的執行個體清單。如果需要通過安全組來進行過濾隻需要加上安全組id即可。

續費執行個體隻支援包年包月的伺服器類型，不支援按量付費的伺服器，同時要求使用者必須支援賬号的餘額支付或信用支付。在執行api的時候将執行同步的扣費和訂單生成。是以在執行api的時候必須保證您的賬号有足夠的資金支援自動扣費。

續費執行個體将會自動完成扣費，在續費執行之後您可以根據<code>instanceid</code>進行查詢執行個體的資源到期時間。由于api為異步任務，查詢資源到期時間可能需要延遲10秒才會變化。

我們也提供了openapi來查詢和設定自動續費，該api也僅支援包年包月的執行個體，按量付費的執行個體執行将會報錯。

查詢執行個體的自動續費狀态支援一次最多查詢100個包年包月的執行個體，多個執行個體id以逗号連接配接。

describeinstanceautorenewattribut的入參為執行個體id

instanceid： 支援最多查詢100個包年包月的執行個體，多個執行個體id以逗号連接配接。

傳回的内容如下

如果設定自動續費則傳回的屬性<code>autorenewenabled</code>則為true，否則傳回false。

設定自動續費有三個入參：

duration：支援 1，2，3，6，12，機關為月

autorenew：true/false， true為開啟自動續費，false為取消自動續費

執行成功傳回response如下:

續費成功後您可以再執行一次查詢即可, 如果續費成功會傳回續費的時長和是否開啟自動續費。

請選擇相應的操作完成您的任務。