Alibaba Cloud API Upgrade Notification

Dear，AlibabaCloud Users：

To better adapt to the current development of ECS products and services, we plan to upgrade OpenAPI by January 20, 2017.

The affected APIs include those on the Alibaba Cloud official Chinese site, international site, and Japanese site.

The changes to API calling will primarily involve the data disk attaching point (/dev/xvdb-/dev/xvdz) allocation mode. This will change from allowing users to specify attaching points to allocating attaching points according to default order. This change affects the following APIs: CreateInstance, AttachDisk, and CreateImage. It is recommended that, when creating ECS instances, full images, and attaching disks, you follow the order xvdb-xvdz for all the disk attaching points involved. The specific changes are as follows: 1.

1. CreateInstance

1）Change: Involves the input parameter DataDisk.n.Device.

2）Details: We will gradually end support for the DataDisk.n.Device input parameter. The system will transition from allowing users to specify attaching points to allocating attaching points according to default order, from /dev/xvdb to /dev/xvdz.

3）Compatibility measures: To maintain compatibility with the API usage habits of existing users, when calls to the CreateInstance interface include the DataDisk.n.Device parameter, the system will simply ignore the parameter, and the data disk attaching points will be arranged according to the default order, from /dev/xvdb to /dev/xvdz. For instances created from user-defined images, the original data disk attaching points of the user-defined image will remain unchanged.

2. AttachDisk

1）Change: Involves the input parameter Device.

2） Details: We will gradually end support for the Device input parameter. The system will transition from allowing users to specify attaching points to allocating attaching points according to default order. Attaching points are allocated as follows: If the current VM data disk attaching point is empty, the blank will be filled. If none of the customer's existing attaching points is empty, the attaching points will be arranged in sequence.

3） Compatibility measures: To maintain compatibility with the API usage habits of existing users, when calls to the AttachDisk interface include the Device parameter, the system will simply ignore the parameter, and the data disk attaching points will be allocated according to the default principles.

3. CreateImage

1） Change: Involves the input parameter DiskDeviceMapping.N.Device.

2） Details: We will gradually end support for the DiskDeviceMapping.N.Device parameter. When combining multiple snapshots into a single image template, the Device parameter for data disk snapshots will change from allowing users to specify attaching points to allocating attaching points according to default order. Attaching points will only be arranged according to the specified order and cannot be duplicate. The data disk snapshot values will range from /dev/xvdb to /dev/xvdz.

3）Compatibility measures: To maintain compatibility with the API usage habits of existing users, when calls to the CreateImage interface include the DiskDeviceMapping.N.Device parameter, the system will simply ignore the parameter, and the data disk snapshot attaching points will be arranged according to the specified order, from /dev/xvdb to /dev/xvdz.

We apologize for any inconvenience this API upgrade may cause, and ask for your understanding. Thank you for your long-term support for and trust in Alibaba Cloud. We will continue to make our APIs more stable and user-friendly.