diff --git a/docs/eip/api-ref/ALL_META.TXT.json b/docs/eip/api-ref/ALL_META.TXT.json new file mode 100644 index 000000000..ab1952b28 --- /dev/null +++ b/docs/eip/api-ref/ALL_META.TXT.json @@ -0,0 +1,542 @@ +[ + { + "uri":"eip_api01_0000.html", + "product_code":"eip", + "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":"eip_api04_0000.html", + "product_code":"eip", + "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":"APIs", + "title":"APIs", + "githuburl":"" + }, + { + "uri":"eip_api_0000.html", + "product_code":"eip", + "code":"3", + "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":"Elastic IP", + "title":"Elastic IP", + "githuburl":"" + }, + { + "uri":"eip_api_0001.html", + "product_code":"eip", + "code":"4", + "des":"This API is used to assign an EIP.The EIP service provides independent public IP addresses and bandwidth for Internet access. EIPs can be bound to or unbound from ECSs, B", + "doc_type":"api", + "kw":"Assigning an EIP,Elastic IP,API Reference", + "title":"Assigning an EIP", + "githuburl":"" + }, + { + "uri":"eip_api_0002.html", + "product_code":"eip", + "code":"5", + "des":"This API is used to query a specific EIP.GET /v1/{project_id}/publicips/{publicip_id}Table 1 describes the parameters.Parameter descriptionNameMandatoryDescriptionproject", + "doc_type":"api", + "kw":"Querying an EIP,Elastic IP,API Reference", + "title":"Querying an EIP", + "githuburl":"" + }, + { + "uri":"eip_api_0003.html", + "product_code":"eip", + "code":"6", + "des":"This API is used to query EIPs.GET /v1/{project_id}/publicipsTable 1 describes the parameters.Parameter descriptionNameMandatoryTypeDescriptionproject_idYesStringSpecifie", + "doc_type":"api", + "kw":"Querying EIPs,Elastic IP,API Reference", + "title":"Querying EIPs", + "githuburl":"" + }, + { + "uri":"eip_api_0004.html", + "product_code":"eip", + "code":"7", + "des":"This API is used to bind an EIP to a NIC, or unbind an EIP from a NIC.This API cannot be used to bind an EIP to or unbind an EIP from a dedicated load balancer.PUT /v1/{p", + "doc_type":"api", + "kw":"Updating an EIP,Elastic IP,API Reference", + "title":"Updating an EIP", + "githuburl":"" + }, + { + "uri":"eip_api_0005.html", + "product_code":"eip", + "code":"8", + "des":"This API is used to release an EIP.DELETE /v1/{project_id}/publicips/{publicip_id}Table 1 describes the parameters.Parameter descriptionNameMandatoryDescriptionproject_id", + "doc_type":"api", + "kw":"Releasing an EIP,Elastic IP,API Reference", + "title":"Releasing an EIP", + "githuburl":"" + }, + { + "uri":"eip_apifloatip_0000.html", + "product_code":"eip", + "code":"9", + "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":"Floating IP Address (IPv6)", + "title":"Floating IP Address (IPv6)", + "githuburl":"" + }, + { + "uri":"eip_apifloatip_0001.html", + "product_code":"eip", + "code":"10", + "des":"This API is used to query all floating IP addresses accessible to the tenant submitting the request.GET /v2.0/eip/floatingips_v6Example:Table 1 describes the parameters.R", + "doc_type":"api", + "kw":"Querying Floating IP Addresses,Floating IP Address (IPv6),API Reference", + "title":"Querying Floating IP Addresses", + "githuburl":"" + }, + { + "uri":"eip_apifloatip_0002.html", + "product_code":"eip", + "code":"11", + "des":"This API is used to query details about a specific floating IP address accessible to the tenant submitting the request.GET /v2.0/eip/floatingips_v6/{floatingip_id}Request", + "doc_type":"api", + "kw":"Querying a Floating IP Address,Floating IP Address (IPv6),API Reference", + "title":"Querying a Floating IP Address", + "githuburl":"" + }, + { + "uri":"eip_apifloatip_0003.html", + "product_code":"eip", + "code":"12", + "des":"This API is used to assign a floating IP address and associates it with an internal port.RestrictionsYou can use GET /v2.0/networks?router:external=True or run the neutro", + "doc_type":"api", + "kw":"Assigning a Floating IP Address,Floating IP Address (IPv6),API Reference", + "title":"Assigning a Floating IP Address", + "githuburl":"" + }, + { + "uri":"eip_apifloatip_0004.html", + "product_code":"eip", + "code":"13", + "des":"This API is used to update a specific floating IP address and the port associated with the IP address. If port_id is left blank, the floating IP address has been unbound ", + "doc_type":"api", + "kw":"Updating a Floating IP Address,Floating IP Address (IPv6),API Reference", + "title":"Updating a Floating IP Address", + "githuburl":"" + }, + { + "uri":"eip_apifloatip_0005.html", + "product_code":"eip", + "code":"14", + "des":"This API is used to delete a floating IP address.DELETE /v2.0/eip/floatingips_v6/{floatingip_id}Request parameterNoneNoneExample requestDELETE https://{Endpoint}/v2.0/eip", + "doc_type":"api", + "kw":"Deleting a Floating IP Address,Floating IP Address (IPv6),API Reference", + "title":"Deleting a Floating IP Address", + "githuburl":"" + }, + { + "uri":"eip_apiBandwidth_0000.html", + "product_code":"eip", + "code":"15", + "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":"Bandwidth", + "title":"Bandwidth", + "githuburl":"" + }, + { + "uri":"eip_apiBandwidth_0001.html", + "product_code":"eip", + "code":"16", + "des":"This API is used to query details about a bandwidth.GET /v1/{project_id}/bandwidths/{bandwidth_id}Table 1 describes the parameters.Parameter descriptionNameMandatoryDescr", + "doc_type":"api", + "kw":"Querying a Bandwidth,Bandwidth,API Reference", + "title":"Querying a Bandwidth", + "githuburl":"" + }, + { + "uri":"eip_apiBandwidth_0002.html", + "product_code":"eip", + "code":"17", + "des":"This API is used to query bandwidths using search criteria.GET /v1/{project_id}/bandwidthsTable 1 describes the parameters.Parameter descriptionNameMandatoryTypeDescripti", + "doc_type":"api", + "kw":"Querying Bandwidths,Bandwidth,API Reference", + "title":"Querying Bandwidths", + "githuburl":"" + }, + { + "uri":"eip_apiBandwidth_0003.html", + "product_code":"eip", + "code":"18", + "des":"This API is used to update information about a bandwidth.PUT /v1/{project_id}/bandwidths/{bandwidth_id}Table 1 describes the parameters.Parameter descriptionNameMandatory", + "doc_type":"api", + "kw":"Updating a Bandwidth,Bandwidth,API Reference", + "title":"Updating a Bandwidth", + "githuburl":"" + }, + { + "uri":"eip_apisharedbandwidth_0000.html", + "product_code":"eip", + "code":"19", + "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":"Bandwidth (V2.0)", + "title":"Bandwidth (V2.0)", + "githuburl":"" + }, + { + "uri":"eip_apisharedbandwidth_0001.html", + "product_code":"eip", + "code":"20", + "des":"This API is used to assign a shared bandwidth.POST /v2.0/{project_id}/bandwidthsTable 1 describes the parameters.Parameter descriptionNameMandatoryDescriptionproject_idYe", + "doc_type":"api", + "kw":"Assigning a Shared Bandwidth,Bandwidth (V2.0),API Reference", + "title":"Assigning a Shared Bandwidth", + "githuburl":"" + }, + { + "uri":"eip_apisharedbandwidth_0003.html", + "product_code":"eip", + "code":"21", + "des":"This API is used to delete a shared bandwidth.DELETE /v2.0/{project_id}/bandwidths/{bandwidth_id}Table 1 describes the parameters.Parameter descriptionNameMandatoryDescri", + "doc_type":"api", + "kw":"Deleting a Shared Bandwidth,Bandwidth (V2.0),API Reference", + "title":"Deleting a Shared Bandwidth", + "githuburl":"" + }, + { + "uri":"eip_apisharedbandwidth_0004.html", + "product_code":"eip", + "code":"22", + "des":"This API is used to add an EIP to a shared bandwidth.POST /v2.0/{project_id}/bandwidths/{bandwidth_id}/insertTable 1 describes the parameters.Parameter descriptionNameMan", + "doc_type":"api", + "kw":"Adding an EIP to a Shared Bandwidth,Bandwidth (V2.0),API Reference", + "title":"Adding an EIP to a Shared Bandwidth", + "githuburl":"" + }, + { + "uri":"eip_apisharedbandwidth_0005.html", + "product_code":"eip", + "code":"23", + "des":"This API is used to remove an EIP from a shared bandwidth.POST /v2.0/{project_id}/bandwidths/{bandwidth_id}/removeTable 1 describes the parameters.Parameter descriptionNa", + "doc_type":"api", + "kw":"Removing an EIP from a Shared Bandwidth,Bandwidth (V2.0),API Reference", + "title":"Removing an EIP from a Shared Bandwidth", + "githuburl":"" + }, + { + "uri":"eip_apiquota_0000.html", + "product_code":"eip", + "code":"24", + "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":"Quota", + "title":"Quota", + "githuburl":"" + }, + { + "uri":"eip_apiquota_0001.html", + "product_code":"eip", + "code":"25", + "des":"This API is used to query network resource quotas of a tenant. The network resources include VPCs, subnets, security groups, security group rules, EIPs, and VPNs.This API", + "doc_type":"api", + "kw":"Querying the Quota,Quota,API Reference", + "title":"Querying the Quota", + "githuburl":"" + }, + { + "uri":"eip_apitag_0000.html", + "product_code":"eip", + "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":"EIP Tag Management", + "title":"EIP Tag Management", + "githuburl":"" + }, + { + "uri":"eip_apitag_0001.html", + "product_code":"eip", + "code":"27", + "des":"This API is used to create a tag for an EIP.POST /v2.0/{project_id}/publicips/{publicip_id}/tagsTable 1 describes the parameters.Request parameterRequest parameterParamet", + "doc_type":"api", + "kw":"Creating a Tag for an EIP,EIP Tag Management,API Reference", + "title":"Creating a Tag for an EIP", + "githuburl":"" + }, + { + "uri":"eip_apitag_0002.html", + "product_code":"eip", + "code":"28", + "des":"This API is used to query tags of a specified EIP.GET /v2.0/{project_id}/publicips/{publicip_id}/tagsTable 1 describes the parameters.Request parameterNoneNoneExample req", + "doc_type":"api", + "kw":"Querying EIP Tags,EIP Tag Management,API Reference", + "title":"Querying EIP Tags", + "githuburl":"" + }, + { + "uri":"eip_apitag_0003.html", + "product_code":"eip", + "code":"29", + "des":"This API is used to delete an EIP tag.DELETE /v2.0/{project_id}/publicips/{publicip_id}/tags/{key}Table 1 describes the parameters.Request parameterNoneNoneExample reques", + "doc_type":"api", + "kw":"Deleting an EIP Tag,EIP Tag Management,API Reference", + "title":"Deleting an EIP Tag", + "githuburl":"" + }, + { + "uri":"eip_apitag_0004.html", + "product_code":"eip", + "code":"30", + "des":"This API is used to add multiple tags to or delete multiple tags from an EIP at a time.This API is idempotent.If there are duplicate keys in the request body when you add", + "doc_type":"api", + "kw":"Batch Creating or Deleting EIP Tags,EIP Tag Management,API Reference", + "title":"Batch Creating or Deleting EIP Tags", + "githuburl":"" + }, + { + "uri":"eip_apitag_0005.html", + "product_code":"eip", + "code":"31", + "des":"This API is used to query EIPs by tag.POST /v2.0/{project_id}/publicips/resource_instances/actionTable 1 describes the parameters.Request parameterRequest parameterParame", + "doc_type":"api", + "kw":"Querying EIPs by Tag,EIP Tag Management,API Reference", + "title":"Querying EIPs by Tag", + "githuburl":"" + }, + { + "uri":"eip_apitag_0006.html", + "product_code":"eip", + "code":"32", + "des":"This API is used to query all EIP tags of a tenant in a specified region.GET /v2.0/{project_id}/publicips/tagsTable 1 describes the parameters.Request parameterNoneNoneEx", + "doc_type":"api", + "kw":"Querying EIP Tags in a Specified Project,EIP Tag Management,API Reference", + "title":"Querying EIP Tags in a Specified Project", + "githuburl":"" + }, + { + "uri":"eip_openstackapi_0000.html", + "product_code":"eip", + "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":"Native OpenStack Neutron APIs V2.0", + "title":"Native OpenStack Neutron APIs V2.0", + "githuburl":"" + }, + { + "uri":"eip_openstackapi_0001.html", + "product_code":"eip", + "code":"34", + "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 Information", + "title":"API Version Information", + "githuburl":"" + }, + { + "uri":"eip_openstackapi_0002.html", + "product_code":"eip", + "code":"35", + "des":"This API is used to query all available versions of a native OpenStack API.GET /Request parameterNoneExample requestResponse parameterExample responseSee Status Codes.See", + "doc_type":"api", + "kw":"Querying API Versions,API Version Information,API Reference", + "title":"Querying API Versions", + "githuburl":"" + }, + { + "uri":"eip_openstackapi_0003.html", + "product_code":"eip", + "code":"36", + "des":"This API is used to query the version of a specified API.GET /{api_version}Table 1 describes the parameters.Request parameterNoneNoneExample requestGET https://{Endpoint}", + "doc_type":"api", + "kw":"Querying a Specified API Version,API Version Information,API Reference", + "title":"Querying a Specified API Version", + "githuburl":"" + }, + { + "uri":"eip_openstackapi_0004.html", + "product_code":"eip", + "code":"37", + "des":"Neutron APIs v2.0 provides the pagination function. You can set parameters limit and marker in the URL to enable the desired number of items to be returned. All returned ", + "doc_type":"api", + "kw":"Pagination,API Version Information,API Reference", + "title":"Pagination", + "githuburl":"" + }, + { + "uri":"eip_openstackapi_0005.html", + "product_code":"eip", + "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":"Floating IP Address", + "title":"Floating IP Address", + "githuburl":"" + }, + { + "uri":"eip_openstackapi_0006.html", + "product_code":"eip", + "code":"39", + "des":"This API is used to query all floating IP addresses accessible to the tenant submitting the request.You can query the detailed information about a specified floating IP a", + "doc_type":"api", + "kw":"Querying Floating IP Addresses,Floating IP Address,API Reference", + "title":"Querying Floating IP Addresses", + "githuburl":"" + }, + { + "uri":"eip_openstackapi_0007.html", + "product_code":"eip", + "code":"40", + "des":"This API is used to query details about a specified floating IP address, including the floating IP address status, ID of the router to which the floating IP address belon", + "doc_type":"api", + "kw":"Querying a Floating IP Address,Floating IP Address,API Reference", + "title":"Querying a Floating IP Address", + "githuburl":"" + }, + { + "uri":"eip_openstackapi_0008.html", + "product_code":"eip", + "code":"41", + "des":"When assigning a floating IP address, you need to obtain the external network ID floating_network_id of the floating IP address.You can use GET /v2.0/networks?router:exte", + "doc_type":"api", + "kw":"Assigning a Floating IP Address,Floating IP Address,API Reference", + "title":"Assigning a Floating IP Address", + "githuburl":"" + }, + { + "uri":"eip_openstackapi_0009.html", + "product_code":"eip", + "code":"42", + "des":"This API is used to update a floating IP address.During the update, the ID of the floating IP address must be provided in the URL.If port_id is left blank, the floating I", + "doc_type":"api", + "kw":"Updating a Floating IP Address,Floating IP Address,API Reference", + "title":"Updating a Floating IP Address", + "githuburl":"" + }, + { + "uri":"eip_openstackapi_0010.html", + "product_code":"eip", + "code":"43", + "des":"This API is used to delete a floating IP address.DELETE /v2.0/floatingips/{floatingip_id}Table 1 describes the parameters.NoneNoneExample requestExample responseNoneSee S", + "doc_type":"api", + "kw":"Deleting a Floating IP Address,Floating IP Address,API Reference", + "title":"Deleting a Floating IP Address", + "githuburl":"" + }, + { + "uri":"eip_apipermission_0000.html", + "product_code":"eip", + "code":"44", + "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":"Permissions Policies and Supported Actions", + "title":"Permissions Policies and Supported Actions", + "githuburl":"" + }, + { + "uri":"eip_apipermission_0002.html", + "product_code":"eip", + "code":"45", + "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":"Elastic IP,Permissions Policies and Supported Actions,API Reference", + "title":"Elastic IP", + "githuburl":"" + }, + { + "uri":"eip_apipermission_0003.html", + "product_code":"eip", + "code":"46", + "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":"Bandwidth,Permissions Policies and Supported Actions,API Reference", + "title":"Bandwidth", + "githuburl":"" + }, + { + "uri":"eip_apipermission_0004.html", + "product_code":"eip", + "code":"47", + "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":"Bandwidth (V2.0),Permissions Policies and Supported Actions,API Reference", + "title":"Bandwidth (V2.0)", + "githuburl":"" + }, + { + "uri":"eip_apipermission_0006.html", + "product_code":"eip", + "code":"48", + "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":"Floating IP Address (OpenStack Neutron API),Permissions Policies and Supported Actions,API Reference", + "title":"Floating IP Address (OpenStack Neutron API)", + "githuburl":"" + }, + { + "uri":"eip_apipermission_0007.html", + "product_code":"eip", + "code":"49", + "des":"If you have insufficient permissions, response code 200 will be returned when you query network resources and an empty list will be displayed.", + "doc_type":"api", + "kw":"Precautions for API Permissions,Permissions Policies and Supported Actions,API Reference", + "title":"Precautions for API Permissions", + "githuburl":"" + }, + { + "uri":"eip_api06_0001.html", + "product_code":"eip", + "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":"Appendix", + "title":"Appendix", + "githuburl":"" + }, + { + "uri":"eip_api06_0003.html", + "product_code":"eip", + "code":"51", + "des":"This section describes monitoring metrics reported by VPC to Cloud Eye as well as their namespaces and dimensions. You can use APIs provided by Cloud Eye to query the mon", + "doc_type":"api", + "kw":"VPC Monitoring Metrics,Appendix,API Reference", + "title":"VPC Monitoring Metrics", + "githuburl":"" + }, + { + "uri":"eip_api05_0001.html", + "product_code":"eip", + "code":"52", + "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":"Status Codes,Appendix,API Reference", + "title":"Status Codes", + "githuburl":"" + }, + { + "uri":"eip_api05_0002.html", + "product_code":"eip", + "code":"53", + "des":"If an error occurs when an API is called, error information is returned. This section describes the error information for EIP APIs (excluding native OpenStack APIs).", + "doc_type":"api", + "kw":"Error Codes,Appendix,API Reference", + "title":"Error Codes", + "githuburl":"" + }, + { + "uri":"eip_api07_0000.html", + "product_code":"eip", + "code":"54", + "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/eip/api-ref/CLASS.TXT.json b/docs/eip/api-ref/CLASS.TXT.json new file mode 100644 index 000000000..85d79e321 --- /dev/null +++ b/docs/eip/api-ref/CLASS.TXT.json @@ -0,0 +1,488 @@ +[ + { + "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":"eip", + "title":"API Usage Guidelines", + "uri":"eip_api01_0000.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":"eip", + "title":"APIs", + "uri":"eip_api04_0000.html", + "doc_type":"api", + "p_code":"", + "code":"2" + }, + { + "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":"eip", + "title":"Elastic IP", + "uri":"eip_api_0000.html", + "doc_type":"api", + "p_code":"2", + "code":"3" + }, + { + "desc":"This API is used to assign an EIP.The EIP service provides independent public IP addresses and bandwidth for Internet access. EIPs can be bound to or unbound from ECSs, B", + "product_code":"eip", + "title":"Assigning an EIP", + "uri":"eip_api_0001.html", + "doc_type":"api", + "p_code":"3", + "code":"4" + }, + { + "desc":"This API is used to query a specific EIP.GET /v1/{project_id}/publicips/{publicip_id}Table 1 describes the parameters.Parameter descriptionNameMandatoryDescriptionproject", + "product_code":"eip", + "title":"Querying an EIP", + "uri":"eip_api_0002.html", + "doc_type":"api", + "p_code":"3", + "code":"5" + }, + { + "desc":"This API is used to query EIPs.GET /v1/{project_id}/publicipsTable 1 describes the parameters.Parameter descriptionNameMandatoryTypeDescriptionproject_idYesStringSpecifie", + "product_code":"eip", + "title":"Querying EIPs", + "uri":"eip_api_0003.html", + "doc_type":"api", + "p_code":"3", + "code":"6" + }, + { + "desc":"This API is used to bind an EIP to a NIC, or unbind an EIP from a NIC.This API cannot be used to bind an EIP to or unbind an EIP from a dedicated load balancer.PUT /v1/{p", + "product_code":"eip", + "title":"Updating an EIP", + "uri":"eip_api_0004.html", + "doc_type":"api", + "p_code":"3", + "code":"7" + }, + { + "desc":"This API is used to release an EIP.DELETE /v1/{project_id}/publicips/{publicip_id}Table 1 describes the parameters.Parameter descriptionNameMandatoryDescriptionproject_id", + "product_code":"eip", + "title":"Releasing an EIP", + "uri":"eip_api_0005.html", + "doc_type":"api", + "p_code":"3", + "code":"8" + }, + { + "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":"eip", + "title":"Floating IP Address (IPv6)", + "uri":"eip_apifloatip_0000.html", + "doc_type":"api", + "p_code":"2", + "code":"9" + }, + { + "desc":"This API is used to query all floating IP addresses accessible to the tenant submitting the request.GET /v2.0/eip/floatingips_v6Example:Table 1 describes the parameters.R", + "product_code":"eip", + "title":"Querying Floating IP Addresses", + "uri":"eip_apifloatip_0001.html", + "doc_type":"api", + "p_code":"9", + "code":"10" + }, + { + "desc":"This API is used to query details about a specific floating IP address accessible to the tenant submitting the request.GET /v2.0/eip/floatingips_v6/{floatingip_id}Request", + "product_code":"eip", + "title":"Querying a Floating IP Address", + "uri":"eip_apifloatip_0002.html", + "doc_type":"api", + "p_code":"9", + "code":"11" + }, + { + "desc":"This API is used to assign a floating IP address and associates it with an internal port.RestrictionsYou can use GET /v2.0/networks?router:external=True or run the neutro", + "product_code":"eip", + "title":"Assigning a Floating IP Address", + "uri":"eip_apifloatip_0003.html", + "doc_type":"api", + "p_code":"9", + "code":"12" + }, + { + "desc":"This API is used to update a specific floating IP address and the port associated with the IP address. If port_id is left blank, the floating IP address has been unbound ", + "product_code":"eip", + "title":"Updating a Floating IP Address", + "uri":"eip_apifloatip_0004.html", + "doc_type":"api", + "p_code":"9", + "code":"13" + }, + { + "desc":"This API is used to delete a floating IP address.DELETE /v2.0/eip/floatingips_v6/{floatingip_id}Request parameterNoneNoneExample requestDELETE https://{Endpoint}/v2.0/eip", + "product_code":"eip", + "title":"Deleting a Floating IP Address", + "uri":"eip_apifloatip_0005.html", + "doc_type":"api", + "p_code":"9", + "code":"14" + }, + { + "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":"eip", + "title":"Bandwidth", + "uri":"eip_apiBandwidth_0000.html", + "doc_type":"api", + "p_code":"2", + "code":"15" + }, + { + "desc":"This API is used to query details about a bandwidth.GET /v1/{project_id}/bandwidths/{bandwidth_id}Table 1 describes the parameters.Parameter descriptionNameMandatoryDescr", + "product_code":"eip", + "title":"Querying a Bandwidth", + "uri":"eip_apiBandwidth_0001.html", + "doc_type":"api", + "p_code":"15", + "code":"16" + }, + { + "desc":"This API is used to query bandwidths using search criteria.GET /v1/{project_id}/bandwidthsTable 1 describes the parameters.Parameter descriptionNameMandatoryTypeDescripti", + "product_code":"eip", + "title":"Querying Bandwidths", + "uri":"eip_apiBandwidth_0002.html", + "doc_type":"api", + "p_code":"15", + "code":"17" + }, + { + "desc":"This API is used to update information about a bandwidth.PUT /v1/{project_id}/bandwidths/{bandwidth_id}Table 1 describes the parameters.Parameter descriptionNameMandatory", + "product_code":"eip", + "title":"Updating a Bandwidth", + "uri":"eip_apiBandwidth_0003.html", + "doc_type":"api", + "p_code":"15", + "code":"18" + }, + { + "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":"eip", + "title":"Bandwidth (V2.0)", + "uri":"eip_apisharedbandwidth_0000.html", + "doc_type":"api", + "p_code":"2", + "code":"19" + }, + { + "desc":"This API is used to assign a shared bandwidth.POST /v2.0/{project_id}/bandwidthsTable 1 describes the parameters.Parameter descriptionNameMandatoryDescriptionproject_idYe", + "product_code":"eip", + "title":"Assigning a Shared Bandwidth", + "uri":"eip_apisharedbandwidth_0001.html", + "doc_type":"api", + "p_code":"19", + "code":"20" + }, + { + "desc":"This API is used to delete a shared bandwidth.DELETE /v2.0/{project_id}/bandwidths/{bandwidth_id}Table 1 describes the parameters.Parameter descriptionNameMandatoryDescri", + "product_code":"eip", + "title":"Deleting a Shared Bandwidth", + "uri":"eip_apisharedbandwidth_0003.html", + "doc_type":"api", + "p_code":"19", + "code":"21" + }, + { + "desc":"This API is used to add an EIP to a shared bandwidth.POST /v2.0/{project_id}/bandwidths/{bandwidth_id}/insertTable 1 describes the parameters.Parameter descriptionNameMan", + "product_code":"eip", + "title":"Adding an EIP to a Shared Bandwidth", + "uri":"eip_apisharedbandwidth_0004.html", + "doc_type":"api", + "p_code":"19", + "code":"22" + }, + { + "desc":"This API is used to remove an EIP from a shared bandwidth.POST /v2.0/{project_id}/bandwidths/{bandwidth_id}/removeTable 1 describes the parameters.Parameter descriptionNa", + "product_code":"eip", + "title":"Removing an EIP from a Shared Bandwidth", + "uri":"eip_apisharedbandwidth_0005.html", + "doc_type":"api", + "p_code":"19", + "code":"23" + }, + { + "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":"eip", + "title":"Quota", + "uri":"eip_apiquota_0000.html", + "doc_type":"api", + "p_code":"2", + "code":"24" + }, + { + "desc":"This API is used to query network resource quotas of a tenant. The network resources include VPCs, subnets, security groups, security group rules, EIPs, and VPNs.This API", + "product_code":"eip", + "title":"Querying the Quota", + "uri":"eip_apiquota_0001.html", + "doc_type":"api", + "p_code":"24", + "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":"eip", + "title":"EIP Tag Management", + "uri":"eip_apitag_0000.html", + "doc_type":"api", + "p_code":"2", + "code":"26" + }, + { + "desc":"This API is used to create a tag for an EIP.POST /v2.0/{project_id}/publicips/{publicip_id}/tagsTable 1 describes the parameters.Request parameterRequest parameterParamet", + "product_code":"eip", + "title":"Creating a Tag for an EIP", + "uri":"eip_apitag_0001.html", + "doc_type":"api", + "p_code":"26", + "code":"27" + }, + { + "desc":"This API is used to query tags of a specified EIP.GET /v2.0/{project_id}/publicips/{publicip_id}/tagsTable 1 describes the parameters.Request parameterNoneNoneExample req", + "product_code":"eip", + "title":"Querying EIP Tags", + "uri":"eip_apitag_0002.html", + "doc_type":"api", + "p_code":"26", + "code":"28" + }, + { + "desc":"This API is used to delete an EIP tag.DELETE /v2.0/{project_id}/publicips/{publicip_id}/tags/{key}Table 1 describes the parameters.Request parameterNoneNoneExample reques", + "product_code":"eip", + "title":"Deleting an EIP Tag", + "uri":"eip_apitag_0003.html", + "doc_type":"api", + "p_code":"26", + "code":"29" + }, + { + "desc":"This API is used to add multiple tags to or delete multiple tags from an EIP at a time.This API is idempotent.If there are duplicate keys in the request body when you add", + "product_code":"eip", + "title":"Batch Creating or Deleting EIP Tags", + "uri":"eip_apitag_0004.html", + "doc_type":"api", + "p_code":"26", + "code":"30" + }, + { + "desc":"This API is used to query EIPs by tag.POST /v2.0/{project_id}/publicips/resource_instances/actionTable 1 describes the parameters.Request parameterRequest parameterParame", + "product_code":"eip", + "title":"Querying EIPs by Tag", + "uri":"eip_apitag_0005.html", + "doc_type":"api", + "p_code":"26", + "code":"31" + }, + { + "desc":"This API is used to query all EIP tags of a tenant in a specified region.GET /v2.0/{project_id}/publicips/tagsTable 1 describes the parameters.Request parameterNoneNoneEx", + "product_code":"eip", + "title":"Querying EIP Tags in a Specified Project", + "uri":"eip_apitag_0006.html", + "doc_type":"api", + "p_code":"26", + "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":"eip", + "title":"Native OpenStack Neutron APIs V2.0", + "uri":"eip_openstackapi_0000.html", + "doc_type":"api", + "p_code":"", + "code":"33" + }, + { + "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":"eip", + "title":"API Version Information", + "uri":"eip_openstackapi_0001.html", + "doc_type":"api", + "p_code":"33", + "code":"34" + }, + { + "desc":"This API is used to query all available versions of a native OpenStack API.GET /Request parameterNoneExample requestResponse parameterExample responseSee Status Codes.See", + "product_code":"eip", + "title":"Querying API Versions", + "uri":"eip_openstackapi_0002.html", + "doc_type":"api", + "p_code":"34", + "code":"35" + }, + { + "desc":"This API is used to query the version of a specified API.GET /{api_version}Table 1 describes the parameters.Request parameterNoneNoneExample requestGET https://{Endpoint}", + "product_code":"eip", + "title":"Querying a Specified API Version", + "uri":"eip_openstackapi_0003.html", + "doc_type":"api", + "p_code":"34", + "code":"36" + }, + { + "desc":"Neutron APIs v2.0 provides the pagination function. You can set parameters limit and marker in the URL to enable the desired number of items to be returned. All returned ", + "product_code":"eip", + "title":"Pagination", + "uri":"eip_openstackapi_0004.html", + "doc_type":"api", + "p_code":"34", + "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":"eip", + "title":"Floating IP Address", + "uri":"eip_openstackapi_0005.html", + "doc_type":"api", + "p_code":"33", + "code":"38" + }, + { + "desc":"This API is used to query all floating IP addresses accessible to the tenant submitting the request.You can query the detailed information about a specified floating IP a", + "product_code":"eip", + "title":"Querying Floating IP Addresses", + "uri":"eip_openstackapi_0006.html", + "doc_type":"api", + "p_code":"38", + "code":"39" + }, + { + "desc":"This API is used to query details about a specified floating IP address, including the floating IP address status, ID of the router to which the floating IP address belon", + "product_code":"eip", + "title":"Querying a Floating IP Address", + "uri":"eip_openstackapi_0007.html", + "doc_type":"api", + "p_code":"38", + "code":"40" + }, + { + "desc":"When assigning a floating IP address, you need to obtain the external network ID floating_network_id of the floating IP address.You can use GET /v2.0/networks?router:exte", + "product_code":"eip", + "title":"Assigning a Floating IP Address", + "uri":"eip_openstackapi_0008.html", + "doc_type":"api", + "p_code":"38", + "code":"41" + }, + { + "desc":"This API is used to update a floating IP address.During the update, the ID of the floating IP address must be provided in the URL.If port_id is left blank, the floating I", + "product_code":"eip", + "title":"Updating a Floating IP Address", + "uri":"eip_openstackapi_0009.html", + "doc_type":"api", + "p_code":"38", + "code":"42" + }, + { + "desc":"This API is used to delete a floating IP address.DELETE /v2.0/floatingips/{floatingip_id}Table 1 describes the parameters.NoneNoneExample requestExample responseNoneSee S", + "product_code":"eip", + "title":"Deleting a Floating IP Address", + "uri":"eip_openstackapi_0010.html", + "doc_type":"api", + "p_code":"38", + "code":"43" + }, + { + "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":"eip", + "title":"Permissions Policies and Supported Actions", + "uri":"eip_apipermission_0000.html", + "doc_type":"api", + "p_code":"", + "code":"44" + }, + { + "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":"eip", + "title":"Elastic IP", + "uri":"eip_apipermission_0002.html", + "doc_type":"api", + "p_code":"44", + "code":"45" + }, + { + "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":"eip", + "title":"Bandwidth", + "uri":"eip_apipermission_0003.html", + "doc_type":"api", + "p_code":"44", + "code":"46" + }, + { + "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":"eip", + "title":"Bandwidth (V2.0)", + "uri":"eip_apipermission_0004.html", + "doc_type":"api", + "p_code":"44", + "code":"47" + }, + { + "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":"eip", + "title":"Floating IP Address (OpenStack Neutron API)", + "uri":"eip_apipermission_0006.html", + "doc_type":"api", + "p_code":"44", + "code":"48" + }, + { + "desc":"If you have insufficient permissions, response code 200 will be returned when you query network resources and an empty list will be displayed.", + "product_code":"eip", + "title":"Precautions for API Permissions", + "uri":"eip_apipermission_0007.html", + "doc_type":"api", + "p_code":"44", + "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":"eip", + "title":"Appendix", + "uri":"eip_api06_0001.html", + "doc_type":"api", + "p_code":"", + "code":"50" + }, + { + "desc":"This section describes monitoring metrics reported by VPC to Cloud Eye as well as their namespaces and dimensions. You can use APIs provided by Cloud Eye to query the mon", + "product_code":"eip", + "title":"VPC Monitoring Metrics", + "uri":"eip_api06_0003.html", + "doc_type":"api", + "p_code":"50", + "code":"51" + }, + { + "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":"eip", + "title":"Status Codes", + "uri":"eip_api05_0001.html", + "doc_type":"api", + "p_code":"50", + "code":"52" + }, + { + "desc":"If an error occurs when an API is called, error information is returned. This section describes the error information for EIP APIs (excluding native OpenStack APIs).", + "product_code":"eip", + "title":"Error Codes", + "uri":"eip_api05_0002.html", + "doc_type":"api", + "p_code":"50", + "code":"53" + }, + { + "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":"eip", + "title":"Change History", + "uri":"eip_api07_0000.html", + "doc_type":"api", + "p_code":"", + "code":"54" + } +] \ No newline at end of file diff --git a/docs/eip/api-ref/PARAMETERS.txt b/docs/eip/api-ref/PARAMETERS.txt new file mode 100644 index 000000000..6da8d5f07 --- /dev/null +++ b/docs/eip/api-ref/PARAMETERS.txt @@ -0,0 +1,3 @@ +version="" +language="en-us" +type="" \ No newline at end of file diff --git a/docs/eip/api-ref/eip_api01_0000.html b/docs/eip/api-ref/eip_api01_0000.html new file mode 100644 index 000000000..5d19f2586 --- /dev/null +++ b/docs/eip/api-ref/eip_api01_0000.html @@ -0,0 +1,8 @@ + + +
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 and responses are transmitted using JSON messages, with media type represented by Application/json.
+For details about how to use APIs, see API Usage Guidelines.
+Normal Response Code + |
+Type + |
+Description + |
+
|---|---|---|
200 + |
+OK + |
+Specifies the normal response code for the GET, PUT, and POST operations. + |
+
201 + |
+Created + |
+Specifies the normal response code for the POST operation of the OpenStack Neutron API. + |
+
204 + |
+No Content + |
+Specifies the normal response code for the DELETE operation. + |
+
Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter a username and password to access the requested page. + |
+
403 Forbidden + |
+You are forbidden to access the requested page. + |
+
404 Not Found + |
+The server could not find the requested page. + |
+
405 Method Not Allowed + |
+You are not allowed to use the method specified in the request. + |
+
406 Not Acceptable + |
+The response generated by the server could not be accepted by the client. + |
+
407 Proxy Authentication Required + |
+You must use the proxy server for authentication so that the request can be processed. + |
+
408 Request Timeout + |
+The request timed out. + |
+
409 Conflict + |
+The request could not be processed due to a conflict. + |
+
500 Internal Server Error + |
+Failed to complete the request because of an internal service error. + |
+
501 Not Implemented + |
+Failed to complete the request because the server does not support the requested function. + |
+
502 Bad Gateway + |
+Failed to complete the request because the server has received an invalid response. + |
+
503 Service Unavailable + |
+Failed to complete the request because the service is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
If an error occurs when an API is called, error information is returned. This section describes the error information for EIP APIs (excluding native OpenStack APIs).
+{
+ "code": "VPC.0504",
+ "message": "Floating IP could not be found."
+}
+Module + |
+Status Code + |
+Error Code + |
+Message + |
+Description + |
+Handling Measure + |
+
|---|---|---|---|---|---|
Public + |
+400 + |
+VPC.0002 + |
+Available zone Name is null. + |
+The AZ is left blank. + |
+Check whether the availability_zone field in the request body for creating a subnet is left blank. + |
+
404 + |
+VPC.0003 + |
+VPC does not exist. + |
+The VPC does not exist. + |
+Check whether the VPC ID is correct or whether the VPC exists under the tenant. + |
+|
400 + |
+VPC.0004 + |
+VPC is not active, please try later. + |
+The VPC status is abnormal. + |
+Try again later or contact technical support. + |
+|
401 + |
+VPC.0005 + |
+Lack of user authority. + |
+User restricted. + |
+Check whether the account is in arrears or has not applied for the OBT permission. + |
+|
401 + |
+VPC.0009 + |
+real-name authentication fail. + |
+Real-name authentication fails. + |
+Contact technical support. + |
+|
Public + |
+400 + |
+VPC.0007 + |
+urlTenantId is not equal tokenTenantId + |
+Inconsistent tenant IDs. + |
+The tenant ID in the URL is different from that parsed in the token. + |
+
401 + |
+VPC.0008 + |
+Invalid token in the header. + |
+Invalid token. + |
+Check whether the token in the request header is valid. + |
+|
403 + |
+VPC.2701 + |
+Token not allowed to do this action. + |
+You do not have permission to perform this operation, or your account balance is insufficient. + |
+Check whether the account balance is insufficient or whether your account has been frozen. + |
+|
Public + + |
+403 + |
+VPC.0010 + |
+Rules on xx by ** disallowed by policy + |
+Insufficient permissions to make calls to the underlying system. + |
+Obtain the required permissions. + |
+
403 + |
+VPC.2201 + |
+Policy doesn't allow <x:x:x> to be performed + |
+Insufficient fine-grained permissions. + |
+Obtain the required permissions. + |
+|
Creating a VPC + |
+400 + |
+VPC.0101 + |
+Param is invalid. + |
+VPC parameters are incorrect. + |
+Check whether the parameter values are valid based on the returned error message and API reference document. + |
+
409 + |
+VPC.0114 + |
+Quota exceeded for resources: ['router']. + |
+The number of VPCs has reached the maximum allowed limit specified by the quota. + |
+Clear VPC resources that no longer will be used or apply for expanding the VPC resource quota. + |
+|
400 + |
+VPC.0115 + |
+The router name has exist. + |
+The VPC name already exists. + |
+Change the VPC name. + |
+|
Querying a VPC + |
+400 + |
+VPC.0101 + |
+getVpc error vpcId is invalid. + |
+VPC parameters are incorrect. + |
+Ensure that the specified VPC ID is correct. + |
+
404/500 + |
+VPC.0105 + |
+Neutron Error. + |
+Calling the backend service fails. + |
+Check whether the Neutron service is normal or contact technical support. + |
+|
500 + |
+VPC.0106 + |
+get router is null. + |
+An error is returned for the failure to call the backend service. + |
+Check whether the Neutron service is normal or contact technical support. + |
+|
Querying VPCs + |
+400 + |
+VPC.0101 + |
+Query vpc list error. + |
+Failed to query the VPCs. + |
+Check whether the parameter values are valid based on the returned error message. + |
+
500 + |
+VPC.0105 + |
+Neutron Error. + |
+Calling the backend service fails. + |
+Check whether the Neutron service is normal or contact technical support. + |
+|
500 + |
+VPC.0106 + |
+query routers or getList are null. + |
+The response result of calls to the IaaS OpenStack system is null or empty. + |
+Check whether the Neutron service is normal or contact technical support. + |
+|
Deleting a VPC + |
+400/404 + |
+VPC.0101 + |
+Delete router error xx is invalid. + |
+Invalid parameters. + |
+Check whether the parameter values are valid based on the returned error message. + |
+
500 + |
+VPC.0102 + |
+Delete router fail. + |
+The interface fails to obtain the routing resources. + |
+Contact technical support. + |
+|
409 + |
+VPC.0103 + |
+Resource status is busy, try it again later. + |
+The VPC cannot be deleted because it is being created. + |
+Contact technical support. + |
+|
409 + |
+VPC.0104 + |
+Router contains subnets, please delete subnet first. + |
+The VPC cannot be deleted because it contains subnets. + |
+Delete the subnet in the VPC. + |
+|
404/500 + |
+VPC.0105 + |
+Neutron Error. + |
+Calling the backend service fails. + |
+Check whether the Neutron service is normal or contact technical support. + |
+|
409 + |
+VPC.0107 + |
+Delete the firewall first before deleting the router. + |
+Failed to delete the VPC because it has firewalls associated. + |
+Delete the firewalls of the tenant first. + |
+|
409 + |
+VPC.0108 + |
+Router is used not allow deleted. + |
+Failed to delete the VPC because it has EIPs associated. + |
+Delete the EIPs of the tenant first. + |
+|
409 + |
+VPC.0109 + |
+Router is used not allow deleted. + |
+Failed to delete the VPC because one or more VPNs have been created for it. + |
+Delete VPNs of the tenant. + |
+|
409 + |
+VPC.0110 + |
+deleteDefaultNetworkFromRouter router status is invalid. + |
+The VPC cannot be deleted because its status is unstable. + |
+Contact technical support. + |
+|
500 + |
+VPC.0111 + |
+Database Error. + |
+An internal VPC exception occurs. + |
+Contact technical support. + |
+|
409 + |
+VPC.0112 + |
+Delete the securitygroup first before deleting the router. + |
+The VPC cannot be deleted because it contains security groups. + |
+Delete security groups of the tenant. + |
+|
409 + |
+VPC.0118 + |
+ELB exists under this router, delete ELB firstly. + |
+The VPC cannot be deleted because it contains load balancers. + |
+Delete load balancers in the VPC. + |
+|
500 + |
+VPC.0119 + |
+ELB Error. + |
+An error occurred when the VPC service makes calls to the ELB service. + |
+Check whether the ELB service is normal or contact technical support. + |
+|
409 + |
+VPC.0120 + |
+exroutes exists under this router, delete exroutes firstly. + |
+The VPC cannot be deleted because it contains extension routes. + |
+Delete extension routes in the VPC. + |
+|
Updating a VPC + + |
+400 + |
+VPC.0101 + |
+Update router xx is invalid. + |
+Invalid parameters. + |
+Check whether the parameter values are valid based on the returned error message. + |
+
404/500 + |
+VPC.0105 + |
+Neutron Error. + |
+Calling the backend service fails. + |
+Check whether the Neutron service is normal or contact technical support. + |
+|
500 + |
+VPC.0113 + |
+Router status is not active. + |
+The VPC cannot be updated because the status of the VPC is abnormal. + |
+Try again later or contact technical support. + |
+|
400 + |
+VPC.0115 + |
+The router name has exist. + |
+The VPC name already exists. + |
+Change the VPC name. + |
+|
400 + |
+VPC.0117 + |
+Cidr can not contain subnetList cidr. + |
+The subnet parameters are invalid. The VPC CIDR block does not contain all its subnet CIDR blocks. + |
+Change the CIDR block of the VPC. + |
+|
Creating a subnet + |
+400 + |
+VPC.0201 + |
+Subnet name is invalid. + |
+Incorrect subnet parameters. + |
+Check whether the parameter values are valid based on the returned error message and API reference document. + |
+
500 + |
+VPC.0202 + |
+Create subnet failed. + |
+An internal error occurs in the subnet. + |
+Contact technical support. + |
+|
400 + |
+VPC.0203 + |
+Subnet is not in the range of VPC. + |
+The CIDR block of the subnet is not in the range of the VPC. + |
+Change the CIDR block of the subnet. + |
+|
400 + |
+VPC.0204 + |
+The subnet has already existed in the VPC, or has been in conflict with the VPC subnet. + |
+The CIDR block of the subnet already exists in the VPC. + |
+Change the CIDR block of the subnet. + |
+|
400 + |
+VPC.0212 + |
+The subnet cidr is not valid. + |
+Invalid subnet CIDR block. + |
+Check whether the subnet CIDR block is valid. + |
+|
Querying a subnet + |
+400 + |
+VPC.0201 + |
+Subnet ID is invalid. + |
+Invalid subnet ID. + |
+Check whether the subnet ID is valid. + |
+
404/500 + |
+VPC.0202 + |
+Query subnet fail. + |
+Failed to query the subnet. + |
+Contact technical support. + |
+|
Querying subnets + |
+400 + |
+VPC.0201 + |
+Query subnets list error. + |
+Failed to query the subnets. + |
+Check whether the parameter values are valid based on the returned error message. + |
+
500 + |
+VPC.0202 + |
+List subnets error. + |
+Failed to query the subnets. + |
+Contact technical support. + |
+|
Deleting a subnet + |
+400 + |
+VPC.0201 + |
+Subnet ID is invalid. + |
+Invalid subnet ID. + |
+Check whether the parameter values are valid based on the returned error message. + |
+
404/500 + |
+VPC.0202 + |
+Neutron Error. + |
+An internal error occurs in the subnet. + |
+Contact technical support. + |
+|
500 + |
+VPC.0206 + |
+Subnet has been used by VPN, please remove the subnet from the VPN and try again. + |
+The subnet cannot be deleted because it is being used by the VPN. + |
+Delete the subnet that is used by the VPN. + |
+|
400 + |
+VPC.0207 + |
+Subnet does not belong to the VPC. + |
+This operation is not allowed because the subnet does not belong to the VPC. + |
+Check whether the subnet is in the VPC. + |
+|
500 + |
+VPC.0208 + |
+Subnet is used by private IP, can not be deleted. + |
+The subnet cannot be deleted because it is being used by the private IP address. + |
+Delete the private IP address of the subnet. + |
+|
500 + |
+VPC.0209 + |
+subnet is still used ,such as computer,LB. + |
+The subnet cannot be deleted because it is being used by an ECS or load balancer. + |
+Delete the ECS or load balancer in the subnet. + |
+|
500 + |
+VPC.0210 + |
+Subnet has been used by routes, please remove the routes first and try again. + |
+The subnet cannot be deleted because it is being used by the custom route. + |
+Delete the custom route. + |
+|
500 + |
+VPC.0211 + |
+subnet is still used by LBaas. + |
+The subnet cannot be deleted because it is being used by load balancers. + |
+Delete load balancers in the subnet. + |
+|
Updating a subnet + |
+400 + |
+VPC.0201 + |
+xx is invalid. + |
+Incorrect subnet parameters. + |
+Check whether the parameter values are valid based on the returned error message. + |
+
404/500 + |
+VPC.0202 + |
+Neutron Error. + |
+An internal error occurs in the subnet. + |
+Contact technical support. + |
+|
500 + |
+VPC.0205 + |
+Subnet states is invalid, please try again later. + |
+The subnet cannot be updated because it is being processed. + |
+Try again later or contact technical support. + |
+|
400 + |
+VPC.0207 + |
+Subnet does not belong to the VPC. + |
+This operation is not allowed because the subnet does not belong to the VPC. + |
+Check whether the subnet is in the VPC. + |
+|
Assigning an EIP + + |
+400 + |
+VPC.0301 + |
+Bandwidth name or share_type is invalid. + |
+The specified bandwidth parameter for assigning an EIP is invalid. + |
+Check whether the specified bandwidth parameter is valid. + |
+
400 + |
+VPC.0501 + |
+Bandwidth share_type is invalid. + |
+Invalid EIP parameters. + |
+Check whether the parameter values are valid based on the returned error message and API reference document. + |
+|
403 + |
+VPC.0502 + |
+Tenant status is op_restricted. + |
+You are not allowed to assign the EIP. + |
+Check whether the account balance is insufficient or whether your account has been frozen. + |
+|
500 + |
+VPC.0503 + |
+Creating publicIp failed. + |
+Failed to assign the EIP. + |
+Contact technical support. + |
+|
500 + |
+VPC.0504 + |
+FloatIp is null. + |
+Failed to assign the EIP because no IP address is found. + |
+Contact technical support. + |
+|
500 + |
+VPC.0508 + |
+Port is invalid. + |
+Port-related resources could not be found. + |
+Contact technical support. + |
+|
409 + |
+VPC.0510 + |
+Floatingip has already associated with port. + |
+The EIP has already been bound to another ECS. + |
+Unbind the EIP from the ECS. + |
+|
409 + |
+VPC.0511 + |
+Port has already associated with floatingip. + |
+The port has already been associated with an EIP. + |
+Disassociate the port from the EIP. + |
+|
409 + |
+VPC.0521 + |
+Quota exceeded for resources: ['floatingip']. + |
+Insufficient EIP quota. + |
+Release the unbound EIPs or request to increase the EIP quota. + |
+|
409 + |
+VPC.0522 + |
+The IP address is in use. + |
+The IP address is invalid or in use. + |
+Check whether the IP address format is valid or replace it with another IP address. + |
+|
409 + |
+VPC.0532 + |
+No more IP addresses available on network. + |
+Failed to assign the IP address because no IP addresses are available. + |
+Release unbound EIPs or try again later. + |
+|
Querying an EIP + |
+400 + |
+VPC.0501 + |
+Invalid floatingip_id. + |
+Invalid EIP parameters. + |
+Check whether the EIP ID is valid. + |
+
404 + |
+VPC.0504 + |
+Floating IP could not be found. + |
+The EIP could not be found. + |
+Check whether the specified EIP ID is valid. + |
+|
500 + |
+VPC.0514 + |
+Neutron Error. + |
+An exception occurs in the IaaS OpenStack system. + |
+Check whether the Neutron service is normal or contact technical support. + |
+|
Querying EIPs + |
+400 + |
+VPC.0501 + |
+Invalid limit. + |
+Invalid EIP parameters. + |
+Check whether the parameter values are valid based on the returned error message and API reference document. + |
+
Releasing an EIP + + + + + + + + |
+400 + |
+VPC.0501 + |
+Invalid param. + |
+Invalid EIP parameters. + |
+Contact technical support. + |
+
404 + |
+VPC.0504 + |
+Floating IP could not be found. + |
+The EIP could not be found. + |
+Check whether the specified EIP ID is valid. + |
+|
409 + |
+VPC.0512 + |
+Resource status is busy, try it again later. + |
+The EIP status is abnormal. + |
+Try again later or contact technical support. + |
+|
500 + |
+VPC.0513 + |
+getElementByKey error. + |
+Network resources cannot be found. + |
+Contact technical support. + |
+|
500 + |
+VPC.0516 + |
+Publicip is in used by ELB. + |
+Failed to release the EIP because it is being used by a load balancer. + |
+Unbind the EIP from the load balancer. + |
+|
409 + |
+VPC.0517 + |
+Floatingip has associated with port, please disassociate it firstly. + |
+Failed to release the EIP because it is bound to an ECS. + |
+Unbind the EIP from the ECS. + |
+|
500 + |
+VPC.0518 + |
+Public IP has firewall rules. + |
+Failed to release the EIP because it is being used by a firewall. + |
+Contact technical support. + |
+|
Updating an EIP + |
+400 + |
+VPC.0501 + |
+Port id is invalid. + |
+Invalid EIP parameters. + |
+Check whether the port ID is valid. + |
+
404 + |
+VPC.0504 + |
+Floating IP could not be found. + |
+The EIP could not be found. + |
+Check whether the specified EIP ID is valid. + |
+|
500 + |
+VPC.0509 + |
+Floating ip double status is invalid. + |
+The port has already been associated with an EIP. + |
+Disassociate the port from the EIP. + |
+|
409 + |
+VPC.0510 + |
+Floatingip has already associated with port. + |
+The EIP has already been bound to another ECS. + |
+Unbind the EIP from the ECS. + |
+|
409 + |
+VPC.0511 + |
+Port has already associated with floatingip. + |
+Failed to bind the EIP to the ECS because another EIP has already been bound to the ECS. + |
+Unbind the EIP from the ECS. + |
+|
409 + |
+VPC.0512 + |
+Resource status is busy, try it again later. + |
+The EIP status is abnormal. + |
+Try again later or contact technical support. + |
+|
404/500 + |
+VPC.0514 + |
+Neutron Error. + |
+An exception occurs in the IaaS OpenStack system. + |
+Check whether the Neutron service is normal or contact technical support. + |
+|
Querying a bandwidth + + |
+400 + |
+VPC.0301 + |
+getBandwidth error bandwidthId is invalid. + |
+The bandwidth parameters are incorrect. + |
+Check whether the bandwidth ID is valid. + |
+
404 + |
+VPC.0306 + |
+No Eip bandwidth exist with id. + |
+The bandwidth object does not exist. + |
+The bandwidth object to be queried does not exist. + |
+|
500 + |
+VPC.0302 + |
+Neutron Error. + |
+An exception occurs in the IaaS OpenStack system. + |
+Check whether the Neutron service is normal or contact technical support. + |
+|
Querying bandwidths + |
+400 + |
+VPC.0301 + |
+Get bandwidths error limit is invalid. + |
+The bandwidth parameters are incorrect. + |
+Check whether the parameter values are valid based on the returned error message and API reference document. + |
+
404 + |
+VPC.0306 + |
+No Eip bandwidth exist with id. + |
+The bandwidth object does not exist. + |
+The bandwidth object to be queried does not exist. + |
+|
500 + |
+VPC.0302 + |
+Neutron Error. + |
+An exception occurs in the IaaS OpenStack system. + |
+Check whether the Neutron service is normal or contact technical support. + |
+|
Updating a bandwidth + + |
+400 + |
+VPC.0301 + |
+updateBandwidth input param is invalid. + |
+The bandwidth parameters are incorrect. + |
+Check whether the parameter values are valid based on the returned error message and API reference document. + |
+
500 + |
+VPC.0302 + |
+Neutron Error. + |
+Failed to obtain underlying resources. + |
+Check whether the Neutron service is normal or contact technical support. + |
+|
500 + |
+VPC.0305 + |
+updateBandwidth error. + |
+An internal error occurs during the bandwidth update. + |
+Contact technical support. + |
+|
Querying quotas + |
+400 + |
+VPC.1207 + |
+resource type is invalid. + |
+The specified resource type does not exist. + |
+Use an existing resource type. + |
+
Assigning a private IP address + + + + |
+500 + |
+VPC.0701 + |
+The IP has been used. + |
+The private IP address already exists. + |
+Change another private IP address and try again. + |
+
400 + |
+VPC.0705 + |
+IP address is not a valid IP for the specified subnet. + |
+Invalid private IP address + |
+Check whether the specified IP address in the request body is within the subnet CIDR block. + |
+|
404 + |
+VPC.2204 + |
+Query resource by id fail. + |
+The resource does not exist or the permission is insufficient. + |
+Check whether the specified subnet in the request body exists or the current account has the permission to query the subnet. + |
+|
409 + |
+VPC.0703 + |
+No more IP addresses available on network xxx. + |
+Insufficient IP addresses. + |
+Check whether the subnet has sufficient IP addresses. + |
+|
Querying a Private IP Address + |
+404 + |
+VPC.0704 + |
+Query resource by id fail. + |
+The private IP address does not exist. + |
+Check whether the private IP address exists. + |
+
Querying Private IP Addresses + |
+400 + |
+VPC.0702 + |
+query privateIps error. + |
+Invalid parameters. + |
+Check whether the parameter values are valid based on the returned error message. + |
+
Releasing a Private IP Address + + + |
+404 + |
+VPC.0704 + |
+Query resource by id fail. + |
+The private IP address does not exist. + |
+Check whether the private IP address exists. + |
+
500 + |
+VPC.0706 + |
+Delete port fail. + |
+An error occurs when the private IP address is being released. + |
+Try again later or contact technical support. + |
+|
409 + |
+VPC.0707 + |
+privateIp is in use. + |
+The private IP address is in use. + |
+Check whether the private IP address is being used by other resource. + |
+|
Creating a security group + + |
+400 + |
+VPC.0601 + |
+Creating securitygroup name is invalid. + |
+The parameters of the security group are incorrect. + |
+Check whether the parameter values are valid based on the returned error message and API reference document. + |
+
500 + |
+VPC.0602 + |
+Add security group fail. + |
+An internal error occurs in the security group. + |
+Check whether the Neutron service is normal or contact technical support. + |
+|
409 + |
+VPC.0604 + |
+Quota exceeded for resources: ['security_group']. + |
+Insufficient security group quota. + |
+Delete the security group that is no longer required or apply for increasing the quota. + |
+|
Querying a security group + |
+400 + |
+VPC.0601 + |
+Securitygroup id is invalid. + |
+The parameters of the security group are incorrect. + |
+Check whether the security group ID is valid. + |
+
500 + |
+VPC.0602 + |
+Query security group fail. + |
+An internal error occurs in the security group. + |
+Check whether the Neutron service is normal or contact technical support. + |
+|
404 + |
+VPC.0603 + |
+Securitygroup is not exist. + |
+The security group does not exist. + |
+Check whether the security group ID is correct or whether the security group exists under the tenant. + |
+|
404/500 + |
+VPC.0612 + |
+Neutron Error. + |
+An internal error occurs in the security group. + |
+Contact technical support. + |
+|
Querying security groups + |
+400 + |
+VPC.0601 + |
+Query security groups error limit is invalid. + |
+The parameters of the security group are incorrect. + |
+Check whether the parameter values are valid based on the returned error message and API reference document. + |
+
500 + |
+VPC.0602 + |
+Query security groups fail. + |
+An internal error occurs in the security group. + |
+Check whether the Neutron service is normal or contact technical support. + |
+|
Associating multiple NIC ports to or disassociating them from a security group at a time + |
+400 + |
+VPC.0606 + |
+Security group id is invalid + |
+Invalid security group ID. + |
+Use a valid security group ID. + |
+
400 + |
+VPC.0606 + |
+Request is invalid + |
+The request structure is missing. + |
+Use a valid request body. + |
+|
400 + |
+VPC.0606 + |
+Request is null + |
+The request is empty. + |
+Use a valid request body. + |
+|
400 + |
+VPC.0606 + |
+Action is invalid + |
+Invalid action value. + |
+Use a valid action value (add or remove). + |
+|
400 + |
+VPC.0606 + |
+Ports list is empty + |
+The ports are an empty list. + |
+Use a valid ports list. + |
+|
400 + |
+VPC.0606 + |
+Port id is invalid + |
+The ports list contains invalid port IDs. + |
+Use a valid ports list. + |
+|
400 + |
+VPC.0609 + |
+Ports list exceeds limit + |
+The ports list contains more than 20 IDs. + |
+Use a valid ports list. + |
+|
400 + |
+VPC.0606 + |
+Endpoint is invalid + |
+Invalid endpoint. + |
+Contact technical support. + |
+|
200 + |
+VPC.0607 + |
+Security group of this instance doesn't exist + |
+The security group does not exist. + |
+Use a valid security group ID. + |
+|
200 + |
+VPC.0607 + |
+An instance must belong to at least one security group + |
+Do not disassociate the instance from the security group when it is associated with only one security group. + |
+Perform other operations. + |
+|
200 + |
+VPC.0608 + |
+Neutron Error + |
+An internal error occurs when you perform batch operations. + |
+Contact technical support. + |
+|
Flow log + + + |
+400 + |
+VPC.3001 + |
+resource could not be found, flowlog id is invalid + |
+Invalid parameters. + |
+Check whether the parameters are valid. + |
+
400 + |
+VPC.3002 + |
+create its topic failed + |
+An error occurred during log topic creation in LTS. + |
+Check whether the parameters are valid. + |
+|
404 + |
+VPC.3002 + |
+NeutronError + |
+Failed to query the flow log. + |
+Check whether the parameters are valid. + |
+|
500 + |
+VPC.3002 + |
+NeutronError + |
+Failed to create the flow log. + |
+Contact technical support. + |
+|
Resource tags + |
+400 + |
+VPC.1801 + |
+resource id is invalid. + |
+Incorrect resource ID. + |
+Use a correct resource ID. + |
+
400 + |
+VPC.1801 + |
+action is invalid. + |
+Invalid action value. + |
+Ensure that the value of action is create or delete. + |
+|
400 + |
+VPC.1801 + |
+Tag length is invalid. The key length must be in range [1,36] and value in range [0,43] + |
+Invalid key length. The key can contain 1 to 36 characters. + |
+Use a valid key value. + |
+|
400 + |
+VPC.1801 + |
+Tag length is invalid. The key length must be in range [1,36] and value in range [0,43] + |
+Invalid value length. +The value can contain 0 to 43 characters. + |
+Use a value of valid length. + |
+|
400 + |
+VPC.1801 + |
+Resource_type xxx is invalid. + |
+Incorrect resource type. + |
+Ensure that the value of resource_type is vpcs. + |
+|
400 + |
+VPC.1801 + |
+Tag can not be null. + |
+The tag list contains value null. + |
+Use valid tags. + |
+|
400 + |
+VPC.1801 + |
+The list of matches contains null. + |
+The matches list contains value null. + |
+Use valid matches. + |
+|
400 + |
+VPC.1801 + |
+Tag value can not be null. + |
+The tags exist, but their values are null. + |
+Use valid tags. + |
+|
400 + |
+VPC.1801 + |
+The value of Matches in resourceInstancesReq is null. + |
+The matches exist, and the value is null. + |
+Use valid matches. + |
+|
400 + |
+VPC.1801 + |
+number of tags exceeds max num of 10. + |
+The tag list contains more than 10 keys. + |
+Use valid tags. + |
+|
400 + |
+VPC.1801 + |
+Tag key is repeated. + |
+The tag list contains duplicate keys. + |
+Use valid tags. + |
+|
400 + |
+VPC.1801 + |
+Value of tags in resourceInstancesReq is duplicate. + |
+There are duplicate tag values in the tag list. + |
+Use valid tags. + |
+|
400 + |
+VPC.1801 + |
+number of tags exceeds max num of 10. + |
+The tag in the tag list has more than 10 tag values. + |
+Use valid tags. + |
+|
400 + |
+VPC.1801 + |
+The key of matches is invalid. + |
+The key in matches is not the resource name. + |
+Use valid matches. + |
+|
400 + |
+VPC.1801 + |
+Limit in resourceInstancesReq is invalid. +Offset in resourceInstancesReq is invalid. + |
+Invalid limit or offset value. + |
+Use valid limit and offset values. + |
+|
400 + |
+VPC.1801 + |
+ResourceInstancesReq is null or invalid. + |
+The tags dictionary structure is missing. + |
+Use a valid tags dictionary structure. + |
+|
400 + |
+VPC.1801 + |
+Tag length is invalid. The key length must be in range [1,36] and value in range [0,43] + |
+The key in tags exceeds the maximum length or is left blank. + |
+Use valid keys in tags. + |
+|
400 + |
+VPC.1801 + |
+Tag length is invalid. The key length must be in range [1,36] and value in range [0,43] + |
+A value in tags exceeds the maximum length. + |
+Use valid values in tags. + |
+|
400 + |
+VPC.1801 + |
+ResourceInstancesReq is null or invalid. + |
+The matches dictionary structure is missing. + |
+Use a valid matches dictionary structure. + |
+|
400 + |
+VPC.1801 + |
+The number of Matches in resourceInstancesReq is 0. + |
+The matches are an empty list. + |
+Use a valid matches list. + |
+|
400 + |
+VPC.1801 + |
+The value's length of Matches in resourceInstancesReq is more than 255. + |
+The matches list contains tag values that contain more than 255 Unicode characters. + |
+Use a valid matches list. + |
+|
500 + |
+VPC.1801 + |
+InvalidInput + |
+Incorrect request body format. + |
+Use the correct request body format. + |
+|
404 + |
+VPC.2204 + |
+Query subnet by id fail. + |
+The resource does not exist or the permission is insufficient. + |
+Use an existing resource or obtain required permission. + |
+|
Querying the network IP address usage + |
+400 + |
+VPC.2301 + |
+parameter network_id is invalid. + |
+The request parameter is incorrect. + |
+Enter a valid network ID. + |
+
400 + |
+VPC.2302 + |
+Network xxx could not be found. + |
+The network is not found. + |
+Ensure that the network ID exists. + |
+
This section describes monitoring metrics reported by VPC to Cloud Eye as well as their namespaces and dimensions. You can use APIs provided by Cloud Eye to query the monitoring metrics of the monitored object and alarms generated for VPC.
+SYS.VPC
+ID + |
+Name + |
+Description + |
+Value Range + |
+Monitored Object + |
+Monitoring Interval (Raw Data) + |
+
|---|---|---|---|---|---|
upstream_bandwidth + |
+Outbound Bandwidth + |
+Network rate of outbound traffic +Unit: bit/s + |
+≥ 0 bit/s + |
+Bandwidth or EIP + |
+1 minute + |
+
downstream_bandwidth + |
+Inbound Bandwidth + |
+Network rate of inbound traffic +Unit: bit/s + |
+≥ 0 bit/s + |
+Bandwidth or EIP + |
+1 minute + |
+
up_stream + |
+Outbound Traffic + |
+Network traffic going out of the cloud platform +Unit: byte + |
+≥ 0 bytes + |
+Bandwidth or EIP + |
+1 minute + |
+
down_stream + |
+Inbound Traffic + |
+Network traffic going into the cloud platform +Unit: byte + |
+≥ 0 bytes + |
+Bandwidth or EIP + |
+1 minute + |
+
Key + |
+Value + |
+
|---|---|
publicip_id + |
+EIP ID + |
+
bandwidth_id + |
+Bandwidth ID + |
+
Released On + |
+Description + |
+
|---|---|
2022-06-25 + |
+This release incorporates the following changes: +Modified the load balancer types applicable to the 5_gray type in Assigning an EIP, Querying an EIP, Querying EIPs, Updating an EIP, Querying a Bandwidth, Querying Bandwidths, Updating a Bandwidth, Assigning a Shared Bandwidth, and Adding an EIP to a Shared Bandwidth. + |
+
2022-03-03 + |
+This release incorporates the following changes: +Added descriptions of parameters private_ip_address and port_id in Querying an EIP, Querying EIPs, and Updating an EIP. + |
+
2022-02-15 + |
+This release incorporates the following changes: +
|
+
2021-12-31 + |
+This release incorporates the following change: +
|
+
2021-08-25 + |
+This release incorporates the following changes: +
|
+
2021-06-18 + |
+This release incorporates the following changes: +
|
+
2021-05-25 + |
+This release incorporates the following changes: +
|
+
2021-05-10 + |
+This release incorporates the following changes: +
|
+
2021-03-16 + |
+This release incorporates the following changes: +Added description that leaving parameter port_id blank cannot be used to unbind an EIP from a dedicated load balancer in sections Updating an EIP and Updating a Floating IP Address. + |
+
2020-12-16 + |
+This release incorporates the following changes: +
|
+
2020-03-20 + |
+This release incorporates the following changes: +Added the value of 5_mailbgp for parameters type and publicip_type +in sections Assigning an EIP, Bandwidth, and Bandwidth (V2.0). + |
+
2020-02-25 + |
+This release incorporates the following changes: +
|
+
2018-09-14 + |
+This issue is the first official release. + |
+
This API is used to query details about a bandwidth.
+Name + |
+Type + |
+Description + |
+
|---|---|---|
bandwidth + |
+bandwidth object + |
+Specifies the bandwidth object. + |
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
name + |
+String + |
+
|
+
size + |
+Integer + |
+
|
+
id + |
+String + |
+Specifies the bandwidth ID, which uniquely identifies the bandwidth. + |
+
share_type + |
+String + |
+
|
+
publicip_info + |
+Array of publicip_info objects + |
+
|
+
tenant_id + |
+String + |
+Specifies the project ID. + |
+
bandwidth_type + |
+String + |
+
|
+
charge_mode + |
+String + |
+
+ If the value is traffic, the billing is based on traffic. + |
+
billing_info + |
+String + |
+Specifies the bill information. +If billing_info is specified, the bandwidth is in yearly/monthly billing mode. + |
+
enterprise_project_id + |
+String + |
+
NOTE:
+This parameter is unsupported. Do not use it. + |
+
status + |
+String + |
+
|
+
created_at + |
+String + |
+
|
+
updated_at + |
+String + |
+
|
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
publicip_id + |
+String + |
+Specifies the ID of the EIP that uses the bandwidth. + |
+
publicip_address + |
+String + |
+Specifies the obtained EIP if only IPv4 EIPs are available. + |
+
ip_version + |
+Integer + |
+
|
+
publicip_type + |
+String + |
+
|
+
{
+ "bandwidth": {
+ "id": "3cbd5ae9-368f-4bc8-8841-f2ecc322c64a",
+ "name": "EIPResourceSetup_1553594229",
+ "size": 5,
+ "share_type": "PER",
+ "publicip_info": [
+ {
+ "publicip_id": "22b02f40-b95f-465a-ae9b-7c8b0f042a41",
+ "publicip_address": "10.xx.xx.62",
+ "ip_version": 4,
+ "publicip_type": "5_bgp",
+ }
+ ],
+ "tenant_id": "26ae5181a416420998eb2093aaed84d9",
+ "bandwidth_type": "bgp",
+ "charge_mode": "traffic",
+ "enterprise_project_id": "0",
+ "status": "NORMAL",
+ "created_at": "2020-04-21T07:58:02Z",
+ "updated_at": "2020-04-21T07:58:02Z"
+ }
+}
+See Status Codes.
+See Error Codes.
+This API is used to query bandwidths using search criteria.
+GET /v1/{project_id}/bandwidths
+Name + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
marker + |
+No + |
+String + |
+Specifies a resource ID for pagination query, indicating that the query starts from the next record of the specified resource ID. +This parameter can work together with the parameter limit. +
|
+
limit + |
+No + |
+Integer + |
+Specifies the number of records that will be returned on each page. The value is from 0 to intmax. +limit can be used together with marker. For details, see the parameter description of marker. + |
+
enterprise_project_id + |
+No + |
+String + |
+
NOTE:
+This parameter is unsupported. Do not use it. + |
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
bandwidths + |
+Array of bandwidths objects + |
+Specifies the bandwidth objects. For details, see Table 3. + |
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
name + |
+String + |
+
|
+
size + |
+Integer + |
+
|
+
id + |
+String + |
+Specifies the bandwidth ID, which uniquely identifies the bandwidth. + |
+
share_type + |
+String + |
+
If this parameter is not set, the list of all bandwidths will be returned by default. + |
+
publicip_info + |
+Array of publicip_info objects + |
+
|
+
tenant_id + |
+String + |
+Specifies the project ID. + |
+
bandwidth_type + |
+String + |
+
|
+
charge_mode + |
+String + |
+
+ If the value is traffic, the bandwidth is billed by traffic. + |
+
billing_info + |
+String + |
+Specifies the bill information. +If billing_info is specified, the bandwidth is in yearly/monthly billing mode. + |
+
enterprise_project_id + |
+String + |
+
NOTE:
+This parameter is unsupported. Do not use it. + |
+
status + |
+String + |
+
|
+
created_at + |
+String + |
+
|
+
updated_at + |
+String + |
+
|
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
publicip_id + |
+String + |
+Specifies the ID of the EIP that uses the bandwidth. + |
+
publicip_address + |
+String + |
+Specifies the obtained EIP if only IPv4 EIPs are available. + |
+
publicip_type + |
+String + |
+
|
+
{
+ "bandwidths": [
+ {
+ "id": "09b99c91-da7c-449f-94e2-f4934c5b2a71",
+ "name": "vpngw-f632a7b0-ef50-4ac5-97e9-ddc56b3d5977",
+ "size": 200,
+ "share_type": "PER",
+ "publicip_info": [
+ {
+ "publicip_id": "2a65923c-7133-415d-ae3b-cf9635a942c5",
+ "publicip_address": "10.xx.xx.3",
+ "ip_version": 4,
+ "publicip_type": "5_bgp",
+ }
+ ],
+ "tenant_id": "26ae5181a416420998eb2093aaed84d9",
+ "bandwidth_type": "bgp",
+ "charge_mode": "traffic",
+ "billing_info": "",
+ "enterprise_project_id": "0",
+ "status": "NORMAL"
+ },
+ {
+ "id": "0a583ff1-b43e-4000-ade3-e7af0097f832",
+ "name": "vpngw-7e880d5b-f458-40ad-a7e5-735c44cd8b7d",
+ "size": 300,
+ "share_type": "PER",
+ "publicip_info": [
+ {
+ "publicip_id": "c754bc9a-16d5-4763-9674-d7561917aa80",
+ "publicip_address": "10.xx.xx.9",
+ "ip_version": 4,
+ "publicip_type": "5_bgp",
+ }
+ ],
+ "tenant_id": "26ae5181a416420998eb2093aaed84d9",
+ "bandwidth_type": "bgp",
+ "charge_mode": "traffic",
+ "billing_info": "",
+ "enterprise_project_id": "0",
+ "status": "NORMAL"
+ },
+ {
+ "id": "0a673f00-3640-4a13-949e-7049b2916baf",
+ "name": "bandwidth123",
+ "size": 10,
+ "share_type": "PER",
+ "publicip_info": [
+ {
+ "publicip_id": "cec7fb70-2f82-4561-bd83-2121fb642fdc",
+ "publicip_address": "10.xx.xx.184",
+ "ip_version": 4,
+ "publicip_type": "5_bgp",
+ }
+ ],
+ "tenant_id": "26ae5181a416420998eb2093aaed84d9",
+ "bandwidth_type": "bgp",
+ "charge_mode": "traffic",
+ "billing_info": "",
+ "enterprise_project_id": "0",
+ "status": "NORMAL"
+ },
+ {
+ "id": "0dde1eae-1783-46dc-998c-930fbe261ff9",
+ "name": "bandwidth123",
+ "size": 100,
+ "share_type": "PER",
+ "publicip_info": [
+ {
+ "publicip_id": "24232038-e178-40ad-80e4-5abb75db84be",
+ "publicip_address": "10.xx.xx.101",
+ "ip_version": 4,
+ "publicip_type": "5_bgp",
+ }
+ ],
+ "tenant_id": "26ae5181a416420998eb2093aaed84d9",
+ "bandwidth_type": "bgp",
+ "charge_mode": "traffic",
+ "billing_info": "",
+ "enterprise_project_id": "0",
+ "status": "NORMAL"
+ }
+ ]
+}
+See Status Codes.
+See Error Codes.
+This API is used to update information about a bandwidth.
+Name + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
bandwidth + |
+Yes + |
+bandwidth object + |
+Specifies the bandwidth objects. For details, see Table 3. + |
+
Name + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
name + |
+No + |
+String + |
+
|
+
size + |
+No + |
+Integer + |
+
|
+
PUT https://{Endpoint}/v1/{project_id}/bandwidths/{bandwidth_id}
+
+{
+ "bandwidth":
+ {"name": "bandwidth123",
+ "size": 10
+ }
+}
+Name + |
+Type + |
+Description + |
+
|---|---|---|
bandwidth + |
+bandwidth object + |
+Specifies the bandwidth objects. For details, see Table 5. + |
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
name + |
+String + |
+
|
+
size + |
+Integer + |
+
|
+
id + |
+String + |
+Specifies the bandwidth ID, which uniquely identifies the bandwidth. + |
+
share_type + |
+String + |
+
|
+
publicip_info + |
+Array of publicip_info objects + |
+
|
+
tenant_id + |
+String + |
+Specifies the project ID. + |
+
bandwidth_type + |
+String + |
+
|
+
charge_mode + |
+String + |
+
+ If the value is traffic, the bandwidth is billed by traffic. + |
+
billing_info + |
+String + |
+Specifies the bill information. +If billing_info is specified, the bandwidth is in yearly/monthly billing mode. + |
+
enterprise_project_id + |
+String + |
+
NOTE:
+This parameter is unsupported. Do not use it. + |
+
status + |
+String + |
+
|
+
created_at + |
+String + |
+
|
+
updated_at + |
+String + |
+
|
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
publicip_id + |
+String + |
+Specifies the ID of the EIP that uses the bandwidth. + |
+
publicip_address + |
+String + |
+Specifies the obtained EIP if only IPv4 EIPs are available. + |
+
ip_version + |
+Integer + |
+
|
+
publicip_type + |
+String + |
+
|
+
{
+ "bandwidth": {
+ "id": "3fa5b383-5a73-4dcb-a314-c6128546d855",
+ "name": "bandwidth123",
+ "size": 10,
+ "share_type": "PER",
+ "publicip_info": [
+ {
+ "publicip_id": "6285e7be-fd9f-497c-bc2d-dd0bdea6efe0",
+ "publicip_address": "161.xx.xx.9",
+ "publicip_type": "5_bgp",
+ "ip_version": 4
+ }
+ ],
+ "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
+ "bandwidth_type": "bgp",
+ "charge_mode": "traffic",
+ "billing_info": "",
+ "status": "NORMAL"
+ }
+}
+See Status Codes.
+See Error Codes.
+This API is used to assign an EIP.
+The EIP service provides independent public IP addresses and bandwidth for Internet access. EIPs can be bound to or unbound from ECSs, BMSs, virtual IP addresses, load balancers, and NAT gateways.
+Name + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
publicip + |
+Yes + |
+publicip object + |
+Specifies the EIP object. For details, see Table 3. + |
+
bandwidth + |
+Yes + |
+bandwidth object + |
+Specifies the bandwidth object. For details, see Table 4. + |
+
enterprise_project_id + |
+No + |
+String + |
+
NOTE:
+This parameter is unsupported. Do not use it. + |
+
Name + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
type + |
+Yes + |
+String + |
+
|
+
ip_address + |
+No + |
+String + |
+
|
+
Name + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
name + |
+Yes + |
+String + |
+
|
+
size + |
+Yes + |
+Integer + |
+
|
+
id + |
+No + |
+String + |
+
|
+
share_type + |
+Yes + |
+String + |
+
|
+
charge_mode + |
+No + |
+String + |
+
|
+
POST https://{Endpoint}/v1/{project_id}/publicips
+
+{
+ "publicip": {
+ "type": "5_bgp",
+ "ip_version": 4
+ },
+ "bandwidth": {
+ "name": "bandwidth123",
+ "size": 10,
+ "share_type": "PER"
+ },
+ "enterprise_project_id":"b261ac1f-2489-4bc7-b31b-c33c3346a439"
+}
+Name + |
+Type + |
+Description + |
+
|---|---|---|
publicip + |
+publicip object + |
+Specifies the EIP object. For details, see Table 6. + |
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the unique identifier of an EIP. + |
+
status + |
+String + |
+
|
+
type + |
+String + |
+
|
+
public_ip_address + |
+String + |
+Specifies the obtained EIP if only IPv4 EIPs are available. + |
+
ip_version + |
+Integer + |
+Specifies the IP address version. The value can be 4 or 6. +
|
+
tenant_id + |
+String + |
+Specifies the project ID. + |
+
create_time + |
+String + |
+Specifies the time (UTC) when the EIP is assigned. + |
+
bandwidth_size + |
+Integer + |
+Specifies the bandwidth (Mbit/s). + |
+
enterprise_project_id + |
+String + |
+
NOTE:
+This parameter is unsupported. Do not use it. + |
+
{
+ "publicip": {
+ "id": "f588ccfa-8750-4d7c-bf5d-2ede24414706",
+ "status": "PENDING_CREATE",
+ "type": "5_bgp",
+ "public_ip_address": "161.xx.xx.7",
+ "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
+ "ip_version": 4,
+ "create_time": "2015-07-16 04:10:52",
+ "bandwidth_size": 0,
+ "enterprise_project_id":"b261ac1f-2489-4bc7-b31b-c33c3346a439"
+ }
+}
+See Status Codes.
+See Error Codes.
+This API is used to query a specific EIP.
+Name + |
+Type + |
+Description + |
+
|---|---|---|
publicip + |
+publicip object + |
+Specifies the EIP object. For details, see Table 3. + |
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the unique identifier of an EIP. + |
+
status + |
+String + |
+
|
+
profile + |
+profile object + |
+Specifies the additional parameters, including the order ID and product ID. For details, see Table 4. + |
+
type + |
+String + |
+
|
+
public_ip_address + |
+String + |
+Specifies the obtained EIP if only IPv4 EIPs are available. Specifies the IPv4 address corresponding to the IPv6 address if IPv6 EIPs are available. IPv6 is not supported currently. + |
+
ip_version + |
+Integer + |
+Specifies the IP address version. The value can be 4 or 6.
+
|
+
private_ip_address + |
+String + |
+
NOTE:
+The value of private_ip_address is null if the EIP is bound to a dedicated load balancer. + |
+
port_id + |
+String + |
+
NOTE:
+The value of port_id is null if the EIP is bound to a dedicated load balancer. + |
+
tenant_id + |
+String + |
+Specifies the project ID. + |
+
create_time + |
+String + |
+Specifies the time (UTC) when the EIP is assigned. + |
+
bandwidth_id + |
+String + |
+Specifies the ID of the EIP bandwidth. + |
+
bandwidth_size + |
+Integer + |
+Specifies the bandwidth (Mbit/s). + |
+
bandwidth_share_type + |
+String + |
+
|
+
bandwidth_name + |
+String + |
+Specifies the bandwidth name. + |
+
enterprise_project_id + |
+String + |
+
NOTE:
+This parameter is unsupported. Do not use it. + |
+
{
+ "publicip": {
+ "id": "2ec9b78d-9368-46f3-8f29-d1a95622a568",
+ "status": "DOWN",
+ "profile": {},
+ "type": "5_bgp",
+ "public_ip_address": "161.xx.xx.12",
+ "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
+ "private_ip_address": "192.168.10.5",
+ "create_time": "2015-07-16 04:32:50",
+ "bandwidth_id": "49c8825b-bed9-46ff-9416-704b96d876a2",
+ "bandwidth_share_type": "PER",
+"bandwidth_size": 10, //The EIP bandwidth size is 10 Mbit/s.
+ "bandwidth_name": "bandwidth-test",
+ "enterprise_project_id":"b261ac1f-2489-4bc7-b31b-c33c3346a439",
+ "ip_version": 4
+ }
+}
+See Status Codes.
+See Error Codes.
+This API is used to query EIPs.
+GET /v1/{project_id}/publicips
+Name + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
marker + |
+No + |
+String + |
+Specifies a resource ID for pagination query, indicating that the query starts from the next record of the specified resource ID. +This parameter can work together with the parameter limit. +
|
+
limit + |
+No + |
+Integer + |
+Specifies the number of records that will be returned on each page. The value is from 0 to intmax. +limit can be used together with marker. For details, see the parameter description of marker. + |
+
enterprise_project_id + |
+No + |
+String + |
+
NOTE:
+This parameter is unsupported. Do not use it. + |
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
publicips + |
+Array of publicips objects + |
+Specifies the EIP object. For details, see Table 3. + |
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the unique identifier of an EIP. + |
+
status + |
+String + |
+
|
+
profile + |
+Object + |
+Specifies the additional parameters, including the order ID and product ID. For details, see Table 4. + |
+
type + |
+String + |
+
|
+
public_ip_address + |
+String + |
+Specifies the obtained EIP if only IPv4 EIPs are available. + |
+
ip_version + |
+Integer + |
+Specifies the IP address version. The value can be 4 or 6. +
|
+
private_ip_address + |
+String + |
+
NOTE:
+The value of private_ip_address is null if the EIP is bound to a dedicated load balancer. + |
+
port_id + |
+String + |
+
NOTE:
+The value of port_id is null if the EIP is bound to a dedicated load balancer. + |
+
tenant_id + |
+String + |
+Specifies the project ID. + |
+
create_time + |
+String + |
+Specifies the time (UTC) when the EIP is assigned. + |
+
bandwidth_id + |
+String + |
+Specifies the ID of the EIP bandwidth. + |
+
bandwidth_size + |
+Integer + |
+Specifies the bandwidth (Mbit/s). + |
+
bandwidth_share_type + |
+String + |
+
|
+
bandwidth_name + |
+String + |
+Specifies the bandwidth name. + |
+
enterprise_project_id + |
+String + |
+
NOTE:
+This parameter is unsupported. Do not use it. + |
+
{
+ "publicips": [
+ {
+ "id": "6285e7be-fd9f-497c-bc2d-dd0bdea6efe0",
+ "status": "DOWN",
+ "profile": {},
+ "type": "5_bgp",
+ "public_ip_address": "161.xx.xx.9",
+ "private_ip_address": "192.168.10.5",
+ "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
+ "create_time": "2015-07-16 04:22:32",
+ "bandwidth_id": "3fa5b383-5a73-4dcb-a314-c6128546d855",
+ "bandwidth_share_type": "PER",
+ "bandwidth_size": 5,
+ "bandwidth_name": "bandwidth-test",
+ "enterprise_project_id":"b261ac1f-2489-4bc7-b31b-c33c3346a439",
+ "ip_version": 4
+ },
+ {
+ "id": "80d5b82e-43b9-4f82-809a-37bec5793bd4",
+ "status": "DOWN",
+ "profile": {},
+ "type": "5_bgp",
+ "public_ip_address": "161.xx.xx.10",
+ "private_ip_address": "192.168.10.6",
+ "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
+ "create_time": "2015-07-16 04:23:03",
+ "bandwidth_id": "a79fd11a-047b-4f5b-8f12-99c178cc780a",
+ "bandwidth_share_type": "PER",
+ "bandwidth_size": 5,
+ "bandwidth_name": "bandwidth-test1",
+ "enterprise_project_id":"0",
+ "ip_version": 4
+ }
+ ]
+}
+See Status Codes.
+See Error Codes.
+This API is used to bind an EIP to a NIC, or unbind an EIP from a NIC.
+
This API cannot be used to bind an EIP to or unbind an EIP from a dedicated load balancer.
+Name + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
publicip + |
+Yes + |
+publicip object + |
+Specifies the EIP object. For details, see Table 3. + |
+
PUT https://{Endpoint}/v1/{project_id}/publicips/{publicip_id}
+
+{
+ "publicip": {
+ "port_id": "f588ccfa-8750-4d7c-bf5d-2ede24414706"
+ }
+}
+Name + |
+Type + |
+Description + |
+
|---|---|---|
publicip + |
+publicip object + |
+Specifies the EIP object. For details, see Table 5. + |
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the unique identifier of an EIP. + |
+
status + |
+String + |
+
|
+
profile + |
+profile object + |
+Specifies the additional parameters, including the order ID and product ID. For details, see Table 6. + |
+
type + |
+String + |
+
|
+
public_ip_address + |
+String + |
+Specifies the obtained EIP if only IPv4 EIPs are available. + |
+
ip_version + |
+Integer + |
+Specifies the IP address version. The value can be 4 or 6. +
|
+
private_ip_address + |
+String + |
+
NOTE:
+The value of private_ip_address is null if the EIP is bound to a dedicated load balancer. + |
+
port_id + |
+String + |
+
NOTE:
+The value of port_id is null if the EIP is bound to a dedicated load balancer. + |
+
tenant_id + |
+String + |
+Specifies the project ID. + |
+
create_time + |
+String + |
+Specifies the time (UTC) when the EIP is assigned. + |
+
bandwidth_id + |
+String + |
+Specifies the ID of the EIP bandwidth. + |
+
bandwidth_size + |
+Integer + |
+Specifies the bandwidth (Mbit/s). + |
+
bandwidth_share_type + |
+String + |
+
|
+
enterprise_project_id + |
+String + |
+
NOTE:
+This parameter is unsupported. Do not use it. + |
+
{
+ "publicip": {
+ "id": "f6318bef-6508-4ea5-a48f-6152b6b1a8fb",
+ "status": "ACTIVE",
+ "profile": {},
+ "type": "5_bgp",
+ "port_id": "a135e9b8-1630-40d2-a6c5-eb534a61efbe",
+ "public_ip_address": "10.xx.xx.162",
+ "private_ip_address": "192.168.1.131",
+ "tenant_id": "26ae5181a416420998eb2093aaed84d9",
+ "create_time": "2019-03-27 01:33:18",
+ "bandwidth_size": 7,
+ "ip_version": 4
+ }
+}
+See Status Codes.
+See Error Codes.
+This API is used to release an EIP.
+See Status Codes.
+See Error Codes.
+This API is used to query all floating IP addresses accessible to the tenant submitting the request.
+GET /v2.0/eip/floatingips_v6
+Example:
+GET https://{Endpoint}/v2.0/eip/floatingips_v6?id={id}&router_id={router_id}&floating_network_id={floating_network_id}&floating_ip_address={floating_ip_address}&port_id={port_id }&fixed_ip_address={fixed_ip_address}&tenant_id={tenant_id}
+Table 1 describes the parameters.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
id + |
+Yes + |
+String + |
+Specifies the floating IP address ID. + |
+
floating_ip_address + |
+No + |
+String + |
+Specifies the floating IPv6 address. + |
+
floating_network_id + |
+No + |
+String + |
+Specifies the external network ID. +You can only use fixed external network. +You can use GET /v2.0/networks?router:external=True or +GET /v2.0/networks?name={floating_network} or run the neutron net-external-list command to obtain information about the external network. + |
+
router_id + |
+No + |
+String + |
+Specifies the ID of the belonged router. + |
+
port_id + |
+No + |
+String + |
+Specifies the port ID. + |
+
fixed_ip_address + |
+No + |
+String + |
+Specifies the private IP address of the associated port. + |
+
tenant_id + |
+No + |
+String + |
+Specifies the project ID. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
floatingips + |
+Array of floatingip objects + |
+Specifies the floating IP address list. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+String + |
+Specifies the floating IP address status. The value can be ACTIVE, DOWN, or ERROR. +
|
+
id + |
+String + |
+Specifies the floating IP address ID. + |
+
floating_ip_address + |
+String + |
+Specifies the floating IPv6 address. + |
+
floating_network_id + |
+String + |
+Specifies the external network ID. + |
+
router_id + |
+String + |
+Specifies the ID of the belonged router. + |
+
port_id + |
+String + |
+Specifies the port ID. + |
+
fixed_ip_address + |
+String + |
+Specifies the private IP address of the associated port. + |
+
tenant_id + |
+String + |
+Specifies the project ID. + |
+
floatingips_links + |
+Array of strings + |
+Specifies the request URL. + |
+
{
+ "floatingips": [
+ {
+ "id": "861a4c5b-b17b-4a1d-b653-f3e95dcb3345",
+ "status": "DOWN",
+ "router_id": null,
+ "tenant_id": "26ae5181a416420998eb2093aaed84d9",
+ "project_id": "26ae5181a416420998eb2093aaed84d9",
+ "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
+ "fixed_ip_address": null,
+ "floating_ip_address": "cdcd:910a:2222:5498:8475:1111:c613:16e3",
+ "port_id": null,
+ "created_at": "2019-03-26T09:52:41",
+ "updated_at": "2019-03-26T09:52:45"
+ }
+ ],
+ "floatingips_links": [
+ {
+ "href": "https://network.region.cn-southwest-2.hwclouds.com/v2.0/floatingips_v6?marker=861a4c5b-b17b-4a1d-b653-f3e95dcb3345&page_reverse=true&page_reverse=True",
+ "rel": "previous"
+ }
+ ]
+}
+See Status Codes.
+See Error Codes.
+This API is used to query details about a specific floating IP address accessible to the tenant submitting the request.
+GET /v2.0/eip/floatingips_v6/{floatingip_id}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
floatingip + |
+floatingip object + |
+Specifies the floating IP address list. For details, see Table 2. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+String + |
+Specifies the floating IP address status. The value can be ACTIVE, DOWN, or ERROR. +
|
+
id + |
+String + |
+Specifies the floating IP address ID. + |
+
floating_ip_address + |
+String + |
+Specifies the floating IPv6 address. + |
+
floating_network_id + |
+String + |
+Specifies the external network ID. + |
+
router_id + |
+String + |
+Specifies the ID of the belonged router. + |
+
port_id + |
+String + |
+Specifies the port ID. + |
+
fixed_ip_address + |
+String + |
+Specifies the private IP address of the associated port. + |
+
tenant_id + |
+String + |
+Specifies the project ID. + |
+
{
+ "floatingip": {
+ "id": "861a4c5b-b17b-4a1d-b653-f3e95dcb3345",
+ "status": "DOWN",
+ "router_id": null,
+ "tenant_id": "26ae5181a416420998eb2093aaed84d9",
+ "project_id": "26ae5181a416420998eb2093aaed84d9",
+ "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
+ "fixed_ip_address": null,
+ "floating_ip_address": "cdcd:910a:2222:5498:8475:1111:c613:16e3",
+ "port_id": null,
+ "created_at": "2019-03-26T09:52:41",
+ "updated_at": "2019-03-26T09:52:45"
+ }
+}
+See Status Codes.
+See Error Codes.
+This API is used to assign a floating IP address and associates it with an internal port.
+Restrictions
+You can use GET /v2.0/networks?router:external=True or run the neutron net-external-list command to obtain the UUID of the external network required for assigning a floating IP address.
+The port_id parameter value must be the ECS port ID, which can be obtained from the NIC ID parameter in the ECS NIC details.
+POST /v2.0/eip/floatingips_v6
+Parameter + |
+Type + |
+Mandatory + |
+Description + |
+
|---|---|---|---|
floatingip + |
+floatingip object + |
+Yes + |
+Specifies the floating IP address list. For details, see Table 2. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
id + |
+Yes + |
+String + |
+Specifies the floating IP address ID. + |
+
floating_ip_address + |
+No + |
+String + |
+Specifies the floating IPv6 address. + |
+
floating_network_id + |
+No + |
+String + |
+Specifies the external network ID. +You can only use fixed external network. +You can use GET /v2.0/networks?router:external=True or +GET /v2.0/networks?name={floating_network} or run the neutron net-external-list command to obtain information about the external network. + |
+
router_id + |
+No + |
+String + |
+Specifies the ID of the belonged router. + |
+
port_id + |
+No + |
+String + |
+Specifies the port ID. + |
+
fixed_ip_address + |
+No + |
+String + |
+Specifies the private IP address of the associated port. +This value can only be dynamically assigned by the system. + |
+
tenant_id + |
+No + |
+String + |
+Specifies the project ID. + |
+
POST https://{Endpoint}/v2.0/eip/floatingips_v6
+
+{
+ "floatingip": {
+ "floating_network_id": "5ce655fa-c911-4d2c-99f7-445bc1162ef8",
+ "port_id": "552389f5-8f4c-4bb7-9991-07233c315d60"
+ }
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
floatingip + |
+floatingip object + |
+Specifies the floating IP address list. For details, see Table 4. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+String + |
+Specifies the floating IP address status. The value can be ACTIVE, DOWN, or ERROR. +
|
+
id + |
+String + |
+Specifies the floating IP address ID. + |
+
floating_ip_address + |
+String + |
+Specifies the floating IPv6 address. + |
+
floating_network_id + |
+String + |
+Specifies the external network ID. + |
+
router_id + |
+String + |
+Specifies the ID of the belonged router. + |
+
port_id + |
+String + |
+Specifies the port ID. + |
+
fixed_ip_address + |
+String + |
+Specifies the private IP address of the associated port. + |
+
tenant_id + |
+String + |
+Specifies the project ID. + |
+
{
+ "floatingip": {
+ "router_id": "76c052d6-6a92-444c-b67d-147ee166a480",
+ "status": "DOWN",
+ "tenant_id": "6fd9b5fdb997425f97bc5ba1f0846084",
+ "floating_network_id": "5ce655fa-c911-4d2c-99f7-445bc1162ef8",
+ "fixed_ip_address": "12.xx.xx.5",
+ "floating_ip_address": "cdcd:910a:2222:5498:8475:1111:c013:8096",
+ "port_id": "552389f5-8f4c-4bb7-9991-07233c315d60",
+ "id": "2567f393-5c76-42db-a397-477723ce41f7"
+ }
+}
+See Status Codes.
+See Error Codes.
+This API is used to update a specific floating IP address and the port associated with the IP address. If port_id is left blank, the floating IP address has been unbound from the port.
+Restrictions
+When you bind a floating IP address, if the floating IP address is in the error state, try unbinding the address first.
+You are not allowed to bind a floating IP address that has been bound to a port to another port. You must first unbind the IP address from its original port and bind it to the required port.
+PUT /v2.0/eip/floatingips_v6/{floatingip_id}
+Parameter + |
+Type + |
+Mandatory + |
+Description + |
+
|---|---|---|---|
floatingip + |
+floatingip object + |
+Yes + |
+Specifies the floating IP address list. For details, see Table 2. + |
+
PUT https://{Endpoint}/v2.0/eip/floatingips_v6/b639c937-4737-4107-8978-fecc7327a5ae
+
+{
+ "floatingip": {
+ "port_id": "21b5c483-84e9-40a1-86b3-3041606106f5",
+ "fixed_ip_address": "10.0.2.2"
+ }
+}
+PUT https://{Endpoint}/v2.0/eip/floatingips_v6/3870858f-91dc-489f-92a1-c04dbdc6d781
+
+{
+ "floatingip": {
+ "port_id": null
+ }
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
floatingip + |
+floatingip object + |
+Specifies the floating IP address list. For details, see Table 4. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+String + |
+Specifies the floating IP address status. The value can be ACTIVE, DOWN, or ERROR. +
|
+
id + |
+String + |
+Specifies the floating IP address ID. + |
+
floating_ip_address + |
+String + |
+Specifies the floating IPv6 address. + |
+
floating_network_id + |
+String + |
+Specifies the external network ID. + |
+
router_id + |
+String + |
+Specifies the ID of the belonged router. + |
+
port_id + |
+String + |
+Specifies the port ID. + |
+
fixed_ip_address + |
+String + |
+Specifies the private IP address of the associated port. + |
+
tenant_id + |
+String + |
+Specifies the project ID. + |
+
{
+ "floatingip": {
+ "router_id": "76c052d6-6a92-444c-b67d-147ee166a480",
+ "status": "ACTIVE",
+ "tenant_id": "6fbe9263116a4b68818cf1edce16bc4f",
+ "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
+ "fixed_ip_address": "10.0.2.2",
+ "floating_ip_address": "cdcd:910a:2222:5498:8475:1111:c013:8096",
+ "port_id": "21b5c483-84e9-40a1-86b3-3041606106f5",
+ "id": "b639c937-4737-4107-8978-fecc7327a5ae"
+ }
+}
+{
+ "floatingip": {
+ "floating_network_id": "809fdbbc-2e3e-426e-897c-cb632b081a72",
+ "router_id": null,
+ "fixed_ip_address": null,
+ "floating_ip_address": "cdcd:910a:2222:5498:8475:1111:c013:8096",
+ "tenant_id": "3c8c36e1520147ccbc83d2ccfbb9ab24",
+ "status": "ACTIVE",
+ "port_id": null,
+ "id": "3870858f-91dc-489f-92a1-c04dbdc6d781"
+ }
+}
+See Status Codes.
+See Error Codes.
+This API is used to delete a floating IP address.
+DELETE /v2.0/eip/floatingips_v6/{floatingip_id}
+See Status Codes.
+See Error Codes.
+Permission + |
+API + |
+Action + |
+
|---|---|---|
Assigns an EIP. + |
+POST /v1/{project_id}/publicips + |
+vpc:publicIps:create + |
+
Queries an EIP. + |
+GET /v1/{project_id}/publicips/{publicip_id} + |
+vpc:publicIps:get + |
+
Queries EIPs. + |
+GET /v1/{project_id}/publicips + |
+vpc:publicIps:list + |
+
Updates an EIP. + |
+PUT /v1/{project_id}/publicips/{publicip_id} + |
+vpc:publicIps:update + |
+
Release an EIP. + |
+DELETE /v1/{project_id}/publicips/{publicip_id} + |
+vpc:publicIps:delete + |
+
Permission + |
+API + |
+Action + |
+
|---|---|---|
Queries a bandwidth. + |
+GET /v1/{project_id}/bandwidths/{bandwidth_id} + |
+vpc:bandwidths:get + |
+
Queries bandwidths. + |
+GET /v1/{project_id}/bandwidths + |
+vpc:bandwidths:list + |
+
Updates a bandwidth. + |
+PUT /v1/{project_id}/bandwidths/{bandwidth_id} + |
+vpc:bandwidths:update + |
+
Permission + |
+API + |
+Action + |
+
|---|---|---|
Allocates a shared bandwidth. + |
+POST /v2.0/{project_id}/bandwidths + |
+vpc:bandwidths:create + |
+
Deletes a shared bandwidth. + |
+DELETE /v2.0/{project_id}/bandwidths/{bandwidth_id} + |
+vpc:bandwidths:delete + |
+
Adds an EIP to a shared bandwidth. + |
+POST /v2.0/{project_id}/bandwidths/{bandwidth_id}/insert + |
+vpc:publicIps:insert + |
+
Removes an EIP from a shared bandwidth. + |
+POST /v2.0/{project_id}/bandwidths/{bandwidth_id}/remove + |
+vpc:publicIps:remove + |
+
Permission + |
+API + |
+Action + |
+
|---|---|---|
Queries floating IP addresses. + |
+GET /v2.0/floatingips + |
+vpc:floatingIps:get + |
+
Queries a floating IP address. + |
+GET /v2.0/floatingips/{floatingip_id} + |
+vpc:floatingIps:get + |
+
Creates a floating IP address. + |
+POST /v2.0/floatingips + |
+vpc:floatingIps:create + |
+
Updates a floating IP address. + |
+PUT /v2.0/floatingips/{floatingip_id} + |
+vpc:floatingIps:update + |
+
Deletes a floating IP address. + |
+DELETE /v2.0/floatingips/{floatingip_id} + |
+vpc:floatingIps:delete + |
+
If you have insufficient permissions, response code 200 will be returned when you query network resources and an empty list will be displayed.
+This API is used to query network resource quotas of a tenant. The network resources include VPCs, subnets, security groups, security group rules, EIPs, and VPNs.
+
This API is used to query both the EIP and VPC quotas.
+GET /v1/{project_id}/quotas
+GET https://{Endpoint}/v1/{project_id}/quotas?type={type}
+Name + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
type + |
+No + |
+String + |
+
|
+
None+
GET https://{Endpoint}/v1/{project_id}/quotas
+Name + |
+Type + |
+Description + |
+
|---|---|---|
quotas + |
+quotas object + |
+Specifies the quota object. For details, see Table 3. + |
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
resources + |
+Array of resource objects + |
+Specifies the resource objects. For details, see Table 4. + |
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
type + |
+String + |
+
|
+
used + |
+Integer + |
+
|
+
quota + |
+Integer + |
+
|
+
min + |
+Integer + |
+Specifies the minimum quota value allowed. + |
+
{
+ "quotas": {
+ "resources": [
+ {
+ "type": "vpc",
+ "used": 4,
+ "quota": 150,
+ "min": 0
+ },
+ {
+ "type": "subnet",
+ "used": 5,
+ "quota": 400,
+ "min": 0
+ },
+ {
+ "type": "securityGroup",
+ "used": 1,
+ "quota": 100,
+ "min": 0
+ },
+ {
+ "type": "securityGroupRule",
+ "used": 6,
+ "quota": 5000,
+ "min": 0
+ },
+ {
+ "type": "publicIp",
+ "used": 2,
+ "quota": 10,
+ "min": 0
+ },
+ {
+ "type": "vpn",
+ "used": 0,
+ "quota": 5,
+ "min": 0
+ },
+ {
+ "type": "vpcPeer",
+ "used": 0,
+ "quota": 50,
+ "min": 0
+ },
+ {
+ "type": "firewall",
+ "used": 0,
+ "quota": 200,
+ "min": 0
+ },
+ {
+ "type": "shareBandwidth",
+ "used": 0,
+ "quota": 5,
+ "min": 0
+ },
+ {
+ "type": "shareBandwidthIP",
+ "used": 0,
+ "quota": 20,
+ "min": 0
+ },
+ {
+ "type": "loadbalancer",
+ "used": 0,
+ "quota": 10,
+ "min": 0
+ },
+ {
+ "type": "listener",
+ "used": 0,
+ "quota": 10,
+ "min": 0
+ }
+ ]
+ }
+}
+See Status Codes.
+See Error Codes.
+This API is used to create a tag for an EIP.
+Parameter + |
+Type + |
+Mandatory + |
+Description + |
+
|---|---|---|---|
tag + |
+tag object + |
+Yes + |
+Specifies the tag objects. For details, see Table 3. + |
+
Attribute + |
+Type + |
+Mandatory + |
+Description + |
+
|---|---|---|---|
key + |
+String + |
+Yes + |
+
|
+
value + |
+String + |
+Yes + |
+
|
+
POST https://{Endpoint}/v2.0/{project_id}/publicips/{publicip_id}/tags
+
+{
+ "tag": {
+ "key": "key1",
+ "value": "value1"
+ }
+}
+See Status Codes.
+See Error Codes.
+This API is used to query tags of a specified EIP.
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
tags + |
+Array of tag objects + |
+Specifies the tag object list. For details, see Table 3. + |
+
Attribute + |
+Type + |
+Description + |
+
|---|---|---|
key + |
+String + |
+
|
+
value + |
+String + |
+
|
+
{
+ "tags": [
+ {
+ "key": "key1",
+ "value": "value1"
+ },
+ {
+ "key": "key2",
+ "value": "value3"
+ }
+ ]
+}
+See Status Codes.
+See Error Codes.
+This API is used to delete an EIP tag.
+DELETE /v2.0/{project_id}/publicips/{publicip_id}/tags/{key}
+Table 1 describes the parameters.
+ + +See Status Codes.
+See Error Codes.
+This API is used to add multiple tags to or delete multiple tags from an EIP at a time.
+This API is idempotent.
+If there are duplicate keys in the request body when you add tags, an error is reported.
+During tag creation, duplicate keys are not allowed. If a key already exists in the database, its value will be overwritten by the new duplicate key.
+During tag deletion, if some tags do not exist, the operation is considered to be successful by default. The character set of the tags will not be checked. When you delete tags, the tag structure cannot be missing, and the key cannot be left blank or be an empty string.
+POST /v2.0/{project_id}/publicips/{publicip_id}/tags/action
+Table 1 describes the parameters.
+ + +Parameter + |
+Type + |
+Mandatory + |
+Description + |
+
|---|---|---|---|
tags + |
+Array of tag objects + |
+Yes + |
+Specifies the tag object list. For details, see Table 3. + |
+
action + |
+String + |
+Yes + |
+Specifies the operation. Possible values are as follows: +
|
+
Attribute + |
+Type + |
+Mandatory + |
+Description + |
+
|---|---|---|---|
key + |
+String + |
+Yes + |
+
|
+
value + |
+String + |
+Yes + |
+
|
+
POST https://{Endpoint}/v2.0/{project_id}/publicips/{publicip_id}/tags/action
+
+{
+ "action": "create",
+ "tags": [
+ {
+ "key": "key1",
+ "value": "value1"
+ },
+ {
+ "key": "key2",
+ "value": "value3"
+ }
+ ]
+}
+POST https://{Endpoint}/v2.0/{project_id}/publicips/{publicip_id}/tags/action
+
+{
+ "action": "delete",
+ "tags": [
+ {
+ "key": "key1",
+ "value": "value1"
+ },
+ {
+ "key": "key2",
+ "value": "value3"
+ }
+ ]
+}
+See Status Codes.
+See Error Codes.
+This API is used to query EIPs by tag.
+POST /v2.0/{project_id}/publicips/resource_instances/action
+Table 1 describes the parameters.
+ + +Parameter + |
+Type + |
+Mandatory + |
+Description + |
+
|---|---|---|---|
tags + |
+Array of tags objects + |
+No + |
+Specifies the included tags. A maximum of 20 tag keys are allowed for each query operation. Each tag key can have up to 10 tag values. The structure body must be included. The tag key cannot be left blank or set to an empty string. Each tag key must be unique, and each tag value in a tag must be unique. + |
+
limit + |
+Integer + |
+No + |
+Sets the page size. This parameter is not available when action is set to count. The default value is 1000 when action is set to filter. The maximum value is 1000, and the minimum value is 1. The value cannot be a negative number. + |
+
offset + |
+Integer + |
+No + |
+Specifies the index position. The query starts from the next piece of data indexed by this parameter. This parameter is not required when you query data on the first page. The value in the response returned for querying data on the previous page will be included in this parameter for querying data on subsequent pages. This parameter is not available when action is set to count. If action is set to filter, the value must be a number, and the default value is 0. The value cannot be a negative number. + |
+
action + |
+String + |
+Yes + |
+Specifies the operation to perform. The value can only be filter (filtering) or count (querying the total number). +The value filter indicates pagination query. The value count indicates that the total number of query results meeting the search criteria will be returned. + |
+
matches + |
+Array of match objects + |
+No + |
+Specifies the search criteria. The tag key is the field to match. Currently, only resource_name is supported. The tag value indicates the matched value. This field is a fixed dictionary value. + |
+
Name + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Specifies the tag key. The value can contain a maximum of 127 Unicode characters. The tag key cannot be left blank. (This parameter is not verified during the search process.) + |
+
values + |
+Yes + |
+Array of strings + |
+Specifies the tag value list. Each value can contain a maximum of 255 Unicode characters. An empty list for values indicates any value. The values are in the OR relationship. + |
+
Name + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Specifies the tag key. Currently, the tag key can only be the resource name. + |
+
value + |
+Yes + |
+String + |
+Specifies the tag value. Each value can contain a maximum of 255 Unicode characters. + |
+
POST https://{Endpoint}/v2.0/{project_id}/publicips/resource_instances/action
+
+{
+ "offset": "0",
+ "limit": "100",
+ "action": "filter",
+ "matches": [
+ {
+ "key": "resource_name",
+ "value": "resource1"
+ }
+ ],
+ "tags": [
+ {
+ "key": "key1",
+ "values": [
+ "*value1",
+ "value2"
+ ]
+ }
+ ]
+}
+{
+ "action": "count",
+ "tags": [
+ {
+ "key": "key1",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ },
+ {
+ "key": "key2",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ }
+ ],
+ "matches": [
+ {
+ "key": "resource_name",
+ "value": "resource1"
+ }
+ ]
+}
+Name + |
+Type + |
+Description + |
+
|---|---|---|
resources + |
+Array of resource objects + |
+Specifies the resource object list. For details, see Table 6. + |
+
total_count + |
+Integer + |
+Specifies the total number of query records. + |
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
resource_id + |
+String + |
+Specifies the resource ID. + |
+
resource_detail + |
+Object + |
+Specifies the resource details. Resource details are used for extension. This parameter is left blank by default. + |
+
tags + |
+Array of tags objects + |
+Specifies the tag list. This parameter is an empty array by default if there is no tag. For details, see Table 7. + |
+
resource_name + |
+String + |
+Specifies the resource name. This parameter is an empty string by default if there is no resource name. + |
+
Name + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Specifies the tag key. The value can contain a maximum of 127 Unicode characters. The tag key cannot be left blank. (This parameter is not verified during the search process.) + |
+
value + |
+Yes + |
+String + |
+Specifies the tag value list. Each value can contain a maximum of 255 Unicode characters. An empty list for values indicates any value. The values are in the OR relationship. + |
+
{
+ "resources": [
+ {
+ "resource_detail": null,
+ "resource_id": "cdfs_cefs_wesas_12_dsad",
+ "resource_name": "resouece1",
+ "tags": [
+ {
+ "key": "key1",
+ "value": "value1"
+ },
+ {
+ "key": "key2",
+ "value": "value1"
+ }
+ ]
+ }
+ ],
+ "total_count": 1000
+}
+{
+ "total_count": 1000
+}
+See Status Codes.
+See Error Codes.
+This API is used to query all EIP tags of a tenant in a specified region.
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
tags + |
+Array of tag objects + |
+Specifies the tag object list. For details, see Table 3. + |
+
Name + |
+Type + |
+Description + |
+
|---|---|---|
key + |
+String + |
+Specifies the tag key. +
|
+
values + |
+Array of strings + |
+Specifies the tag value list. +
|
+
{
+ "tags": [
+ {
+ "key": "key1",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ },
+ {
+ "key": "key2",
+ "values": [
+ "value1",
+ "value2"
+ ]
+ }
+ ]
+}
+See Status Codes.
+See Error Codes.
+This API is used to query all available versions of a native OpenStack API.
+GET /
+Request parameter
+None
+Example request
+GET https://{Endpoint}/
+Response parameter
+ +Parameter + |
+Type + |
+Description + |
+
|---|---|---|
versions + |
+Array of version objects + |
+Specifies the API version list. For details, see Table 2. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+String + |
+Specifies the API version status. Possible values are as follows: +
|
+
id + |
+String + |
+Specifies the API version. + |
+
links + |
+Array of link objects + |
+Specifies the link list. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
href + |
+String + |
+Specifies the API link. + |
+
rel + |
+String + |
+Specifies the relationship between the API link and the API version. + |
+
Example response
+{
+ "versions": [
+ {
+ "status": "CURRENT",
+ "id": "v2.0",
+ "links": [
+ {
+ "href": "https://None/v2.0",
+ "rel": "self"
+ }
+ ]
+ }
+ ]
+}
+See Status Codes.
+See Error Codes.
+This API is used to query the version of a specified API.
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
resources + |
+Array of resource objects + |
+Specifies the resource object list. + |
+
{
+ "resources": [
+ {
+ "links": [
+ {
+ "href": "https://vpc.systems.com/v2.0/subnets",
+ "rel": "self"
+ }
+ ],
+ "name": "subnet",
+ "collection": "subnets"
+ },
+ {
+ "links": [
+ {
+ "href": "https://vpc.systems.com/v2.0/networks",
+ "rel": "self"
+ }
+ ],
+ "name": "network",
+ "collection": "networks"
+ },
+ {
+ "links": [
+ {
+ "href": "https://vpc.systems.com/v2.0/ports",
+ "rel": "self"
+ }
+ ],
+ "name": "port",
+ "collection": "ports"
+ }
+ ]
+}
+See Status Codes.
+See Error Codes.
+Neutron APIs v2.0 provides the pagination function. You can set parameters limit and marker in the URL to enable the desired number of items to be returned. All returned items are displayed in the ascending order of ID.
+Request parameter
+ +Parameter + |
+Type + |
+Mandatory + |
+Description + |
+
|---|---|---|---|
limit + |
+Integer + |
+No + |
+Specifies the number of items displayed per page. + |
+
marker + |
+String + |
+No + |
+Specifies the ID of the last item in the previous list. If the marker value is invalid, error code 400 will be returned. + |
+
page_reverse + |
+Boolean + |
+No + |
+Specifies the page direction. The value can be True or False. + |
+
Example request 1
+GET https://{Endpoint}/v2.0/networks?limit=2&marker=3d42a0d4-a980-4613-ae76-a2cddecff054&page_reverse=False
+Example request 2
+GET https://{Endpoint}/v2.0/vpc/peerings?limit=2&marker=e5a0c88e-228e-4e62-a8b0-90825b1b7958&page_reverse=True
+Response parameter
+None
+Example response 1
+{
+ "networks": [
+ {
+ "status": "ACTIVE",
+ "subnets": [],
+ "name": "liudongtest ",
+ "admin_state_up": false,
+ "tenant_id": "6fbe9263116a4b68818cf1edce16bc4f",
+ "id": "60c809cb-6731-45d0-ace8-3bf5626421a9"
+ },
+ {
+ "status": "ACTIVE",
+ "subnets": [
+ "132dc12d-c02a-4c90-9cd5-c31669aace04"
+ ],
+ "name": "publicnet",
+ "admin_state_up": true,
+ "tenant_id": "6fbe9263116a4b68818cf1edce16bc4f",
+ "id": "9daeac7c-a98f-430f-8e38-67f9c044e299"
+ }
+ ],
+ "networks_links": [
+ {
+ "href": "http://192.168.82.231:9696/v2.0/networks?limit=2&marker=9daeac7c-a98f-430f-8e38-67f9c044e299",
+ "rel": "next"
+ },
+ {
+ "href": "http://192.168.82.231:9696/v2.0/networks?limit=2&marker=60c809cb-6731-45d0-ace8-3bf5626421a9&page_reverse=True",
+ "rel": "previous"
+ }
+ ]
+}
+Example response 2
+{
+ "peerings_links": [
+ {
+ "marker": "dd442819-5638-401c-bd48-a82703cf0464",
+ "rel": "next"
+ },
+ {
+ "marker": "1e13cbaf-3ce4-413d-941f-66d855dbfa7f",
+ "rel": "previous"
+ }
+ ],
+ "peerings": [
+ {
+ "status": "ACTIVE",
+ "accept_vpc_info": {
+ "vpc_id": "83a48834-b9bc-4f70-aa46-074568594650",
+ "tenant_id": "e41a43bf06e249678413c6d61536eff9"
+ },
+ "request_vpc_info": {
+ "vpc_id": "db8e7687-e43b-4fc1-94cf-16f69f484d6d",
+ "tenant_id": "e41a43bf06e249678413c6d61536eff9"
+ },
+ "name": "peering1",
+ "id": "1e13cbaf-3ce4-413d-941f-66d855dbfa7f"
+ },
+ {
+ "status": "ACTIVE",
+ "accept_vpc_info": {
+ "vpc_id": "83a48834-b9bc-4f70-aa46-074568594650",
+ "tenant_id": "e41a43bf06e249678413c6d61536eff9"
+ },
+ "request_vpc_info": {
+ "vpc_id": "bd63cc9e-e7b8-4d4e-a0e9-055031470ffc",
+ "tenant_id": "e41a43bf06e249678413c6d61536eff9"
+ },
+ "name": "peering2",
+ "id": "dd442819-5638-401c-bd48-a82703cf0464"
+ }
+ ]
+}
+See Status Codes.
+See Error Codes.
+This API is used to query all floating IP addresses accessible to the tenant submitting the request.
+You can query the detailed information about a specified floating IP address using the API for Querying a Floating IP Address.
+GET /v2.0/floatingips
+Table 1 describes the parameters.
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
id + |
+No + |
+String + |
+Specifies the floating IP address ID. + |
+
floating_ip_address + |
+No + |
+String + |
+Specifies the floating IPv4 address. + |
+
floating_network_id + |
+No + |
+String + |
+Specifies the external network ID. +You can only use fixed external network. +You can use GET /v2.0/networks?router:external=True or +GET /v2.0/networks?name={floating_network} or run the neutron net-external-list command to obtain information about the external network. + |
+
router_id + |
+No + |
+String + |
+Specifies the ID of the belonged router. + |
+
port_id + |
+No + |
+String + |
+Specifies the port ID. + |
+
fixed_ip_address + |
+No + |
+String + |
+Specifies the private IP address of the associated port. + |
+
tenant_id + |
+No + |
+String + |
+Specifies the project ID. + |
+
limit + |
+Integer + |
+No + |
+Specifies the number of records that will be returned on each page. The value is from 0 to intmax. +limit can be used together with marker. For details, see the parameter description of marker. + |
+
marker + |
+String + |
+No + |
+Specifies a resource ID for pagination query, indicating that the query starts from the next record of the specified resource ID. +This parameter can work together with the parameter limit. +
|
+
page_reverse + |
+Boolean + |
+No + |
+Specifies the page direction. The value can be True or False. + |
+
Example:
+GET https://{Endpoint}/v2.0/floatingips?id={fip_id}&router_id={router_id}&floating_network_id={net_id}&floating_ip_address={floating_ip}&port_id={port_id}&fixed_ip_address={fixed_ip}&tenant_id={tenant_id}
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
floatingips + |
+Array of floatingip objects + |
+Specifies the floating IP address list. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+String + |
+Specifies the floating IP address status. The value can be ACTIVE, DOWN, or ERROR. +
|
+
id + |
+String + |
+Specifies the floating IP address ID. + |
+
project_id + |
+String + |
+Specifies the project ID. + |
+
floating_ip_address + |
+String + |
+Specifies the floating IP address. + |
+
floating_network_id + |
+String + |
+Specifies the external network ID. + |
+
router_id + |
+String + |
+Specifies the ID of the belonged router. + |
+
port_id + |
+String + |
+Specifies the port ID. + NOTE:
+The value of port_id is null if the EIP is bound to a dedicated load balancer. + |
+
fixed_ip_address + |
+String + |
+Specifies the private IP address of the associated port. + |
+
tenant_id + |
+String + |
+Specifies the project ID. + + |
+
dns_name + |
+String + |
+Specifies the DNS name. + |
+
dns_domain + |
+String + |
+Specifies the DNS domain. + |
+
created_at + |
+String + |
+Specifies the time when the floating IP address was created. +UTC time is used. +Format: yyyy-MM-ddTHH:mm:ss + |
+
updated_at + |
+String + |
+Specifies the time when the floating IP address was updated. +UTC time is used. +Format: yyyy-MM-ddTHH:mm:ss + |
+
Example request
+GET https://{Endpoint}/v2.0/floatingips?limit=1
+Example response
+{
+ "floatingips": [
+ {
+ "id": "1a3a2818-d9b4-4a9c-8a19-5252c499d1cd",
+ "status": "DOWN",
+ "router_id": null,
+ "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
+ "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
+ "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
+ "fixed_ip_address": null,
+ "floating_ip_address": "99.99.99.84",
+ "port_id": null,
+ "dns_name": "ecs-80-158-78-239",
+ "dns_domain": "reverse.domain-name.com",
+ "created_at": "2017-10-19T12:21:28",
+ "updated_at": "2018-07-30T12:52:13"
+ }
+ ]
+}
+See Status Codes.
+See Error Codes.
+This API is used to query details about a specified floating IP address, including the floating IP address status, ID of the router to which the floating IP address belongs, and external network ID of the floating IP address.
+GET /v2.0/floatingips/{floatingip_id}
+None
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
floatingip + |
+floatingip object + |
+Specifies the floating IP address list. For details, see Table 2. + |
+
Attribute + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+String + |
+Specifies the floating IP address status. The value can be ACTIVE, DOWN, or ERROR. +
|
+
id + |
+String + |
+Specifies the floating IP address ID. + |
+
project_id + |
+String + |
+Specifies the project ID. + |
+
floating_ip_address + |
+String + |
+Specifies the floating IP address. + |
+
floating_network_id + |
+String + |
+Specifies the external network ID. + |
+
router_id + |
+String + |
+Specifies the ID of the belonged router. + |
+
port_id + |
+String + |
+Specifies the port ID. + NOTE:
+The value of port_id is null if the EIP is bound to a dedicated load balancer. + |
+
fixed_ip_address + |
+String + |
+Specifies the private IP address of the associated port. + |
+
tenant_id + |
+String + |
+Specifies the project ID. + + |
+
dns_name + |
+String + |
+Specifies the DNS name. + |
+
dns_domain + |
+String + |
+Specifies the DNS domain. + |
+
created_at + |
+String + |
+Specifies the time when the floating IP address was created. +UTC time is used. +Format: yyyy-MM-ddTHH:mm:ss + |
+
updated_at + |
+String + |
+Specifies the time when the floating IP address was updated. +UTC time is used. +Format: yyyy-MM-ddTHH:mm:ss + |
+
Example request
+GET https://{Endpoint}/v2.0/floatingips/1a3a2818-d9b4-4a9c-8a19-5252c499d1cd
+Example response
+{
+ "floatingip": {
+ "id": "1a3a2818-d9b4-4a9c-8a19-5252c499d1cd",
+ "status": "DOWN",
+ "router_id": null,
+ "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
+ "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
+ "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
+ "fixed_ip_address": null,
+ "floating_ip_address": "99.99.99.84",
+ "port_id": null,
+ "dns_name": "ecs-80-158-78-239",
+ "dns_domain": "reverse.domain-name.com",
+ "created_at": "2017-10-19T12:21:28",
+ "updated_at": "2018-07-30T12:52:13"
+ }
+}
+
+See Status Codes.
+See Error Codes.
+When assigning a floating IP address, you need to obtain the external network ID floating_network_id of the floating IP address.
+You can use GET /v2.0/networks?router:external=True or run the neutron net-external-list command to obtain the UUID of the external network required for assigning a floating IP address.
+POST /v2.0/floatingips
+Parameter + |
+Type + |
+Mandatory + |
+Description + |
+
|---|---|---|---|
floatingip + |
+floatingip object + |
+Yes + |
+Specifies the floating IP address list. For details, see Table 2. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
floating_ip_address + |
+No + |
+String + |
+Specifies the floating IP address. + |
+
floating_network_id + |
+Yes + |
+String + |
+Specifies the external network ID. +You can only use fixed external network. +You can use GET /v2.0/networks?router:external=True or +GET /v2.0/networks?name={floating_network} or +run the neutron net-external-list mode command to obtain information about the external network. + |
+
port_id + |
+No + |
+String + |
+Specifies the port ID. + |
+
fixed_ip_address + |
+No + |
+String + |
+Specifies the private IP address of the associated port. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
floatingip + |
+floatingip object + |
+Specifies the floating IP address list. For details, see Table 4. + |
+
Attribute + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+String + |
+Specifies the floating IP address status. The value can be ACTIVE, DOWN, or ERROR. +
|
+
id + |
+String + |
+Specifies the floating IP address ID. + |
+
floating_ip_address + |
+String + |
+Specifies the floating IP address. + |
+
floating_network_id + |
+String + |
+Specifies the external network ID. + |
+
router_id + |
+String + |
+Specifies the ID of the belonged router. + |
+
port_id + |
+String + |
+Specifies the port ID. + |
+
fixed_ip_address + |
+String + |
+Specifies the private IP address of the associated port. + |
+
tenant_id + |
+String + |
+Specifies the project ID. + + |
+
dns_name + |
+String + |
+Specifies the DNS name. + |
+
dns_domain + |
+String + |
+Specifies the DNS domain. + |
+
Example request
+POST https://{Endpoint}/v2.0/floatingips
+
+{
+ "floatingip": {
+ "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975"
+ }
+}
+Example response
+{
+ "floatingip": {
+ "id": "b997e0d4-3359-4c74-8f88-bc0af81cd5a2",
+ "status": "DOWN",
+ "router_id": null,
+ "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
+ "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
+ "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
+ "fixed_ip_address": null,
+ "floating_ip_address": "88.88.215.205",
+ "port_id": null,
+ "dns_name": "ecs-80-158-78-239",
+ "dns_domain": "reverse.domain-name.com",
+ "created_at": "2018-09-20T02:10:02",
+ "updated_at": "2018-09-20T02:10:02"
+ }
+}
+See Status Codes.
+See Error Codes.
+This API is used to update a floating IP address.
+During the update, the ID of the floating IP address must be provided in the URL.
+If port_id is left blank, the floating IP address has been unbound from the port.
+
PUT /v2.0/floatingips/{floatingip_id}
+Table 1 describes the parameters.
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
floatingip_id + |
+Yes + |
+String + |
+Specifies the floating IP address ID. +This parameter is not required when you assign a floating IP address. This parameter is mandatory when you query, update, or delete a floating IP address. + |
+
Parameter + |
+Type + |
+Mandatory + |
+Description + |
+
|---|---|---|---|
floatingip + |
+floatingip object + |
+Yes + |
+Specifies the floating IP address list. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
floatingip + |
+floatingip object + |
+Specifies the floating IP address list. For details, see Table 5. + |
+
Attribute + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+String + |
+Specifies the floating IP address status. The value can be ACTIVE, DOWN, or ERROR. +
|
+
id + |
+String + |
+Specifies the floating IP address ID. + |
+
floating_ip_address + |
+String + |
+Specifies the floating IP address. + |
+
floating_network_id + |
+String + |
+Specifies the external network ID. + |
+
router_id + |
+String + |
+Specifies the ID of the belonged router. + |
+
port_id + |
+String + |
+Specifies the port ID. + |
+
fixed_ip_address + |
+String + |
+Specifies the private IP address of the associated port. + |
+
tenant_id + |
+String + |
+Specifies the project ID. + + |
+
dns_name + |
+String + |
+Specifies the DNS name. + |
+
dns_domain + |
+String + |
+Specifies the DNS domain. + |
+
Example request 1 (Binding a floating IP address to a port)
+PUT https://{Endpoint}/v2.0/floatingips/b997e0d4-3359-4c74-8f88-bc0af81cd5a2
+
+{
+ "floatingip": {
+ "port_id": "f91f5763-c5a2-4458-979d-61e48b3c3fac"
+ }
+}
+Example response 1 (Binding a floating IP address to a port)
+{
+ "floatingip": {
+ "id": "b997e0d4-3359-4c74-8f88-bc0af81cd5a2",
+ "status": "DOWN",
+ "router_id": null,
+ "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
+ "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
+ "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
+ "fixed_ip_address": "192.168.10.3",
+ "floating_ip_address": "88.88.215.205",
+ "port_id": 00587256-27e3-489b-96bf-ea80c1da4aeb,
+ "dns_name": "ecs-80-158-78-239",
+ "dns_domain": "reverse.domain-name.com",
+ "created_at": "2018-09-20T02:10:02",
+ "updated_at": "2018-09-20T02:10:07"
+ }
+}
+Example request 2 (Unbinding a floating IP address from a port)
+PUT https://{Endpoint}/v2.0/floatingips/b997e0d4-3359-4c74-8f88-bc0af81cd5a2
+
+{
+ "floatingip": {
+ "port_id": null
+ }
+}
+Example response 2 (Unbinding a floating IP address from a port)
+{
+ "floatingip": {
+ "id": "b997e0d4-3359-4c74-8f88-bc0af81cd5a2",
+ "status": "DOWN",
+ "router_id": null,
+ "tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
+ "project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
+ "floating_network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
+ "fixed_ip_address": null,
+ "floating_ip_address": "88.88.215.205",
+ "port_id": null,
+ "dns_name": "ecs-80-158-78-239",
+ "dns_domain": "reverse.domain-name.com",
+ "created_at": "2018-09-20T02:10:02",
+ "updated_at": "2018-09-20T02:10:07"
+ }
+}
+See Status Codes.
+See Error Codes.
+This API is used to delete a floating IP address.
+None
+None
+Example request
+DELETE https://{Endpoint}/v2.0/floatingips/a95ec431-8473-463b-aede-34fb048ee3a7
+Example response
+None
+See Status Codes.
+See Error Codes.
+