华为云用户手册

响应示例 { "keypairs": [ { "keypair": { "fingerprint": "15:b0:f8:b3:f9:48:63:**:**:**:**:**:**:**:**:**", "name": "keypair-601a2305-4f25-41ed-89c6-2a966fc8027a", "type": "ssh", "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQC+Eo/RZRngaGTkFs7I62ZjsIlO79Kkl****************************************************************************************************************************************************** Generated-by-Nova\n" } } ]}

响应示例 { "flavor": { "name": "c3.2xlarge.2", "links": [ { "href": "https://compute.region.example.com/v2.1/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.2", "rel": "self" }, { "href": "https://compute.region.example.com/743b4c0428d94531b9f2add666642e6b/flavors/c3.2xlarge.2", "rel": "bookmark" } ], "ram": 16384, "OS-FLV-DISABLED:disabled": false, "vcpus": 8, "swap": "", "os-flavor-access:is_public": true, "rxtx_factor": 1, "OS-FLV-EXT-DATA:ephemeral": 0, "disk": 0, "id": "c3.2xlarge.2" }}

响应消息 响应参数如表2所示。 表2 响应参数 参数 参数类型 描述 keypairs Array of objects 密钥信息列表，详情请参见表3。 表3 keypairs字段数据结构说明 参数 参数类型 描述 keypair Object 密钥信息详情，详情请参见表4。 表4 keypair字段数据结构说明 参数 参数类型 描述 fingerprint String 密钥对应指纹信息。 name String 密钥名称。 type String 密钥类型，默认“ssh” 微版本2.2及以上版本支持。 public_key String 密钥对应publicKey信息。

请求示例 POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers/47e9be4e-a7b9-471f-92d9-ffc83814e07a/action { "addFloatingIp" : { "address" : "10.144.2.1", "fixed_address" : "192.168.1.3" }}

接口约束 使用此接口时，请指定微版本不低于2.6。 "微版本号": 通过Http请求头X-OpenStack-Nova-API-Version来或者OpenStack-API-Version添加。 示例：X-OpenStack-Nova-API-Version：2.6 或者OpenStack-API-Version：compute 2.6 获取的登录地址有效时间10min，超过10min请重新获取。

响应消息 响应参数如表4所示。 表4 响应参数 参数 参数类型 描述 remote_console Object 弹性云服务器获取远程登录地址，参考表5。 表5 remote_console参数信息 参数 参数类型 描述 type String 远程登录的类型。 protocol String 远程登录的协议。 url String 远程登录的url。 该url有效时间10min，超过10min请重新获取。

请求示例 获取指定云服务器的VNC远程登录地址。 POST https://{endpoint}/v2.1/13c67a214ced4afb88d911ae4bd5721a/servers/47bc79ae-df61-4ade-9197-283a74e5d70e/remote-consoles{ "remote_console" : { "type" : "novnc", "protocol": "vnc" }}

URI PUT /v2.1/{project_id}/servers/{server_id}/tags/{tag} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方法请参见获取项目ID。 server_id 是 云服务器ID。 tag 是 待添加标签的key。 说明： 系统近期对标签功能进行了升级。如果之前添加的Tag为“Key.Value”的形式，则查询的时候需要使用“Key”来查询。 例如：之前添加的tag为“a.b”，查询时采用“tag=a.b”,则现在查询时需采用“tag=a”。

响应消息 响应参数如表9所示。 表9 响应参数 参数 参数类型 描述 server Object 云服务器信息，详情请参见表10。 表10 server字段数据结构说明 参数 参数类型 描述 id String 弹性云服务器ID，UUID格式。 links Array of objects 弹性云服务器URI自描述信息，详情参见表11。 security_groups Array of objects 弹性云服务器所在安全组，详情参见表12。 OS-DCF:diskConfig String diskConfig方式。 MANUAL，镜像空间不会扩展。 AUTO，系统盘镜像空间会自动扩展为与flavor大小一致。 reservation_id String reservation_id：通过返回的reservation_id，可以过滤查询到本次创建的弹性云服务器。 说明： 批量创建弹性云服务器时，支持使用该字段。 adminPass String Windows弹性云服务器Administrator用户的密码。 表11 links字段数据结构说明 参数 参数类型 描述 rel String 快捷链接标记名称。 href String 对应快捷链接。 表12 security_groups字段数据结构说明 参数 参数类型 描述 name String 安全组名称或者uuid。

