diff --git a/docs/bms/api-ref/.placeholder b/docs/bms/api-ref/.placeholder deleted file mode 100644 index e69de29bb..000000000 diff --git a/docs/bms/api-ref/ALL_META.TXT.json b/docs/bms/api-ref/ALL_META.TXT.json new file mode 100644 index 000000000..f68420567 --- /dev/null +++ b/docs/bms/api-ref/ALL_META.TXT.json @@ -0,0 +1,532 @@ +[ + { + "uri":"en-us_topic_0143138428.html", + "product_code":"bms", + "code":"1", + "des":"Public cloud APIs comply with the RESTful API design principles. REST-based web services are organized into resources. Each resource is identified by one or more Uniform ", + "doc_type":"api", + "kw":"API Usage Guidelines,API Reference", + "title":"API Usage Guidelines", + "githuburl":"" + }, + { + "uri":"en-us_topic_0171226370.html", + "product_code":"bms", + "code":"2", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"Native OpenStack Nova V2.1 APIs", + "title":"Native OpenStack Nova V2.1 APIs", + "githuburl":"" + }, + { + "uri":"en-us_topic_0171226371.html", + "product_code":"bms", + "code":"3", + "des":"BMS does not have independent endpoints. When API calls are made to the BMS service, ECS APIs are used. Therefore, ensure that you use the ECS service endpoints when you ", + "doc_type":"api", + "kw":"API Use Instructions,Native OpenStack Nova V2.1 APIs,API Reference", + "title":"API Use Instructions", + "githuburl":"" + }, + { + "uri":"en-us_topic_0134720581.html", + "product_code":"bms", + "code":"4", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"API Version Query", + "title":"API Version Query", + "githuburl":"" + }, + { + "uri":"en-us_topic_0134720582.html", + "product_code":"bms", + "code":"5", + "des":"This interface is used to query all available Nova versions.GET /Request parametersNoneNoneExample requestGET https://{ECS Endpoint}/Response parametersParameterTypeDescr", + "doc_type":"api", + "kw":"Querying API Versions (Native OpenStack API),API Version Query,API Reference", + "title":"Querying API Versions (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0134720583.html", + "product_code":"bms", + "code":"6", + "des":"This API is used to query a specified API version.GET /{api_version}Table 1 lists the parameters.Request parametersNoneNoneExample requestGET https://{ECS Endpoint}/v2Res", + "doc_type":"api", + "kw":"Querying an API Version (Native OpenStack API),API Version Query,API Reference", + "title":"Querying an API Version (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158680.html", + "product_code":"bms", + "code":"7", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"BMS Lifecycle Management", + "title":"BMS Lifecycle Management", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158682.html", + "product_code":"bms", + "code":"8", + "des":"This interface is used to create a BMS.This interface cannot be used to create BMSs in batches.When you create a BMS using an image that supports Cloud-Init or Cloudbase-", + "doc_type":"api", + "kw":"Creating a BMS (Native OpenStack API),BMS Lifecycle Management,API Reference", + "title":"Creating a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158713.html", + "product_code":"bms", + "code":"9", + "des":"This interface is used to delete a BMS.DELETE /v2.1/{project_id}/servers/{server_id}Table 1 lists the parameters.Request parametersNoneNoneExample requestDELETE https://{", + "doc_type":"api", + "kw":"Deleting a BMS (Native OpenStack API),BMS Lifecycle Management,API Reference", + "title":"Deleting a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158707.html", + "product_code":"bms", + "code":"10", + "des":"This API is used to query details about a BMS based on the BMS ID.GET /v2.1/{project_id}/servers/{server_id}Table 1 lists the parameters.Request parametersNoneNoneExample", + "doc_type":"api", + "kw":"Querying Details About a BMS (Native OpenStack API),BMS Lifecycle Management,API Reference", + "title":"Querying Details About a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158693.html", + "product_code":"bms", + "code":"11", + "des":"This API is used to query BMSs.The query result returned by this interface includes both ECSs and BMSs. You need to filter out the BMSs using the flavor used to create th", + "doc_type":"api", + "kw":"Querying BMSs (Native OpenStack API),BMS Lifecycle Management,API Reference", + "title":"Querying BMSs (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158679.html", + "product_code":"bms", + "code":"12", + "des":"This API is used to query details about BMSs.The query result returned by this interface includes both ECS and BMS details. You need to filter out the BMS details using t", + "doc_type":"api", + "kw":"Querying Details About BMSs (Native OpenStack API),BMS Lifecycle Management,API Reference", + "title":"Querying Details About BMSs (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158613.html", + "product_code":"bms", + "code":"13", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"BMS Status Management", + "title":"BMS Status Management", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158710.html", + "product_code":"bms", + "code":"14", + "des":"This interface is used to modify BMS information. Currently, only the name of the BMS can be changed.PUT /v2.1/{project_id}/servers/{server_id}Table 1 lists the parameter", + "doc_type":"api", + "kw":"Changing the Name of a BMS (Native OpenStack API),BMS Status Management,API Reference", + "title":"Changing the Name of a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158659.html", + "product_code":"bms", + "code":"15", + "des":"This API is used to start a single BMS.POST /v2.1/{project_id}/servers/{server_id}/actionTable 1 lists the parameters.Request parametersParameterMandatoryTypeDescriptiono", + "doc_type":"api", + "kw":"Starting a BMS (Native OpenStack API),BMS Status Management,API Reference", + "title":"Starting a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158716.html", + "product_code":"bms", + "code":"16", + "des":"This API is used to restart a single BMS.Currently, only forcible restart is supported.POST /v2.1/{project_id}/servers/{server_id}/actionTable 1 lists the parameters.Requ", + "doc_type":"api", + "kw":"Restarting a BMS (Native OpenStack API),BMS Status Management,API Reference", + "title":"Restarting a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158685.html", + "product_code":"bms", + "code":"17", + "des":"This API is used to stop a single BMS.The BMS OS-EXT-STS:vm_state attribute (BMS status) must be active or error.Currently, only forcible stopping is supported.POST /v2.1", + "doc_type":"api", + "kw":"Stopping a BMS (Native OpenStack API),BMS Status Management,API Reference", + "title":"Stopping a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0173933989.html", + "product_code":"bms", + "code":"18", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"BMS Metadata Management", + "title":"BMS Metadata Management", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060402469.html", + "product_code":"bms", + "code":"19", + "des":"The BMS metadata includes BMS basic information on the cloud platform, such as the BMS ID, hostname, and network information. This API is used to query the BMS metadata.P", + "doc_type":"api", + "kw":"Querying BMS Metadata (Native OpenStack API),BMS Metadata Management,API Reference", + "title":"Querying BMS Metadata (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158712.html", + "product_code":"bms", + "code":"20", + "des":"This API is used to update BMS metadata.If the metadata does not contain the target field, the field is automatically added to the field.If the metadata contains the targ", + "doc_type":"api", + "kw":"Updating BMS Metadata (Native OpenStack API),BMS Metadata Management,API Reference", + "title":"Updating BMS Metadata (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158695.html", + "product_code":"bms", + "code":"21", + "des":"This API is used to modify specified BMS metadata.The BMS OS-EXT-STS:vm_state attribute (BMS status) must be active, stopped, paused, or suspended.PUT /v2.1/{project_id}/", + "doc_type":"api", + "kw":"Modifying Specified BMS Metadata (Native OpenStack API),BMS Metadata Management,API Reference", + "title":"Modifying Specified BMS Metadata (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158683.html", + "product_code":"bms", + "code":"22", + "des":"This API is used to delete specified BMS metadata.The BMS OS-EXT-STS:vm_state attribute (BMS status) must be active, stopped, paused, or suspended.DELETE /v2.1/{project_i", + "doc_type":"api", + "kw":"Deleting Specified BMS Metadata (Native OpenStack API),BMS Metadata Management,API Reference", + "title":"Deleting Specified BMS Metadata (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158688.html", + "product_code":"bms", + "code":"23", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"BMS IP Address Query", + "title":"BMS IP Address Query", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158696.html", + "product_code":"bms", + "code":"24", + "des":"This API is used to query private IP addresses of a BMS.Pagination query is not supported.GET /v2.1/{project_id}/servers/{server_id}/ipsTable 1 lists the parameters.Reque", + "doc_type":"api", + "kw":"Querying IP Addresses of a BMS (Native OpenStack API),BMS IP Address Query,API Reference", + "title":"Querying IP Addresses of a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158662.html", + "product_code":"bms", + "code":"25", + "des":"This API is used to query the specified IP address of a BMS based on the network name.GET /v2.1/{project_id}/servers/{server_id}/ips/{vpc_id}Table 1 lists the parameters.", + "doc_type":"api", + "kw":"Querying the Specified IP Address of a BMS (Native OpenStack API),BMS IP Address Query,API Reference", + "title":"Querying the Specified IP Address of a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158668.html", + "product_code":"bms", + "code":"26", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"BMS Flavor Query", + "title":"BMS Flavor Query", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158684.html", + "product_code":"bms", + "code":"27", + "des":"This API is used to query BMS flavors.The flavors you obtained using this API are all the flavors in the system. The flavors whose names starting with physical are BMS fl", + "doc_type":"api", + "kw":"Querying BMS Flavors (Native OpenStack API),BMS Flavor Query,API Reference", + "title":"Querying BMS Flavors (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158674.html", + "product_code":"bms", + "code":"28", + "des":"This API is used to query details about a BMS flavor, such as the flavor name, CPU cores, and memory.GET /v2.1/{project_id}/flavors/{flavor_id}Table 1 lists the parameter", + "doc_type":"api", + "kw":"Querying Details About a BMS Flavor (Native OpenStack API),BMS Flavor Query,API Reference", + "title":"Querying Details About a BMS Flavor (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0114885743.html", + "product_code":"bms", + "code":"29", + "des":"extra_specs parameters specify the key-value pair of a BMS flavor. For example, baremetal:extBootType specifies the boot device of the BMS. Its value can be LocalDisk (lo", + "doc_type":"api", + "kw":"Querying Details About extra_specs Parameters of a BMS Flavor (Native OpenStack API),BMS Flavor Quer", + "title":"Querying Details About extra_specs Parameters of a BMS Flavor (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158711.html", + "product_code":"bms", + "code":"30", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"BMS NIC Management", + "title":"BMS NIC Management", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158678.html", + "product_code":"bms", + "code":"31", + "des":"This API is used to query information about BMS NICs, such as the MAC addresses and private IP addresses.GET /v2.1/{project_id}/servers/{server_id}/os-interfaceTable 1 li", + "doc_type":"api", + "kw":"Querying Information About BMS NICs (Native OpenStack API),BMS NIC Management,API Reference", + "title":"Querying Information About BMS NICs (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158687.html", + "product_code":"bms", + "code":"32", + "des":"This API is used to query information about a specified BMS NIC based on the NIC ID.GET /v2.1/{project_id}/servers/{server_id}/os-interface/{id}Table 1 lists the paramete", + "doc_type":"api", + "kw":"Querying Information About a Specified BMS NIC (Native OpenStack API),BMS NIC Management,API Referen", + "title":"Querying Information About a Specified BMS NIC (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158703.html", + "product_code":"bms", + "code":"33", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"BMS Disk Management", + "title":"BMS Disk Management", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158658.html", + "product_code":"bms", + "code":"34", + "des":"This API is used to query information about the EVS disks attached to a BMS.GET /v2.1/{project_id}/servers/{server_id}/os-volume_attachmentsTable 1 lists the parameters.R", + "doc_type":"api", + "kw":"Querying Information About the Disks Attached to a BMS (Native OpenStack API),BMS Disk Management,AP", + "title":"Querying Information About the Disks Attached to a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158665.html", + "product_code":"bms", + "code":"35", + "des":"This API is used to query information about a single disk attached to a BMS based on the disk ID.GET /v2.1/{project_id}/servers/{server_id}/os-volume_attachments/{volume_", + "doc_type":"api", + "kw":"Querying Information About a Disk Attached to a BMS (Native OpenStack API),BMS Disk Management,API R", + "title":"Querying Information About a Disk Attached to a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158614.html", + "product_code":"bms", + "code":"36", + "des":"This API is used to attach an EVS disk to a BMS.A bootable disk cannot be attached to a BMS.A disk cannot be attached to a BMS when the BMS is in the SUSPENDED or PAUSED ", + "doc_type":"api", + "kw":"Attaching an EVS Disk to a BMS (Native OpenStack API),BMS Disk Management,API Reference", + "title":"Attaching an EVS Disk to a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158611.html", + "product_code":"bms", + "code":"37", + "des":"This API is used to detach an EVS disk from a BMS.If a BMS is stopped, disks can be detached from it without any limitation on the OS. If a BMS is in running state, the c", + "doc_type":"api", + "kw":"Detaching an EVS Disk from a BMS (Native OpenStack API),BMS Disk Management,API Reference", + "title":"Detaching an EVS Disk from a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060384657.html", + "product_code":"bms", + "code":"38", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"BMS SSH Key Pair Management", + "title":"BMS SSH Key Pair Management", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060384658.html", + "product_code":"bms", + "code":"39", + "des":"This interface is used to query SSH key pairs and to display the query results in a list.Pagination query is not supported.GET /v2.1/{project_id}/os-keypairsTable 1 lists", + "doc_type":"api", + "kw":"Querying SSH Key Pairs (Native OpenStack API),BMS SSH Key Pair Management,API Reference", + "title":"Querying SSH Key Pairs (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060384659.html", + "product_code":"bms", + "code":"40", + "des":"This interface is used to query a specified SSH key pair based on the key pair name.GET /v2.1/{project_id}/os-keypairs/{keypair_name}Table 1 lists the parameters.Request ", + "doc_type":"api", + "kw":"Querying an SSH Key Pair (Native OpenStack API),BMS SSH Key Pair Management,API Reference", + "title":"Querying an SSH Key Pair (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060384660.html", + "product_code":"bms", + "code":"41", + "des":"This interface is used to create an SSH key pair or import a public key to generate a key pair.After an SSH key is created, download the private key to a local directory.", + "doc_type":"api", + "kw":"Creating and Importing an SSH Key Pair (Native OpenStack API),BMS SSH Key Pair Management,API Refere", + "title":"Creating and Importing an SSH Key Pair (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060384661.html", + "product_code":"bms", + "code":"42", + "des":"This interface is used to delete a specified SSH key pair based on the key pair name.DELETE /v2.1/{project_id}/os-keypairs/{keypair_name}Table 1 lists the parameters.Requ", + "doc_type":"api", + "kw":"Deleting an SSH Key Pair (Native OpenStack API),BMS SSH Key Pair Management,API Reference", + "title":"Deleting an SSH Key Pair (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060410925.html", + "product_code":"bms", + "code":"43", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"BMS 1D Tag Management", + "title":"BMS 1D Tag Management", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060410926.html", + "product_code":"bms", + "code":"44", + "des":"This API is used to query all tags of a BMS.You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.GET /v2.", + "doc_type":"api", + "kw":"Querying BMS Tags (Native OpenStack API),BMS 1D Tag Management,API Reference", + "title":"Querying BMS Tags (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060410927.html", + "product_code":"bms", + "code":"45", + "des":"This API is used to add tags to a BMS.You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.A BMS can have", + "doc_type":"api", + "kw":"Adding Tags to a BMS (Native OpenStack API),BMS 1D Tag Management,API Reference", + "title":"Adding Tags to a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060410928.html", + "product_code":"bms", + "code":"46", + "des":"This API is used to delete all tags of a BMS.You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.Tag __t", + "doc_type":"api", + "kw":"Deleting Tags of a BMS (Native OpenStack API),BMS 1D Tag Management,API Reference", + "title":"Deleting Tags of a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060410929.html", + "product_code":"bms", + "code":"47", + "des":"This API is used to add a tag to a BMS.You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.A BMS can hav", + "doc_type":"api", + "kw":"Adding a Tag to a BMS (Native OpenStack API),BMS 1D Tag Management,API Reference", + "title":"Adding a Tag to a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060410930.html", + "product_code":"bms", + "code":"48", + "des":"This API is used to check whether a BMS has a specified tag.You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the", + "doc_type":"api", + "kw":"Checking for Tags of a BMS (Native OpenStack API),BMS 1D Tag Management,API Reference", + "title":"Checking for Tags of a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060424486.html", + "product_code":"bms", + "code":"49", + "des":"This API is used to delete a tag of a BMS.You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.The tag co", + "doc_type":"api", + "kw":"Deleting a Tag of a BMS (Native OpenStack API),BMS 1D Tag Management,API Reference", + "title":"Deleting a Tag of a BMS (Native OpenStack API)", + "githuburl":"" + }, + { + "uri":"en-us_topic_0060323087.html", + "product_code":"bms", + "code":"50", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"Public Parameters", + "title":"Public Parameters", + "githuburl":"" + }, + { + "uri":"en-us_topic_0053158690.html", + "product_code":"bms", + "code":"51", + "des":"NormalReturned ValueDescription200 OKThe request has been successfully processed.201 CreatedThe request has been successfully processed and a resource has been created.20", + "doc_type":"api", + "kw":"Status Codes,Public Parameters,API Reference", + "title":"Status Codes", + "githuburl":"" + }, + { + "uri":"en-us_topic_0107541808.html", + "product_code":"bms", + "code":"52", + "des":"An error code returned by an API does not correspond to one error message. The following table lists only common error messages.Most BMS APIs are asynchronous. Some error", + "doc_type":"api", + "kw":"Error Codes,Public Parameters,API Reference", + "title":"Error Codes", + "githuburl":"" + }, + { + "uri":"en-us_topic_0131054288.html", + "product_code":"bms", + "code":"53", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"Change History,API Reference", + "title":"Change History", + "githuburl":"" + } +] \ No newline at end of file diff --git a/docs/bms/api-ref/CLASS.TXT.json b/docs/bms/api-ref/CLASS.TXT.json new file mode 100644 index 000000000..efe67c7d0 --- /dev/null +++ b/docs/bms/api-ref/CLASS.TXT.json @@ -0,0 +1,479 @@ +[ + { + "desc":"Public cloud APIs comply with the RESTful API design principles. REST-based web services are organized into resources. Each resource is identified by one or more Uniform ", + "product_code":"bms", + "title":"API Usage Guidelines", + "uri":"en-us_topic_0143138428.html", + "doc_type":"api", + "p_code":"", + "code":"1" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"bms", + "title":"Native OpenStack Nova V2.1 APIs", + "uri":"en-us_topic_0171226370.html", + "doc_type":"api", + "p_code":"", + "code":"2" + }, + { + "desc":"BMS does not have independent endpoints. When API calls are made to the BMS service, ECS APIs are used. Therefore, ensure that you use the ECS service endpoints when you ", + "product_code":"bms", + "title":"API Use Instructions", + "uri":"en-us_topic_0171226371.html", + "doc_type":"api", + "p_code":"2", + "code":"3" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"bms", + "title":"API Version Query", + "uri":"en-us_topic_0134720581.html", + "doc_type":"api", + "p_code":"2", + "code":"4" + }, + { + "desc":"This interface is used to query all available Nova versions.GET /Request parametersNoneNoneExample requestGET https://{ECS Endpoint}/Response parametersParameterTypeDescr", + "product_code":"bms", + "title":"Querying API Versions (Native OpenStack API)", + "uri":"en-us_topic_0134720582.html", + "doc_type":"api", + "p_code":"4", + "code":"5" + }, + { + "desc":"This API is used to query a specified API version.GET /{api_version}Table 1 lists the parameters.Request parametersNoneNoneExample requestGET https://{ECS Endpoint}/v2Res", + "product_code":"bms", + "title":"Querying an API Version (Native OpenStack API)", + "uri":"en-us_topic_0134720583.html", + "doc_type":"api", + "p_code":"4", + "code":"6" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"bms", + "title":"BMS Lifecycle Management", + "uri":"en-us_topic_0053158680.html", + "doc_type":"api", + "p_code":"2", + "code":"7" + }, + { + "desc":"This interface is used to create a BMS.This interface cannot be used to create BMSs in batches.When you create a BMS using an image that supports Cloud-Init or Cloudbase-", + "product_code":"bms", + "title":"Creating a BMS (Native OpenStack API)", + "uri":"en-us_topic_0053158682.html", + "doc_type":"api", + "p_code":"7", + "code":"8" + }, + { + "desc":"This interface is used to delete a BMS.DELETE /v2.1/{project_id}/servers/{server_id}Table 1 lists the parameters.Request parametersNoneNoneExample requestDELETE https://{", + "product_code":"bms", + "title":"Deleting a BMS (Native OpenStack API)", + "uri":"en-us_topic_0053158713.html", + "doc_type":"api", + "p_code":"7", + "code":"9" + }, + { + "desc":"This API is used to query details about a BMS based on the BMS ID.GET /v2.1/{project_id}/servers/{server_id}Table 1 lists the parameters.Request parametersNoneNoneExample", + "product_code":"bms", + "title":"Querying Details About a BMS (Native OpenStack API)", + "uri":"en-us_topic_0053158707.html", + "doc_type":"api", + "p_code":"7", + "code":"10" + }, + { + "desc":"This API is used to query BMSs.The query result returned by this interface includes both ECSs and BMSs. You need to filter out the BMSs using the flavor used to create th", + "product_code":"bms", + "title":"Querying BMSs (Native OpenStack API)", + "uri":"en-us_topic_0053158693.html", + "doc_type":"api", + "p_code":"7", + "code":"11" + }, + { + "desc":"This API is used to query details about BMSs.The query result returned by this interface includes both ECS and BMS details. You need to filter out the BMS details using t", + "product_code":"bms", + "title":"Querying Details About BMSs (Native OpenStack API)", + "uri":"en-us_topic_0053158679.html", + "doc_type":"api", + "p_code":"7", + "code":"12" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"bms", + "title":"BMS Status Management", + "uri":"en-us_topic_0053158613.html", + "doc_type":"api", + "p_code":"2", + "code":"13" + }, + { + "desc":"This interface is used to modify BMS information. Currently, only the name of the BMS can be changed.PUT /v2.1/{project_id}/servers/{server_id}Table 1 lists the parameter", + "product_code":"bms", + "title":"Changing the Name of a BMS (Native OpenStack API)", + "uri":"en-us_topic_0053158710.html", + "doc_type":"api", + "p_code":"13", + "code":"14" + }, + { + "desc":"This API is used to start a single BMS.POST /v2.1/{project_id}/servers/{server_id}/actionTable 1 lists the parameters.Request parametersParameterMandatoryTypeDescriptiono", + "product_code":"bms", + "title":"Starting a BMS (Native OpenStack API)", + "uri":"en-us_topic_0053158659.html", + "doc_type":"api", + "p_code":"13", + "code":"15" + }, + { + "desc":"This API is used to restart a single BMS.Currently, only forcible restart is supported.POST /v2.1/{project_id}/servers/{server_id}/actionTable 1 lists the parameters.Requ", + "product_code":"bms", + "title":"Restarting a BMS (Native OpenStack API)", + "uri":"en-us_topic_0053158716.html", + "doc_type":"api", + "p_code":"13", + "code":"16" + }, + { + "desc":"This API is used to stop a single BMS.The BMS OS-EXT-STS:vm_state attribute (BMS status) must be active or error.Currently, only forcible stopping is supported.POST /v2.1", + "product_code":"bms", + "title":"Stopping a BMS (Native OpenStack API)", + "uri":"en-us_topic_0053158685.html", + "doc_type":"api", + "p_code":"13", + "code":"17" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"bms", + "title":"BMS Metadata Management", + "uri":"en-us_topic_0173933989.html", + "doc_type":"api", + "p_code":"2", + "code":"18" + }, + { + "desc":"The BMS metadata includes BMS basic information on the cloud platform, such as the BMS ID, hostname, and network information. This API is used to query the BMS metadata.P", + "product_code":"bms", + "title":"Querying BMS Metadata (Native OpenStack API)", + "uri":"en-us_topic_0060402469.html", + "doc_type":"api", + "p_code":"18", + "code":"19" + }, + { + "desc":"This API is used to update BMS metadata.If the metadata does not contain the target field, the field is automatically added to the field.If the metadata contains the targ", + "product_code":"bms", + "title":"Updating BMS Metadata (Native OpenStack API)", + "uri":"en-us_topic_0053158712.html", + "doc_type":"api", + "p_code":"18", + "code":"20" + }, + { + "desc":"This API is used to modify specified BMS metadata.The BMS OS-EXT-STS:vm_state attribute (BMS status) must be active, stopped, paused, or suspended.PUT /v2.1/{project_id}/", + "product_code":"bms", + "title":"Modifying Specified BMS Metadata (Native OpenStack API)", + "uri":"en-us_topic_0053158695.html", + "doc_type":"api", + "p_code":"18", + "code":"21" + }, + { + "desc":"This API is used to delete specified BMS metadata.The BMS OS-EXT-STS:vm_state attribute (BMS status) must be active, stopped, paused, or suspended.DELETE /v2.1/{project_i", + "product_code":"bms", + "title":"Deleting Specified BMS Metadata (Native OpenStack API)", + "uri":"en-us_topic_0053158683.html", + "doc_type":"api", + "p_code":"18", + "code":"22" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"bms", + "title":"BMS IP Address Query", + "uri":"en-us_topic_0053158688.html", + "doc_type":"api", + "p_code":"2", + "code":"23" + }, + { + "desc":"This API is used to query private IP addresses of a BMS.Pagination query is not supported.GET /v2.1/{project_id}/servers/{server_id}/ipsTable 1 lists the parameters.Reque", + "product_code":"bms", + "title":"Querying IP Addresses of a BMS (Native OpenStack API)", + "uri":"en-us_topic_0053158696.html", + "doc_type":"api", + "p_code":"23", + "code":"24" + }, + { + "desc":"This API is used to query the specified IP address of a BMS based on the network name.GET /v2.1/{project_id}/servers/{server_id}/ips/{vpc_id}Table 1 lists the parameters.", + "product_code":"bms", + "title":"Querying the Specified IP Address of a BMS (Native OpenStack API)", + "uri":"en-us_topic_0053158662.html", + "doc_type":"api", + "p_code":"23", + "code":"25" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"bms", + "title":"BMS Flavor Query", + "uri":"en-us_topic_0053158668.html", + "doc_type":"api", + "p_code":"2", + "code":"26" + }, + { + "desc":"This API is used to query BMS flavors.The flavors you obtained using this API are all the flavors in the system. The flavors whose names starting with physical are BMS fl", + "product_code":"bms", + "title":"Querying BMS Flavors (Native OpenStack API)", + "uri":"en-us_topic_0053158684.html", + "doc_type":"api", + "p_code":"26", + "code":"27" + }, + { + "desc":"This API is used to query details about a BMS flavor, such as the flavor name, CPU cores, and memory.GET /v2.1/{project_id}/flavors/{flavor_id}Table 1 lists the parameter", + "product_code":"bms", + "title":"Querying Details About a BMS Flavor (Native OpenStack API)", + "uri":"en-us_topic_0053158674.html", + "doc_type":"api", + "p_code":"26", + "code":"28" + }, + { + "desc":"extra_specs parameters specify the key-value pair of a BMS flavor. For example, baremetal:extBootType specifies the boot device of the BMS. Its value can be LocalDisk (lo", + "product_code":"bms", + "title":"Querying Details About extra_specs Parameters of a BMS Flavor (Native OpenStack API)", + "uri":"en-us_topic_0114885743.html", + "doc_type":"api", + "p_code":"26", + "code":"29" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"bms", + "title":"BMS NIC Management", + "uri":"en-us_topic_0053158711.html", + "doc_type":"api", + "p_code":"2", + "code":"30" + }, + { + "desc":"This API is used to query information about BMS NICs, such as the MAC addresses and private IP addresses.GET /v2.1/{project_id}/servers/{server_id}/os-interfaceTable 1 li", + "product_code":"bms", + "title":"Querying Information About BMS NICs (Native OpenStack API)", + "uri":"en-us_topic_0053158678.html", + "doc_type":"api", + "p_code":"30", + "code":"31" + }, + { + "desc":"This API is used to query information about a specified BMS NIC based on the NIC ID.GET /v2.1/{project_id}/servers/{server_id}/os-interface/{id}Table 1 lists the paramete", + "product_code":"bms", + "title":"Querying Information About a Specified BMS NIC (Native OpenStack API)", + "uri":"en-us_topic_0053158687.html", + "doc_type":"api", + "p_code":"30", + "code":"32" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"bms", + "title":"BMS Disk Management", + "uri":"en-us_topic_0053158703.html", + "doc_type":"api", + "p_code":"2", + "code":"33" + }, + { + "desc":"This API is used to query information about the EVS disks attached to a BMS.GET /v2.1/{project_id}/servers/{server_id}/os-volume_attachmentsTable 1 lists the parameters.R", + "product_code":"bms", + "title":"Querying Information About the Disks Attached to a BMS (Native OpenStack API)", + "uri":"en-us_topic_0053158658.html", + "doc_type":"api", + "p_code":"33", + "code":"34" + }, + { + "desc":"This API is used to query information about a single disk attached to a BMS based on the disk ID.GET /v2.1/{project_id}/servers/{server_id}/os-volume_attachments/{volume_", + "product_code":"bms", + "title":"Querying Information About a Disk Attached to a BMS (Native OpenStack API)", + "uri":"en-us_topic_0053158665.html", + "doc_type":"api", + "p_code":"33", + "code":"35" + }, + { + "desc":"This API is used to attach an EVS disk to a BMS.A bootable disk cannot be attached to a BMS.A disk cannot be attached to a BMS when the BMS is in the SUSPENDED or PAUSED ", + "product_code":"bms", + "title":"Attaching an EVS Disk to a BMS (Native OpenStack API)", + "uri":"en-us_topic_0053158614.html", + "doc_type":"api", + "p_code":"33", + "code":"36" + }, + { + "desc":"This API is used to detach an EVS disk from a BMS.If a BMS is stopped, disks can be detached from it without any limitation on the OS. If a BMS is in running state, the c", + "product_code":"bms", + "title":"Detaching an EVS Disk from a BMS (Native OpenStack API)", + "uri":"en-us_topic_0053158611.html", + "doc_type":"api", + "p_code":"33", + "code":"37" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"bms", + "title":"BMS SSH Key Pair Management", + "uri":"en-us_topic_0060384657.html", + "doc_type":"api", + "p_code":"2", + "code":"38" + }, + { + "desc":"This interface is used to query SSH key pairs and to display the query results in a list.Pagination query is not supported.GET /v2.1/{project_id}/os-keypairsTable 1 lists", + "product_code":"bms", + "title":"Querying SSH Key Pairs (Native OpenStack API)", + "uri":"en-us_topic_0060384658.html", + "doc_type":"api", + "p_code":"38", + "code":"39" + }, + { + "desc":"This interface is used to query a specified SSH key pair based on the key pair name.GET /v2.1/{project_id}/os-keypairs/{keypair_name}Table 1 lists the parameters.Request ", + "product_code":"bms", + "title":"Querying an SSH Key Pair (Native OpenStack API)", + "uri":"en-us_topic_0060384659.html", + "doc_type":"api", + "p_code":"38", + "code":"40" + }, + { + "desc":"This interface is used to create an SSH key pair or import a public key to generate a key pair.After an SSH key is created, download the private key to a local directory.", + "product_code":"bms", + "title":"Creating and Importing an SSH Key Pair (Native OpenStack API)", + "uri":"en-us_topic_0060384660.html", + "doc_type":"api", + "p_code":"38", + "code":"41" + }, + { + "desc":"This interface is used to delete a specified SSH key pair based on the key pair name.DELETE /v2.1/{project_id}/os-keypairs/{keypair_name}Table 1 lists the parameters.Requ", + "product_code":"bms", + "title":"Deleting an SSH Key Pair (Native OpenStack API)", + "uri":"en-us_topic_0060384661.html", + "doc_type":"api", + "p_code":"38", + "code":"42" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"bms", + "title":"BMS 1D Tag Management", + "uri":"en-us_topic_0060410925.html", + "doc_type":"api", + "p_code":"2", + "code":"43" + }, + { + "desc":"This API is used to query all tags of a BMS.You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.GET /v2.", + "product_code":"bms", + "title":"Querying BMS Tags (Native OpenStack API)", + "uri":"en-us_topic_0060410926.html", + "doc_type":"api", + "p_code":"43", + "code":"44" + }, + { + "desc":"This API is used to add tags to a BMS.You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.A BMS can have", + "product_code":"bms", + "title":"Adding Tags to a BMS (Native OpenStack API)", + "uri":"en-us_topic_0060410927.html", + "doc_type":"api", + "p_code":"43", + "code":"45" + }, + { + "desc":"This API is used to delete all tags of a BMS.You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.Tag __t", + "product_code":"bms", + "title":"Deleting Tags of a BMS (Native OpenStack API)", + "uri":"en-us_topic_0060410928.html", + "doc_type":"api", + "p_code":"43", + "code":"46" + }, + { + "desc":"This API is used to add a tag to a BMS.You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.A BMS can hav", + "product_code":"bms", + "title":"Adding a Tag to a BMS (Native OpenStack API)", + "uri":"en-us_topic_0060410929.html", + "doc_type":"api", + "p_code":"43", + "code":"47" + }, + { + "desc":"This API is used to check whether a BMS has a specified tag.You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the", + "product_code":"bms", + "title":"Checking for Tags of a BMS (Native OpenStack API)", + "uri":"en-us_topic_0060410930.html", + "doc_type":"api", + "p_code":"43", + "code":"48" + }, + { + "desc":"This API is used to delete a tag of a BMS.You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.The tag co", + "product_code":"bms", + "title":"Deleting a Tag of a BMS (Native OpenStack API)", + "uri":"en-us_topic_0060424486.html", + "doc_type":"api", + "p_code":"43", + "code":"49" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"bms", + "title":"Public Parameters", + "uri":"en-us_topic_0060323087.html", + "doc_type":"api", + "p_code":"", + "code":"50" + }, + { + "desc":"NormalReturned ValueDescription200 OKThe request has been successfully processed.201 CreatedThe request has been successfully processed and a resource has been created.20", + "product_code":"bms", + "title":"Status Codes", + "uri":"en-us_topic_0053158690.html", + "doc_type":"api", + "p_code":"50", + "code":"51" + }, + { + "desc":"An error code returned by an API does not correspond to one error message. The following table lists only common error messages.Most BMS APIs are asynchronous. Some error", + "product_code":"bms", + "title":"Error Codes", + "uri":"en-us_topic_0107541808.html", + "doc_type":"api", + "p_code":"50", + "code":"52" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"bms", + "title":"Change History", + "uri":"en-us_topic_0131054288.html", + "doc_type":"api", + "p_code":"", + "code":"53" + } +] \ No newline at end of file diff --git a/docs/bms/api-ref/PARAMETERS.txt b/docs/bms/api-ref/PARAMETERS.txt new file mode 100644 index 000000000..6da8d5f07 --- /dev/null +++ b/docs/bms/api-ref/PARAMETERS.txt @@ -0,0 +1,3 @@ +version="" +language="en-us" +type="" \ No newline at end of file diff --git a/docs/bms/api-ref/en-us_topic_0053158611.html b/docs/bms/api-ref/en-us_topic_0053158611.html new file mode 100644 index 000000000..28a5d98b4 --- /dev/null +++ b/docs/bms/api-ref/en-us_topic_0053158611.html @@ -0,0 +1,82 @@ + + +
This API is used to detach an EVS disk from a BMS.
+If a BMS is stopped, disks can be detached from it without any limitation on the OS. If a BMS is in running state, the constraints are as follows:
+DELETE /v2.1/{project_id}/servers/{server_id}/os-volume_attachments/{volume_id}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
volume_id + |
+Yes + |
+Specifies the EVS disk ID. +You can query attached EVS disks attached to a BMS using the Querying Information About the Disks Attached to a BMS (Native OpenStack API) API. + |
+
N/A
+Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to attach an EVS disk to a BMS.
+POST /v2.1/{project_id}/servers/{server_id}/os-volume_attachments
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
volumeAttachment + |
+Yes + |
+Object + |
+Specifies the disks to be attached. For details, see Table 2. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
volumeId + |
+Yes + |
+String + |
+Specifies the ID of the disk to be attached to a BMS. + |
+
device + |
+No + |
+String + |
+Specifies the mount point, such as /dev/sda and /dev/sdb. +The new disk mount point cannot be the same as an existing one. +The mount point must be specified based on the sequence of existing device names. Otherwise, the system automatically generates a mount point. + |
+
1 | POST https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/os-volume_attachments
+ |
1 +2 +3 +4 +5 +6 | {
+ "volumeAttachment": {
+ "volumeId": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6",
+ "device": "/dev/sdb"
+ }
+}
+ |
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
volumeAttachment + |
+Object + |
+Specifies the disks attached to a BMS. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
device + |
+String + |
+Specifies the device name, for example, /dev/vdb. + |
+
serverId + |
+String + |
+Specifies the ID of the BMS to which the disk is to be attached. The ID is in UUID format. + |
+
id + |
+String + |
+Specifies the disk UUID. + |
+
volumeId + |
+String + |
+Specifies the attaching ID, which is the same as the UUID. + |
+
1 +2 +3 +4 +5 +6 +7 +8 | {
+ "volumeAttachment": {
+ "id": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6",
+ "volumeId": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6",
+ "serverId": "820abbd0-2d8e-4bc5-ae46-69cacfd4fbaa",
+ "device": "/dev/vdb"
+ }
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to query information about the EVS disks attached to a BMS.
+GET /v2.1/{project_id}/servers/{server_id}/os-volume_attachments
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
volumeAttachments + |
+Object + |
+Specifies information about the disks attached to the BMS. For details, see Table 2. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
device + |
+String + |
+Specifies the mount directory, for example, /dev/vdb. + |
+
id + |
+String + |
+Specifies the ID of the attached resource. + |
+
serverId + |
+String + |
+Specifies the ID of the BMS to which the disks are attached. + |
+
volumeId + |
+String + |
+Specifies the IDs of the EVS disks attached to the BMS. + |
+
1 +2 +3 +4 +5 +6 +7 +8 | {
+ "volumeAttachment": {
+ "device": "/dev/vdb",
+ "serverId": "820abbd0-2d8e-4bc5-ae46-69cacfd4fbaa",
+ "id": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6",
+ "volumeId": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6"
+ }
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to start a single BMS.
+POST /v2.1/{project_id}/servers/{server_id}/action
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
os-start + |
+Yes + |
+null + |
+Specifies the operation of starting the BMS. The data structure is empty. + |
+
1 | POST https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/action
+ |
1 +2 +3 | {
+ "os-start": {}
+ }
+ |
N/A
+Returned Values + |
+Description + |
+
|---|---|
204 + |
+The server has processed the request but did not return any content. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to query the specified IP address of a BMS based on the network name.
+GET /v2.1/{project_id}/servers/{server_id}/ips/{vpc_id}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
vpc_id + |
+Yes + |
+Specifies the ID of the VPC where the BMS is located. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
VPC where the BMS is located + |
+Array of objects + |
+Specifies the ID of the VPC where the BMS is located. For details about the format, see Table 2. + |
+
1 +2 +3 +4 +5 +6 +7 +8 | {
+ "5849fdf1-9d79-4589-80c2-fe557990c417": [
+ {
+ "version": 4,
+ "addr": "192.168.1.159"
+ }
+ ]
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to query information about a single disk attached to a BMS based on the disk ID.
+GET /v2.1/{project_id}/servers/{server_id}/os-volume_attachments/{volume_id}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
volume_id + |
+Yes + |
+Specifies the EVS disk ID. +You can query attached EVS disks attached to a BMS using the Querying Information About the Disks Attached to a BMS (Native OpenStack API) API. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
volumeAttachment + |
+Object + |
+Specifies information about the disk attached to the BMS. For details, see Table 2. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
device + |
+String + |
+Specifies the mount directory, for example, /dev/vdb. + |
+
id + |
+String + |
+Specifies the ID of the attached resource. + |
+
serverId + |
+String + |
+Specifies the ID of the BMS to which the disks are attached. + |
+
volumeId + |
+String + |
+Specifies the ID of the disk attached to the BMS. + |
+
1 +2 +3 +4 +5 +6 +7 +8 | {
+ "volumeAttachment": {
+ "device": "/dev/vdb",
+ "serverId": "820abbd0-2d8e-4bc5-ae46-69cacfd4fbaa",
+ "id": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6",
+ "volumeId": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6"
+ }
+ }
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to query details about a BMS flavor, such as the flavor name, CPU cores, and memory.
+GET /v2.1/{project_id}/flavors/{flavor_id}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
flavor_id + |
+Yes + |
+Specifies the flavor ID. +You can obtain the flavor ID from the BMS console or using the Querying BMS Flavors (Native OpenStack API) API. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
flavor + |
+Object + |
+Specifies the BMS flavor. For details, see Table 2. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the BMS flavor ID. + |
+
name + |
+String + |
+Specifies the BMS flavor name. + |
+
vcpus + |
+Integer + |
+Specifies the number of CPU cores in the BMS flavor. + |
+
ram + |
+Integer + |
+Specifies the memory size (MB) in the BMS flavor. + |
+
disk + |
+Integer + |
+Specifies the disk size (GB) in the BMS flavor. + |
+
swap + |
+String + |
+This is a reserved attribute. + |
+
OS-FLV-EXT-DATA:ephemeral + |
+Integer + |
+This is a reserved attribute. + |
+
OS-FLV-DISABLED:disabled + |
+Boolean + |
+This is a reserved attribute. + |
+
rxtx_factor + |
+Float + |
+This is a reserved attribute. + |
+
os-flavor-access:is_public + |
+Boolean + |
+This is a reserved attribute. + |
+
links + |
+Array of objects + |
+Specifies shortcut links of the BMS flavor. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
rel + |
+String + |
+Specifies the shortcut link marker name. +
|
+
href + |
+String + |
+Specifies the corresponding shortcut link. + |
+
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 | {
+ "flavor": {
+ "name": "physical.o2.medium",
+ "links": [
+ {
+ "href": "https://openstack.example.com/v2/c685484a8cc2416b97260938705deb65/flavors/physical.o2.medium",
+ "rel": "self"
+ },
+ {
+ "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.o2.medium",
+ "rel": "bookmark"
+ }
+ ],
+ "ram": 192705,
+ "OS-FLV-DISABLED:disabled": false,
+ "vcpus": 24,
+ "swap": "",
+ "os-flavor-access:is_public": true,
+ "rxtx_factor": 1,
+ "OS-FLV-EXT-DATA:ephemeral": 0,
+ "disk": 1862,
+ "id": "physical.o2.medium"
+ }
+ }
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to query information about BMS NICs, such as the MAC addresses and private IP addresses.
+GET /v2.1/{project_id}/servers/{server_id}/os-interface
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
interfaceAttachments + |
+Array of objects + |
+Specifies information about NICs of the BMS. For details, see Table 2. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
port_state + |
+String + |
+Specifies the status of the NIC port. The value can be ACTIVE, BUILD, or DOWN. + |
+
fixed_ips + |
+Array of objects + |
+Specifies the NIC private IP address. For details, see Table 3. + |
+
net_id + |
+String + |
+Specifies the ID of the subnet (network_id) to which the NIC ports belong. + |
+
port_id + |
+String + |
+Specifies the ID of the NIC port. + |
+
mac_addr + |
+String + |
+Specifies the MAC address of the NIC. + |
+
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 | {
+ "interfaceAttachments": [
+ {
+ "port_state": "ACTIVE",
+ "fixed_ips": [
+ {
+ "subnet_id": "f8a6e8f8-c2ec-497c-9f23-da9616de54ef",
+ "ip_address": "192.168.1.3"
+ }
+ ],
+ "net_id": "3cb9bc59-5699-4588-a4b1-b87f96708bc6",
+ "port_id": "ce531f90-199f-48c0-816c-13e38010b442",
+ "mac_addr": "fa:16:3e:4c:2c:30"
+ }
+ ]
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to query details about BMSs.
+GET /v2.1/{project_id}/servers/detail{?changes-since={changes-since}&image={image}&flavor={flavor}&name={name}&status={status}&limit={limit}&marker={marker}&tags={tags}¬-tags={not-tags}&reservation_id={reservation_id}&sort_key={sort_key}&sort_dir={sort_dir}}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
changes-since + |
+No + |
+String + |
+Specifies the timestamp of the last BMS status update. The parameter is in ISO 8601 time format, for example, 2013-06-09T06:42:18Z. + |
+
image + |
+No + |
+String + |
+Specifies the image ID. + NOTE:
+If the image is used as the search criteria, other search criteria and pagination criteria are not supported. If both the image and other search criteria are used, the BMS details are filtered out by image. If the image is not used as the search criteria, this interface has no restrictions. + |
+
flavor + |
+No + |
+String + |
+Specifies the flavor ID. +You can obtain the flavor ID from the BMS console or using the Querying BMS Flavors (Native OpenStack API) API. + |
+
name + |
+No + |
+String + |
+Specifies the BMS name. This parameter supports fuzzy matching. +For example, the regular expression ?name=bob will return both bob and bobb. To obtain only bob, you can use a regular expression matching the basic database syntax, such as MySQL or PostgreSQL (official website: https://www.postgresql.org/docs/9.2/static/functions-matching.html). + |
+
status + |
+No + |
+String + |
+Specifies the BMS status. +Value range: +
|
+
limit + |
+No + |
+Integer + |
+Specifies the number of BMSs displayed on each page. + |
+
marker + |
+No + |
+String + |
+Specifies the BMS ID to which the marker corresponds. The query will start from the next ID. + |
+
tags + |
+No + |
+String + |
+Queries the BMSs with specified tags. +Added in micro version 2.26. + |
+
not-tags + |
+No + |
+String + |
+Queries the BMSs with tags not containing the specified value. The value is a list of tag keys. + NOTE:
+If the tags added before the function upgrade are in the format of "Key.Value", query tags using "Key". +For example, an existing tag is a.b. After the tag function upgrade, query the tag using "not-tags=a". +Added in micro version 2.26. + |
+
reservation_id + |
+No + |
+String + |
+Specifies the reserved ID, which can be used to query BMSs created in a batch. +Added in micro version 2.26. + |
+
sort_key + |
+No + |
+String + |
+Specifies the BMS sorting attribute, which can be the BMS UUID (uuid), BMS status (vm_state), BMS name (display_name), BMS task status (task_state), power status (power_state), creation time (created_at), last time when the BMS is updated (updated_at), and AZ (availability_zone). You can specify multiple sort_key and sort_dir pairs. +The default sorting is the reverse order by created_at. + |
+
sort_dir + |
+No + |
+String + |
+Specifies the sorting direction. +
|
+
1 | https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers/detail
+ |
1 | https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers/detail?tags=__type_baremetal
+ |
1 | https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers/detail?tags=__type_baremetal&name=bms-test01
+ |
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
servers + |
+Array of objects + |
+Specifies details about the BMS. For details, see Table 2. + |
+
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +81 +82 +83 +84 +85 +86 +87 +88 +89 | {
+ "servers": [
+{
+ "tenant_id": "c685484a8cc2416b97260938705deb64",
+ "addresses": {
+ "08a7715f-7de6-4ff9-a343-95ba4209f24a": [
+{
+ "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:0e:c4:77",
+ "OS-EXT-IPS:type": "fixed",
+ "addr": "192.168.0.107",
+ "version": 4
+ }
+ ]
+ },
+ "metadata": {
+ "op_svc_userid": "1311c433dd9b408886f57d695c229cbe"
+ },
+ "OS-EXT-STS:task_state": null,
+ "OS-DCF:diskConfig": "MANUAL",
+ "OS-EXT-AZ:availability_zone": "az-dc-1",
+ "links": [
+{
+ "rel": "self",
+ "href": "https://openstack.example.com/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd"
+ },
+{
+ "rel": "bookmark",
+ "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd"
+ }
+ ],
+ "OS-EXT-STS:power_state": 1,
+ "id": "95bf2490-5428-432c-ad9b-5e3406f869dd",
+ "os-extended-volumes:volumes_attached": [
+{
+ "id": "dfa375b5-9856-44ad-a937-a4802b6434c3"
+ },
+{
+ "id": "bb9f1b27-843b-4561-b62e-ca18eeaec417"
+ },
+{
+ "id": "86e801c3-acc6-465d-890c-d43ba493f553"
+ },
+{
+ "id": "0994d3ac-3c6a-495c-a439-c597a4f08fa6"
+ }
+ ],
+ "OS-EXT-SRV-ATTR:host": "bms.az1",
+ "image": {
+ "links": [
+{
+ "rel": "bookmark",
+ "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/images/1a6635d8-afea-4f2b-abb6-27a202bad319"
+ }
+ ],
+ "id": "1a6635d8-afea-4f2b-abb6-27a202bad319"
+ },
+ "OS-SRV-USG:terminated_at": null,
+ "accessIPv4": "",
+ "accessIPv6": "",
+ "created": "2017-05-24T06:14:05Z",
+ "hostId": "e9c3ee0fcc58ab6085cf30df70b5544eab958858fb50d925f023e53e",
+ "OS-EXT-SRV-ATTR:hypervisor_hostname": "nova004@2",
+ "key_name": "KeyPair-JX",
+ "flavor": {
+ "links": [
+{
+ "rel": "bookmark",
+ "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.83.medium"
+ }
+ ],
+ "id": "physical.83.medium"
+ },
+ "security_groups": [
+{
+ "name": "0011b620-4982-42e4-ad12-47c95ca495c4"
+ }
+ ],
+ "config_drive": "",
+ "OS-EXT-STS:vm_state": "active",
+ "OS-EXT-SRV-ATTR:instance_name": "instance-0000ebd3",
+ "user_id": "1311c433dd9b408886f57d695c229cbe",
+ "name": "bms",
+ "progress": 0,
+ "OS-SRV-USG:launched_at": "2017-05-25T03:40:25.066078",
+ "updated": "2017-05-25T03:40:25Z",
+ "status": "ACTIVE"
+ }
+ ]
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This interface is used to create a BMS.
+POST /v2.1/{project_id}/servers
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
server + |
+Yes + |
+Object + |
+Specifies the BMS information, see Table 2. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
imageRef + |
+Yes + |
+String + |
+Specifies the ID of the image used by the BMS or the image resource uniform resource locator (URL). +
NOTE:
+
|
+
flavorRef + |
+Yes + |
+String + |
+Specifies the ID or URL of the flavor used by the BMS. + |
+
name + |
+Yes + |
+String + |
+Specifies the BMS name. It contains a maximum of 255 characters and cannot be left blank. + |
+
metadata + |
+No + |
+Object + |
+Specifies the BMS metadata. The maximum size for both the metadata key and value is 255 characters. For details, see Table 3. + |
+
user_data + |
+No + |
+String + |
+Specifies the user data to be injected during the BMS creation. +Text, text files, and .gzip files can be injected. The content to be injected cannot be greater than 32 KB in size. The content to be injected must be encoded with base64. + |
+
adminPass + |
+No + |
+String + |
+Specifies the initial login password of the BMS administrator account. This parameter is invalid for a Linux BMS. The administrator account of a Windows BMS is Administrator. +Password complexity requirements: +
Note: If this parameter is not specified, a random password will be generated. +Special characters: !@$%^-_=+[{}]:,./? + |
+
security_groups + |
+No + |
+Array of objects + |
+Specifies the security group of a BMS. The default value is default. This parameter is valid when you specify parameter network. You are not allowed to specify multiple security groups. For details, see Table 4. + |
+
networks + |
+Yes + |
+Array of objects + |
+Specifies the BMS NICs. For details, see Table 5. +You can specify a maximum of four networks for a BMS, including two VXLAN networks and two GENEVE networks. The first network in the parameter must be a VXLAN network. The network is used as by the primary NIC of the BMS. If multiple groups of network parameters are specified, ensure that the parameters of each group belong to the same VPC. + |
+
key_name + |
+No + |
+String + |
+Specifies the name of a key pair. This is an extended attribute. + |
+
availability_zone + |
+Yes + |
+String + |
+Specifies information about the AZ to which the BMS belongs. You are not allowed to specify host information. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
User-defined field key and value pair + |
+No + |
+String + |
+Specifies the key and value pair of the metadata. +Each key or value contains a maximum of 255 characters. + |
+
1 | POST https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers
+ |
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 | {
+ "server": {
+ "imageRef": "1a6635d8-afea-4f2b-abb6-27a202bad319",
+ "flavorRef": "physical.o2.medium",
+ "name": "bms_name01",
+ "availability_zone": "az-dc-1",
+ "networks": [
+ {
+ "uuid": "8470310b-bfa2-4edf-8f64-d15196b2b2c9"
+ }
+ ]
+ }
+}
+ |
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
server + |
+Object + |
+Specifies the BMS information. For details, see Table 6. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
security_groups + |
+Array of objects + |
+Specifies information about the BMS security group. For details, see Table 7. + |
+
OS-DCF:diskConfig + |
+String + |
+Specifies the disk configuration. The value can be: +
|
+
id + |
+String + |
+Specifies the BMS ID. + |
+
links + |
+Array of objects + |
+Specifies the shortcut links of the BMS. For details, see Table 8. + |
+
adminPass + |
+String + |
+Specifies the initial login password of the BMS administrator account. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
name + |
+String + |
+Specifies the name of the security group to which the BMS belongs. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
rel + |
+String + |
+Specifies the shortcut link marker name. The value can be: +
|
+
href + |
+String + |
+Specifies the corresponding shortcut link. + |
+
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 | {
+ "server": {
+ "security_groups": [
+ {
+ "name": "default"
+ }
+ ],
+ "OS-DCF:diskConfig": "MANUAL",
+ "links": [
+ {
+ "rel": "self",
+ "href": "https://openstack.example.com/v2/c685484a8cc2416b97260938705deb65/servers/9ab74d89-61e7-4259-8546-465fdebe4944"
+ },
+ {
+ "rel": "bookmark",
+ "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/servers/9ab74d89-61e7-4259-8546-465fdebe4944"
+ }
+ ],
+ "id": "9ab74d89-61e7-4259-8546-465fdebe4944",
+ "adminPass": "RjdD3h8U2DBe"
+ }
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to delete specified BMS metadata.
+The BMS OS-EXT-STS:vm_state attribute (BMS status) must be active, stopped, paused, or suspended.
+DELETE /v2.1/{project_id}/servers/{server_id}/metadata/{key}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
key + |
+Yes + |
+Specifies the BMS metadata key value to be deleted. + |
+
N/A
+Returned Values + |
+Description + |
+
|---|---|
204 + |
+The server has processed the request but did not return any content. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to query BMS flavors.
+The flavors you obtained using this API are all the flavors in the system. The flavors whose names starting with physical are BMS flavors and can be used to create BMSs.
+GET /v2.1/{project_id}/flavors/detail{?minDisk={minDisk}&minRam={minRam}&sort_key={sort_key}&sort_dir={sort_dir}}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
Table 2 lists the optional parameters that can be used to query BMS flavors.
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
minDisk + |
+No + |
+String + |
+Specifies the minimum disk size in GB. Only the BMSs with a disk size greater than or equal to the minimum size can be queried. + |
+
minRam + |
+No + |
+String + |
+Specifies the minimum memory size in MB. Only the BMSs with the memory size greater than or equal to the minimum size can be queried. + |
+
sort_key + |
+No + |
+String + |
+Specifies the sorting field. The default value is flavorid. The value of this parameter can also be name, memory_mb, vcpus, root_gb, or flavorid. + |
+
sort_dir + |
+No + |
+String + |
+Specifies the sorting of BMS flavors. +The value can be asc or desc, and is asc by default. + |
+
1 | GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail
+ |
1 | GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail?minDisk=3725
+ |
1 | GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/flavors/detail?minDisk=3725&is_public=true
+ |
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
flavors + |
+Array of objects + |
+Specifies BMS flavors. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the BMS flavor ID. + |
+
name + |
+String + |
+Specifies the BMS flavor name. + |
+
vcpus + |
+Integer + |
+Specifies the number of CPU cores in the BMS flavor. + |
+
ram + |
+Integer + |
+Specifies the memory size (MB) in the BMS flavor. + |
+
disk + |
+Integer + |
+Specifies the disk size (GB) in the BMS flavor. + |
+
swap + |
+String + |
+This is a reserved attribute. + |
+
OS-FLV-EXT-DATA:ephemeral + |
+Integer + |
+This is a reserved attribute. + |
+
OS-FLV-DISABLED:disabled + |
+Boolean + |
+This is a reserved attribute. + |
+
rxtx_factor + |
+Float + |
+This is a reserved attribute. + |
+
os-flavor-access:is_public + |
+Boolean + |
+This is a reserved attribute. + |
+
links + |
+Array of objects + |
+Specifies shortcut links of the BMS flavor. For details, see Table 4. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
rel + |
+String + |
+Specifies the shortcut link marker name. +
|
+
href + |
+String + |
+Specifies the corresponding shortcut link. + |
+
{
+ "flavors": [
+ {
+ "name": "physical.o2.medium",
+ "links": [
+ {
+ "href": "https://openstack.example.com/v2/c685484a8cc2416b97260938705deb65/flavors/physical.o2.medium",
+ "rel": "self"
+ },
+ {
+ "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.o2.medium",
+ "rel": "bookmark"
+ }
+ ],
+ "ram": 321725,
+ "OS-FLV-DISABLED:disabled": false,
+ "vcpus": 56,
+ "swap": "",
+ "os-flavor-access:is_public": true,
+ "rxtx_factor": 1,
+ "OS-FLV-EXT-DATA:ephemeral": 0,
+ "disk": 3725,
+ "id": "physical.o2.medium"
+ }
+ ]
+ }
+Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to stop a single BMS.
+POST /v2.1/{project_id}/servers/{server_id}/action
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
os-stop + |
+Yes + |
+Object + |
+Specifies the operation of stopping the BMS. For details, see Table 2. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
type + |
+No + |
+String + |
+Specifies the type of the BMS stopping operation. +
|
+
1 | POST https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/action
+ |
1 +2 +3 | {
+ "os-stop": {}
+}
+ |
N/A
+Returned Values + |
+Description + |
+
|---|---|
204 + |
+The server has processed the request but did not return any content. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to query information about a specified BMS NIC based on the NIC ID.
+GET /v2.1/{project_id}/servers/{server_id}/os-interface/{id}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
id + |
+Yes + |
+Specifies the ID of the NIC. +You can obtain the NIC ID from the NICs tab page on the BMS details page or by calling the Querying Information About BMS NICs (Native OpenStack API) API. (The NIC ID is the value of port_id). + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
interfaceAttachment + |
+Object + |
+Specifies information about the specified BMS NIC. For details, see Table 2. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
port_state + |
+String + |
+Specifies the status of the NIC port. The value can be ACTIVE, BUILD, or DOWN. + |
+
fixed_ips + |
+Array of objects + |
+Specifies the IP addresses of NICs. For details, see Table 3. + |
+
net_id + |
+String + |
+Specifies the ID of the subnet (network_id) to which the NIC ports belong. + |
+
port_id + |
+String + |
+Specifies the ID of the NIC port. + |
+
mac_addr + |
+String + |
+Specifies the MAC address of the NIC. + |
+
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 | {
+ "interfaceAttachment": {
+ "port_state": "ACTIVE",
+ "fixed_ips": [
+{
+ "subnet_id": "f8a6e8f8-c2ec-497c-9f23-da9616de54ef",
+ "ip_address": "192.168.1.3"
+ }
+ ],
+ "net_id": "3cb9bc59-5699-4588-a4b1-b87f96708bc6",
+ "port_id": "ce531f90-199f-48c0-816c-13e38010b442",
+ "mac_addr": "fa:16:3e:4c:2c:30"
+ }
+ }
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+Returned Value + |
+Description + |
+
|---|---|
200 OK + |
+The request has been successfully processed. + |
+
201 Created + |
+The request has been successfully processed and a resource has been created. + |
+
202 Accepted + |
+The request has been accepted but may not be processed immediately. + |
+
204 No Content + |
+The request has been successfully processed, but there is no need to send any data back. + |
+
Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The request failed to be processed due to bad syntax. + |
+
401 Unauthorized + |
+A username and a password are required to access a page. + |
+
403 Forbidden + |
+The requested page cannot be accessed. + |
+
404 Not Found + |
+The requested page cannot be found. + |
+
405 Method Not Allowed + |
+A method in the request is not allowed. + |
+
406 Not Acceptable + |
+The response cannot be accepted by the client. + |
+
407 Proxy Authentication Required + |
+The client must be authorised by the proxy before the request can proceed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+Failed to complete the request due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request due to a system error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support all that is needed for the request to be completed. + |
+
502 Bad Gateway + |
+Failed to complete the request because the server has received an invalid response from an upstream server. + |
+
503 Service Unavailable + |
+Failed to complete the request because the server is unavailable. + |
+
504 Gateway Timeout + |
+The server has waited too long for a response from an upstream server. + |
+
This API is used to query BMSs.
+GET /v2.1/{project_id}/servers{?changes-since={changes-since}&image={image}&flavor={flavor}&name={name}&status={status}&limit={limit}&marker={marker}&tags={tags}¬-tags={not-tags}&reservation_id={reservation_id}&sort_key={sort_key}&sort_dir={sort_dir}}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
changes-since + |
+No + |
+String + |
+Specifies the timestamp of the last BMS status update. The parameter is in ISO 8601 time format, for example, 2013-06-09T06:42:18Z. + |
+
image + |
+No + |
+String + |
+Specifies the image ID. + NOTE:
+If the image is used as the search criteria, other search criteria and pagination criteria are not supported. If both the image and other search criteria are used, the BMS details are filtered out by image. If the image is not used as the search criteria, this interface has no restrictions. + |
+
flavor + |
+No + |
+String + |
+Specifies the flavor ID. +You can obtain the flavor ID from the BMS console or using the Querying BMS Flavors (Native OpenStack API) API. + |
+
name + |
+No + |
+String + |
+Specifies the BMS name. This parameter supports fuzzy matching. +For example, the regular expression ?name=bob will return both bob and bobb. To obtain only bob, you can use a regular expression matching the basic database syntax, such as MySQL or PostgreSQL (official website: https://www.postgresql.org/docs/9.2/static/functions-matching.html). + |
+
status + |
+No + |
+String + |
+Specifies the BMS status. +Value range: +
|
+
limit + |
+No + |
+Integer + |
+Specifies the number of BMSs displayed on each page. + |
+
marker + |
+No + |
+String + |
+Specifies the BMS ID to which the marker corresponds. The query will start from the next ID. + |
+
tags + |
+No + |
+String + |
+Queries the BMSs with specified tags. +Added in micro version 2.26. + |
+
not-tags + |
+No + |
+String + |
+Queries the BMSs with tags not containing the specified value. The value is a list of tag keys. + NOTE:
+If the tags added before the function upgrade are in the format of "Key.Value", query tags using "Key". +For example, an existing tag is a.b. After the tag function upgrade, query the tag using "not-tags=a". +Added in micro version 2.26. + |
+
reservation_id + |
+No + |
+String + |
+Specifies the reserved ID, which can be used to query BMSs created in a batch. +Added in micro version 2.26. + |
+
sort_key + |
+No + |
+String + |
+Specifies the BMS sorting attribute, which can be the BMS UUID (uuid), BMS status (vm_state), BMS name (display_name), BMS task status (task_state), power status (power_state), creation time (created_at), last time when the BMS is updated (updated_at), and AZ (availability_zone). You can specify multiple sort_key and sort_dir pairs. +The default sorting is the reverse order by created_at. + |
+
sort_dir + |
+No + |
+String + |
+Specifies the sorting direction. +
|
+
1 | GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers
+ |
1 | GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers?tags=__type_baremetal
+ |
1 | GET https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers?tags=__type_baremetal&name=bms-test01
+ |
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
servers + |
+Array of objects + |
+Specifies the BMS list. For details, see Table 2. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
name + |
+String + |
+Specifies the BMS name. + |
+
id + |
+String + |
+Specifies the unique ID of the BMS. + |
+
links + |
+Array of objects + |
+Specifies shortcut links of the BMS. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
rel + |
+String + |
+Specifies the shortcut link marker name. The value can be: +
|
+
href + |
+String + |
+Specifies the corresponding shortcut link. + |
+
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 | {
+ "servers": [
+ {
+ "name": "bms",
+ "links": [
+ {
+ "rel": "self",
+ "href": "https://openstack.example.com/v2.1/c685484a8cc2416b97260938705deb65/servers/820abbd0-2d8b-4bc5-ae46-69cacfd4fbaa"
+ },
+ {
+ "rel": "bookmark",
+ "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/servers/820abbd0-2d8e-4bc5-ae46-69cacfd4fbaa"
+ }
+ ],
+ "id": "820abbd0-2d8e-4bc5-ae46-69cacfd4fbaa"
+ }
+ ]
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to modify specified BMS metadata.
+The BMS OS-EXT-STS:vm_state attribute (BMS status) must be active, stopped, paused, or suspended.
+PUT /v2.1/{project_id}/servers/{server_id}/metadata/{key}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
key + |
+Yes + |
+Specifies the BMS metadata key value to be modified + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
meta + |
+Yes + |
+Object + |
+Specifies the user-defined metadata key and value pair. For details, see Table 2. + |
+
1 | PUT https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/metadata/{key}
+ |
1 +2 +3 +4 +5 | {
+ "meta": {
+ "key": "value"
+ }
+}
+ |
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
meta + |
+Object + |
+Specifies the user-defined metadata key and value pair. For details, see Table 3. + |
+
1 +2 +3 +4 +5 | {
+ "meta": {
+ "key": "value"
+ }
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to query private IP addresses of a BMS.
+Pagination query is not supported.
+GET /v2.1/{project_id}/servers/{server_id}/ips
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
addresses + |
+Object + |
+Specifies IP addresses of the BMS. For details, see Table 2. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
vpc_id + |
+Array of objects + |
+Specifies the VPC used by the BMS. +
|
+
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 | {
+ "addresses": {
+ "08a7715f-7de6-4ff9-a343-95ba4209f24a": [
+ {
+ "version": 4,
+ "addr": "192.168.2.90"
+ }
+ ]
+ }
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to query details about a BMS based on the BMS ID.
+GET /v2.1/{project_id}/servers/{server_id}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
server + |
+Object + |
+Specifies BMS information. For details, see Table 2. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
name + |
+String + |
+Specifies the BMS name. + |
+
id + |
+String + |
+Specifies the unique ID of the BMS. + |
+
status + |
+String + |
+Specifies the BMS status. +Value range: +
|
+
created + |
+String + |
+Specifies the time when the BMS was created. +The timestamp format is YYYY-MM-DDTHH:MM:SSZ (ISO 8601), for example, 2019-05-22T03:30:52Z. + |
+
updated + |
+String + |
+Specifies the time when the BMS was last updated. +The timestamp format is YYYY-MM-DDTHH:MM:SSZ (ISO 8601), for example, 2019-05-22T04:30:52Z. + |
+
flavor + |
+Object + |
+Specifies the BMS flavor. For details, see Table 3. + |
+
image + |
+Object + |
+Specifies the BMS image. For details, see Table 4. + |
+
tenant_id + |
+String + |
+Specifies the ID of the tenant owning the BMS. The value is in UUID format. +This parameter specifies the same meaning as project_id. + |
+
key_name + |
+String + |
+Specifies the SSH key name. + |
+
user_id + |
+String + |
+Specifies the ID of the user to which the BMS belongs. + |
+
metadata + |
+Object + |
+Specifies the BMS metadata. For details, see Table 6. + |
+
hostId + |
+String + |
+Specifies the host ID of the BMS. + |
+
addresses + |
+Object + |
+Specifies BMS network addresses. For details, see Table 7. + |
+
security_groups + |
+Array of objects + |
+Specifies the security groups to which the BMS belongs. For details, see Table 9. + |
+
links + |
+Array of objects + |
+Specifies shortcut links of the BMS. For details, see Table 5. + |
+
OS-DCF:diskConfig + |
+String + |
+Specifies the disk configuration method. This is an extended attribute. The value can be: +
|
+
OS-EXT-AZ:availability_zone + |
+String + |
+Specifies the AZ where the BMS is located. + |
+
OS-EXT-SRV-ATTR:host + |
+String + |
+Specifies the host name of the BMS. This is an extended attribute. + |
+
OS-EXT-SRV-ATTR:hypervisor_hostname + |
+String + |
+Specifies the name of a host on the hypervisor. This is an extended attribute provided by the Nova virt driver. + |
+
OS-EXT-SRV-ATTR:instance_name + |
+String + |
+Specifies the BMS alias. This is an extended attribute. + |
+
OS-EXT-STS:power_state + |
+Integer + |
+Specifies the power status of the BMS. This is an extended attribute. +Options: 0, 1, 2, 3, and 4 +
|
+
OS-EXT-STS:task_state + |
+String + |
+Specifies the task status of the BMS. This is an extended attribute. +Value range: +
|
+
OS-EXT-STS:vm_state + |
+String + |
+Specifies the stable BMS status. This is an extended attribute. +Value range: +
|
+
OS-SRV-USG:launched_at + |
+String + |
+Specifies the time when the BMS was started. This is an extended attribute. +The timestamp format is ISO 8601, for example, 2019-05-22T03:23:59.000000. + |
+
OS-SRV-USG:terminated_at + |
+String + |
+Specifies the time when the BMS was deleted. This is an extended attribute. +The timestamp format is ISO 8601, for example, 2019-05-22T04:23:59.000000. + |
+
os-extended-volumes:volumes_attached + |
+Array of objects + |
+Specifies the EVS disks attached to the BMS. For details, see Table 10. + |
+
accessIPv4 + |
+String + |
+This is a reserved attribute. + |
+
accessIPv6 + |
+String + |
+This is a reserved attribute. + |
+
fault + |
+Object + |
+Specifies the fault cause. If the BMS is faulty, this field is returned. For details, see Table 11. + |
+
config_drive + |
+String + |
+This is a reserved attribute. + |
+
progress + |
+Integer + |
+This is a reserved attribute. + |
+
description + |
+String + |
+Provides supplementary information about the pool. +This parameter is added in micro version 2.19. + |
+
host_status + |
+String + |
+Specifies the status of the host that accommodates the BMS. +
Added in micro version 2.16. + |
+
OS-EXT-SRV-ATTR:hostname + |
+String + |
+Specifies the host name of the BMS. +Added in micro version 2.3. + |
+
OS-EXT-SRV-ATTR:reservation_id + |
+String + |
+Specifies the reserved BMS IDs in the batch BMS creation scenario. +Added in micro version 2.3. + |
+
OS-EXT-SRV-ATTR:launch_index + |
+Integer + |
+Specifies the BMS startup sequence in the batch BMS creation scenario. +Added in micro version 2.3. + |
+
OS-EXT-SRV-ATTR:kernel_id + |
+String + |
+Specifies the UUID of the kernel image when the AMI image is used. In other scenarios, leave this parameter blank. +Added in micro version 2.3. + |
+
OS-EXT-SRV-ATTR:ramdisk_id + |
+String + |
+Specifies the UUID of the Ramdisk image when the AMI image is used. In other scenarios, leave this parameter blank. +Added in micro version 2.3. + |
+
OS-EXT-SRV-ATTR:root_device_name + |
+String + |
+Specifies the device name of the BMS system disk, for example, /dev/sda. +Added in micro version 2.3. + |
+
OS-EXT-SRV-ATTR:user_data + |
+String + |
+Specifies the user_data specified during BMS creation. The value is encoded using Base64 or an empty string. + |
+
locked + |
+Boolean + |
+Specifies whether the BMS is locked. +
Added in micro version 2.9. + |
+
tags + |
+Array of strings + |
+Specifies tags of the BMS. +This parameter is added in microversion 2.26. If the microversion is not used for query, the response does not contain the tags field. +The value of this field meets the following requirements: +
|
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the BMS type ID. +This field is not supported in microversions later than 2.47. + |
+
links + |
+Array of objects + |
+Specifies shortcut links of the BMS type. +For details, see Table 5. +This field is not supported in microversions later than 2.47. + |
+
vcpus + |
+Integer + |
+Specifies the number of CPU cores in the BMS flavor. +This field is supported in microversions later than 2.47. + |
+
ram + |
+Integer + |
+Specifies the memory size (MB) in the BMS flavor. +This field is supported in microversions later than 2.47. + |
+
disk + |
+Integer + |
+Specifies the system disk size in the BMS flavor. The value 0 indicates that the disk size is not limited. +This field is supported in microversions later than 2.47. + |
+
ephemeral + |
+Integer + |
+This is a reserved attribute. +This field is supported in microversions later than 2.47. + |
+
swap + |
+Integer + |
+This is a reserved attribute. +This field is supported in microversions later than 2.47. + |
+
original_name + |
+String + |
+This is a reserved attribute. +This field is supported in microversions later than 2.47. + |
+
extra_specs + |
+Object + |
+Extended flavor field +This field is supported in microversions later than 2.47. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the image ID of the BMS. + |
+
links + |
+Array of objects + |
+Specifies shortcut links of the BMS image. For details, see Table 5. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
rel + |
+String + |
+Specifies the shortcut link marker name. The value can be: +
|
+
href + |
+String + |
+Specifies the corresponding shortcut link. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
User-defined field key and value pair + |
+String + |
+Specifies the key and value pair of the metadata. +Each key or value contains a maximum of 255 characters. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
vpc_id + |
+Array of objects + |
+Specifies the VPC used by the BMS. +
|
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
addr + |
+String + |
+Specifies the IP address. + |
+
version + |
+Integer + |
+Specifies the type of the IP address. The value can be 4 or 6. +
|
+
OS-EXT-IPS-MAC:mac_addr + |
+String + |
+Specifies the MAC address. This is an extended attribute. + |
+
OS-EXT-IPS:type + |
+String + |
+Specifies the IP address type. This is an extended attribute. +
|
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
name + |
+String + |
+
|
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the EVS disk ID. + |
+
delete_on_termination + |
+Boolean + |
+Specifies whether to delete the disk when deleting the BMS. +
Added in micro version 2.3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
message + |
+String + |
+Specifies the fault information. + |
+
code + |
+Integer + |
+Specifies the fault code. + |
+
details + |
+String + |
+Specifies the fault details. + |
+
created + |
+String + |
+Specifies the time when the fault occurred. The time is in ISO 8601 format. + |
+
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 +56 +57 +58 +59 +60 +61 +62 +63 +64 +65 +66 +67 +68 +69 +70 +71 +72 +73 +74 +75 +76 +77 +78 +79 +80 +81 +82 +83 +84 +85 +86 +87 | {
+ "server": {
+ "tenant_id": "c685484a8cc2416b97260938705deb65",
+ "addresses": {
+ "08a7715f-7de6-4ff9-a343-95ba4209f24a": [
+{
+ "OS-EXT-IPS-MAC:mac_addr": "fa:16:3e:0e:c3:77",
+ "OS-EXT-IPS:type": "fixed",
+ "addr": "192.168.0.107",
+ "version": 4
+ }
+ ]
+ },
+ "metadata": {
+ "op_svc_userid": "1311c433dd9b408886f57d695c229cbe"
+ },
+ "OS-EXT-STS:task_state": null,
+ "OS-DCF:diskConfig": "MANUAL",
+ "OS-EXT-AZ:availability_zone": "az-dc-1",
+ "links": [
+{
+ "rel": "self",
+ "href": "https://openstack.example.com/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd"
+ },
+{
+ "rel": "bookmark",
+ "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd"
+ }
+ ],
+ "OS-EXT-STS:power_state": 1,
+ "id": "95bf2490-5428-432c-ad9b-5e3406f869dd",
+ "os-extended-volumes:volumes_attached": [
+{
+ "id": "dfa375b5-9856-44ad-a937-a4802b6434c3"
+ },
+{
+ "id": "bb9f1b27-843b-4561-b62e-ca18eeaec417"
+ },
+{
+ "id": "86e801c3-acc6-465d-890c-d43ba493f553"
+ },
+{
+ "id": "0994d3ac-3c6a-495c-a439-c597a4f08fa6"
+ }
+ ],
+ "OS-EXT-SRV-ATTR:host": "bms.az1",
+ "image": {
+ "links": [
+{
+ "rel": "bookmark",
+ "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/images/1a6635d8-afea-4f2b-abb6-27a202bad319"
+ }
+ ],
+ "id": "1a6635d8-afea-4f2b-abb6-27a202bad319"
+ },
+ "OS-SRV-USG:terminated_at": null,
+ "accessIPv4": "",
+ "accessIPv6": "",
+ "created": "2017-05-24T06:14:05Z",
+ "hostId": "e9c3ee0fcc58ab6085cf30df70b5544eab958858fb50d925f023e53e",
+ "OS-EXT-SRV-ATTR:hypervisor_hostname": "nova004@2",
+ "key_name": "KeyPair-JX",
+ "flavor": {
+ "links": [
+{
+ "rel": "bookmark",
+ "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.83.medium"
+ }
+ ],
+ "id": "physical.83.medium"
+ },
+ "security_groups": [
+{
+ "name": "0011b620-4982-42e4-ad12-47c95ca495c4"
+ }
+ ],
+ "config_drive": "",
+ "OS-EXT-STS:vm_state": "active",
+ "OS-EXT-SRV-ATTR:instance_name": "instance-0000ebd3",
+ "user_id": "1311c433dd9b408886f57d695c229cbe",
+ "name": "bms-83",
+ "progress": 0,
+ "OS-SRV-USG:launched_at": "2017-05-25T03:40:25.066078",
+ "updated": "2017-05-25T03:40:25Z",
+ "status": "ACTIVE"
+ }
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This interface is used to modify BMS information. Currently, only the name of the BMS can be changed.
+PUT /v2.1/{project_id}/servers/{server_id}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
server + |
+Yes + |
+Object + |
+Specifies the BMS data structure. For details, see Table 2. + |
+
1 | PUT https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd
+ |
1 +2 +3 +4 +5 | {
+ "server": {
+ "name": "new-server-test"
+ }
+}
+ |
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
name + |
+String + |
+Specifies the BMS name. + |
+
id + |
+String + |
+Specifies the unique ID of the BMS. + |
+
status + |
+String + |
+Specifies the current status of the BMS. +
|
+
created + |
+String + |
+Specifies the time when the BMS was created. +The timestamp format is YYYY-MM-DDTHH:MM:SSZ (ISO 8601), for example, 2019-05-22T03:30:52Z. + |
+
updated + |
+String + |
+Specifies the time when the BMS was last updated. +The timestamp format is YYYY-MM-DDTHH:MM:SSZ (ISO 8601), for example, 2019-05-22T04:30:52Z. + |
+
flavor + |
+Object + |
+Specifies the BMS flavor information. For details, see Table 3. + |
+
image + |
+Object + |
+Specifies the BMS image. For details, see Table 4. + |
+
tenant_id + |
+String + |
+Specifies the ID of the tenant owning the BMS. The ID is in UUID format. +This parameter specifies the same meaning as project_id. + |
+
user_id + |
+String + |
+Specifies the ID of the user to which the BMS belongs. + |
+
metadata + |
+Object + |
+Specifies the BMS metadata. For details, see Table 5. + |
+
hostId + |
+String + |
+Specifies the host ID of the BMS. + |
+
addresses + |
+Object + |
+Specifies the BMS network address. For details, see Table 7. + |
+
links + |
+Array of objects + |
+Specifies the shortcut links of the BMS. For details, see Table 6. + |
+
accessIPv4 + |
+String + |
+This is a reserved attribute. + |
+
accessIPv6 + |
+String + |
+This is a reserved attribute. + |
+
OS-DCF:diskConfig + |
+String + |
+Specifies the disk configuration method. This is an extended attribute. The value can be: +
|
+
progress + |
+Integer + |
+This is a reserved attribute. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the flavor ID. + |
+
links + |
+Array of objects + |
+Specifies the shortcut link of the BMS flavor. For details, see Table 6. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the ID of the BMS image. + |
+
links + |
+Array of objects + |
+Specifies the shortcut links of the BMS image. For details, see Table 6. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
User-defined field key and value pair + |
+String + |
+Specifies the key and value pair of the metadata. +Each key or value contains a maximum of 255 characters. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
rel + |
+String + |
+Specifies the shortcut link marker name. The value can be: +
|
+
href + |
+String + |
+Specifies the corresponding shortcut link. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
vpc_id + |
+Array of objects + |
+Specifies the VPC used by the BMS. +
|
+
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 +27 +28 +29 +30 +31 +32 +33 +34 +35 +36 +37 +38 +39 +40 +41 +42 +43 +44 +45 +46 +47 +48 +49 +50 +51 +52 +53 +54 +55 | {
+ "server": {
+ "tenant_id": "c685484a8cc2416b97260938705deb65",
+ "image": {
+ "links": [
+ {
+ "rel": "bookmark",
+ "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/images/1a6635d8-afea-4f2b-abb6-27a202bad319"
+ }
+ ],
+ "id": "1a6635d8-afea-4f2b-abb6-27a202bad319"
+ },
+ "accessIPv4": "",
+ "addresses": {
+ "08a7715f-7de6-4ff9-a343-95ba4209f24a": [
+ {
+ "addr": "192.168.0.107",
+ "version": 4
+ }
+ ]
+ },
+ "metadata": {
+ "op_svc_userid": "1311c433dd9b408886f57d695c229cbe"
+ },
+ "accessIPv6": "",
+ "created": "2017-05-24T06:14:05Z",
+ "hostId": "e9c3ee0fcc58ab6085cf30df70b5544eab958858fb50d925f023e53e",
+ "flavor": {
+ "links": [
+ {
+ "rel": "bookmark",
+ "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/flavors/physical.83.medium"
+ }
+ ],
+ "id": "physical.83.medium"
+ },
+ "OS-DCF:diskConfig": "MANUAL",
+ "user_id": "1311c433dd9b408886f57d695c229cbe",
+ "name": "new-server-test",
+ "progress": 0,
+ "links": [
+ {
+ "rel": "self",
+ "href": "https://openstack.example.com/v2/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd"
+ },
+ {
+ "rel": "bookmark",
+ "href": "https://openstack.example.com/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd"
+ }
+ ],
+ "id": "95bf2490-5428-432c-ad9b-5e3406f869dd",
+ "updated": "2017-05-25T03:40:25Z",
+ "status": "ACTIVE"
+ }
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to update BMS metadata.
+The BMS OS-EXT-STS:vm_state attribute (BMS status) must be active, stopped, paused, or suspended.
+POST /v2.1/{project_id}/servers/{server_id}/metadata
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
metadata + |
+Yes + |
+Object + |
+Specifies the user-defined metadata key and value pair. For details, see Table 2. + |
+
1 | POST https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/metadata
+ |
1 +2 +3 +4 +5 | {
+ "metadata": {
+ "key": "value"
+ }
+ }
+ |
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
metadata + |
+Object + |
+Specifies the user-defined metadata key and value pair. For details, see Table 3. + |
+
1 +2 +3 +4 +5 | {
+ "metadata": {
+ "key": "value"
+ }
+ }
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This interface is used to delete a BMS.
+DELETE /v2.1/{project_id}/servers/{server_id}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
N/A
+Returned Values + |
+Description + |
+
|---|---|
204 + |
+The server has processed the request but did not return any content. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to restart a single BMS.
+Currently, only forcible restart is supported.
+POST /v2.1/{project_id}/servers/{server_id}/action
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
reboot + |
+Yes + |
+Object + |
+Specifies the operation of restarting the BMS. For details, see Table 2. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
type + |
+Yes + |
+String + |
+Specifies the type of the restart operation. +
|
+
1 | POST https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/action
+ |
1 +2 +3 +4 +5 | {
+ "reboot": {
+ "type": "HARD"
+ }
+}
+ |
N/A
+Returned Values + |
+Description + |
+
|---|---|
204 + |
+The server has processed the request but did not return any content. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This interface is used to query SSH key pairs and to display the query results in a list.
+Pagination query is not supported.
+GET /v2.1/{project_id}/os-keypairs
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
keypairs + |
+Array of objects + |
+Specifies key pairs. For details, see Table 2. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
keypair + |
+Object + |
+Specifies details about a key pair. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
fingerprint + |
+String + |
+Specifies fingerprint information about the key pair. + |
+
name + |
+String + |
+Specifies the key pair name. + |
+
type + |
+String + |
+Specifies the key type, which is ssh by default. +This field is supported in microversions later than 2.2. + |
+
public_key + |
+String + |
+Specifies information about the public key in the key pair. + |
+
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 | {
+ "keypairs": [
+ {
+ "keypair": {
+ "fingerprint": "15:b0:f8:b3:f9:48:63:71:cf:7b:5b:38:6d:44:2d:4a",
+ "name": "keypair-test",
+ "type": "ssh",
+ "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQC+Eo/RZRngaGTkFs7I62ZjsIlO79KklKbMXi8F+KITD4bVQHHn+kV+4gRgkgCRbdoDqoGfpaDFs877DYX9n4z6FrAIZ4PES8TNKhatifpn9NdQYWA+IkU8CuvlEKGuFpKRi/k7JLos/gHi2hy7QUwgtRvcefvD/vgQZOVw/mGR9Q== Generated-by-Nova"
+ }
+ }
+ ]
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This interface is used to query a specified SSH key pair based on the key pair name.
+GET /v2.1/{project_id}/os-keypairs/{keypair_name}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
keypair_name + |
+Yes + |
+Specifies the key pair name. +You can obtain the key pair name by calling the Querying SSH Key Pairs (Native OpenStack API) API. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
keypair + |
+Object + |
+Specifies the SSH key pair. For details, see Table 2. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
public_key + |
+String + |
+Specifies information about the public key in the key pair. + |
+
name + |
+String + |
+Specifies the key pair name. + |
+
fingerprint + |
+String + |
+Specifies fingerprint information about the key pair. + |
+
created_at + |
+String + |
+Specifies the time when the key pair was created. +The timestamp format is ISO 8601, for example, 2019-05-07T12:06:13.681238. + |
+
deleted + |
+Boolean + |
+Specifies the deleted key pair. +
|
+
deleted_at + |
+String + |
+Specifies the time when the key pair was deleted. +The timestamp format is ISO 8601, for example, 2019-05-07T12:06:13.681238. + |
+
id + |
+String + |
+Specifies the key pair ID. + |
+
updated_at + |
+String + |
+Specifies the time when the key pair was updated. +The timestamp format is ISO 8601, for example, 2019-05-07T12:06:13.681238. + |
+
user_id + |
+String + |
+Specifies information about the user to which the key pair belongs. + |
+
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 | {
+ "keypair": {
+ "created_at": "2019-05-07T12:06:13.681238",
+ "deleted": false,
+ "deleted_at": null,
+ "fingerprint": "9d:00:f4:d7:26:6e:52:06:4c:c1:d3:1d:fd:06:66:01",
+ "id": 1,
+ "name": "keypair-3582d8b7-e588-4aad-b7f7-f4e76f0e4314",
+ "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDYJrTVpcMwFqQy/oMvtUSRofZdSRHEwrsX8AYkRvn2ZnCXM+b6+GZ2NQuuWj+ocznlnwiGFQDsL/yeE+/kurqcPJFKKp60mToXIMyzioFxW88fJtwEWawHKAclbHWpR1t4fQ4DS+/sIbX/Yd9btlVQ2tpQjodGDbM9Tr9/+/3i6rcR+EoLqmbgCgAiGiVV6VbM2Zx79yUwd+GnQejHX8BlYZoOjCnt3NREsITcmWE9FVFy6TnLmahs3FkEO/QGgWGkaohAJlsgaVvSWGgDn2AujKYwyDokK3dXyeX3m2Vmc3ejiqPa/C4nRrCOlko5nSgV/9IXRx1ERImsqZnE9usB Generated-by-Nova",
+ "updated_at": null,
+ "user_id": "fake"
+ }
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This interface is used to create an SSH key pair or import a public key to generate a key pair.
+After an SSH key is created, download the private key to a local directory. Then, you can use this private key to log in to the BMS. To ensure BMS security, the private key can be downloaded only once. Keep it secure.
+POST /v2.1/{project_id}/os-keypairs
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
When creating an SSH key pair, you only need to configure name. When importing a public SSH key, you must also configure public_key.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
keypair + |
+Yes + |
+Object + |
+Specifies the created or imported SSH key pair. For details, see Table 2. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
public_key + |
+No + |
+String + |
+Specifies the imported public key. The maximum size of the imported public key is 1024 bytes. +Note: If the length of the public key to be imported exceeds 1024 bytes, the public key import to the BMS will fail. + |
+
name + |
+Yes + |
+String + |
+Specifies the key pair name. +The new key pair name cannot be the same as an existing one. + |
+
1 | POST https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/os-keypairs
+ |
1 +2 +3 +4 +5 +6 | {
+ "keypair": {
+ "name": "keypair-7d7c3650-dabe-4eb0-b904-5c464453c043",
+ "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQC9mC3WZN9UGLxgPBpP7H5jZMc6pKwOoSgre8yun6REFktn/Kz7DUt9jaR1UJyRzHxITfCfAIgSxPdGqB/oF1suMyWgu5i0625vavLB5z5kC8Hq3qZJ9zJO1poE1kyD+htiTtPWJ88e12xuH2XB/CZN9OpEiF98hAagiOE0EnOS5Q== Generated by Nova\n"
+ }
+}
+ |
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
keypair + |
+Object + |
+Specifies the SSH key pair. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
fingerprint + |
+String + |
+Specifies fingerprint information about the key pair. + |
+
name + |
+String + |
+Specifies the key pair name. + |
+
public_key + |
+String + |
+Specifies the public key. + |
+
private_key + |
+String + |
+Specifies the private key. +
|
+
user_id + |
+String + |
+Specifies the ID of the user to which the key pair belongs. + |
+
1 +2 +3 +4 +5 +6 +7 +8 | {
+ "keypair": {
+ "public_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQC9mC3WZN9UGLxgPBpP7H5jZMc6pKwOoSgre8yun6REFktn/Kz7DUt9jaR1UJyRzHxITfCfAIgSxPdGqB/oF1suMyWgu5i0625vavLB5z5kC8Hq3qZJ9zJO1poE1kyD+htiTtPWJ88e12xuH2XB/CZN9OpEiF98hAagiOE0EnOS5Q== Generated by Nova\n",
+ "user_id": "f882feb345064e7d9392440a0f397c25",
+ "name": "keypair-7d7c3650-dabe-4eb0-b904-5c464453c043",
+ "fingerprint": "35:9d:d0:c3:4a:80:d3:d8:86:f1:ca:f7:df:c4:f9:d8"
+ }
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This interface is used to delete a specified SSH key pair based on the key pair name.
+DELETE /v2.1/{project_id}/os-keypairs/{keypair_name}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
keypair_name + |
+Yes + |
+Specifies the key pair name. +You can obtain the key pair name by calling the Querying SSH Key Pairs (Native OpenStack API) API. + |
+
N/A
+Returned Values + |
+Description + |
+
|---|---|
204 + |
+The server has processed the request but did not return any content. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+The BMS metadata includes BMS basic information on the cloud platform, such as the BMS ID, hostname, and network information. This API is used to query the BMS metadata.
+Pagination query is not supported.
+GET /v2.1/{project_id}/servers/{server_id}/metadata
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
metadata + |
+Object + |
+Specifies the user-defined metadata key and value pair. For details, see Table 2. + |
+
1 +2 +3 +4 +5 | {
+ "metadata": {
+ "key": "value"
+ }
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to query all tags of a BMS.
+You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.
+GET /v2.1/{project_id}/servers/{server_id}/tags
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
tags + |
+Array of strings + |
+Specifies user-defined tags of a BMS. + |
+
1 +2 +3 +4 +5 +6 +7 | {
+ "tags": [
+ "baz",
+ "foo",
+ "qux"
+ ]
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to add tags to a BMS.
+You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.
+
PUT /v2.1/{project_id}/servers/{server_id}/tags
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
tags + |
+Yes + |
+Array of strings + |
+
|
+
1 | PUT https://{ECS Endpoint}/v2.1/bbf1946d374b44a0a2a95533562ba954/servers/53206ed0-56de-4d6b-b7ee-ffc62ca26f43/tags
+ |
1 +2 +3 +4 +5 +6 +7 | {
+ "tags": [
+ "baz",
+ "foo",
+ "qux"
+ ]
+}
+ |
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
tags + |
+Array of strings + |
+Specifies user-defined tags of a BMS. + |
+
1 +2 +3 +4 +5 +6 +7 | {
+ "tags": [
+ "baz",
+ "foo",
+ "qux"
+ ]
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to delete all tags of a BMS.
+You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.
+
DELETE /v2.1/{project_id}/servers/{server_id}/tags
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
N/A
+Returned Values + |
+Description + |
+
|---|---|
204 + |
+The server has processed the request but did not return any content. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to add a tag to a BMS.
+You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.
+
It is recommended that you add the __type_baremetal tag to BMSs to distinguish BMSs from ECSs.
+PUT /v2.1/{project_id}/servers/{server_id}/tags/{tag}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
tag + |
+Yes + |
+Specifies the tag information. +Constraints: +
|
+
N/A
+Returned Values + |
+Description + |
+
|---|---|
204 + |
+The server has processed the request but did not return any content. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to check whether a BMS has a specified tag.
+You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.
+GET /v2.1/{project_id}/servers/{server_id}/tags/{tag}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
tag + |
+Yes + |
+Specifies the key of the tag to be queried. +Constraints: +
|
+
If the specified tag exists, no response is returned.
+If the specified tag does not exist, the response is as follows:
+1 +2 +3 +4 +5 +6 | {
+ "itemNotFound": {
+ "message": "Server 2d85af7c-cbfe-40c5-a378-4d03b42fb0e2 has no tag 'abc'",
+ "code": 404
+ }
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
204 + |
+The server has processed the request but did not return any content. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to delete a tag of a BMS.
+You are required to use the HTTP header X-OpenStack-Nova-API-Version: 2.26 to specify the micro version on the client.
+
DELETE /v2.1/{project_id}/servers/{server_id}/tags/{tag}
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
server_id + |
+Yes + |
+Specifies the BMS ID. +You can obtain the BMS ID from the BMS console or using the Querying BMSs (Native OpenStack API) API. + |
+
tag + |
+Yes + |
+Specifies the tag information. +Constraints: +
|
+
N/A
+Returned Values + |
+Description + |
+
|---|---|
204 + |
+The server has processed the request but did not return any content. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+HTTP Status Code + |
+Returned Value + |
+Description + |
+Error Message + |
+Handling Measure + |
+
|---|---|---|---|---|
400 + |
+BMS.0001 + |
+Request error. + |
+Fail to parse request, reason: %s. + |
+Check the request body according to the returned error message. + |
+
400 + |
+BMS.0002 + |
+BMS has not been launched. + |
+The BMS service is unavailable. + |
+Select a region where the BMS service is available. + |
+
400 + |
+BMS.0003 + |
+Request error. + |
+Create BareMetal Server error, request is null. + |
+Check the request body according to the returned error message. + |
+
400 + |
+BMS.0004 + |
+Insufficient permission. + |
+Role check fail, reason: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0005 + |
+Insufficient permission. + |
+Role check fail, reason: You do not have permission or your balance is insufficient. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0008 + |
+Failed to query a flavor. + |
+Fail to query flavor [%s], reason: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0006 + |
+Failed to create the task. + |
+Fail to operate baremetal server. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0009 + |
+Failed to query flavor attributes. + |
+Fail to query flavor extra specs[%s], reason: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0010 + |
+Failed to query an image. + |
+Fail to query image [%s], reason: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0011 + |
+The images do not support BMS. + |
+The selected images cannot be used to apply for BMSs, %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0012 + |
+Insufficient IP addresses in the selected subnet. + |
+The number of IP addresses in the selected subnet[%s] is insufficient. + |
+Check whether the IP addresses of the subnet are used up. + |
+
400 + |
+BMS.0013 + |
+Failed to query the port. + |
+Fail to query ports by subnet [%s], reason: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0014 + |
+IP address conflict. + |
+The specified IP address conflicts with an existing IP address in subnet[%s]. + |
+Modify the NIC IP address. + |
+
400 + |
+BMS.0015 + |
+Failed to query the NIC. + |
+Fail to query subnet, reason: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0017 + |
+The EIP quota is insufficient. + |
+The number[%d] of EIPs has reached the maximum[%d] allowed. Apply for a higher quota and try again. + |
+Apply for a higher EIP quota. + |
+
400 + |
+BMS.0218 + |
+Failed to create the order. + |
+Fail to create order, reason: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0018 + |
+Invalid request parameters. + |
+Request parameter is invalid. + |
+Modify the request parameters based on the returned error message. + |
+
400 + |
+BMS.0019 + |
+Invalid NIC parameters. + |
+publicIp parameter is illegal, reason: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0021 + |
+The flavor is invalid for creating the BMS. Select another flavor. + |
+Flavor parameter is illegal, reason: %s. + |
+Select a valid flavor. + |
+
400 + |
+BMS.0022 + |
+Invalid request parameters. + |
+Request parameter is invalid. + |
+Modify the request parameters based on the returned error message. + |
+
400 + |
+BMS.0023 + |
+Failed to query the quota. + |
+Fail to query limits, reason: %s + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0025 + |
+The number of BMSs exceeds the quota. + |
+The number of cloud servers has reached the maximum allowed. + |
+Apply for a higher quota. + |
+
400 + |
+BMS.0026 + |
+The number of BMS CPUs exceeds the quota. + |
+The number of CPU cores used by all cloud servers has reached the maximum allowed. + |
+Apply for a higher quota. + |
+
400 + |
+BMS.0027 + |
+The BMS memory exceeds the quota. + |
+The memory space used by all cloud servers has reached the maximum allowed. + |
+Apply for a higher quota. + |
+
400 + |
+BMS.0028 + |
+The number of BMSs and that of CPUs exceed the quotas. + |
+The number of CPU cores used by all cloud servers and that of cloud servers have reached the maximum allowed. + |
+Apply for a higher quota. + |
+
400 + |
+BMS.0029 + |
+The number of BMSs and the memory exceed the quotas. + |
+The memory space used by all cloud servers and the number of cloud servers have reached the maximum allowed. + |
+Apply for a higher quota. + |
+
400 + |
+BMS.0030 + |
+The BMS memory and the number of CPUs exceed the quotas. + |
+The memory space and number of CPU cores used by all cloud servers have reached the maximum allowed. + |
+Apply for a higher quota. + |
+
400 + |
+BMS.0031 + |
+The number of BMSs, the number of CPUs, and the memory exceed the quotas. + |
+The number of cloud servers, the memory space used by all cloud servers, and the number of CPU cores used by all cloud servers have reached the maximum allowed. + |
+Apply for a higher quota. + |
+
400 + |
+BMS.0032 + |
+Contact technical support to apply for a BMS. + |
+Token check fail. + |
+See the returned error message or contact technical support. + |
+
403 + |
+BMS.0033 + |
+You do not have operation rights. Contact technical support. + |
+Fail to check roles, reason: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0034 + |
+Currently, BMSs cannot be automatically provisioned. + |
+Not support create Bare Metal Server. + |
+This operation is not supported. + |
+
400 + |
+BMS.0047 + |
+Invalid system disk. + |
+Root volume is illegal, reason: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0049 + |
+Failed to query key_name. + |
+Query keypair fail, reason is: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0102 + |
+This image does not support volume attaching. + |
+The image does not support attach volume. + |
+Contact technical support. + |
+
400 + |
+BMS.0103 + |
+The disk does not exist. + |
+Attach volume %s fail, volume info is null. + |
+Check whether the disk information is correct. + |
+
400 + |
+BMS.0104 + |
+The data volume cannot be attached to the mount point of the system volume. + |
+Attach volume %s fail, data volume can not attach in root volume device. + |
+Select another mount point. + |
+
400 + |
+BMS.0105 + |
+The mount point is invalid. + |
+Attach volume %s fail, device is illegal. + |
+Check whether the mount point is valid. + |
+
400 + |
+BMS.0106 + |
+The AZ of data disks is different from that of the BMS. + |
+Attach volume %s fail, volume's az is not equal with server's az. + |
+Ensure that the AZ of data disks is the same as that of the BMS. + |
+
400 + |
+BMS.0108 + |
+The system disk does not match the BMS. + |
+Attach volume %s fail, root volume does not match the VM, do not change image. + |
+Attach a matching system disk to the BMS. + |
+
400 + |
+BMS.1001 + |
+This operation can be performed only when the BMS is in running or stopped. + |
+Volume can only be attached when server %s stopped or active. + |
+Try again later or contact technical support. + |
+
400 + |
+BMS.1002 + |
+The number of data disks that can be attached to the BMS exceeds the quota. + |
+Attach volume fail, server %s attachment num over limit. + |
+Contact technical support. + |
+
400 + |
+BMS.1003 + |
+The disk status is invalid. + |
+Attach shareable volume %s fail, volume status is %s, not available or inuse. + |
+Check whether the disk is in attached or other unavailable status. + |
+
400 + |
+BMS.1004 + |
+The number of shared data disks that can be attached to the BMS exceeds the quota. + |
+Attach shareable volume %s fail, volume status is %s, not available or inuse. + |
+Contact technical support. + |
+
400 + |
+BMS.1006 + |
+The running status of the BMS cannot be obtained. + |
+Server %s info is null or its status or its metadata is null. + |
+Try again later or contact technical support. + |
+
400 + |
+BMS.1007 + |
+Failed to call the API. + |
+Calling interface failed + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.1008 + |
+The disk type does not match the BMS. + |
+The server[%s] is not HANA server, volume[%s] does not match the server. + |
+Check whether the disk type matches the BMS or contact the technical support. + |
+
400 + |
+BMS.1009 + |
+The data disk has been attached to the BMS. + |
+Attach shareable volume %s fail, volume status is %s, the volume has been attached to the server. + |
+Select another data disk. + |
+
400 + |
+BMS.1011 + |
+The data disk is being attached. + |
+Attach shareable volume %s fail, volume status is %s, not available or inuse. + |
+Do not repeatedly attach the data disk. + |
+
400 + |
+BMS.3001 + |
+Failed to query the security group or subnet. + |
+Query security group failed: %s. +or +Query vpcId for subnet failed: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.3011 + |
+System error. + |
+Decoded token is null. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.3025 + |
+The EVS disk type is incorrect. + |
+Not support create shareable data volumes. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.3035 + |
+No matching disk is found for the BMS. + |
+Attach volume fail: the bmsid [%s] in volume metadata is not the same with bmsid [%s] in url. + |
+Ensure that the disk matches the BMS or contact technical support. + |
+
400 + |
+BMS.3039 + |
+Failed to verify password complexity. + |
+The password is illegal, reason: %s. + |
+See the password rules. + |
+
400 + |
+BMS.0246 + |
+Failed to query the VPC. + |
+The vpcId[%s] is invalid or not-existing. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0201 + |
+The parameters for creating the BMS are incorrectly configured. + |
+Fail to check the baremetal server params, reason: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0202 + |
+The data disk type is invalid. + |
+All volumes must be in same type. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0203 + |
+Parameter Volume is invalid. + |
+Volume is illegal, %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0204 + |
+The number of data disks exceeds the upper limit. + |
+The number of data volumes is illegal. The number is %d, but maximum number allow is %d. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0205 + |
+The BMS quantity is invalid. + |
+The number of baremetal servers is out of range for one quest. + |
+Change or delete the BMS quantity. + |
+
400 + |
+BMS.0206 + |
+Invalid name. + |
+The length of baremetal server name[%s] is %s. + |
+Change the name as required. + |
+
400 + |
+BMS.0207 + |
+No IP address can be specified when BMSs are created in a batch. + |
+VPC is illegal, reason: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0208 + |
+Failed to query the AZ. + |
+Fail to get RegionInfo by tenant [%s], reason: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0210 + |
+The length of the injected data exceeds the upper limit. + |
+The size of userdata [%d] is over quota limits [%d]. + |
+Modify the injected data. + |
+
400 + |
+BMS.0211 + |
+Invalid key. + |
+The image platform is [%s], support publicKey, reason: the publicKey is illegal, null is not allowed. + |
+Select a valid key. + |
+
400 + |
+BMS.0114 + |
+The disk to be detached is not in the disk list of the BMS. + |
+Volume %s is not in server %s attach volume list. + |
+Check whether the disk exists. + |
+
400 + |
+BMS.0212 + |
+The system is overloaded. + |
+System is overloaded, please try again later. + |
+Try again later. + |
+
400 + |
+BMS.0213 + |
+Insufficient permission. + |
+OBTAZ role verify fail: not allowed role. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0214 + |
+Failed to query the NIC. + |
+Query subnet[%s] failed: response is null. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0215 + |
+Failed to create the order. + |
+The response of inquiry order info is null or invalid. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0216 + |
+Failed to submit the order. + |
+Submit order[%s] failed: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0217 + |
+Failed to verify metadata. + |
+Create server fail, reason: metaData is illegal. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0222 + |
+The primary NIC cannot be deleted. + |
+primary port can not be deleted. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0223 + |
+Currently, only SCSI disks are supported. + |
+Only SCSI disks are supported. + |
+Select the SCSI disk type. + |
+
400 + |
+BMS.0039 + |
+The BMS has been shut down. + |
+Server is stopped, not allow to stop. + |
+Do not stop the BMS again. + |
+
400 + |
+BMS.0040 + |
+The BMS does not exist. + |
+The server does not exist. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0035 + |
+The BMS is being powered on and no other operations are allowed. + |
+Server is powering on, not allow to %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0036 + |
+The BMS is being powered off and no other operations are allowed. + |
+Server is powering off, not allow to %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0038 + |
+The BMS is running and cannot be started. + |
+Server is running, not allow to start. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0037 + |
+The BMS is being restarted and no other operations are allowed. + |
+Server is rebooting, not allow to %s. + |
+See the returned error message or contact technical support. + |
+
403 + |
+BMS.0288 + |
+You do not have permissions to perform this operation. + |
+Policy doesn't allow %s to be performed. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0290 + |
+The disk is not a shared disk and cannot be attached to multiple BMSs. + |
+Batch attach volume type must be sharable. + |
+Select a shared disk. + |
+
400 + |
+BMS.0071 + |
+If an EIP has been specified for creating the BMS, no other EIP can be created for the BMS. + |
+Using an existing EIP and creating a new EIP can't be used at the same time. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0072 + |
+An EIP cannot be used to create multiple BMSs. + |
+An existing EIP cannot be assigned to the ECSs created in batches. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0073 + |
+The bandwidth parameter is empty. + |
+Bandwidth info in eip is null. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0074 + |
+The EIP extension parameter is unavailable. + |
+Parameter exetendparam or chargingMode is null. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0075 + |
+The bandwidth ID is empty. + |
+Bandwidth info in eip is null. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0077 + |
+Invalid bandwidth size. + |
+PublicIp parameter is illegal, reason: %s. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0078 + |
+EIP quota is insufficient. + |
+Shared bandwidth has been bound to %d EIPs, quota is %d. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0079 + |
+The EIP bandwidth type is unavailable. + |
+Specifies the bandwidth of the shared type and the id cannot be empty. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0080 + |
+The subnet status is unavailable. + |
+Check subnet status failed. + |
+Check whether the subnet exists or whether it is in ACTIVE state. + |
+
400 + |
+BMS.0297 + |
+The submitted EVS disk order has not been paid. The EVS disk cannot be attached to or detached from the BMS. + |
+Fail to attach volume[%s]: volume is locked. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0054 + |
+Failed to verify the capacity. + |
+Check capacity fail, the number of capacity is: [%d], and req num is: [%d]. + |
+The capacity is insufficient. Contact technical support. + |
+
400 + |
+BMS.0055 + |
+Failed to query the quota. + |
+Query capacity fail, Flavor id is [%s], reason: [%s]. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.3037 + |
+Insufficient resources or failed to start the BMS. + |
+Insufficient resources or failed to start the BMS. + |
+Contact technical support. + |
+
400 + |
+BMS.3004 + |
+Failed to create the BMS due to an internal system error. + |
+Failed to create the BMS due to an internal system error. + |
+Contact technical support. + |
+
400 + |
+BMS.3005 + |
+Failed to create the port. + |
+Failed to create the port. + |
+Contact technical support. + |
+
400 + |
+BMS.3033 + |
+Failed to create the system disk. + |
+Failed to create the system disk. + |
+Contact technical support. + |
+
400 + |
+BMS.3029 + |
+Failed to create the system disk. The disk status is abnormal. + |
+Failed to create the system disk. The disk status is abnormal. + |
+Contact technical support. + |
+
400 + |
+BMS.3006 + |
+Failed to assign the EIP. + |
+Failed to assign the floating IP address. + |
+Contact technical support. + |
+
400 + |
+BMS.3021 + |
+Failed to create the data disk. + |
+Failed to create the data disk. + |
+Contact technical support. + |
+
400 + |
+BMS.3019 + |
+Failed to attach the data disk. + |
+Failed to attach the data disk. + |
+Contact technical support. + |
+
400 + |
+BMS.3038 + |
+Failed to assign an EIP. + |
+Failed to assign the EIP. + |
+Contact technical support. + |
+
400 + |
+BMS.0315 + |
+Disks cannot be attached to a BMS using this flavor. + |
+Disks cannot be attached to a BMS using this flavor[%s]. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.0360 + |
+The disk has been frozen and cannot be operated for the BMS. + |
+This operation cannot be performed because EVS Disk %s is frozen. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.3026 + |
+The password does not meet requirements. + |
+Password does not meet the requirements of the rule. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.3027 + |
+Invalid VPC parameters. + |
+VPC parameter is illegal. + |
+See the returned error message or contact technical support. + |
+
400 + |
+BMS.3028 + |
+Disk quota is abnormal. + |
+cinder quota check fail. + |
+See the returned error message or contact technical support. + |
+
400 + |
+Common.0018 + |
+tenant_id in the token is different from that in the URL. + |
+tenantId in token is not the same with in URL. + |
+Check whether the tenant token is correct. + |
+
400 + |
+BMS.0111 + |
+Password or key pair is not specified, or both specified. + |
+none or multiple passwords specified, please specify one. + |
+The password and key pair cannot be specified at the same time. Select one of them based on the login mode. + |
+
400 + |
+BMS.0395 + |
+Windows BMSs do not support remote login. + |
+The server[%s] is windows system and can not support remote login. + |
+See the returned error message or contact technical support. + |
+
extra_specs parameters specify the key-value pair of a BMS flavor. For example, baremetal:extBootType specifies the boot device of the BMS. Its value can be LocalDisk (local disk) or Volume (EVS disk). If you want to check whether a flavor supports quick provisioning, you can call this API.
+GET /v2.1/{project_id}/flavors/{flavor_id}/os-extra_specs
+Table 1 lists the parameters.
+ +Parameter + |
+Mandatory + |
+Description + |
+
|---|---|---|
project_id + |
+Yes + |
+Specifies the project ID. +For how to obtain the project ID, see Obtaining Required Information. + |
+
flavor_id + |
+Yes + |
+Specifies the flavor ID. +You can obtain the flavor ID from the BMS console or using the Querying BMS Flavors (Native OpenStack API) API. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
extra_specs + |
+Object + |
+Specifies the key-value pair of a BMS flavor. +
|
+
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 | {
+ "extra_specs": {
+ "capabilities:cpu_arch": "x86_64",
+ "baremetal:disk_detail": "SAS 8T",
+ "capabilities:hypervisor_type": "ironic",
+ "baremetal:__support_evs": "true",
+ "baremetal:extBootType": "LocalDisk",
+ "capabilities:board_type": "s2m",
+ "baremetal:net_num": "2",
+ "baremetal:netcard_detail": "2*10GE",
+ "baremetal:cpu_detail": "2*8coreIntel Xeon E5-2667 V43.2GHz",
+ "resource_type": "ironic",
+ "baremetal:memory_detail": "256GB DDR4 RAM(GB)"
+ }
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+Released On + |
+Description + |
+
|---|---|
2021-10-30 + |
+Modified the following content: +Optimized the descriptions for some APIs. + |
+
2019-04-25 + |
+Modified the following content: +Added response parameters in Querying API Versions (Native OpenStack API) and Querying an API Version (Native OpenStack API). + |
+
2019-01-30 + |
+Modified the following content: +
|
+
2018-10-15 + |
+Added the following content: + + |
+
2018-05-30 + |
+Modified the following content: +Adjusted the outline. + |
+
2018-03-30 + |
+Modified the following content: +
|
+
2018-02-07 + |
+Accepted in OTC 3.0. + |
+
2017-11-30 + |
+Modified the following content: +Changed availability_zone to a mandatory field in section Creating a BMS (Native OpenStack API). + |
+
2017-08-30 + |
+Modified the following content: +
|
+
2017-05-30 + |
+This issue is the first official release. + |
+
This interface is used to query all available Nova versions.
+GET /
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
versions + |
+Array of objects + |
+Specifies the list of all API versions. + |
+
id + |
+String + |
+Specifies the version ID, for example, v1. + |
+
links + |
+Array of objects + |
+Specifies the API URL. + |
+
href + |
+String + |
+Specifies the reference address of the current API version. + |
+
rel + |
+String + |
+Specifies the relationship between the current API version and the referenced address. + |
+
version + |
+String + |
+If the APIs of this version support minor versions, set this parameter to the maximum minor version supported. If not, leave this parameter blank. + |
+
status + |
+String + |
+Specifies the version status. Possible values are as follows: +
|
+
updated + |
+String + |
+Specifies the version release time, which must be the UTC time. +For example, the release time of v1 is 2014-06-28T12:20:21Z. + |
+
min_version + |
+String + |
+If the APIs of this version support minor versions, set this parameter to the supported minimum minor version. If not, leave this parameter blank. + |
+
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 | {
+ "versions": [
+ {
+ "links": [
+ {
+ "rel": "self",
+ "href": "https://192.168.82.231:443/v2/"
+ }
+ ],
+ "id": "v2.0",
+ "updated": "2018-09-21T12:33:21Z",
+ "status": "SUPPORTED"
+ }
+ ]
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+This API is used to query a specified API version.
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
version + |
+Object + |
+Specifies a specified version. + |
+
id + |
+String + |
+Specifies the version ID, for example, v1. + |
+
links + |
+Array of objects + |
+Specifies the API URL. + |
+
href + |
+String + |
+Specifies the reference address of the current API version. + |
+
rel + |
+String + |
+Specifies the relationship between the current API version and the referenced address. + |
+
version + |
+String + |
+If the APIs of this version support minor versions, set this parameter to the maximum minor version supported. If not, leave this parameter blank. + |
+
status + |
+String + |
+Specifies the version status. Possible values are as follows: +
|
+
updated + |
+String + |
+Specifies the version release time, which must be the UTC time. +For example, the release time of v1 is 2014-06-28T12:20:21Z. + |
+
min_version + |
+String + |
+If the APIs of this version support minor versions, set this parameter to the supported minimum minor version. If not, leave this parameter blank. + |
+
1 + 2 + 3 + 4 + 5 + 6 + 7 + 8 + 9 +10 +11 +12 +13 +14 +15 +16 +17 +18 +19 +20 +21 +22 +23 +24 +25 +26 | {
+ "version": {
+ "min_version": "",
+ "media-types": [
+ {
+ "type": "application/vnd.openstack.compute+json;version=2",
+ "base": "application/json"
+ }
+ ],
+ "links": [
+ {
+ "rel": "self",
+ "href": "https://ecs.service.domain.com:443/v2/"
+ },
+ {
+ "rel": "describedby",
+ "href": "http://docs.openstack.org/",
+ "type": "text/html"
+ }
+ ],
+ "id": "v2.0",
+ "updated": "1999-02-20T11:33:21Z",
+ "version": "",
+ "status": "SUPPORTED"
+ }
+}
+ |
Returned Values + |
+Description + |
+
|---|---|
200 + |
+The request has been successfully processed. + |
+
For details about other returned values, see Status Codes.
+See Error Codes.
+Public cloud APIs comply with the RESTful API design principles. REST-based web services are organized into resources. Each resource is identified by one or more Uniform Resource Identifiers (URIs). An application accesses a resource based on the resource's Unified Resource Locator (URL). A URL is usually in the following format: https://Endpoint/uri. In the URL, uri indicates the resource path, that is, the API access path.
+Public cloud APIs use HTTPS as the transmission protocol. Requests/Responses are transmitted using JSON messages, with the media type represented by Application/json.
+For details about how to use APIs, see API Usage Guidelines.
+