华为云用户手册

响应消息 响应参数如表2所示。 表2 响应参数 参数 参数类型 描述 limits Object 租户限制，详情请参见表3。 表3 limits参数信息 参数 参数类型 描述 rate List 值为空列表 absolute Object 租户配额限制，详情请参见表4。 表4 absolute参数信息 参数 参数类型 描述 maxServerMeta String 云服务器元数据数量限制。 值为“-1”时，表示无数量限制。 maxPersonality String 注入文件数量限制。 值为“-1”时，表示无数量限制。 totalServerGroupsUsed String 已使用的云服务器组数量。 maxImageMeta String 镜像元数据数量限制。 值为“-1”时，表示无数量限制。 maxPersonalitySize String 注入文件大小限制。 值为“-1”时，表示无大小限制。 maxTotal RAM Size String 总内存大小限制。 值为“-1”时，表示无大小限制。 maxTotalKeypairs String keypair数量限制。 值为“-1”时，表示无数量限制。 maxSecurityGroupRules String 安全组规则数量限制。 值为“-1”时，表示无数量限制。 微版本2.35及以上版本不支持。 maxServerGroups String 云服务器组数量限制。 值为“-1”时，表示无数量限制。 totalCoresUsed String 已使用的核数。 totalRAMUsed String 已使用的内存大小。 maxSecurityGroups String 安全组数量限制。 值为“-1”时，表示无数量限制。 totalFloatingIpsUsed String 已使用的浮动IP数量。 totalInstancesUsed String 已使用的云服务器数量。 totalSecurityGroupsUsed String 已使用的安全组数量。 maxTotalFloatingIps String 浮动IP数量限制。 值为“-1”时，表示无数量限制。 maxTotalInstances String 云服务器数量限制。 值为“-1”时，表示无数量限制。 maxTotalCores String 总核数限制。 值为“-1”时，表示无数量限制。 maxServerGroupMembers String 云服务器组成员数量限制。 值为“-1”时，表示无数量限制。

响应示例 { "limits": { "rate": [], "absolute": { "maxServerMeta": 128, "maxPersonality": 5, "totalServerGroupsUsed": 0, "maxImageMeta": 128, "maxPersonalitySize": 10240, "maxTotalRAMSize": 25165824, "maxTotalKeypairs": -1, "maxSecurityGroupRules": 20, "maxServerGroups": -1, "totalCoresUsed": 0, "totalRAMUsed": 0, "maxSecurityGroups": 10, "totalFloatingIpsUsed": 0, "totalInstancesUsed": 0, "totalSecurityGroupsUsed": 0, "maxTotalFloatingIps": 10, "maxTotalInstances": 2048, "maxTotalCores": 20480, "maxServerGroupMembers": -1 } }}