请求示例 通过block_device_mapping_v2扩展属性使用镜像创建一台云服务器，采用密钥方式登录鉴权。 POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers{ "server": { "flavorRef": "s3.xlarge.2", "name": "wjvm48", "metadata": { "name": "name_xx1", "id": "id_xxxx1" }, "block_device_mapping_v2": [{ "source_type": "image", "destination_type": "volume", "uuid": "b023fe17-11db-4efb-b800-78882a0e394b", "delete_on_termination": "False", "boot_index": "0", "volume_type": "SAS", "volume_size": "40" }], "security_groups": [{ "name": "name_xx5_sg" }], "networks": [{ "uuid": "fd40e6f8-942d-4b4e-a7ae-465287b02a2c", "port": "e730a11c-1a19-49cc-8797-cee2ad67af6f", "fixed_ip": "10.20.30.137" }], "key_name": "test", "user_data": "ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA==", "availability_zone":"az1-dc1" } } 通过block_device_mapping_v2扩展属性使用快照创建一台云服务器，其中，boot_index为0，且该快照对应的云硬盘必须为系统盘。 POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers{ "server":{ "name":"wjvm48", "availability_zone":"az1-dc1", "block_device_mapping_v2": [ { "source_type":"snapshot", "boot_index":"0", "uuid":"df51997d-ee35-4fb3-a372-e2ac933a6565", // snapshot id，创建snapshot接口会返回id "destination_type":"volume" } ], "flavorRef":"s3.xlarge.2", "max_count":1, "min_count":1, "networks": [ { "uuid":"79a68cef-0936-4e21-b1f4-b800ecb70246" } ] } } 通过block_device_mapping_v2使用卷创建一台弹性云服务器。 POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers{ "server": { "flavorRef": "s3.xlarge.2", "name": "wjvm48", "metadata": { "name": "name_xx1", "id": "id_xxxx1" }, "block_device_mapping_v2": [{ "source_type": "volume", "destination_type": "volume", "uuid": "bd7e4f86-b004-4745-bea2-a55b1085f107", "delete_on_termination": "False", "boot_index": "0", "volume_type": "dsware", "volume_size": "40" }], "security_groups": [{ "name": "name_xx5_sg" }], "networks": [{ "uuid": "fd40e6f8-942d-4b4e-a7ae-465287b02a2c", "port": "e730a11c-1a19-49cc-8797-cee2ad67af6f", "fixed_ip": "10.20.30.137" }], "key_name": "test", "user_data": "ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA==", "availability_zone":"az1-dc1" } } 使用imageRef创建一台弹性云服务器，建议将密码在配置文件或者环境变量中密文存放，使用时解密，确保安全。 POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers{ "server": { "flavorRef": "s3.xlarge.2", "name": "wjvm48", "metadata": { "name": "name_xx1", "id": "id_xxxx1" }, "adminPass": "$ADMIN_PASS", "imageRef": "6b344c54-d606-4e1a-a99e-a7d0250c3d14", "security_groups": [{ "name": "name_xx5_sg" }], "networks": [{ "uuid": "fd40e6f8-942d-4b4e-a7ae-465287b02a2c", "port": "e730a11c-1a19-49cc-8797-cee2ad67af6f", "fixed_ip": "10.20.30.137" }], "key_name": "test", "user_data": "ICAgICAgDQoiQSBjbG91ZCBkb2VzIG5vdCBrbm93IHdoeSBpdCBtb3ZlcyBpbiBqdXN0IHN1Y2ggYSBkaXJlY3Rpb24gYW5kIGF0IHN1Y2ggYSBzcGVlZC4uLkl0IGZlZWxzIGFuIGltcHVsc2lvbi4uLnRoaXMgaXMgdGhlIHBsYWNlIHRvIGdvIG5vdy4gQnV0IHRoZSBza3kga25vd3MgdGhlIHJlYXNvbnMgYW5kIHRoZSBwYXR0ZXJucyBiZWhpbmQgYWxsIGNsb3VkcywgYW5kIHlvdSB3aWxsIGtub3csIHRvbywgd2hlbiB5b3UgbGlmdCB5b3Vyc2VsZiBoaWdoIGVub3VnaCB0byBzZWUgYmV5b25kIGhvcml6b25zLiINCg0KLVJpY2hhcmQgQmFjaA==", "availability_zone":"az1-dc1" } } 批量创建弹性云服务器，最小数量为2，最大数量为3。 POST https://{endpoint}/v2.1/9c53a566cb3443ab910cf0daebca90c4/servers{ "server": { "availability_zone":"az1.dc1", "name": "test", "imageRef": "10ff4f01-35b6-4209-8397-359cb4475fa0", "flavorRef": "s3.xlarge.2", "return_reservation_id": "true", "networks": [ { "uuid": "51bead38-d1a3-4d08-be20-0970c24b7cab" } ], "min_count": "2", "max_count": "3" }}

响应示例 创建弹性云服务器： { "server": { "security_groups": [ { "name": "name_xx5_sg" } ], "OS-DCF:diskConfig": " MANUAL", "id": "567c1557-0eca-422c-bfce-149d6b8f1bb8", "links": [ { "href": "http://xxx/v2/dc4059e8e7994f2498b514ca04cdaf44/servers/567c1557-0eca-422c-bfce-149d6b8f1bb8", "rel": "self" }, { "href": "http://xxx/dc4059e8e7994f2498b514ca04cdaf44/servers/567c1557-0eca-422c-bfce-149d6b8f1bb8", "rel": "bookmark" } ], "adminPass": "*********" }} 批量创建弹性云服务器： { "reservation_id": "r-3fhpjulh"}

接口约束 该接口为原生接口，不支持整机镜像创建弹性云服务器功能。如需使用整机镜像创建弹性云服务器，请使用创建云服务器（按需）。 该接口为原生接口，不支持创建竞价实例。如需创建竞价实例请使用创建云服务器、创建云服务器（按需）。 该接口为原生接口，不支持创建包年/包月计费模式的实例。如需创建包年/包月计费模式的云服务器请使用创建云服务器。 使用该接口创建的云服务器，不支持在创建过程中绑定弹性公网IP，推荐使用创建云服务器（按需）创建云服务器并绑定弹性公网IP。 网络的三个参数（port、uuid和fixed_ip）中，port优先级最高；指定fixed_ip时必须指明uuid。 注入文件失败，将导致创建弹性云服务器失败。 使用镜像创建弹性云服务器时，存在下面约束： 不支持指定Host创建弹性云服务器。 租户如果对弹性云服务器中的卷进行了备份，则需要租户自行删除该卷所对应的快照等数据后，才能删除卷。 调整镜像创建的弹性云服务器规格时，不支持resource_type不同的flavor之间的规格调整。 云服务平台提供的原生接口/v2/{project_id}/servers 和 /v2.1/{project_id}/servers 是基于社区版OpenStack原生接口加固而成的，兼容社区版OpenStack原生接口。 较之社区版的OpenStack原生接口，在使用指定镜像的方式创建弹性云服务器时存在如下差异： 社区OpenStack原生接口：默认使用服务器本地磁盘创建弹性云服务器。 云服务平台提供的原生接口：为了保障可靠性，使用共享存储作为系统盘创建弹性云服务器。 该差异的具体表现为，当您使用提供的原生接口创建云服务器时： 可以查询到云服务器挂载的系统盘信息。 云服务器的系统盘会占用云硬盘的配额。 不支持使用image过滤查询指定镜像方式创建的弹性云服务器。 指定卷创建弹性云服务器场景下，指定的卷与创建的弹性云服务器必须处于相同的AZ（availability_zone）。 用户创建弹性云服务器时在block_device_mapping_v2设置的device_name字段不会生效，系统会默认生成一个device_name。 请勿使用“provider:network_type”为“geneve”的网络来创建弹性云服务器。 “provider:network_type”为“geneve”时，表示裸金属服务器使用的内部高速网络。 如果使用密钥方式远程登录云服务器，请使用key_name参数。如果使用密码方式远程登录云服务器，可使用adminPass参数；对于Linux云服务器，还可使用user_data进行注入，对于Windows云服务器，还可通过元数据admin_pass进行注入。

响应示例 { "snapshot": { "createdAt": "2016-05-20T16:54:14.981520", "displayDescription": null, "id": "b836dc3d-4e10-4ea4-a34c-8f6b0460a583", "displayName": "test", "size": 1, "status": "creating", "volumeId": "ba5730ea-8621-4ae8-b702-ff0ffc12c209" }}

响应消息 响应参数 响应参数如表2所示。 表2 响应参数 参数 参数类型 描述 id String 卷快照ID，UUID格式 status String 卷快照的状态 displayName String 卷快照名称 displayDescription String 卷快照描述信息 createdAt String 卷快照创建时间 volumeId String 快照所属的卷ID，UUID格式。 size Integer 卷快照大小

功能介绍 变更单台云服务器规格。 对于运行中的弹性云服务器，系统会自动关机，并将弹性云服务器中的数据拷贝到目标节点（目标节点可与源节点相同）后重新启动弹性云服务器。 底层资源不足时，该接口会自动回滚。 该接口不单独使用，需要轮询判断虚拟机状态，当虚拟机同时满足"status"为"VERIFY_RESIZE"、"OS-EXT-STS:task_state"为""、"OS-EXT-STS:vm_state"为"RESIZED"时，配合“确认变更云服务器规格（POST /v2.1/{project_id}/servers/{server_id}/action）”或“回退变更云服务器规格（POST /v2.1/{project_id}/servers/{server_id}/action）”两个接口一起使用。 当前API已废弃，请使用变更云服务器规格（按需）。

请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 security_group 是 Object security_group对象，在消息体中指定，请参见表3。 表3 请求参数security_group的对象 参数 是否必选 参数类型 描述 name 否 String 安全组名称，长度0-255。 description 否 String 安全组描述，长度0-255。

响应消息 响应参数如表4所示。 表4 响应参数 参数 参数类型 描述 security_group Object security_group对象，参见表5。 表5 响应参数security_group的对象 参数 参数类型 描述 description String 安全组描述信息 id String 安全组ID，UUID格式 name String 安全组名字 rules Array of objects 安全组规则列表，当前该列表为空列表 tenant_id String 租户ID或项目ID

响应示例 { "security_group": { "rules": [], "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae", "description": "desc-sg", "id": "81f1d23b-b1e2-42cd-bdee-359b4a065a42", "name": "test-sg" }}

响应消息 响应参数请参见表2。 表2 响应参数 参数 参数类型 描述 id String 镜像ID，UUID格式。 links Array of objects 镜像相关快捷链接地址 name String 镜像名称 metadata Object metadata键值对 OS-EXT-IMG-SIZE:size Integer 镜像大小。大于0。 minDisk Integer 镜像要求的最小磁盘大小。大于0。 minRam Integer 镜像要求的最小内存大小。大于0。 progress Integer 镜像上传百分比。大于0。 status String 镜像状态 created String 镜像创建时间。ISO8601时间格式，例如：2013-06-09T06:42:18Z updated String 镜像更新时间。ISO8601时间格式，例如：2013-06-09T06:42:18Z 表3 links参数信息 参数 是否必选 参数类型 描述 href 是 String 相应资源的链接。 rel 是 String 有三种取值。self：自助链接包含版本链接的资源。立即链接后使用这些链接。bookmark：书签链接提供了一个永久资源的永久链接，该链接适合于长期存储。alternate：备用链接可以包含资源的替换表示形式。例如，OpenStack计算映像可能在OpenStack映像服务中有一个替代表示。 type 否 String type属性提供了一个提示，用于在跟踪该链接时期望的表示类型。

响应示例 { "image": { "status": "ACTIVE", "updated": "2015-12-27T02:52:25Z", "name": "cirror", "links": [ { "href": "https://compute.localdomain.com:8001/v2/719e9483f42d4784a089862ac4c3e8d0/images/17a1890b-0fa4-485e-8505-14e294017988", "rel": "self" }, { "href": "https://compute.localdomain.com:8001/719e9483f42d4784a089862ac4c3e8d0/images/17a1890b-0fa4-485e-8505-14e294017988", "rel": "bookmark" }, { "href": "https://https://image.az2.dc1.domainname.com:443/719e9483f42d4784a089862ac4c3e8d0/images/17a1890b-0fa4-485e-8505-14e294017988", "type": "application/vnd.openstack.image", "rel": "alternate" } ], "created": "2015-12-27T02:52:24Z", "minDisk": 0, "progress": 100, "minRam": 0, "metadata": { "__os_version": "CentOS 4.4 32bit", "file_format": "img", "file_name": "**.img", "describe": "", "__os_type": "Linux", "virtual_env_type": "KVM", "hw_disk_bus": "scsi" }, "id": "17a1890b-0fa4-485e-8505-14e294017988", "OS-EXT-IMG-SIZE:size": 13167616 }}

URI GET /v2.1/{project_id}/images/detail?name={name}&status={status}&changes-since={changes-since}&minRam={minRam}&minDisk={inDisk} 参数说明请参见表1。 表1 路径参数 参数 是否必选 描述 project_id 是 项目ID。 获取方法请参见获取项目ID。 支持分页查询。分页查询的相关信息，请参见分页查询。

响应消息 响应参数如表4所示。 表4 响应参数 参数 参数类型 描述 id String 镜像ID，UUID格式。 links Array of objects 镜像相关快捷链接地址 name String 镜像名称 metadata Object metadata键值对 OS-EXT-IMG-SIZE:size Integer 镜像大小。 大于0。 minDisk Integer 镜像要求的最小磁盘大小。 大于0。 minRam Integer 镜像要求的最小内存大小。 大于0。 progress Integer 镜像上传百分比。 大于0。 status String 镜像状态 created String 镜像创建时间。 ISO8601时间格式，例如：2013-06-09T06:42:18Z updated String 镜像更新时间。 ISO8601时间格式，例如：2013-06-09T06:42:18Z 表5 links参数信息 参数 是否必选 参数类型 描述 href 是 String 相应资源的链接。 rel 是 String 有三种取值。self：自助链接包含版本链接的资源。立即链接后使用这些链接。bookmark：书签链接提供了一个永久资源的永久链接，该链接适合于长期存储。alternate：备用链接可以包含资源的替换表示形式。例如，OpenStack计算映像可能在OpenStack映像服务中有一个替代表示。 type 否 String type属性提供了一个提示，用于在跟踪该链接时期望的表示类型。

响应示例 { "image": { "OS-EXT-IMG-SIZE:size": 20578304, "created": "2014-02-10T17:05:01Z", "id": "ee10f19c-503c-44af-af2f-73d5e42f7a17", "links": [ { "href": "http://xxx/v2/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17", "rel": "self" }, { "href": "http://xxx/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17", "rel": "bookmark" }, { "href": "http://xxx/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17", "rel": "alternate", "type": "application/vnd.openstack.image" } ], "metadata": { "clean_attempts": "3", "image_location": "snapshot", "image_state": "available", "image_type": "snapshot", "instance_type_ephemeral_gb": "0", "instance_type_flavorid": "6", "instance_type_id": "7", "instance_type_memory_mb": "256", "instance_type_name": "wj.ssd", "instance_type_root_gb": "2", "instance_type_rxtx_factor": "1.0", "instance_type_swap": "0", "instance_type_vcpus": "1", "instance_uuid": "b600b5b1-ed8c-4814-aefa-8b903c894c20", "os_type": "None", "owner_id": "d9ebe43510414ef590a4aa158605329e", "user_id": "74fe4ff0674b434b8a274077d8106c5b" }, "minDisk": 2, "minRam": 0, "name": "image1", "progress": 100, "server": { "id": "b600b5b1-ed8c-4814-aefa-8b903c894c20", "links": [ { "href": "http://xxx/v2/d9ebe43510414ef590a4aa158605329e/servers/b600b5b1-ed8c-4814-aefa-8b903c894c20", "rel": "self" }, { "href": "http://xxx/d9ebe43510414ef590a4aa158605329e/servers/b600b5b1-ed8c-4814-aefa-8b903c894c20", "rel": "bookmark" } ] }, "status": "ACTIVE", "updated": "2014-02-10T17:05:07Z" }}

URI GET /v2.1/{project_id}/images?name={name}&status={status}&changes-since={changes-since}&minRam={minRam}&minDisk={inDisk} 参数说明请参见表1。 表1 路径参数 参数 是否必选 描述 project_id 是 项目ID。 获取方法请参见获取项目ID。 支持分页查询。分页查询的相关信息，请参见分页查询。

响应示例 { "images": [ { "id": "ee10f19c-503c-44af-af2f-73d5e42f7a17", "links": [ { "href": "http://xxx/v2/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17", "rel": "self" }, { "href": "http://xxx/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17", "rel": "bookmark" }, { "href": "http://xxx/d9ebe43510414ef590a4aa158605329e/images/ee10f19c-503c-44af-af2f-73d5e42f7a17", "rel": "alternate", "type": "application/vnd.openstack.image" } ], "name": "image1" } ]}

请求示例 设置对云服务器资源供给的地域和规格推荐，vCPU范围为2~8，内存范围为4096 MiB~8192 MiB；推荐结果对每个可用区下的每个规格打分，推荐策略为成本策略，接受推荐的区域为“region1”。 POST https://{endpoint}/v1/{domain_id}/recommendations/ecs-supply{ "flavor_constraint": { "flavor_requirements": [{ "vcpu_count": { "max": 8, "min": 2 }, "memory_mb": { "max": 8192, "min": 4096 } }] }, "option": { "result_granularity": "BY_FLAVOR_AND_AZ" }, "strategy": "COST", "locations": [{ "region_id": "region1" }]}

请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 flavor_constraint 否 Object 资源供给规格的约束，给出规格列表时优先使用规格列表，详情请参见表3。 flavor_ids 否 Array of strings 接受推荐的规格列表。 locations 否 Array of objects 接受推荐的地域列表，默认接受所有区域。 option 否 Object 供给推荐的选项。 strategy 否 String 推荐的策略。 CAPACITY：容量策略 COST：成本策略 limit 否 Integer 查询返回的数量限制。 marker 否 String 取值为上一页数据的最后一条记录的唯一标记。 表3 flavor_constraint参数信息 参数 是否必选 参数类型 描述 architecture_type 否 Array of strings 接受的体系结构描述。 flavor_requirements 否 Array of objects 资源的需求约束，详情请参见表4。 表4 flavor_requirements参数信息 参数 是否必选 参数类型 描述 vcpu_count 否 Object 规格的vCPU数量范围，不填表示接受所有，详情请参见表5。 memory_mb 否 Object 规格的内存大小范围，不填表示接受所有，单位MiB，详情请参见表6。 cpu_manufacturers 否 Array of strings 可选CPU制造商，不填表示接受所有。 memory_gb_per_vcpu 否 Object 规格的单vCPU对应内存容量范围，不填表示接受所有，内存单位GiB，详情请参见表6。 instance_generations 否 Array of strings 接受的资源代系，不填表示接受所有。 表5 vcpu_count参数信息 参数 是否必选 参数类型 描述 max 否 Integer 最大值，-1表示无限制。 min 否 Integer 最小值，-1表示无限制。 表6 memory_mb参数信息 参数 是否必选 参数类型 描述 max 否 Integer 最大值，-1表示无限制。 min 否 Integer 最小值，-1表示无限制。 表7 memory_gb_per_vcpu参数信息 参数 是否必选 参数类型 描述 max 否 Double 最大值，-1表示无限制。 min 否 Double 最小值，-1表示无限制。 表8 locations参数信息 参数 是否必选 参数类型 描述 region_id 是 String 区域ID。 availability_zone_id 否 String 可用区ID。 表9 option参数信息 参数 是否必选 参数类型 描述 result_granularity 否 String 推荐结果的粒度。 BY_REGION：对每个区域打分，可使用多种规格满足需求。 BY_AZ：对每个可用区打分。 BY_FLAVOR：对每个规格打分，可使用多地域满足需求。 BY_FLAVOR_AND_REGION：对每个区域下的每个规格打分。 BY_FLAVOR_AND_AZ：对每个可用区下的每个规格打分。 enable_spot 否 Boolean 是否推荐竞价实例。

响应示例 { "instances": [ { "id": "5bbcc3c4-1da2-4437-a48a-66f15b1b13f9", "name": "server1", "availability_zone_id": "az1", "flavor_id": "s3.large.2", "status": "ACTIVE", "sell_mode": "onDemand" } ], "page_info": { "next_marker": "616fb98f-46ca-475e-917e-2563e5a8cd19" }}

URI GET /v2/{domain_id}/auto-launch-groups/{auto_launch_group_id}/instances 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 domain_id 是 租户域ID。 auto_launch_group_id 是 智能购买组ID。 表2 查询参数 参数 是否必选 参数类型 描述 limit 否 Integer 查询返回实例的数量限制。 取值范围：1-1000。 marker 否 String 取值为上一页数据的最后一条记录的唯一标识。

响应消息 响应参数如表3所示。 表3 响应参数 参数 参数类型 描述 instances Array of objects 实例列表，详情请参见表4。 page_info Object 页标记。 表4 instances参数信息 参数 参数类型 描述 name String 实例名称。 id String 实例ID。 availability_zone_id String 可用区ID。 flavor_id String 实例规格。 status String 实例状态。 sell_mode String 销售模型。 spot：竞价实例 onDemand：按需实例 表5 page_info参数信息 参数 参数类型 描述 next_marker String 返回下一页查询地址。