更新时间:2022-09-29 gmt 08:00

api概览-凯发k8国际娱乐官网入口

接口介绍

裸金属服务器所提供的接口分为bms接口与openstack原生接口。

通过配合使用bms服务提供的接口和openstack原生接口,您可以完整地使用裸金属服务器的所有功能。例如创建裸金属服务器实例,可以使用openstack原生接口,也可以使用bms接口进行创建。

表1 接口说明

类型

子类型

说明

bms接口

查询裸金属服务器服务当前所用的api版本。

可以实现包周期裸金属服务器的创建、裸金属服务器详情查询等操作。

裸金属服务器修改名称、重装系统、启动、重启、关闭等功能。

用于查询裸金属服务器的规格详情和规格扩展信息,比如规格id、规格名称、cpu核数、启动源。

可以查询裸金属服务器网卡信息,比如网卡的ip地址、mac地址。

裸金属服务器云硬盘挂载、卸载,以及挂载的磁盘信息查询。

裸金属服务器元数据包含了裸金属服务器在云平台的基本信息,例如服务器id、主机名、网络信息等。您可以更新裸金属服务器的元数据。

查询某租户名下,所有资源的配额信息,包括已使用配额。

查询是否支持一键重置密码,如果支持,您可以对裸金属服务器重置密码。还包括windows裸金属服务器的密码获取与清除。

对于创建裸金属服务器、挂卸卷等异步api,命令下发后,会返回“job_id”,通过“job_id”可以查询任务的执行状态。

openstack原生接口(v2.1版本)

查询类接口,包括查询裸金属服务器详情、查询裸金属服务器列表、查询裸金属服务器详情信息列表。

状态管理接口,包括对裸金属服务器的启动、重启、关闭等接口。

裸金属服务器元数据包含了裸金属服务器在云平台的基本信息,例如服务器id、主机名、网络信息等。您可以查询、更新、删除裸金属服务器的元数据。

查询裸金属服务器的私有ip地址信息,包括ip地址版本(ipv4或者ipv6)和具体的ip地址。

  • :查询系统中的所有规格,或者指定过滤条件检索需要的规格。
  • :根据裸金属服务器的规格id,查询规格的详细信息,比如规格名称、cpu核数、内存大小等。
  • :“extra_specs”参数用于描述裸金属服务器规格的键值对,如果您想确认某个规格是否支持快速发放,可以调用该接口进行查询。

您可以查询裸金属服务器的所有网卡;或者根据网卡id,查询某一个网卡的详细信息,比如网卡的ip地址、mac地址。

您可以查询裸金属服务器所挂载的云硬盘信息;或者根据磁盘id,查询裸金属服务器挂载的某个云硬盘信息,比如挂载目录。

查询ssh密钥信息列表、详情,创建、删除ssh密钥等功能。

裸金属服务器一维标签的增删改查。

  • 使用bms提供的接口时,您需要使用bms服务自身的endpoint。
  • 使用openstack原生接口时,您需要使用ecs服务注册的endpoint。
  • 当前版本调用openstack接口不支持http长连接。

bms接口使用限制

表2 bms接口使用限制

类型

api

uri

使用限制

查询api版本信息

get /

每分钟2000次

get /{api_version}

每分钟2000次

生命周期管理

创建裸金属服务器

post /v1/{project_id}/baremetalservers

每分钟50次

get /v1/{project_id}/baremetalservers/detail

每分钟500次

get /v1/{project_id}/baremetalservers/{server_id}

每分钟1000次

状态管理

put /v1/{project_id}/baremetalservers/{server_id}

每分钟100次

post /v1/{project_id}/baremetalservers/{server_id}/reinstallos

每分钟50次

post /v1/{project_id}/baremetalservers/action

每分钟50次

post /v1/{project_id}/baremetalservers/action

每分钟50次

post /v1/{project_id}/baremetalservers/action

每分钟50次

规格管理

get /v1/{project_id}/baremetalservers/flavors

每分钟500次

网卡管理

get /v1/{project_id}/baremetalservers/{server_id}/os-interface

每分钟500次

云硬盘管理

post /v1/{project_id}/baremetalservers/{server_id}/attachvolume

每分钟100次

delete /v1/{project_id}/baremetalservers/{server_id}/detachvolume/{attachment_id}

每分钟100次

get /v1/{project_id}/baremetalservers/{server_id}/os-volume_attachments

每分钟500次

元数据管理

post /v1/{project_id}/baremetalservers/{server_id}/metadata

每分钟100次

租户配额管理

get /v1/{project_id}/baremetalservers/limits

每分钟500次

密码管理

get /v1/{project_id}/baremetalservers/{server_id}/os-resetpwd-flag

每分钟500次

put /v1/{project_id}/baremetalservers/{server_id}/os-reset-password

每分钟50次

get /v1/{project_id}/baremetalservers/{server_id}/os-server-password

每分钟50次

delete /v1/{project_id}/baremetalservers/{server_id}/os-server-password

每分钟50次

job管理

get /v1/{project_id}/jobs/{jobid}

每分钟2000次

分享:
网站地图