云服务器状态 E CS API中云服务器实例存在三种状态： status，云服务器实例当前状态信息，由OS-EXT-STS:vm_state和OS-EXT-STS:task_state综合生成。 OS-EXT-STS:vm_state，云服务器扩展属性，标识云服务器实例当前处于完成某个操作的稳定状态。 OS-EXT-STS:task_state，云服务器扩展属性，标识当前云服务器实例的任务状态，即当前云服务器实例正在处理某个操作的中间状态。 表1 Status 列表 Status 状态 说明 BUILD 创建实例后，在实例状态进入运行中之前的状态。 REBOOT 实例正在进行重启操作。 HARD_REBOOT 实例正在进行强制重启操作。 REBUILD 实例正在重建中。 MIGRATING 实例正在热迁移中。 RESIZE 实例接收变更请求，开始进行变更操作。 ACTIVE 实例正常运行状态。 SHUTOFF 实例被正常停止。 REVERT_RESIZE 实例正在回退变更规格的配置。 VERIFY_RESIZE 实例正在校验变更完成后的配置。 ERROR 实例处于异常状态。 DELETED 实例已被正常删除。 SHELVED 镜像启动的实例处于搁置状态。 SHELVED_OFFLOADED 卷启动的实例处于搁置状态。 UNKNOWN 实例处于未知状态。 表2 OS-EXT-STS:vm_state 列表 vm_state 状态 说明 building 创建实例后，在实例状态进入运行中之前的状态。 active 实例正常运行状态。 stopped 实例被正常停止。 resized 实例完成变更规格的配置。 error 实例处于异常状态。 deleted 实例已被正常删除。 shelved 镜像启动的实例处于搁置状态。 shelved_offloaded 卷启动的实例处于搁置状态。 表3 OS-EXT-STS:task_state 列表 task_state 状态 说明 scheduling 实例处于创建中，正在进行调度。 block_device_mapping 实例处于创建中，正在准备磁盘。 networking 实例处于创建中，正在准备网络。 spawning 实例处于创建中，正在内部创建。 rebooting 实例处于重启中。 reboot_pending 实例处于重启中，正在下发重启。 reboot_started 实例处于重启中，开始内部重启。 rebooting_hard 实例处于强制重启中。 reboot_pending_hard 实例处于强制重启中，正在下发重启。 reboot_started_hard 实例处于强制重启中，开始内部重启。 rebuilding 实例处于重建中。 rebuild_block_device_mapping 实例处于重建中，正在准备磁盘。 rebuild_spawning 实例处于重建中，正在内部重建。 migrating 实例处于热迁移中。 resize_prep 实例处于调整规格中，正在准备阶段。 resize_migrating 实例处于调整规格中，正在迁移阶段。 resize_migrated 实例处于调整规格中，已经完成迁移。 resize_finish 实例处于调整规格中，正在完成调整。 resize_reverting 实例处于调整规格中，正在回退调整。 powering-off 实例处于停止中。 powering-on 实例处于启动中。 deleting 实例处于删除中。 shelving 镜像启动的实例处于搁置中。 shelving_offloading 卷启动的实例处于搁置中。 shelving_image_pending_upload 实例处于搁置中，正在下发上传镜像。 shelving_image_uploading 实例处于搁置中，上传镜像中。 unshelving 实例处于解除搁置中。 表4 三种状态对应关系表 vm_state task_state status building scheduling block_device_mapping networking spawning null BUILD active rebooting reboot_pending reboot_started REBOOT rebooting_hard reboot_pending_hard reboot_started_hard HARD_REBOOT rebuilding rebuild_block_device_mapping rebuild_spawning REBUILD migrating MIGRATING powering-off deleting null ACTIVE stopped resize_prep resize_migrating resize_migrated resize_finish RESIZE rebuilding rebuild_block_device_mapping rebuild_spawning REBUILD powering-on deleting null SHUTOFF resized resize_reverting REVERT_RESIZE null VERIFY_RESIZE error rebuilding rebuild_block_device_mapping rebuild_spawning REBUILD deleting null ERROR deleted null DELETED shelved shelving shelving_image_pending_upload shelving_image_uploading unshelving null SHELVED shelved_offloaded shelving_offloading unshelving null SHELVED_OFFLOADED 如果状态未包含在表4中，则为UNKNOWN状态。 父主题： 附录

租户配额管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM 项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 查询租户配额 GET /v1/{project_id}/cloudservers/limits ecs:cloudServerQuotas:get - √ √ × × 查询租户配额（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-quota-sets/{project_id}?user_id={user_id} ecs:quotas:get - √ × × × 查询默认配额（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-quota-sets/{project_id}/defaults ecs:quotas:get - √ × × × 父主题： 权限和授权项

SSH密钥管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 创建和导入SSH密钥（OpenStack原生）（废弃） POST /v2.1/{project_id}/os-keypairs ecs:serverKeypairs:create - √ × × × 查询SSH密钥详情（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-keypairs/{keypair_name} ecs:serverKeypairs:get - √ × × × 查询SSH密钥列表（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-keypairs ecs:serverKeypairs:list - √ × × × 删除SSH密钥（OpenStack原生）（废弃） DELETE /v2.1/{project_id}/os-keypairs/{keypair_name} ecs:serverKeypairs:delete - √ × × × 父主题： 权限和授权项

响应示例 { "volumeAttachment": { "pciAddress": "0000:02:01.0", "volumeId": "a26887c6-c47b-4654-abb5-asdf234r234r", "device": "/dev/vda", "serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0", "id": "a26887c6-c47b-4654-abb5-asdf234r234r", "size": "40", "bootIndex": 0, "bus":"virtio" }}

