API Overview
API Introduction
BMS APIs (recommended) and Native OpenStack APIs are provided.
| Type | Function | Description |
|---|---|---|
| BMS APIs | Query the API version of the BMS service. | |
| Create yearly/monthly BMSs and query BMS details. | ||
| Change the BMS name, reinstall the BMS OS, start, restart, and stop BMSs. | ||
| Query BMS flavor details and extended flavor information, such as the flavor ID, flavor name, number of CPU cores, and boot device. | ||
| Query the BMS NIC information, such as the IP address and MAC address of the NIC. | ||
| Attach EVS disks to or detach EVS disks from a BMS, and query EVS disks attached to a BMS. | ||
| The BMS metadata includes BMS basic information on the cloud platform, such as the BMS ID, hostname, and network information. You can update the BMS metadata. | ||
| Query the quotas of all resources of a specified tenant, including used quotas. | ||
| Query whether one-click password reset is supported. If yes, you can reset the BMS password. Obtain and delete the password of a Windows BMS. | ||
| Ater an asynchronous API is called, for example an API for creating BMSs or attaching or detaching disks, job_id will be returned. You can use job_id to query the task status. | ||
| Native OpenStack v2.1 APIs | Query BMS details, query BMSs, and query details about BMSs. | |
| Start, restart, and stop BMSs. | ||
| The BMS metadata includes BMS basic information on the cloud platform, such as the BMS ID, hostname, and network information. You can query, update, and delete BMS metadata. | ||
| Query the private IP address of a BMS, including the IP address version (IPv4 or IPv6) and the specific IP address. | ||
| ||
| Query all NICs of a BMS or query details about a NIC based on the NIC ID, such as the IP address and MAC address of the NIC. | ||
| Query all EVS disks attached to a BMS or query details about an EVS disk attached to a BMS based on the disk ID, such as the mount directory. | ||
| Query SSH key pairs or details about an SSH key pair, and create and delete SSH key pairs. | ||
| Add, delete, modify, and query 1D tags of BMSs. |
- When using BMS APIs, you must use the endpoints of the BMS service.
- When using native OpenStack APIs, you must use the endpoints registered by the ECS service.
- In the current version, long HTTP connections cannot be used to call native OpenStack APIs.
BMS API Constraints
| Type | API | URI | Constraint |
|---|---|---|---|
| API version query | GET / | 2,000 requests per minute | |
| GET /{api_version} | 2,000 requests per minute | ||
| Lifecycle management | POST /v1/{project_id}/baremetalservers | 50 requests per minute | |
| GET /v1/{project_id}/baremetalservers/detail | 500 requests per minute | ||
| GET /v1/{project_id}/baremetalservers/{server_id} | 1,000 requests per minute | ||
| Status management | PUT /v1/{project_id}/baremetalservers/{server_id} | 100 requests per minute | |
| POST /v1/{project_id}/baremetalservers/{server_id}/reinstallos | 50 requests per minute | ||
| POST /v1/{project_id}/baremetalservers/action | 50 requests per minute | ||
| POST /v1/{project_id}/baremetalservers/action | 50 requests per minute | ||
| POST /v1/{project_id}/baremetalservers/action | 50 requests per minute | ||
| Flavor management | GET /v1/{project_id}/baremetalservers/flavors | 500 requests per minute | |
| NIC management | GET /v1/{project_id}/baremetalservers/{server_id}/os-interface | 500 requests per minute | |
| EVS disk management | POST /v1/{project_id}/baremetalservers/{server_id}/attachvolume | 100 requests per minute | |
| DELETE /v1/{project_id}/baremetalservers/{server_id}/detachvolume/{attachment_id} | 100 requests per minute | ||
| GET /v1/{project_id}/baremetalservers/{server_id}/os-volume_attachments | 500 requests per minute | ||
| Metadata management | POST /v1/{project_id}/baremetalservers/{server_id}/metadata | 100 requests per minute | |
| Tenant quota management | GET /v1/{project_id}/baremetalservers/limits | 500 requests per minute | |
| Password management | GET /v1/{project_id}/baremetalservers/{server_id}/os-resetpwd-flag | 500 requests per minute | |
| Resetting the BMS Password with a Few Clicks | - | - | |
| GET /v1/{project_id}/baremetalservers/{server_id}/os-server-password | 50 requests per minute | ||
| DELETE /v1/{project_id}/baremetalservers/{server_id}/os-server-password | 50 requests per minute | ||
| Task management | GET /v1/{project_id}/jobs/{jobId} | 2,000 requests per minute |
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.
