阿里雲ECS API升級注意事項

尊敬的阿里雲使用者：

為了更好地調整目前 ECS 產品和商務的發展，我們排程在2017年1月20日前進行OpenAPI升級。 此次API變化可及範圍涉及阿里雲官網國內站、國際站和日本站。

本次變化的 API 呼叫，主要涉及資料盤掛載點（/dev/xvdb-/dev/xvdz）的散發設定檔，從“允許使用者自行指定”修改為“系統預設順序散發”，涉及CreateInstance、AttachDisk和CreateImage三個API的行為修改。建議項目您在建立ECS執行個體、建立全鏡像和掛載磁碟時，涉及到資料盤掛載點，均按照從xvdb-xvdz依次順序排列。

具體改動如下：

1. CreateInstance 建立執行個體

1） 改動點：涉及入參DataDisk.n.Device；

2） 具體內容：將逐步暫止對DataDisk.n.Device入參的支援，資料盤掛載點由“允許自行指定”修改為“系統預設順序散發”，從/dev/xvdb 開始到 /dev/xvdz；

3） 相容性措施：為了相容存量使用者的API使用習慣，對叫用CreateInstance時帶有DataDisk.n.Device入參的情況，系統採取拒接來電設定檔，資料盤掛載點佈建按照預設順序排列，從/dev/xvdb開始到/dev/xvdz。對於基於自訂鏡像建立執行個體的場景，原自訂鏡像的資料盤掛載點不做改動。

2. AttachDisk掛載磁碟

1） 改動點：涉及入參Device；

2） 具體內容：將逐步暫止對Device入參的支援，資料盤掛載點從“允許自行指定”修改為“系統預設散發”，散發準則為：如果本期VM資料盤掛載點中線上缺，採用填空缺的設定檔，如果客戶現有掛載點中沒線上缺，採用順序排列的設定檔；

3） 相容性措施：為了相容存量使用者的API使用習慣，對叫用AttachDisk時帶有Device入參的情況，系統採取拒接來電設定檔，資料盤掛載點佈建按照系統預設準則散發。

3. CreateImage 建立鏡像

1） 改動點：涉及入參DiskDeviceMapping.N.Device；

2） 具體內容：將逐步暫止對DiskDeviceMapping.N.Device入參的支援，在對多個快照集進行群組成一個鏡像範本的時候，資料盤快照集的Device引數從“允許自行指定”修改為“系統預設散發”，只能由系統指定順序排列，且不能重複，資料盤快照集取值從/dev/xvdb 開始到 /dev/xvdz

3） 相容性措施：為了相容存量使用者的API使用習慣，對叫用CreateImage時帶有DiskDeviceMapping.N.Device入參的情況，系統採取拒接來電設定檔，資料盤快照集掛載點佈建由系統指定順序排列，從/dev/xvdb 開始到 /dev/xvdz。

對於本次 API 升級給您帶來的不便，我們深表歉意，也希望您能夠諒解。謝謝您一直以來對阿里雲的支援和信任，我們會一步步把 API 做的更加好用，更加穩定。 感謝您對阿里雲的支援！