响应消息 响应参数如表2所示。 表2 响应参数 参数 参数类型 描述 volumeAttachment Object 云服务器挂载信息，更多信息请参见表3。 表3 volumeAttachment参数 参数 参数类型 描述 serverId String 弹性云服务器ID，UUID格式。 volumeId String 云硬盘ID，UUID格式。 id String 挂载ID，与云硬盘ID相同。 UUID格式。 size Integer 云硬盘大小，单位GB。 device String 云硬盘挂载盘符，即磁盘挂载点。 pciAddress String pci地址。 bootIndex Boolean 云硬盘启动顺序。 0为系统盘。 非0为数据盘 bus String 磁盘总线类型 。 取值范围：virtio、scsi

磁盘管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 卸载指定弹性云服务器的磁盘 DELETE /v1/{project_id}/cloudservers/{server_id}/detachvolume/{volume_id} ecs:cloudServers:detachVolume - √ √ √ √ 弹性云服务器挂载磁盘 POST /v1/{project_id}/cloudservers/{server_id}/attachvolume ecs:cloudServers:attach evs:volumes:use √ √ √ √ 查询弹性云服务器挂载磁盘列表详情信息 GET /v1/{project_id}/cloudservers/{server_id}/block_device ecs:cloudServers:listServerBlockDevices - √ √ √ √ 查询弹性云服务器挂载磁盘列表信息 GET /v1/{project_id}/cloudservers/{server_id}/os-volume_attachments ecs:cloudServers:listServerVolumeAttachments - √ √ √ √ 查询弹性云服务器单个磁盘挂载信息 GET /v1/cloudservers/{server_id}/block_device/{volume_id} ecs:cloudServers:showServerBlockDevice - √ √ √ √ 挂载弹性云服务器磁盘（OpenStack原生）（废弃） POST /v2.1/{project_id}/servers/{server_id}/os-volume_attachments ecs:serverVolumeAttachments:create ecs:servers:get ecs:flavors:get ecs:serverVolumes:use evs:volumes:list evs:volumes:get evs:volumes:update evs:volumes:attach evs:volumes:manage √ × × × 卸载云服务器磁盘（OpenStack原生）（废弃） DELETE /v2.1/{project_id}/servers/{server_id}/os-volume_attachments/{volume_id} ecs:serverVolumeAttachments:delete ecs:serverVolumes:use evs:volumes:list evs:volumes:get evs:volumes:update evs:volumes:detach evs:volumes:manage √ × × × 查询弹性云服务器挂载磁盘信息（OpenStack原生）（废弃） GET /v2.1/{project_id}/servers/{server_id}/os-volume_attachments ecs:serverVolumeAttachments:list ecs:serverVolumes:use ecs:servers:get √ × × × 查询弹性云服务器挂载的单个磁盘信息（OpenStack原生）（废弃） GET /v2.1/{project_id}/servers/{server_id}/os-volume_attachments/{volume_id} ecs:serverVolumeAttachments:get ecs:serverVolumes:use √ × × × 创建磁盘（OpenStack原生）（废弃） POST /v2.1/{project_id}/os-volumes ecs:serverVolumes:use evs:volumes:create √ × × × 删除磁盘（OpenStack原生）（废弃） DELETE /v2.1/{project_id}/os-volumes/{volume_id} ecs:serverVolumes:use evs:volumes:get evs:volumes:delete √ × × × 查询指定磁盘信息（OpenStack原生） GET /v2.1/{project_id}/os-volumes/{volume_id} ecs:serverVolumes:use evs:volumes:get √ × × × 查询磁盘列表（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-volumes ecs:serverVolumes:use evs:volumes:get evs:volumes:list √ × × × 查询磁盘列表详情（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-volumes/detail ecs:serverVolumes:use evs:volumes:get evs:volumes:list √ × × × 父主题： 权限和授权项

