diff --git a/docs/as/api-ref/ALL_META.TXT.json b/docs/as/api-ref/ALL_META.TXT.json new file mode 100644 index 000000000..58cdbd431 --- /dev/null +++ b/docs/as/api-ref/ALL_META.TXT.json @@ -0,0 +1,612 @@ +[ + { + "uri":"en-us_topic_0045219159.html", + "product_code":"as", + "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":"as_06_0000.html", + "product_code":"as", + "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":"API", + "title":"API", + "githuburl":"" + }, + { + "uri":"as_06_0100.html", + "product_code":"as", + "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":"AS Groups", + "title":"AS Groups", + "githuburl":"" + }, + { + "uri":"as_06_0101.html", + "product_code":"as", + "code":"4", + "des":"An AS group consists of a collection of instances that apply to the same scenario. It is the basis for enabling or disabling AS policies and performing scaling actions. A", + "doc_type":"api", + "kw":"Creating an AS Group,AS Groups,API Reference", + "title":"Creating an AS Group", + "githuburl":"" + }, + { + "uri":"as_06_0102.html", + "product_code":"as", + "code":"5", + "des":"This API is used to query AS groups based on search criteria. The results are displayed by page.Search criteria can be the AS group name, AS configuration ID, AS group st", + "doc_type":"api", + "kw":"Querying AS Groups,AS Groups,API Reference", + "title":"Querying AS Groups", + "githuburl":"" + }, + { + "uri":"as_06_0103.html", + "product_code":"as", + "code":"6", + "des":"This API is used to query details about a specified AS group by group ID.GET /autoscaling-api/v1/{project_id}/scaling_group/{scaling_group_id}Request parametersNoneNoneEx", + "doc_type":"api", + "kw":"Querying AS Group Details,AS Groups,API Reference", + "title":"Querying AS Group Details", + "githuburl":"" + }, + { + "uri":"as_06_0104.html", + "product_code":"as", + "code":"7", + "des":"This API is used to modify a specified AS group.When the AS configuration of an AS group is changed, the existing instances created using the original AS configuration ar", + "doc_type":"api", + "kw":"Modifying an AS Group,AS Groups,API Reference", + "title":"Modifying an AS Group", + "githuburl":"" + }, + { + "uri":"as_06_0105.html", + "product_code":"as", + "code":"8", + "des":"This interface is used to delete a specified AS group.force_delete specifies whether to forcibly delete an AS group, remove the ECS instances and release them when the AS", + "doc_type":"api", + "kw":"Deleting an AS Group,AS Groups,API Reference", + "title":"Deleting an AS Group", + "githuburl":"" + }, + { + "uri":"as_06_0106.html", + "product_code":"as", + "code":"9", + "des":"This interface is used to enable or disable a specified AS group.For a disabled AS group, AS does not automatically trigger any scaling actions. When an AS group has an i", + "doc_type":"api", + "kw":"Enabling or Disabling an AS Group,AS Groups,API Reference", + "title":"Enabling or Disabling an AS Group", + "githuburl":"" + }, + { + "uri":"as_06_0200.html", + "product_code":"as", + "code":"10", + "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":"AS Configurations", + "title":"AS Configurations", + "githuburl":"" + }, + { + "uri":"as_06_0201.html", + "product_code":"as", + "code":"11", + "des":"This API is used to create an AS configuration.An AS configuration is a template of ECSs in an AS group. It defines the specifications of the instances to be added to the", + "doc_type":"api", + "kw":"Creating an AS Configuration,AS Configurations,API Reference", + "title":"Creating an AS Configuration", + "githuburl":"" + }, + { + "uri":"as_06_0202.html", + "product_code":"as", + "code":"12", + "des":"This API is used to query AS configurations based on search criteria. The results are displayed by page.Search criteria can be the AS configuration name, image ID, start ", + "doc_type":"api", + "kw":"Querying AS Configurations,AS Configurations,API Reference", + "title":"Querying AS Configurations", + "githuburl":"" + }, + { + "uri":"as_06_0203.html", + "product_code":"as", + "code":"13", + "des":"This interface is used to query details about an AS configuration by configuration ID.GET /autoscaling-api/v1/{project_id}/scaling_configuration/{scaling_configuration_id", + "doc_type":"api", + "kw":"Querying AS Configuration Details,AS Configurations,API Reference", + "title":"Querying AS Configuration Details", + "githuburl":"" + }, + { + "uri":"as_06_0204.html", + "product_code":"as", + "code":"14", + "des":"This interface is used to delete a specified AS configuration.AS configurations used by AS groups cannot be deleted.DELETE /autoscaling-api/v1/{project_id}/scaling_config", + "doc_type":"api", + "kw":"Deleting an AS Configuration,AS Configurations,API Reference", + "title":"Deleting an AS Configuration", + "githuburl":"" + }, + { + "uri":"as_06_0205.html", + "product_code":"as", + "code":"15", + "des":"This interface is used to batch delete AS configurations.AS configurations used by AS groups cannot be deleted.A maximum of 50 AS configurations can be deleted at a time.", + "doc_type":"api", + "kw":"Batch Deleting AS Configurations,AS Configurations,API Reference", + "title":"Batch Deleting AS Configurations", + "githuburl":"" + }, + { + "uri":"as_06_0300.html", + "product_code":"as", + "code":"16", + "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":"Instances in an AS Group", + "title":"Instances in an AS Group", + "githuburl":"" + }, + { + "uri":"as_06_0301.html", + "product_code":"as", + "code":"17", + "des":"This API is used to query instances in an AS group based on search criteria. The results are displayed by page.Search criteria can be the instance lifecycle status, insta", + "doc_type":"api", + "kw":"Querying Instances in an AS Group,Instances in an AS Group,API Reference", + "title":"Querying Instances in an AS Group", + "githuburl":"" + }, + { + "uri":"as_06_0302.html", + "product_code":"as", + "code":"18", + "des":"This interface is used to remove a specified instance from an AS group.You can remove instances only in INSERVICE state and only when the number of instances after the re", + "doc_type":"api", + "kw":"Removing a Specified Instance from an AS Group,Instances in an AS Group,API Reference", + "title":"Removing a Specified Instance from an AS Group", + "githuburl":"" + }, + { + "uri":"as_06_0303.html", + "product_code":"as", + "code":"19", + "des":"Add or remove instances to or from an AS group in batches.Configure instance protection or cancel the configuration for the instances in an AS group in batches.A batch op", + "doc_type":"api", + "kw":"Performing Operations on Instances in Batches,Instances in an AS Group,API Reference", + "title":"Performing Operations on Instances in Batches", + "githuburl":"" + }, + { + "uri":"as_06_0400.html", + "product_code":"as", + "code":"20", + "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":"AS Policies", + "title":"AS Policies", + "githuburl":"" + }, + { + "uri":"as_06_0401.html", + "product_code":"as", + "code":"21", + "des":"This API is used to create an AS policy.An AS policy defines whether to increase or decrease the number of instances in an AS group. If the number and the expected number", + "doc_type":"api", + "kw":"Creating an AS Policy,AS Policies,API Reference", + "title":"Creating an AS Policy", + "githuburl":"" + }, + { + "uri":"as_06_0402.html", + "product_code":"as", + "code":"22", + "des":"This API is used to create an AS policy for an AS group or bandwidth.The difference between the V2 and V1 APIs for creating an AS policy is that V2 supports creating an A", + "doc_type":"api", + "kw":"Creating an AS Policy (V2),AS Policies,API Reference", + "title":"Creating an AS Policy (V2)", + "githuburl":"" + }, + { + "uri":"as_06_0403.html", + "product_code":"as", + "code":"23", + "des":"This API is used to modify a specified AS policy.PUT /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id}Request parametersRequest parametersParameterManda", + "doc_type":"api", + "kw":"Modifying an AS Policy,AS Policies,API Reference", + "title":"Modifying an AS Policy", + "githuburl":"" + }, + { + "uri":"as_06_0404.html", + "product_code":"as", + "code":"24", + "des":"This API is used to modify a specified AS policy.The difference between the V2 and V1 APIs for modifying an AS policy is that V2 supports modifying a scaling resource typ", + "doc_type":"api", + "kw":"Modifying an AS Policy (V2),AS Policies,API Reference", + "title":"Modifying an AS Policy (V2)", + "githuburl":"" + }, + { + "uri":"as_06_0405.html", + "product_code":"as", + "code":"25", + "des":"This API is used to query AS policies based on search criteria. The results are displayed by page.Search criteria can be the AS policy name, policy type, policy ID, start", + "doc_type":"api", + "kw":"Querying AS Policies,AS Policies,API Reference", + "title":"Querying AS Policies", + "githuburl":"" + }, + { + "uri":"as_06_0406.html", + "product_code":"as", + "code":"26", + "des":"This API is used to query AS policies based on search criteria. The results are displayed by page.The difference between the V2 and V1 APIs for querying AS policies is th", + "doc_type":"api", + "kw":"Querying AS Policies (V2),AS Policies,API Reference", + "title":"Querying AS Policies (V2)", + "githuburl":"" + }, + { + "uri":"as_06_0407.html", + "product_code":"as", + "code":"27", + "des":"This API is used to query all AS policies for a tenant based on search criteria. The results are displayed by page.Search criteria can be the AS resource ID, AS resource ", + "doc_type":"api", + "kw":"Querying All AS Policies (V2),AS Policies,API Reference", + "title":"Querying All AS Policies (V2)", + "githuburl":"" + }, + { + "uri":"as_06_0408.html", + "product_code":"as", + "code":"28", + "des":"This API is used to query details about a specified AS policy by policy ID.GET /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id}Request parametersNoneNo", + "doc_type":"api", + "kw":"Querying AS Policy Details,AS Policies,API Reference", + "title":"Querying AS Policy Details", + "githuburl":"" + }, + { + "uri":"as_06_0409.html", + "product_code":"as", + "code":"29", + "des":"This API is used to query details about a specified AS policy by policy ID.The difference between the V2 and V1 APIs for querying details of an AS policy is that V2 conta", + "doc_type":"api", + "kw":"Querying Details of an AS Policy (V2),AS Policies,API Reference", + "title":"Querying Details of an AS Policy (V2)", + "githuburl":"" + }, + { + "uri":"as_06_0410.html", + "product_code":"as", + "code":"30", + "des":"This interface is used to immediately execute, enable, or disable a specified AS policy.An AS policy can be executed only when the AS group and AS policy are in the INSER", + "doc_type":"api", + "kw":"Executing, Enabling, or Disabling an AS Policy,AS Policies,API Reference", + "title":"Executing, Enabling, or Disabling an AS Policy", + "githuburl":"" + }, + { + "uri":"as_06_0411.html", + "product_code":"as", + "code":"31", + "des":"This interface is used to delete a specified AS policy.DELETE /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id}Request parametersNoneNoneExample request", + "doc_type":"api", + "kw":"Deleting an AS Policy,AS Policies,API Reference", + "title":"Deleting an AS Policy", + "githuburl":"" + }, + { + "uri":"as_06_0412.html", + "product_code":"as", + "code":"32", + "des":"This interface is used to enable, disable, or delete AS policies in batches.A batch operation can be performed on a maximum of 20 AS policies at a time.POST /autoscaling-", + "doc_type":"api", + "kw":"Performing Operations on AS Policies in Batches,AS Policies,API Reference", + "title":"Performing Operations on AS Policies in Batches", + "githuburl":"" + }, + { + "uri":"as_06_0500.html", + "product_code":"as", + "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":"AS Policy Execution Logs", + "title":"AS Policy Execution Logs", + "githuburl":"" + }, + { + "uri":"as_06_0501.html", + "product_code":"as", + "code":"34", + "des":"This API is used to query the historical records of AS policy execution based on search criteria. The results are displayed by page.Search criteria can be the log ID, AS ", + "doc_type":"api", + "kw":"Querying AS Policy Execution Logs,AS Policy Execution Logs,API Reference", + "title":"Querying AS Policy Execution Logs", + "githuburl":"" + }, + { + "uri":"as_06_0600.html", + "product_code":"as", + "code":"35", + "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":"Scaling Action Logs", + "title":"Scaling Action Logs", + "githuburl":"" + }, + { + "uri":"as_06_0601.html", + "product_code":"as", + "code":"36", + "des":"This API is used to query scaling action logs based on search criteria. The results are displayed by page.Search criteria can be the start time, end time, start line numb", + "doc_type":"api", + "kw":"Querying Scaling Action Logs,Scaling Action Logs,API Reference", + "title":"Querying Scaling Action Logs", + "githuburl":"" + }, + { + "uri":"as_06_0602.html", + "product_code":"as", + "code":"37", + "des":"This API is used to query scaling action logs based on search criteria. The scaling actions include increasing instances and migrating instances to balance load. The resu", + "doc_type":"api", + "kw":"Querying Scaling Action Logs (V2),Scaling Action Logs,API Reference", + "title":"Querying Scaling Action Logs (V2)", + "githuburl":"" + }, + { + "uri":"as_06_0700.html", + "product_code":"as", + "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":"Quotas", + "title":"Quotas", + "githuburl":"" + }, + { + "uri":"as_06_0701.html", + "product_code":"as", + "code":"39", + "des":"This API is used to query the total quotas and used quotas of AS groups, AS configurations, bandwidth scaling policies, AS policies, and instances for a specified tenant.", + "doc_type":"api", + "kw":"Querying AS Quotas,Quotas,API Reference", + "title":"Querying AS Quotas", + "githuburl":"" + }, + { + "uri":"as_06_0702.html", + "product_code":"as", + "code":"40", + "des":"This interface is used to query the total quotas and used quotas of AS policies and instances of a specified AS group by group ID.GET /autoscaling-api/v1/{project_id}/quo", + "doc_type":"api", + "kw":"Querying AS policy and instance quotas,Quotas,API Reference", + "title":"Querying AS policy and instance quotas", + "githuburl":"" + }, + { + "uri":"as_06_1000.html", + "product_code":"as", + "code":"41", + "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":"Tag Management", + "title":"Tag Management", + "githuburl":"" + }, + { + "uri":"as_06_1001.html", + "product_code":"as", + "code":"42", + "des":"This API is used to query tags by project ID.GET /autoscaling-api/v1/{project_id}/{resource_type}/tagsRequest parametersNoneNoneExample requestThis example shows how to q", + "doc_type":"api", + "kw":"Querying Tags,Tag Management,API Reference", + "title":"Querying Tags", + "githuburl":"" + }, + { + "uri":"as_06_1002.html", + "product_code":"as", + "code":"43", + "des":"This interface is used to query tags of a specified resource by project ID and resource ID.GET /autoscaling-api/v1/{project_id}/{resource_type}/{resource_id}/tagsRequest ", + "doc_type":"api", + "kw":"Querying Tags of a Resource,Tag Management,API Reference", + "title":"Querying Tags of a Resource", + "githuburl":"" + }, + { + "uri":"as_06_1003.html", + "product_code":"as", + "code":"44", + "des":"This API is used to create or delete a resource tag.Each AS group can have a maximum of 10 tags added to it.POST /autoscaling-api/v1/{project_id}/{resource_type}/{resourc", + "doc_type":"api", + "kw":"Creating or Deleting a Tag,Tag Management,API Reference", + "title":"Creating or Deleting a Tag", + "githuburl":"" + }, + { + "uri":"as_06_1004.html", + "product_code":"as", + "code":"45", + "des":"This API is used to query instances of a specified resource type by project ID.By default, resources and resource tags are in descending order of their creation time.POST", + "doc_type":"api", + "kw":"Querying Resources,Tag Management,API Reference", + "title":"Querying Resources", + "githuburl":"" + }, + { + "uri":"as_06_1100.html", + "product_code":"as", + "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":"API Management", + "title":"API Management", + "githuburl":"" + }, + { + "uri":"as_06_1101.html", + "product_code":"as", + "code":"47", + "des":"This interface is used to query all API versions of the AS service.GET /Request parametersNoneNoneExample requestThis example shows how to query all versions of an API.GE", + "doc_type":"api", + "kw":"Querying API Versions,API Management,API Reference", + "title":"Querying API Versions", + "githuburl":"" + }, + { + "uri":"as_06_1102.html", + "product_code":"as", + "code":"48", + "des":"This interface is used to query a specified API version of the AS service.GET /{api_version}Request parametersNoneNoneExample requestThis example shows how to query V1 AS", + "doc_type":"api", + "kw":"Querying a Specified API Version,API Management,API Reference", + "title":"Querying a Specified API Version", + "githuburl":"" + }, + { + "uri":"as_07_0200.html", + "product_code":"as", + "code":"49", + "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":"as_05_0202.html", + "product_code":"as", + "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":"AS Group,Permissions Policies and Supported Actions,API Reference", + "title":"AS Group", + "githuburl":"" + }, + { + "uri":"as_07_0203.html", + "product_code":"as", + "code":"51", + "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":"AS Configuration,Permissions Policies and Supported Actions,API Reference", + "title":"AS Configuration", + "githuburl":"" + }, + { + "uri":"as_07_0204.html", + "product_code":"as", + "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":"Instance,Permissions Policies and Supported Actions,API Reference", + "title":"Instance", + "githuburl":"" + }, + { + "uri":"as_07_0205.html", + "product_code":"as", + "code":"53", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"AS Policy,Permissions Policies and Supported Actions,API Reference", + "title":"AS Policy", + "githuburl":"" + }, + { + "uri":"as_07_0206.html", + "product_code":"as", + "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":"AS Policy Execution Log,Permissions Policies and Supported Actions,API Reference", + "title":"AS Policy Execution Log", + "githuburl":"" + }, + { + "uri":"as_07_0207.html", + "product_code":"as", + "code":"55", + "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":"Scaling Action Log,Permissions Policies and Supported Actions,API Reference", + "title":"Scaling Action Log", + "githuburl":"" + }, + { + "uri":"as_07_0208.html", + "product_code":"as", + "code":"56", + "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,Permissions Policies and Supported Actions,API Reference", + "title":"Quota", + "githuburl":"" + }, + { + "uri":"as_07_0211.html", + "product_code":"as", + "code":"57", + "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":"Tag Management,Permissions Policies and Supported Actions,API Reference", + "title":"Tag Management", + "githuburl":"" + }, + { + "uri":"as_07_0100.html", + "product_code":"as", + "code":"58", + "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":"as_07_0101.html", + "product_code":"as", + "code":"59", + "des":"This section describes metrics reported by AS to Cloud Eye as well as their namespaces and dimensions. You can use APIs provided by Cloud Eye to view the AS metrics and t", + "doc_type":"api", + "kw":"AS Metrics,Appendix,API Reference", + "title":"AS Metrics", + "githuburl":"" + }, + { + "uri":"as_07_0102.html", + "product_code":"as", + "code":"60", + "des":"This section provides the meanings of error codes returned by AS APIs.{\"error\":{\"code\":\"AS.0001\",\"message\":\"System error.\"}}", + "doc_type":"api", + "kw":"Error Codes,Appendix,API Reference", + "title":"Error Codes", + "githuburl":"" + }, + { + "uri":"record08.html", + "product_code":"as", + "code":"61", + "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/as/api-ref/CLASS.TXT.json b/docs/as/api-ref/CLASS.TXT.json new file mode 100644 index 000000000..7d2d9ff7a --- /dev/null +++ b/docs/as/api-ref/CLASS.TXT.json @@ -0,0 +1,551 @@ +[ + { + "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":"as", + "title":"API Usage Guidelines", + "uri":"en-us_topic_0045219159.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":"as", + "title":"API", + "uri":"as_06_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":"as", + "title":"AS Groups", + "uri":"as_06_0100.html", + "doc_type":"api", + "p_code":"2", + "code":"3" + }, + { + "desc":"An AS group consists of a collection of instances that apply to the same scenario. It is the basis for enabling or disabling AS policies and performing scaling actions. A", + "product_code":"as", + "title":"Creating an AS Group", + "uri":"as_06_0101.html", + "doc_type":"api", + "p_code":"3", + "code":"4" + }, + { + "desc":"This API is used to query AS groups based on search criteria. The results are displayed by page.Search criteria can be the AS group name, AS configuration ID, AS group st", + "product_code":"as", + "title":"Querying AS Groups", + "uri":"as_06_0102.html", + "doc_type":"api", + "p_code":"3", + "code":"5" + }, + { + "desc":"This API is used to query details about a specified AS group by group ID.GET /autoscaling-api/v1/{project_id}/scaling_group/{scaling_group_id}Request parametersNoneNoneEx", + "product_code":"as", + "title":"Querying AS Group Details", + "uri":"as_06_0103.html", + "doc_type":"api", + "p_code":"3", + "code":"6" + }, + { + "desc":"This API is used to modify a specified AS group.When the AS configuration of an AS group is changed, the existing instances created using the original AS configuration ar", + "product_code":"as", + "title":"Modifying an AS Group", + "uri":"as_06_0104.html", + "doc_type":"api", + "p_code":"3", + "code":"7" + }, + { + "desc":"This interface is used to delete a specified AS group.force_delete specifies whether to forcibly delete an AS group, remove the ECS instances and release them when the AS", + "product_code":"as", + "title":"Deleting an AS Group", + "uri":"as_06_0105.html", + "doc_type":"api", + "p_code":"3", + "code":"8" + }, + { + "desc":"This interface is used to enable or disable a specified AS group.For a disabled AS group, AS does not automatically trigger any scaling actions. When an AS group has an i", + "product_code":"as", + "title":"Enabling or Disabling an AS Group", + "uri":"as_06_0106.html", + "doc_type":"api", + "p_code":"3", + "code":"9" + }, + { + "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":"as", + "title":"AS Configurations", + "uri":"as_06_0200.html", + "doc_type":"api", + "p_code":"2", + "code":"10" + }, + { + "desc":"This API is used to create an AS configuration.An AS configuration is a template of ECSs in an AS group. It defines the specifications of the instances to be added to the", + "product_code":"as", + "title":"Creating an AS Configuration", + "uri":"as_06_0201.html", + "doc_type":"api", + "p_code":"10", + "code":"11" + }, + { + "desc":"This API is used to query AS configurations based on search criteria. The results are displayed by page.Search criteria can be the AS configuration name, image ID, start ", + "product_code":"as", + "title":"Querying AS Configurations", + "uri":"as_06_0202.html", + "doc_type":"api", + "p_code":"10", + "code":"12" + }, + { + "desc":"This interface is used to query details about an AS configuration by configuration ID.GET /autoscaling-api/v1/{project_id}/scaling_configuration/{scaling_configuration_id", + "product_code":"as", + "title":"Querying AS Configuration Details", + "uri":"as_06_0203.html", + "doc_type":"api", + "p_code":"10", + "code":"13" + }, + { + "desc":"This interface is used to delete a specified AS configuration.AS configurations used by AS groups cannot be deleted.DELETE /autoscaling-api/v1/{project_id}/scaling_config", + "product_code":"as", + "title":"Deleting an AS Configuration", + "uri":"as_06_0204.html", + "doc_type":"api", + "p_code":"10", + "code":"14" + }, + { + "desc":"This interface is used to batch delete AS configurations.AS configurations used by AS groups cannot be deleted.A maximum of 50 AS configurations can be deleted at a time.", + "product_code":"as", + "title":"Batch Deleting AS Configurations", + "uri":"as_06_0205.html", + "doc_type":"api", + "p_code":"10", + "code":"15" + }, + { + "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":"as", + "title":"Instances in an AS Group", + "uri":"as_06_0300.html", + "doc_type":"api", + "p_code":"2", + "code":"16" + }, + { + "desc":"This API is used to query instances in an AS group based on search criteria. The results are displayed by page.Search criteria can be the instance lifecycle status, insta", + "product_code":"as", + "title":"Querying Instances in an AS Group", + "uri":"as_06_0301.html", + "doc_type":"api", + "p_code":"16", + "code":"17" + }, + { + "desc":"This interface is used to remove a specified instance from an AS group.You can remove instances only in INSERVICE state and only when the number of instances after the re", + "product_code":"as", + "title":"Removing a Specified Instance from an AS Group", + "uri":"as_06_0302.html", + "doc_type":"api", + "p_code":"16", + "code":"18" + }, + { + "desc":"Add or remove instances to or from an AS group in batches.Configure instance protection or cancel the configuration for the instances in an AS group in batches.A batch op", + "product_code":"as", + "title":"Performing Operations on Instances in Batches", + "uri":"as_06_0303.html", + "doc_type":"api", + "p_code":"16", + "code":"19" + }, + { + "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":"as", + "title":"AS Policies", + "uri":"as_06_0400.html", + "doc_type":"api", + "p_code":"2", + "code":"20" + }, + { + "desc":"This API is used to create an AS policy.An AS policy defines whether to increase or decrease the number of instances in an AS group. If the number and the expected number", + "product_code":"as", + "title":"Creating an AS Policy", + "uri":"as_06_0401.html", + "doc_type":"api", + "p_code":"20", + "code":"21" + }, + { + "desc":"This API is used to create an AS policy for an AS group or bandwidth.The difference between the V2 and V1 APIs for creating an AS policy is that V2 supports creating an A", + "product_code":"as", + "title":"Creating an AS Policy (V2)", + "uri":"as_06_0402.html", + "doc_type":"api", + "p_code":"20", + "code":"22" + }, + { + "desc":"This API is used to modify a specified AS policy.PUT /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id}Request parametersRequest parametersParameterManda", + "product_code":"as", + "title":"Modifying an AS Policy", + "uri":"as_06_0403.html", + "doc_type":"api", + "p_code":"20", + "code":"23" + }, + { + "desc":"This API is used to modify a specified AS policy.The difference between the V2 and V1 APIs for modifying an AS policy is that V2 supports modifying a scaling resource typ", + "product_code":"as", + "title":"Modifying an AS Policy (V2)", + "uri":"as_06_0404.html", + "doc_type":"api", + "p_code":"20", + "code":"24" + }, + { + "desc":"This API is used to query AS policies based on search criteria. The results are displayed by page.Search criteria can be the AS policy name, policy type, policy ID, start", + "product_code":"as", + "title":"Querying AS Policies", + "uri":"as_06_0405.html", + "doc_type":"api", + "p_code":"20", + "code":"25" + }, + { + "desc":"This API is used to query AS policies based on search criteria. The results are displayed by page.The difference between the V2 and V1 APIs for querying AS policies is th", + "product_code":"as", + "title":"Querying AS Policies (V2)", + "uri":"as_06_0406.html", + "doc_type":"api", + "p_code":"20", + "code":"26" + }, + { + "desc":"This API is used to query all AS policies for a tenant based on search criteria. The results are displayed by page.Search criteria can be the AS resource ID, AS resource ", + "product_code":"as", + "title":"Querying All AS Policies (V2)", + "uri":"as_06_0407.html", + "doc_type":"api", + "p_code":"20", + "code":"27" + }, + { + "desc":"This API is used to query details about a specified AS policy by policy ID.GET /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id}Request parametersNoneNo", + "product_code":"as", + "title":"Querying AS Policy Details", + "uri":"as_06_0408.html", + "doc_type":"api", + "p_code":"20", + "code":"28" + }, + { + "desc":"This API is used to query details about a specified AS policy by policy ID.The difference between the V2 and V1 APIs for querying details of an AS policy is that V2 conta", + "product_code":"as", + "title":"Querying Details of an AS Policy (V2)", + "uri":"as_06_0409.html", + "doc_type":"api", + "p_code":"20", + "code":"29" + }, + { + "desc":"This interface is used to immediately execute, enable, or disable a specified AS policy.An AS policy can be executed only when the AS group and AS policy are in the INSER", + "product_code":"as", + "title":"Executing, Enabling, or Disabling an AS Policy", + "uri":"as_06_0410.html", + "doc_type":"api", + "p_code":"20", + "code":"30" + }, + { + "desc":"This interface is used to delete a specified AS policy.DELETE /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id}Request parametersNoneNoneExample request", + "product_code":"as", + "title":"Deleting an AS Policy", + "uri":"as_06_0411.html", + "doc_type":"api", + "p_code":"20", + "code":"31" + }, + { + "desc":"This interface is used to enable, disable, or delete AS policies in batches.A batch operation can be performed on a maximum of 20 AS policies at a time.POST /autoscaling-", + "product_code":"as", + "title":"Performing Operations on AS Policies in Batches", + "uri":"as_06_0412.html", + "doc_type":"api", + "p_code":"20", + "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":"as", + "title":"AS Policy Execution Logs", + "uri":"as_06_0500.html", + "doc_type":"api", + "p_code":"2", + "code":"33" + }, + { + "desc":"This API is used to query the historical records of AS policy execution based on search criteria. The results are displayed by page.Search criteria can be the log ID, AS ", + "product_code":"as", + "title":"Querying AS Policy Execution Logs", + "uri":"as_06_0501.html", + "doc_type":"api", + "p_code":"33", + "code":"34" + }, + { + "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":"as", + "title":"Scaling Action Logs", + "uri":"as_06_0600.html", + "doc_type":"api", + "p_code":"2", + "code":"35" + }, + { + "desc":"This API is used to query scaling action logs based on search criteria. The results are displayed by page.Search criteria can be the start time, end time, start line numb", + "product_code":"as", + "title":"Querying Scaling Action Logs", + "uri":"as_06_0601.html", + "doc_type":"api", + "p_code":"35", + "code":"36" + }, + { + "desc":"This API is used to query scaling action logs based on search criteria. The scaling actions include increasing instances and migrating instances to balance load. The resu", + "product_code":"as", + "title":"Querying Scaling Action Logs (V2)", + "uri":"as_06_0602.html", + "doc_type":"api", + "p_code":"35", + "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":"as", + "title":"Quotas", + "uri":"as_06_0700.html", + "doc_type":"api", + "p_code":"2", + "code":"38" + }, + { + "desc":"This API is used to query the total quotas and used quotas of AS groups, AS configurations, bandwidth scaling policies, AS policies, and instances for a specified tenant.", + "product_code":"as", + "title":"Querying AS Quotas", + "uri":"as_06_0701.html", + "doc_type":"api", + "p_code":"38", + "code":"39" + }, + { + "desc":"This interface is used to query the total quotas and used quotas of AS policies and instances of a specified AS group by group ID.GET /autoscaling-api/v1/{project_id}/quo", + "product_code":"as", + "title":"Querying AS policy and instance quotas", + "uri":"as_06_0702.html", + "doc_type":"api", + "p_code":"38", + "code":"40" + }, + { + "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":"as", + "title":"Tag Management", + "uri":"as_06_1000.html", + "doc_type":"api", + "p_code":"2", + "code":"41" + }, + { + "desc":"This API is used to query tags by project ID.GET /autoscaling-api/v1/{project_id}/{resource_type}/tagsRequest parametersNoneNoneExample requestThis example shows how to q", + "product_code":"as", + "title":"Querying Tags", + "uri":"as_06_1001.html", + "doc_type":"api", + "p_code":"41", + "code":"42" + }, + { + "desc":"This interface is used to query tags of a specified resource by project ID and resource ID.GET /autoscaling-api/v1/{project_id}/{resource_type}/{resource_id}/tagsRequest ", + "product_code":"as", + "title":"Querying Tags of a Resource", + "uri":"as_06_1002.html", + "doc_type":"api", + "p_code":"41", + "code":"43" + }, + { + "desc":"This API is used to create or delete a resource tag.Each AS group can have a maximum of 10 tags added to it.POST /autoscaling-api/v1/{project_id}/{resource_type}/{resourc", + "product_code":"as", + "title":"Creating or Deleting a Tag", + "uri":"as_06_1003.html", + "doc_type":"api", + "p_code":"41", + "code":"44" + }, + { + "desc":"This API is used to query instances of a specified resource type by project ID.By default, resources and resource tags are in descending order of their creation time.POST", + "product_code":"as", + "title":"Querying Resources", + "uri":"as_06_1004.html", + "doc_type":"api", + "p_code":"41", + "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":"as", + "title":"API Management", + "uri":"as_06_1100.html", + "doc_type":"api", + "p_code":"2", + "code":"46" + }, + { + "desc":"This interface is used to query all API versions of the AS service.GET /Request parametersNoneNoneExample requestThis example shows how to query all versions of an API.GE", + "product_code":"as", + "title":"Querying API Versions", + "uri":"as_06_1101.html", + "doc_type":"api", + "p_code":"46", + "code":"47" + }, + { + "desc":"This interface is used to query a specified API version of the AS service.GET /{api_version}Request parametersNoneNoneExample requestThis example shows how to query V1 AS", + "product_code":"as", + "title":"Querying a Specified API Version", + "uri":"as_06_1102.html", + "doc_type":"api", + "p_code":"46", + "code":"48" + }, + { + "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":"as", + "title":"Permissions Policies and Supported Actions", + "uri":"as_07_0200.html", + "doc_type":"api", + "p_code":"", + "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":"as", + "title":"AS Group", + "uri":"as_05_0202.html", + "doc_type":"api", + "p_code":"49", + "code":"50" + }, + { + "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":"as", + "title":"AS Configuration", + "uri":"as_07_0203.html", + "doc_type":"api", + "p_code":"49", + "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":"as", + "title":"Instance", + "uri":"as_07_0204.html", + "doc_type":"api", + "p_code":"49", + "code":"52" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"as", + "title":"AS Policy", + "uri":"as_07_0205.html", + "doc_type":"api", + "p_code":"49", + "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":"as", + "title":"AS Policy Execution Log", + "uri":"as_07_0206.html", + "doc_type":"api", + "p_code":"49", + "code":"54" + }, + { + "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":"as", + "title":"Scaling Action Log", + "uri":"as_07_0207.html", + "doc_type":"api", + "p_code":"49", + "code":"55" + }, + { + "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":"as", + "title":"Quota", + "uri":"as_07_0208.html", + "doc_type":"api", + "p_code":"49", + "code":"56" + }, + { + "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":"as", + "title":"Tag Management", + "uri":"as_07_0211.html", + "doc_type":"api", + "p_code":"49", + "code":"57" + }, + { + "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":"as", + "title":"Appendix", + "uri":"as_07_0100.html", + "doc_type":"api", + "p_code":"", + "code":"58" + }, + { + "desc":"This section describes metrics reported by AS to Cloud Eye as well as their namespaces and dimensions. You can use APIs provided by Cloud Eye to view the AS metrics and t", + "product_code":"as", + "title":"AS Metrics", + "uri":"as_07_0101.html", + "doc_type":"api", + "p_code":"58", + "code":"59" + }, + { + "desc":"This section provides the meanings of error codes returned by AS APIs.{\"error\":{\"code\":\"AS.0001\",\"message\":\"System error.\"}}", + "product_code":"as", + "title":"Error Codes", + "uri":"as_07_0102.html", + "doc_type":"api", + "p_code":"58", + "code":"60" + }, + { + "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":"as", + "title":"Change History", + "uri":"record08.html", + "doc_type":"api", + "p_code":"", + "code":"61" + } +] \ No newline at end of file diff --git a/docs/as/api-ref/PARAMETERS.txt b/docs/as/api-ref/PARAMETERS.txt new file mode 100644 index 000000000..6da8d5f07 --- /dev/null +++ b/docs/as/api-ref/PARAMETERS.txt @@ -0,0 +1,3 @@ +version="" +language="en-us" +type="" \ No newline at end of file diff --git a/docs/as/api-ref/as_05_0202.html b/docs/as/api-ref/as_05_0202.html new file mode 100644 index 000000000..a6b9aa6cf --- /dev/null +++ b/docs/as/api-ref/as_05_0202.html @@ -0,0 +1,94 @@ + + +
Permission + |
+APIs + |
+Actions + |
+IAM Project ++ |
+Enterprise Project ++ |
+
|---|---|---|---|---|
Creating an AS group + |
+POST /autoscaling-api/v1/{project_id}/scaling_group + |
+as:groups:create + |
+√ + |
+√ + |
+
Querying AS groups + |
+GET /autoscaling-api/v1/{project_id}/scaling_group + |
+as:groups:list + |
+√ + |
+√ + |
+
Querying AS group details + |
+GET /autoscaling-api/v1/{project_id}/scaling_group/{scaling_group_id} + |
+as:groups:get + |
+√ + |
+√ + |
+
Modifying an AS group + |
+PUT /autoscaling-api/v1/{project_id}/scaling_group/{scaling_group_id} + |
+as:groups:update + |
+√ + |
+√ + |
+
Deleting an AS group + |
+DELETE /autoscaling-api/v1/{project_id}/scaling_group/{scaling_group_id} + |
+as:groups:delete + |
+√ + |
+√ + |
+
Enabling or disabling an AS group + |
+POST /autoscaling-api/v1/{project_id}/scaling_group/{scaling_group_id}/action + |
+as:groups:action + |
+√ + |
+√ + |
+
An AS group consists of a collection of instances that apply to the same scenario. It is the basis for enabling or disabling AS policies and performing scaling actions. An AS group specifies parameters, such as the maximum number of instances, expected number of instances, minimum number of instances, VPC, subnet, and load balancing.
+POST /autoscaling-api/v1/{project_id}/scaling_group
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
scaling_group_name + |
+Yes + |
+String + |
+Specifies the AS group name. The name contains only letters, digits, underscores (_), and hyphens (-), and cannot exceed 64 characters. + |
+
scaling_configuration_id + |
+No + |
+String + |
+Specifies the AS configuration ID, which can be obtained using the API for querying AS configurations. For details, see Querying AS Configurations. + |
+
desire_instance_number + |
+No + |
+Integer + |
+Specifies the expected number of instances. The default value is the minimum number of instances. +The value ranges from the minimum number of instances to the maximum number of instances. + |
+
min_instance_number + |
+No + |
+Integer + |
+Specifies the minimum number of instances. The default value is 0. + |
+
max_instance_number + |
+No + |
+Integer + |
+Specifies the maximum number of instances. The default value is 0. + |
+
cool_down_time + |
+No + |
+Integer + |
+Specifies the cooldown period (in seconds). The value ranges from 0 to 86400 and is 300 by default. +After a scaling action is triggered, the system starts the cooldown period. During the cooldown period, scaling actions triggered by alarms will be denied. Scheduled, periodic, and manual scaling actions are not affected. + |
+
lb_listener_id + |
+No + |
+String + |
+Specifies the ID of a classic load balancer listener. The system supports the binding of up to six load balancer listeners, the IDs of which are separated using a comma (,). +This parameter is alternative to lbaas_listeners. + |
+
lbaas_listeners + |
+No + |
+Array of lbaas_listeners objects + |
+Specifies information about an enhanced load balancer. The system supports the binding of up to six load balancers. This parameter is in list data structure. For details, see Table 3. +This parameter is alternative to lb_listener_id. + |
+
available_zones + |
+No + |
+Array of strings + |
+Specifies the AZ information. The instances added in a scaling action will be created in a specified AZ. If you do not specify an AZ, the system automatically specifies one. For details, see Availability Zone. + |
+
networks + |
+Yes + |
+Array of networks objects + |
+Specifies network information. The system supports up to five subnets. The first subnet transferred serves as the primary NIC of the ECS by default. This parameter is in data structure. For details, see Table 4. + |
+
security_groups + |
+No + |
+Array of security_groups objects + |
+Specifies the security group information. A maximum of one security group can be selected. This parameter is in data structure. For details, see Table 5. +If the security group is specified both in the AS configuration and AS group, scaled ECS instances will be added to the security group specified in the AS configuration. If the security group is not specified in either of them, scaled ECS instances will be added to the default security group. For your convenience, you are advised to specify the security group in the AS configuration. + |
+
vpc_id + |
+Yes + |
+String + |
+Specifies the VPC ID, which can be obtained using the API for querying VPCs. For details, see "Querying VPCs" in Virtual Private Network API Reference. + |
+
health_periodic_audit_method + |
+No + |
+String + |
+Specifies the health check method for instances in the AS group. The health check methods include ELB_AUDIT and NOVA_AUDIT. When load balancing is configured for an AS group, the default value is ELB_AUDIT. Otherwise, the default value is NOVA_AUDIT. +
|
+
health_periodic_audit_time + |
+No + |
+Integer + |
+Specifies the instance health check period. The value can be 1, 5, 15, 60, or 180 in the unit of minutes. If this parameter is not specified, the default value is 5. +If the value is set to 0, health check is performed every 10 seconds. + |
+
health_periodic_audit_grace_period + |
+No + |
+Integer + |
+Specifies the grace period for instance health check. The unit is second and value range is 0-86400. The default value is 600. +The health check grace period starts after an instance is added to an AS group and is enabled. The AS group will start checking the instance status only after the grace period ends. +This parameter is valid only when the instance health check method of the AS group is ELB_AUDIT. + |
+
instance_terminate_policy + |
+No + |
+String + |
+Specifies the instance removal policy. +
|
+
notifications + |
+No + |
+Array of strings + |
+Specifies the notification mode. +EMAIL refers to notification by email. + |
+
delete_publicip + |
+No + |
+Boolean + |
+Specifies whether to delete the EIP bound to the ECS when deleting the ECS. The value can be true or false. The default value is false.
+
|
+
delete_volume + |
+No + |
+Boolean + |
+Specifies whether to delete the data disks attached to the ECS when deleting the ECS. The value can be true or false. The default value is false.
+
|
+
enterprise_project_id + |
+No + |
+String + |
+Specifies the enterprise project ID, which is used to specify the enterprise project to which the AS group belongs. +
If an enterprise project is configured for an AS group, ECSs created in this AS group also belong to this enterprise project. Otherwise, the default enterprise project will be used. + |
+
multi_az_priority_policy + |
+No + |
+String + |
+Specifies the priority policy used to select target AZs when adjusting the number of instances in an AS group. +
|
+
description + |
+No + |
+String + |
+Specifies the description of the AS group. The value can contain 1 to 256 characters. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
pool_id + |
+Yes + |
+String + |
+Specifies the backend ECS group ID. + |
+
protocol_port + |
+Yes + |
+Integer + |
+Specifies the backend protocol ID, which is the port on which a backend ECS listens for traffic. The port ID ranges from 1 to 65535. + |
+
weight + |
+Yes + |
+Integer + |
+Specifies the weight, which determines the portion of requests a backend ECS processes when being compared to other backend ECSs added to the same listener. The value of this parameter ranges from 0 to 100. + |
+
The following example shows how to create an AS group:
+The request example is as follows:
+POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group
+
+{
+ "scaling_group_name": "GroupNameTest",
+ "scaling_configuration_id": "47683a91-93ee-462a-a7d7-484c006f4440",
+ "desire_instance_number": 0,
+ "min_instance_number": 0,
+ "max_instance_number": 10,
+ "health_periodic_audit_method": "NOVA_AUDIT",
+ "vpc_id": "a8327883-6b07-4497-9c61-68d03ee193a",
+ "available_zones": ["XXXa","XXXb"],
+ "networks": [
+ {
+ "id": "3cd35bca-5a10-416f-8994-f79169559870"
+ }
+ ],
+ "enterprise_project_id": "c92b1a5d-6f20-43f2-b1b7-7ce35e58e413",
+
+ "multi_az_priority_policy": "PICK_FIRST"
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_group_id + |
+String + |
+Specifies the AS group ID. + |
+
{
+ "scaling_group_id": "a8327883-6b07-4497-9c61-68d03ee193a1"
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query AS groups based on search criteria. The results are displayed by page.
+GET /autoscaling-api/v1/{project_id}/scaling_group
+
You can type the question mark (?) and ampersand (&) at the end of the URI to define multiple search criteria. AS groups can be searched by all optional parameters in the following table. For details, see the example request.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_group_name + |
+No + |
+String + |
+Specifies the AS group name. +Supports fuzzy search. + |
+
scaling_configuration_id + |
+No + |
+String + |
+Specifies the AS configuration ID, which can be obtained using the API for querying AS configurations. For details, see Querying AS Configurations. + |
+
scaling_group_status + |
+No + |
+String + |
+Specifies the AS group status. The options are as follows: +
|
+
start_number + |
+No + |
+Integer + |
+Specifies the start line number. The default value is 0. The minimum value is 0, and there is no limit on the maximum value. + |
+
limit + |
+No + |
+Integer + |
+Specifies the number of query records. The default value is 20. The value range is 0 to 100. + |
+
enterprise_project_id + |
+No + |
+String + |
+Specifies the enterprise project ID. If all_granted_eps is transferred, this API will query AS groups in the enterprise projects that you have permissions to. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
total_number + |
+Integer + |
+Specifies the total number of query records. + |
+
start_number + |
+Integer + |
+Specifies the start number of query records. + |
+
limit + |
+Integer + |
+Specifies the number of query records. + |
+
scaling_groups + |
+Array of scaling_groups objects + |
+Specifies the scaling group list. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_group_name + |
+String + |
+Specifies the name of the AS group. + |
+
scaling_group_id + |
+String + |
+Specifies the AS group ID. + |
+
scaling_group_status + |
+String + |
+Specifies the status of the AS group. + |
+
scaling_configuration_id + |
+String + |
+Specifies the AS configuration ID. + |
+
scaling_configuration_name + |
+String + |
+Specifies the AS configuration name. + |
+
current_instance_number + |
+Integer + |
+Specifies the number of current instances in the AS group. + |
+
desire_instance_number + |
+Integer + |
+Specifies the expected number of instances in the AS group. + |
+
min_instance_number + |
+Integer + |
+Specifies the minimum number of instances in the AS group. + |
+
max_instance_number + |
+Integer + |
+Specifies the maximum number of instances in the AS group. + |
+
cool_down_time + |
+Integer + |
+Specifies the cooldown period (s). + |
+
lb_listener_id + |
+String + |
+Specifies the ID of a typical ELB listener. ELB listener IDs are separated using a comma (,). + |
+
lbaas_listeners + |
+Array of lbaas_listeners objects + |
+Specifies enhanced load balancers. For details, see Table 4. + |
+
available_zones + |
+Array of strings + |
+Specifies the AZ information. + |
+
networks + |
+Array of networks objects + |
+Specifies the network information. For details, see Table 5. + |
+
security_groups + |
+Array of security_groups objects + |
+Specifies the security group information. For details, see Table 6. + |
+
create_time + |
+String + |
+Specifies the time when an AS group was created. The time format complies with UTC. + |
+
vpc_id + |
+String + |
+Specifies the ID of the VPC to which the AS group belongs. + |
+
detail + |
+String + |
+Specifies details about the AS group. If a scaling action fails, this parameter is used to record errors. + |
+
is_scaling + |
+Boolean + |
+Specifies the scaling flag of the AS group. + |
+
health_periodic_audit_method + |
+String + |
+Specifies the health check method. + |
+
health_periodic_audit_time + |
+Integer + |
+Specifies the health check interval. + |
+
health_periodic_audit_grace_period + |
+Integer + |
+Specifies the grace period for health check. + |
+
instance_terminate_policy + |
+String + |
+Specifies the instance removal policy. + |
+
notifications + |
+Array of strings + |
+Specifies the notification mode. +EMAIL refers to notification by email. + |
+
delete_publicip + |
+Boolean + |
+Specifies whether to delete the EIP bound to the ECS when deleting the ECS. + |
+
delete_volume + |
+Boolean + |
+Specifies whether to delete the data disks attached to the ECS when deleting the ECS. + |
+
cloud_location_id + |
+String + |
+This parameter is reserved. + |
+
enterprise_project_id + |
+String + |
+Specifies the enterprise project ID. + |
+
activity_type + |
+String + |
+Specifies the type of the AS action. + |
+
multi_az_priority_policy + |
+String + |
+Specifies the priority policy used to select target AZs when adjusting the number of instances in an AS group. + |
+
description + |
+String + |
+Specifies the description of the AS group. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
listener_id + |
+String + |
+Specifies the listener ID. + |
+
pool_id + |
+String + |
+Specifies the backend ECS group ID. + |
+
protocol_port + |
+Integer + |
+Specifies the backend protocol ID, which is the port on which a backend ECS listens for traffic. + |
+
weight + |
+Integer + |
+Specifies the weight, which determines the portion of requests a backend ECS processes when being compared to other backend ECSs added to the same listener. + |
+
{
+ "limit": 20,
+ "scaling_groups": [
+ {
+ "networks": [
+ {
+ "id": "a8327883-6b07-4497-9c61-68d03ee193a",
+ "ipv6_enable": false,
+ "ipv6_bandwidth": null,
+ }
+ ],
+ "available_zones": [
+ "XXXa",
+ "XXXb"
+ ],
+ "detail": null,
+ "scaling_group_name": "as-group-test",
+ "scaling_group_id": "77a7a397-7d2f-4e79-9da9-6a35e2709150",
+ "scaling_group_status": "INSERVICE",
+ "scaling_configuration_id": "1d281494-6085-4579-b817-c1f813be835f",
+ "scaling_configuration_name": "healthCheck",
+ "current_instance_number": 0,
+ "desire_instance_number": 1,
+ "min_instance_number": 0,
+ "max_instance_number": 500,
+ "cool_down_time": 300,
+ "lb_listener_id": "f06c0112570743b51c0e8fbe1f235bab",
+ "security_groups": [
+ {
+ "id": "8a4b1d5b-0054-419f-84b1-5c8a59ebc829"
+ }
+ ],
+ "create_time": "2015-07-23T02:46:29Z",
+ "vpc_id": "863ccae2-ee85-4d27-bc5b-3ba2a198a9e2",
+ "health_periodic_audit_method": "ELB_AUDIT",
+ "health_periodic_audit_time": 5,
+ "health_periodic_audit_grace_period": 600,
+ "instance_terminate_policy": "OLD_CONFIG_OLD_INSTANCE",
+ "is_scaling": false,
+ "delete_publicip": false,
+ "notifications": [
+ "EMAIL"
+ ]
+ "enterprise_project_id": "c92b1a5d-6f20-43f2-b1b7-7ce35e58e413",
+ "multi_az_priority_policy": "PICK_FIRST"
+ }
+ ],
+ "total_number": 1,
+ "start_number": 0
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query details about a specified AS group by group ID.
+GET /autoscaling-api/v1/{project_id}/scaling_group/{scaling_group_id}
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_group_id + |
+Yes + |
+String + |
+Specifies the AS group ID. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_group + |
+scaling_groups object + |
+Specifies details about the AS group. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_group_name + |
+String + |
+Specifies the name of the AS group. + |
+
scaling_group_id + |
+String + |
+Specifies the AS group ID. + |
+
scaling_group_status + |
+String + |
+Specifies the status of the AS group. + |
+
scaling_configuration_id + |
+String + |
+Specifies the AS configuration ID. + |
+
scaling_configuration_name + |
+String + |
+Specifies the AS configuration name. + |
+
current_instance_number + |
+Integer + |
+Specifies the number of current instances in the AS group. + |
+
desire_instance_number + |
+Integer + |
+Specifies the expected number of instances in the AS group. + |
+
min_instance_number + |
+Integer + |
+Specifies the minimum number of instances in the AS group. + |
+
max_instance_number + |
+Integer + |
+Specifies the maximum number of instances in the AS group. + |
+
cool_down_time + |
+Integer + |
+Specifies the cooldown period (s). + |
+
lb_listener_id + |
+String + |
+Specifies the ID of a typical ELB listener. ELB listener IDs are separated using a comma (,). + |
+
lbaas_listeners + |
+Array of lbaas_listeners objects + |
+Specifies enhanced load balancers. For details, see Table 4. + |
+
available_zones + |
+Array of strings + |
+Specifies the AZ information. + |
+
networks + |
+Array of networks objects + |
+Specifies the network information. For details, see Table 5. + |
+
security_groups + |
+Array of security_groups objects + |
+Specifies the security group information. For details, see Table 6. + |
+
create_time + |
+String + |
+Specifies the time when an AS group was created. The time format complies with UTC. + |
+
vpc_id + |
+String + |
+Specifies the ID of the VPC to which the AS group belongs. + |
+
detail + |
+String + |
+Specifies details about the AS group. If a scaling action fails, this parameter is used to record errors. + |
+
is_scaling + |
+Boolean + |
+Specifies the scaling flag of the AS group. + |
+
health_periodic_audit_method + |
+String + |
+Specifies the health check method. + |
+
health_periodic_audit_time + |
+Integer + |
+Specifies the health check interval. + |
+
health_periodic_audit_grace_period + |
+Integer + |
+Specifies the grace period for health check. + |
+
instance_terminate_policy + |
+String + |
+Specifies the instance removal policy. + |
+
notifications + |
+Array of strings + |
+Specifies the notification mode. +EMAIL refers to notification by email. + |
+
delete_publicip + |
+Boolean + |
+Specifies whether to delete the EIP bound to the ECS when deleting the ECS. + |
+
delete_volume + |
+Boolean + |
+Specifies whether to delete the data disks attached to the ECS when deleting the ECS. + |
+
cloud_location_id + |
+String + |
+This parameter is reserved. + |
+
enterprise_project_id + |
+String + |
+Specifies the enterprise project ID. + |
+
activity_type + |
+String + |
+Specifies the type of the AS action. + |
+
multi_az_priority_policy + |
+String + |
+Specifies the priority policy used to select target AZs when adjusting the number of instances in an AS group. + |
+
description + |
+String + |
+Specifies the description of the AS group. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
listener_id + |
+String + |
+Specifies the listener ID. + |
+
pool_id + |
+String + |
+Specifies the backend ECS group ID. + |
+
protocol_port + |
+Integer + |
+Specifies the backend protocol ID, which is the port on which a backend ECS listens for traffic. + |
+
weight + |
+Integer + |
+Specifies the weight, which determines the portion of requests a backend ECS processes when being compared to other backend ECSs added to the same listener. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the subnet ID. + |
+
{
+ "scaling_group": {
+ "networks": [
+ {
+ "id": " a8327883-6b07-4497-9c61-68d03ee193a ",
+ "ipv6_enable": false,
+ "ipv6_bandwidth": null,
+ }
+ ],
+ "available_zones": [
+ "XXXa",
+ "XXXb"
+ ],
+ "detail": null,
+ "scaling_group_name": "api_gateway_modify",
+ "scaling_group_id": "d4e50321-3777-4135-97f8-9f5e9714a4b0",
+ "scaling_group_status": "INSERVICE",
+ "scaling_configuration_id": "53579851-3841-418d-a97b-9cecdb663a90",
+ "scaling_configuration_name": "press",
+ "current_instance_number": 7,
+ "desire_instance_number": 8,
+ "min_instance_number": 0,
+ "max_instance_number": 100,
+ "cool_down_time": 900,
+ "lb_listener_id": null,
+ "security_groups": [
+ {
+ "id": "23b7b999-0a30-4b48-ae8f-ee201a88a6ab"
+ }
+ ],
+ "create_time": "2015-09-01T08:36:10Z",
+ "vpc_id": "3e22f934-800d-4bb4-a588-0b9a76108190",
+ "health_periodic_audit_method": "NOVA_AUDIT",
+ "health_periodic_audit_time": 5,
+ "health_periodic_audit_grace_period": 600,
+ "instance_terminate_policy": "OLD_CONFIG_OLD_INSTANCE",
+ "is_scaling": true,
+ "delete_publicip": false,
+ "notifications": null,
+ "enterprise_project_id": "c92b1a5d-6f20-43f2-b1b7-7ce35e58e413",
+ "activity_type": "MODIFY_ELB",
+ "multi_az_priority_policy": "PICK_FIRST"
+ }
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to modify a specified AS group.
+PUT /autoscaling-api/v1/{project_id}/scaling_group/{scaling_group_id}
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_group_id + |
+Yes + |
+String + |
+Specifies the AS group ID. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
scaling_group_name + |
+No + |
+String + |
+Specifies the AS group name. The name contains only letters, digits, underscores (_), and hyphens (-), and cannot exceed 64 characters. + |
+
desire_instance_number + |
+No + |
+Integer + |
+Specifies the expected number of instances. +The value ranges from the minimum number of instances to the maximum number of instances. + |
+
min_instance_number + |
+No + |
+Integer + |
+Specifies the minimum number of instances. + |
+
max_instance_number + |
+No + |
+Integer + |
+Specifies the maximum number of instances, which is greater than or equal to the minimum number of instances. + |
+
cool_down_time + |
+No + |
+Integer + |
+Specifies the cooldown period (in seconds). The value ranges from 0 to 86400 and is 300 by default. + |
+
available_zones + |
+No + |
+Array of strings + |
+Specifies the AZ information. The instances added in a scaling action will be created in a specified AZ. If you do not specify an AZ, the system automatically specifies one. +For details, see Availability Zone. +You can change the AZ of an AS group only when no scaling action is being performed in the group. + |
+
networks + |
+No + |
+Array of networks objects + |
+Specifies network information. The system supports up to five subnets. The first subnet transferred serves as the primary NIC of the ECS by default. This parameter is in data structure. For details, see Table 4. +The value of this parameter can be changed only when all the following conditions are met: +
|
+
security_groups + |
+No + |
+Array of security_groups objects + |
+Specifies the security group. A maximum of one security group can be selected. This parameter is in data structure. For details, see Table 5. +If the security group is specified both in the AS configuration and AS group, scaled ECS instances will be added to the security group specified in the AS configuration. If the security group is not specified in either of them, scaled ECS instances will be added to the default security group. For your convenience, you are advised to specify the security group in the AS configuration. The value of this parameter can be changed only when all the following conditions are met: +
|
+
lb_listener_id + |
+No + |
+String + |
+Specifies the ID of a classic load balancer listener. The system supports the binding of up to six load balancer listeners, the IDs of which are separated using a comma (,). +The value of this parameter can be changed only when all the following conditions are met: +
|
+
lbaas_listeners + |
+No + |
+Array of lbaas_listeners objects + |
+Specifies information about an enhanced load balancer. The system supports the binding of up to six load balancers. This parameter is in list data structure. For details, see Table 3. +This parameter is alternative to lb_listener_id. + |
+
health_periodic_audit_method + |
+No + |
+String + |
+Specifies the health check method for instances in the AS group. The health check methods include ELB_AUDIT and NOVA_AUDIT. When load balancing is configured for an AS group, the default value is ELB_AUDIT. Otherwise, the default value is NOVA_AUDIT. +
|
+
health_periodic_audit_time + |
+No + |
+Integer + |
+Specifies the health check period for the instances in the AS group. The value can be 1, 5, 15, 60, or 180 in the unit of minutes. +If the value is set to 0, health check is performed every 10 seconds. + |
+
instance_terminate_policy + |
+No + |
+String + |
+Specifies the instance removal policy. +
|
+
health_periodic_audit_grace_period + |
+No + |
+Integer + |
+Specifies the grace period for instance health check. The unit is second and value range is 0-86400. The default value is 600. +The health check grace period starts after an instance is added to an AS group and is enabled. The AS group will start checking the instance status only after the grace period ends. +This parameter is valid only when the instance health check method of the AS group is ELB_AUDIT. + |
+
scaling_configuration_id + |
+No + |
+String + |
+Specifies the AS configuration ID, which can be obtained using the API for querying AS configurations. For details, see Querying AS Configurations. + |
+
notifications + |
+No + |
+Array of strings + |
+Specifies the notification mode. +EMAIL refers to notification by email. + |
+
delete_publicip + |
+No + |
+Boolean + |
+Specifies whether to delete the EIP bound to the ECS when deleting the ECS. If you do not want to delete the EIP, set this parameter to false. Then, the system only unbinds the EIP from the ECS and reserves the EIP. +
|
+
delete_volume + |
+No + |
+Boolean + |
+Specifies whether to delete the data disks attached to the ECS when deleting the ECS. The value can be true or false. The default value is false. +
|
+
enterprise_project_id + |
+No + |
+String + |
+Specifies the enterprise project ID, which is used to specify the enterprise project to which the AS group belongs. +
If an enterprise project is configured for an AS group, ECSs created in this AS group also belong to this enterprise project. Otherwise, the default enterprise project will be used. + |
+
multi_az_priority_policy + |
+No + |
+String + |
+Specifies the priority policy used to select target AZs when adjusting the number of instances in an AS group. +
|
+
description + |
+No + |
+String + |
+Specifies the description of the AS group. The value can contain 1 to 256 characters. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
pool_id + |
+Yes + |
+String + |
+Specifies the backend ECS group ID. +The value of this parameter can be changed only when all the following conditions are met: +
|
+
protocol_port + |
+Yes + |
+Integer + |
+Specifies the backend protocol ID, which is the port on which a backend ECS listens for traffic. The port ID ranges from 1 to 65535. + |
+
weight + |
+Yes + |
+Integer + |
+Specifies the weight, which determines the portion of requests a backend ECS processes when being compared to other backend ECSs added to the same listener. The value of this parameter ranges from 0 to 100. + |
+
PUT https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group/a8327883-6b07-4497-9c61-68d03ee193a1
+
+{
+ "scaling_group_name": "group_1",
+ "scaling_configuration_id": "f8327883-6a07-4497-9a61-68c03e8e72a2",
+ "enterprise_project_id": "c92b1a5d-6f20-43f2-b1b7-7ce35e58e413",
+ "desire_instance_number": 1,
+ "min_instance_number": 1,
+ "max_instance_number": 3,
+ "cool_down_time": 200,
+ "multi_az_priority_policy": "PICK_FIRST"
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_group_id + |
+String + |
+Specifies the AS group ID. + |
+
{
+ "scaling_group_id": "a8327883-6b07-4497-9c61-68d03ee193a1"
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This interface is used to delete a specified AS group.
+DELETE /autoscaling-api/v1/{project_id}/scaling_group/{scaling_group_id}?force_delete=no
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_group_id + |
+Yes + |
+String + |
+Specifies the AS group ID. + |
+
force_delete + |
+No + |
+String + |
+Specifies whether to forcibly delete an AS group. Options: +
|
+
Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This interface is used to enable or disable a specified AS group.
+
For a disabled AS group, AS does not automatically trigger any scaling actions. When an AS group has an in-progress scaling action, the scaling action does not stop immediately after the AS group is disabled.
+POST /autoscaling-api/v1/{project_id}/scaling_group/{scaling_group_id}/action
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_group_id + |
+Yes + |
+String + |
+Specifies the AS group ID. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
action + |
+Yes + |
+String + |
+Specifies a flag for enabling or disabling an AS group. +
|
+
Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to create an AS configuration.
+POST /autoscaling-api/v1/{project_id}/scaling_configuration
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
scaling_configuration_name + |
+Yes + |
+String + |
+Specifies the AS configuration name. The name contains only letters, digits, underscores (_), and hyphens (-), and cannot exceed 64 characters. + |
+
instance_config + |
+Yes + |
+Object + |
+Specifies the ECS configuration. For details, see Table 3. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
instance_id + |
+No + |
+String + |
+Specifies the ECS ID. When using the existing ECS specifications as the template to create AS configurations, specify this parameter. In this case, the flavorRef, imageRef, disk, and security_groups fields do not take effect. +If the instance_id field is not specified, flavorRef, imageRef, and disk fields are mandatory. + |
+
flavorRef + |
+No + |
+String + |
+Specifies the ECS flavor ID. A maximum of 10 flavors can be selected. Use a comma (,) to separate multiple flavor IDs. You can obtain its value from the API for querying details about flavors and extended flavor information. + |
+
imageRef + |
+No + |
+String + |
+Specifies the image ID. Its value is the same as that of image_id for specifying the image selected during ECS creation. Obtain the value using the API for querying images. . + |
+
disk + |
+No + |
+Array of disk objects + |
+Specifies the disk group information. System disks are mandatory and data disks are optional. For details, see Table 4. + |
+
key_name + |
+Yes + |
+String + |
+Specifies the name of the SSH key pair used to log in to the ECS. + |
+
personality + |
+No + |
+Array of personality objects + |
+Specifies information about the injected file. Only text files can be injected. A maximum of five files can be injected at a time and the maximum size of each file is 1 KB. For details, see Table 6. + |
+
public_ip + |
+No + |
+public_ip object + |
+Specifies the EIP of the ECS. The EIP can be configured in two ways. For details, see Table 7. +
|
+
user_data + |
+No + |
+String + |
+Specifies the user data to be injected during the ECS creation process. Text, text files, and gzip files can be injected. +Constraints: +
Examples: +
|
+
metadata + |
+No + |
+metadata object + |
+Specifies the ECS metadata. For details, see Table 10. + |
+
security_groups + |
+Yes + |
+Array of security_groups objects + |
+Specifies security groups. For details, see Table 11. +If the security group is specified both in the AS configuration and AS group, scaled ECS instances will be added to the security group specified in the AS configuration. If the security group is not specified in either of them, scaled ECS instances will be added to the default security group. For your convenience, you are advised to specify the security group in the AS configuration. + |
+
market_type + |
+No + |
+String + |
+This parameter is reserved. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
size + |
+Yes + |
+Integer + |
+Specifies the disk size. The unit is GB. +The system disk size ranges from 1 to 1024 and must be greater than or equal to the minimum size (min_disk value) of the system disk specified in the image. +The data disk size ranges from 10 to 32768. + |
+
volume_type + |
+Yes + |
+String + |
+Specifies the ECS system disk type. The disk type must match the available disk type. +
If the specified disk type is not available in the AZ, the disk will fail to create. + NOTE:
+For HANA, HL1, and HL2 ECSs, use co-p1 and uh-l1 disks. For other ECSs, do not use co-p1 or uh-l1 disks. + + |
+
disk_type + |
+Yes + |
+String + |
+Specifies a disk type. The options are as follows: +
|
+
dedicated_storage_id + |
+No + |
+String + |
+Specifies a DSS device ID for creating an ECS disk. + NOTE:
+Specify DSS devices for all disks in an AS configuration or not. If DSS devices are specified, all the data stores must belong to the same AZ, and the disk types supported by a DSS device for a disk must be the same as the volume_type value. + |
+
data_disk_image_id + |
+No + |
+String + |
+Specifies the ID of a data disk image used to export data disks of an ECS. + |
+
snapshot_id + |
+No + |
+String + |
+Specifies the disk backup snapshot ID for restoring the system disk and data disks using a full-ECS backup when a full-ECS image is used. + NOTE:
+Each disk in an AS configuration must correspond to a disk backup in the full-ECS backup by snapshot_id. + |
+
metadata + |
+No + |
+metadata object + |
+Specifies the metadata for creating disks. For details, see Table 5. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
__system__encrypted + |
+No + |
+String + |
+Specifies encryption in metadata. The value can be 0 (encryption disabled) or 1 (encryption enabled). +If this parameter does not exist, the disk will not be encrypted by default. + NOTE:
+System disk encryption is not supported. + |
+
__system__cmkid + |
+No + |
+String + |
+Specifies the CMK ID, which indicates encryption in metadata. This parameter is used with __system__encrypted. + NOTE:
+
|
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
path + |
+Yes + |
+String + |
+Specifies the path of the injected file. +
|
+
content + |
+Yes + |
+String + |
+Specifies the content of the injected file. +The value must be the information after the content of the injected file is encoded using Base64. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
eip + |
+Yes + |
+eip object + |
+Specifies the EIP automatically assigned to the ECS. For details, see Table 8. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
ip_type + |
+Yes + |
+String + |
+Specifies the EIP type. +Enumerated value of the IP address type: 5_bgp (indicates dynamic BGP) + |
+
bandwidth + |
+Yes + |
+bandwidth object + |
+Specifies the bandwidth of an IP address. For details, see Table 9. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
size + |
+Yes + |
+Integer + |
+Specifies the bandwidth (Mbit/s). The value range is 1 to 500. + NOTE:
+
|
+
share_type + |
+Yes + |
+String + |
+Specifies the bandwidth sharing type. +Enumerated values of the sharing type: +
Only dedicated bandwidth is available. + |
+
charging_mode + |
+Yes + |
+String + |
+Specifies the bandwidth billing mode. +traffic: billed by traffic. +If the parameter value is out of the preceding options, creating the ECS will fail. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
admin_pass + |
+No + |
+String + |
+Specifies the initial login password of the administrator account for logging in to an ECS using password authentication. The Linux administrator is root, and the Windows administrator is Administrator. +Password complexity requirements:
+
|
+
POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_configuration
+
+{
+ "scaling_configuration_name": "as-config-tlzq",
+ "instance_config": {
+ "flavorRef": "s3.xlarge.4",
+ "imageRef": "627a1223-2ca3-46a7-8d5f-7aef22c74ee6",
+ "disk": [
+ {
+ "size": 40,
+ "volume_type": "SATA",
+ "disk_type": "SYS"
+ }
+ ],
+ "key_name": "100vm_key" ,
+ "security_groups": [{
+ "id": "6c22a6c0-b5d2-4a84-ac56-51090dcc33be"
+ }],
+ "multi_flavor_priority_policy": "PICK_FIRST"
+ }
+}
+
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_configuration_id + |
+String + |
+Specifies the AS configuration ID. + |
+
{
+ "scaling_configuration_id": "f8327883-6a07-4497-9a61-68c03e8e72a2"
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query AS configurations based on search criteria. The results are displayed by page.
+GET /autoscaling-api/v1/{project_id}/scaling_configuration
+
You can type the question mark (?) and ampersand (&) at the end of the URI to define multiple search criteria. AS configurations can be searched by all optional parameters in the following table. For details, see the example request.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_configuration_name + |
+No + |
+String + |
+Specifies the AS configuration name. +Supports fuzzy search. + |
+
image_id + |
+No + |
+String + |
+Specifies the image ID. It is same as imageRef. + |
+
start_number + |
+No + |
+Integer + |
+Specifies the start line number. The default value is 0. The minimum parameter value is 0. + |
+
limit + |
+No + |
+Integer + |
+Specifies the number of query records. The default value is 20. The value range is 0 to 100. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
total_number + |
+Integer + |
+Specifies the total number of query records. + |
+
start_number + |
+Integer + |
+Specifies the start line number. + |
+
limit + |
+Integer + |
+Specifies the number of query records. + |
+
scaling_configurations + |
+Array of scaling_configurations objects + |
+Specifies the AS configuration list. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_configuration_id + |
+String + |
+Specifies the AS configuration ID. This parameter is globally unique. + |
+
tenant + |
+String + |
+Specifies the tenant ID. + |
+
scaling_configuration_name + |
+String + |
+Specifies the AS configuration name. +Supports fuzzy search. + |
+
instance_config + |
+instance_config object + |
+Specifies the information about instance configurations. + |
+
create_time + |
+String + |
+Specifies the time when AS configurations are created. The time format complies with UTC. + |
+
scaling_group_id + |
+String + |
+Specifies the ID of the AS group to which the AS configuration is bound. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
flavorRef + |
+String + |
+Specifies the ECS flavor ID. + |
+
imageRef + |
+String + |
+Specifies the image ID. It is same as image_id. + |
+
disk + |
+Array of disk objects + |
+Specifies the disk group information. + |
+
key_name + |
+String + |
+Specifies the name of the SSH key pair used to log in to the ECS. + |
+
key_fingerprint + |
+String + |
+Specifies the fingerprint of the SSH key pair used to log in to the ECS. + |
+
instance_name + |
+String + |
+This parameter is reserved. + |
+
instance_id + |
+String + |
+This parameter is reserved. + |
+
adminPass + |
+String + |
+This parameter is reserved. + |
+
personality + |
+Array of personality objects + |
+Specifies information about the injected file. + |
+
public_ip + |
+public_ip object + |
+Specifies the EIP of the ECS. + |
+
user_data + |
+String + |
+Specifies the Cloud-Init user data, which is encoded using Base64. + |
+
metadata + |
+metadata object + |
+Specifies the ECS metadata. For details, see Table 11. + |
+
security_groups + |
+Array of security_groups objects + |
+Specifies the security group information. + |
+
server_group_id + |
+String + |
+This parameter is reserved. + |
+
tenancy + |
+String + |
+This parameter is reserved. + |
+
dedicated_host_id + |
+String + |
+This parameter is reserved. + |
+
market_type + |
+String + |
+This parameter is reserved. + |
+
multi_flavor_priority_policy + |
+String + |
+This parameter is reserved. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
size + |
+Integer + |
+Specifies the disk size. The unit is GB. + |
+
volume_type + |
+String + |
+Specifies the disk type. + |
+
disk_type + |
+String + |
+Specifies whether the disk is a system disk or a data disk. DATA indicates a data disk. SYS indicates a system disk. + |
+
dedicated_storage_id + |
+String + |
+Specifies the ID of the DSS device for the disk. + |
+
data_disk_image_id + |
+String + |
+Specifies the ID of the data disk image for creating a data disk. + |
+
snapshot_id + |
+String + |
+Specifies the disk backup snapshot ID. + |
+
metadata + |
+metadata object + |
+Specifies the metadata for creating disks. For details, see Table 6. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
__system__encrypted + |
+String + |
+Specifies encryption in metadata. The value can be 0 (encryption disabled) or 1 (encryption enabled). +If this parameter does not exist, the disk will not be encrypted by default. + |
+
__system__cmkid + |
+String + |
+Specifies the CMK ID, which indicates encryption in metadata. This parameter is used with __system__encrypted. + NOTE:
+For details about how to obtain the CMK ID, see "Querying the List of CMKs" in Key Management Service API Reference. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
path + |
+String + |
+Specifies the path of the injected file. + |
+
content + |
+String + |
+Specifies the content of the file to be injected. The file content is encoded using Base64. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
eip + |
+eip object + |
+Specifies the automatically assigned EIP. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
ip_type + |
+String + |
+Specifies the IP address type. + |
+
bandwidth + |
+bandwidth object + |
+Specifies the bandwidth of an IP address. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
size + |
+Integer + |
+Specifies the bandwidth (Mbit/s). + |
+
share_type + |
+String + |
+Specifies the bandwidth sharing type. +Enumerated values of the sharing type: +
|
+
charging_mode + |
+String + |
+Specifies the bandwidth billing mode. +
|
+
{
+ "limit": 20,
+ "total_number": 2,
+ "start_number": 0,
+ "scaling_configurations": [
+ {
+ "tenant": "ce061903a53545dcaddb300093b477d2",
+ "scaling_configuration_id": "6afe46f9-7d3d-4046-8748-3b2a1085ad86",
+ "scaling_configuration_name": " config_name_1",
+ "instance_config": {
+ "disk": [
+ {
+ "size": 40,
+ "volume_type": "SATA",
+ "disk_type": "SYS"
+ },
+ {
+ "size": 100,
+ "volume_type": "SATA",
+ "disk_type": "DATA"
+ }
+ ],
+ "personality": null,
+ "instance_name": null,
+ "instance_id": null,
+ "flavorRef": "103",
+ "imageRef": "37ca2b35-6fc7-47ab-93c7-900324809c5c",
+ "key_name": "keypair01",
+ "public_ip": null,
+ "user_data": null,
+ "metadate": {},
+ "security_groups": [{
+ "id": "6c22a6c0-b5d2-4a84-ac56-51090dcc33be"
+ }],
+ },
+ "create_time": "2015-07-23T01:04:07Z"
+ },
+ {
+ "tenant": "ce061903a53545dcaddb300093b477d2",
+ "scaling_configuration_id": "24a8c5f3-c713-4aba-ac29-c17101009e5d",
+ "scaling_configuration_name": "config_name_2",
+ "instance_config": {
+ "disk": [
+ {
+ "size": 40,
+ "volume_type": "SATA",
+ "disk_type": "SYS"
+ }
+ ],
+ "personality": null,
+ "instance_name": null,
+ "instance_id": null,
+ "flavorRef": "103",
+ "imageRef": "37ca2b35-6fc7-47ab-93c7-900324809c5c",
+ "key_name": "keypair01",
+ "public_ip": null,
+ "user_data": null,
+ "metadata": {},
+ "security_groups": [{
+ "id": "6c22a6c0-b5d2-4a84-ac56-51090dcc33be"
+ }],
+ "multi_flavor_priority_policy": "PICK_FIRST"
+ },
+ "create_time": "2015-07-22T01:08:41Z"
+ }
+ ]
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This interface is used to query details about an AS configuration by configuration ID.
+GET /autoscaling-api/v1/{project_id}/scaling_configuration/{scaling_configuration_id}
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_configuration_id + |
+Yes + |
+String + |
+Specifies an AS configuration ID, which is unique globally. For details, see Querying AS Configuration Details. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_configuration + |
+scaling_configurations object + |
+Provides AS configuration details. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_configuration_id + |
+String + |
+Specifies the AS configuration ID. This parameter is globally unique. + |
+
tenant + |
+String + |
+Specifies the tenant ID. + |
+
scaling_configuration_name + |
+String + |
+Specifies the AS configuration name. +Supports fuzzy search. + |
+
instance_config + |
+instance_config object + |
+Specifies the information about instance configurations. + |
+
create_time + |
+String + |
+Specifies the time when AS configurations are created. The time format complies with UTC. + |
+
scaling_group_id + |
+String + |
+Specifies the ID of the AS group to which the AS configuration is bound. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
flavorRef + |
+String + |
+Specifies the ECS flavor ID. + |
+
imageRef + |
+String + |
+Specifies the image ID. It is same as image_id. + |
+
disk + |
+Array of disk objects + |
+Specifies the disk group information. + |
+
key_name + |
+String + |
+Specifies the name of the SSH key pair used to log in to the ECS. + |
+
key_fingerprint + |
+String + |
+Specifies the fingerprint of the SSH key pair used to log in to the ECS. + |
+
instance_name + |
+String + |
+This parameter is reserved. + |
+
instance_id + |
+String + |
+This parameter is reserved. + |
+
adminPass + |
+String + |
+This parameter is reserved. + |
+
personality + |
+Array of personality objects + |
+Specifies information about the injected file. + |
+
public_ip + |
+public_ip object + |
+Specifies the EIP of the ECS. + |
+
user_data + |
+String + |
+Specifies the Cloud-Init user data, which is encoded using Base64. + |
+
metadata + |
+metadata object + |
+Specifies the ECS metadata. For details, see Table 11. + |
+
security_groups + |
+Array of security_groups objects + |
+Specifies the security group information. + |
+
server_group_id + |
+String + |
+This parameter is reserved. + |
+
tenancy + |
+String + |
+This parameter is reserved. + |
+
dedicated_host_id + |
+String + |
+This parameter is reserved. + |
+
market_type + |
+String + |
+This parameter is reserved. + |
+
multi_flavor_priority_policy + |
+String + |
+This parameter is reserved. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
size + |
+Integer + |
+Specifies the disk size. The unit is GB. + |
+
volume_type + |
+String + |
+Specifies the disk type. + |
+
disk_type + |
+String + |
+Specifies whether the disk is a system disk or a data disk. DATA indicates a data disk. SYS indicates a system disk. + |
+
dedicated_storage_id + |
+String + |
+Specifies the ID of the DSS device for the disk. + |
+
data_disk_image_id + |
+String + |
+Specifies the ID of the data disk image for creating a data disk. + |
+
snapshot_id + |
+String + |
+Specifies the disk backup snapshot ID. + |
+
metadata + |
+metadata object + |
+Specifies the metadata for creating disks. For details, see Table 6. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
path + |
+String + |
+Specifies the path of the injected file. + |
+
content + |
+String + |
+Specifies the content of the file to be injected. The file content is encoded using Base64. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
eip + |
+eip object + |
+Specifies the automatically assigned EIP. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
ip_type + |
+String + |
+Specifies the IP address type. + |
+
bandwidth + |
+bandwidth object + |
+Specifies the bandwidth of an IP address. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
size + |
+Integer + |
+Specifies the bandwidth (Mbit/s). + |
+
share_type + |
+String + |
+Specifies the bandwidth sharing type. +Enumerated values of the sharing type: +
|
+
charging_mode + |
+String + |
+Specifies the bandwidth billing mode. +
|
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
admin_pass + |
+String + |
+Specifies the password of the Administrator account for a Windows ECS. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the security group ID. + |
+
{
+ "scaling_configuration": {
+ "tenant": "ce061903a53545dcaddb300093b477d2",
+ "scaling_configuration_id": "6afe46f9-7d3d-4046-8748-3b2a1085ad86",
+ "scaling_configuration_name": " config_name_1",
+ "instance_config": {
+ "disk": [
+ {
+ "size": 40,
+ "volume_type": "SATA",
+ "disk_type": "SYS"
+ },
+ {
+ "size": 100,
+ "volume_type": "SATA",
+ "disk_type": "DATA"
+ }
+ ],
+ "adminPass": "***",
+ "personality": null,
+ "instance_name": null,
+ "instance_id": null,
+ "flavorRef": "103",
+ "imageRef": "37ca2b35-6fc7-47ab-93c7-900324809c5c",
+ "key_name": "keypair01",
+ "public_ip": null,
+ "user_data": null,
+ "metadata": {},
+ "security_groups": [{
+ "id": "6c22a6c0-b5d2-4a84-ac56-51090dcc33be"
+ }],
+ "multi_flavor_priority_policy": "PICK_FIRST"
+ },
+ "create_time": "2015-07-23T01:04:07Z"
+ }
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This interface is used to delete a specified AS configuration.
+
AS configurations used by AS groups cannot be deleted.
+DELETE /autoscaling-api/v1/{project_id}/scaling_configuration/{scaling_configuration_id}
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_ configuration _id + |
+Yes + |
+String + |
+Specifies the AS configuration ID. For details, see Querying AS Configurations. + |
+
Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This interface is used to batch delete AS configurations.
+POST /autoscaling-api/v1/{project_id}/scaling_configurations
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
scaling_configuration_id + |
+Yes + |
+Array of strings + |
+Specifies the AS configuration ID. For details, see Querying AS Configurations. + |
+
Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query instances in an AS group based on search criteria. The results are displayed by page.
+GET /autoscaling-api/v1/{project_id}/scaling_group_instance/{scaling_group_id}/list
+
You can type the question mark (?) and ampersand (&) at the end of the URI to define multiple search criteria. Instances in an AS group can be searched by all optional parameters in the following table. For details, see the example request.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_group_id + |
+Yes + |
+String + |
+Specifies the AS group ID. + |
+
life_cycle_state + |
+No + |
+String + |
+Specifies the instance lifecycle status in the AS group. +
|
+
health_status + |
+No + |
+String + |
+Specifies the instance health status. +
|
+
protect_from_scaling_down + |
+No + |
+String + |
+Specifies the instance protection status. +
|
+
start_number + |
+No + |
+Integer + |
+Specifies the start line number. The default value is 0. The minimum parameter value is 0. + |
+
limit + |
+No + |
+Integer + |
+Specifies the number of query records. The default value is 20. The value range is 0 to 100. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
total_number + |
+Integer + |
+Specifies the total number of query records. + |
+
start_number + |
+Integer + |
+Specifies the start line number. + |
+
limit + |
+Integer + |
+Specifies the maximum number of resources to be queried. + |
+
scaling_group_instances + |
+Array of scaling_group_instances objects + |
+Specifies details about the instances in the AS group. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
instance_id + |
+String + |
+Specifies the instance ID. + |
+
instance_name + |
+String + |
+Specifies the instance name. + |
+
scaling_group_id + |
+String + |
+Specifies the ID of the AS group to which the instance belongs. + |
+
scaling_group_name + |
+String + |
+Specifies the name of the AS group to which the instance belongs. +Supports fuzzy search. + |
+
life_cycle_state + |
+String + |
+Specifies the instance lifecycle status in the AS group. +
|
+
health_status + |
+String + |
+Specifies the instance health status. +
|
+
scaling_configuration_name + |
+String + |
+Specifies the AS configuration name. + |
+
scaling_configuration_id + |
+String + |
+Specifies the AS configuration ID. +If the returned value is not empty, the instance is an ECS automatically created in a scaling action. +If the returned value is empty, the instance is an ECS manually added to the AS group. + |
+
create_time + |
+String + |
+Specifies the time when the instance is added to the AS group. The time format complies with UTC. + |
+
protect_from_scaling_down + |
+Boolean + |
+Specifies the instance protection status. + |
+
{
+ "limit": 10,
+ "total_number": 1,
+ "start_number": 0,
+ "scaling_group_instances": [
+ {
+ "instance_id": "b25c1589-c96c-465b-9fef-d06540d1945c",
+ "scaling_group_id": "e5d27f5c-dd76-4a61-b4bc-a67c5686719a",
+ "scaling_group_name": "discuz",
+ "life_cycle_state": "INSERVICE",
+ "health_status": "NORMAL",
+ "scaling_configuration_name": "discuz",
+ "scaling_configuration_id": "ca3dcd84-d197-4c4f-af2a-cf8ba39696ac",
+ "create_time": "2015-07-23T06:47:33Z",
+ "instance_name": "discuz_3D210808",
+ "protect_from_scaling_down": false
+ }
+ ]
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This interface is used to remove a specified instance from an AS group.
+DELETE /autoscaling-api/v1/{project_id}/scaling_group_instance/{instance_id}?instance_delete=yes
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
instance_id + |
+Yes + |
+String + |
+Specifies the instance ID. For details, see Querying Instances in an AS Group. + |
+
instance_delete + |
+No + |
+String + |
+Specifies whether an instance is deleted when it is removed from the AS group. +Options: +
|
+
Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+
POST /autoscaling-api/v1/{project_id}/scaling_group_instance/{scaling_group_id}/action
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_group_id + |
+Yes + |
+String + |
+Specifies the AS group ID. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
instances_id + |
+Yes + |
+Array of strings + |
+Specifies the ECS ID. + |
+
instance_delete + |
+No + |
+String + |
+Specifies whether to delete an instance when it is removed from an AS group. +Options: +
This parameter takes effect only when the action is set to REMOVE. + |
+
action + |
+Yes + |
+String + |
+Specifies an action to be performed on instances in batches. The options are as follows: +
|
+
POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_instance/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/action
+
+{
+ "action": "REMOVE",
+ "instances_id": [
+ "instance_id_1",
+ "instance_id_2"
+ ],
+ "instance_delete": "yes"
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to create an AS policy.
+POST /autoscaling-api/v1/{project_id}/scaling_policy
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
scaling_policy_name + |
+Yes + |
+String + |
+Specifies the AS policy name. The name contains only letters, digits, underscores (_), and hyphens (-), and cannot exceed 64 characters. + |
+
scaling_group_id + |
+Yes + |
+String + |
+Specifies the AS group ID, which can be obtained using the API for querying AS groups. For details, see Querying AS Groups. + |
+
scaling_policy_type + |
+Yes + |
+String + |
+Specifies the AS policy type. +
|
+
alarm_id + |
+No + |
+String + |
+Specifies the alarm rule ID. This parameter is mandatory when scaling_policy_type is set to ALARM. After this parameter is specified, the value of scheduled_policy does not take effect. +After you create an alarm policy, the system automatically adds an alarm triggering activity of the autoscaling type to the alarm_actions field in the alarm rule specified by the parameter value. + |
+
scheduled_policy + |
+No + |
+scheduled_policy object + |
+Specifies the periodic or scheduled AS policy. This parameter is mandatory when scaling_policy_type is set to SCHEDULED or RECURRENCE. After this parameter is specified, the value of alarm_id does not take effect. For details, see Table 3. + |
+
scaling_policy_action + |
+No + |
+scaling_policy_action object + |
+Specifies the scaling action of the AS policy. For details, see Table 4. + |
+
cool_down_time + |
+No + |
+Integer + |
+Specifies the cooldown period (in seconds). The value ranges from 0 to 86400 and is 300 by default. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
launch_time + |
+Yes + |
+String + |
+Specifies the time when the scaling action is triggered. The time format complies with UTC. +
|
+
recurrence_type + |
+No + |
+String + |
+Specifies the periodic triggering type. This parameter is mandatory when scaling_policy_type is set to RECURRENCE. +
|
+
recurrence_value + |
+No + |
+String + |
+Specifies the day when a periodic scaling action is triggered. This parameter is mandatory when scaling_policy_type is set to RECURRENCE. +
|
+
start_time + |
+No + |
+String + |
+Specifies the start time of the scaling action triggered periodically. The time format complies with UTC. The default value is the local time. +The time format is YYYY-MM-DDThh:mmZ. + |
+
end_time + |
+No + |
+String + |
+Specifies the end time of the scaling action triggered periodically. The time format complies with UTC. This parameter is mandatory when scaling_policy_type is set to RECURRENCE. +When the scaling action is triggered periodically, the end time cannot be earlier than the current and start time. +The time format is YYYY-MM-DDThh:mmZ. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
operation + |
+No + |
+String + |
+Specifies the operation to be performed. The default operation is ADD. +
|
+
instance_number + |
+No + |
+Integer + |
+Specifies the number of instances to be operated. The default number is 1. The value range is as follows for a default quota: +
NOTE:
+Either instance_number or instance_percentage is required. + |
+
instance_percentage + |
+No + |
+Integer + |
+Specifies the percentage of instances to be operated. You can increase, decrease, or set the number of instances in an AS group to the specified percentage of the current number of instances. If operation is set to ADD, REMOVE or REDUCE, the value of this parameter is an integer from 1 to 20000. If operation is set to SET, the value is an integer from 0 to 20000. +If neither instance_number nor instance_percentage is specified, the number of instances to be operated is 1. +Either instance_number or instance_percentage is required. + |
+
POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_policy
+
+{
+ "scaling_policy_name": "as-policy-7a75",
+ "scaling_policy_action": {
+ "operation": "ADD",
+ "instance_number": 1
+ },
+ "cool_down_time": 900,
+ "scheduled_policy": {
+ "launch_time": "16:00",
+ "recurrence_type": "Daily",
+ "start_time": "2015-12-14T03:34Z",
+ "end_time": "2015-12-27T03:34Z"
+ },
+ "scaling_policy_type": "RECURRENCE",
+ "scaling_group_id": "5bc3aa02-b83e-454c-aba1-4d2095c68f8b"
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_policy_id + |
+String + |
+Specifies the AS policy ID. + |
+
{
+ "scaling_policy_id": "0h327883-324n-4dzd-9c61-68d03ee191dd"
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to create an AS policy for an AS group or bandwidth.
+The difference between the V2 and V1 APIs for creating an AS policy is that V2 supports creating an AS policy for adjusting bandwidth and differentiating scaling resources by their types.
+POST /autoscaling-api/v2/{project_id}/scaling_policy
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
scaling_policy_name + |
+Yes + |
+String + |
+Specifies the AS policy name. The name contains only letters, digits, underscores (_), and hyphens (-), and cannot exceed 64 characters. + |
+
scaling_resource_id + |
+Yes + |
+String + |
+Specifies the scaling resource ID, which is the unique ID of an AS group or bandwidth. +
|
+
scaling_resource_type + |
+Yes + |
+String + |
+Specifies the scaling resource type. +
|
+
scaling_policy_type + |
+Yes + |
+String + |
+Specifies the AS policy type. +
|
+
alarm_id + |
+No + |
+String + |
+Specifies the alarm rule ID. This parameter is mandatory when scaling_policy_type is set to ALARM. After this parameter is specified, the value of scheduled_policy does not take effect. +After you create an alarm policy, the system automatically adds an alarm triggering activity of the autoscaling type to the alarm_actions field in the alarm rule specified by the parameter value. +You can obtain the parameter value by querying Cloud Eye alarm rules. + |
+
scheduled_policy + |
+No + |
+scheduled_policy object + |
+Specifies the periodic or scheduled AS policy. This parameter is mandatory when scaling_policy_type is set to SCHEDULED or RECURRENCE. After this parameter is specified, the value of alarm_id does not take effect. For details, see Table 3. + |
+
scaling_policy_action + |
+No + |
+scaling_policy_action object + |
+Specifies the scaling action of the AS policy. For details, see Table 4. + |
+
cool_down_time + |
+No + |
+Integer + |
+Specifies the cooldown period (in seconds). The value ranges from 0 to 86400 and is 300 by default. + |
+
description + |
+No + |
+String + |
+Specifies the description of the AS policy. The value can contain 1 to 256 characters. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
launch_time + |
+Yes + |
+String + |
+Specifies the time when the scaling action is triggered. The time format complies with UTC. +
|
+
recurrence_type + |
+No + |
+String + |
+Specifies the periodic triggering type. This parameter is mandatory when scaling_policy_type is set to RECURRENCE. +
|
+
recurrence_value + |
+No + |
+String + |
+Specifies the day when a periodic scaling action is triggered. This parameter is mandatory when scaling_policy_type is set to RECURRENCE. +
|
+
start_time + |
+No + |
+String + |
+Specifies the start time of the scaling action triggered periodically. The time format complies with UTC. The default value is the local time. +The time format is YYYY-MM-DDThh:mmZ. + |
+
end_time + |
+No + |
+String + |
+Specifies the end time of the scaling action triggered periodically. The time format complies with UTC. This parameter is mandatory when scaling_policy_type is set to RECURRENCE. When the scaling action is triggered periodically, the end time cannot be earlier than the current and start time. +The time format is YYYY-MM-DDThh:mmZ. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
operation + |
+No + |
+String + |
+Specifies the operation to be performed. The default operation is ADD.
+
|
+
size + |
+No + |
+Integer + |
+Specifies the operation size. The value is an integer from 0 to 300. The default value is 1. This parameter can be set to 0 only when operation is set to SET. +
|
+
percentage + |
+No + |
+Integer + |
+Specifies the percentage of instances to be operated. If operation is set to ADD, REMOVE, or REDUCE, the value of this parameter is an integer from 1 to 20000. If operation is set to SET, the value is an integer from 0 to 20000. +
|
+
limits + |
+No + |
+Integer + |
+Specifies the operation restrictions. +If scaling_resource_type is set to BANDWIDTH and operation is not SET, this parameter takes effect and the unit is Mbit/s. +
|
+
POST https://{Endpoint}/autoscaling-api/v2/{project_id}/scaling_policy
+
+{
+ "alarm_id": "al1513822380493GvlJKZwA8",
+ "cool_down_time": 900,
+ "scaling_resource_id": "8ade64b5-d685-40b8-8582-4ce306ea37a6",
+ "scaling_resource_type": "BANDWIDTH",
+ "scaling_policy_action": {
+ "size": 1,
+ "operation": "ADD",
+ "limits": 10
+ },
+ "scaling_policy_name": "hth_aspolicy_1",
+ "scaling_policy_type": "ALARM"
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_policy_id + |
+String + |
+Specifies the AS policy ID. + |
+
{
+ "scaling_policy_id": "0h327883-324n-4dzd-9c61-68d03ee191dd"
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to modify a specified AS policy.
+PUT /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id}
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_policy_id + |
+Yes + |
+String + |
+Specifies an AS policy ID. For details, see Querying AS Policies. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
scaling_policy_name + |
+No + |
+String + |
+Specifies the AS policy name. The name contains only letters, digits, underscores (_), and hyphens (-), and cannot exceed 64 characters. + |
+
scaling_policy_type + |
+No + |
+String + |
+Specifies the AS policy type. +
|
+
alarm_id + |
+No + |
+String + |
+Specifies the alarm rule ID. This parameter is mandatory when scaling_policy_type is set to ALARM. After this parameter is specified, the value of scheduled_policy does not take effect. +After you modify an alarm policy, the system automatically adds an alarm triggering activity of the autoscaling type to the alarm_actions field in the alarm rule specified by the parameter value. +You can obtain the parameter value by querying Cloud Eye alarm rules. + |
+
scheduled_policy + |
+No + |
+scheduled_policy object + |
+Specifies the periodic or scheduled AS policy. This parameter is mandatory when scaling_policy_type is set to SCHEDULED or RECURRENCE. After this parameter is specified, the value of alarm_id does not take effect. For details, see Table 3. + |
+
scaling_policy_action + |
+No + |
+scaling_policy_action object + |
+Specifies the scaling action of the AS policy. For details, see Table 4. + |
+
cool_down_time + |
+No + |
+Integer + |
+Specifies the cooldown period (in seconds). The value ranges from 0 to 86400. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
launch_time + |
+Yes + |
+String + |
+Specifies the time when the scaling action is triggered. The time format complies with UTC. +
|
+
recurrence_type + |
+No + |
+String + |
+Specifies the periodic triggering type. This parameter is mandatory when scaling_policy_type is set to RECURRENCE. +
|
+
recurrence_value + |
+No + |
+String + |
+Specifies the day when a periodic scaling action is triggered. This parameter is mandatory when scaling_policy_type is set to RECURRENCE. +
|
+
start_time + |
+No + |
+String + |
+Specifies the start time of the scaling action triggered periodically. The time format complies with UTC. +The time format is YYYY-MM-DDThh:mmZ. + |
+
end_time + |
+No + |
+String + |
+Specifies the end time of the scaling action triggered periodically. The time format complies with UTC. This parameter is mandatory when scaling_policy_type is set to RECURRENCE. +When the scaling action is triggered periodically, the end time cannot be earlier than the current and start time. +The time format is YYYY-MM-DDThh:mmZ. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
operation + |
+No + |
+String + |
+Specifies the operation to be performed. The default operation is ADD. +
|
+
instance_number + |
+No + |
+Integer + |
+Specifies the number of instances to be operated. The default number is 1. The value range is as follows for a default quota: +
NOTE:
+Either instance_number or instance_percentage is required. + |
+
instance_percentage + |
+No + |
+Integer + |
+Specifies the percentage of instances to be operated. You can increase, decrease, or set the number of instances in an AS group to the specified percentage of the current number of instances. If operation is set to ADD, REMOVE or REDUCE, the value of this parameter is an integer from 1 to 20000. If operation is set to SET, the value is an integer from 0 to 20000. +If neither instance_number nor instance_percentage is specified, the number of instances to be operated is 1. +Either instance_number or instance_percentage is required. + |
+
This example shows how to modify the periodic AS policy with ID 0h327883-324n-4dzd-9c61-68d03ee191dd for an AS group with two instances. The modification is as follows: The AS policy name is changed to policy_01, and the modification is executed at 16:00 every day from 2016-01-08T17:31Z through 2016-02-08T17:31Z.
+PUT https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_policy/0h327883-324n-4dzd-9c61-68d03ee191dd
+
+{
+ "scaling_policy_type": "RECURRENCE",
+ "scaling_policy_name": "policy_01",
+ "scheduled_policy": {
+ "launch_time": "16:00",
+ "recurrence_type": "Daily",
+ "end_time": "2016-02-08T17:31Z",
+ "start_time": "2016-01-08T17:31Z"
+ },
+ "scaling_policy_action": {
+ "operation": "SET",
+ "instance_number": 2
+ }
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_policy_id + |
+String + |
+Specifies the AS policy ID. + |
+
{
+ "scaling_policy_id": "0h327883-324n-4dzd-9c61-68d03ee191dd"
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to modify a specified AS policy.
+The difference between the V2 and V1 APIs for modifying an AS policy is that V2 supports modifying a scaling resource type.
+PUT /autoscaling-api/v2/{project_id}/scaling_policy/{scaling_policy_id}
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_policy_id + |
+Yes + |
+String + |
+Specifies an AS policy ID. For details, see Querying AS Policies (V2). + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
scaling_policy_name + |
+No + |
+String + |
+Specifies the AS policy name. The name contains only letters, digits, underscores (_), and hyphens (-), and cannot exceed 64 characters. + |
+
scaling_policy_type + |
+No + |
+String + |
+Specifies the AS policy type. +
|
+
scaling_resource_id + |
+No + |
+String + |
+Specifies the scaling resource ID, which is the ID of a unique AS group or bandwidth. + |
+
scaling_resource_type + |
+No + |
+String + |
+Specifies the scaling resource type. +
|
+
alarm_id + |
+No + |
+String + |
+Specifies the alarm rule ID. This parameter is mandatory when scaling_policy_type is set to ALARM. After this parameter is specified, the value of scheduled_policy does not take effect. +After you modify an alarm policy, the system automatically adds an alarm triggering activity of the autoscaling type to the alarm_actions field in the alarm rule specified by the parameter value. +You can obtain the parameter value by querying Cloud Eye alarm rules. + |
+
scheduled_policy + |
+No + |
+scheduled_policy object + |
+Specifies the periodic or scheduled AS policy. This parameter is mandatory when scaling_policy_type is set to SCHEDULED or RECURRENCE. After this parameter is specified, the value of alarm_id does not take effect. For details, see Table 3. + |
+
scaling_policy_action + |
+No + |
+scaling_policy_action object + |
+Specifies the scaling action of the AS policy. For details, see Table 4. + |
+
cool_down_time + |
+No + |
+Integer + |
+Specifies the cooldown period (in seconds). The value ranges from 0 to 86400. + |
+
description + |
+No + |
+String + |
+Specifies the description of the AS policy. The value can contain 1 to 256 characters. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
launch_time + |
+Yes + |
+String + |
+Specifies the time when the scaling action is triggered. The time format complies with UTC. +
|
+
recurrence_type + |
+No + |
+String + |
+Specifies the periodic triggering type. This parameter is mandatory when scaling_policy_type is set to RECURRENCE. +
|
+
recurrence_value + |
+No + |
+String + |
+Specifies the day when a periodic scaling action is triggered. This parameter is mandatory when scaling_policy_type is set to RECURRENCE. +
|
+
start_time + |
+No + |
+String + |
+Specifies the start time of the scaling action triggered periodically. The time format complies with UTC. +The time format is YYYY-MM-DDThh:mmZ. + |
+
end_time + |
+No + |
+String + |
+Specifies the end time of the scaling action triggered periodically. The time format complies with UTC. This parameter is mandatory when scaling_policy_type is set to RECURRENCE. +When the scaling action is triggered periodically, the end time cannot be earlier than the current and start time. +The time format is YYYY-MM-DDThh:mmZ. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
operation + |
+No + |
+String + |
+Specifies the operation to be performed. The default operation is ADD.
+
|
+
size + |
+No + |
+Integer + |
+Specifies the operation size. The value is an integer from 0 to 300. The default value is 1. This parameter can be set to 0 only when operation is set to SET. +
|
+
percentage + |
+No + |
+Integer + |
+Specifies the percentage of instances to be operated. If operation is set to ADD, REMOVE, or REDUCE, the value of this parameter is an integer from 1 to 20000. If operation is set to SET, the value is an integer from 0 to 20000. +
|
+
limits + |
+No + |
+Integer + |
+Specifies the operation restrictions. +If scaling_resource_type is set to BANDWIDTH and operation is not SET, this parameter takes effect and the unit is Mbit/s. +
|
+
This example shows how to modify an AS policy with ID 0h327883-324n-4dzd-9c61-68d03ee191dd. The modification is as follows: The AS policy name is changed to hth_aspolicy_1; the alarm ID is changed to al1513822380493GvlJKZwA8; the cooldown period is changed to 900 seconds; the policy execution action is to add a bandwidth of 1 Mbit/s until the bandwidth reaches 10 Mbit/s.
+PUT https://{Endpoint}/autoscaling-api/v2/{project_id}/scaling_policy/0h327883-324n-4dzd-9c61-68d03ee191dd
+
+{
+ "alarm_id": "al1513822380493GvlJKZwA8",
+ "cool_down_time": 900,
+ "scaling_policy_action": {
+ "size": 1,
+ "operation": "ADD",
+ "limits": 10
+ },
+ "scaling_policy_name": "hth_aspolicy_1",
+ "scaling_policy_type": "ALARM"
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_policy_id + |
+String + |
+Specifies the AS policy ID. + |
+
{
+ "scaling_policy_id": "0h327883-324n-4dzd-9c61-68d03ee191dd"
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query AS policies based on search criteria. The results are displayed by page.
+GET /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_group_id}/list
+
You can type the question mark (?) and ampersand (&) at the end of the URI to define multiple search criteria. AS policies can be searched by all optional parameters in the following table. For details, see the example request.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_group_id + |
+Yes + |
+String + |
+Specifies the AS group ID. + |
+
scaling_policy_name + |
+No + |
+String + |
+Specifies the AS policy name. +Supports fuzzy search. + |
+
scaling_policy_type + |
+No + |
+String + |
+Specifies the AS policy type. +
|
+
scaling_policy_id + |
+No + |
+String + |
+Specifies the AS policy ID. + |
+
start_number + |
+No + |
+Integer + |
+Specifies the start line number. The default value is 0. The minimum parameter value is 0. + |
+
limit + |
+No + |
+Integer + |
+Specifies the number of query records. The default value is 20. The value range is 0 to 100. + |
+
GET https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_policy/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/list?scaling_policy_name=as-policy-test&scaling_policy_type=SCHEDULED
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
total_number + |
+Integer + |
+Specifies the total number of query records. + |
+
start_number + |
+Integer + |
+Specifies the start line number. + |
+
limit + |
+Integer + |
+Specifies the maximum number of resources to be queried. + |
+
scaling_policies + |
+Array of scaling_policies objects + |
+Specifies scaling policies. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_group_id + |
+String + |
+Specifies the AS group ID. + |
+
scaling_policy_name + |
+String + |
+Specifies the AS policy name. + |
+
scaling_policy_id + |
+String + |
+Specifies the AS policy ID. + |
+
policy_status + |
+String + |
+Specifies the AS policy status. +
|
+
scaling_policy_type + |
+String + |
+Specifies the AS policy type. +
|
+
alarm_id + |
+String + |
+Specifies the alarm ID. + |
+
scheduled_policy + |
+scheduled_policy object + |
+Specifies the periodic or scheduled AS policy. For details, see Table 4. + |
+
scaling_policy_action + |
+scaling_policy_action object + |
+Specifies the scaling action of the AS policy. For details, see Table 5. + |
+
cool_down_time + |
+Integer + |
+Specifies the cooldown period (s). + |
+
create_time + |
+String + |
+Specifies the time when an AS policy was created. The time format complies with UTC. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
launch_time + |
+String + |
+Specifies the time when the scaling action is triggered. The time format complies with UTC. +
|
+
recurrence_type + |
+String + |
+Specifies the type of a periodically triggered scaling action. +
|
+
recurrence_value + |
+String + |
+Specifies the frequency at which scaling actions are triggered. +
|
+
start_time + |
+String + |
+Specifies the start time of the scaling action triggered periodically. The time format complies with UTC. +The time format is YYYY-MM-DDThh:mmZ. + |
+
end_time + |
+String + |
+Specifies the end time of the scaling action triggered periodically. The time format complies with UTC. +The time format is YYYY-MM-DDThh:mmZ. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
operation + |
+String + |
+Specifies the scaling action. +
|
+
instance_number + |
+Integer + |
+Specifies the number of instances to be operated. + |
+
instance_percentage + |
+Integer + |
+Specifies the percentage of instances to be operated. + |
+
{
+ "limit": 20,
+ "total_number": 1,
+ "start_number": 0,
+ "scaling_policies": [
+ {
+ "scaling_policy_id": "fd7d63ce-8f5c-443e-b9a0-bef9386b23b3",
+ "scaling_group_id": "e5d27f5c-dd76-4a61-b4bc-a67c5686719a",
+ "scaling_policy_name": "as-policy-test",
+ "scaling_policy_type": "SCHEDULED",
+ "scheduled_policy": {
+ "launch_time": "2015-07-24T01:21Z"
+ },
+ "cool_down_time": 300,
+ "scaling_policy_action": {
+ "operation": "REMOVE",
+ "instance_number": 1
+ },
+ "policy_status": "INSERVICE",
+ "create_time": "2015-07-24T01:09:30Z"
+ }
+ ]
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query AS policies based on search criteria. The results are displayed by page.
+GET /autoscaling-api/v2/{project_id}/scaling_policy/{scaling_resource_id}/list
+
You can type the question mark (?) and ampersand (&) at the end of the URI to define multiple search criteria. AS policies can be searched by all optional parameters in the following table. For details, see the example request.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_resource_id + |
+Yes + |
+String + |
+Specifies the scaling resource ID. + |
+
scaling_policy_name + |
+No + |
+String + |
+Specifies the AS policy name. +Supports fuzzy search. + |
+
scaling_policy_type + |
+No + |
+String + |
+Specifies the AS policy type. +
|
+
scaling_policy_id + |
+No + |
+String + |
+Specifies the AS policy ID. + |
+
start_number + |
+No + |
+Integer + |
+Specifies the start line number. The default value is 0. The minimum parameter value is 0. + |
+
limit + |
+No + |
+Integer + |
+Specifies the number of query records. The default value is 20. The value range is 0 to 100. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
total_number + |
+Integer + |
+Specifies the total number of query records. + |
+
start_number + |
+Integer + |
+Specifies the start line number. + |
+
limit + |
+Integer + |
+Specifies the maximum number of resources to be queried. + |
+
scaling_policies + |
+Array of scaling_policies objects + |
+Specifies AS policies. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_policy_name + |
+String + |
+Specifies the AS policy name. +Supports fuzzy search. + |
+
scaling_policy_id + |
+String + |
+Specifies the AS policy ID. + |
+
scaling_resource_id + |
+String + |
+Specifies the scaling resource ID. + |
+
scaling_resource_type + |
+String + |
+Specifies the scaling resource type. +
|
+
policy_status + |
+String + |
+Specifies the AS policy status. +
|
+
scaling_policy_type + |
+String + |
+Specifies the AS policy type. +
|
+
alarm_id + |
+String + |
+Specifies the alarm ID. + |
+
scheduled_policy + |
+scheduled_policy object + |
+Specifies the periodic or scheduled AS policy. For details, see Table 4. + |
+
scaling_policy_action + |
+scaling_policy_action object + |
+Specifies the scaling action of the AS policy. For details, see Table 5. + |
+
cool_down_time + |
+Integer + |
+Specifies the cooldown period (s). + |
+
create_time + |
+String + |
+Specifies the time when an AS policy was created. The time format complies with UTC. + |
+
meta_data + |
+meta_data object + |
+Provides additional information. For details, see Table 6. + |
+
description + |
+String + |
+Specifies the AS policy description. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
launch_time + |
+String + |
+Specifies the time when the scaling action is triggered. The time format complies with UTC. +
|
+
recurrence_type + |
+String + |
+Specifies the type of a periodically triggered scaling action. +
|
+
recurrence_value + |
+String + |
+Specifies the frequency at which scaling actions are triggered. +
|
+
start_time + |
+String + |
+Specifies the start time of the scaling action triggered periodically. The time format complies with UTC. +The time format is YYYY-MM-DDThh:mmZ. + |
+
end_time + |
+String + |
+Specifies the end time of the scaling action triggered periodically. The time format complies with UTC. +The time format is YYYY-MM-DDThh:mmZ. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
operation + |
+String + |
+Specifies the scaling action. +
|
+
size + |
+Integer + |
+Specifies the number of instances to be operated. + |
+
percentage + |
+Integer + |
+Specifies the percentage of instances to be operated. + |
+
limits + |
+Integer + |
+Specifies the operation restrictions. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
metadata_bandwidth_share_type + |
+String + |
+Specifies the bandwidth sharing type in the bandwidth scaling policy. + |
+
metadata_eip_id + |
+String + |
+Specifies the EIP ID for the bandwidth in the bandwidth scaling policy. + |
+
metadata_eip_address + |
+String + |
+Specifies the EIP for the bandwidth in the bandwidth scaling policy. + |
+
{
+ "limit": 20,
+ "total_number": 3,
+ "start_number": 0,
+ "scaling_policies": [
+ {
+ "scaling_policy_id": "803a35a5-38fb-4d27-a042-496c14bc1fb8",
+ "scaling_policy_name": "as-policy-7a75",
+ "scaling_resource_id": "8ade64b5-d685-40b8-8582-4ce306ea37a6",
+ "scaling_resource_type": "SCALING_GROUP",
+ "scaling_policy_type": "RECURRENCE",
+ "scheduled_policy": {
+ "launch_time": "03:30",
+ "recurrence_type": "Daily",
+ "start_time": "2017-08-28T03:08Z",
+ "end_time": "2017-09-01T03:08Z"
+ },
+ "cool_down_time": 900,
+ "scaling_policy_action": {
+ "operation": "ADD",
+ "size": 1
+ },
+ "policy_status": "INSERVICE",
+ "create_time": "2017-08-31T03:02:41Z"
+ },
+ {
+ "scaling_policy_id": "535fd67e-276b-409c-879e-52f4e09e14bb",
+ "scaling_policy_name": "as-policy-7a75",
+ "scaling_resource_id": "8ade64b5-d685-40b8-8582-4ce306ea37a6",
+ "scaling_resource_type": "SCALING_GROUP",
+ "scaling_policy_type": "RECURRENCE",
+ "scheduled_policy": {
+ "launch_time": "21:30",
+ "recurrence_type": "Daily",
+ "start_time": "2017-08-27T21:08Z",
+ "end_time": "2017-08-31T21:08Z"
+ },
+ "cool_down_time": 900,
+ "scaling_policy_action": {
+ "operation": "ADD",
+ "size": 1
+ },
+ "policy_status": "INSERVICE",
+ "create_time": "2017-08-31T07:35:05Z"
+ },
+ {
+ "scaling_policy_id": "37df92f8-73cb-469e-a420-c15f445d2ee1",
+ "scaling_policy_name": "as-policy-7a75",
+ "scaling_resource_id": "8ade64b5-d685-40b8-8582-4ce306ea37a6",
+ "scaling_resource_type": "SCALING_GROUP",
+ "scaling_policy_type": "RECURRENCE",
+ "scheduled_policy": {
+ "launch_time": "22:30",
+ "recurrence_type": "Daily",
+ "start_time": "2017-08-27T22:08Z",
+ "end_time": "2017-08-31T22:08Z"
+ },
+ "cool_down_time": 900,
+ "scaling_policy_action": {
+ "operation": "ADD",
+ "size": 1
+ },
+ "policy_status": "INSERVICE",
+ "create_time": "2017-08-31T07:41:06Z"
+ }
+ ]
+}
+Returned Values + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query all AS policies for a tenant based on search criteria. The results are displayed by page.
+
The bandwidth scaling policy configured for a released EIP still occupies the quota of bandwidth scaling policy. The policy is only visible to the account and its IAM users with the global permissions.
+GET /autoscaling-api/v2/{project_id}/scaling_policy
+
You can type the question mark (?) and ampersand (&) at the end of the URI to define multiple search criteria. AS policies can be searched by all optional parameters in the following table. For details, see the example request.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_resource_id + |
+No + |
+String + |
+Specifies the scaling resource ID. + |
+
scaling_resource_type + |
+No + |
+String + |
+Specifies the scaling resource type. +
|
+
scaling_policy_name + |
+No + |
+String + |
+Specifies the AS policy name. +Supports fuzzy search. + |
+
scaling_policy_id + |
+No + |
+String + |
+Specifies the AS policy ID. + |
+
scaling_policy_type + |
+No + |
+String + |
+Specifies the AS policy type. +
|
+
start_number + |
+No + |
+Integer + |
+Specifies the start line number. The default value is 0. The minimum parameter value is 0. + |
+
limit + |
+No + |
+Integer + |
+Specifies the number of query records. The default value is 20. The value range is 0 to 100. + |
+
sort_by + |
+No + |
+String + |
+Specifies the sorting method. +
|
+
order + |
+No + |
+String + |
+Specifies the sorting order. +
|
+
enterprise_project_id + |
+No + |
+String + |
+Specifies the enterprise project ID. If all_granted_eps is transferred, this API will query AS groups in the enterprise projects that you have permissions to. + |
+
alarm_id + |
+No + |
+String + |
+Specifies the alarm rule ID. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
total_number + |
+Integer + |
+Specifies the total number of query records. + |
+
start_number + |
+Integer + |
+Specifies the start line number. + |
+
limit + |
+Integer + |
+Specifies the maximum number of resources to be queried. + |
+
scaling_policies + |
+Array of scaling_policies objects + |
+Specifies AS policies. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_policy_name + |
+String + |
+Specifies the AS policy name. + |
+
scaling_policy_id + |
+String + |
+Specifies the AS policy ID. + |
+
scaling_resource_id + |
+String + |
+Specifies the scaling resource ID. + |
+
scaling_resource_type + |
+String + |
+Specifies the scaling resource type. +
|
+
policy_status + |
+String + |
+Specifies the AS policy status. +
|
+
scaling_policy_type + |
+String + |
+Specifies the AS policy type. +
|
+
alarm_id + |
+String + |
+Specifies the alarm ID. + |
+
scheduled_policy + |
+scheduled_policy object + |
+Specifies the periodic or scheduled AS policy. For details, see Table 4. + |
+
scaling_policy_action + |
+scaling_policy_action object + |
+Specifies the scaling action of the AS policy. For details, see Table 5. + |
+
cool_down_time + |
+Integer + |
+Specifies the cooldown period (s). + |
+
create_time + |
+String + |
+Specifies the time when an AS policy was created. The time format complies with UTC. + |
+
meta_data + |
+meta_data object + |
+Provides additional information. For details, see Table 6. + |
+
description + |
+String + |
+Specifies the AS policy description. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
launch_time + |
+String + |
+Specifies the time when the scaling action is triggered. The time format complies with UTC. +
|
+
recurrence_type + |
+String + |
+Specifies the type of a periodically triggered scaling action. +
|
+
recurrence_value + |
+String + |
+Specifies the frequency at which scaling actions are triggered. +
|
+
start_time + |
+String + |
+Specifies the start time of the scaling action triggered periodically. The time format complies with UTC. +The time format is YYYY-MM-DDThh:mmZ. + |
+
end_time + |
+String + |
+Specifies the end time of the scaling action triggered periodically. The time format complies with UTC. +The time format is YYYY-MM-DDThh:mmZ. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
operation + |
+String + |
+Specifies the scaling action. +
|
+
size + |
+Integer + |
+Specifies the number of instances to be operated. + |
+
percentage + |
+Integer + |
+Specifies the percentage of instances to be operated. + |
+
limits + |
+Integer + |
+Specifies the operation restrictions. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
metadata_bandwidth_share_type + |
+String + |
+Specifies the bandwidth sharing type in the bandwidth scaling policy. + |
+
metadata_eip_id + |
+String + |
+Specifies the EIP ID for the bandwidth in the bandwidth scaling policy. + |
+
metadata_eip_address + |
+String + |
+Specifies the EIP for the bandwidth in the bandwidth scaling policy. + |
+
{
+ "limit": 20,
+ "total_number": 3,
+ "start_number": 0,
+ "scaling_policies": [
+ {
+ "scaling_policy_id": "803a35a5-38fb-4d27-a042-496c14bc1fb8",
+ "scaling_policy_name": "as-policy-7a75",
+ "scaling_resource_id": "8ade64b5-d685-40b8-8582-4ce306ea37a6",
+ "scaling_resource_type": "SCALING_GROUP",
+ "scaling_policy_type": "RECURRENCE",
+ "scheduled_policy": {
+ "launch_time": "03:30",
+ "recurrence_type": "Daily",
+ "start_time": "2017-08-28T03:08Z",
+ "end_time": "2017-09-01T03:08Z"
+ },
+ "cool_down_time": 900,
+ "scaling_policy_action": {
+ "operation": "ADD",
+ "size": 1
+ },
+ "policy_status": "INSERVICE",
+ "create_time": "2017-08-31T03:02:41Z"
+ },
+ {
+ "scaling_policy_id": "535fd67e-276b-409c-879e-52f4e09e14bb",
+ "scaling_policy_name": "as-policy-7a75",
+ "scaling_resource_id": "8ade64b5-d685-40b8-8582-4ce306ea37a6",
+ "scaling_resource_type": "SCALING_GROUP",
+ "scaling_policy_type": "RECURRENCE",
+ "scheduled_policy": {
+ "launch_time": "21:30",
+ "recurrence_type": "Daily",
+ "start_time": "2017-08-27T21:08Z",
+ "end_time": "2017-08-31T21:08Z"
+ },
+ "cool_down_time": 900,
+ "scaling_policy_action": {
+ "operation": "ADD",
+ "size": 1
+ },
+ "policy_status": "INSERVICE",
+ "create_time": "2017-08-31T07:35:05Z",
+"meta_data": {
+ "metadata_eip_id": "263f0886-de6a-4e21-ad83-814ca9f3844e",
+ "metadata_eip_address": "255.255.255.255"
+ }
+ },
+ {
+ "scaling_policy_id": "37df92f8-73cb-469e-a420-c15f445d2ee1",
+ "scaling_policy_name": "as-policy-7a75",
+ "scaling_resource_id": "8ade64b5-d685-40b8-8582-4ce306ea37a6",
+ "scaling_resource_type": "SCALING_GROUP",
+ "scaling_policy_type": "RECURRENCE",
+ "scheduled_policy": {
+ "launch_time": "22:30",
+ "recurrence_type": "Daily",
+ "start_time": "2017-08-27T22:08Z",
+ "end_time": "2017-08-31T22:08Z"
+ },
+ "cool_down_time": 900,
+ "scaling_policy_action": {
+ "operation": "ADD",
+ "size": 1
+ },
+ "policy_status": "INSERVICE",
+ "create_time": "2017-08-31T07:41:06Z",
+"meta_data": {
+ "metadata_eip_id": "263f0886-de6a-4e21-ad83-814ca9f3844e",
+ "metadata_eip_address": "255.255.255.255"
+ }
+ }
+ ]
+}
+Returned Values + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query details about a specified AS policy by policy ID.
+GET /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id}
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_policy_id + |
+Yes + |
+String + |
+Specifies the AS policy ID. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_policy + |
+scaling_policy object + |
+Specifies details about the AS policy. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_group_id + |
+String + |
+Specifies the AS group ID. + |
+
scaling_policy_name + |
+String + |
+Specifies the AS policy name. +Supports fuzzy search. + |
+
scaling_policy_id + |
+String + |
+Specifies the AS policy ID. + |
+
policy_status + |
+String + |
+Specifies the AS policy status. +
|
+
scaling_policy_type + |
+String + |
+Specifies the AS policy type. +
|
+
alarm_id + |
+String + |
+Specifies the alarm ID. + |
+
scheduled_policy + |
+scheduled_policy object + |
+Specifies the periodic or scheduled AS policy. For details, see Table 4. + |
+
scaling_policy_action + |
+scaling_policy_action object + |
+Specifies the scaling action of the AS policy. For details, see Table 5. + |
+
cool_down_time + |
+Integer + |
+Specifies the cooldown period (s). + |
+
create_time + |
+String + |
+Specifies the time when an AS policy was created. The time format complies with UTC. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
launch_time + |
+String + |
+Specifies the time when the scaling action is triggered. The time format complies with UTC. +
|
+
recurrence_type + |
+String + |
+Specifies the type of a periodically triggered scaling action. +
|
+
recurrence_value + |
+String + |
+Specifies the frequency at which scaling actions are triggered. +
|
+
start_time + |
+String + |
+Specifies the start time of the scaling action triggered periodically. The time format complies with UTC. +The time format is YYYY-MM-DDThh:mmZ. + |
+
end_time + |
+String + |
+Specifies the end time of the scaling action triggered periodically. The time format complies with UTC. +The time format is YYYY-MM-DDThh:mmZ. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
operation + |
+String + |
+Specifies the scaling action. +
|
+
instance_number + |
+Integer + |
+Specifies the number of instances to be operated. + |
+
instance_percentage + |
+Integer + |
+Specifies the percentage of instances to be operated. + |
+
{
+ "scaling_policy": {
+ "scaling_policy_id": "fd7d63ce-8f5c-443e-b9a0-bef9386b23b3",
+ "scaling_group_id": "e5d27f5c-dd76-4a61-b4bc-a67c5686719a",
+"scaling_policy_name": "Scheduled 1",
+ "scaling_policy_type": "SCHEDULED",
+ "scheduled_policy": {
+ "launch_time": "2015-07-24T01:21Z"
+ },
+ "cool_down_time": 300,
+ "scaling_policy_action": {
+ "operation": "REMOVE",
+ "instance_number": 1
+ },
+ "policy_status": "INSERVICE",
+ "create_time": "2015-07-24T01:09:30Z"
+ }
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query details about a specified AS policy by policy ID.
+The difference between the V2 and V1 APIs for querying details of an AS policy is that V2 contains scaling resource types in response messages.
+GET /autoscaling-api/v2/{project_id}/scaling_policy/{scaling_policy_id}
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_policy_id + |
+Yes + |
+String + |
+Specifies the AS policy ID. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_policy + |
+scaling_policy object + |
+Specifies details about the AS policy. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
scaling_resource_id + |
+String + |
+Specifies the scaling resource ID. + |
+
scaling_resource_type + |
+String + |
+Specifies the scaling resource type. +
|
+
scaling_policy_name + |
+String + |
+Specifies the AS policy name. +Supports fuzzy search. + |
+
scaling_policy_id + |
+String + |
+Specifies the AS policy ID. + |
+
policy_status + |
+String + |
+Specifies the AS policy status. +
|
+
scaling_policy_type + |
+String + |
+Specifies the AS policy type. +
|
+
alarm_id + |
+String + |
+Specifies the alarm ID. + |
+
scheduled_policy + |
+scheduled_policy object + |
+Specifies the periodic or scheduled AS policy. For details, see Table 4. + |
+
scaling_policy_action + |
+scaling_policy_action object + |
+Specifies the scaling action of the AS policy. For details, see Table 5. + |
+
cool_down_time + |
+Integer + |
+Specifies the cooldown period (s). + |
+
create_time + |
+String + |
+Specifies the time when an AS policy was created. The time format complies with UTC. + |
+
meta_data + |
+meta_data object + |
+Provides additional information. For details, see Table 6. + |
+
description + |
+String + |
+Specifies the AS policy description. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
launch_time + |
+String + |
+Specifies the time when the scaling action is triggered. The time format complies with UTC. +
|
+
recurrence_type + |
+String + |
+Specifies the type of a periodically triggered scaling action. +
|
+
recurrence_value + |
+String + |
+Specifies the frequency at which scaling actions are triggered. +
|
+
start_time + |
+String + |
+Specifies the start time of the scaling action triggered periodically. The time format complies with UTC. +The time format is YYYY-MM-DDThh:mmZ. + |
+
end_time + |
+String + |
+Specifies the end time of the scaling action triggered periodically. The time format complies with UTC. +The time format is YYYY-MM-DDThh:mmZ. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
operation + |
+String + |
+Specifies the scaling action. +
|
+
size + |
+Integer + |
+Specifies the operation size. + |
+
percentage + |
+Integer + |
+Specifies the percentage of instances to be operated. + |
+
limits + |
+Integer + |
+Specifies the operation restrictions. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
metadata_bandwidth_share_type + |
+String + |
+Specifies the bandwidth sharing type in the bandwidth scaling policy. + |
+
metadata_eip_id + |
+String + |
+Specifies the EIP ID for the bandwidth in the bandwidth scaling policy. + |
+
metadata_eip_address + |
+String + |
+Specifies the EIP for the bandwidth in the bandwidth scaling policy. + |
+
{
+ "scaling_policy": {
+ "scaling_policy_id": "906f73ff-56e8-41b2-a005-8157d0c60361",
+ "scaling_policy_name": "hth_aspolicy_1",
+ "scaling_resource_id": "8ade64b5-d685-40b8-8582-4ce306ea37a6",
+ "scaling_resource_type": "BANDWIDTH",
+ "scaling_policy_type": "ALARM",
+ "alarm_id": "al1513822380493GvlJKZwA8",
+ "scheduled_policy": {
+ },
+ "cool_down_time": 900,
+ "scaling_policy_action": {
+ "operation": "ADD",
+ "size": 1,
+ "limits": 111
+ },
+ "policy_status": "INSERVICE",
+ "create_time": "2018-03-21T08:03:35Z",
+ "meta_data": {
+ "metadata_eip_id": "263f0886-de6a-4e21-ad83-814ca9f3844e",
+ "metadata_eip_address": "255.255.255.255"
+ }
+ }
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This interface is used to immediately execute, enable, or disable a specified AS policy.
+An AS policy can be executed only when the AS group and AS policy are in the INSERVICE state. Otherwise, the execution fails.
+POST /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id}/action
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_policy_id + |
+Yes + |
+String + |
+Specifies the AS policy ID. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
action + |
+Yes + |
+String + |
+Specifies the operation for an AS policy. +
|
+
Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This interface is used to delete a specified AS policy.
+DELETE /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id}
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_policy_id + |
+Yes + |
+String + |
+Specifies the AS policy ID. + |
+
Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This interface is used to enable, disable, or delete AS policies in batches.
+POST /autoscaling-api/v1/{project_id}/scaling_policies/action
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
scaling_policy_id + |
+Yes + |
+Array of strings + |
+Specifies the AS policy ID. + |
+
action + |
+Yes + |
+String + |
+Specifies an action to be performed on AS policies in batches. The options are as follows: +
|
+
force_delete + |
+No + |
+String + |
+Specifies whether to forcibly delete an AS policy. If the value is set to no, in-progress AS policies cannot be deleted. Options: +
This parameter is available only when action is set to delete. + |
+
delete_alarm + |
+No + |
+String + |
+Specifies whether to delete the alarm rule used by the alarm policy. The value can be yes or no (default). +This parameter is available only when action is set to delete. + |
+
This example shows how to enable the AS policies with IDs policy_id1 and policy_id2 in a batch.
+POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_policies/action
+
+{
+ "action": "resume",
+ "scaling_policy_id": [
+ "policy_id1",
+ "policy_id2"
+ ]
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query the historical records of AS policy execution based on search criteria. The results are displayed by page.
+GET /autoscaling-api/v1/{project_id}/scaling_policy_execute_log/{scaling_policy_id}
+
You can type the question mark (?) and ampersand (&) at the end of the URI to define multiple search criteria. AS policy execution logs can be searched by all optional parameters in the following table. For details, see the example request.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_policy_id + |
+Yes + |
+String + |
+Specifies the AS policy ID. + |
+
log_id + |
+No + |
+String + |
+Specifies the ID of an AS policy execution log. + |
+
scaling_resource_type + |
+No + |
+String + |
+Specifies the scaling resource type. +
|
+
scaling_resource_id + |
+No + |
+String + |
+Specifies the scaling resource ID. + |
+
execute_type + |
+No + |
+String + |
+Specifies the AS policy execution type. +
|
+
start_time + |
+No + |
+String + |
+Specifies the start time that complies with UTC for querying AS policy execution logs. The format of the start time is yyyy-MM-ddThh:mm:ssZ. + |
+
end_time + |
+No + |
+String + |
+Specifies the end time that complies with UTC for querying AS policy execution logs. The format of the end time is yyyy-MM-ddThh:mm:ssZ. + |
+
start_number + |
+No + |
+Integer + |
+Specifies the start line number. The default value is 0. The minimum parameter value is 0. + |
+
limit + |
+No + |
+Integer + |
+Specifies the number of query records. The default value is 20. The value range is 0 to 100. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
total_number + |
+Integer + |
+Specifies the total number of query records. + |
+
start_number + |
+Integer + |
+Specifies the start line number. + |
+
limit + |
+Integer + |
+Specifies the maximum number of resources to be queried. + |
+
scaling_policy_execute_log + |
+Array of scaling_policy_execute_log objects + |
+Specifies the AS policy execution logs. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+String + |
+Specifies the AS policy execution status. +
|
+
failed_reason + |
+String + |
+Specifies the AS policy execution failure. + |
+
execute_type + |
+String + |
+Specifies the AS policy execution type. +
|
+
execute_time + |
+String + |
+Specifies the time when an AS policy was executed. The time format complies with UTC. + |
+
id + |
+String + |
+Specifies the ID of an AS policy execution log. + |
+
tenant_id + |
+String + |
+Specifies the project ID. + |
+
scaling_policy_id + |
+String + |
+Specifies the AS policy ID. + |
+
scaling_resource_type + |
+String + |
+Specifies the scaling resource type. +
|
+
scaling_resource_id + |
+String + |
+Specifies the scaling resource ID. + |
+
old_value + |
+String + |
+Specifies the source value. + |
+
desire_value + |
+String + |
+Specifies the target value. + |
+
limit_value + |
+String + |
+Specifies the operation restrictions. +If scaling_resource_type is set to BANDWIDTH and operation is not SET, this parameter takes effect and the unit is Mbit/s. +In this case: +
|
+
type + |
+String + |
+Specifies the AS policy execution type. +
|
+
job_records + |
+Array of job_records objects + |
+Specifies the tasks contained in a scaling action based on an AS policy. For details, see Table 4. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
job_name + |
+String + |
+Specifies the task name. + |
+
record_type + |
+String + |
+Specifies the record type. +
|
+
record_time + |
+String + |
+Specifies the record time. + |
+
request + |
+String + |
+Specifies the request body. This parameter is valid only if record_type is set to API. + |
+
response + |
+String + |
+Specifies the response body. This parameter is valid only if record_type is set to API. + |
+
code + |
+String + |
+Specifies the returned code. This parameter is valid only if record_type is set to API. + |
+
message + |
+String + |
+Specifies the message. This parameter is valid only if record_type is set to MEG. + |
+
job_status + |
+String + |
+Specifies the execution status of the task. +
|
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
metadata_bandwidth_share_type + |
+String + |
+Specifies the bandwidth sharing type in the bandwidth scaling policy. + |
+
metadata_eip_id + |
+String + |
+Specifies the EIP ID for the bandwidth in the bandwidth scaling policy. + |
+
metadataeip_address + |
+String + |
+Specifies the EIP for the bandwidth in the bandwidth scaling policy. + |
+
{
+ "limit": 20,
+ "scaling_policy_execute_log": [
+ {
+ "id": "b86e4175-30cb-4b1e-a332-83f9ee472c58",
+ "status": "SUCCESS",
+ "type": "REMOVE",
+ "tenant_id": "0428982a1b8039f42f01c005edde7c0d",
+ "scaling_resource_type": "SCALING_GROUP",
+ "scaling_resource_id": "1f2d3e73-7ef6-40b3-a8fa-514b68eccaa7",
+ "scaling_policy_id": "05545d3d-ccf9-4bca-ae4f-1e5e73ca0bf6",
+ "old_value": "1",
+ "desire_value": "0",
+ "limit_value": "0",
+ "execute_time": "2019-03-18T16:00:00Z",
+ "execute_type": "RECURRENCE",
+ "job_records": [
+ {
+ "message": "modify desire number of scaling group",
+ "job_name": "ADJUST_VM_NUMBERS",
+ "record_type": "MEG",
+ "record_time": "2019-03-18T16:00:00Z",
+ "job_status": "SUCCESS"
+ }
+ ]
+ }
+ ],
+ "total_number": 1,
+ "start_number": 0
+}
+Returned Values + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query scaling action logs based on search criteria. The results are displayed by page.
+GET /autoscaling-api/v1/{project_id}/scaling_activity_log/{scaling_group_id}
+
You can type the question mark (?) and ampersand (&) at the end of the URI to define multiple search criteria. Scaling action logs can be searched by all optional parameters in the following table. For details, see the example request.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_group_id + |
+Yes + |
+String + |
+Specifies the AS group ID. + |
+
start_time + |
+No + |
+String + |
+Specifies the start time that complies with UTC for querying scaling action logs. The format of the start time is yyyy-MM-ddThh:mm:ssZ. + |
+
end_time + |
+No + |
+String + |
+Specifies the end time that complies with UTC for querying scaling action logs. The format of the end time is yyyy-MM-ddThh:mm:ssZ. + |
+
start_number + |
+No + |
+Integer + |
+Specifies the start line number. The default value is 0. The minimum parameter value is 0. + |
+
limit + |
+No + |
+Integer + |
+Specifies the number of query records. The default value is 20. The value range is 0 to 100. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
total_number + |
+Integer + |
+Specifies the total number of query records. + |
+
start_number + |
+Integer + |
+Specifies the start line number. + |
+
limit + |
+Integer + |
+Specifies the maximum number of resources to be queried. + |
+
scaling_activity_log + |
+Array of scaling_activity_log objects + |
+Specifies scaling action logs. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+String + |
+Specifies the status of the scaling action. +
|
+
start_time + |
+String + |
+Specifies the start time of the scaling action. The time format must comply with UTC. + |
+
end_time + |
+String + |
+Specifies the end time of the scaling action. The time format must comply with UTC. + |
+
id + |
+String + |
+Specifies the scaling action log ID. + |
+
instance_removed_list + |
+String + |
+Specifies the names of the instances removed from the AS group after the scaling action is complete. The instance names are separated using commas (,). + |
+
instance_deleted_list + |
+String + |
+Specifies the names of the instances removed and deleted from the AS group after the scaling action is complete. The instance names are separated using commas (,). + |
+
instance_added_list + |
+String + |
+Specifies the names of the instances added to the AS group after the scaling action is complete. The instance names are separated using commas (,). + |
+
scaling_value + |
+String + |
+Specifies the number of added or removed instances in the scaling action. + |
+
description + |
+String + |
+Specifies the description of the scaling action. + |
+
instance_value + |
+Integer + |
+Specifies the number of instances in the AS group. + |
+
desire_value + |
+Integer + |
+Specifies the expected number of instances for the scaling action. + |
+
{
+ "limit": 20,
+ "scaling_activity_log": [
+ {
+ "id": "66e0f775-c4ac-4b52-9d5c-f93ba217aa5f",
+ "instance_value": 1,
+ "desire_value": 0,
+ "scaling_value": 1,
+ "start_time": "2019-03-18T16:00:11Z",
+ "end_time": "2019-03-18T16:00:32Z",
+ "instance_added_list": null,
+ "instance_deleted_list": "as-config-bblh-ONQE551S",
+ "instance_removed_list": null,
+ "status": "SUCCESS",
+ "description": "{\"reason\":[{\"change_reason\":\"RECURRENCE\",\"old_value\":1,\"scaling_policy_name\":\"as-policy-bvfk\",\"change_time\":\"2019-03-18T16:00:00Z\",\"new_value\":0,\"scaling_policy_id\":\"05545d3d-ccf9-4bca-ae4f-1e5e73ca0bf6\"}]}"
+ },
+ {
+ "id": "c3a1fff6-84a3-4cbc-8ac0-e3b0f645ecd8",
+ "instance_value": 0,
+ "desire_value": 1,
+ "scaling_value": 1,
+ "start_time": "2019-03-16T10:21:11Z",
+ "end_time": "2019-03-16T10:25:12Z",
+ "instance_added_list": "as-config-bblh-ONQE551S",
+ "instance_deleted_list": null,
+ "instance_removed_list": null,
+ "status": "SUCCESS",
+ "description": "{\"reason\":[{\"change_reason\":\"DIFF\",\"old_value\":0,\"change_time\":\"2019-03-16T10:21:11Z\",\"new_value\":1}]}"
+ },
+ "total_number": 2,
+ "start_number": 0
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query scaling action logs based on search criteria. The scaling actions include increasing instances and migrating instances to balance load. The results are displayed by page.
+GET /autoscaling-api/v2/{project_id}/scaling_activity_log/{scaling_group_id}
+
You can type the question mark (?) and ampersand (&) at the end of the URI to define multiple search criteria. Scaling action logs can be searched by all optional parameters in the following table. For details, see the example request.
+Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_group_id + |
+Yes + |
+String + |
+Specifies the AS group ID. + |
+
log_id + |
+No + |
+String + |
+Specifies the scaling action log ID. + |
+
start_time + |
+No + |
+String + |
+Specifies the start time that complies with UTC for querying scaling action logs. The format of the start time is yyyy-MM-ddThh:mm:ssZ. + |
+
end_time + |
+No + |
+String + |
+Specifies the end time that complies with UTC for querying scaling action logs. The format of the end time is yyyy-MM-ddThh:mm:ssZ. + |
+
start_number + |
+No + |
+Integer + |
+Specifies the start line number. The default value is 0. The minimum parameter value is 0. + |
+
limit + |
+No + |
+Integer + |
+Specifies the number of query records. The default value is 20. The value range is 0 to 100. + |
+
type + |
+No + |
+String + |
+Specifies the types of the scaling actions to be queried. Different types are separated by commas (,). +
|
+
status + |
+No + |
+String + |
+Specifies the status of the scaling action. +
|
+
This example shows how to query the scaling action logs of the AS group with ID e5d27f5c-dd76-4a61-b4bc-a67c5686719a. The start time is 2018-11-22T00:00:00Z, and the end time is 2018-11-22T14:00:00Z.
+GET https://{Endpoint}/autoscaling-api/v2/{project_id}/scaling_activity_log/e5d27f5c-dd76-4a61-b4bc-a67c5686719a?start_time=2018-11-22T00:00:00Z&end_time=2018-11-22T14:00:00Z
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
total_number + |
+Integer + |
+Specifies the total number of query records. + |
+
start_number + |
+Integer + |
+Specifies the start line number. + |
+
limit + |
+Integer + |
+Specifies the maximum number of resources to be queried. + |
+
scaling_activity_log + |
+Array of scaling_activity_log objects + |
+Specifies scaling action logs. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
status + |
+String + |
+Specifies the status of the scaling action. +
|
+
start_time + |
+String + |
+Specifies the start time of the scaling action. The time format must comply with UTC. + |
+
end_time + |
+String + |
+Specifies the end time of the scaling action. The time format must comply with UTC. + |
+
id + |
+String + |
+Specifies the scaling action log ID. + |
+
instance_removed_list + |
+Array of scaling_instance objects + |
+Specifies names of the ECSs that are removed from the AS group in a scaling action. For details, see Table 4. + |
+
instance_deleted_list + |
+Array of scaling_instance objects + |
+Specifies names of the ECSs that are removed from the AS group and deleted in a scaling action. For details, see Table 4. + |
+
instance_added_list + |
+Array of scaling_instance objects + |
+Specifies names of the ECSs that are added to the AS group in a scaling action. For details, see Table 4. + |
+
instance_failed_list + |
+Array of scaling_instance objects + |
+Specifies the ECSs for which a scaling action fails. For details, see Table 4. + |
+
instance_standby_list + |
+Array of scaling_instance objects + |
+Specifies the ECSs that are set to standby mode or for which standby mode is canceled in a scaling action. For details, see Table 4. This parameter is reserved. + |
+
scaling_value + |
+String + |
+Specifies the number of added or deleted instances during the scaling. + |
+
description + |
+String + |
+Specifies the description of the scaling action. + |
+
instance_value + |
+Integer + |
+Specifies the number of instances in the AS group. + |
+
desire_value + |
+Integer + |
+Specifies the expected number of instances for the scaling action. + |
+
lb_bind_success_list + |
+Array of modify_lb objects + |
+Specifies the load balancers that are bound to the AS group. For details, see Table 5. + |
+
lb_bind_failed_list + |
+Array of modify_lb objects + |
+Specifies the load balancers that failed to be bound to the AS group. For details, see Table 5. + |
+
lb_unbind_success_list + |
+Array of modify_lb objects + |
+Specifies the load balancers that are unbound from the AS group. For details, see Table 5. + |
+
lb_unbind_failed_list + |
+Array of modify_lb objects + |
+Specifies the load balancers that failed to be unbound from the AS group. For details, see Table 5. + |
+
type + |
+String + |
+Specifies the type of the scaling action. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
instance_name + |
+String + |
+Specifies the ECS name. + |
+
instance_id + |
+String + |
+Specifies the ECS ID. + |
+
failed_reason + |
+String + |
+Specifies the cause of the instance scaling failure. + |
+
failed_details + |
+String + |
+Specifies details of the instance scaling failure. + |
+
instance_config + |
+String + |
+Specifies the information about instance configurations. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
lbaas_listener + |
+lbaas_listener object + |
+Specifies information about an enhanced load balancer. For details, see Table 6. + |
+
listener + |
+String + |
+Specifies information about a classic load balancer. + |
+
failed_reason + |
+String + |
+Specifies the cause of a load balancer migration failure. + |
+
failed_details + |
+String + |
+Specifies the details of a load balancer migration failure. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
listener_id + |
+String + |
+Specifies the listener ID. + |
+
pool_id + |
+String + |
+Specifies the backend ECS group ID. + |
+
protocol_port + |
+Integer + |
+Specifies the backend protocol port, which is the port on which a backend ECS listens for traffic. + |
+
weight + |
+Integer + |
+Specifies the weight, which determines the portion of requests a backend ECS processes when being compared to other backend ECSs added to the same listener. + |
+
{
+ "limit": 20,
+ "scaling_activity_log": [
+ {
+ "id": "8753a18c-931d-4cb8-8d49-6c99396af348",
+ "instance_value": 0,
+ "desire_value": 0,
+ "scaling_value": 0,
+ "start_time": "2018-11-22T13:46:20Z",
+ "end_time": "2018-11-22T13:47:38Z",
+ "status": "SUCCESS",
+ "lb_bind_success_list": [
+ {
+ "lbaas_listener": {
+ "weight": 1,
+ "listener_id": null,
+ "pool_id": "0f0a9dd8-2e1d-4432-8ca2-49adc75aa662",
+ "protocol_port": 82
+ }
+ }
+ ],
+ "lb_bind_failed_list": [],
+ "lb_unbind_success_list": [],
+ "lb_unbind_failed_list": [],
+ "type": "MODIFY_ELB"
+ },
+ {
+ "id": "44152cf2-a005-4507-b6e9-66a2a64eff52",
+ "instance_value": 0,
+ "desire_value": 1,
+ "scaling_value": 1,
+ "start_time": "2018-11-22T13:44:22Z",
+ "end_time": "2018-11-22T13:46:02Z",
+ "instance_added_list": [
+ {
+ "instance_id": "8e273bac-d303-46dc-9883-628be2294bdf",
+ "instance_name": "as-config-t66a_9W8L9SSK"
+ }
+ ],
+ "instance_deleted_list": [],
+ "instance_removed_list": [],
+ "instance_failed_list": [],
+ "status": "SUCCESS",
+ "description": "{\"reason\":[{\"change_reason\":\"MANNUAL\",\"old_value\":0,\"change_time\":\"2018-11-22T13:44:19Z\",\"new_value\":1}]}",
+ "type": "NORMAL"
+ }
+],
+ "total_number": 2,
+ "start_number": 0
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query the total quotas and used quotas of AS groups, AS configurations, bandwidth scaling policies, AS policies, and instances for a specified tenant.
+GET /autoscaling-api/v1/{project_id}/quotas
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
quotas + |
+quotas object + |
+Specifies quota details. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
resources + |
+Array of resources objects + |
+Specifies resources. For details, see Table 4. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
type + |
+String + |
+Specifies the quota type. +
|
+
used + |
+Integer + |
+Specifies the used amount of the quota. +When type is set to scaling_Policy or scaling_Instance, this parameter is reserved, and the system returns -1 as the parameter value. You can query the used quota of AS policies and AS instances in a specified AS group. For details, see Querying AS policy and instance quotas. + |
+
quota + |
+Integer + |
+Specifies the total quota. + |
+
max + |
+Integer + |
+Specifies the quota upper limit. + |
+
{
+ "quotas": {
+ "resources": [
+ {
+ "type": "scaling_Group",
+ "used": 2,
+ "quota": 25,
+ "max": 50
+ },
+ {
+ "type": "scaling_Config",
+ "used": 3,
+ "quota": 100,
+ "max": 200
+ },
+ {
+ "type": "scaling_Policy",
+ "used": -1,
+ "quota": 50,
+ "max": 50
+ },
+ {
+ "type": "scaling_Instance",
+ "used": -1,
+ "quota": 200,
+ "max": 1000
+ },
+ {
+ "type": "bandwidth_scaling_policy",
+ "used": 1,
+ "quota": 10,
+ "max": 100
+ }
+ ]
+ }
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This interface is used to query the total quotas and used quotas of AS policies and instances of a specified AS group by group ID.
+GET /autoscaling-api/v1/{project_id}/quotas/{scaling_group_id}
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
scaling_group_id + |
+Yes + |
+String + |
+Specifies the AS group ID. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
quotas + |
+quotas object + |
+Specifies quota details. For details, see Table 3. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
resources + |
+Array of resources objects + |
+Specifies resources. For details, see Table 4. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
type + |
+String + |
+Specifies the quota type. +
|
+
used + |
+Integer + |
+Specifies the used quota. + |
+
quota + |
+Integer + |
+Specifies the total quota. + |
+
max + |
+Integer + |
+Specifies the quota upper limit. + |
+
{
+ "quotas": {
+ "resources": [
+ {
+ "type": "scaling_Policy",
+ "used": 2,
+ "quota": 50,
+ "max": 50
+ },
+ {
+ "type": "scaling_Instance",
+ "used": 0,
+ "quota": 200,
+ "max": 1000
+ }
+ ]
+ }
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query tags by project ID.
+GET /autoscaling-api/v1/{project_id}/{resource_type}/tags
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
resource_type + |
+Yes + |
+String + |
+Specifies the resource type. The option is as follows: +scaling_group_tag: indicates that the resource type is an AS group. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
tags + |
+Array of tags objects + |
+Specifies the resource tag. + |
+
{
+ "tags": [
+ {
+ "key": "ENV15",
+ "values": [
+ "ENV15"
+ ]
+ },
+ {
+ "key": "111",
+ "values": [
+ ""
+ ]
+ },
+ {
+ "key": "environment",
+ "values": [
+ "DEV"
+ ]
+ },
+ {
+ "key": "ENV151",
+ "values": [
+ "ENV151"
+ ]
+ },
+ {
+ "key": "ENV152",
+ "values": [
+ "ENV152"
+ ]
+ }
+ ]
+ }
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 an internal service error occurred. + |
+
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 system is currently unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This interface is used to query tags of a specified resource by project ID and resource ID.
+GET /autoscaling-api/v1/{project_id}/{resource_type}/{resource_id}/tags
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
resource_type + |
+Yes + |
+String + |
+Specifies the resource type. The option is as follows: +scaling_group_tag: indicates that the resource type is an AS group. + |
+
resource_id + |
+Yes + |
+String + |
+Specifies the resource ID. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
tags + |
+Array of ResourceTag objects + |
+Specifies resource tags. For details, see Table 3. + |
+
sys_tags + |
+Array of ResourceTag objects + |
+Specifies system resource tags. For details, see Table 3. + |
+
{
+ "tags": [
+ {
+ "key": "ENV15",
+ "value": "ENV15"
+ },
+ {
+ "key": "ENV151",
+ "value": "ENV151"
+ },
+ {
+ "key": "ENV152",
+ "value": "ENV152"
+ }
+ ],
+ "sys_tags": null
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 an internal service error occurred. + |
+
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 system is currently unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to create or delete a resource tag.
+Each AS group can have a maximum of 10 tags added to it.
+POST /autoscaling-api/v1/{project_id}/{resource_type}/{resource_id}/tags/action
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
resource_type + |
+Yes + |
+String + |
+Specifies the resource type. The option is as follows: +scaling_group_tag: indicates that the resource type is an AS group. + |
+
resource_id + |
+Yes + |
+String + |
+Resource ID + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
tags + |
+Yes + |
+Array of ResourceTag objects + |
+Specifies the tag list. For details, see Table 3. +If action is set to delete, the tag structure cannot be missing, and the key cannot be left blank or an empty string. + |
+
action + |
+Yes + |
+String + |
+Operation ID (case sensitive) +
|
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Specifies the resource tag key. Tag keys of a resource must be unique. +
|
+
value + |
+No + |
+String + |
+Specifies the resource tag value. +
|
+
This example shows how to create two resource tags (key = ENV15 and value = ENV15) and (key = ENV151 and value = ENV151) in the AS group with ID e5d27f5c-dd76-4a61-b4bc-a67c5686719a.
+POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_tag/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/tags/action
+
+{
+ "tags": [
+ {
+ "key": "ENV15",
+ "value": "ENV15"
+ },
+ {
+ "key": "ENV151",
+ "value": "ENV151"
+ }
+ ],
+ "action": "create"
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 an internal service error occurred. + |
+
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 system is currently unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This API is used to query instances of a specified resource type by project ID.
+By default, resources and resource tags are in descending order of their creation time.
+POST /autoscaling-api/v1/{project_id}/{resource_type}/resource_instances/action
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
project_id + |
+Yes + |
+String + |
+Specifies the project ID. + |
+
resource_type + |
+Yes + |
+String + |
+Specifies the resource type. An example value is scaling_group_tag. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
tags + |
+No + |
+Array of Tag objects + |
+Specifies filter criteria with tags included. A maximum of 10 keys can be contained. The structure body must be complete. For details, see Table 3. + |
+
tags_any + |
+No + |
+Array of Tag objects + |
+Specifies filter criteria with any tag included. A maximum of 10 keys can be contained. For details, see Table 3. + |
+
not_tags + |
+No + |
+Array of Tag objects + |
+Specifies filter criteria without tags included. A maximum of 10 keys can be contained. For details, see Table 3. + |
+
not_tags_any + |
+No + |
+Array of Tag objects + |
+Specifies filter criteria without any tag included. A maximum of 10 keys can be contained. For details, see Table 3. + |
+
limit + |
+No + |
+String + |
+Specifies the maximum number of query records. The maximum value is 1000, and the minimum value is 1. +
|
+
marker + |
+No + |
+String + |
+Marks the paging location (index position). You are advised to use the offset parameter to set the index position. +Marks the paging location (resource ID or index location). + |
+
action + |
+Yes + |
+String + |
+Specifies the operation, which can be filter or count. +
|
+
offset + |
+No + |
+String + |
+Specifies the index position. The query starts from the next image indexed by this parameter. The value must be a non-negative number. +You do not need to specify this parameter when querying resources on the first page. When you query resources on subsequent pages, set the value of offset to the location returned in the response body for the previous query. +
|
+
matches + |
+No + |
+Array of match objects + |
+Specifies fuzzy search. For details, see Table 4. + |
+
without_any_tag + |
+Yes + |
+Boolean + |
+If this parameter is set to true, all resources without tags are queried. In this case, the tags, tags_any, not_tags, and not_tags_any fields are ignored. + |
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Specifies the resource tag key. It contains a maximum of 127 Unicode characters. It cannot be left blank (This parameter is not verified in the search process.) A maximum of 10 keys are allowed and the key cannot be left blank or an empty string. Each key must be unique. + |
+
values + |
+Yes + |
+Array of strings + |
+Specifies resource tag values. A value contains a maximum of 255 Unicode characters. A key contains a maximum of 10 values. Each value of the same key must be unique. +
|
+
Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
key + |
+Yes + |
+String + |
+Specifies the key parameter to be matched. +The parameter value can only be resource_name. + |
+
value + |
+Yes + |
+String + |
+Specifies the value. The value is a fixed dictionary value. A value contains a maximum of 255 Unicode characters. If the value is an empty string or resource_id, exact match is used. + |
+
This example shows how to query AS group resources of a tenant using the following search criteria: including tag (key = key1 and value = value), excluding tag (key = key2 and value = value2), index position 100, and maximum number of records 100.
+POST https: //{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_tag/resource_instances/action
+
+{
+ "offset": "100",
+ "limit": "100",
+ "action": "filter",
+ "matches": [{
+ "key": "resource_name",
+ "value": "resource1"
+ }],
+ "not_tags": [{
+ "key": "key2",
+ "values": ["value2"]
+ }],
+ "tags": [{
+ "key": "key1",
+ "values": ["value1"]
+ }]
+}
+POST https: //{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_tag/resource_instances/action
+
+{
+ "action": "count",
+ "not_tags": [{
+ "key": "key2",
+ "values": ["value2"]
+ }],
+ "tags": [{
+ "key": "key1",
+ "values": ["value1"]
+ },
+ {
+ "key": "key2",
+ "values": ["value1",
+ "value2"]
+ }],
+ "matches": [{
+ "key": "resource_name",
+ "value": "resource1"
+ }]
+}
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
resources + |
+Array of Resource objects + |
+Specifies tag resources. For details, see Table 6. + |
+
total_count + |
+Integer + |
+Specifies the total number of records. When action is set to count, only this parameter is returned. The values of resources and marker are not returned. + |
+
marker + |
+String + |
+Specifies the paging location identifier. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
resource_id + |
+String + |
+Specifies the resource ID. + |
+
resource_detail + |
+String + |
+Specifies the resource details. + |
+
tags + |
+Array of ResourceTag objects + |
+Specifies tags. If there is no tag, tags is taken as an empty array by default. For details, see Table 7. + |
+
resource_name + |
+String + |
+Specifies the resource name. If there is no resource, this parameter is an empty string by default. + |
+
{
+ "resources": [{
+ "resource_id": "64af4b6f-ec51-4436-8004-7a8f30080c87",
+ "resource_detail": "SCALING_GROUP_TAG",
+ "tags": [{
+ "key": "key1","value": "value1"
+ }],
+ "resource_name": "as_scaling_group_1"
+ },
+ {
+ "resource_id": "7122ef51-604b-40e7-b9b2-1de4cd78dc60",
+ "resource_detail": "SCALING_GROUP_TAG",
+ "tags": [{
+ "key": "key1","value": "value1"
+ }],
+ "resource_name": "as_scaling_group_2"
+ },
+ "marker": "2",
+ "total_count": 2
+}
+{
+ "total_count": 1000
+}
+Returned Values + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This interface is used to query all API versions of the AS service.
+GET /
+Parameter + |
+Type + |
+Description + |
+
|---|---|---|
versions + |
+Array of versions objects + |
+Specifies the API versions. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the API version ID. + |
+
links + |
+Array of links objects + |
+Specifies the API URL. For details, see Table 3. + |
+
min_version + |
+String + |
+Specifies the earliest supported API version number. + |
+
status + |
+String + |
+Specifies the API version status. +
|
+
updated + |
+String + |
+Specifies the release date of an API version. + |
+
version + |
+String + |
+Specifies the latest supported API version number. + |
+
{
+ "versions": [
+ {
+ "id": "v1",
+ "links": [
+ {
+ "href": "https://as.XXX.mycloud.com/autoscaling-api/v1/",
+ "rel": "self"
+ }
+ ],
+ "min_version": "",
+ "status": "CURRENT",
+ "updated": "2016-06-30T00:00:00Z",
+ "version": ""
+ },
+ {
+ "id": "v2",
+ "links": [
+ {
+ "href": "https://as.XXX.mycloud.com/autoscaling-api/v2/",
+ "rel": "self"
+ }
+ ],
+ "min_version": "",
+ "status": "SUPPORTED",
+ "updated": "2018-03-30T00:00:00Z",
+ "version": ""
+ }
+ ]
+}
+
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This interface is used to query a specified API version of the AS service.
+GET /{api_version}
+ +Parameter + |
+Mandatory + |
+Type + |
+Description + |
+
|---|---|---|---|
api_version + |
+Yes + |
+String + |
+Specifies the ID of the AS API version. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
version + |
+version object + |
+Specifies a specified API version. + |
+
Parameter + |
+Type + |
+Description + |
+
|---|---|---|
id + |
+String + |
+Specifies the API version ID. + |
+
links + |
+Array of links objects + |
+Specifies the API URL. For details, see Table 4. + |
+
min_version + |
+String + |
+Specifies the earliest supported API version number. + |
+
status + |
+String + |
+Specifies the API version status. +
|
+
updated + |
+String + |
+Specifies the release date of an API version. + |
+
version + |
+String + |
+Specifies the latest supported API version number. + |
+
{
+ "version": {
+ "id": "v1",
+ "links": [
+ {
+ "href": "https://as.XXX.mycloud.com/autoscaling-api/v1/",
+ "rel": "self"
+ }
+ ],
+ "min_version": "",
+ "status": "CURRENT",
+ "updated": "2016-06-30T00:00:00Z",
+ "version": ""
+ }
+}
+Returned Value + |
+Description + |
+
|---|---|
400 Bad Request + |
+The server failed to process the request. + |
+
401 Unauthorized + |
+You must enter the 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 request is invalid. + |
+
503 Service Unavailable + |
+Failed to complete the request because the system is unavailable. + |
+
504 Gateway Timeout + |
+A gateway timeout error occurred. + |
+
See Error Codes.
+This section describes metrics reported by AS to Cloud Eye as well as their namespaces and dimensions. You can use APIs provided by Cloud Eye to view the AS metrics and the alarms generated by Cloud Eye for AS.
+SYS.AS
+Metric + |
+Name + |
+Description + |
+Value Range + |
+Remarks + |
+
|---|---|---|---|---|
cpu_util + |
+CPU Usage + |
+Average CPU usage of all instances in a monitored object + |
+≥ 0% + |
+The monitored object is an AS group. + |
+
mem_util + |
+Memory Usage + |
+Average memory usage of all instances in a monitored object + |
+≥ 0% + |
+The monitored object is an AS group. + NOTE:
+This metric is unavailable if the image has no OTC Tools installed. + |
+
network_incoming_bytes_rate_inband + |
+Inband Incoming Rate + |
+Average number of incoming bytes per second on all instances in a monitored object + |
+≥ 0 + |
+The monitored object is an AS group. + |
+
network_outgoing_bytes_rate_inband + |
+Inband Outgoing Rate + |
+Average number of outgoing bytes per second on all instances in a monitored object + |
+≥ 0 + |
+The monitored object is an AS group. + |
+
instance_num + |
+Number of Instances + |
+Number of available instances in a monitored object + |
+≥ 0 + |
+The monitored object is an AS group. +Available ECSs are INSERVICE instances in an AS group. + |
+
disk_read_bytes_rate + |
+Disks Read Rate + |
+Number of bytes read from all instances in a monitored object per second + |
+≥ 0 + |
+The monitored object is an AS group. + |
+
disk_write_bytes_rate + |
+Disks Write Rate + |
+Number of bytes written to all instances in a monitored object per second + |
+≥ 0 + |
+The monitored object is an AS group. + |
+
disk_read_requests_rate + |
+Disk Read Requests + |
+Number of read requests sent to all instances in a monitored object per second + |
+≥ 0 + |
+The monitored object is an AS group. + |
+
disk_write_requests_rate + |
+Disks Write Requests + |
+Number of write requests sent to all instances in a monitored object per second + |
+≥ 0 + |
+The monitored object is an AS group. + |
+
Key + |
+Value + |
+
|---|---|
AutoScalingGroup + |
+AS group ID + |
+
This section provides the meanings of error codes returned by AS APIs.
+{"error":{"code":"AS.0001","message":"System error."}}
+HTTP Status Code + |
+Error Code + |
+Error Message + |
+Description + |
+Solution + |
+
|---|---|---|---|---|
500 + |
+AS.0001 + |
+System error. + |
+System error. + |
+Try again later or contact technical support. + |
+
400 + |
+AS.0002 + |
+Request body is null. + |
+The message body is empty. + |
+Enter a valid message body. + |
+
401 + |
+AS.0005 + |
+The token of the header in the request is null. + |
+The header in the request carries no or an empty token. + |
+Enter a valid token. + |
+
401 + |
+AS.0006 + |
+The token of the header in the request is incorrect. + |
+The header in the request carries an incorrect, invalid, or expired token. + |
+Enter a valid token. + |
+
404 + |
+AS.0007 + |
+The requested resource [%s] could not be found. + |
+The requested resources are not found. + |
+Use the correct URL parameter. + |
+
400 + |
+AS.0008 + |
+Incorrect ProjectID. + |
+The project id value carried in the URL is different from that resolved from the token. + |
+Check whether the parameter in the URL matches that in the token. + |
+
403 + |
+AS.0011 + |
+You do not have the rights to perform the operation. + |
+You do not have the rights to perform the operation. + |
+Check whether te_admin, as_adm, or other required roles exist. + |
+
400 + |
+AS.0022 + |
+Request body error + |
+The request is invalid. + |
+Check whether the request body is in standard JSON format or whether an unsupported parameter exists. + |
+
400 + |
+AS.0026 + |
+Scaling action is not allowed in the cooling duration. + |
+No scaling action is allowed in the cooldown period. + |
+Try again later. + |
+
400 + |
+AS.0031 + |
+Policy doesn't allow [%s] to be performed. + |
+Fine-grained authentication failed because no authentication item is specified. + |
+Add the required authorization item. + |
+
400 + |
+AS.0033 + |
+The api version is illegal, only v1 and v2. + |
+Invalid API ID. + |
+Enter a correct API ID. + |
+
400 + |
+AS.0034 + |
+Failed to execute the policy because the AS group is in active state. + |
+Failed to trigger the AS policy because a scaling action in the AS group is in progress. + |
+An AS policy can be automatically triggered only when there is no in-progress scaling action in the AS group. Try again later. + |
+
400 + |
+AS.1001 + |
+The value of parameter Start number is invalid. + |
+The start number value is invalid. + |
+Enter a valid start number value. + |
+
400 + |
+AS.1002 + |
+The value of parameter Limit is invalid. + |
+The limit value is invalid. + |
+Enter a valid limit value. + |
+
400 + |
+AS.1003 + |
+The AS configuration ID is null. + |
+The AS configuration ID is empty. + |
+Add an AS configuration ID. + |
+
400 + |
+AS.1004 + |
+The AS configuration does not exist. + |
+The AS configuration does not exist. + |
+Use a correct AS configuration ID. + |
+
400 + |
+AS.1006 + |
+The AS configuration is in use. + |
+The AS configuration is being used by an AS group and cannot be deleted. + |
+Change this AS configuration for the AS group to another one and delete the AS configuration. + |
+
400 + |
+AS.1007 + |
+The AS configuration name is null. + |
+The AS configuration name is empty. + |
+Add an AS configuration name. + |
+
400 + |
+AS.1008 + |
+The AS configuration name is too long. + |
+The AS configuration name is too long. + |
+Use an AS configuration name of proper length. + |
+
400 + |
+AS.1009 + |
+The AS group ID is null. + |
+The AS group ID is not specified. + |
+Add an AS group ID. + |
+
400 + |
+AS.1011 + |
+The instance configuration information is null. + |
+The instance_config field is not specified. + |
+Enter a valid instance_config value. + |
+
400 + |
+AS.1014 + |
+The image ID in the AS configuration is null. + |
+The image ID is not specified. + |
+Add an image ID. + |
+
400 + |
+AS.1015 + |
+The image in the AS configuration does not exist. + |
+The image in the AS configuration does not exist. + |
+Use a correct image ID. + |
+
400 + |
+AS.1016 + |
+The specification ID in the AS configuration cannot be null. + |
+The flavor ID is not specified. + |
+Add a flavor ID. + |
+
400 + |
+AS.1017 + |
+The specification [%s] in the AS configuration does not exist. + |
+The flavor of the AS configuration does not exist. + |
+Use a correct flavor ID. + |
+
400 + |
+AS.1018 + |
+The specification [%s] and image is not match. + |
+The flavor and image do not match. + |
+Check whether the flavor matches the image. If not, modify the configuration. + |
+
400 + |
+AS.1019 + |
+The disk of this type is not applicable to the ECS. + |
+The flavor and disk do not match. + |
+Check whether the flavor matches the disk type. If not, change the resources. + |
+
400 + |
+AS.1021 + |
+The image in the AS configuration is not activated. + |
+The image in the AS configuration is not activated. + |
+Use a correct image ID. + |
+
400 + |
+AS.1022 + |
+The image in the AS configuration is not available. + |
+The image in the AS configuration is unavailable. + |
+Use a correct image ID. + |
+
400 + |
+AS.1023 + |
+Invalid AS configuration name. + |
+The AS configuration name is invalid. + |
+Use a valid AS configuration name. + |
+
400 + |
+AS.1024 + |
+The number of AS configurations exceeds the upper limit. + |
+The number of AS configurations exceeds the upper limit. + |
+Delete idle AS configurations or apply for a higher quota. + |
+
400 + |
+AS.1025 + |
+The user login mode in the AS configuration is not unique. + |
+The user login mode in the AS configuration is not unique. + |
+Use account-and-password or key-pair login mode only. + |
+
400 + |
+AS.1026 + |
+The user login mode in the AS configuration is empty. + |
+The user login mode in the AS configuration is empty. + |
+Enter a valid key_name value. + |
+
400 + |
+AS.1027 + |
+The scaling config personality is invalid. + |
+The user AS configuration is invalid. + |
+Enter a valid personality value. + |
+
400 + |
+AS.1028 + |
+The disk in the AS configuration is null. + |
+The disk in the AS configuration is empty. + |
+Enter a valid disk value. + |
+
400 + |
+AS.1029 + |
+The number of system disks in the AS configuration is invalid. + |
+The number of system disks in the AS configuration is invalid. + |
+Ensure that there is only one system disk. + |
+
400 + |
+AS.1030 + |
+The size of the system disk in the AS configuration is less than the specification required. + |
+The size of the system disk in the AS configuration is smaller than the requirement. + |
+Use a proper system disk size. + |
+
400 + |
+AS.1031 + |
+The size of the disk in the AS configuration is not correct. + |
+The size of the disk in the AS configuration is invalid. + |
+Use a proper disk size. + |
+
400 + |
+AS.1032 + |
+The ECS type [%s] in the AS configuration do not support 24 disks. + |
+The number of disks in the AS configuration exceeds 24. + |
+Ensure that the number of disks does not exceed the limit. + |
+
400 + |
+AS.1033 + |
+Parameter volumeType in the AS configuration is invalid. + |
+The volumeType of the disk in the AS configuration is invalid. + |
+Use a valid volume_type value. + |
+
400 + |
+AS.1034 + |
+Parameter diskType in the AS configuration is invalid. + |
+The diskType in the AS configuration is invalid. + |
+Use a valid disk_type value. + |
+
400 + |
+AS.1035 + |
+Parameter adminPass in the AS configuration is invalid. + |
+The password in the AS configuration fails to meet the complexity requirements. + |
+Use passwords that meet complexity requirements. + |
+
400 + |
+AS.1036 + |
+32-bit operating system (OS) does not support the specification [%s] with 4G memory. + |
+The memory of 32-bit OS exceeds 4 GB. + |
+Change the image or the policy. + |
+
400 + |
+AS.1038 + |
+Batch deleting the AS configuration failed. + |
+Deleting AS configurations in batches fails. + |
+If this error code is returned, use parameter Message to obtain the configuration ID and the failure cause. + |
+
400 + |
+AS.1039 + |
+The number of AS configurations is beyond the maximum limit. + |
+The number of AS configurations to be deleted in batches exceeds the upper limit. + |
+Delete a maximum of 50 AS configurations at a time. + |
+
400 + |
+AS.1040 + |
+The list of AS config to be deleted is null. + |
+The AS configuration list is empty. + |
+Add the IDs of the AS configurations to be deleted in batches. + |
+
400 + |
+AS.1041 + |
+The eip info of scaling config is null. + |
+The eip field in the public_ip field is empty. + |
+Ensure that the eip field is not empty when specifying the public_ip field. + |
+
400 + |
+AS.1042 + |
+The bandwidth size of eip is invalid. + |
+The bandwidth size is invalid. + |
+Enter a valid bandwidth. + |
+
400 + |
+AS.1043 + |
+The eip type of scaling config is invalid. + |
+The EIP type is invalid. + |
+Use a valid EIP type. + |
+
400 + |
+AS.1044 + |
+The bandwidth charging mode of eip is invalid. + |
+The bandwidth billing model of the AS configuration is invalid. + |
+Use a valid bandwidth billing model. + |
+
400 + |
+AS.1045 + |
+The bandwidth type of eip is invalid. + |
+The bandwidth type is invalid. + |
+Use a valid bandwidth. + |
+
400 + |
+AS.1046 + |
+The bandwidth size of eip is null. + |
+The bandwidth size is not specified. + |
+Add the bandwidth value of the AS configuration. + |
+
400 + |
+AS.1049 + |
+Parameter userdata in the AS configuration is invalid. + |
+Parameter userdata in the AS configuration is invalid. + |
+Use a valid userdata. + |
+
400 + |
+AS.1050 + |
+The user login mode in the AS configuration is illegal. + |
+The user login mode in the AS configuration is invalid. + |
+Use a valid login mode. + |
+
400 + |
+AS.1052 + |
+Parameter metadata in the AS configuration is invalid. + |
+The metadata in the AS configuration is invalid. + |
+Use a valid metadata, whose maximum length is 512 bytes and the key value cannot contain spaces, $, or periods(.). + |
+
400 + |
+AS.1053 + |
+The data image is not available. + |
+The data image in the AS configuration is unavailable. + |
+Use a valid data image. + |
+
400 + |
+AS.1054 + |
+The size of the data disk in the AS configuration is less than the data image required. + |
+The size of the data disk in the AS configuration is smaller than what the data image requires. + |
+Use a proper data disk. + |
+
400 + |
+AS.1055 + |
+The system disk is not support to data image. + |
+A data disk image cannot be used to create a system disk. + |
+Refer to the error code description. + |
+
400 + |
+AS.1056 + |
+The data image in the AS configuration does not exist. + |
+The data image in the AS configuration does not exist. + |
+Use a valid data image ID. + |
+
400 + |
+AS.1057 + |
+The DSS of the disk in the AS configuration is not available. + |
+The selected DSS device is unavailable. + |
+Use a correct DSS device. + |
+
400 + |
+AS.1058 + |
+The type of dss in the AS configuration is incorrect. + |
+The selected DSS device does not support the disk type. + |
+Change the DSS device or disk type. + |
+
400 + |
+AS.1059 + |
+The capacity of dss in the AS configuration is not enough. + |
+The storage space on the selected DSS device is insufficient. + |
+Change the DSS device. + |
+
400 + |
+AS.1060 + |
+DSS and EVS are used together in the AS configuration. + |
+You can use either DSS or EVS disks in an AS configuration. + |
+Refer to the error code description. + |
+
400 + |
+AS.1061 + |
+The DSS does not belong to the same AZ in the AS configuration. + |
+The selected DSS devices must be in the same AZ. + |
+Change DSS devices so that they are in the same AZ. + |
+
400 + |
+AS.1062 + |
+The number of EVS disks with snapshot IDs in the AS configuration is different from that of EVS disks specified in the full-ECS image. + |
+The number of disks with snapshot IDs in the AS configuration is different from that of EVS disks specified in the full-ECS image. + |
+Refer to the error code description. + |
+
400 + |
+AS.1063 + |
+The disk data backup in a full-ECS image cannot be used to restore the disk in DSS. + |
+The disk data backup in a full-ECS image is used to restore the disk in DSS. + |
+Refer to the error code description. + |
+
400 + |
+AS.1064 + |
+The data disk you have selected will be restored using the disk data backup in the full-ECS image. Then, data mirroring will be unavailable. + |
+Your selected data disk will recover from the disk backup in the full-ECS image, and data mirroring is unavailable now. + |
+Refer to the error code description. + |
+
400 + |
+AS.1065 + |
+ECS resources specified in the AS configuration belong to different AZs. + |
+The VMs in the AS configuration do not belong to the same AZ. + |
+Use ECS resources (specifications, images, disk) in the same AZ. + |
+
400 + |
+AS.1066 + |
+The AS configuration contains EVS disks with invalid snapshot IDs. + |
+The AS configuration contains EVS disks with invalid snapshot IDs. + |
+Use a correct snapshot ID. + |
+
400 + |
+AS.1067 + |
+The value of parameter Offset number is invalid. + |
+Parameter offset is invalid. + |
+Use a valid offset value. + |
+
400 + |
+AS.1074 + |
+The value of parameter Marker is invalid. + |
+Parameter marker is invalid. + |
+Use a valid marker value. + |
+
400 + |
+AS.1075 + |
+The image ID is invalid. + |
+Image ID in the AS configuration is invalid. + |
+Use a correct image ID. + |
+
400 + |
+AS.1085 + |
+Invalid multi flavor priority policy. + |
+The priority policy used in multi-flavor AS configuration is invalid. + |
+Use a valid multi_flavor_priority_policy value. + |
+
400 + |
+AS.1086 + |
+AS configuration is not available for AS group + |
+The AS configuration is unavailable. + |
+Replace the AS configuration in the AS group. + |
+
400 + |
+AS.1087 + |
+The number of flavors in the AS config exceeds the upper limit. + |
+The number of flavors in the AS configuration reaches the upper limit. + |
+Ensure that the number of flavors in the AS configuration does not exceed the upper limit. + |
+
400 + |
+AS.1088 + |
+The image in the AS configuration you selected is unavailable for the AZ [%s] in AS group. + |
+The image in the AS configuration is not available in the AZ of the AS group. + |
+Change another AS configuration or AZ for the AS group. + |
+
400 + |
+AS.1090 + |
+Flavor {0} in the AS configuration is incompatible with the image architecture. + |
+The selected flavor is incompatible with the image architecture. + |
+Ensure that the selected flavor is compatible with the image architecture. + |
+
400 + |
+AS.2002 + |
+The name of the AS group is null. + |
+The AS group name is empty. + |
+Add an AS group name. + |
+
400 + |
+AS.2003 + |
+The AS group name is too long. + |
+The AS group name is too long. + |
+Use an AS group name of proper length. + |
+
400 + |
+AS.2004 + |
+Invalid min or max number of instances in the AS group. + |
+The maximum or minimum number of instances is invalid. + |
+Enter correct maximum/minimum number of instances for the AS group. + |
+
400 + |
+AS.2005 + |
+The expected number cannot be less than the minimum number of instances or greater than the maximum number of instances. + |
+The expected number of instances in the AS group is invalid. + |
+Enter a valid number of expected instances for the AS group. + |
+
400 + |
+AS.2006 + |
+Invalid cooldown period of the AS group. + |
+The cooldown period in the AS group is invalid. + |
+Enter a valid cooldown period for the AS group. + |
+
400 + |
+AS.2007 + |
+The AS group does not exist. + |
+The AS group does not exist. + |
+Use a correct AS group ID. + |
+
400 + |
+AS.2008 + |
+Invalid execution action of the AS group. + |
+The scaling action of the AS group is invalid. + |
+Use a correct scaling action for the AS group. + |
+
400 + |
+AS.2009 + |
+The AS group ID is null. + |
+The AS group ID is not specified. + |
+Add an AS group ID. + |
+
400 + |
+AS.2010 + |
+The expected number of instances in the AS group cannot be smaller than the number of instances for which instance protection has been configured. + |
+The expected number of instances in the AS group cannot be smaller than the number of instances for which instance protection has been configured. + |
+Ensure that the number of expected instances is no less than the protected instances, or change the expected number of instances after canceling instance protection. + |
+
400 + |
+AS.2011 + |
+Invalid AZ in AS group. + |
+The AZ in the AS group is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.2012 + |
+The VPC of the AS group does not exist. + |
+The VPC of the AS group does not exist. + |
+Use a valid value. + |
+
400 + |
+AS.2013 + |
+Parameter networks in the AS group is invalid. + |
+Parameter networks in the AS group is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.2014 + |
+The security group of the AS group does not exist. + |
+The security group of the AS group does not exist. + |
+Use a valid value. + |
+
400 + |
+AS.2015 + |
+Parameter listenerId in the AS group is invalid. + |
+The load balancer listener of the AS group is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.2016 + |
+The listener of the AS group does not belong to the vpc. + |
+The VPC to which the ELB listener in the AS group belongs is different from the VPC in the AS group. + |
+Change the VPC ID or ELB listener ID. + |
+
400 + |
+AS.2017 + |
+The ID of the VPC in the AS group is null. + |
+The VPC ID in the AS group is not specified. + |
+Add a VPC ID. + |
+
400 + |
+AS.2018 + |
+No AS configuration is in the AS group. + |
+No AS is configured in the AS group. + |
+Enable the AS group after adding an AS configuration to the AS group. + |
+
400 + |
+AS.2019 + |
+The value of the parameter that specifies whether to forcibly delete an AS group is invalid. + |
+The value of the parameter that specifies whether to forcibly delete an AS group is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.2020 + |
+The scaling group status is illegal. + |
+The AS group status is invalid. + |
+You are not allowed to perform the operation when the AS group is in the current status. + |
+
400 + |
+AS.2021 + |
+The current number of instances in the AS group is not 0. + |
+Deleting the AS group fails because there are instances in it. + |
+Before deleting the AS group, deleting its instances. + |
+
400 + |
+AS.2022 + |
+The AS group name contains invalid characters. + |
+The AS group name contains invalid characters. + |
+Use a correct AS group name. + |
+
400 + |
+AS.2023 + |
+The number of AS groups exceeds the upper limit. + |
+The number of AS groups exceeds the upper limit. + |
+Delete idle AS groups or apply for a higher quota. + |
+
400 + |
+AS.2024 + |
+The number of subnets in the AS group exceeds the upper limit. + |
+The number of subnets in the AS group exceeds the upper limit. + |
+Ensure that the number of subnets does not exceed the upper limit. + |
+
400 + |
+AS.2025 + |
+The number of security groups in the AS group exceeds the upper limit. + |
+The number of security groups in the AS group exceeds the upper limit. + |
+Ensure that the number of security groups does not exceed the upper limit. + |
+
400 + |
+AS.2026 + |
+The type of listeners in the AS group is not unique. + |
+There are ELB listeners of different types in the AS group. + |
+lb_listener_id is alternative to lbaas_listeners. + |
+
400 + |
+AS.2027 + |
+The subnet of the AS group does not belong to the vpc. + |
+The VPC to which some subnets in the AS group belong is different with the VPC in the AS group. + |
+Change the VPC ID or subnet. + |
+
400 + |
+AS.2028 + |
+The modified expected number of instances is the same as the original number. + |
+The new expected number of instances is the same as the original number. + |
+Refer to the error code description. + |
+
400 + |
+AS.2029 + |
+Invalid health check method of the AS group. + |
+The health check method for instances in the AS group is incorrect. + |
+Use a valid health_periodic_audit_method value. + |
+
400 + |
+AS.2030 + |
+You are not allowed to modify the lb, AZ, subnet, and security information when the number of instances in the AS group is not 0, the AS group is scaling, or the AS group is in Inservice status. + |
+You are not allowed to modify the load balancer, AZ, subnet, or security group information when there are instances in the AS group, the AS group is scaling, or the AS group is in Inservice state. + |
+Check the number of instances in the AS group and the status of the AS group, or try again later. + |
+
400 + |
+AS.2031 + |
+Invalid health check period of the AS group. + |
+The health check period of the AS group is invalid. + |
+Use a valid health_periodic_audit_time value. + |
+
400 + |
+AS.2032 + |
+Invalid instance removal policy. + |
+The instance removal policy for the AS group is invalid. + |
+Use a valid instance_terminate_policy value. + |
+
400 + |
+AS.2033 + |
+You are not allowed to perform the operation when the AS group is in current [%s] status. + |
+You are not allowed to perform the operation when the AS group is in the current status. + |
+Refer to the error code description. + |
+
400 + |
+AS.2034 + |
+Invalid notification method of the AS group. + |
+The notification method for the AS group is invalid. + |
+Use a valid notification method. + |
+
400 + |
+AS.2035 + |
+The number of instances manually added to the AS group exceeds the maximum number of the instances required in the AS group. + |
+The number of ECSs in the AS group is greater than the upper limit because some ECSs are manually added. + |
+Add a proper number of ECSs or increase the maximum number of instances in the AS group. + |
+
400 + |
+AS.2036 + |
+The number of instances manually deleted is less than the minimum number of the instances required in the AS group. + |
+The number of ECSs in the AS group is smaller than the lower limit because some ECSs are manually deleted. + |
+Delete a proper number of ECSs or decrease the minimum number of instances in the AS group. + |
+
400 + |
+AS.2037 + |
+The number of listeners in the AS group exceeds the upper limit. + |
+The number of ELB listeners in the AS group reaches the upper limit. + |
+Select a proper number of load balancer listeners. + |
+
400 + |
+AS.2038 + |
+The type [%s] of ECS in the AZ you selected has been sold out. + |
+The ECSs of this type have been sold out in the AZ specified for this AS group. + |
+Refer to the error code description. Change the AZ of the AS group or change the AS configuration for the AS group. + |
+
400 + |
+AS.2039 + |
+Parameter protocolPort of the AS group is invalid. + |
+Parameter protocolPort of the AS group is invalid. + |
+Use a valid protocolPort. + |
+
400 + |
+AS.2040 + |
+Parameter weight of the AS group is invalid. + |
+Parameter weight of the AS group is invalid. + |
+Use a valid weight. + |
+
400 + |
+AS.2042 + |
+Parameter pool of lbaas in the AS group is invalid. + |
+The load balancer pool in the AS group is invalid. + |
+Use a valid pool. + |
+
400 + |
+AS.2043 + |
+There is not avalid volume in the AZ [%s] you selected. + |
+Storage resources of this type are sold out or do not exist in the AZ specified for this AS group. + |
+Refer to the error code description. Change the AZ of the AS group or change the AS configuration for the AS group. + |
+
400 + |
+AS.2044 + |
+The AZ in the AS group is not available. + |
+The AZ in the AS group is invalid. + |
+Refer to the error code description. Change the AZ of the AS group. + |
+
400 + |
+AS.2045 + |
+The min or max number of instances in the AS group exceeds the upper limit. + |
+The minimum or maximum number of instances in the AS group exceeds the limit. + |
+Enter proper maximum and minimum numbers of instances for the AS group. + |
+
400 + |
+AS.2046 + |
+Invalid health check grace period of the AS group. + |
+The grace period for the instance health check is invalid. + |
+Use a valid health_periodic_audit_grace_period value. + |
+
400 + |
+AS.2047 + |
+The AS group is in active status. + |
+Failed to modify load balancer parameters because a scaling action is ongoing. + |
+Wait until the scaling action is complete and modify the load balancer parameters again. + |
+
400 + |
+AS.2053 + |
+Invalid multi az priority policy. + |
+The priority policy used for multiple AZs in the AS group is invalid. + |
+Change the priority policy used for multiple AZs in the AS group. + |
+
400 + |
+AS.2054 + |
+The AS group is in active status. + |
+Failed to change the AZ because a scaling action is ongoing. + |
+Wait until the scaling action is complete and change the AZ again. + |
+
400 + |
+AS.3002 + |
+Invalid AS policy type. + |
+The AS policy type is invalid. + |
+Use a valid scaling_policy_type value. + |
+
400 + |
+AS.3003 + |
+The information about the AS policy is null. + |
+When the AS policy is scheduled or periodic, parameter scheduled_policy is empty. + |
+Use a valid scheduled_policy value. + |
+
400 + |
+AS.3004 + |
+Invalid recurrence type in the AS policy. + |
+The period type is incorrect. + |
+Use a valid recurrence_type value. + |
+
400 + |
+AS.3005 + |
+The end time of the scaling action triggered periodically is empty. + |
+The end time is not specified for a periodic AS policy. + |
+Enter a valid end_time value. + |
+
400 + |
+AS.3006 + |
+The format of the end time for the scaling action triggered periodically is incorrect. + |
+The format of the end time for the periodically triggered scaling action is incorrect. + |
+Use a correct format for the end time. + |
+
400 + |
+AS.3007 + |
+The end time of the scaling action triggered periodically must be later than the current time. + |
+The end time of the scaling action triggered periodically must be later than the current time. + |
+Ensure that the end time is later than the current time. + |
+
400 + |
+AS.3008 + |
+Parameter lanchTime in the AS policy is null. + |
+The triggering time is not specified. + |
+Enter a valid launch_time value. + |
+
400 + |
+AS.3009 + |
+The format of parameter lanchTime is incorrect. + |
+The triggering time format is incorrect. + |
+Use a correct triggering time format. + |
+
400 + |
+AS.3010 + |
+The triggering time of the scheduled policy must be later than the current time. + |
+The triggering time of the scaling action triggered at a scheduled time must be later than the current time. + |
+Ensure that the triggering time of the scheduled policy is later than the current time. + |
+
400 + |
+AS.3011 + |
+The AS policy type is null. + |
+The AS policy type is not specified. + |
+Enter a valid scaling_policy_type value. + |
+
400 + |
+AS.3012 + |
+Invalid cooldown period in the AS policy. + |
+The cooldown period in the AS policy is invalid. + |
+Enter a valid cool_down_time value. + |
+
400 + |
+AS.3013 + |
+The AS policy name is null. + |
+The AS policy name is not specified. + |
+Enter a valid scaling_policy_name value. + |
+
400 + |
+AS.3014 + |
+The length of the AS policy name is invalid. + |
+The length of the AS policy name is invalid. + |
+Enter a valid scaling_policy_name value. + |
+
400 + |
+AS.3015 + |
+The action in the AS policy is null. + |
+The execution action in the AS policy is not specified. + |
+Enter a valid scaling_policy_action value. + |
+
400 + |
+AS.3016 + |
+The operation to perform the action in the AS policy is null. + |
+The operation to perform the execution action in the AS policy is not specified. + |
+Enter a valid operation value. + |
+
400 + |
+AS.3017 + |
+The operation to perform the action in the AS policy action is invalid. + |
+The operation to perform the action in the AS policy is invalid. + |
+Enter a valid operation value. + |
+
400 + |
+AS.3018 + |
+The number of instances which action in the AS policy operates on is invalid. + |
+The number of instances to which the AS policy applies is invalid. + |
+Enter a valid instance_number value. + |
+
400 + |
+AS.3019 + |
+The AS group ID in the AS policy cannot be null. + |
+The AS group ID in the AS policy is not specified. + |
+Add an AS group ID. + |
+
400 + |
+AS.3020 + |
+The AS policy does not exist. + |
+The AS policy does not exist. + |
+Use a correct AS policy ID. + |
+
400 + |
+AS.3021 + |
+The AS policy ID cannot be null. + |
+The AS policy ID is not specified. + |
+Add an AS policy ID. + |
+
400 + |
+AS.3022 + |
+The action of the AS policy request body is invalid. + |
+The action of the AS policy request body is invalid. + |
+Use a valid action value. + |
+
400 + |
+AS.3023 + |
+The period type of the AS policy is null. + |
+The period type of the AS policy is empty. + |
+Use a valid recurrence_type value. + |
+
400 + |
+AS.3024 + |
+The value of the period type of the AS policy is null. + |
+The value of the periodically triggered tasks of the AS policy is empty. + |
+Add a valid recurrence_value value. + |
+
400 + |
+AS.3025 + |
+The value of period type of the AS policy is invalid. + |
+The period type of the AS policy is invalid. + |
+Use a valid recurrence_type value. + |
+
400 + |
+AS.3026 + |
+The alarm ID in the AS policy is null. + |
+The alarm ID in the AS policy is empty. + |
+Add an alarm ID. + |
+
400 + |
+AS.3027 + |
+The AS policy must be in the inservice status when the AS policy is performed. + |
+The AS group must be in service when the AS policy is performed. + |
+Enable the AS group and try again. + |
+
400 + |
+AS.3028 + |
+The format of the start time for the scaling action triggered periodically is incorrect. + |
+The format of the start time for the periodically triggered scaling action is incorrect. + |
+Use a correct format for the start time. + |
+
400 + |
+AS.3029 + |
+The start time of the scaling action triggered periodically must be earlier than the end time. + |
+The start time of the periodically triggered scaling action must be earlier than the end time. + |
+Ensure that the start time of the periodic policy is earlier than the end time. + |
+
400 + |
+AS.3030 + |
+The alarm in the AS policy does not exist. + |
+The alarm rule in the AS policy does not exist. + |
+Modify the alarm rule used by the AS policy. + |
+
400 + |
+AS.3031 + |
+Invalid AS policy name. + |
+The AS policy name is invalid. + |
+Enter a valid scaling_policy_name value. + |
+
400 + |
+AS.3032 + |
+The number of AS policies exceeds the upper limit. + |
+The number of AS policies exceeds the upper limit. + |
+Delete idle AS policies or apply for a higher quota. + |
+
400 + |
+AS.3033 + |
+The triggering time of the periodic policy is not included in the effective time of the policy. + |
+The triggering time of the periodic policy falls outside the effective time range of the policy. + |
+Ensure that the triggering time of the periodic policy is within the range from the start time to the end time. + |
+
400 + |
+AS.3034 + |
+The alarm ID in the AS policy is being used by another AS group. + |
+The alarm ID in the AS policy is being used by another AS group. + |
+Refer to the error code description. An alarm ID can be used only by the AS policy in one AS group at a time. + |
+
400 + |
+AS.3035 + |
+The percentage of instances which action in the AS policy operates on is invalid. + |
+The percentage of instances to which the AS policy applies is invalid. + |
+Use a valid instance_percentage value. + |
+
400 + |
+AS.3036 + |
+The action in the AS policy operates is not unique. + |
+The action in the AS policy operates is not unique. + |
+Select one from instance_percentage or instance_number. + |
+
400 + |
+AS.3037 + |
+The scaling resource type in the AS policy is invalid. + |
+The resource type in the AS policy is invalid. + |
+Use a valid scaling_resource_type value. + |
+
400 + |
+AS.3038 + |
+The AS policy is in executing status. + |
+The AS policy is being executed and cannot be executed again. + |
+Try again later. + |
+
400 + |
+AS.3040 + |
+The adjustment by policy reached the limit + |
+The number of modifications to scaling resources in the AS policy has reached the upper limit. + |
+Refer to the error code description. + |
+
400 + |
+AS.3041 + |
+The scaling resource ID in the AS policy is null. + |
+The scaling resource ID in the AS policy is not specified. + |
+Enter a valid AS resource ID in the AS policy. + |
+
400 + |
+AS.3042 + |
+The scaling resource in the AS policy does not exist. + |
+The scaling resource in the AS policy does not exist. + |
+Enter a valid AS resource ID in the AS policy. + |
+
400 + |
+AS.3043 + |
+The limit which action in the AS policy operates on is invalid. + |
+The value of parameter limits in the AS policy is invalid. + |
+Use a valid limits value in the AS policy. + |
+
400 + |
+AS.3045 + |
+Failed to delete policies in a batch. + |
+Failed to delete policies in batches. + |
+If this error code is returned, use parameter Message to obtain the policy ID and the failure cause. + |
+
400 + |
+AS.3046 + |
+Failed to resume policies in a batch. + |
+Failed to enable policies in batches. + |
+If this error code is returned, use parameter Message to obtain the policy ID and the failure cause. + |
+
400 + |
+AS.3047 + |
+Failed to pause policies in a batch. + |
+Failed to disable policies in batches. + |
+If this error code is returned, use parameter Message to obtain the policy ID and the failure cause. + |
+
400 + |
+AS.3048 + |
+The value of the parameter that specifies whether to forcibly delete the policy is invalid. + |
+The value of the parameter that specifies whether to forcibly delete the policy is invalid. + |
+Use a valid force_delete value. + |
+
400 + |
+AS.3049 + |
+The list of AS policies to be batched is empty. + |
+The list of AS policies on which a batch operation is to be performed is empty. + |
+Add the IDs of the AS policies to be operated in batches. + |
+
400 + |
+AS.3050 + |
+The alarm ID in the AS policy is illegal. + |
+The format of the alarm ID in the AS policy is incorrect. + |
+Use an alarm ID in correct format. + |
+
400 + |
+AS.3054 + |
+The scaling resource type in the AS policy is null. + |
+The scaling resource type in the AS policy cannot be left blank. + |
+Use a valid scaling_resource_type value. + |
+
400 + |
+AS.3055 + |
+The scaling resource ID in the AS policy is format wrong. + |
+The scaling resource ID in the scaling policy is invalid. + |
+Enter a valid AS resource ID in the AS policy. + |
+
400 + |
+AS.3056 + |
+The value of the parameter that specifies whether to delete the alarm in the AS policy is invalid. + |
+The value of the alarm rule used for deleting the scaling policy is invalid. + |
+Use a valid delete_alarm value. + |
+
400 + |
+AS.3057 + |
+The value of parameter sort_by in the request is invalid. + |
+The sort_by value in the request is invalid. + |
+Use a valid sort_by value. + |
+
400 + |
+AS.3058 + |
+The value of parameter order in the request is invalid. + |
+The order value in the request is invalid. + |
+Use a valid order value. + |
+
400 + |
+AS.4000 + |
+The value of parameter start_number in the request for the instance is invalid. + |
+The start_number value in the instance request is invalid. + |
+Use a valid start_number value. + |
+
400 + |
+AS.4001 + |
+The value of parameter limit in the request for the instance is invalid. + |
+The limit value in the instance request is invalid. + |
+Use a valid limit value. + |
+
400 + |
+AS.4003 + |
+The value of parameter life_cycle_state in the instance request is invalid. + |
+The life_cycle_state value in the instance request is invalid. + |
+Use a valid life_cycle_state value. + |
+
400 + |
+AS.4004 + |
+The value of parameter health_status in the request for the instance is invalid. + |
+The health_status value in the instance request is invalid. + |
+Use a valid health_status value. + |
+
400 + |
+AS.4005 + |
+Parameter scaling_group_id in the request for the instance does not exist. + |
+The scaling_group_id in the instance request does not exist. + |
+Use a correct scaling_group_id. + |
+
400 + |
+AS.4006 + |
+The instance does not exist. + |
+The instance does not exist. + |
+Use a correct instance ID. + |
+
400 + |
+AS.4007 + |
+The value of the parameter that specifies whether to delete the instance is invalid. + |
+The value of the parameter that specifies whether to delete the instance is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.4008 + |
+The start time format of the log about the expected number of the instances is incorrect. + |
+The start time format of the log about the expected number of the instances is incorrect. + |
+Use a correct format. + |
+
400 + |
+AS.4009 + |
+The end time format of the log about expected number of the instances is incorrect. + |
+The end time format of the log about expected number of the instances is incorrect. + |
+Use a correct format. + |
+
400 + |
+AS.4010 + |
+Parameter start_number in the request for the log about the expected number of instances is invalid. + |
+The start_number in the request for the log about the expected number of instances is invalid. + |
+Use a valid start_number value. + |
+
400 + |
+AS.4011 + |
+The value of parameter limit in the request for the log about the expected number of instances is invalid. + |
+The value of limit in the request for the log about the expected number of instances is invalid. + |
+Use a valid limit value. + |
+
400 + |
+AS.4012 + |
+The value of parameter logId in the request for the log about the expected number of instances is invalid. + |
+The logId in the request for the log about the expected number of instances is invalid. + |
+Use a valid logId value. + |
+
400 + |
+AS.4013 + |
+The list of instances to be deleted is null. + |
+The list of instances to be deleted is empty. + |
+Add instances to be deleted. + |
+
400 + |
+AS.4014 + |
+The instances do not belong to the same AS group. + |
+The instances do not belong to the same AS group. + |
+Select instances in the same AS group. + |
+
400 + |
+AS.4015 + |
+The instance is not in the inservice status. + |
+The instance is not in inservice state. + |
+Select an inservice instance. + |
+
400 + |
+AS.4016 + |
+Failed to delete the instance because the instance is charged by month or year. + |
+The instance cannot be deleted because it is charged by month or year. + |
+Refer to the error code description. + |
+
400 + |
+AS.4017 + |
+The requested instance is null. + |
+The requested instance is empty. + |
+Enter a valid instance. + |
+
400 + |
+AS.4018 + |
+The action of the body in the request to operate the instance is invalid. + |
+The value of the request body action of the batch instance operation is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.4019 + |
+The list of instances to be added to the AS group is empty. + |
+The list of instances to be added to the AS group is empty. + |
+Enter a valid instance. + |
+
400 + |
+AS.4020 + |
+The AZ to which the instance belongs is not within the AZ in the AS group. + |
+The AZ to which the instance belongs is different from the AZ to which the AS group belongs. + |
+Select a proper instance for the AZ. + |
+
400 + |
+AS.4021 + |
+The VPC to which the instance belongs is different from the VPC in the AS group. + |
+The VPC to which the instance belongs is different from the VPC in the AS group. + |
+Select a proper instance for the VPC. + |
+
400 + |
+AS.4022 + |
+The number of instances added to the AS group exceeds the upper limit. + |
+The number of instances added to the AS group exceeds the upper limit. + |
+Add a proper number of instances. + |
+
400 + |
+AS.4023 + |
+The added instance has already existed. + |
+The added instance already exists. + |
+Select another valid instance. + |
+
400 + |
+AS.4024 + |
+The instance is not in the active status. + |
+The added instance is not in the active state. + |
+Select an active instance. + |
+
400 + |
+AS.4026 + |
+The number of instances deleted exceeds the upper limit. + |
+The number of instances deleted exceeds the upper limit. + |
+Delete a proper number of instances. + |
+
400 + |
+AS.4027 + |
+The added instance has already existed in other AS group. + |
+The instance has already been added to another AS group. + |
+Select another valid instance. + |
+
400 + |
+AS.4028 + |
+The AS instance ID cannot be null. + |
+The instance ID cannot be left blank. + |
+Use a correct instance ID. + |
+
400 + |
+AS.4029 + |
+Failed to add instances in a batch. + |
+Failed to batch add instances. + |
+If this error code is returned, use parameter Message to obtain the instance ID and the failure cause. + |
+
400 + |
+AS.4030 + |
+Failed to delete instances in a batch. + |
+Failed to delete instances in batches. + |
+If this error code is returned, use parameter Message to obtain the instance ID and the failure cause. + |
+
400 + |
+AS.4032 + |
+The list of instances is null. + |
+The list of instances is empty. + |
+Refer to the error code description. + |
+
400 + |
+AS.4033 + |
+Failed to set instance protection in a batch. + |
+Failed to set instance protection in a batch. + |
+If this error code is returned, use parameter Message to obtain the instance ID and the failure cause. + |
+
400 + |
+AS.4043 + |
+The number of instances exceeds the upper limit. + |
+The number of instances for batch operations exceeds the upper limit. + |
+Ensure that the number of instances for batch operations is no more than 10 at a time. + |
+
400 + |
+AS.7012 + |
+The ELB listener is unavailable. + |
+The ELB listener does not exist. + |
+Modify the ELB listener information. + |
+
400 + |
+AS.7019 + |
+The number of private IP addresses in the subnet is insufficient. + |
+Private IP addresses in the subnet are insufficient. + |
+Modify the subnet information and enable the AS group. + |
+
400 + |
+AS.7022 + |
+The key pair does not exist. + |
+The SSH key of the AS configuration does not exist. + |
+Replace the AS configuration in the AS group. + |
+
400 + |
+AS.7044 + |
+The tag of this resource is null + |
+The tag of this resource is empty. + |
+Use a valid value. + |
+
400 + |
+AS.7045 + |
+The number of tags exceeded. + |
+The maximum number of tags has been reached. + |
+Add a maximum of 10 tags. + |
+
400 + |
+AS.7046 + |
+The tags in the resource is invalid. + |
+The tag is invalid. + |
+Use a valid tag. + |
+
400 + |
+AS.7047 + |
+The value of tag in the resource is too long. + |
+The tag value is too long. + |
+Use a valid value. + |
+
400 + |
+AS.7048 + |
+The resource type in this operation with tag is invalid. + |
+The resource type in this operation with tag is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.7049 + |
+The action in this operation with tag is invalid. + |
+The action in this operation with tag is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.7050 + |
+The key of tag cannot be duplicate. + |
+The key of tag is duplicate. + |
+Use a valid value. + |
+
400 + |
+AS.7052 + |
+The matches in the resource is invalid. + |
+The matches value is invalid. + |
+Use a valid matches value. + |
+
400 + |
+AS.7054 + |
+The value of tag cannot be duplicate. + |
+A key in the tag has duplicate values. + |
+Check and change the duplicate values in the tag. + |
+
400 + |
+AS.7059 + |
+The enterprise project does not exist. + |
+The selected enterprise project does not exist. + |
+Use an existing enterprise project. + |
+
400 + |
+AS.7060 + |
+The enterprise project is unavailable. + |
+The enterprise project is unavailable. + |
+Use an available enterprise project. + |
+
400 + |
+AS.7061 + |
+The value of scaling tag is null. + |
+The value of the tag is empty. + |
+Use a valid value. + |
+
400 + |
+AS.7062 + |
+The key of scaling tag is null. + |
+The key of the tag is empty. + |
+Use a valid value. + |
+
400 + |
+AS.7063 + |
+The key of scaling tag is too long. + |
+The tag key is too long. + |
+Use a valid value. + |
+
400 + |
+AS.7065 + |
+The value of parameter enterprise_project_id in the request is invalid. + |
+The request parameter enterprise_project_id is invalid. + |
+Use a valid enterprise_project_id. + |
+
400 + |
+AS.7111 + |
+Insufficient instance quota. + |
+Insufficient ECS quota. + |
+Release idle ECSs or apply for a higher ECS quota. + |
+
400 + |
+AS.7112 + |
+Insufficient volume quota. + |
+Insufficient EVS disk quota. + |
+Release idle ECSs or increase the upper limit of disks. + |
+
400 + |
+AS.7113 + |
+Insufficient elastic ip quota. + |
+Insufficient EIP quota. + |
+Release idle EIPs or increase the upper limit of EIPs. + |
+
400 + |
+AS.7114 + |
+Insufficient ram quota. + |
+Insufficient ECS memory quota. + |
+Release idle ECSs or apply for a higher ECS memory quota. + |
+
400 + |
+AS.7115 + |
+Insufficient cpu quota. + |
+Insufficient ECS vCPU quota. + |
+Release idle ECSs or increase the upper limit of ECS vCPUs. + |
+
400 + |
+AS.9001 + |
+The format of the start time of the scaling activity log is incorrect. + |
+The format of the start time of the scaling log is incorrect. + |
+Use a valid value. + |
+
400 + |
+AS.9002 + |
+The format of the end time for the scaling action log is incorrect. + |
+The format of the end time for the scaling log is incorrect. + |
+Use a valid value. + |
+
400 + |
+AS.9003 + |
+The value of parameter start_number in the request for the scaling activity log is invalid. + |
+The start_number in the request for the scaling log is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.9004 + |
+The value of parameter limit in the request for the scaling activity log is invalid. + |
+The limit in the request for the scaling log is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.9005 + |
+The value of parameter log_id in the request for the scaling log is invalid. + |
+The logId in the request for the scaling log is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.9007 + |
+The format of the execute time in the request is incorrect. + |
+The time format of the AS policy execution log is incorrect. + |
+Use a valid value. + |
+
400 + |
+AS.9008 + |
+The value of parameter start_number in the request is invalid. + |
+Parameter start_number in the AS policy execution log is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.9009 + |
+The value of parameter limit in the request is invalid. + |
+Parameter limit in the AS policy execution log is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.9010 + |
+The value of parameter log_id in the request is invalid. + |
+Parameter logId in the AS policy execution log is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.9011 + |
+The value of parameter scaling_resource_id in the request is invalid. + |
+The resource ID in the AS policy execution log is invalid. + |
+Use a valid value. + |
+
400 + |
+AS.9012 + |
+The value of parameter type in the request for the scaling activity log is invalid. + |
+The type in the request for the scaling action log is invalid. + |
+Use a valid type value. + |
+
400 + |
+AS.9013 + |
+The value of parameter status in the request for the scaling activity log is invalid. + |
+The status in the request for the scaling action log is invalid. + |
+Use a valid value. + |
+
Permission + |
+APIs + |
+Actions + |
+IAM Project ++ |
+Enterprise Project ++ |
+
|---|---|---|---|---|
Creating an AS configuration + |
+POST /autoscaling-api/v1/{project_id}/scaling_configuration + |
+as:configs:create + |
+√ + |
+√ + |
+
Querying AS configurations + |
+GET /autoscaling-api/v1/{project_id}/scaling_configuration + |
+as:configs:list + |
+√ + |
+√ + |
+
Querying AS configuration details + |
+GET /autoscaling-api/v1/{project_id}/scaling_configuration/{scaling_configuration_id} + |
+as:configs:get + |
+√ + |
+√ + |
+
Deleting an AS configuration + |
+DELETE /autoscaling-api/v1/{project_id}/scaling_configuration/{scaling_configuration_id} + |
+as:configs:delete + |
+√ + |
+√ + |
+
Batch deleting AS configurations + |
+POST /autoscaling-api/v1/{project_id}/scaling_configurations + |
+as:configs:batchDelete + |
+√ + |
+√ + |
+
Permission + |
+APIs + |
+Actions + |
+IAM Project ++ |
+Enterprise Project ++ |
+
|---|---|---|---|---|
Querying instances in an AS group + |
+GET /autoscaling-api/v1/{project_id}/scaling_group_instance/{scaling_group_id}/list + |
+as:instances:list + |
+√ + |
+√ + |
+
Removing instances from an AS group + |
+DELETE /autoscaling-api/v1/{project_id}/scaling_group_instance/{instance_id} + |
+as:instances:delete + |
+√ + |
+√ + |
+
Performing operations on instances in batches + |
+POST /autoscaling-api/v1/{project_id}/scaling_group_instance/{scaling_group_id}/action + |
+as:instances:batchAction + |
+√ + |
+√ + |
+
Permission + |
+APIs + |
+Actions + |
+IAM Project ++ |
+Enterprise Project ++ |
+
|---|---|---|---|---|
Creating an AS policy + |
+POST /autoscaling-api/v1/{project_id}/scaling_policy + |
+as:policies:create + |
+√ + |
+√ + |
+
Modifying an AS policy + |
+PUT /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id} + |
+as:policies:update + |
+√ + |
+√ + |
+
Querying AS policies + |
+GET /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_group_id}/list + |
+as:policies:list + |
+√ + |
+√ + |
+
Querying AS policy details + |
+GET /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id} + |
+as:policies:get + |
+√ + |
+√ + |
+
Executing, enabling, or disabling an AS policy + |
+POST /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id}/action + |
+as:policies:action + |
+√ + |
+√ + |
+
Deleting an AS policy + |
+DELETE /autoscaling-api/v1/{project_id}/scaling_policy/{scaling_policy_id} + |
+as:policies:delete + |
+√ + |
+√ + |
+
Creating an AS policy + |
+POST /autoscaling-api/v2/{project_id}/scaling_policy + |
+as:policies:create + |
+√ + |
+√ + |
+
Modifying an AS policy + |
+PUT /autoscaling-api/v2/{project_id}/scaling_policy/{scaling_policy_id} + |
+as:policies:update + |
+√ + |
+√ + |
+
Querying AS policies + |
+GET /autoscaling-api/v2/{project_id}/scaling_policy/{scaling_resource_id}/list + |
+as:policies:list + |
+√ + |
+√ + |
+
Querying AS policies + |
+GET /autoscaling-api/v2/{project_id}/scaling_policy{? scaling_resource_id, scaling_resource_type ,scaling_policy_name, scaling_policy_id,scaling_policy_type,start_number,limit,sort_by,order,enterprise_project_id} + |
+as:groups:get +as:policies:list + |
+√ + |
+√ + |
+
Querying AS policy details + |
+GET /autoscaling-api/v2/{project_id}/scaling_policy/{scaling_policy_id} + |
+as:policies:get + |
+√ + |
+√ + |
+
Performing operations on AS policies in batches + |
+POST /autoscaling-api/v1/{project_id}/scaling_policies/action + |
+as:policies:batchAction + |
+√ + |
+√ + |
+
Permission + |
+APIs + |
+Actions + |
+IAM Project ++ |
+Enterprise Project ++ |
+
|---|---|---|---|---|
Querying AS policy execution logs + |
+GET /autoscaling-api/v1/{project_id}/scaling_policy_execute_log/{scaling_policy_id} + |
+as:policyExecuteLogs:list + |
+√ + |
+√ + |
+
Permission + |
+APIs + |
+Actions + |
+IAM Project ++ |
+Enterprise Project ++ |
+
|---|---|---|---|---|
Querying scaling action logs + |
+GET /autoscaling-api/v1/{project_id}/scaling_activity_log/{scaling_group_id} + |
+as:acivityLogs:list + |
+√ + |
+√ + |
+
Querying scaling action logs (V2) + |
+GET /autoscaling-api/v2/{project_id}/scaling_activity_log/{scaling_group_id} + |
+as:acivityLogs:list + |
+√ + |
+√ + |
+
Permission + |
+APIs + |
+Actions + |
+IAM Project ++ |
+Enterprise Project ++ |
+
|---|---|---|---|---|
Querying AS quotas + |
+GET /autoscaling-api/v1/{project_id}/quotas + |
+as:quotas:get + |
+√ + |
+√ + |
+
Querying AS policy and instance quotas + |
+GET /autoscaling-api/v1/{project_id}/quotas/{scaling_group_id} + |
+as:quotas:get + |
+√ + |
+√ + |
+
Permission + |
+APIs + |
+Actions + |
+IAM Project ++ |
+Enterprise Project ++ |
+
|---|---|---|---|---|
Querying tags + |
+GET /autoscaling-api/v1/{project_id}/{resource_type}/tags + |
+as:tags:list + |
+√ + |
+× + |
+
Querying tags of a resource + |
+GET /autoscaling-api/v1/{project_id}/{resource_type}/{resource_id}/tags + |
+as:tags:get + |
+√ + |
+× + |
+
Updating or deleting a tag + |
+POST /autoscaling-api/v1/{project_id}/{resource_type}/{resource_id}/tags/action + |
+as:tags:set + |
+√ + |
+× + |
+
Querying resources + |
+POST /autoscaling-api/v1/{project_id}/{resource_type}/resource_instances/action + |
+as:tagResources:list + |
+√ + |
+× + |
+
Public cloud APIs comply with the RESTful API design principles. REST-based Web services are organized into resources. Each resource is identified by one or more Uniform Resource Identifiers (URIs). An application accesses a resource based on the resource's Unified Resource Locator (URL). A URL is usually in the following format: https://Endpoint/uri. In the URL, uri indicates the resource path, that is, the API access path.
+Public cloud APIs use HTTPS as the transmission protocol. Requests/Responses are transmitted by using JSON messages, with media type represented by Application/json.
+For details about how to use APIs, see API Usage Guidelines.
+Released On + |
+Description + |
+
|---|---|
2021-10-20 + |
+Modified the following content: +Modified the type of the available_zones parameter and optimized the networks description in Creating an AS Group and Querying AS Groups. + |
+
2019-10-30 + |
+Added the following content: +
|
+
2019-09-30 + |
+Added the following content: +
|
+
2019-05-31 + |
+Added the following content: +
Modified the following content: +
|
+
2019-04-30 + |
+Added the following content: +
|
+
2019-03-31 + |
+Added the following content: +
Modified the following content: +
|
+
2019-02-28 + |
+Added the following content: +
Modified the following content: +
|
+
2018-11-30 + |
+Added the following content: +
Modified the following content: +Modified error codes AS.2015, AS.2035, and AS.2042 in Error Codes. + |
+
2018-09-30 + |
+Added the following content: +
|
+
2018-08-30 + |
+Modified the following content: +
|
+
2018-08-14 + |
+Modified the following content: +Accepted in OTC-3.2/Agile 09.2018. + |
+
2018-07-30 + |
+Modified the following content: +
|
+
2018-05-30 + |
+Modified the following content: +
|
+
2018-04-30 + |
+Modified the following content: +
|
+
2018-03-30 + |
+Modified the following content: +
|
+
2018-01-30 + |
+Modified the following content: +
|
+
2017-11-30 + |
+Modified the following content:
+
|
+
2017-09-30 + |
+Modified the following content:
+
|
+
2017-07-30 + |
+Modified the following content: +Added tag management. + |
+
2017-03-30 + |
+Modified the following content: +Added error codes AS.2015, AS.2026, AS.2039, and AS.2040 to Error Codes. + |
+
2016-12-30 + |
+Modified the following content: +
|
+
2016-10-29 + |
+Modified the following content: +Added the metadata field to Creating an AS Configuration. +Added error codes AS.7011, AS.1049, AS.1050, and AS.1052 to Error Codes. + |
+
2016-10-09 + |
+Modified the following content: +Modified the volume_type description in Creating an AS Configuration. + |
+
2016-08-25 + |
+Modified the following content: +
|
+
2016-08-09 + |
+Modified the following content: +Changed the maximum user data length to 32 KB in Creating an AS Configuration. + |
+
2016-06-30 + |
+Modified the following content: +
|
+
2016-06-16 + |
+Modified the following content: +
|
+
2016-06-02 + |
+Modified the following content: +
|
+
2016-05-05 + |
+Modified the following content: +
|
+
2016-04-14 + |
+Modified the following content: +
|
+
2016-03-09 + |
+This issue is the first official release. + |
+