响应（批量操作类） 本节内容当前仅支持批量重置弹性云服务器密码、批量修改云服务器的响应。其他批量操作的请求结果请参见响应（任务类）。 正常响应要素说明 名称 参数类型 说明 response Array of objects 提交请求成功后返回的响应列表，详情请参见 response数据结构说明。 表1 response数据结构说明 名称 参数类型 说明 id String 操作成功的虚拟机id 异常响应要素说明 名称 参数类型 说明 error Object 批量请求异常时返回的整体异常信息，详情请参见 表2。 internalError Array of objects 批量请求处理中，每一个单个请求的具体异常信息，详情请参见 internalError 数据结构说明。 表2 error数据结构 名称 参数类型 说明 message String 批量操作整体异常错误信息描述。 code String 批量操作整体异常错误信息编码。 表3 internalEroCMM.0101r 数据结构说明 名称 参数类型 说明 id String 具体单个请求操作失败的虚拟机id error_message String 具体单个请求操作失败的错误信息描述。 error_code String 具体单个请求操作失败的错误信息编码。 响应示例 正常响应： { "response": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19" }, { "id": "516fb98f-46ca-475e-917e-2563e5a8cd12" } ]} 异常响应： { "error": { "code": "Ecs.xxxx", "message": "xxxxxxxxxxxxxxx" }, "internalError": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19", "error_code": "ECS.XXXX", "error_message": "xxxxxxxxxxxxxxx" }, { "id": "516fb98f-46ca-475e-917e-2563e5a8cd12", "error_code": "ECS.XXXX", "error_message": "xxxxxxxxxxxxxxx" } ]} 父主题： 提交批量操作请求结果

响应示例 { "versions":[ { "min_version":"", "links":[ { "rel":"self", "href":"https://{endpoint}/v2/" } ], "id":"v2.0", "updated":"2011-01-21T11:33:21Z", "version":"", "status":"SUPPORTED" }, { "min_version":"2.1", "links":[ { "rel":"self", "href":"https://{endpoint}/v2.1/" } ], "id":"v2.1", "updated":"2013-07-23T11:33:21Z", "version":"2.60", "status":"CURRENT" } ]}

请求消息 请求参数如表2所示。 表2 请求参数 参数 是否必选 参数类型 描述 name 否 String 智能购买组名称。 取值范围：1-64个字符，只能包含中文、字母、数字、下划线和中划线。 guarantee_plan_id 否 String 算力保障计划ID。 target_capacity 否 Integer 智能购买组目标容量。 实例数量或者CPU个数目标容量大于等于stable_capacity。竞价实例的容量为满配容量减去stable_capacity。 stable_capacity 否 Integer 按需实例目标容量。 目标容量指实例数量或CPU个数，必须小于等于target_capacity，智能购买组中可以没有按需实例。 excess_fulfilled_capacity_behavior 否 String 超过目标容量或目标容量减少时的实例中断行为。 terminate：释放 noTermination：不释放 默认值：terminate instances_behavior_with_expiration 否 String 请求到期时正在运行实例的中断行为。 terminate：释放 noTermination：不释放 默认值：terminate spot_price 否 Double 用户愿意为竞价实例每小时支付的最高价格。如果overrides中没有提供价格，可以使用该价格。

请求示例 修改指定智能购买组信息，包括名称、算力保障计划ID、目标容量、按需实例目标容量等。 PUT https://{endpoint}/v2/{domain_id}/auto_launch_groups/{auto_launch_group_id}{ "name": "autoLaunchGroup1", "guarantee_plan_id": "plan_id", "target_capacity": 10, "stable_capacity": 5, "excess_fulfilled_capacity_behavior": "terminate", "instances_behavior_with_expiration": "terminate", "spot_price": 0.5}

响应消息 响应参数如表1所示。 表1 响应参数 参数 参数类型 描述 versions Object API版本信息列表，详情请参见表2。 表2 versions字段数据结构说明 参数 参数类型 描述 id string 所讨论的版本的通用名称，仅是信息性的，它没有真正的语义。 links Object 版本相关标记快捷链接信息，详情请参见表3。 min_version string 如果API的这个版本支持微版本，则支持最小的微版本。 如果不支持微版本，这将是空字符串。 status string API版本的状态。 CURRENT，这是使用的API的首选版本 SUPPORTED，这是一个较老的，但仍然支持的API版本。 DEPRECATED，一个被废弃的API版本，该版本将被删除。 version string 如果API的这个版本支持微版本，则支持最大的微版本。 如果不支持微版本，这将是空字符串。 updated string 一个有特定值的字符串。 API版本为2.0时，值为2011-01-21T11:33:21Z，API版本是2.1时，值为 2013-07-23T11:33:21Z。 表3 links字段数据结构说明 参数 参数类型 描述 href string 相应资源的链接。 rel string self：自助链接包含版本链接的资源。立即链接后使用这些链接。 bookmark：书签链接提供了一个永久资源的永久链接，该链接适合于长期存储。 alternate：备用链接可以包含资源的替换表示形式。 例如，OpenStack计算映像可能在OpenStack映像服务中有一个替代表示。

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

响应示例 { "servers": [ { "id": "616fb98f-46ca-475e-917e-2563e5a8cd19", "links": [ { "href": "http://openstack.example.com/v2/openstack/servers/616fb98f-46ca-475e-917e-2563e5a8cd19", "rel": "self" }, { "href": "http://openstack.example.com/openstack/servers/616fb98f-46ca-475e-917e-2563e5a8cd19", "rel": "bookmark" } ], "name": "new-server-test" } ]}

URI GET /v2.1/{project_id}/servers?changes-since={changes-since}&image={image}&flavor={flavor}&name={name}&status={status}&limit={limit}&marker={marker}¬-tags={not-tags}&reservation_id={reservation_id}&ip={ip} 参数说明请参见表1。 表1 路径参数 参数 是否必选 描述 project_id 是 项目ID。 获取方法请参见获取项目ID。

响应消息 响应参数如表3所示。 表3 响应参数 参数 参数类型 描述 servers Array of objects 查询云服务器信息列表，请参见表4。 servers_links Array of objects 分页查询时，查询下一页数据链接，详情请参见表5 表4 servers字段数据结构说明 参数 参数类型 描述 name String 云服务器名称。 id String 云服务器唯一标识。 links Array of objects 云服务器相关快捷链接信息，详情请参见表5。 表5 servers_links，links字段数据结构说明 参数 参数类型 描述 rel String 快捷链接标记名称。 href String 对应快捷链接。

响应示例 { "volumeAttachments": [ { "device": "/dev/sdd", "id": "a26887c6-c47b-4654-abb5-dfadf7d3f803", "serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0", "volumeId": "a26887c6-c47b-4654-abb5-dfadf7d3f803" }, { "device": "/dev/sdc", "id": "a26887c6-c47b-4654-abb5-dfadf7d3f804", "serverId": "4d8c3732-a248-40ed-bebc-539a6ffd25c0", "volumeId": "a26887c6-c47b-4654-abb5-dfadf7d3f804" } ]}

请求示例 PUT https://{endpoint}/v2.1/bb1118612ba64af3a6ea63a1bdcaa5ae/os-security-groups/3d02312d-0764-49c9-8244-2368ddce0045 { "security_group": { "name": "test", "description": "description" }}

响应示例 { "security_group": { "rules": [ { "from_port": null, "group": { "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae", "name": "test" }, "ip_protocol": null, "to_port": null, "parent_group_id": "3d02312d-0764-49c9-8244-2368ddce0045", "ip_range": {}, "id": "00dec0b6-8e96-4906-aadf-46cfe54cf5ef" } ], "tenant_id": "bb1118612ba64af3a6ea63a1bdcaa5ae", "id": "3d02312d-0764-49c9-8244-2368ddce0045", "name": "test", "description": "description" }}

响应消息 响应参数 响应参数如表2所示。 表2 响应参数 参数 参数类型 描述 volumeAttachments Array of objects 云服务器挂载信息列表，详情请参见表3。 表3 volumeAttachments字段数据结构说明 参数 参数类型 描述 device String 挂载目录。 id String 挂载资源ID。 serverId String 所属云服务器ID。 volumeId String 挂载云磁盘ID。

响应消息 响应参数如表4所示。 表4 响应参数 参数 是否必选 参数类型 描述 security_group 是 Object security_group对象，请参见表5。 表5 响应参数security_group对象 参数 是否必选 参数类型 描述 description 是 String 安全组描述信息。 长度不超过255个字符。 id 是 String 安全组ID，UUID格式。 name 是 String 安全组名称。 长度不超过255个字符。 rules 是 Array of objects 安全组规则列表，请参见表6。 tenant_id 是 String 租户ID或项目ID。 长度不超过255个字符。 表6 security_group_rule对象 参数 是否必选 参数类型 描述 parent_group_id 是 String 相关联的安全组ID，UUID格式。 ip_protocol 是 String 协议类型或直接指定IP协议号，取值可为icmp，tcp，udp或IP协议号。 from_port 是 Integer 起始端口，范围1-65535，且不大于to_port(icmp时，表示type，范围是0-255)。 to_port 是 Integer 终止端口，范围1-65535，且不小于from_port(icmp时，表示code，范围是0-255，且如果from_port为-1，to_port为-1表示任意ICMP报文)。 ip_range 是 Object 包含对端ip网段，cidr格式，参见表7。ip_range或者group参数的值为空。 group 是 Object 包括对端安全组的名称和对端安全组所属租户的租户ID，参见表8，ip_range或者group参数的值为空。 id 是 String 安全组规则ID，UUID格式。 表7 ip_range对象 参数 是否必选 参数类型 描述 cidr 是 String 对端IP网段，cidr格式。 长度不超过255个字符。 表8 group对象 参数 是否必选 参数类型 描述 tenant_id 是 String 对端安全组所属租户的租户ID。 name 是 String 对端安全组的名称。

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

响应消息 响应参数如表2所示。 表2 响应参数 参数 参数类型 描述 id String 卷ID，UUID格式 displayName String 卷名称 status String 卷状态 attachments Array of objects 挂卷信息 availabilityZone String 卷所属AZ createdAt String 创建卷的时间 displayDescription String 卷描述 volumeType String 卷类型 snapshotId String 快照ID metadata Object 元数据 size Integer 卷大小

响应示例 { "volume": { "status": "available", "attachments": [{}], "availabilityZone": "nova", "createdAt": "2016-05-20T07:57:56.299000", "displayDescription": null, "volumeType": null, "dispalyName": "test", "snapshotId": null, "metadata": {}, "id": "70b14513-faad-4646-b7ab-a065cef282b4", "size": 1 }}

响应示例 { "quota_set":{ "injected_file_content_bytes":10240, "metadata_items":128, "server_group_members":10, "server_groups":10, "ram":51200, "floating_ips":10, "key_pairs":100, "injected_file_path_bytes":255, "instances":10, "security_group_rules":20, "injected_files":5, "cores":20, "fixed_ips":-1, "id":"474eff20eee84b2e87b5717cc7f34dd8", "security_groups":10 }}

检验Token的有效期 调用API时判断Token有效期是否充足，若您的应用程序缓存了Token，建议每12小时刷新一次Token。以确保Token有足够长的有效期。 您还可以主动查询某个Token的过期时间。通过调用检验Token有效性的接口查看Token的有效时期。 您可以在 API Explorer 中调试该接口。 本例以检验华东-上海二区域的Token为例： 请求URI：GET https://iam.cn-east-2.myhuaweicloud.com/v3/auth/tokens 请求消息头： Content-Type=application/json;charset=utf8 X-Auth-Token：管理员校验本账号中IAM用户的token的有效性：拥有Security Administrator权限的token。 IAM用户校验自己token的有效性：该IAM用户的token（无需特殊权限）。 本例中使用的是IAM用户因此X-Auth-Token与待校验的Token相同。 X-Subject-Token：待校验的token。 查看Token过期时间：响应体中“expires_at”表示该Token过期时间。 若Token即将超期（无法满足一次完整的API调用或者完整的一套组合的调用）则需要重新 获取Token ，防止调用过程中Token超期，调用中断。 {"token": {"expires_at": "2021-05-28T01:24:49.905000Z", ...}}

网络管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 查询网络列表（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-networks ecs:networks:list vpc:networks:get √ × × × 父主题： 权限和授权项

获取Token 接口调用前需要认证鉴权，因此需要提前获取token信息。后续调用API的消息头中“X-Auth-Token”的值即为Token值。 本例以获取华东-上海二区域的Token为例： 请求URI：POST https://iam.cn-east-2.myhuaweicloud.com/v3/auth/tokens 请求消息头：Content-Type=application/json 请求消息体： { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "请填写用户名", "password": "$ADMIN_PASS", //建议在配置文件或者环境变量中密文存放，使用时解密，确保安全 "domain": { "name": "用户所属的账号名称" } } } }, "scope": { "project": { "name": "区 域名 称，本例为cn-east-2" } } }} 查看获取的Token：单击响应头，x-subject-token的取值即为获取的Token。请妥善保存Token信息，在后续的创建云服务器的请求头信息中需要使用Token认证。 General: Request URL: https://iam.cn-east-2.myhuaweicloud.com/v3/auth/tokens Request Method: POST Status Code: 201Response Headers: cache-control: no-cache, no-store, must-revalidate connection: keep-alive content-length: 18401 content-type: application/json; charset=UTF-8 date: Thu, 27 May 2021 01:24:49 GMT expires: Thu, 01 Jan 1970 00:00:00 GMT pragma: no-cache server: api-gateway strict-transport-security: max-age=31536000; includeSubdomains; via: proxy A x-content-type-options: nosniff x-download-options: noopen x-frame-options: SAMEORIGIN x-iam-trace-id: token_cn-east-2_null_9bbec3983f3c7a5c146e709251760467 x-request-id: d7796611318416bc8ffb2948a47fede8 x-subject-token: MIISMAYJKoZIhvcNAQ...7xMUw== x-xss-protection: 1; mode=block; 查看Token过期时间：响应体中“expires_at”表示该Token过期时间。 {"token": {"expires_at": "2021-05-28T01:24:49.905000Z", ...}}

安全组管理 权限 对应的API接口 授权项（Action） 依赖的授权项 IAM项目 (Project) 企业项目 (Enterprise Project) 实例授权 标签授权 创建安全组（OpenStack原生）（废弃） POST /v2.1/{project_id}/os-security-groups ecs:securityGroups:use vpc:securityGroups:get vpc:securityGroups:create vpc:securityGroups:update √ × × × 删除安全组（OpenStack原生）（废弃） DELETE /v2.1/{project_id}/os-security-groups/{security_group_id} ecs:securityGroups:use vpc:securityGroups:get vpc:securityGroups:delete vpc:securityGroups:update √ × × × 查询安全组详细信息（OpenStack原生）(废弃) GET /v2.1/{project_id}/os-security-groups/{security_group_id} ecs:securityGroups:use vpc:securityGroups:get √ × × × 查询安全组列表（OpenStack原生）（废弃） GET /v2.1/{project_id}/os-security-groups ecs:securityGroups:use vpc:securityGroups:get √ × × × 创建安全组规则（OpenStack原生）（废弃） POST /v2.1/{project_id}/os-security-group-rules ecs:securityGroups:use vpc:securityGroups:get vpc:securityGroups:update vpc:securityGroupRules:get vpc:securityGroupRules:create √ × × × 删除安全组规则（OpenStack原生）（废弃） DELETE /v2.1/{project_id}/os-security-group-rules/{security_group_rule_id} ecs:securityGroups:use vpc:securityGroups:get vpc:securityGroups:update vpc:securityGroupRules:get vpc:securityGroupRules:delete √ × × × 更新安全组信息（OpenStack原生）（废弃） PUT /v2.1/{project_id}/os-security-groups/{security_group_id} ecs:securityGroups:use vpc:securityGroups:get vpc:securityGroups:update √ × × × 查询指定云服务器安全组列表（OpenStack原生）（废弃） GET /v2.1/{project_id}/servers/{server_id}/os-security-groups ecs:securityGroups:use vpc:securityGroups:get vpc:ports:get √ × × × 添加安全组（OpenStack原生）（废弃） POST /v2.1/{project_id}/servers/{server_id}/action ecs:securityGroups:use ecs:servers:get ecs:servers:list ecs:serverVolumes:use ecs:diskConfigs:use ecs:serverKeypairs:get vpc:securityGroups:get vpc:securityGroups:create vpc:securityGroups:update vpc:securityGroupRules:get vpc:networks:get vpc:subnets:get vpc:routers:get vpc:ports:get vpc:ports:update √ × × × 移除安全组（OpenStack原生）（废弃） POST /v2.1/{project_id}/servers/{server_id}/action ecs:securityGroups:use ecs:servers:get ecs:servers:list ecs:serverVolumes:use ecs:diskConfigs:use ecs:serverKeypairs:get vpc:securityGroups:get vpc:securityGroups:delete vpc:securityGroups:update vpc:securityGroupRules:get vpc:networks:get vpc:subnets:get vpc:routers:get vpc:ports:get vpc:ports:update √ × × × 父主题： 权限和授权项