From 5bdbeeee8c831d27ab806a5eb2a901f3dd845dc3 Mon Sep 17 00:00:00 2001 From: "Youyuan, Pan" Date: Wed, 7 Dec 2022 16:06:33 +0000 Subject: [PATCH] Added event monitoring metrics in CES API Reference. Reviewed-by: Hasko, Vladimir Co-authored-by: Youyuan, Pan Co-committed-by: Youyuan, Pan --- docs/ces/api-ref/ALL_META.TXT.json | 322 +++++ docs/ces/api-ref/CLASS.TXT.json | 290 +++++ docs/ces/api-ref/ErrorCode.html | 312 +++++ docs/ces/api-ref/PARAMETERS.txt | 3 + docs/ces/api-ref/ces_01_0054.html | 1130 +++++++++++++++++ docs/ces/api-ref/ces_03_0001.html | 9 + docs/ces/api-ref/ces_03_0018.html | 22 + docs/ces/api-ref/ces_03_0019.html | 18 + docs/ces/api-ref/ces_03_0020.html | 190 +++ docs/ces/api-ref/ces_03_0021.html | 209 +++ docs/ces/api-ref/ces_03_0022.html | 16 + docs/ces/api-ref/ces_03_0023.html | 321 +++++ docs/ces/api-ref/ces_03_0026.html | 24 + docs/ces/api-ref/ces_03_0027.html | 581 +++++++++ docs/ces/api-ref/ces_03_0028.html | 444 +++++++ docs/ces/api-ref/ces_03_0029.html | 126 ++ docs/ces/api-ref/ces_03_0030.html | 98 ++ docs/ces/api-ref/ces_03_0031.html | 509 ++++++++ docs/ces/api-ref/ces_03_0032.html | 22 + docs/ces/api-ref/ces_03_0033.html | 309 +++++ docs/ces/api-ref/ces_03_0034.html | 610 +++++++++ docs/ces/api-ref/ces_03_0035.html | 227 ++++ docs/ces/api-ref/ces_03_0036.html | 16 + docs/ces/api-ref/ces_03_0037.html | 184 +++ docs/ces/api-ref/ces_03_0038.html | 20 + docs/ces/api-ref/ces_03_0053.html | 16 + docs/ces/api-ref/ces_03_0055.html | 121 ++ docs/ces/api-ref/ces_03_0057.html | 15 + docs/ces/api-ref/ces_03_0058.html | 14 + docs/ces/api-ref/ces_03_0059.html | 180 +++ docs/ces/api-ref/ces_03_0060.html | 188 +++ docs/ces/api-ref/ces_03_0074.html | 294 +++++ docs/ces/api-ref/ces_03_0075.html | 491 +++++++ docs/ces/api-ref/en-us_image_0218975120.png | Bin 0 -> 54806 bytes docs/ces/api-ref/en-us_topic_0032831274.html | 328 +++++ docs/ces/api-ref/en-us_topic_0109034020.html | 339 +++++ .../caution_3.0-en-us.png | Bin 0 -> 2752 bytes .../public_sys-resources/commonltr.css | 1 + .../public_sys-resources/commonltr_print.css | 1 + .../public_sys-resources/commonrtl.css | 2 + .../public_sys-resources/danger_3.0-en-us.png | Bin 0 -> 2771 bytes .../api-ref/public_sys-resources/delta.gif | Bin 0 -> 836 bytes .../api-ref/public_sys-resources/deltaend.gif | Bin 0 -> 834 bytes .../public_sys-resources/icon-arrowdn.gif | Bin 0 -> 68 bytes .../public_sys-resources/icon-arrowrt.gif | Bin 0 -> 70 bytes .../public_sys-resources/icon-caution.gif | Bin 0 -> 1086 bytes .../public_sys-resources/icon-danger.gif | Bin 0 -> 1086 bytes .../public_sys-resources/icon-huawei.gif | Bin 0 -> 2767 bytes .../public_sys-resources/icon-note.gif | Bin 0 -> 983 bytes .../public_sys-resources/icon-notice.gif | Bin 0 -> 962 bytes .../api-ref/public_sys-resources/icon-tip.gif | Bin 0 -> 879 bytes .../public_sys-resources/icon-warning.gif | Bin 0 -> 1086 bytes .../public_sys-resources/note_3.0-en-us.png | Bin 0 -> 1080 bytes .../public_sys-resources/notice_3.0-en-us.png | Bin 0 -> 1672 bytes .../warning_3.0-en-us.png | Bin 0 -> 3164 bytes 55 files changed, 8002 insertions(+) create mode 100644 docs/ces/api-ref/ALL_META.TXT.json create mode 100644 docs/ces/api-ref/CLASS.TXT.json create mode 100644 docs/ces/api-ref/ErrorCode.html create mode 100644 docs/ces/api-ref/PARAMETERS.txt create mode 100644 docs/ces/api-ref/ces_01_0054.html create mode 100644 docs/ces/api-ref/ces_03_0001.html create mode 100644 docs/ces/api-ref/ces_03_0018.html create mode 100644 docs/ces/api-ref/ces_03_0019.html create mode 100644 docs/ces/api-ref/ces_03_0020.html create mode 100644 docs/ces/api-ref/ces_03_0021.html create mode 100644 docs/ces/api-ref/ces_03_0022.html create mode 100644 docs/ces/api-ref/ces_03_0023.html create mode 100644 docs/ces/api-ref/ces_03_0026.html create mode 100644 docs/ces/api-ref/ces_03_0027.html create mode 100644 docs/ces/api-ref/ces_03_0028.html create mode 100644 docs/ces/api-ref/ces_03_0029.html create mode 100644 docs/ces/api-ref/ces_03_0030.html create mode 100644 docs/ces/api-ref/ces_03_0031.html create mode 100644 docs/ces/api-ref/ces_03_0032.html create mode 100644 docs/ces/api-ref/ces_03_0033.html create mode 100644 docs/ces/api-ref/ces_03_0034.html create mode 100644 docs/ces/api-ref/ces_03_0035.html create mode 100644 docs/ces/api-ref/ces_03_0036.html create mode 100644 docs/ces/api-ref/ces_03_0037.html create mode 100644 docs/ces/api-ref/ces_03_0038.html create mode 100644 docs/ces/api-ref/ces_03_0053.html create mode 100644 docs/ces/api-ref/ces_03_0055.html create mode 100644 docs/ces/api-ref/ces_03_0057.html create mode 100644 docs/ces/api-ref/ces_03_0058.html create mode 100644 docs/ces/api-ref/ces_03_0059.html create mode 100644 docs/ces/api-ref/ces_03_0060.html create mode 100644 docs/ces/api-ref/ces_03_0074.html create mode 100644 docs/ces/api-ref/ces_03_0075.html create mode 100644 docs/ces/api-ref/en-us_image_0218975120.png create mode 100644 docs/ces/api-ref/en-us_topic_0032831274.html create mode 100644 docs/ces/api-ref/en-us_topic_0109034020.html create mode 100644 docs/ces/api-ref/public_sys-resources/caution_3.0-en-us.png create mode 100644 docs/ces/api-ref/public_sys-resources/commonltr.css create mode 100644 docs/ces/api-ref/public_sys-resources/commonltr_print.css create mode 100644 docs/ces/api-ref/public_sys-resources/commonrtl.css create mode 100644 docs/ces/api-ref/public_sys-resources/danger_3.0-en-us.png create mode 100644 docs/ces/api-ref/public_sys-resources/delta.gif create mode 100644 docs/ces/api-ref/public_sys-resources/deltaend.gif create mode 100644 docs/ces/api-ref/public_sys-resources/icon-arrowdn.gif create mode 100644 docs/ces/api-ref/public_sys-resources/icon-arrowrt.gif create mode 100644 docs/ces/api-ref/public_sys-resources/icon-caution.gif create mode 100644 docs/ces/api-ref/public_sys-resources/icon-danger.gif create mode 100644 docs/ces/api-ref/public_sys-resources/icon-huawei.gif create mode 100644 docs/ces/api-ref/public_sys-resources/icon-note.gif create mode 100644 docs/ces/api-ref/public_sys-resources/icon-notice.gif create mode 100644 docs/ces/api-ref/public_sys-resources/icon-tip.gif create mode 100644 docs/ces/api-ref/public_sys-resources/icon-warning.gif create mode 100644 docs/ces/api-ref/public_sys-resources/note_3.0-en-us.png create mode 100644 docs/ces/api-ref/public_sys-resources/notice_3.0-en-us.png create mode 100644 docs/ces/api-ref/public_sys-resources/warning_3.0-en-us.png diff --git a/docs/ces/api-ref/ALL_META.TXT.json b/docs/ces/api-ref/ALL_META.TXT.json new file mode 100644 index 000000000..6e9f6bc7d --- /dev/null +++ b/docs/ces/api-ref/ALL_META.TXT.json @@ -0,0 +1,322 @@ +[ + { + "uri":"ces_03_0001.html", + "product_code":"ces", + "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":"ces_03_0018.html", + "product_code":"ces", + "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 Description", + "title":"API Description", + "githuburl":"" + }, + { + "uri":"ces_03_0019.html", + "product_code":"ces", + "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":"API Version Management", + "title":"API Version Management", + "githuburl":"" + }, + { + "uri":"ces_03_0020.html", + "product_code":"ces", + "code":"4", + "des":"This API is used to query all API versions supported by Cloud Eye.GET /Example requestResponse parametersParameter descriptionParameterTypeDescriptionversionsArray of obj", + "doc_type":"api", + "kw":"Querying All API Versions,API Version Management,API Reference", + "title":"Querying All API Versions", + "githuburl":"" + }, + { + "uri":"ces_03_0021.html", + "product_code":"ces", + "code":"5", + "des":"This API is used to query a specified API version of Cloud Eye.GET /{api_version}Parameter descriptionParameter descriptionParameterMandatoryDescriptionapi_versionYesSpec", + "doc_type":"api", + "kw":"Querying a Specified API Version,API Version Management,API Reference", + "title":"Querying a Specified API Version", + "githuburl":"" + }, + { + "uri":"ces_03_0022.html", + "product_code":"ces", + "code":"6", + "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":"Metric Management", + "title":"Metric Management", + "githuburl":"" + }, + { + "uri":"ces_03_0023.html", + "product_code":"ces", + "code":"7", + "des":"This API is used to query the metrics. You can specify the namespace, metric, dimension, sorting order, start records, and the maximum number of records when using this A", + "doc_type":"api", + "kw":"Querying Metrics,Metric Management,API Reference", + "title":"Querying Metrics", + "githuburl":"" + }, + { + "uri":"ces_03_0026.html", + "product_code":"ces", + "code":"8", + "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":"Alarm Rule Management", + "title":"Alarm Rule Management", + "githuburl":"" + }, + { + "uri":"ces_03_0027.html", + "product_code":"ces", + "code":"9", + "des":"This API is used to query the alarm rule list. You can specify the paging parameters to limit the number of query results displayed on a page. You can also set the sortin", + "doc_type":"api", + "kw":"Querying Alarm Rules,Alarm Rule Management,API Reference", + "title":"Querying Alarm Rules", + "githuburl":"" + }, + { + "uri":"ces_03_0028.html", + "product_code":"ces", + "code":"10", + "des":"This API is used to query an alarm rule based on the alarm rule ID.GET /V1.0/{project_id}/alarms/{alarm_id}Parameter descriptionParameter descriptionParameterMandatoryDes", + "doc_type":"api", + "kw":"Querying an Alarm Rule,Alarm Rule Management,API Reference", + "title":"Querying an Alarm Rule", + "githuburl":"" + }, + { + "uri":"ces_03_0029.html", + "product_code":"ces", + "code":"11", + "des":"This API is used to enable or disable an alarm rule.PUT /V1.0/{project_id}/alarms/{alarm_id}/actionParameter descriptionParameter descriptionParameterMandatoryDescription", + "doc_type":"api", + "kw":"Enabling or Disabling an Alarm Rule,Alarm Rule Management,API Reference", + "title":"Enabling or Disabling an Alarm Rule", + "githuburl":"" + }, + { + "uri":"ces_03_0030.html", + "product_code":"ces", + "code":"12", + "des":"This API is used to delete an alarm rule.DELETE /V1.0/{project_id}/alarms/{alarm_id}Parameter descriptionParameter descriptionParameterMandatoryDescriptionproject_idYesSp", + "doc_type":"api", + "kw":"Deleting an Alarm Rule,Alarm Rule Management,API Reference", + "title":"Deleting an Alarm Rule", + "githuburl":"" + }, + { + "uri":"ces_03_0031.html", + "product_code":"ces", + "code":"13", + "des":"This API is used to create an alarm rule.POST /V1.0/{project_id}/alarmsParameter descriptionParameter descriptionParameterMandatoryDescriptionproject_idYesSpecifies the p", + "doc_type":"api", + "kw":"Creating an Alarm Rule,Alarm Rule Management,API Reference", + "title":"Creating an Alarm Rule", + "githuburl":"" + }, + { + "uri":"ces_03_0032.html", + "product_code":"ces", + "code":"14", + "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":"Monitoring Data Management", + "title":"Monitoring Data Management", + "githuburl":"" + }, + { + "uri":"ces_03_0033.html", + "product_code":"ces", + "code":"15", + "des":"This API is used to query the monitoring data at a specified granularity for a specified metric in a specified period of time. You can specify the dimension of data to be", + "doc_type":"api", + "kw":"Querying Monitoring Data,Monitoring Data Management,API Reference", + "title":"Querying Monitoring Data", + "githuburl":"" + }, + { + "uri":"en-us_topic_0032831274.html", + "product_code":"ces", + "code":"16", + "des":"This API is used to add one or more pieces of custom metric monitoring data to solve the problem that the system metrics cannot meet specific service requirements.POST /V", + "doc_type":"api", + "kw":"Adding Monitoring Data,Monitoring Data Management,API Reference", + "title":"Adding Monitoring Data", + "githuburl":"" + }, + { + "uri":"ces_03_0034.html", + "product_code":"ces", + "code":"17", + "des":"You can query the monitoring data of specified metrics within a specified time range and specified granularities in batches. At present, you can query the monitoring data", + "doc_type":"api", + "kw":"Querying Monitoring Data in Batches,Monitoring Data Management,API Reference", + "title":"Querying Monitoring Data in Batches", + "githuburl":"" + }, + { + "uri":"ces_03_0035.html", + "product_code":"ces", + "code":"18", + "des":"This API is used to query the host configuration for a specified event type in a specified period of time. You can specify the dimension of data to be queried.This API is", + "doc_type":"api", + "kw":"Querying the Host Configuration,Monitoring Data Management,API Reference", + "title":"Querying the Host Configuration", + "githuburl":"" + }, + { + "uri":"ces_03_0036.html", + "product_code":"ces", + "code":"19", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"Quota Management", + "title":"Quota Management", + "githuburl":"" + }, + { + "uri":"ces_03_0037.html", + "product_code":"ces", + "code":"20", + "des":"This API is used to query a resource quota and the used amount. The current resource refers to alarm rules only.GET /V1.0/{project_id}/quotasParameter descriptionParamete", + "doc_type":"api", + "kw":"Querying Quotas,Quota Management,API Reference", + "title":"Querying Quotas", + "githuburl":"" + }, + { + "uri":"ces_03_0038.html", + "product_code":"ces", + "code":"21", + "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":"Event Monitoring", + "title":"Event Monitoring", + "githuburl":"" + }, + { + "uri":"en-us_topic_0109034020.html", + "product_code":"ces", + "code":"22", + "des":"An API for reporting custom events is provided, which helps you collect and report abnormal events or important change events to Cloud Eye.POST /V1.0/{project_id}/eventsP", + "doc_type":"api", + "kw":"Reporting Events,Event Monitoring,API Reference", + "title":"Reporting Events", + "githuburl":"" + }, + { + "uri":"ces_03_0074.html", + "product_code":"ces", + "code":"23", + "des":"This API is used to query the events, including system events and custom events.GET /V1.0/{project_id}/eventsParameter descriptionParameter descriptionParameterTypeMandat", + "doc_type":"api", + "kw":"Querying Events,Event Monitoring,API Reference", + "title":"Querying Events", + "githuburl":"" + }, + { + "uri":"ces_03_0075.html", + "product_code":"ces", + "code":"24", + "des":"This API is used to query the event details based on the event name.GET /V1.0/{project_id}/event/{event_name}Parameter descriptionParameter descriptionParameterTypeMandat", + "doc_type":"api", + "kw":"Querying Monitoring Details of an Event,Event Monitoring,API Reference", + "title":"Querying Monitoring Details of an Event", + "githuburl":"" + }, + { + "uri":"ces_03_0053.html", + "product_code":"ces", + "code":"25", + "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":"Common Parameters", + "title":"Common Parameters", + "githuburl":"" + }, + { + "uri":"ces_03_0055.html", + "product_code":"ces", + "code":"26", + "des":"NormalReturned ValueDescription200 OKThe results of GET and PUT operations are returned as expected.201 CreatedThe results of the POST operation are returned as expected.", + "doc_type":"api", + "kw":"Status Codes,Common Parameters,API Reference", + "title":"Status Codes", + "githuburl":"" + }, + { + "uri":"ErrorCode.html", + "product_code":"ces", + "code":"27", + "des":"If an error occurs during API calling, the system returns error information. This section describes the error codes contained in the error information for Cloud Eye APIs.", + "doc_type":"api", + "kw":"Error Codes,Common Parameters,API Reference", + "title":"Error Codes", + "githuburl":"" + }, + { + "uri":"ces_03_0057.html", + "product_code":"ces", + "code":"28", + "des":"A project ID needs to be specified in the URIs of some APIs. Therefore, you need to obtain the project ID before calling APIs. The following procedure describes how to ob", + "doc_type":"api", + "kw":"Obtaining a Project ID,Common Parameters,API Reference", + "title":"Obtaining a Project ID", + "githuburl":"" + }, + { + "uri":"ces_03_0058.html", + "product_code":"ces", + "code":"29", + "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":"ces_03_0059.html", + "product_code":"ces", + "code":"30", + "des":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "doc_type":"api", + "kw":"Services Interconnected with Cloud Eye,Appendix,API Reference", + "title":"Services Interconnected with Cloud Eye", + "githuburl":"" + }, + { + "uri":"ces_01_0054.html", + "product_code":"ces", + "code":"31", + "des":"Events in Event Monitoring come from operations on cloud service resources and are not collected by the Agent in Server Monitoring.Once a physical host running ECSs break", + "doc_type":"api", + "kw":"Events Supported by Event Monitoring,Appendix,API Reference", + "title":"Events Supported by Event Monitoring", + "githuburl":"" + }, + { + "uri":"ces_03_0060.html", + "product_code":"ces", + "code":"32", + "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/ces/api-ref/CLASS.TXT.json b/docs/ces/api-ref/CLASS.TXT.json new file mode 100644 index 000000000..e6688b5bf --- /dev/null +++ b/docs/ces/api-ref/CLASS.TXT.json @@ -0,0 +1,290 @@ +[ + { + "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":"ces", + "title":"API Usage Guidelines", + "uri":"ces_03_0001.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":"ces", + "title":"API Description", + "uri":"ces_03_0018.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":"ces", + "title":"API Version Management", + "uri":"ces_03_0019.html", + "doc_type":"api", + "p_code":"2", + "code":"3" + }, + { + "desc":"This API is used to query all API versions supported by Cloud Eye.GET /Example requestResponse parametersParameter descriptionParameterTypeDescriptionversionsArray of obj", + "product_code":"ces", + "title":"Querying All API Versions", + "uri":"ces_03_0020.html", + "doc_type":"api", + "p_code":"3", + "code":"4" + }, + { + "desc":"This API is used to query a specified API version of Cloud Eye.GET /{api_version}Parameter descriptionParameter descriptionParameterMandatoryDescriptionapi_versionYesSpec", + "product_code":"ces", + "title":"Querying a Specified API Version", + "uri":"ces_03_0021.html", + "doc_type":"api", + "p_code":"3", + "code":"5" + }, + { + "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":"ces", + "title":"Metric Management", + "uri":"ces_03_0022.html", + "doc_type":"api", + "p_code":"2", + "code":"6" + }, + { + "desc":"This API is used to query the metrics. You can specify the namespace, metric, dimension, sorting order, start records, and the maximum number of records when using this A", + "product_code":"ces", + "title":"Querying Metrics", + "uri":"ces_03_0023.html", + "doc_type":"api", + "p_code":"6", + "code":"7" + }, + { + "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":"ces", + "title":"Alarm Rule Management", + "uri":"ces_03_0026.html", + "doc_type":"api", + "p_code":"2", + "code":"8" + }, + { + "desc":"This API is used to query the alarm rule list. You can specify the paging parameters to limit the number of query results displayed on a page. You can also set the sortin", + "product_code":"ces", + "title":"Querying Alarm Rules", + "uri":"ces_03_0027.html", + "doc_type":"api", + "p_code":"8", + "code":"9" + }, + { + "desc":"This API is used to query an alarm rule based on the alarm rule ID.GET /V1.0/{project_id}/alarms/{alarm_id}Parameter descriptionParameter descriptionParameterMandatoryDes", + "product_code":"ces", + "title":"Querying an Alarm Rule", + "uri":"ces_03_0028.html", + "doc_type":"api", + "p_code":"8", + "code":"10" + }, + { + "desc":"This API is used to enable or disable an alarm rule.PUT /V1.0/{project_id}/alarms/{alarm_id}/actionParameter descriptionParameter descriptionParameterMandatoryDescription", + "product_code":"ces", + "title":"Enabling or Disabling an Alarm Rule", + "uri":"ces_03_0029.html", + "doc_type":"api", + "p_code":"8", + "code":"11" + }, + { + "desc":"This API is used to delete an alarm rule.DELETE /V1.0/{project_id}/alarms/{alarm_id}Parameter descriptionParameter descriptionParameterMandatoryDescriptionproject_idYesSp", + "product_code":"ces", + "title":"Deleting an Alarm Rule", + "uri":"ces_03_0030.html", + "doc_type":"api", + "p_code":"8", + "code":"12" + }, + { + "desc":"This API is used to create an alarm rule.POST /V1.0/{project_id}/alarmsParameter descriptionParameter descriptionParameterMandatoryDescriptionproject_idYesSpecifies the p", + "product_code":"ces", + "title":"Creating an Alarm Rule", + "uri":"ces_03_0031.html", + "doc_type":"api", + "p_code":"8", + "code":"13" + }, + { + "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":"ces", + "title":"Monitoring Data Management", + "uri":"ces_03_0032.html", + "doc_type":"api", + "p_code":"2", + "code":"14" + }, + { + "desc":"This API is used to query the monitoring data at a specified granularity for a specified metric in a specified period of time. You can specify the dimension of data to be", + "product_code":"ces", + "title":"Querying Monitoring Data", + "uri":"ces_03_0033.html", + "doc_type":"api", + "p_code":"14", + "code":"15" + }, + { + "desc":"This API is used to add one or more pieces of custom metric monitoring data to solve the problem that the system metrics cannot meet specific service requirements.POST /V", + "product_code":"ces", + "title":"Adding Monitoring Data", + "uri":"en-us_topic_0032831274.html", + "doc_type":"api", + "p_code":"14", + "code":"16" + }, + { + "desc":"You can query the monitoring data of specified metrics within a specified time range and specified granularities in batches. At present, you can query the monitoring data", + "product_code":"ces", + "title":"Querying Monitoring Data in Batches", + "uri":"ces_03_0034.html", + "doc_type":"api", + "p_code":"14", + "code":"17" + }, + { + "desc":"This API is used to query the host configuration for a specified event type in a specified period of time. You can specify the dimension of data to be queried.This API is", + "product_code":"ces", + "title":"Querying the Host Configuration", + "uri":"ces_03_0035.html", + "doc_type":"api", + "p_code":"14", + "code":"18" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ces", + "title":"Quota Management", + "uri":"ces_03_0036.html", + "doc_type":"api", + "p_code":"2", + "code":"19" + }, + { + "desc":"This API is used to query a resource quota and the used amount. The current resource refers to alarm rules only.GET /V1.0/{project_id}/quotasParameter descriptionParamete", + "product_code":"ces", + "title":"Querying Quotas", + "uri":"ces_03_0037.html", + "doc_type":"api", + "p_code":"19", + "code":"20" + }, + { + "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":"ces", + "title":"Event Monitoring", + "uri":"ces_03_0038.html", + "doc_type":"api", + "p_code":"2", + "code":"21" + }, + { + "desc":"An API for reporting custom events is provided, which helps you collect and report abnormal events or important change events to Cloud Eye.POST /V1.0/{project_id}/eventsP", + "product_code":"ces", + "title":"Reporting Events", + "uri":"en-us_topic_0109034020.html", + "doc_type":"api", + "p_code":"21", + "code":"22" + }, + { + "desc":"This API is used to query the events, including system events and custom events.GET /V1.0/{project_id}/eventsParameter descriptionParameter descriptionParameterTypeMandat", + "product_code":"ces", + "title":"Querying Events", + "uri":"ces_03_0074.html", + "doc_type":"api", + "p_code":"21", + "code":"23" + }, + { + "desc":"This API is used to query the event details based on the event name.GET /V1.0/{project_id}/event/{event_name}Parameter descriptionParameter descriptionParameterTypeMandat", + "product_code":"ces", + "title":"Querying Monitoring Details of an Event", + "uri":"ces_03_0075.html", + "doc_type":"api", + "p_code":"21", + "code":"24" + }, + { + "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":"ces", + "title":"Common Parameters", + "uri":"ces_03_0053.html", + "doc_type":"api", + "p_code":"", + "code":"25" + }, + { + "desc":"NormalReturned ValueDescription200 OKThe results of GET and PUT operations are returned as expected.201 CreatedThe results of the POST operation are returned as expected.", + "product_code":"ces", + "title":"Status Codes", + "uri":"ces_03_0055.html", + "doc_type":"api", + "p_code":"25", + "code":"26" + }, + { + "desc":"If an error occurs during API calling, the system returns error information. This section describes the error codes contained in the error information for Cloud Eye APIs.", + "product_code":"ces", + "title":"Error Codes", + "uri":"ErrorCode.html", + "doc_type":"api", + "p_code":"25", + "code":"27" + }, + { + "desc":"A project ID needs to be specified in the URIs of some APIs. Therefore, you need to obtain the project ID before calling APIs. The following procedure describes how to ob", + "product_code":"ces", + "title":"Obtaining a Project ID", + "uri":"ces_03_0057.html", + "doc_type":"api", + "p_code":"25", + "code":"28" + }, + { + "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":"ces", + "title":"Appendix", + "uri":"ces_03_0058.html", + "doc_type":"api", + "p_code":"", + "code":"29" + }, + { + "desc":"HUAWEI CLOUD Help Center presents technical documents to help you quickly get started with HUAWEI CLOUD services. The technical documents include Service Overview, Price Details, Purchase Guide, User Guide, API Reference, Best Practices, FAQs, and Videos.", + "product_code":"ces", + "title":"Services Interconnected with Cloud Eye", + "uri":"ces_03_0059.html", + "doc_type":"api", + "p_code":"29", + "code":"30" + }, + { + "desc":"Events in Event Monitoring come from operations on cloud service resources and are not collected by the Agent in Server Monitoring.Once a physical host running ECSs break", + "product_code":"ces", + "title":"Events Supported by Event Monitoring", + "uri":"ces_01_0054.html", + "doc_type":"api", + "p_code":"29", + "code":"31" + }, + { + "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":"ces", + "title":"Change History", + "uri":"ces_03_0060.html", + "doc_type":"api", + "p_code":"", + "code":"32" + } +] \ No newline at end of file diff --git a/docs/ces/api-ref/ErrorCode.html b/docs/ces/api-ref/ErrorCode.html new file mode 100644 index 000000000..45e8d38d6 --- /dev/null +++ b/docs/ces/api-ref/ErrorCode.html @@ -0,0 +1,312 @@ + + +

Error Codes

+

Function

If an error occurs during API calling, the system returns error information. This section describes the error codes contained in the error information for Cloud Eye APIs.

+
+

Example Response

{
+    "code": 400,
+    "element": "Bad Request",
+    "message": "The system received a request which cannot be recognized",
+    "details": {
+        "details": "Some content in message body is not correct",
+        "code": "ces.0014"
+    }
+}
+
+

Glossary

+
+ + + + + + + + + + + + + +

Glossary

+

Description

+

Cloud Eye

+

Cloud Eye

+

Built-in metric

+

Each service has its own built-in metrics and dimensions. For example, an ECS (SYS.ECS) supports cpu_util.

+

Metric

+

A metric consists of the namespace, dimension (optional), and metric name. A metric name solely does not identify any object.

+
+
+
+

Error Code Description

+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Module

+

HTTP Status Code

+

Error Code

+

Error Code Description

+

Error Message

+

Measure

+

Cloud Eye

+

500

+

ces.0007

+

Internal service error

+

Internal service error.

+

Contact technical support.

+

API

+

400

+

ces.0001

+

The request content cannot be empty.

+

The content must be specified.

+

Specify the request content.

+

400

+

ces.0003

+

The project ID is left blank or is incorrect.

+

The tenant ID is left blank or incorrect.

+

Add or use the correct tenant ID.

+

400

+

ces.0004

+

The API version is not specified.

+

The API version must be specified.

+

Specify the API version in the request URL.

+

400

+

ces.0005

+

The API version is incorrect.

+

The API version is incorrect.

+

Use the correct API version.

+

400

+

ces.0006

+

The paging address is incorrect.

+

The paging address is incorrect.

+

Use correct pagination information.

+

403

+

ces.0009

+

System metrics cannot be added.

+

Adding SYS metric is not allowed

+

Use correct rights to add metrics.

+

403

+

ces.0010

+

System metrics cannot be deleted.

+

Deleting SYS metric is not allowed

+

Use correct rights to delete metrics.

+

400

+

ces.0011

+

The request is invalid.

+

The request is invalid.

+

Check the request.

+

400

+

ces.0013

+

The URL parameter is invalid or does not exist.

+

The URL parameter is invalid or does not exist.

+

Check the URL parameter.

+

400

+

ces.0014

+

Some content in the message body is correct.

+

Some content in message body is not correct.

+

Check the request body parameters.

+

401

+

ces.0015

+

Authentication fails or valid authentication information is not provided.

+

Authentication fails or the authentication information is not provided.

+

Check whether the user name or password (or AK or SK) for obtaining the token is correct.

+

404

+

ces.0016

+

The requested resource does not exist.

+

The requested resource does not exist.

+

Check whether the requested resource exists.

+

403

+

ces.0017

+

The authentication information is incorrect or the service invoker does not have sufficient rights.

+

The authentication information is incorrect or the service invoker does not have sufficient rights.

+

Check whether the user name or password (or AK or SK) or the user rights for obtaining the token are correct.

+

Cassandra

+

500

+

ces.0008

+

Database error

+

Database error.

+

Contact technical support.

+

Kafka

+

500

+

ces.0012

+

The message queue is abnormal or is not ready.

+

The message queue is abnormal or is not ready.

+

Contact technical support.

+

Zookeeper

+

500

+

ces.0021

+

Internal locking error

+

Internal locking error

+

Contact technical support.

+

Blueflood

+

500

+

ces.0019

+

The metric processing engine is abnormal.

+

The metric processing engine is abnormal.

+

Contact technical support.

+

Alarm

+

400

+

ces.0002

+

The alarm ID cannot be left blank.

+

The alarm ID must be specified.

+

Specify the alarm ID.

+

403

+

ces.0018

+

The number of alarm rules created exceeds the quota.

+

The number of alarms exceeds the quota

+

Apply for a higher alarm quota.

+

400

+

ces.0028

+

The metric and notification type do not match when an alarm rule is created.

+

The metric does not support the alarm action type.

+

Modify the metric or notification type according to the parameter description to make them match.

+
+
+
+
+
+
+
Parent topic: Common Parameters
+
+
+ diff --git a/docs/ces/api-ref/PARAMETERS.txt b/docs/ces/api-ref/PARAMETERS.txt new file mode 100644 index 000000000..6da8d5f07 --- /dev/null +++ b/docs/ces/api-ref/PARAMETERS.txt @@ -0,0 +1,3 @@ +version="" +language="en-us" +type="" \ No newline at end of file diff --git a/docs/ces/api-ref/ces_01_0054.html b/docs/ces/api-ref/ces_01_0054.html new file mode 100644 index 000000000..f6d1e3c27 --- /dev/null +++ b/docs/ces/api-ref/ces_01_0054.html @@ -0,0 +1,1130 @@ + + +

Events Supported by Event Monitoring

+

Events in Event Monitoring come from operations on cloud service resources and are not collected by the Agent in Server Monitoring.

+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1 ECS

Event Source

+

Event Name

+

Event ID

+

Event Severity

+

Description

+

Solution

+

Impact

+

ECS

+

Delete ECS

+

deleteServer

+

Major

+

The ECS was deleted

+
  • on the management console.
  • by calling APIs.
+

Check whether the deletion was performed intentionally by a user.

+

Services are interrupted.

+

Reboot ECS

+

rebootServer

+

Minor

+

The ECS was restarted

+
  • on the management console.
  • by calling APIs.
+

Check whether the restart was performed intentionally by a user.

+
  • Deploy service applications in HA mode.
  • After the ECS starts up, check whether services recover.
+

Services are interrupted.

+

Resize ECS

+

resizeServer

+

Minor

+

The ECS was resized

+
  • on the management console.
  • by calling APIs.
+
  • Check whether the operation was performed by a user.
  • Deploy service applications in HA mode.
  • After the ECS is resized, check whether services have recovered.
+

Services are interrupted.

+

Start auto recovery

+

startAutoRecovery

+

Major

+

ECSs on a faulty host would be automatically migrated to another properly-running host. During the migration, the ECSs was restarted.

+

Wait for the event to end and check whether services are affected.

+

Services may be interrupted.

+

Stop auto recovery

+

endAutoRecovery

+

Major

+

The ECS was restored to be normal after the automatic migration.

+

This event indicates that the ECS has been recovered and been working properly.

+

None

+

Auto recovery timeout (being processed on the backend)

+

faultAutoRecovery

+

Major

+

Migrating the ECS to a normal host timed out.

+

Migrate services to other ECSs.

+

Services are interrupted.

+

Improper ECS running

+

vmIsRunningImproperly

+

Major

+

The ECS was faulty or the ECS NIC was abnormal.

+

Deploy service applications in HA mode.

+

After the fault is rectified, check whether services recover.

+

Services are interrupted.

+

Improper ECS running recovered

+

vmIsRunningImproperlyRecovery

+

Major

+

The ECS was restored to the normal status.

+

Wait for the ECS status to become normal and check whether services are affected.

+

None

+

VM faults caused by host process exceptions

+

VMFaultsByHostProcessExceptions

+

Critical

+

The processes of the host accommodating the ECS were abnormal.

+

Contact O&M personnel.

+

The ECS is faulty.

+

Restarted GuestOS

+

RestartGuestOS

+

Minor

+

The guest OS was restarted.

+

Contact O&M personnel.

+

Services may be interrupted.

+
+
+

Once a physical host running ECSs breaks down, the ECSs are automatically migrated to a functional physical host. During the migration, the ECSs will be restarted.

+
+ +
+ + + + + + + + + + + + + + + + + +
Table 2 Advanced Anti-DDoS (AAD)

Event Source

+

Event Name

+

Event ID

+

Event Severity

+

Description

+

Solution

+

Impact

+

AAD

+

DDoS Attack Events

+

ddosAttackEvents

+

Major

+

A DDoS attack occurs in the AAD protected lines.

+

Judge the impact on services based on the attack traffic and attack type. If the attack traffic exceeds your purchased elastic bandwidth, change to another line or increase your bandwidth.

+

Services may be interrupted.

+
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 3 CBR

Event Source

+

Event Name

+

Event ID

+

Event Severity

+

Description

+

Solution

+

Impact

+

CBR

+

Failed to create the backup.

+

backupFailed

+

Critical

+

The backup failed to be created.

+

Manually create a backup or contact customer service.

+

Data loss may occur.

+

Failed to restore the resource using a backup.

+

restorationFailed

+

Critical

+

The resource failed to be restored using a backup.

+

Restore the resource using another backup or contact customer service.

+

Data loss may occur.

+

Failed to delete the backup.

+

backupDeleteFailed

+

Critical

+

The backup failed to be deleted.

+

Try again later or contact customer service.

+

Charging may be abnormal.

+

Failed to delete the vault.

+

vaultDeleteFailed

+

Critical

+

The vault failed to be deleted.

+

Try again later or contact technical support.

+

Charging may be abnormal.

+

Replication failure

+

replicationFailed

+

Critical

+

The backup failed to be replicated.

+

Try again later or contact technical support.

+

Data loss may occur.

+

The backup is created successfully.

+

backupSucceeded

+

Major

+

The backup was created.

+

None

+

None

+

Resource restoration using a backup succeeded.

+

restorationSucceeded

+

Major

+

The resource was restored using a backup.

+

Check whether the data is successfully restored.

+

None

+

The backup is deleted successfully.

+

backupDeletionSucceeded

+

Major

+

The backup was deleted.

+

None

+

None

+

The vault is deleted successfully.

+

vaultDeletionSucceeded

+

Major

+

The vault was deleted.

+

None

+

None

+

Replication success

+

replicationSucceeded

+

Major

+

The backup was replicated successfully.

+

None

+

None

+
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 4 RDS — resource exception

Event Source

+

Event Name

+

Event ID

+

Event Severity

+

Description

+

Solution

+

Impact

+

RDS

+

Full backup failure

+

fullBackupFailed

+

Major

+

A single full backup failure does not affect the files that have been successfully backed up, but prolong the incremental backup time during the point-in-time restore (PITR).

+

Create a manual backup again.

+

Backup failed.

+

Primary/standby switchover or failover

+

PrimaryStandbySwitched

+

Major

+

This event is reported when a primary/standby switchover or a failover is triggered.

+
  1. After the switchover or failover is complete, check whether workloads are restored. If workloads are not restored, contact SRE engineers.
  2. Ignore the event if you have performed a switchover.
  3. If the failover is triggered by a node fault, contact the SRE engineers.
+

Downtime occurs during the switchover.

+

Replication status abnormal

+

abnormalReplicationStatus

+

Major

+

The possible causes are as follows:

+

The replication delay between the primary and standby instances is too long, which usually occurs when a large amount of data is written to databases or a large transaction is processed. During peak hours, data may be blocked.

+

The network between the primary and standby instances is disconnected.

+

Submit a service ticket.

+

Your applications are not affected because this event does not interrupt data read and write.

+

Replication status recovered

+

replicationStatusRecovered

+

Major

+

The replication delay between the primary and standby instances is within the normal range, or the network connection between them has restored.

+

No action is required.

+

None

+

DB instance faulty

+

faultyDBInstance

+

Major

+

A single or primary DB instance was faulty due to a disaster or a server failure.

+

Check whether an automated backup policy has been configured for the DB instance and submit a service ticket.

+

The database service may be unavailable.

+

DB instance recovered

+

DBInstanceRecovered

+

Major

+

RDS rebuilds the standby DB instance with its high availability. After the instance is rebuilt, this event will be reported.

+

No action is required.

+

None

+

Failure of changing single DB instance to primary/standby

+

singleToHaFailed

+

Major

+

A fault occurs when RDS is creating the standby DB instance or configuring replication between the primary and standby DB instances. The fault may occur because resources are insufficient in the data center where the standby DB instance is located.

+

Submit a service ticket.

+

Your applications are not affected because this event does not interrupt data read and write of the DB instance.

+

Database process restarted

+

DatabaseProcessRestarted

+

Major

+

The database process is stopped due to insufficient memory or high load.

+

Log in to the Cloud Eye console. Check whether the memory usage increases sharply, the CPU usage is too high for a long time, or the storage space is insufficient. You can increase the CPU and memory specifications or optimize the service logic.

+

Downtime occurs. When this happens, RDS automatically restarts the database process and attempts to recover the workloads.

+

Instance storage full

+

instanceDiskFull

+

Major

+

Generally, the cause is that the data space usage is too high.

+

Scale up the instance.

+

The DB instance becomes read-only because the storage space is full, and data cannot be written to the database.

+

Instance storage full recovered

+

instanceDiskFullRecovered

+

Major

+

The instance disk is recovered.

+

No action is required.

+

Cancel the read-only state of the instance and resume write operations.

+

Read replica promotion failure

+

activeStandBySwitchFailed

+

Major

+

The read replica fails to be promoted to the primary DB instance due to network or server failures. The original primary DB instance takes over workloads quickly.

+

Submit a service ticket.

+

The read replica fails to be promoted to the primary DB instance.

+
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 5 GaussDB(for MySQL)

Event Source

+

Event Name

+

Event ID

+

Event Severity

+

Description

+

Solution

+

Impact

+

GaussDB(for MySQL)

+

Incremental backup failure

+

TaurusIncrementalBackupInstanceFailed

+

Major

+

The network between the instance and the management plane (or the OBS) is disconnected, or the backup environment created for the instance is abnormal.

+

Submit a service ticket.

+

Backup jobs fail.

+

Read replica creation failure

+

addReadonlyNodesFailed

+

Major

+

The quota is insufficient or underlying resources are exhausted.

+

Check the read replica quota. Release resources and create read replicas again.

+

Read replicas fail to be created.

+

DB instance creation failure

+

createInstanceFailed

+

Major

+

The instance quota or underlying resources are insufficient.

+

Check the instance quota. Release resources and create instances again.

+

DB instances fail to be created.

+

Read replica promotion failure

+

activeStandBySwitchFailed

+

Major

+

The read replica fails to be promoted to the primary node due to network or server failures. The original primary node takes over services quickly.

+

Submit a service ticket.

+

The read replica fails to be promoted to the primary node.

+

Instance specifications change failure

+

flavorAlterationFailed

+

Major

+

The quota is insufficient or underlying resources are exhausted.

+

Submit a service ticket.

+

Instance specifications fail to be changed.

+

Faulty DB instance

+

TaurusInstanceRunningStatusAbnormal

+

Major

+

The instance process is faulty or the communications between the instance and the DFV storage are abnormal.

+

Submit a service ticket.

+

Services may be affected.

+

DB instance recovered

+

TaurusInstanceRunningStatusRecovered

+

Major

+

The instance is recovered.

+

Observe the service running status.

+

None

+

Faulty node

+

TaurusNodeRunningStatusAbnormal

+

Major

+

The node process is faulty or the communications between the node and the DFV storage are abnormal.

+

Observe the instance and service running statuses.

+

A read replica may be promoted to the primary node.

+

Node recovered

+

TaurusNodeRunningStatusRecovered

+

Major

+

The node is recovered.

+

Observe the service running status.

+

None

+

Read replica deletion failure

+

TaurusDeleteReadOnlyNodeFailed

+

Major

+

The communications between the management plane and the read replica are abnormal or the VM fails to be deleted from IaaS.

+

Submit a service ticket.

+

Read replicas fail to be deleted.

+

Password reset failure

+

TaurusResetInstancePasswordFailed

+

Major

+

The communications between the management plane and the instance are abnormal or the instance is abnormal.

+

Check the instance status and try again. If the fault persists, submit a service ticket.

+

Passwords fail to be reset for instances.

+

DB instance reboot failure

+

TaurusRestartInstanceFailed

+

Major

+

The network between the management plane and the instance is abnormal or the instance is abnormal.

+

Check the instance status and try again. If the fault persists, submit a service ticket.

+

Instances fail to be rebooted.

+

Restoration to new DB instance failure

+

TaurusRestoreToNewInstanceFailed

+

Major

+

The instance quota is insufficient, underlying resources are exhausted, or the data restoration logic is incorrect.

+

If the new instance fails to be created, check the instance quota, release resources, and try to restore to a new instance again. In other cases, submit a service ticket.

+

Backup data fails to be restored to new instances.

+

EIP binding failure

+

TaurusBindEIPToInstanceFailed

+

Major

+

The binding task fails.

+

Submit a service ticket.

+

EIPs fail to be bound to instances.

+

EIP unbinding failure

+

TaurusUnbindEIPFromInstanceFailed

+

Major

+

The unbinding task fails.

+

Submit a service ticket.

+

EIPs fail to be unbound from instances.

+

Parameter modification failure

+

TaurusUpdateInstanceParameterFailed

+

Major

+

The network between the management plane and the instance is abnormal or the instance is abnormal.

+

Check the instance status and try again. If the fault persists, submit a service ticket.

+

Instance parameters fail to be modified.

+

Parameter template application failure

+

TaurusApplyParameterGroupToInstanceFailed

+

Major

+

The network between the management plane and instances is abnormal or the instances are abnormal.

+

Check the instance status and try again. If the fault persists, submit a service ticket.

+

Parameter templates fail to be applied to instances.

+

Full backup failure

+

TaurusBackupInstanceFailed

+

Major

+

The network between the instance and the management plane (or the OBS) is disconnected, or the backup environment created for the instance is abnormal.

+

Submit a service ticket.

+

Backup jobs fail.

+

Primary/standby failover

+

TaurusActiveStandbySwitched

+

Major

+

When the network, physical machine, or database of the primary node is faulty, the system promotes a read replica to primary based on the failover priority to ensure service continuity.

+
  1. Check whether the service is running properly.
  2. Check whether an alarm is generated, indicating that the read replica failed to be promoted to primary.
+

During the failover, database connection is interrupted for a short period of time. After the failover is complete, you can reconnect to the database.

+

Database read-only

+

NodeReadonlyMode

+

Major

+

The database supports only query operations.

+

Contact the database technical support team.

+

After the database becomes read-only, write operations cannot be processed.

+

Database read/write

+

NodeReadWriteMode

+

Major

+

The database supports both write and read operations.

+

None.

+

None.

+
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 6 GaussDB(for openGauss)

Event Source

+

Event Name

+

Event ID

+

Event Severity

+

Description

+

Solution

+

Impact

+

GaussDB(for openGauss)

+

Process status alarm

+

ProcessStatusAlarm

+

Major

+

Key processes exit, including: CMS/CMA, ETCD, GTM, CN, or DN process.

+

Wait until the process is automatically recovered or a primary/standby failover is automatically performed. Check whether services are recovered. If no, contact SRE engineers.

+

If processes on primary nodes are faulty, services are interrupted and then rolled back. If processes on standby nodes are faulty, services are not affected.

+

Component status alarm

+

ComponentStatusAlarm

+

Major

+

Key components do not respond, including: CMA, ETCD, GTM, CN, or DN component.

+

Wait until the process is automatically recovered or a primary/standby failover is automatically performed. Check whether services are recovered. If no, contact SRE engineers.

+

If processes on primary nodes do not respond, neither do the services. If processes on standby nodes are faulty, services are not affected.

+

Cluster status alarm

+

ClusterStatusAlarm

+

Major

+

The cluster status is abnormal. For example, the cluster is read-only; majority of ETCDs are faulty; or the cluster resources are unevenly distributed.

+

Contact SRE engineers.

+

If the cluster status is read-only, only read services are processed.

+

If the majority of ETCDs are fault, the cluster is unavailable.

+

If resources are unevenly distributed, the instance performance and reliability deteriorate.

+

Hardware resource alarm

+

HardwareResourceAlarm

+

Major

+

A major hardware fault occurs in the instance, such as disk damage or GTM network fault.

+

Contact SRE engineers.

+

Some or all services are affected.

+

Status transition alarm

+

StateTransitionAlarm

+

Major

+

The following events occur in the instance: DN build failure, forcible DN promotion, primary/standby DN switchover/failover, or primary/standby GTM switchover/failover.

+

Wait until the fault is automatically rectified and check whether services are recovered. If no, contact SRE engineers.

+

Some services are interrupted.

+

Other abnormal alarm

+

OtherAbnormalAlarm

+

Major

+

Disk usage threshold alarm

+

Focus on service changes and scale up storage space as needed.

+

If the used storage space exceeds the threshold, storage space cannot be scaled up.

+

Faulty DB instance

+

TaurusInstanceRunningStatusAbnormal

+

Major

+

This event is a key alarm event and is reported when an instance is faulty due to a disaster or a server failure.

+

Submit a service ticket.

+

The database service may be unavailable.

+

DB instance recovered

+

TaurusInstanceRunningStatusRecovered

+

Major

+

GaussDB(for openGauss) provides an HA tool for automated or manual rectification of faults. After the fault is rectified, this event is reported.

+

No further action is required.

+

None

+

Faulty DB node

+

TaurusNodeRunningStatusAbnormal

+

Major

+

This event is a key alarm event and is reported when a database node is faulty due to a disaster or a server failure.

+

Check whether the database service is available and submit a service ticket.

+

The database service may be unavailable.

+

DB node recovered

+

TaurusNodeRunningStatusRecovered

+

Major

+

GaussDB(for openGauss) provides an HA tool for automated or manual rectification of faults. After the fault is rectified, this event is reported.

+

No further action is required.

+

None

+

DB instance creation failure

+

GaussDBV5CreateInstanceFailed

+

Major

+

Instances fail to be created because the quota is insufficient or underlying resources are exhausted.

+

Release the instances that are no longer used and try to provision them again, or submit a service ticket to adjust the quota.

+

DB instances cannot be created.

+

Node adding failure

+

GaussDBV5ExpandClusterFailed

+

Major

+

The underlying resources are insufficient.

+

Submit a service ticket. The O&M personnel will coordinate resources in the background, and then you delete the node that failed to be added and add a new node.

+

None

+

Storage scale-up failure

+

GaussDBV5EnlargeVolumeFailed

+

Major

+

The underlying resources are insufficient.

+

Submit a service ticket. The O&M personnel will coordinate resources in the background and then you scale up the storage space again.

+

Services may be interrupted.

+

Reboot failure

+

GaussDBV5RestartInstanceFailed

+

Major

+

The network is abnormal.

+

Retry the reboot operation or submit a service ticket to the O&M personnel.

+

The database service may be unavailable.

+

Full backup failure

+

GaussDBV5FullBackupFailed

+

Major

+

The backup files fail to be exported or uploaded.

+

Submit a service ticket to the O&M personnel.

+

Data cannot be backed up.

+

Differential backup failure

+

GaussDBV5DifferentialBackupFailed

+

Major

+

The backup files fail to be exported or uploaded.

+

Submit a service ticket to the O&M personnel.

+

Data cannot be backed up.

+

Backup deletion failure

+

GaussDBV5DeleteBackupFailed

+

Major

+

This function does not need to be implemented.

+

N/A

+

N/A

+

EIP binding failure

+

GaussDBV5BindEIPFailed

+

Major

+

The EIP is bound to another resource.

+

Submit a service ticket to the O&M personnel.

+

The instance cannot be accessed from the Internet.

+

EIP unbinding failure

+

GaussDBV5UnbindEIPFailed

+

Major

+

The network is faulty or EIP is abnormal.

+

Unbind the IP address again or submit a service ticket to the O&M personnel.

+

IP addresses may be residual.

+

Parameter template application failure

+

GaussDBV5ApplyParamFailed

+

Major

+

Modifying a parameter template times out.

+

Modify the parameter template again.

+

None

+

Parameter modification failure

+

GaussDBV5UpdateInstanceParamGroupFailed

+

Major

+

Modifying a parameter template times out.

+

Modify the parameter template again.

+

None

+

Backup and restoration failure

+

GaussDBV5RestoreFromBcakupFailed

+

Major

+

The underlying resources are insufficient or backup files fail to be downloaded.

+

Submit a service ticket.

+

The database service may be unavailable during the restoration failure.

+
+
+
+
+
+
Parent topic: Appendix
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0001.html b/docs/ces/api-ref/ces_03_0001.html new file mode 100644 index 000000000..f80d33188 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0001.html @@ -0,0 +1,9 @@ + + +

API Usage Guidelines

+

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.

+

An endpoint is the request address for calling an API. Endpoints vary depending on services and regions. For example, the endpoint of the eu-de region is ces.eu-de.otc.t-systems.com. For the endpoints of all services, see Regions and Endpoints.

+
+ diff --git a/docs/ces/api-ref/ces_03_0018.html b/docs/ces/api-ref/ces_03_0018.html new file mode 100644 index 000000000..cdc28b7c9 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0018.html @@ -0,0 +1,22 @@ + + +

API Description

+

+
+
+ +
+ diff --git a/docs/ces/api-ref/ces_03_0019.html b/docs/ces/api-ref/ces_03_0019.html new file mode 100644 index 000000000..d34eb31e7 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0019.html @@ -0,0 +1,18 @@ + + +

API Version Management

+

+
+
+ + +
+
Parent topic: API Description
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0020.html b/docs/ces/api-ref/ces_03_0020.html new file mode 100644 index 000000000..2ec65a866 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0020.html @@ -0,0 +1,190 @@ + + +

Querying All API Versions

+

Function

This API is used to query all API versions supported by Cloud Eye.

+
+

URI

GET /

+
+

Request

Example request

+
GET https://{Cloud Eye endpoint}/
+
+

Response

  • Response parameters +
    + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Type

    +

    Description

    +

    versions

    +

    Array of objects

    +

    Specifies the list of all versions.

    +

    For details, see Table 2.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 2 versions data structure description

    Parameter

    +

    Type

    +

    Description

    +

    id

    +

    String

    +

    Specifies the version ID, for example, v1.

    +

    links

    +

    Array of objects

    +

    Specifies the API URL.

    +

    For details, see Table 3.

    +

    version

    +

    String

    +

    Specifies the API version. If the APIs of this version support microversions, set this parameter to the supported maximum microversion. If the microversion is not supported, leave this parameter blank.

    +

    status

    +

    String

    +

    Specifies the version status.

    +

    CURRENT: indicates a primary version.

    +

    SUPPORTED: indicates an old version but is still supported.

    +

    DEPRECATED: indicates a deprecated version which may be deleted later.

    +

    updated

    +

    String

    +

    Specifies the version release time, which must be the UTC time. For example, the release time of v1 is 2014-06-28T12:20:21Z.

    +

    min_version

    +

    String

    +

    If the APIs of this version support microversions, set this parameter to the supported minimum microversion. If not, leave this parameter blank.

    +
    +
    + +
    + + + + + + + + + + + + + +
    Table 3 links data structure description

    Parameter

    +

    Type

    +

    Description

    +

    href

    +

    String

    +

    Specifies the reference address of the current API version.

    +

    rel

    +

    String

    +

    Specifies the relationship between the current API version and the referenced address.

    +
    +
    +
  • Example response
    {
+  "versions": [
+    {
+      "id": "V1.0",
+      "links": [
+        {
+          "href": "https://x.x.x.x/V1.0/",
+          "rel": "self"
+        }
+      ],
+      "min_version": "",
+      "status": "CURRENT",
+      "updated": "2018-09-30T00:00:00Z",
+      "version": ""
+    }
+  ]
+}
    +
+
+

Returned Values

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: API Version Management
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0021.html b/docs/ces/api-ref/ces_03_0021.html new file mode 100644 index 000000000..691573f79 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0021.html @@ -0,0 +1,209 @@ + + +

Querying a Specified API Version

+

Function

This API is used to query a specified API version of Cloud Eye.

+
+

URI

GET /{api_version}

+
  • Parameter description +
    + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Mandatory

    +

    Description

    +

    api_version

    +

    Yes

    +

    Specifies the API version.

    +
    +
    +
+
  • Example
    GET https://{Cloud Eye endpoint}/V1.0\
    +
+
+

Request

None

+
+

Response

  • Response parameters +
    + + + + + + + + + +
    Table 2 Parameter description

    Parameter

    +

    Type

    +

    Description

    +

    version

    +

    Objects

    +

    Specifies the list of all versions.

    +

    For details, see Table 3.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 3 versions data structure description

    Parameter

    +

    Type

    +

    Description

    +

    id

    +

    String

    +

    Specifies the version ID, for example, v1.

    +

    links

    +

    Array of objects

    +

    Specifies the API URL.

    +

    For details, see Table 4.

    +

    version

    +

    String

    +

    Specifies the API version. If the APIs of this version support microversions, set this parameter to the supported maximum microversion. If the microversion is not supported, leave this parameter blank.

    +

    status

    +

    String

    +

    Specifies the version status.

    +

    CURRENT: indicates a primary version.

    +

    SUPPORTED: indicates an old version but is still supported.

    +

    DEPRECATED: indicates a deprecated version which may be deleted later.

    +

    updated

    +

    String

    +

    Specifies the version release time, which must be the UTC time. For example, the release time of v1 is 2014-06-28T12:20:21Z.

    +

    min_version

    +

    String

    +

    If the APIs of this version support microversions, set this parameter to the supported minimum microversion. If not, leave this parameter blank.

    +
    +
    + +
    + + + + + + + + + + + + + +
    Table 4 links data structure description

    Parameter

    +

    Type

    +

    Description

    +

    href

    +

    String

    +

    Specifies the reference address of the current API version.

    +

    rel

    +

    String

    +

    Specifies the relationship between the current API version and the referenced address.

    +
    +
    +
  • Example response
    { 
+  "version": { 
+      "id": "V1.0", 
+      "links": [ 
+        { 
+          "href": "https://x.x.x.x/V1.0/", 
+          "rel": "self" 
+        } 
+      ], 
+      "min_version": "", 
+      "status": "CURRENT", 
+      "updated": "2018-09-30T00:00:00Z", 
+      "version": "" 
+    } 
+}
    +
+
+

Returned Values

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: API Version Management
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0022.html b/docs/ces/api-ref/ces_03_0022.html new file mode 100644 index 000000000..06c241336 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0022.html @@ -0,0 +1,16 @@ + + +

Metric Management

+

+
+
+ + +
+
Parent topic: API Description
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0023.html b/docs/ces/api-ref/ces_03_0023.html new file mode 100644 index 000000000..62e7552bf --- /dev/null +++ b/docs/ces/api-ref/ces_03_0023.html @@ -0,0 +1,321 @@ + + +

Querying Metrics

+

Function

This API is used to query the metrics. You can specify the namespace, metric, dimension, sorting order, start records, and the maximum number of records when using this API to query metrics.

+
+

URI

GET /V1.0/{project_id}/metrics

+
  • Parameter description +
    + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Mandatory

    +

    Description

    +

    project_id

    +

    Yes

    +

    Specifies the project ID.

    +

    For details about how to obtain the project ID, see Obtaining a Project ID.

    +
    +
    +
    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 2 Query parameter description

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    namespace

    +

    No

    +

    String

    +

    Query the namespace of a service. For details, see Services Interconnected with Cloud Eye.

    +

    The namespace must be in the service.item format and contain 3 to 32 characters. service and item each must start with a letter and contain only letters, digits, and underscores (_).

    +

    metric_name

    +

    No

    +

    String

    +

    Specifies the metric ID. For example, if the monitoring metric of an ECS is CPU usage, metric_name is cpu_util. For details, see Services Interconnected with Cloud Eye.

    +

    dim

    +

    No

    +

    String

    +

    Specifies the dimension. For example, the ECS dimension is instance_id. For details about each service dimension, see Services Interconnected with Cloud Eye.

    +

    A maximum of three dimensions are supported, and the dimensions are numbered from 0 in dim.{i}=key,value format. key cannot exceed 32 characters and value cannot exceed 256 characters.

    +

    Single dimension: dim.0=instance_id,6f3c6f91-4b24-4e1b-b7d1-a94ac1cb011d

    +

    Multiple dimensions: dim.0=key,value&dim.1=key,value

    +

    start

    +

    No

    +

    String

    +

    Specifies the paging start value.

    +

    The format is namespace.metric_name.key:value.

    +

    Example: start=SYS.ECS.cpu_util.instance_id:d9112af5-6913-4f3b-bd0a-3f96711e004d.

    +

    limit

    +

    No

    +

    Integer

    +

    Supported range: 1 to 1000 (default)

    +

    This parameter is used to limit the number of query results.

    +

    order

    +

    No

    +

    String

    +

    Specifies the result sorting method, which is sorted by timestamp.

    +

    The default method is desc.

    +
    • asc: The query results are displayed in the ascending order.
    • desc: The query results are displayed in the descending order.
    +
    +
    +
    +
  • Example requests
    Example request 1: Query all metrics that can be monitored.
    GET https://{Cloud Eye endpoint}/V1.0/{project_id}/metrics
    +
    +
    Example request 2: Query the CPU usage of the ECS whose ID is 6f3c6f91-4b24-4e1b-b7d1-a94ac1cb011d. Retain 10 records in descending order by timestamp.
    GET https://{Cloud Eye endpoint}/V1.0/{project_id}/metrics?namespace=SYS.ECS&metric_name=cpu_util&dim.0=instance_id,6f3c6f91-4b24-4e1b-b7d1-a94ac1cb011d&limit=10&order=desc
    +
    +
+
+

Request

None

+
+

Response

  • Response parameters +
    + + + + + + + + + + + + + +
    Table 3 Parameter description

    Parameter

    +

    Type

    +

    Description

    +

    metrics

    +

    Array of objects

    +

    Specifies the list of metric objects.

    +

    For details, see Table 4.

    +

    meta_data

    +

    Object

    +

    Specifies the metadata of query results, including the pagination information.

    +

    For details, see Table 6.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + +
    Table 4 metrics data structure description

    Parameter

    +

    Type

    +

    Description

    +

    namespace

    +

    String

    +

    Specifies the metric namespace.

    +

    dimensions

    +

    Array of objects

    +

    Specifies the list of metric dimensions.

    +

    For details, see Table 5.

    +

    metric_name

    +

    String

    +

    Specifies the metric name, such as cpu_util.

    +

    unit

    +

    String

    +

    Specifies the metric unit.

    +
    +
    + +
    + + + + + + + + + + + + + +
    Table 5 dimensions data structure description

    Parameter

    +

    Type

    +

    Description

    +

    name

    +

    String

    +

    Specifies the dimension. For example, the ECS dimension is instance_id. For details about the dimension of each service, see the key column in Services Interconnected with Cloud Eye.

    +

    value

    +

    String

    +

    Specifies the dimension value, for example, an ECS ID.

    +

    Enter 1 to 256 characters.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + +
    Table 6 meta_data data structure description

    Parameter

    +

    Type

    +

    Description

    +

    count

    +

    Integer

    +

    Specifies the number of returned results.

    +

    marker

    +

    String

    +

    Specifies the pagination marker.

    +

    For example, you have queried 10 records this time and the tenth record is about cpu_util. In your next query, if start is set to cpu_util, you can start your query from the next metric of cpu_util.

    +

    total

    +

    Integer

    +

    Specifies the total number of metrics.

    +
    +
    +
  • Example response
    {
+    "metrics": [
+        {
+            "namespace": "SYS.ECS", 
+            "dimensions": [
+                {
+                    "name": "instance_id", 
+                    "value": "d9112af5-6913-4f3b-bd0a-3f96711e004d"
+                }
+            ], 
+            "metric_name": "cpu_util", 
+            "unit": "%"
+        }
+    ], 
+    "meta_data": {
+        "count": 1, 
+        "marker": "SYS.ECS.cpu_util.instance_id:d9112af5-6913-4f3b-bd0a-3f96711e004d", 
+        "total": 7
+    }
+}
    +
+
+

Returned Values

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: Metric Management
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0026.html b/docs/ces/api-ref/ces_03_0026.html new file mode 100644 index 000000000..58353e184 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0026.html @@ -0,0 +1,24 @@ + + +

Alarm Rule Management

+

+
+
+ + +
+
Parent topic: API Description
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0027.html b/docs/ces/api-ref/ces_03_0027.html new file mode 100644 index 000000000..204998e2a --- /dev/null +++ b/docs/ces/api-ref/ces_03_0027.html @@ -0,0 +1,581 @@ + + +

Querying Alarm Rules

+

Function

This API is used to query the alarm rule list. You can specify the paging parameters to limit the number of query results displayed on a page. You can also set the sorting order of query results.

+
+

URI

GET /V1.0/{project_id}/alarms

+
  • Parameter description +
    + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Mandatory

    +

    Description

    +

    project_id

    +

    Yes

    +

    Specifies the project ID.

    +

    For details about how to obtain the project ID, see Obtaining a Project ID.

    +
    +
    + +
    + + + + + + + + + +
    Table 2 Parameter description

    Parameter

    +

    Type

    +

    Description

    +

    alarms

    +

    Array of objects

    +

    Specifies the alarm rule list.

    +

    For details, see Table 3.

    +
    +
    +
    +
    + + + + + + + + + + + + + + + + + + + + + +
    Table 3 Query parameter description

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    start

    +

    No

    +

    String

    +

    Specifies the first queried alarm to be displayed on a page.

    +

    The value is alarm_id.

    +

    limit

    +

    No

    +

    Integer

    +

    Supported range: 1 to 100 (default)

    +

    This parameter is used to limit the number of query results.

    +

    order

    +

    No

    +

    String

    +

    Specifies the result sorting method, which is sorted by timestamp.

    +

    The default method is desc.

    +
    • asc: The query results are displayed in the ascending order.
    • desc: The query results are displayed in the descending order.
    +
    +
    +
    +
+
  • Example
    Request example 1: Query the current alarm rule list.
    GET https://{Cloud Eye endpoint}/V1.0/{project_id}/alarms
    +
    +

    +
    Request example 2: Query the alarm rule list. Start by setting alarm_id to al1441967036681YkazZ0deN and retain 10 records in the descending order of time stamps.
    GET https://{Cloud Eye endpoint}/V1.0/{project_id}/alarms?start=al1441967036681YkazZ0deN&limit=10&order=desc
    +
    +

    +
+
+

Request

None

+
+

Response

  • Response parameters +
    + + + + + + + + + + + + + +
    Table 4 Response parameters

    Parameter

    +

    Type

    +

    Description

    +

    metric_alarms

    +

    Array of objects

    +

    Specifies the list of alarm objects.

    +

    For details, see Table 5.

    +

    meta_data

    +

    Object

    +

    Specifies the metadata of query results, including the pagination information.

    +

    For details, see Table 11.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 5 metric_alarms data structure description

    Parameter

    +

    Type

    +

    Description

    +

    alarm_name

    +

    String

    +

    Specifies the alarm rule name.

    +

    alarm_description

    +

    String

    +

    Provides supplementary information about the alarm rule.

    +

    metric

    +

    Object

    +

    Specifies the alarm metric.

    +

    For details, see Table 6.

    +

    condition

    +

    Object

    +

    Specifies the alarm triggering condition.

    +

    For details, see Table 10.

    +

    alarm_enabled

    +

    Boolean

    +

    Specifies whether to enable the alarm rule.

    +

    alarm_level

    +

    Integer

    +

    Specifies the alarm severity, which can be 1, 2 (default), 3 or 4, indicating critical, major, minor, and informational, respectively.

    +

    alarm_action_enabled

    +

    Boolean

    +

    Specifies whether to enable the action to be triggered by an alarm.

    +

    alarm_actions

    +

    Array of objects

    +

    Specifies the action to be triggered by an alarm.

    +

    For details, see Table 8.

    +

    ok_actions

    +

    Array of objects

    +

    Specifies the action to be triggered after the alarm is cleared.

    +

    For details, see Table 9.

    +

    alarm_id

    +

    String

    +

    Specifies the alarm rule ID.

    +

    update_time

    +

    long

    +

    Specifies when the alarm status changed. The time is a UNIX timestamp and the unit is ms.

    +

    alarm_state

    +

    String

    +

    Specifies the alarm status, which can be

    +
    • ok: The alarm status is normal.
    • alarm: An alarm is generated.
    • insufficient_data: The required data is insufficient.
    +
    +
    + +
    + + + + + + + + + + + + + + + + + +
    Table 6 metric data structure description

    Parameter

    +

    Type

    +

    Description

    +

    namespace

    +

    String

    +

    Query the namespace of a service. For details, see Services Interconnected with Cloud Eye.

    +

    dimensions

    +

    Array of objects

    +

    Specifies the list of metric dimensions.

    +

    For details, see Table 7.

    +

    metric_name

    +

    String

    +

    Specifies the metric ID. For example, if the monitoring metric of an ECS is CPU usage, metric_name is cpu_util. For details, see Services Interconnected with Cloud Eye.

    +
    +
    + +
    + + + + + + + + + + + + + +
    Table 7 dimensions data structure description

    Parameter

    +

    Type

    +

    Description

    +

    name

    +

    String

    +

    Specifies the dimension. For example, the ECS dimension is instance_id. For details about the dimension of each service, see the key column in Services Interconnected with Cloud Eye.

    +

    value

    +

    String

    +

    Specifies the dimension value, for example, an ECS ID.

    +

    Enter 1 to 256 characters.

    +
    +
    + +
    + + + + + + + + + + + + + +
    Table 8 alarm_actions data structure description

    Parameter

    +

    Type

    +

    Description

    +

    type

    +

    String

    +
    Specifies the alarm notification type.
    • notification: indicates that a notification will be sent.
    • autoscaling: indicates that a scaling action will be triggered.
    +
    +

    notificationList

    +

    Array of strings

    +

    Specifies the list of objects to be notified if the alarm status changes.

    +
    NOTE:

    The IDs in the list are strings.

    +
    +
    +
    + +
    + + + + + + + + + + + + + +
    Table 9 ok_actions data structure description

    Parameter

    +

    Type

    +

    Description

    +

    type

    +

    String

    +
    Specifies the notification type when an alarm is triggered.
    • notification: indicates that a notification will be sent.
    • autoscaling: indicates that a scaling action will be triggered.
    +
    +

    notificationList

    +

    Array of strings

    +

    Specifies the ID list of objects to be notified if the alarm status changes.

    +
    NOTE:

    The IDs in the list are strings.

    +
    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 10 condition data structure description

    Parameter

    +

    Type

    +

    Description

    +

    period

    +

    Integer

    +

    Specifies the interval (seconds) for checking whether the configured alarm rules are met.

    +

    filter

    +

    String

    +

    Specifies the data rollup method. The following methods are supported:

    +
    • average: Cloud Eye calculates the average value of metric data within a rollup period.
    • max: Cloud Eye calculates the maximum value of metric data within a rollup period.
    • min: Cloud Eye calculates the minimum value of metric data within a rollup period.
    • sum: Cloud Eye calculates the sum of metric data within a rollup period.
    • variance: Cloud Eye calculates the variance value of metric data within a rollup period.
    +

    comparison_operator

    +

    String

    +

    Specifies the alarm threshold operator, which can be >, =, <, ≥, or ≤.

    +

    value

    +

    Double

    +

    Specifies the alarm threshold. Supported range: 0 to Number. MAX_VALUE (1.7976931348623157e+108)

    +

    For detailed thresholds, see the value range of each metric in the appendix. For example, you can set ECS cpu_util in Services Interconnected with Cloud Eye to 80.

    +

    unit

    +

    String

    +

    Specifies the data unit. Enter up to 32 characters.

    +

    count

    +

    Integer

    +

    Specifies the number of consecutive occurrence times that the alarm policy was met. Supported range: 1 to 5

    +
    +
    + +
    + + + + + + + + + + + + + + + + + +
    Table 11 meta_data data structure description

    Parameter

    +

    Type

    +

    Description

    +

    count

    +

    Integer

    +

    Specifies the number of returned results.

    +

    marker

    +

    String

    +

    Specifies the pagination marker.

    +

    For example, you have queried 10 records this time and alarm_id of the tenth record is 1441967036681YkazZ0deN. In your next query, if start is set to al1441967036681YkazZ0deN, you can start your query from the next alarm rule ID of al1441967036681YkazZ0deN.

    +

    total

    +

    Integer

    +

    Specifies the total number of query results.

    +
    +
    +
  • Example response
    {
+    "metric_alarms": [
+        {
+            "alarm_name": "alarm-ttttttt",
+            "alarm_description": "",
+            "metric": {
+                "namespace": "SYS.ECS",
+                "dimensions": [
+                    {
+                        "name": "instance_id",
+                        "value": "07814c0e-59a1-4fcd-a6fb-56f2f6923046"
+                    }
+                ],
+                "metric_name": "cpu_util"
+            },
+            "condition": {
+                "period": 300,
+                "filter": "average",
+                "comparison_operator": ">=",
+                "value": 0,
+                "unit": "%",
+                "count": 3                
+            },
+            "alarm_enabled": true,
+            "alarm_level": 2,
+            "alarm_action_enabled": false,
+            "alarm_id": "al15330507498596W7vmlGKL",
+            "update_time": 1533050749992,
+            "alarm_state": "alarm"
+        },
+        {
+            "alarm_name": "alarm-m5rwxxxxxxx",
+            "alarm_description": "",
+            "metric": {
+                "namespace": "SYS.ECS",
+                "dimensions": [
+                    {
+                        "name": "instance_id",
+                        "value": "30f3858d-4377-4514-9081-be5bdbf1392e"
+                    }
+                ],
+                "metric_name": "network_incoming_bytes_aggregate_rate"
+            },
+            "condition": {
+                "period": 300,
+                "filter": "average",
+                "comparison_operator": ">=",
+                "value": 12,
+                "unit": "Byte/s",
+                "count": 3                
+            },
+            "alarm_enabled": true,
+            "alarm_level": 2,
+            "alarm_action_enabled": true,
+            "alarm_actions": [
+                {
+                    "type": "notification",
+                    "notificationList": [
+                        "urn:smn:region:68438a86d98e427e907e0097b7e35d48:test0315"
+                    ]
+                }
+            ],
+            "ok_actions": [
+                {
+                    "type": "notification",
+                    "notificationList": [
+                        "urn:smn:region:68438a86d98e427e907e0097b7e35d48:test0315"
+                    ]
+                }
+            ], 
+            "alarm_id": "al1533031226533nKJexAlbq",
+            "update_time": 1533204036276,
+            "alarm_state": "ok"
+        }
+    ],
+    "meta_data": {
+        "count": 2,
+        "marker": "al1533031226533nKJexAlbq",
+        "total": 389
+    }
+}
    +
+
+

Returned Values

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    You are forbidden to access the page requested.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: Alarm Rule Management
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0028.html b/docs/ces/api-ref/ces_03_0028.html new file mode 100644 index 000000000..ab00e5518 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0028.html @@ -0,0 +1,444 @@ + + +

Querying an Alarm Rule

+

Function

This API is used to query an alarm rule based on the alarm rule ID.

+
+

URI

GET /V1.0/{project_id}/alarms/{alarm_id}

+
  • Parameter description +
    + + + + + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Mandatory

    +

    Description

    +

    project_id

    +

    Yes

    +

    Specifies the project ID.

    +

    For details about how to obtain the project ID, see Obtaining a Project ID.

    +

    alarm_id

    +

    Yes

    +

    Specifies the alarm rule ID.

    +
    +
    +
+
  • Example
    GET https://{Cloud Eye endpoint}/V1.0/{project_id}/alarms/al1441967036681YkazZ0deN
    +
+
+

Request

None

+
+

Response

  • Response parameters +
    + + + + + + + + + +

    Parameter

    +

    Type

    +

    Description

    +

    metric_alarms

    +

    Array of objects

    +

    Specifies the list of alarm objects.

    +

    For details, see Table 2.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 2 metric_alarms data structure description

    Parameter

    +

    Type

    +

    Description

    +

    alarm_name

    +

    String

    +

    Specifies the alarm rule name.

    +

    alarm_description

    +

    String

    +

    Provides supplementary information about the alarm rule.

    +

    metric

    +

    Object

    +

    Specifies the alarm metric.

    +

    For details, see Table 3.

    +

    condition

    +

    Object

    +

    Specifies the alarm triggering condition.

    +

    For details, see Table 7.

    +

    alarm_enabled

    +

    Boolean

    +

    Specifies whether to enable the alarm rule.

    +

    alarm_level

    +

    Integer

    +

    Specifies the alarm severity, which can be 1, 2 (default), 3 or 4, indicating critical, major, minor, and informational, respectively.

    +

    alarm_action_enabled

    +

    Boolean

    +

    Specifies whether to enable the action to be triggered by an alarm.

    +

    alarm_actions

    +

    Array of objects

    +

    Specifies the action to be triggered by an alarm.

    +

    For details, see Table 5.

    +

    ok_actions

    +

    Array of objects

    +

    Specifies the action to be triggered after the alarm is cleared.

    +

    For details, see Table 6.

    +

    alarm_id

    +

    String

    +

    Specifies the alarm rule ID.

    +

    update_time

    +

    long

    +

    Specifies when the alarm status changed. The time is a UNIX timestamp and the unit is ms.

    +

    alarm_state

    +

    String

    +

    Specifies the alarm status, which can be

    +
    • ok: The alarm status is normal.
    • alarm: An alarm is generated.
    • insufficient_data: The required data is insufficient.
    +
    +
    + +
    + + + + + + + + + + + + + + + + + +
    Table 3 metric data structure description

    Parameter

    +

    Type

    +

    Description

    +

    namespace

    +

    String

    +

    Query the namespace of a service. For details, see Services Interconnected with Cloud Eye.

    +

    dimensions

    +

    Array of objects

    +

    Specifies the list of metric dimensions.

    +

    For details, see Table 4.

    +

    metric_name

    +

    String

    +

    Specifies the metric ID. For example, if the monitoring metric of an ECS is CPU usage, metric_name is cpu_util. For details, see Services Interconnected with Cloud Eye.

    +
    +
    + +
    + + + + + + + + + + + + + +
    Table 4 dimensions data structure description

    Parameter

    +

    Type

    +

    Description

    +

    name

    +

    String

    +

    Specifies the dimension. For example, the ECS dimension is instance_id. For details about the dimension of each service, see the key column in Services Interconnected with Cloud Eye.

    +

    value

    +

    String

    +

    Specifies the dimension value, for example, an ECS ID.

    +

    Enter 1 to 256 characters.

    +
    +
    + +
    + + + + + + + + + + + + + +
    Table 5 alarm_actions data structure description

    Parameter

    +

    Type

    +

    Description

    +

    type

    +

    String

    +
    Specifies the alarm notification type.
    • notification: indicates that a notification will be sent.
    • autoscaling: indicates that a scaling action will be triggered.
    +
    +

    notificationList

    +

    Array of strings

    +

    Specifies the list of objects to be notified if the alarm status changes.

    +
    NOTE:

    The IDs in the list are strings.

    +
    +
    +
    + +
    + + + + + + + + + + + + + +
    Table 6 ok_actions data structure description

    Parameter

    +

    Type

    +

    Description

    +

    type

    +

    String

    +
    Specifies the notification type when an alarm is triggered.
    • notification: indicates that a notification will be sent.
    • autoscaling: indicates that a scaling action will be triggered.
    +
    +

    notificationList

    +

    Array of strings

    +

    Specifies the list of objects to be notified if the alarm status changes.

    +
    NOTE:

    The IDs in the list are strings.

    +
    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 7 condition data structure description

    Parameter

    +

    Type

    +

    Description

    +

    period

    +

    Integer

    +

    Specifies the interval (seconds) for checking whether the configured alarm rules are met.

    +

    filter

    +

    String

    +

    Specifies the data rollup method. The following methods are supported:

    +
    • average: Cloud Eye calculates the average value of metric data within a rollup period.
    • max: Cloud Eye calculates the maximum value of metric data within a rollup period.
    • min: Cloud Eye calculates the minimum value of metric data within a rollup period.
    • sum: Cloud Eye calculates the sum of metric data within a rollup period.
    • variance: Cloud Eye calculates the variance value of metric data within a rollup period.
    +

    comparison_operator

    +

    String

    +

    Specifies the alarm threshold operator, which can be >, =, <, ≥, or ≤.

    +

    value

    +

    Double

    +

    Specifies the alarm threshold. Supported range: 0 to Number. MAX_VALUE (1.7976931348623157e+108)

    +

    For detailed thresholds, see the value range of each metric in the appendix. For example, you can set ECS cpu_util in Services Interconnected with Cloud Eye to 80.

    +

    unit

    +

    String

    +

    Specifies the data unit. Enter up to 32 characters.

    +

    count

    +

    Integer

    +

    Specifies the number of consecutive occurrence times that the alarm policy was met. Supported range: 1 to 5

    +
    +
    +
  • Example response
    {
+"metric_alarms":
+  [
+   {
+    "alarm_name":"alarm-ipwx",
+    "alarm_description":"",
+    "metric":
+     {
+      "namespace":"SYS.ELB",
+      "dimensions":
+      [
+       {
+        "name":"lb_instance_id",
+        "value":"44d06d10-bce0-4237-86b9-7b4d1e7d5621"
+       }
+      ],
+      "metric_name":"m8_out_Bps"
+      },
+    "condition":
+     {
+      "period":300,
+      "filter":"sum",
+      "comparison_operator":">=",
+      "value":0,
+      "unit":"",
+      "count":1
+      },
+    "alarm_enabled":true,
+    "alarm_level": 2,
+    "alarm_action_enabled":true,
+    "alarm_actions":
+     [
+      {
+       "type":"notification",
+       "notificationList":["urn:smn:region:68438a86d98e427e907e0097b7e35d48:sd"]
+      }
+     ],
+    "ok_actions":
+     [
+      {
+       "type":"notification",
+       "notificationList":["urn:smn:region:68438a86d98e427e907e0097b7e35d48:sd"]
+      }
+     ],
+    "alarm_id":"al1498096535573r8DNy7Gyk",
+    "update_time":1498100100000,
+    "alarm_state":"alarm"
+   }
+  ]
+}
    +
+
+

Returned Values

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    You are forbidden to access the page requested.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: Alarm Rule Management
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0029.html b/docs/ces/api-ref/ces_03_0029.html new file mode 100644 index 000000000..4449a319f --- /dev/null +++ b/docs/ces/api-ref/ces_03_0029.html @@ -0,0 +1,126 @@ + + +

Enabling or Disabling an Alarm Rule

+

Function

This API is used to enable or disable an alarm rule.

+
+

URI

PUT /V1.0/{project_id}/alarms/{alarm_id}/action

+
  • Parameter description +
    + + + + + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Mandatory

    +

    Description

    +

    project_id

    +

    Yes

    +

    Specifies the project ID.

    +

    For details about how to obtain the project ID, see Obtaining a Project ID.

    +

    alarm_id

    +

    Yes

    +

    Specifies the alarm rule ID.

    +
    +
    +
+
  • Example
    PUT https://{Cloud Eye endpoint}/V1.0/{project_id}/alarms/al1441967036681YkazZ0deN/action
    +
+
+

Request

  • Request parameters +
    + + + + + + + + + + + +
    Table 2 Request parameters

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    alarm_enabled

    +

    Yes

    +

    Boolean

    +

    Specifies whether the alarm rule is enabled.

    +
    • true: indicates that the alarm rule is enabled.
    • false: indicates that the alarm rule is disabled.
    +
    +
    +
+
  • Example request
    {
+    "alarm_enabled":true
+}
    +
+
+

Response

The response has no message body.

+
+

Returned Values

  • Normal

    204

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: Alarm Rule Management
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0030.html b/docs/ces/api-ref/ces_03_0030.html new file mode 100644 index 000000000..f1e0cce79 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0030.html @@ -0,0 +1,98 @@ + + +

Deleting an Alarm Rule

+

Function

This API is used to delete an alarm rule.

+
+

URI

DELETE /V1.0/{project_id}/alarms/{alarm_id}

+
  • Parameter description +
    + + + + + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Mandatory

    +

    Description

    +

    project_id

    +

    Yes

    +

    Specifies the project ID.

    +

    For details about how to obtain the project ID, see Obtaining a Project ID.

    +

    alarm_id

    +

    Yes

    +

    Specifies the alarm rule ID.

    +
    +
    +
+
  • Example
    DELETE https://{Cloud Eye endpoint}/V1.0/{project_id}/alarms/al1441967036681YkazZ0deN
    +
+
+

Request

The request has no message body.

+
+

Response

The response has no message body.

+
+

Returned Values

  • Normal

    204

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: Alarm Rule Management
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0031.html b/docs/ces/api-ref/ces_03_0031.html new file mode 100644 index 000000000..a481177a5 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0031.html @@ -0,0 +1,509 @@ + + +

Creating an Alarm Rule

+

Function

This API is used to create an alarm rule.

+
+

URI

POST /V1.0/{project_id}/alarms

+
  • Parameter description +
    + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Mandatory

    +

    Description

    +

    project_id

    +

    Yes

    +

    Specifies the project ID.

    +

    For details about how to obtain the project ID, see Obtaining a Project ID.

    +
    +
    +
+
  • Example
    POST https://{Cloud Eye endpoint}/V1.0/{project_id}/alarms
    +
+
+

Request

  • Request parameters +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 2 Request parameters

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    alarm_name

    +

    Yes

    +

    String

    +

    Specifies the alarm rule name.

    +

    Enter 1 to 128 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.

    +

    alarm_description

    +

    No

    +

    String

    +

    Provides supplementary information about the alarm rule. Enter 0 to 256 characters.

    +

    metric

    +

    Yes

    +

    Object

    +

    Specifies the alarm metric.

    +

    For details, see Table 3.

    +

    condition

    +

    Yes

    +

    Object

    +

    Specifies the alarm triggering condition.

    +

    For details, see Table 7.

    +

    alarm_enabled

    +

    No

    +

    Boolean

    +

    Specifies whether to enable the alarm.

    +

    The default value is true.

    +

    alarm_action_enabled

    +

    No

    +

    Boolean

    +

    Specifies whether to enable the action to be triggered by an alarm. The default value is true.

    +
    NOTE:

    If you set alarm_action_enabled to true, you must specify either alarm_actions or ok_actions. (You do not need to configure the deprecated parameter insufficientdata_actions.)

    +

    If alarm_actions and ok_actions coexist, their notificationList must be the same. (You do not need to configure the deprecated parameter insufficientdata_actions.)

    +
    +

    alarm_level

    +

    No

    +

    Integer

    +

    Specifies the alarm severity, which can be 1, 2 (default), 3 or 4, indicating critical, major, minor, and informational, respectively.

    +

    alarm_type

    +

    No

    +

    String

    +

    Specifies the alarm rule type.

    +

    EVENT.SYS: The alarm rule is created for system events. EVENT.CUSTOM: The alarm rule is created for custom events.

    +

    alarm_actions

    +

    No

    +

    Arrays of objects

    +

    Specifies the action to be triggered by an alarm.

    +

    An example structure is as follows:

    +

    {

    +

    "type": "notification","notificationList": ["urn:smn:region:68438a86d98e427e907e0097b7e35d47:sd"]

    +

    }

    +

    For details, see Table 5.

    +

    ok_actions

    +

    No

    +

    Arrays of objects

    +

    Specifies the action to be triggered after the alarm is cleared.

    +

    Its structure is:

    +

    { "type": "notification","notificationList": ["urn:smn:region:68438a86d98e427e907e0097b7e35d47:sd"] }

    +

    For details, see Table 6.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 3 metric data structure description

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    namespace

    +

    Yes

    +

    String

    +

    Specifies the namespace of a service. For details, see Services Interconnected with Cloud Eye.

    +

    The namespace must be in the service.item format and contain 3 to 32 characters. service and item each must start with a letter and contain only letters, digits, and underscores (_).

    +

    dimensions

    +

    No

    +

    Arrays of objects

    +

    Specifies the metric dimension list. When resource_group_id is not used, dimensions is mandatory.

    +

    For details, see Table 4.

    +

    metric_name

    +

    Yes

    +

    String

    +

    Specifies the metric name.

    +

    Start with a letter. Enter 1 to 64 characters. Only letters, digits, and underscores (_) are allowed.

    +

    For details, see the metric name queried in Querying Metrics.

    +

    resource_group_id

    +

    No

    +

    String

    +

    Specifies the resource group ID selected during the alarm rule creation, for example, rg1603786526428bWbVmk4rP.

    +
    NOTE:

    If you create alarm rules for resource groups, you must specify resource_group_id and name, enter at least one dimension for dimensions, and set alarm_type to RESOURCE_GROUP.

    +
    +
    +
    + +
    + + + + + + + + + + + + + + + + +
    Table 4 dimensions data structure description

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    name

    +

    Yes

    +

    String

    +

    Specifies the dimension. For example, the ECS dimension is instance_id. For details about the dimension of each service, see the key column in Services Interconnected with Cloud Eye.

    +

    Start with a letter. Enter 1 to 32 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.

    +

    value

    +

    Yes

    +

    String

    +

    Specifies the dimension value, for example, an ECS ID.

    +

    Start with a letter or a digit. Enter 1 to 256 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.

    +
    +
    + +
    + + + + + + + + + + + + + + + + +
    Table 5 alarm_actions data structure description

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    type

    +

    Yes

    +

    String

    +
    Specifies the alarm notification type.
    • notification: indicates that a notification will be sent.
    • autoscaling: indicates that a scaling action will be triggered.
    +
    +

    notificationList

    +

    Yes

    +

    Arrays of strings

    +

    Specifies the list of objects to be notified if the alarm status changes. You can configure up to 5 object IDs. You can obtain the topicUrn value from SMN in the following format: urn:smn:([a-z]|[A-Z]|[0-9]|\-){1,32}:([a-z]|[A-Z]|[0-9]){32}:([a-z]|[A-Z]|[0-9]|\-|\_){1,256}.

    +

    If you set type to notification, you must specify notificationList. If you set type to autoscaling, you must set notificationList to [].

    +
    NOTE:
    • To make the AS alarm rules take effect, you must bind scaling policies. For details, see the Auto Scaling API Reference.
    • If you set alarm_action_enabled to true, you must specify either alarm_actions or ok_actions. (You do not need to configure the deprecated parameter insufficientdata_actions.)
    • If alarm_actions and ok_actions coexist, their notificationList must be the same. (You do not need to configure the deprecated parameter insufficientdata_actions.)
    • The IDs in the list are strings.
    +
    +
    +
    + +
    + + + + + + + + + + + + + + + + +
    Table 6 ok_actions data structure description

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    type

    +

    Yes

    +

    String

    +
    Specifies the notification type when an alarm is triggered.
    • notification: indicates that a notification will be sent.
    • autoscaling: indicates that a scaling action will be triggered.
    +
    +

    notificationList

    +

    Yes

    +

    Arrays of objects

    +

    Specifies the list of objects to be notified if the alarm status changes. You can configure up to 5 object IDs. You can obtain the topicUrn value from SMN in the following format: urn:smn:([a-z]|[A-Z]|[0-9]|\-){1,32}:([a-z]|[A-Z]|[0-9]){32}:([a-z]|[A-Z]|[0-9]|\-|\_){1,256}.

    +
    NOTE:

    If you set alarm_action_enabled to true, you must specify either alarm_actions or ok_actions. (You do not need to configure the deprecated parameter insufficientdata_actions.)

    +

    If alarm_actions and ok_actions coexist, their notificationList must be the same. (You do not need to configure the deprecated parameter insufficientdata_actions.)

    +
    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 7 condition data structure description

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    period

    +

    Yes

    +

    Integer

    +

    Specifies the period during which Cloud Eye determines whether to trigger an alarm. Unit: second

    +

    Possible periods are 1, 300, 1200, 3600, 14400, and 86400.

    +
    NOTE:
    • If you set period to 1, Cloud Eye uses raw data to determine whether to trigger an alarm.
    +
    +

    filter

    +

    Yes

    +

    String

    +

    Specifies the data rollup method.

    +

    Possible methods are max, min, average, sum, or variance.

    +

    comparison_operator

    +

    Yes

    +

    String

    +

    Specifies the operator of alarm thresholds.

    +

    Possible operators are >, =, <, >=, and <=.

    +

    value

    +

    Yes

    +

    Double

    +

    Specifies the alarm threshold.

    +

    Supported range: 0 to Number. MAX_VALUE (1.7976931348623157e+108)

    +

    For detailed thresholds, see the value range of each metric in the appendix. For example, you can set ECS cpu_util in Services Interconnected with Cloud Eye to 80.

    +

    unit

    +

    No

    +

    String

    +

    Specifies the data unit. Enter up to 32 characters.

    +

    count

    +

    Yes

    +

    Integer

    +

    Specifies the number of consecutive occurrence times that the alarm policy was met. Supported range: 1 to 5

    +
    +
    +
+
  • Example request
    {
+    "alarm_name": "alarm-rp0E", 
+    "alarm_description": "", 
+    "metric": {
+        "namespace": "SYS.ECS", 
+        "dimensions": [
+            {
+                "name": "instance_id", 
+                "value": "33328f02-3814-422e-b688-bfdba93d4051"
+            }
+        ], 
+        "metric_name": "network_outgoing_bytes_rate_inband"
+    }, 
+    "condition": {
+        "period": 300, 
+        "filter": "average", 
+        "comparison_operator": ">=", 
+        "value": 6, 
+        "unit": "Byte/s", 
+        "count": 1        
+   }, 
+    "alarm_enabled": true, 
+    "alarm_action_enabled": true, 
+    "alarm_level": 2,
+    "alarm_actions": [
+        {
+            "type": "notification", 
+            "notificationList": ["urn:smn:region:68438a86d98e427e907e0097b7e35d48:sd"]
+        }
+    ], 
+    "ok_actions": [
+        {
+            "type": "notification", 
+            "notificationList": ["urn:smn:region:68438a86d98e427e907e0097b7e35d48:sd"]
+        }
+    ]
+}
    +
+
+

Response

  • Response parameters +
    + + + + + + + + + +
    Table 8 Response parameters

    Parameter

    +

    Type

    +

    Description

    +

    alarm_id

    +

    String

    +

    Specifies the alarm rule ID.

    +
    +
    +
+
  • Example response
    { 
+    "alarm_id":"al1450321795427dR8p5mQBo"
+}
    +
+
+

Returned Values

  • Normal

    201

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: Alarm Rule Management
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0032.html b/docs/ces/api-ref/ces_03_0032.html new file mode 100644 index 000000000..ee6a30988 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0032.html @@ -0,0 +1,22 @@ + + +

Monitoring Data Management

+

+
+
+ + +
+
Parent topic: API Description
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0033.html b/docs/ces/api-ref/ces_03_0033.html new file mode 100644 index 000000000..91cf17f89 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0033.html @@ -0,0 +1,309 @@ + + +

Querying Monitoring Data

+

Function

This API is used to query the monitoring data at a specified granularity for a specified metric in a specified period of time. You can specify the dimension of data to be queried.

+
+

URI

GET /V1.0/{project_id}/metric-data?namespace={namespace}&metric_name={metric_name}&dim.{i}=key,value&from={from}&to={to}&period={period}&filter={filter}

+
  • Parameter description +
    + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Mandatory

    +

    Description

    +

    project_id

    +

    Yes

    +

    Specifies the project ID.

    +

    For details about how to obtain the project ID, see Obtaining a Project ID.

    +
    +
    +
    +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 2 Query parameter description

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    namespace

    +

    Yes

    +

    String

    +

    Specifies the namespace of a service. For details, see Services Interconnected with Cloud Eye.

    +

    The namespace must be in the service.item format and contain 3 to 32 characters. service and item each must start with a letter and contain only letters, digits, and underscores (_).

    +

    metric_name

    +

    Yes

    +

    String

    +

    Specifies the metric name. You can obtain the metric names of existing alarm rules by referring to Querying Metrics.

    +

    from

    +

    Yes

    +

    String

    +

    Specifies the start time of the query. The time is a UNIX timestamp and the unit is ms.

    +

    Rollup aggregates the raw data generated within a period to the start time of the period. Therefore, if from and to are within a period, the query result will be empty due to the rollup failure. Set from to at least one period earlier than the current time.

    +

    Take the 5-minute period as an example. If it is 10:35 now, the raw data generated between 10:30 and 10:35 will be aggregated to 10:30. Therefore, in this example, if period is 5 minutes, from should be 10:30.

    +
    NOTE:

    Cloud Eye rounds up from based on the level of granularity required to perform the rollup.

    +
    +

    to

    +

    Yes

    +

    String

    +

    Specifies the end time of the query.

    +

    The time is a UNIX timestamp and the unit is ms.

    +

    from must be earlier than to.

    +

    period

    +

    Yes

    +

    Integer

    +

    Specifies how often Cloud Eye aggregates data, which can be

    +
    • 1: Cloud Eye performs no aggregation and displays raw data.
    +
    • 300: Cloud Eye aggregates data every 5 minutes.
    • 1200: Cloud Eye aggregates data every 20 minutes.
    • 3600: Cloud Eye aggregates data every 1 hour.
    • 14400: Cloud Eye aggregates data every 4 hours.
    • 86400: Cloud Eye aggregates data every 24 hours.
    +

    filter

    +

    Yes

    +

    String

    +

    Specifies the data rollup method, which can be

    +
    • average: Cloud Eye calculates the average value of metric data within a rollup period.
    • max: Cloud Eye calculates the maximum value of metric data within a rollup period.
    • min: Cloud Eye calculates the minimum value of metric data within a rollup period.
    • sum: Cloud Eye calculates the sum of metric data within a rollup period.
    • variance: Cloud Eye calculates the variance value of metric data within a rollup period.
    +
    NOTE:

    Rollup uses a rollup method to aggregate raw data generated within a specific period. Take the 5-minute period as an example. If it is 10:35 now, the raw data generated between 10:30 and 10:35 will be aggregated to 10:30.

    +
    +

    dim

    +

    Yes

    +

    String

    +

    A maximum of three metric dimensions are supported, and the dimensions are numbered from 0 in the dim.{i}=key,value format. key cannot exceed 32 characters and value cannot exceed 256 characters.

    +

    The following dimensions are only examples. For details about whether multiple dimensions are supported, see the dimension description in the monitoring indicator description of each service.

    +

    Single dimension: dim.0=instance_id,i-12345

    +

    Multiple dimensions: dim.0=instance_id,i-12345&dim.1=instance_name,i-1234

    +
    +
    +
    • dimensions can be obtained from the response body by calling the API for Querying Metrics.
    • OBS metric data can be queried only when the related OBS APIs are called.
    +
    +
    +
+
  • Example:

    Request example 1: View the CPU usage of ECS whose ID is 6f3c6f91-4b24-4e1b-b7d1-a94ac1cb011d from 2019-04-30 20:00:00 to 2019-04-30 22:00:00. The monitoring interval is 20 minutes.

    +
    GET https://{Cloud Eye endpoint}/V1.0/{project_id}/metric-data?namespace=SYS.ECS&metric_name=cpu_util&dim.0=instance_id,6f3c6f91-4b24-4e1b-b7d1-a94ac1cb011d&from=1556625600000&to=1556632800000&period=1200&filter=min
    +
+
+

Request

None

+
+

Response

  • Response parameters +
    + + + + + + + + + + + + + +
    Table 3 Response parameters

    Parameter

    +

    Type

    +

    Description

    +

    datapoints

    +

    Array of objects

    +

    Specifies the metric data list. For details, see Table 4.

    +

    +

    Since Cloud Eye rounds up from based on the level of granularity for data query, datapoints may contain more data points than expected.

    +

    metric_name

    +

    String

    +

    Specifies the metric ID. For example, if the monitoring metric of an ECS is CPU usage, metric_name is cpu_util. For details, see Services Interconnected with Cloud Eye.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 4 datapoints data structure description

    Parameter

    +

    Type

    +

    Description

    +

    average

    +

    double

    +

    Specifies the average value of metric data within a rollup period.

    +

    max

    +

    double

    +

    Specifies the maximum value of metric data within a rollup period.

    +

    min

    +

    double

    +

    Specifies the minimum value of metric data within a rollup period.

    +

    sum

    +

    double

    +

    Specifies the sum of metric data within a rollup period.

    +

    variance

    +

    double

    +

    Specifies the variance of metric data within a rollup period.

    +

    timestamp

    +

    long

    +

    Specifies when the metric is collected. It is a UNIX timestamp in milliseconds.

    +

    unit

    +

    String

    +

    Specifies the metric unit.

    +
    +
    +
  • Example response
    Example response 1: The dimension is SYS.ECS, and the average CPU usage of ECSs is displayed.
    {
+    "datapoints": [
+        {
+            "average": 0.23, 
+            "timestamp": 1442341200000, 
+            "unit": "%"
+        }
+    ], 
+    "metric_name": "cpu_util"
+}
    +
    +
    Example response 2: The dimension is SYS.ECS, and the sum CPU usage of ECSs is displayed.
    {
+    "datapoints": [
+        {
+            "sum": 0.53, 
+            "timestamp": 1442341200000, 
+            "unit": "%"
+        }
+    ], 
+    "metric_name": "cpu_util"
+}
    +
    +
    Example response 3: The dimension is SYS.ECS, and the maximum CPU usage of ECSs is displayed.
    {
+    "datapoints": [
+        {
+            "max": 0.13, 
+            "timestamp": 1442341200000, 
+            "unit": "%"
+        }
+    ], 
+    "metric_name": "cpu_util"
+}
    +
    +
+
+

Returned Values

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    You are forbidden to access the page requested.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: Monitoring Data Management
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0034.html b/docs/ces/api-ref/ces_03_0034.html new file mode 100644 index 000000000..e0958ff53 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0034.html @@ -0,0 +1,610 @@ + + +

Querying Monitoring Data in Batches

+

Function

You can query the monitoring data of specified metrics within a specified time range and specified granularities in batches. At present, you can query the monitoring data of a maximum of 10 metrics in batches.

+
+

URI

POST /V1.0/{project_id}/batch-query-metric-data

+
  • Parameter description +
    + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Mandatory

    +

    Description

    +

    project_id

    +

    Yes

    +

    Specifies the project ID.

    +

    For details about how to obtain the project ID, see Obtaining a Project ID.

    +
    +
    +
+
+

Request

  1. The size of a POST request cannot exceed 512 KB. Otherwise, the request will be denied.
  2. The default maximum query intervals of different periods are different.

    If period is 1, the maximum interval between from and to is 4 hours. If the interval between from and to is longer than 4 hours, adjust the value of from to to - 4*3600*1000.

    +

    If period is 300, the maximum interval between from and to is 1 day. If the interval between from and to is longer than 1 day, adjust the value of from to to - 24*3600*1000.

    +

    If period is 1200, the maximum interval between from and to is 3 days. If the interval between from and to is longer than three days, adjust the value of from to to - 3*24*3600*1000.

    +

    If period is 3600, the maximum interval between from and to is 10 days. If the interval between from and to is longer than 10 days, adjust the value of from to to - 10*24*3600*1000.

    +

    If period is 14400, the maximum interval between from and to is 30 days. If the interval between from and to is longer than 30 days, adjust the value of from to to - 30*24*3600*1000.

    +

    If period is 86400, the maximum interval between from and to is 180 days. If the interval between from and to is longer than 180 days, adjust the value of from to to - 180*24*3600*1000.

    +
+
+
  • Request parameters +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 2 Request parameters

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    metrics

    +

    Yes

    +

    Arrays of objects

    +

    Specifies the metric data. The maximum length of the array is 10.

    +

    For details, see Table 3.

    +

    from

    +

    Yes

    +

    long

    +

    Specifies the start time of the query. The time is a UNIX timestamp and the unit is ms. Set from to at least one period earlier than the current time. Rollup aggregates the raw data generated within a period to the start time of the period. Therefore, if from and to are within a period, the query result will be empty due to the rollup failure. Set from to at least one period earlier than the current time. Take the 5-minute period as an example. If it is 10:35 now, the raw data generated between 10:30 and 10:35 will be aggregated to 10:30. Therefore, in this example, if period is 5 minutes, from should be 10:30.

    +
    NOTE:

    Cloud Eye rounds up from based on the level of granularity required to perform the rollup.

    +
    +

    to

    +

    Yes

    +

    long

    +

    Specifies the end time of the query. The time is a UNIX timestamp and the unit is ms. from must be earlier than to.

    +

    period

    +

    Yes

    +

    String

    +

    Specifies how often Cloud Eye aggregates data, which can be

    +
    • 1: Cloud Eye performs no aggregation and displays raw data.
    • 300: Cloud Eye aggregates data every 5 minutes.
    • 1200: Cloud Eye aggregates data every 20 minutes.
    • 3600: Cloud Eye aggregates data every 1 hour.
    • 14400: Cloud Eye aggregates data every 4 hours.
    • 86400: Cloud Eye aggregates data every 24 hours.
    +

    filter

    +

    Yes

    +

    String

    +

    Specifies the data rollup method, which can be

    +
    • average: Cloud Eye calculates the average value of metric data within a rollup period.
    • max: Cloud Eye calculates the maximum value of metric data within a rollup period.
    • min: Cloud Eye calculates the minimum value of metric data within a rollup period.
    • sum: Cloud Eye calculates the sum of metric data within a rollup period.
    • variance: Cloud Eye calculates the variance value of metric data within a rollup period.
    +

    filter does not affect the query result of raw data. (The period is 1.)

    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + +
    Table 3 metrics data structure description

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    namespace

    +

    Yes

    +

    String

    +

    Specifies the metric namespace, which must be in the service.item format and contain 3 to 32 characters.

    +

    service and item each must start with a letter and contain only letters, digits, and underscores (_).

    +

    dimensions

    +

    Yes

    +

    Arrays of objects

    +

    Specifies the list of the metric dimensions.

    +

    Each dimension is a JSON object, and its structure is as follows:

    +

    {

    +

    "name": "instance_id",

    +

    "value": "33328f02-3814-422e-b688-bfdba93d4050"

    +

    }

    +

    For details, see Table 4.

    +

    metric_name

    +

    Yes

    +

    String

    +

    Specifies the metric name. Start with a letter. Enter 1 to 64 characters. Only letters, digits, and underscores (_) are allowed.

    +
    +
    + +
    + + + + + + + + + + + + + + + + +
    Table 4 dimensions data structure description

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    name

    +

    Yes

    +

    String

    +

    Specifies the dimension. For example, the ECS dimension is instance_id. For details about the dimension of each service, see the key column in Services Interconnected with Cloud Eye.

    +

    Start with a letter. Enter 1 to 32 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.

    +

    value

    +

    Yes

    +

    String

    +

    Specifies the dimension value, for example, an ECS ID.

    +

    Start with a letter or a digit. Enter 1 to 256 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.

    +
    +
    +
    • dimensions can be obtained from the response body by calling the API for Querying Metrics.
    • OBS metric data can be queried only when the related OBS APIs are called.
    +
    +
+
  • Example request
    Request example 1: View the average cpu_util of the ECS whose instance_id is faea5b75-e390-4e2b-8733-9226a9026070 and the average network_vm_connections of the ECS whose instance_id is 06b4020f-461a-4a52-84da-53fa71c2f42b. The monitoring data was collected from 20:00:00 to 22:00:00 on April 30, 2019.
    {
+    "metrics": [
+       {
+            "namespace": "SYS.ECS",
+            "dimensions": [
+                {
+                    "name": "instance_id",
+                    "value": "faea5b75-e390-4e2b-8733-9226a9026070"
+                }
+            ],
+            "metric_name": "cpu_util"
+        },
+        {
+            "namespace": "SYS.ECS",
+            "dimensions": [
+                {
+                    "name": "instance_id",
+                    "value": "06b4020f-461a-4a52-84da-53fa71c2f42b"
+                }
+            ],
+            "metric_name": "network_vm_connections"
+        }
+    ],
+    "from": 1556625600000,
+    "to": 1556632800000,
+    "period": "1",
+    "filter": "average"
+}
+
    +
    +
    Request example 2: View the sums of rds021_myisam_buf_usage of the RDS instance whose rds_cluster_id is 3c8cc15614ab46f5b8743317555e0de2in01 and the RDS instance whose rds_cluster_id is 3b2fa8b55a9b4adca3713962a9d31884in01. The monitoring data was collected from 20:00:00 to 22:00:00 on April 30, 2019.
    {
+    "metrics": [
+        {
+            "namespace": "SYS.RDS",
+            "dimensions": [
+                {
+                    "name": "rds_cluster_id",
+                    "value": "3c8cc15614ab46f5b8743317555e0de2in01"
+                }
+            ],
+            "metric_name": "rds021_myisam_buf_usage"
+        },
+        {
+            "namespace": "SYS.RDS",
+            "dimensions": [
+                {
+                    "name": "rds_cluster_id",
+                    "value": "3b2fa8b55a9b4adca3713962a9d31884in01"
+                }
+            ],
+            "metric_name": "rds021_myisam_buf_usage"
+        }
+    ],
+    "from": 1556625600000,
+    "to": 1556632800000,
+    "period": "1",
+    "filter": "sum"
+}
    +
    +
    Example request 3: View the minimum proc_specified_count of the server whose instance_id is cd841102-f6b1-407d-a31f-235db796dcbb and proc is b28354b543375bfa94dabaeda722927f. The monitoring data is collected from 20:00:00 to 22:00:00 on April 30, 2019 and the rollup period is 20 minutes.
    {
+    "metrics": [
+        {
+            "namespace": "AGT.ECS",
+            "dimensions": [
+                {
+                    "name": "instance_id",
+                    "value": "cd841102-f6b1-407d-a31f-235db796dcbb"
+                },
+                {
+                    "name": "proc",
+                    "value": "b28354b543375bfa94dabaeda722927"
+                }
+            ],
+            "metric_name": "proc_specified_count"
+        }
+    ],
+    "from": 1556625600000,
+    "to": 1556632800000,
+    "period": "1200",
+    "filter": "min"
+}
    +
    +
+
+

Response

  • Response parameters +
    + + + + + + + + + +
    Table 5 Response parameters

    Parameter

    +

    Type

    +

    Description

    +

    metrics

    +

    Arrays of objects

    +

    Specifies the metric data.

    +

    For details, see Table 6.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 6 metrics data structure description

    Parameter

    +

    Type

    +

    Description

    +

    unit

    +

    String

    +

    Specifies the metric unit.

    +

    datapoints

    +

    Arrays of objects

    +

    Specifies the metric data list. Since Cloud Eye rounds up from based on the level of granularity for data query, datapoints may contain more data points than expected.

    +

    For details, see Table 8.

    +

    namespace

    +

    String

    +

    Specifies the metric namespace, which must be in the service.item format and contain 3 to 32 characters. service and item each must start with a letter and contain only letters, digits, and underscores (_).

    +

    dimensions

    +

    Arrays of objects

    +

    Specifies the list of metric dimensions.

    +

    Each dimension is a JSON object, and its structure is as follows:

    +

    {

    +

    "name": "instance_id",

    +

    "value": "33328f02-3814-422e-b688-bfdba93d4050"

    +

    }

    +

    For details, see Table 7.

    +

    metric_name

    +

    String

    +

    Specifies the metric name. Start with a letter. Enter 1 to 64 characters. Only letters, digits, and underscores (_) are allowed.

    +
    +
    + +
    + + + + + + + + + + + + + +
    Table 7 dimensions data structure description

    Parameter

    +

    Type

    +

    Description

    +

    name

    +

    String

    +

    Specifies the dimension. For example, the ECS dimension is instance_id. For details about the dimension of each service, see the key column in Services Interconnected with Cloud Eye.

    +

    Start with a letter. Enter 1 to 32 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.

    +

    value

    +

    String

    +

    Specifies the dimension value, for example, an ECS ID.

    +

    Start with a letter or a digit. Enter 1 to 256 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 8 datapoints data structure description

    Parameter

    +

    Type

    +

    Description

    +

    average

    +

    double

    +

    Specifies the average value of metric data within a rollup period.

    +

    max

    +

    double

    +

    Specifies the maximum value of metric data within a rollup period.

    +

    min

    +

    double

    +

    Specifies the minimum value of metric data within a rollup period.

    +

    sum

    +

    double

    +

    Specifies the sum of metric data within a rollup period.

    +

    variance

    +

    double

    +

    Specifies the variance of metric data within a rollup period.

    +

    timestamp

    +

    long

    +

    Specifies when the metric is collected. It is a UNIX timestamp in milliseconds.

    +
    +
    +
+
  • Example response
    Example response 1: The average cpu_util of the ECS whose instance_id is faea5b75-e390-4e2b-8733-9226a9026070 and the average network_vm_connections of the ECS whose instance_id is 06b4020f-461a-4a52-84da-53fa71c2f42b are displayed.
    {
+    "metrics": [
+        {
+            "namespace": "SYS.ECS",
+            "metric_name": "cpu_util",
+            "dimensions": [
+                {
+                    "name": "instance_id",
+                    "value": "faea5b75-e390-4e2b-8733-9226a9026070"
+                }
+            ],
+            "datapoints": [
+                {
+                    "average": 0.69,
+                    "timestamp": 1556625610000
+                },
+                {
+                    "average": 0.7,
+                    "timestamp": 1556625715000
+                }
+            ],
+            "unit": "%"
+        },
+        {
+            "namespace": "SYS.ECS",
+            "metric_name": "network_vm_connections",
+            "dimensions": [
+                {
+                    "name": "instance_id",
+                    "value": "06b4020f-461a-4a52-84da-53fa71c2f42b"
+                }
+            ],
+            "datapoints": [
+                {
+                    "average": 1,
+                    "timestamp": 1556625612000
+                },
+                {
+                    "average": 3,
+                    "timestamp": 1556625717000
+                }
+            ],
+            "unit": "count"
+        }
+    ]
+}
    +
    +
    Response example 2: The rds021_myisam_buf_usage sums of the RDS instance whose rds_cluster_id are 3c8cc15614ab46f5b8743317555e0de2in01 is displayed, and those of the RDS instance whose rds_cluster_id is 3b2fa8b55a9b4adca3713962a9d31884in01 are displayed.
    {
+    "metrics": [
+        {
+            "unit": "Ratio",
+            "datapoints": [
+                {
+                    "sum": 0.07,
+                    "timestamp": 1556625628000
+                },
+                {
+                    "sum": 0.07,
+                    "timestamp": 1556625688000
+                }
+            ],
+            "namespace": "SYS.RDS",
+            "dimensions": [
+                {
+                    "name": "rds_cluster_id",
+                    "value": "3c8cc15614ab46f5b8743317555e0de2in01"
+                }
+            ],
+            "metric_name": "rds021_myisam_buf_usage"
+        },
+        {
+            "unit": "Ratio",
+            "datapoints": [
+                {
+                    "sum": 0.06,
+                    "timestamp": 1556625614000
+                },
+                {
+                    "sum": 0.07,
+                    "timestamp": 1556625674000
+                }
+            ],
+            "namespace": "SYS.RDS",
+            "dimensions": [
+                {
+                    "name": "rds_cluster_id",
+                    "value": "3b2fa8b55a9b4adca3713962a9d31884in01"
+                }
+            ],
+            "metric_name": "rds021_myisam_buf_usage"
+        }
+    ]
+}
    +
    +
    Response example 3: The minimum proc_specified_count of the server whose instance_id is cd841102-f6b1-407d-a31f-235db796dcbb and proc is b28354b543375bfa94dabaeda722927f is displayed.
    {
+    "metrics": [
+        {
+            "unit": "Ratio",
+            "datapoints": [
+                {
+                    "min": 0,
+                    "timestamp": 1556625612000
+                },
+                {
+                    "min": 0,
+                    "timestamp": 1556625672000
+                }
+            ],
+            "namespace": "AGT.ECS",
+            "dimensions": [
+                {
+                    "name": "instance_id",
+                    "value": "cd841102-f6b1-407d-a31f-235db796dcbb"
+                },
+                {
+                    "name": "proc",
+                    "value": "b28354b543375bfa94dabaeda722927f"
+                }
+            ],
+            "metric_name": "rds021_myisam_buf_usage"
+        }
+    ]
+}
    +
    +
+
+

Returned Values

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: Monitoring Data Management
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0035.html b/docs/ces/api-ref/ces_03_0035.html new file mode 100644 index 000000000..9f16ca3fe --- /dev/null +++ b/docs/ces/api-ref/ces_03_0035.html @@ -0,0 +1,227 @@ + + +

Querying the Host Configuration

+

Function

This API is used to query the host configuration for a specified event type in a specified period of time. You can specify the dimension of data to be queried.

+

This API is provided for SAP Monitor in the HANA scenario to query the host configuration. In other scenarios, the host configuration cannot be queried with this API.

+
+
+

URI

GET /V1.0/{project_id}/event-data

+
  • Parameter description +
    + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Mandatory

    +

    Description

    +

    project_id

    +

    Yes

    +

    Specifies the project ID.

    +

    For details about how to obtain the project ID, see Obtaining a Project ID.

    +
    +
    +
  • Parameters that are used to query the host configuration +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    namespace

    +

    Yes

    +

    String

    +

    Query the namespace of a service. For details, see Services Interconnected with Cloud Eye.

    +

    The namespace must be in the service.item format and contain 3 to 32 characters. service and item each must start with a letter and contain only letters, digits, and underscores (_).

    +

    type

    +

    Yes

    +

    String

    +

    Specifies the event type.

    +

    It can contain only letters, underscores (_), and hyphens (-). It must start with a letter and cannot exceed 64 characters, for example, instance_host_info.

    +

    from

    +

    Yes

    +

    String

    +

    Specifies the start time of the query.

    +

    The time is a UNIX timestamp and the unit is ms.

    +

    to

    +

    Yes

    +

    String

    +

    Specifies the end time of the query.

    +

    The time is a UNIX timestamp and the unit is ms.

    +

    from must be earlier than to.

    +

    dim

    +

    Yes

    +

    String

    +

    Specifies the dimension. For example, the ECS dimension is instance_id. For details about the dimensions corresponding to the monitoring metrics of each service, see the monitoring metrics description of the corresponding service in Services Interconnected with Cloud Eye.

    +

    Specifies the dimension. A maximum of three dimensions are supported, and the dimensions are numbered from 0 in dim.{i}=key,value format. key cannot exceed 32 characters and value cannot exceed 256 characters.

    +

    Example: dim.0=instance_id,i-12345

    +
    +
    +
+
  • Example: Query the configuration information about the ECS whose ID is 33328f02-3814-422e-b688-bfdba93d4051 and type is instance_host_info.
    GET https://{Cloud Eye endpoint}/V1.0/{project_id}/event-data?namespace=SYS.ECS&dim.0=instance_id,33328f02-3814-422e-b688-bfdba93d4051&type=instance_host_info&from=1450234543422&to=1450320943422
    +
+
+

Request

None

+
+

Response

  • Response parameters +
    + + + + + + + + + +
    Table 2 Response parameters

    Parameter

    +

    Type

    +

    Description

    +

    datapoints

    +

    Array of objects

    +

    Specifies the configuration list.

    +

    If the corresponding configuration information does not exist, datapoints is an empty array and is [].

    +

    For details, see Table 3.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + +
    Table 3 datapoints data structure description

    Parameter

    +

    Type

    +

    Description

    +

    type

    +

    String

    +

    Specifies the event type, for example, instance_host_info.

    +

    timestamp

    +

    long

    +

    Specifies when the event is reported. It is a UNIX timestamp and the unit is ms.

    +

    value

    +

    String

    +

    Specifies the host configuration information.

    +
    +
    +
  • Example response
    {
+    "datapoints": [
+        {
+            "type": "instance_host_info",
+            "timestamp": 1450231200000,
+            "value": "xxx"
+        },
+        {
+            "type": "instance_host_info",
+            "timestamp": 1450231800000,
+            "value": "xxx"
+        }
+    ]
+}
    +
+
+

Returned Values

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    You are forbidden to access the page requested.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: Monitoring Data Management
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0036.html b/docs/ces/api-ref/ces_03_0036.html new file mode 100644 index 000000000..3c342993f --- /dev/null +++ b/docs/ces/api-ref/ces_03_0036.html @@ -0,0 +1,16 @@ + + +

Quota Management

+

+
+
+ + +
+
Parent topic: API Description
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0037.html b/docs/ces/api-ref/ces_03_0037.html new file mode 100644 index 000000000..2c9c4a295 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0037.html @@ -0,0 +1,184 @@ + + +

Querying Quotas

+

Function

This API is used to query a resource quota and the used amount. The current resource refers to alarm rules only.

+
+

URI

GET /V1.0/{project_id}/quotas

+
  • Parameter description +
    + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Mandatory

    +

    Description

    +

    project_id

    +

    Yes

    +

    Specifies the project ID.

    +

    For details about how to obtain the project ID, see Obtaining a Project ID.

    +
    +
    +
  • Example: Query the alarm rule quota.
    GET https://{Cloud Eye endpoint}/V1.0/{project_id}/quotas
    +
+
+

Request

None

+
+

Response

  • Response parameters +
    + + + + + + + + + +
    Table 2 Response parameters

    Parameter

    +

    Type

    +

    Description

    +

    quotas

    +

    Object

    +

    Specifies the quota list.

    +

    For details, see Table 3.

    +
    +
    + +
    + + + + + + + + + +
    Table 3 Data structure description of quotas

    Parameter

    +

    Type

    +

    Description

    +

    resources

    +

    Array of objects

    +

    Specifies the resource quota list.

    +

    For details, see Table 4.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + +
    Table 4 Data structure description of resources

    Parameter

    +

    Type

    +

    Description

    +

    type

    +

    String

    +

    Specifies the quota type.

    +

    alarm indicates the alarm rule.

    +

    used

    +

    Integer

    +

    Specifies the used amount of the quota.

    +

    unit

    +

    String

    +

    Specifies the quota unit.

    +

    quota

    +

    Integer

    +

    Specifies the total amount of the quota.

    +
    +
    +
  • Example response
    { 
+"quotas": 
+    { 
+    "resources": [
+            {
+                "unit":"",
+                "type":"alarm",
+                "quota":1000,
+                "used":10 
+            }
+        ]
+    } 
+}
    +
+
+

Returned Values

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: Quota Management
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0038.html b/docs/ces/api-ref/ces_03_0038.html new file mode 100644 index 000000000..051e98d31 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0038.html @@ -0,0 +1,20 @@ + + +

Event Monitoring

+

+
+
+ + +
+
Parent topic: API Description
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0053.html b/docs/ces/api-ref/ces_03_0053.html new file mode 100644 index 000000000..f1fefa14a --- /dev/null +++ b/docs/ces/api-ref/ces_03_0053.html @@ -0,0 +1,16 @@ + + +

Common Parameters

+

+
+
+ +
+ diff --git a/docs/ces/api-ref/ces_03_0055.html b/docs/ces/api-ref/ces_03_0055.html new file mode 100644 index 000000000..a202ad6b9 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0055.html @@ -0,0 +1,121 @@ + + +

Status Codes

+
  • Normal +
    + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    200 OK

    +

    The results of GET and PUT operations are returned as expected.

    +

    201 Created

    +

    The results of the POST operation are returned as expected.

    +

    202 Accepted

    +

    The request has been accepted for processing.

    +

    204 No Content

    +

    The results of the DELETE operation are returned as expected.

    +
    +
    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    The server failed to process the request.

    +

    401 Unauthorized

    +

    You must enter a username and password to access the requested page.

    +

    403 Forbidden

    +

    You are forbidden to access the requested page.

    +

    404 Not Found

    +

    The server cannot 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 cannot 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 a 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. The service is unavailable.

    +

    504 Gateway Timeout

    +

    A gateway timeout error occurred.

    +
    +
    +
+
+
+
+
Parent topic: Common Parameters
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0057.html b/docs/ces/api-ref/ces_03_0057.html new file mode 100644 index 000000000..abcc60f21 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0057.html @@ -0,0 +1,15 @@ + + +

Obtaining a Project ID

+
A project ID needs to be specified in the URIs of some APIs. Therefore, you need to obtain the project ID before calling APIs. The following procedure describes how to obtain a project ID:
  1. Log in to the management console.
  2. Click the username and select My Credentials from the drop-down list.

    On the My Credentials page, view project IDs in the project list.

    +
    Figure 1 Viewing project IDs
    +

    In multi-project scenarios, expand the region, and obtain your sub-project ID from the Project ID column.

    +
+
+
+
+
+
Parent topic: Common Parameters
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0058.html b/docs/ces/api-ref/ces_03_0058.html new file mode 100644 index 000000000..5a6ba3eb4 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0058.html @@ -0,0 +1,14 @@ + + +

Appendix

+

+
+
+ +
+ diff --git a/docs/ces/api-ref/ces_03_0059.html b/docs/ces/api-ref/ces_03_0059.html new file mode 100644 index 000000000..50b1bd5db --- /dev/null +++ b/docs/ces/api-ref/ces_03_0059.html @@ -0,0 +1,180 @@ + + +

Services Interconnected with Cloud Eye

+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Category

+

Service

+

Namespace

+

Reference

+

Compute

+

Elastic Cloud Server

+

SYS.ECS

+

Basic ECS metrics

+

Bare Metal Server

+

SERVICE.BMS

+

BMS Metrics Under OS Monitoring

+

Auto Scaling

+

SYS.AS

+

AS metrics

+

Storage

+

Elastic Volume Service (attached to an ECS or BMS)

+

SYS.EVS

+

EVS metrics

+

Scalable File Service

+

SYS.SFS

+

SFS metrics

+

SFS Turbo

+

SYS.EFS

+

SFS Turbo metrics

+

Cloud Backup and Recovery

+

SYS.CBR

+

CBR metrics

+

Network

+

Elastic IP and bandwidth

+

SYS.VPC

+

VPC metrics

+

Elastic Load Balance

+

SYS.ELB

+

ELB metrics

+

NAT Gateway

+

SYS.NAT

+

NAT Gateway metrics

+

Security

+

Web Application Firewall

+

SYS.WAF

+

WAF metrics

+

Application

+

Distributed Message Service

+

SYS.DMS

+

DMS metrics

+

Distributed Cache Service

+

SYS.DCS

+

DCS metrics

+

Database

+

Relational Database Service

+

SYS.RDS

+

RDS for MySQL metrics

+

RDS for PostgreSQL metrics

+

RDS for SQL Server metrics

+

Document Database Service

+

SYS.DDS

+

DDS metrics

+

GaussDB NoSQL

+

SYS.NoSQL

+

GaussDB(for Cassandra) metrics

+

GaussDB(for MySQL)

+

SYS.GAUSSDB

+

GaussDB(for MySQL) metrics

+

GaussDB(for openGauss)

+

SYS.GAUSSDBV5

+

GaussDB(for MySQL) metrics

+

Data analysis

+

Data Warehouse Service

+

SYS.DWS

+

DWS metrics

+

Cloud Search Service

+

SYS.ES

+

CSS metrics

+
+
+
+
+
+
Parent topic: Appendix
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0060.html b/docs/ces/api-ref/ces_03_0060.html new file mode 100644 index 000000000..e18f3491e --- /dev/null +++ b/docs/ces/api-ref/ces_03_0060.html @@ -0,0 +1,188 @@ + + +

Change History

+
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

Released On

+

Description

+

2022-10-10

+

This release incorporates the following change:

+

Added section "Events Supported by Event Monitoring".

+

2021-02-19

+

Accepted for RM-3379.

+

2020-08-15

+

Accepted for RM-389.

+

2020-03-06

+

This release incorporates the following changes:

+ +

2019-08-31

+

This release incorporates the following change:

+

Added Event Monitoring.

+

2019-03-30

+

This release incorporates the following changes:

+
  • Changed Virtual Private Cloud (VPC) to Elastic IP (EIP) and Bandwidth in section "Elastic IP (EIP) and Bandwidth Monitoring Metrics."
  • Optimized the Distributed Message Service (DMS) metrics.
+

2018-12-30

+

This release incorporates the following changes:

+
  • Optimized Elastic Cloud Server (ECS) metrics, including the names of disk metrics.
  • Optimized Elastic Volume Service (EVS) disk metrics.
  • Optimized the names of Relational Database Service (RDS) metrics.
+

Added

+

Interconnected with Document Database Service (DDS).

+

2018-09-30

+

This release incorporates the following changes:

+ +

2018-08-30

+

This release incorporates the following change:

+

Interconnected with Cloud Search Service (CSS).

+

2018-06-30

+

This release incorporates the following change:

+

Added metrics for the enhanced load balancer and enhanced load balancer listener.

+

2018-05-30

+

This release incorporates the following change:

+

Accepted in OTC 3.1.

+

2018-03-30

+

This release incorporates the following change:

+

Added Virtual Private Cloud (VPC) traffic metrics.

+

2018-02-28

+

This release incorporates the following change:

+

Updated Virtual Private Cloud (VPC) metrics.

+

2017-12-30

+

This release incorporates the following changes:

+
  • Added the API for creating alarm rules.
  • Optimized descriptions of error codes.
+

2017-11-30

+

This release incorporates the following change:

+

Added Auto Scaling (AS) metrics.

+

2017-10-30

+

This release incorporates the following changes:

+
  • Optimized the descriptions of Distributed Message Service (DMS) metrics.
  • Added Scalable File Service (SFS) metrics.
+

2017-10-09

+

This release incorporates the following change:

+

Added the API for querying the host configuration.

+

2017-07-30

+
This release incorporates the following changes:
  • Added descriptions for Distributed Cache Service (DCS) metrics.
  • Added descriptions for API Gateway metrics.
  • Marked the section about querying followed metrics as deprecated.
+
+

2017-05-26

+

This release incorporates the following change:

+

Added Distributed Message Service (DMS) metrics.

+

2017-04-28

+

This release incorporates the following change:

+

Added Virtual Private Cloud (VPC) traffic metrics.

+

2017-02-27

+

This release incorporates the following change:

+

Added the setting description for the from parameter.

+

2016-12-30

+

This release incorporates the following change:

+

Added Relational Database Service (RDS) metrics.

+

2016-10-29

+

This release incorporates the following change:

+

Added Elastic Load Balance (ELB) metrics.

+

2016-10-19

+

This release incorporates the following change:

+

Deleted Resource Template Service (RTS) metrics.

+

2016-9-30

+

This release incorporates the following change:

+

Added Resource Template Service (RTS) metrics.

+

2016-8-25

+

This release incorporates the following changes:

+
  • Added the Cloud Container Engine (CCE), Relational Database Service (RDS), and Domain Name Service (DNS) services in Regions and Endpoints.
  • Added Elastic Cloud Server (ECS) metrics.
  • Added Relational Database Service (RDS) metrics.
+

2016-07-30

+

This release incorporates the following changes:

+
  • Modified the document contents to make the contents display by open API functions.
  • Added the interface for querying an alarm rule.
  • Added the interfaces for enabling, disabling, and deleting alarm rules.
  • Added the interface for adding monitoring data.
  • Added descriptions for Relational Database Service (RDS) metrics.
+

2016-04-14

+

This release incorporates the following changes:

+
  • Modified parameter descriptions in URL in Service Usage.
  • Modified steps for invoking interfaces in Token Authentication.
+

2016-03-09

+

This issue is the first official release.

+
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0074.html b/docs/ces/api-ref/ces_03_0074.html new file mode 100644 index 000000000..c42f7f060 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0074.html @@ -0,0 +1,294 @@ + + +

Querying Events

+

Function

This API is used to query the events, including system events and custom events.

+
+

URI

GET /V1.0/{project_id}/events

+
  • Parameter description +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Type

    +

    Mandatory

    +

    Description

    +

    project_id

    +

    String

    +

    Yes

    +

    Specifies the project ID.

    +

    For details about how to obtain the project ID, see Obtaining a Project ID.

    +

    event_type

    +

    String

    +

    No

    +

    Specifies the event type. Possible types are EVENT.SYS (system event) and EVENT.CUSTOM (custom event).

    +

    event_name

    +

    String

    +

    No

    +

    Specifies the event name. The name can be a system event name or a custom event name.

    +

    from

    +

    Integer

    +

    No

    +

    Specifies the start time of the query. The time is a UNIX timestamp and the unit is ms. Example: 1605952700911

    +

    to

    +

    Integer

    +

    No

    +

    Specifies the end time of the query. The time is a UNIX timestamp and the unit is ms. from must be smaller than to. For example, set to to 1606557500911.

    +

    start

    +

    Integer

    +

    No

    +

    Specifies the start value of pagination. The value is an integer. The default value is 0.

    +

    limit

    +

    Integer

    +

    No

    +

    Specifies the maximum number of events that can be queried at a time. Supported range: 1 to 100 (default)

    +
    +
    +
  • Example
    GET https://{Cloud Eye endpoint}/V1.0/{project_id}/events
    +
+
+

Request

None

+
+

Response

  • Response parameters
+ +
+ + + + + + + + + + + + + + + + +
Table 2 Parameter description

Parameter

+

Type

+

Mandatory

+

Description

+

events

+

Array of Events objects

+

No

+

Specifies one or more pieces of event data.

+

For details, see Table 3.

+

meta_data

+

MetaData object

+

No

+

Specifies the number of metadata records in the query result.

+

For details, see Table 4.

+
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 3 events field description

Parameter

+

Type

+

Mandatory

+

Description

+

event_name

+

String

+

No

+

Specifies the event name.

+

event_type

+

String

+

No

+

Specifies the event type.

+

event_count

+

Integer

+

No

+

Specifies the number of occurrences of this event within the specified query time range.

+

latest_occur_time

+

Long

+

No

+

Specifies when the event last occurred.

+

latest_event_source

+

String

+

No

+

Specifies the event source. If the event is a system event, the value is the namespace of each service. To view the namespace of each service, see Services Interconnected with Cloud Eye.

+

If the event is a custom event, the event source is defined by the user.

+
+
+ +
+ + + + + + + + + + + +
Table 4 meta_data data structure description

Parameter

+

Type

+

Mandatory

+

Description

+

total

+

Integer

+

No

+

Specifies the total number of events.

+
+
+
+
  • Example response
    {
+ "events": [
+   {
+     "event_name": "rebootServer",
+     "event_type": "EVENT.SYS",
+     "event_count": 5,
+     "latest_occur_time": 1606302400000,
+     "latest_event_source": "SYS.ECS"
+   },
+   {
+     "event_name": "deleteVolume",
+     "event_type": "EVENT.SYS",
+     "event_count": 6,
+     "latest_occur_time": 1606300359126,
+     "latest_event_source": "SYS.EVS"
+   },
+   {
+     "event_name": "event_001",
+     "event_type": "EVENT.CUSTOM",
+     "event_count": 4,
+     "latest_occur_time": 1606499035522,
+     "latest_event_source": "TEST.System"
+   }
+ ],
+ "meta_data": {
+   "total": 10
+ }
+}
    +
+

Returned Values

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: Event Monitoring
+
+
+ diff --git a/docs/ces/api-ref/ces_03_0075.html b/docs/ces/api-ref/ces_03_0075.html new file mode 100644 index 000000000..e2ad77391 --- /dev/null +++ b/docs/ces/api-ref/ces_03_0075.html @@ -0,0 +1,491 @@ + + +

Querying Monitoring Details of an Event

+

Function

This API is used to query the event details based on the event name.

+
+

URI

GET /V1.0/{project_id}/event/{event_name}

+
  • Parameter description +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Type

    +

    Mandatory

    +

    Description

    +

    project_id

    +

    String

    +

    Yes

    +

    Specifies the project ID.

    +

    For details about how to obtain the project ID, see Obtaining a Project ID.

    +

    event_name

    +

    String

    +

    Yes

    +

    Specifies the event name.

    +

    event_type

    +

    String

    +

    Yes

    +

    Specifies the event type. Possible types are EVENT.SYS (system event) and EVENT.CUSTOM (custom event).

    +

    event_source

    +

    String

    +

    No

    +

    Specifies the event name. The name can be a system event name or a custom event name.

    +

    event_level

    +

    String

    +

    No

    +

    Specifies the event severity. Possible severities are Critical, Major, Minor, and Info.

    +

    event_user

    +

    String

    +

    No

    +

    Specifies the name of the user who reports the event monitoring data. It can also be a project ID.

    +

    event_state

    +

    String

    +

    No

    +

    Specifies the event status. Possible statuses are normal, warning, or incident.

    +

    from

    +

    Integer

    +

    No

    +

    Specifies the start time of the query. The time is a UNIX timestamp and the unit is ms. Example: 1605952700911

    +

    to

    +

    Integer

    +

    No

    +

    No

    +

    Specifies the end time of the query. The time is a UNIX timestamp and the unit is ms. The from value must be smaller than the to value.

    +

    start

    +

    Integer

    +

    No

    +

    Specifies the start value of pagination. The value is an integer. The default value is 0.

    +

    limit

    +

    Integer

    +

    No

    +

    Specifies the maximum number of records that can be queried at a time. Supported range: 1 to 100 (default)

    +
    +
    +
  • Example
    GET https://{Cloud Eye endpoint}/V1.0/{project_id}/event/{event_name}
    +
+
+

Request

None

+
+

Response

  • Response parameters
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 2 Parameter description

Parameter

+

Type

+

Mandatory

+

Description

+

event_name

+

string

+

No

+

Specifies the event name. The name can be a system event name or a custom event name.

+

event_type

+

string

+

No

+

Specifies the event type. Possible types are EVENT.SYS (system event) and EVENT.CUSTOM (custom event).

+

event_users

+

Array of strings

+

No

+

Specifies the name of the user who reports the event. It can also be a project ID.

+

event_sources

+

Array of strings

+

No

+

Specifies the event source. If the event is a system event, the source is the namespace of each service. To view the namespace of each service, see Services Interconnected with Cloud Eye. If the event is a custom event, the event source is defined by the user.

+

event_info

+

Array of objects

+

No

+

Specifies details about one or more events.

+

For details, see Table 3.

+

meta_data

+

MetaData object

+

No

+

Specifies the number of metadata records in the query result.

+

For details, see Table 5.

+
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 3 event_info data structure description

Parameter

+

Type

+

Mandatory

+

Description

+

event_name

+

string

+

Yes

+

Specifies the event name. Start with a letter. Enter 1 to 64 characters. Only letters, digits, and underscores (_) are allowed.

+

event_source

+

string

+

No

+

Specifies the event source in the format of service.item. service and item each must start with a letter and contain 3 to 32 characters, including only letters, digits, and underscores (_).

+

time

+

long

+

Yes

+

Specifies when the event occurred, which is a UNIX timestamp (ms). Since there is a latency between the client and the server, the data timestamp to be inserted should be within the period that starts from one hour before the current time plus 20s to 10 minutes after the current time minus 20s. In this way, the timestamp will be inserted to the database without being affected by the latency.

+

detail

+

Detail object

+

Yes

+

Specifies the event details.

+

For details, see Table 4.

+

event_id

+

string

+

No

+

Specifies the event ID.

+
+
+ +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 4 detail data structure description

Parameter

+

Type

+

Mandatory

+

Description

+

content

+

string

+

No

+

Specifies the event content. Enter up to 4096 characters.

+

group_id

+

string

+

No

+

Specifies the resource group the event belongs to. This ID must be an existing resource group ID.

+

resource_id

+

string

+

No

+

Specifies the resource ID, which can contain a maximum of 128 characters.

+

resource_name

+

string

+

No

+

Specifies the resource name, which can contain a maximum of 128 characters.

+

event_state

+

string

+

No

+

Specifies the event status.

+

Valid value can be normal, warning, or incident.

+

event_level

+

string

+

No

+

Specifies the event severity.

+

Its value can be Critical, Major, Minor, or Info.

+

event_user

+

string

+

No

+

Specifies the event user. Enter up to 64 characters.

+

event_type

+

string

+

No

+

Specifies the event type.

+

Possible types are EVENT.SYS (system event) and EVENT.CUSTOM (custom event).

+
+
+ +
+ + + + + + + + + + + +
Table 5 meta_data data structure description

Parameter

+

Type

+

Mandatory

+

Description

+

total

+

Integer

+

No

+

Specifies the total number of events.

+
+
+
+
  • Example response
    {
+ "event_name": "rebootServer",
+ "event_type": "EVENT.SYS",
+ "event_users": [
+   ""
+ ],
+ "event_sources": [
+   "SYS.ECS"
+ ],
+ "event_info": [
+   {
+     "event_id": "ev1606302402256R6doP5YeZ",
+     "event_name": "rebootServer",
+     "event_source": "SYS.ECS",
+     "time": 1606302400000,
+     "detail": {
+       "content": "{\"resourceSpecCode\":\"kc1.4xlarge.2.linux\",\"enterpriseProjectId\":\"6efb843e-391a-46a8-afc8-7fe51c9dd575\"}",
+       "group_id": "",
+       "resource_id": "ef8dad27-0488-4de7-bb43-1a0df9806d90",
+       "resource_name": "CES-POROS-0001",
+       "event_state": "normal",
+       "event_level": "Minor",
+       "event_user": "",
+       "event_type": "EVENT.SYS"
+     }
+   },
+   {
+     "event_id": "ev1606296088071wGoAOxVYa",
+     "event_name": "rebootServer",
+     "event_source": "SYS.ECS",
+     "time": 1606296086000,
+     "detail": {
+       "content": "{\"resourceSpecCode\":\"kc1.4xlarge.2.linux\",\"enterpriseProjectId\":\"6efb843e-391a-46a8-afc8-7fe51c9dd575\"}",
+       "group_id": "",
+       "resource_id": "ef8dad27-0488-4de7-bb43-1a0df9806d90",
+       "resource_name": "CES-POROS-0001",
+       "event_state": "normal",
+       "event_level": "Minor",
+       "event_user": "",
+       "event_type": "EVENT.SYS"
+     }
+   },
+   {
+     "event_id": "ev1604654426090g7g37E6Yb",
+     "event_name": "rebootServer",
+     "event_source": "SYS.ECS",
+     "time": 1604654425000,
+     "detail": {
+       "content": "{\"resourceSpecCode\":\"c6.4xlarge.2.linux\",\"enterpriseProjectId\":\"129559eb-f795-4b5f-9e46-cbd43a462362\"}",
+       "group_id": "",
+       "resource_id": "0bfa63ee-31f5-40a9-b992-50992c80c58a",
+       "resource_name": "ndrv2-pod-ops-0001",
+       "event_state": "normal",
+       "event_level": "Minor",
+       "event_user": "",
+       "event_type": "EVENT.SYS"
+     }
+   }
+ ],
+ "meta_data": {
+   "total": 5
+ }
+}
    +
+

Returned Values

  • Normal

    200

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: Event Monitoring
+
+
+ diff --git a/docs/ces/api-ref/en-us_image_0218975120.png b/docs/ces/api-ref/en-us_image_0218975120.png new file mode 100644 index 0000000000000000000000000000000000000000..ec3abb85c4e87fdcfd64e390ee05842d55edaffe GIT binary patch literal 54806 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 H<}d#@Kp + +

Adding Monitoring Data

+

Function

This API is used to add one or more pieces of custom metric monitoring data to solve the problem that the system metrics cannot meet specific service requirements.

+
+

URI

POST /V1.0/{project_id}/metric-data

+
  • Parameter description +
    + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Mandatory

    +

    Description

    +

    project_id

    +

    Yes

    +

    Specifies the project ID.

    +

    For details about how to obtain the project ID, see Obtaining a Project ID.

    +
    +
    +
+
+

Request

  1. The size of a POST request cannot exceed 512 KB. Otherwise, the request will be denied.
  2. The period for sending POST requests must be shorter than the minimum aggregation period. Otherwise, the aggregated data will be noncontinuous. For example, if the aggregation period is 5 minutes and the POST request sending period is 7 minutes, the data will be aggregated every 10 minutes, rather than 5 minutes.
  3. Timestamp (collect_time) in the POST request body value must be within the period that starts from three days before the current time to 10 minutes after the current time. If it is not in this range, you are not allowed to insert the metric data.
+
+
  • Request parameters +
    + + + + + + + + + + + +
    Table 2 Parameter description

    Parameter

    +

    Type

    +

    Mandatory

    +

    Description

    +

    Array elements

    +

    Array of objects

    +

    Yes

    +

    Specifies whether to add one or more pieces of custom metric monitoring data.

    +

    For details, see Table 3.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 3 Array elements

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    metric

    +

    Yes

    +

    Object

    +

    Specifies the metric data.

    +

    For details, see Table 4.

    +

    ttl

    +

    Yes

    +

    Integer

    +

    Specifies the data validity period. The unit is second.

    +

    Supported range: 1 to 604800

    +

    If the validity period expires, the data will be automatically deleted.

    +

    collect_time

    +

    Yes

    +

    long

    +

    Specifies when the data was collected.

    +

    The time is UNIX timestamp (ms) format.

    +
    NOTE:

    Since there is a latency between the client and the server, the data timestamp to be inserted should be within the period that starts from three days before the current time plus 20s to 10 minutes after the current time minus 20s. In this way, the timestamp will be inserted to the database without being affected by the latency.

    +
    +

    value

    +

    Yes

    +

    double

    +

    Specifies the monitoring metric data to be added, which can be an integer or a floating point number.

    +

    unit

    +

    No

    +

    String

    +

    Specifies the data unit.

    +

    Enter a maximum of 32 characters.

    +

    type

    +

    No

    +

    String

    +

    Specifies the enumerated type.

    +

    Possible types:

    +
    • int
    • float
    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + +
    Table 4 metric data structure description

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    namespace

    +

    Yes

    +

    String

    +

    Specifies the customized namespace. For details, see Services Interconnected with Cloud Eye.

    +

    The namespace must be in the service.item format and contain 3 to 32 characters. service and item each must start with a letter and contain only letters, digits, and underscores (_). In addition, service cannot start with SYS, AGT, or SRE, and namespace cannot be SERVICE.BMS because this namespace has been used by the system.

    +

    You can leave this parameter blank when you set alarm_type to (EVENT.SYS| EVENT.CUSTOM).

    +

    dimensions

    +

    Yes

    +

    Array of objects

    +

    Specifies the metric dimension. A maximum of three dimensions are supported.

    +

    For details, see Table 5.

    +

    metric_name

    +

    Yes

    +

    String

    +

    Specifies the metric ID. For example, if the monitoring metric of an ECS is CPU usage, metric_name is cpu_util. For details, see Services Interconnected with Cloud Eye.

    +
    +
    + +
    + + + + + + + + + + + + + + + + +
    Table 5 dimensions data structure description

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    name

    +

    Yes

    +

    String

    +

    Specifies the dimension. For example, the ECS dimension is instance_id. For details about the dimension of each service, see the key column in Services Interconnected with Cloud Eye.

    +

    Start with a letter. Enter 1 to 32 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.

    +

    value

    +

    Yes

    +

    String

    +

    Specifies the dimension value, for example, an ECS ID.

    +

    Start with a letter or a digit. Enter 1 to 256 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed.

    +
    +
    +
+
  • Example request
    Example request 1: Add cpu_util data of a custom dimension. The instance ID is 6f3c6f91-4b24-4e1b-b7d1-a94ac1cb011d.
    [
+    {
+        "metric": {
+            "namespace": "MINE.APP",
+            "dimensions": [
+                {
+                    "name": "instance_id",
+                    "value": "6f3c6f91-4b24-4e1b-b7d1-a94ac1cb011d"
+                }
+            ],
+            "metric_name": "cpu_util"
+        },
+        "ttl": 172800,
+        "collect_time": 1463598260000,
+        "type": "float",
+        "value": 0.09,
+        "unit": "%"
+    },
+    {
+        "metric": {
+            "namespace": "MINE.APP",
+            "dimensions": [
+                {
+                    "name": "instance_id",
+                    "value": "6f3c6f91-4b24-4e1b-b7d1-a94ac1cb011d"
+                }
+            ],
+            "metric_name": "cpu_util"
+        },
+        "ttl": 172800,
+        "collect_time": 1463598270000,
+        "type": "float",
+        "value": 0.12,
+        "unit": "%"
+    }
+]
    +
    +
    Example request 2: Add rds021_myisam_buf_usage data of the RDS instance whose rds_cluster_id is 3c8cc15614ab46f5b8743317555e0de2in01.
    [
+    {
+        "metric": {
+            "namespace": "SYS.RDS",
+            "dimensions": [
+                {
+                    "name": "rds_cluster_id",
+                    "value": "3c8cc15614ab46f5b8743317555e0de2in01"
+                }
+            ],
+            "metric_name": "rds021_myisam_buf_usage"
+        },
+        "ttl": 172800,
+        "collect_time": 1463598260000,
+        "type": "float",
+        "value": 0.01,
+        "unit": "Ratio"
+    }
+]
    +
    +
+
+

Response

The response has no message body.

+
+

Returned Values

  • Normal

    201

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    You are forbidden to access the page requested.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: Monitoring Data Management
+
+
+ diff --git a/docs/ces/api-ref/en-us_topic_0109034020.html b/docs/ces/api-ref/en-us_topic_0109034020.html new file mode 100644 index 000000000..e2716923f --- /dev/null +++ b/docs/ces/api-ref/en-us_topic_0109034020.html @@ -0,0 +1,339 @@ + + +

Reporting Events

+

Function

An API for reporting custom events is provided, which helps you collect and report abnormal events or important change events to Cloud Eye.

+
+

URI

POST /V1.0/{project_id}/events

+
  • Parameter description +
    + + + + + + + + + +
    Table 1 Parameter description

    Parameter

    +

    Mandatory

    +

    Description

    +

    project_id

    +

    Yes

    +

    Specifies the project ID.

    +

    For details about how to obtain the project ID, see Obtaining a Project ID.

    +
    +
    +
  • Example
    POST https://{Cloud Eye endpoint}/V1.0/{project_id}/events
    +
+
+

Request

  • Request parameters +
    + + + + + + + + + + + +
    Table 2 Parameter description

    Parameter

    +

    Type

    +

    Mandatory

    +

    Description

    +

    Array elements

    +

    Arrays of objects

    +

    Yes

    +

    Specifies the event list.

    +

    For details, see Table 3.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 3 Array elements

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    event_name

    +

    Yes

    +

    String

    +

    Specifies the event name.

    +

    Start with a letter. Enter 1 to 64 characters. Only letters, digits, and underscores (_) are allowed.

    +

    event_source

    +

    Yes

    +

    String

    +

    Specifies the event source.

    +

    The format is service.item. Set this parameter based on the site requirements.

    +

    service and item each must be a string that starts with a letter and contains 3 to 32 characters, including only letters, digits, and underscores (_).

    +

    time

    +

    Yes

    +

    long

    +

    Specifies when the event occurred, which is a UNIX timestamp (ms).

    +
    NOTE:

    Since there is a latency between the client and the server, the data timestamp to be inserted should be within the period that starts from one hour before the current time plus 20s to 10 minutes after the current time minus 20s. In this way, the timestamp will be inserted to the database without being affected by the latency.

    +

    For example, if the current time is 2020.01.30 12:00:30, the timestamp inserted must be within the range [2020.01.30 11:00:50, 2020.01.30 12:10:10]. The corresponding UNIX timestamp is [1580353250, 1580357410].

    +
    +

    detail

    +

    Yes

    +

    Arrays of objects

    +

    Specifies the event details.

    +

    For details, see Table 4.

    +
    +
    + +
    + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    Table 4 detail data structure description

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    content

    +

    No

    +

    String

    +

    Specifies the event content. Enter up to 4096 characters.

    +

    resource_id

    +

    No

    +

    String

    +

    Specifies the resource ID. Enter up to 128 characters, including letters, digits, underscores (_), hyphens (-), and colon (:).

    +

    Example: 6a69bf28-ee62-49f3-9785-845dacd799ec

    +

    To query the resource ID, perform the following steps:

    +
    1. Log in to the management console.
    2. Under Computing, select Elastic Cloud Server.

      On the Resource Overview page, obtain the resource ID.

      +
    +

    resource_name

    +

    No

    +

    String

    +

    Specifies the resource name. Enter up to 128 characters, including letters, digits, underscores (_), and hyphens (-).

    +

    event_state

    +

    No

    +

    String

    +

    Specifies the event status.

    +

    Valid value can be normal, warning, or incident.

    +

    event_level

    +

    No

    +

    String

    +

    Specifies the event severity.

    +

    Its value can be Critical, Major, Minor, or Info.

    +

    event_user

    +

    No

    +

    String

    +

    Specifies the event user.

    +

    Enter up to 64 characters, including letters, digits, underscores (_), hyphens (-), slashes (/), and spaces.

    +
    +
    +
+
  • Example request
    [{
+    "event_name":"systemInvaded",
+    "event_source":"financial.System",
+    "time":1522121194000,
+    "detail":{
+        "content":"The financial system was invaded",
+        "group_id":"rg15221211517051YWWkEnVd",
+        "resource_id":"1234567890sjgggad",
+        "resource_name":"ecs001",
+        "event_state":"normal",
+        "event_level":"Major",
+        "event_user":"xiaokong"
+    }
+},
+{
+    "event_name":"systemInvaded",
+    "event_source":"financial.System",
+    "time":1522121194020,
+    "detail":{
+        "content":"The financial system was invaded",
+        "group_id":"rg15221211517051YWWkEnVd",
+        "resource_id":"1234567890sjgggad",
+        "resource_name":"ecs001",
+        "event_state":"normal",
+        "event_level":"Major",
+        "event_user":"xihong"
+    }
+}]
    +
+
+

Response

  • Response parameters +
    + + + + + + + + + +
    Table 5 Parameter description

    Parameter

    +

    Type

    +

    Description

    +

    Array elements

    +

    Arrays of objects

    +

    Specifies the event list.

    +

    For details, see Table 6.

    +
    +
    + +
    + + + + + + + + + + + + + + + + +
    Table 6 Response parameters

    Parameter

    +

    Mandatory

    +

    Type

    +

    Description

    +

    event_id

    +

    Yes

    +

    String

    +

    Specifies the event ID.

    +

    event_name

    +

    Yes

    +

    String

    +

    Specifies the event name.

    +

    Start with a letter. Enter 1 to 64 characters. Only letters, digits, and underscores (_) are allowed.

    +
    +
    +
+
  • Example response
    [
+       {
+            "event_id":"evdgiqwgedkkcvhdjcdu346",
+            "event_name":"systemInvaded"
+        },
+        {
+            "event_id":"evdgiqwgedkkcvhdjcdu347",
+            "event_name":"systemParalysis"
+        }
+]
    +
+
+

Returned Values

  • Normal

    201

    +
  • Abnormal +
    + + + + + + + + + + + + + + + + + + + + + + + + + +

    Returned Value

    +

    Description

    +

    400 Bad Request

    +

    Request error.

    +

    401 Unauthorized

    +

    The authentication information is not provided or is incorrect.

    +

    403 Forbidden

    +

    Access to the requested page is forbidden.

    +

    408 Request Timeout

    +

    The request timed out.

    +

    429 Too Many Requests

    +

    Concurrent requests are excessive.

    +

    500 Internal Server Error

    +

    Failed to complete the request because of an internal service error.

    +

    503 Service Unavailable

    +

    The service is currently unavailable.

    +
    +
    +
+
+

Error Codes

See Error Codes.

+
+
+
+
+
Parent topic: Event Monitoring
+
+
+ diff --git a/docs/ces/api-ref/public_sys-resources/caution_3.0-en-us.png b/docs/ces/api-ref/public_sys-resources/caution_3.0-en-us.png new file mode 100644 index 0000000000000000000000000000000000000000..60f60762138fe7d98fa081415cf26a4943897779 GIT binary patch literal 2752 zcmV;x3P1IUP)pPa!Eu%RCwC$n`u~-F-BFk{0Y@>jH&Wt02T)4n7aXBssVicB` zOX`JaF2{q_2~&#?rkP8$id|Xfs23G(+0lTGT0tnFxgZFMIx;xG$R>Lr2ng2sFhB=q zSd{Td_5QEx{V+WDJooe7@Bg{)|8u`XpV~`~ZvvYTAfN{@5<(zAAd&!qNCE^R2@oI< zNq|5k0e^NPrRGdyW8`F%MH7XH|3P8=s2${2dg49z003YAM?%tm1!4=85P2aZJs3WS zG6CT8kCv0C(eT;v!9vu9jP&3oZEw^8HmnQ6+clMCL4mv(zK?)Ob8&M#`$%sr@v0v& z@zoUHs-n619H>uFER~Aj==ntk06q~XtAWrX`-(7l=)GLjQP?!@q z{@ZTZw0`amLgo~4vvd&0Pxryp)QHy>ob2%4P9)V*SX4zr!(BuoQ>IK9!d&k>z1cqI z{8L;})njUE#LIJj>h%6Q^ZVF{wB;i;Qi+5h9}NJn%x@raKm6;fW+Fl#T`67idLh|4 zu~b$4-1hhHTVfMtV@>p)0G=3ns@?Zq+;oGKv z*YE#+n>`1!`TpdYF4yhs&w)&meoVo}#+v$ur`WVKNyq<%YnFsZMC$eXSc!Bf$)AMeNOrxm z98up?0IbZ4d1uoLyuSG}0{xcY?H+G%68SDpqp0{6ZmtR(?ChBNKk$ZxK&chd%Fub9B!C3$z*oSdfKP$^R+Au*=jW--Q5@}8T8wOFz(A> z+jPJi0CSN!@M}8~J+m~H+qJd0$mL8L?}^W38D?fiTvJtZ_QG{CGOx1j!^2co2eNIY zE_th}e&*28WCEs4)4Ngh`F*TJs&5jrEg}J*$>Ry|NTs@Q5S4XS*jiLGYupV!l}OmJ zCkyWg!}|T(8zmGK-@ggmTpXX4Lzd^H6d8Ibpk8+o_km$bMW>TS}&FY)P96F+{d%+84 z0FbR#^Wj0eUL$0WrHtk7-A3#N4!~oiv))WDwoq|!rza!b-MC#_%g6i5bZq+f?}v+A z&dvOM*6oz`?o(Suoq{*R_pvM}5O;^mT)Ww?Z7fftAwAED0FP9BCXZ)ZL<03qVuSdN zP8xtRONCq}V{LHL13e@F7rC5Q7nL%1)>HuEPG%TvZ9T=8(JF40lp-DCMCkm>9oo4$ zp2gbI0)X_(**fDB#*QLr-bCyM4&cnWE2QR3>%BzUvd0>L#Q|n|$1Tk60kC$33wat1 zyP`b|;`hpR?G6;%TDEA7?qPdG5~XG3DCEwFEmXV^*atUP1r?Q*Z6tf#C@HG~z|7R7 z%W^bSHmKdEz8|Y+XCNKoj5;@$;5Eqx+bjkplCo$bd!u65ur3Iht+xK#S>J1CGr+PQ z0C$JWZS8>kO3xnquB&Tk(E(-;v|eN5zDOk!LKaKgc6D>}Jxa^U*&dP9D~M#(l4Wdd zEW5NF>oE`jQ&SV}G+O8_@4Ge+!`aD+oB8?teVaq?BU0GA1xO_l=1nQrAx&+WdOB8S#d?X;+5%{W zL%$q0tP5gqR7{WS^|&#ETLM_$tqfODr{F@Wvh7$L9&xbkIv%IZL`G<~%z?=et2Z8l(~lTRu|vXblrbH{CQq;M*jC6P7 zAFJjO7P_e26);09x-VYJYSS8{M>uNB=$!_=`UBu*VJQICR{ab{qy@7TIM~}!cc+es zuSRv+yK8E024LzW_fF?DH>qIv7JK9}8Okgb+deq(_=yx1KZZPwhLE7)i2By(j4ulc zZ0X+G=!}W_*0i+)j$M5C6#K-`Q^PI#NC$_uZf2|)Q-QCDmtJxjn1b~m%uQ)q7k*!v<@zee~^S^yy8n;SIv9h!z@F~L` zuV;E)#MIP`TP3BWq~-E)te=ie;#EKP>`x<4qruHp!K;f(yPS8hZ8~d0reR}ajZ`A( z(HeW)kgTXvuy(`eEDH)`tWfsw@ySLcm z71)pX#Is~7?MOOfjY2*gfad0Vq-SPfE=p#UyBs4UBW!G}*%&$+h}RorbCI@}bUZGD z(D`DX7<2A;EnO+wSMkI5S3ZiysJKOPz zXHjNr`1+U~!-i@z2TQevhO_F+9anqo4qDp6*s z{^#^#iMhy}=wm-XjcU;ayd~S zjKa+^{((2(%#||Kxw$%iyNf&$A}5<97d+PwF{vJcqF5t}K17 zWA47SPe$ba7&NE7d;EGLztWTQN_%qi?{fFvpbejgc;mTn%wk=QtX`o_PVsJli{margin-top:0}*[compact="no"]>li{margin-top:.53em}.liexpand{margin-top:1em;margin-bottom:1em}.sliexpand{margin-top:1em;margin-bottom:1em}.dlexpand{margin-top:1em;margin-bottom:1em}.ddexpand{margin-top:1em;margin-bottom:1em}.stepexpand{margin-top:.3em;margin-bottom:.3em}.substepexpand{margin-top:.3em;margin-bottom:.3em}div.imageleft{text-align:left}div.imagecenter{text-align:center}div.imageright{text-align:right}div.imagejustify{text-align:justify}div.noblankline{text-align:center}div.noblankline img{margin-top:0}pre.screen{margin-top:2px;margin-bottom:2px;padding:1.5px 1.5px 0 1.5px;border:0;background-color:#ddd;white-space:pre}pre.codeblock{margin-top:2px;margin-bottom:2px;padding:1.5px 1.5px 0 1.5px;border:0;background-color:#ddd;white-space:pre}.hrcopyright{color:#3f4e5d;margin-top:18pt}.hwcopyright{text-align:center}.comment{margin:2px 2px 2px 2px;font-family:Arial;font-size:10pt;background-color:#bfb;color:#000}.dropdownAllButtonexpand{cursor:pointer;background-repeat:no-repeat;background-position:0 4px;padding-left:15px;background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4}.dropdownAllButtoncollapse{cursor:pointer;background-repeat:no-repeat;background-position:0 4px;padding-left:15px;background-image:url(icon-arrowdn.gif);text-decoration:underline;color:#007af4;text-decoration:underline;color:#007af4}.dropdowntitle{background-repeat:no-repeat;background-position:0 4px;padding-left:15px;cursor:pointer;text-decoration:underline;color:#007af4}.dropdownexpand .dropdowntitle{background-image:url(icon-arrowdn.gif);text-decoration:underline;color:#007af4;margin:0 0 8px 0}.dropdowncollapse .dropdowncontext{display:none}.dropdowncollapse .dropdowntitle{background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4}.dropdowncollapsetable{border:0}.dropdowncollapsetable .dropdowncontext{display:none}.dropdowncollapsetable .dropdowntitle{background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4}pre{font-size:10pt;font-weight:normal;margin-left:9;margin-top:2;margin-bottom:2}.termcolor{color:blue;cursor:pointer}#dhtmlgoodies_tooltip{background-color:#f0f0d2;border:1px solid #000;position:absolute;display:none;z-index:20000;padding:2px;font-size:.9em;-moz-border-radius:6px;font-family:"Trebuchet MS","Lucida Sans Unicode",Arial,sans-serif}#dhtmlgoodies_tooltipShadow{position:absolute;background-color:#555;display:none;z-index:10000;opacity:.7;filter:alpha(opacity=70);-khtml-opacity:.7;-moz-opacity:.7;-moz-border-radius:6px}.freeze{position:fixed;_position:absolute;_top:expression(eval(document.documentElement.scrollTop));left:10;top:0} \ No newline at end of file diff --git a/docs/ces/api-ref/public_sys-resources/commonltr_print.css b/docs/ces/api-ref/public_sys-resources/commonltr_print.css new file mode 100644 index 000000000..a59823141 --- /dev/null +++ b/docs/ces/api-ref/public_sys-resources/commonltr_print.css @@ -0,0 +1 @@ +body{font-size:12.0pt;margin:1.5em;margin-left:1.6cm}.msgph{font-family:Courier New}.rowlinecopyright{color:red;margin-top:10pt}.unresolved{background-color:skyblue}.noTemplate{background-color:yellow}.base{background-color:#fff}.nested0{margin-top:1em}.p{margin-top:1em}p{margin-top:.5em;margin-bottom:.5em}.note p{margin-top:.5em;margin-bottom:.5em}.tip p{margin-top:.5em;margin-bottom:.5em}.danger p{margin-top:.5em;margin-bottom:.5em}.warning p{margin-top:.5em;margin-bottom:.5em}.notice p{margin-top:.5em;margin-bottom:.5em}.caution p{margin-top:.5em;margin-bottom:.5em}.attention p{margin-top:.5em;margin-bottom:.5em}table p{margin-top:.2em;margin-bottom:.2em}table .p{margin-top:.4em;margin-bottom:.2em}.covertable{border:0;width:100% cellpadding:8pt;cellspacing:8pt}.cover_productname{font-size:15.0pt;font-family:"Arial"}.cover_manualtitle{font-size:24.0pt;font-weight:bold;font-family:"Arial"}.cover_manualsubtitle{font-size:18.0pt;font-weight:bold;font-family:"Arial"}.cover_heading{font-size:12.0pt;font-weight:bold;font-family:"Arial"}.cover_text{font-size:9.0pt;font-family:"Arial"}.tocheading,.heading1,.topictitle1{margin-top:40.0pt;margin-right:0;margin-bottom:20.0pt;margin-left:-1cm;text-align:left;border:0;border-bottom:solid windowtext .5pt;font-size:22.0pt;font-family:"Arial";font-weight:bold}.topictitlenumber1{font-size:72.0pt;font-family:"Book Antiqua";font-weight:bold}.topictitle2{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:-1cm;text-indent:0;font-size:18.0pt;font-family:"Arial";font-weight:bold}.topictitle3{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:0;text-indent:0;font-size:16.0pt;font-family:"Book Antiqua";font-weight:bold}.topictitle4{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:0;text-indent:0;font-size:14.0pt;font-family:"Book Antiqua";font-weight:bold}.topictitle5{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:0;text-indent:0;font-size:13.0pt;font-family:"Book Antiqua";font-weight:bold}.blocklabel,.topictitle6{margin-top:15.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;text-indent:0;font-size:13.0pt;font-family:"Book Antiqua";font-weight:bold}.sectiontitle{margin-top:15.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:-1cm;text-indent:0;font-size:13.0pt;font-family:"Arial";font-weight:bold}.tocentry1{margin-top:8.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:12.0pt;font-family:"Book Antiqua";font-weight:bold}.tocentry2{margin-top:4.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman"}.tocentry3{margin-top:4.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman"}.tocentry4{margin-top:4.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman"}.tocentry5{margin-top:4.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman"}.tofentry1{margin-top:8.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman";font-weight:normal}.totentry1{margin-top:8.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;line-height:12.0pt;font-size:11.0pt;font-family:"Times New Roman";font-weight:normal}.indexheading{margin-top:15.0pt;margin-right:0;margin-bottom:4.0pt;margin-left:0;text-indent:0;font-size:13.0pt;font-family:"Book Antiqua";font-weight:bold}.indexentry1{margin-top:4pt;margin-right:0;margin-bottom:0;margin-left:0;line-height:12.0pt;font-size:12.0pt;font-family:"Times New Roman"}.indexentry2{margin-top:0;margin-right:0;margin-bottom:0;margin-left:24.0pt;line-height:12.0pt;font-size:12.0pt}.indexentry3{margin-top:0;margin-right:0;margin-bottom:0;margin-left:48pt;line-height:12.0pt;font-size:12.0pt}.figurenumber{font-weight:bold}.tablenumber{font-weight:bold}.familylinks{margin-top:1.5em;margin-bottom:1em}.figcap{font-size:11.0pt}.tablecap{font-size:11.0pt}.figdesc{font-style:normal}.fignone{margin-top:8.0pt}.figborder{border-style:solid;padding-left:3px;border-width:2px;padding-right:3px;margin-top:1em;border-color:Silver}.figsides{border-left:2px solid;padding-left:3px;border-right:2px solid;padding-right:3px;margin-top:1em;border-color:Silver}.figtop{border-top:2px solid;margin-top:1em;border-color:Silver}.figbottom{border-bottom:2px solid;border-color:Silver}.figtopbot{border-top:2px solid;border-bottom:2px solid;margin-top:1em;border-color:Silver}.ullinks{margin-left:0;list-style-type:none}.ulchildlink{margin-top:1em;margin-bottom:1em}.olchildlink{margin-top:1em;margin-bottom:1em;margin-left:1em}.linklist{margin-bottom:1em}.linklistwithchild{margin-left:1.5em;margin-bottom:1em}.sublinklist{margin-left:1.5em;margin-bottom:1em}.relconcepts{margin-left:1cm;margin-top:1em;margin-bottom:1em}.reltasks{margin-left:1cm;margin-top:1em;margin-bottom:1em}.relref{margin-left:1cm;margin-top:1em;margin-bottom:1em}.relinfo{margin-top:1em;margin-bottom:1em}.breadcrumb{font-size:smaller;margin-bottom:1em}.prereq{margin-left:0}.parentlink{margin-top:.6em;margin-bottom:.6em}.nextlink{margin-top:.6em;margin-bottom:.6em}.previouslink{margin-top:.6em;margin-bottom:.6em}.section{margin-top:1em;margin-bottom:1em}.example{margin-top:1em;margin-bottom:1em}table .note{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.note{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.notetitle{font-weight:bold;font-size:11.0pt}.notelisttitle{font-weight:bold}table .tip{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.tip{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.tiptitle{font-weight:bold;font-size:11.0pt}table .fastpath{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.fastpath{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.fastpathtitle{font-weight:bold;font-size:11.0pt}table .important{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman";font-style:italic}.important{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.importanttitle{font-weight:bold;font-size:11.0pt}table .remember{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman";font-style:italic}.remember{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.remembertitle{font-weight:bold;font-size:11.0pt}table .restriction{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman";font-style:italic}.restriction{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;border-top:solid .5pt;border-bottom:solid .5pt}.restrictiontitle{font-weight:bold;font-size:11.0pt}table .attention{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.attention{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}.attentiontitle{font-weight:bold}table .danger{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.dangertitle{font-weight:bold}.danger{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}table .notice{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.noticetitle{font-weight:bold}.notice{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}table .warning{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}.warningtitle{font-weight:bold}.warning{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}table .caution{margin-top:1em;margin-bottom:1em;border:0;font-size:10.0pt;font-family:"Times New Roman"}table caption{margin-top:8pt;text-align:left;font-weight:bold}.tablenoborder{margin-top:8pt}.cautiontitle{font-weight:bold}.caution{margin-top:1em;margin-bottom:1em;border:0;border-top:solid .5pt;border-bottom:solid .5pt}ul.simple{list-style-type:none}li ul{margin-top:.6em}li{margin-top:.6em;margin-bottom:.6em}.note li{margin-top:.2em;margin-bottom:.2em}.tip li{margin-top:.2em;margin-bottom:.2em}.danger li{margin-top:.2em;margin-bottom:.2em}.warning li{margin-top:.2em;margin-bottom:.2em}.notice li{margin-top:.2em;margin-bottom:.2em}.caution li{margin-top:.2em;margin-bottom:.2em}.attention li{margin-top:.2em;margin-bottom:.2em}table li{margin-top:.2em;margin-bottom:.2em}.firstcol{font-weight:bold}th{background-color:#cfcfcf}.bold{font-weight:bold}.boldItalic{font-weight:bold;font-style:italic}.italic{font-style:italic}.underlined{text-decoration:underline}.var{font-style:italic}.shortcut{text-decoration:underline}.dlterm{font-weight:bold}dd{margin-top:.5em;margin-bottom:.5em}.dltermexpand{font-weight:bold;margin-top:1em}*[compact="yes"]>li{margin-top:0}*[compact="no"]>li{margin-top:.53em}.liexpand{margin-top:1em;margin-bottom:1em}.sliexpand{margin-top:1em;margin-bottom:1em}.dlexpand{margin-top:1em;margin-bottom:1em}.ddexpand{margin-top:1em;margin-bottom:1em}.stepexpand{margin-top:1em;margin-bottom:1em}.substepexpand{margin-top:1em;margin-bottom:1em}table{margin-top:8pt;margin-bottom:10.0pt;width:100%}thead{font-size:10.0pt;font-family:"Book Antiqua";font-weight:bold}tbody{font-size:11.0pt}ol{margin-top:1em;margin-bottom:1em;margin-left:1.7em;-webkit-padding-start:0}ul{margin-top:1em;margin-bottom:1em;margin-left:1.2em;-webkit-padding-start:0}ol ul{list-style:disc}ul ul{list-style:square}ol ol{list-style-type:lower-alpha}table ol{margin-top:.4em;margin-bottom:.4em;list-style:decimal}table ul{margin-top:.4em;margin-bottom:.4em;list-style:disc}table ul ul{margin-top:.4em;margin-bottom:.4em;list-style:square}table ol ol{margin-top:.4em;margin-bottom:.4em;list-style:lower-alpha}table ol ul{margin-top:.4em;margin-bottom:.4em;list-style:disc}table ul ol{margin-top:.4em;margin-bottom:.4em;list-style:decimal}.substepthirdol{list-style-type:lower-roman}div.imageleft{text-align:left}div.imagecenter{text-align:center}div.imageright{text-align:right}div.imagejustify{text-align:justify}div.noblankline{text-align:center}div.noblankline img{margin-top:0}pre{font-size:10.0pt;border-width:2px;padding:2px;margin-top:5px;margin-bottom:5px;white-space:pre-wrap;white-space:-moz-pre-wrap;white-space:-pre-wrap;white-space:-o-pre-wrap;word-wrap:break-word}pre.screen{margin-top:2px;margin-bottom:2px;padding:1.5px 1.5px 0 1.5px;border:0;white-space:pre}pre.codeblock{margin-top:2px;margin-bottom:2px;padding:1.5px 1.5px 0 1.5px;border:0;white-space:pre}.dropdownAllButtonexpand{cursor:pointer;background-repeat:no-repeat;background-position:0 4px;padding-left:15px;background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4}.dropdownAllButtoncollapse{cursor:pointer;background-repeat:no-repeat;background-position:0 4px;padding-left:15px;background-image:url(icon-arrowdn.gif);text-decoration:underline;color:#007af4;text-decoration:underline;color:#007af4}.dropdowntitle{background-repeat:no-repeat;background-position:0 4px;padding-left:15px;cursor:pointer;text-decoration:underline;color:#007af4}.dropdownexpand .dropdowntitle{background-image:url(icon-arrowdn.gif);text-decoration:underline;color:#007af4;margin:0 0 8px 0}.dropdowncollapse .dropdowntitle{background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4;margin:0 0 8px 0}.dropdowncollapsetable .dropdowntitle{background-image:url(icon-arrowrt.gif);text-decoration:underline;color:#007af4;margin:0 0 8px 0}.prefacesectiontitle1{margin-top:10.0pt;margin-right:0;margin-bottom:8.0pt;margin-left:-1cm;text-indent:0;font-size:18.0pt;font-family:"Book Antiqua";font-weight:bold;overflow:auto}.termcolor{color:blue;cursor:pointer}#dhtmlgoodies_tooltip{background-color:#f0f0d2;border:1px solid #000;position:absolute;display:none;z-index:20000;padding:2px;font-size:.9em;-moz-border-radius:6px;font-family:"Trebuchet MS","Lucida Sans Unicode",Arial,sans-serif}#dhtmlgoodies_tooltipShadow{position:absolute;background-color:#555;display:none;z-index:10000;opacity:.7;filter:alpha(opacity=70);-khtml-opacity:.7;-moz-opacity:.7;-moz-border-radius:6px}.freeze{position:fixed;_position:absolute;_top:expression(eval(document.documentElement.scrollTop));left:10;top:0}.hrcopyright{color:#3f4e5d;margin-top:18pt;margin-left:-1cm}.hwcopyright{text-align:center;font-family:Arial;margin-left:-1cm} \ No newline at end of file diff --git a/docs/ces/api-ref/public_sys-resources/commonrtl.css b/docs/ces/api-ref/public_sys-resources/commonrtl.css new file mode 100644 index 000000000..f261da752 --- /dev/null +++ b/docs/ces/api-ref/public_sys-resources/commonrtl.css @@ -0,0 +1,2 @@ +/*! Copyright (c) Huawei Technologies Co., Ltd. 2020-2022. All rights reserved. */.msgph{font-family:Courier New}.unresolved{background-color:#87ceeb}.noTemplate{background-color:#ff0}.base{background-color:#fff}/*! Add space for top level topics */.nested0,.p{margin-top:1em}/*! div with class=p is used for paragraphs that contain blocks, to keep the XHTML valid *//*! Default of italics to set apart figure captions */.figcap,.italic,.var{font-style:italic}.figdesc{font-style:normal}/*! Use @frame to create frames on figures */.figborder{padding-left:3px;padding-right:3px;margin-top:1em;border:2px solid Silver}.figsides{margin-top:1em;padding-left:3px;padding-right:3px;border-left:2px solid Silver;border-right:2px solid Silver}.figtop{border-top:2px solid Silver;margin-top:1em}.figbottom{border-bottom:2px solid Silver}.figtopbot{border-top:2px solid Silver;border-bottom:2px solid Silver;margin-top:1em}/*! Most link groups are created with
. Ensure they have space before and after. */.ullinks,ul.simple{list-style-type:none}.attention,.danger,.ddexpand,.dlexpand,.example,.fastpath,.important,.liexpand,.linklist,.note,.notice,.olchildlink,.relconcepts,.relinfo,.relref,.reltasks,.remember,.restriction,.section,.sliexpand,.stepexpand,.substepexpand,.tip,.ulchildlink,.warning{margin-top:1em;margin-bottom:1em}.linklistwithchild,.sublinklist{margin-top:1em;margin-right:1.5em;margin-bottom:1em}.breadcrumb{font-size:smaller;margin-bottom:1em}.prereq{margin-right:20px}/*! Set heading sizes, getting smaller for deeper nesting */.topictitle1{font-size:1.34em;margin-top:0;margin-bottom:.1em}.topictitle2,.topictitle3,.topictitle4,.topictitle5,.topictitle6,.sectiontitle{font-size:1.17em}.topictitle2{margin-top:1pc;margin-bottom:.45em}.topictitle3{margin-top:1pc;margin-bottom:.17em;font-weight:700}.topictitle4{margin-top:.83em;font-weight:700}.topictitle5{font-weight:700}.topictitle6{font-style:italic}.sectiontitle{margin-top:1em;margin-bottom:0;color:#000;font-weight:700}/*! All note formats have the same default presentation */.attentiontitle,.bold,.cautiontitle,.dangertitle,.dlterm,.fastpathtitle,.firstcol,.importanttitle,.notelisttitle,.notetitle,.noticetitle,.parmname,.remembertitle,.restrictiontitle,.tiptitle,.uicontrol,.warningtitle{font-weight:700}.caution{font-weight:700;margin-bottom:1em}/*! Simple lists do not get a bullet *//*! Used on the first column of a table, when rowheader="firstcol" is used *//*! Various basic phrase styles */.boldItalic{font-weight:700;font-style:italic}.shortcut,.underlined{text-decoration:underline}/*! 2008-10-27 keyword采用跟随上下文的样式 +*//*! Default of bold for definition list terms *//*! Use CSS to expand lists with @compact="no" */.dltermexpand{font-weight:700;margin-top:1em}[compact="yes"]>li{margin-top:0}[compact="no"]>li{margin-top:.53em}/*! Align images based on @align on topic/image */div.imageleft,.text-align-left{text-align:left}div.imagecenter,.text-align-center{text-align:center}div.imageright,.text-align-right{text-align:right}div.imagejustify,.text-align-justify{text-align:justify}.cellrowborder{border-right:0;border-top:0;border-left:1px solid;border-bottom:1px solid}.row-nocellborder{border-left:hidden;border-right:0;border-top:0;border-bottom:1px solid}.cell-norowborder{border-top:0;border-bottom:hidden;border-right:0;border-left:1px solid}.nocellnorowborder{border:0;border-left:hidden;border-bottom:hidden}pre.codeblock,pre.screen{padding:5px;border:outset;background-color:#ccc;margin-top:2px;margin-bottom:2px;white-space:pre} \ No newline at end of file diff --git a/docs/ces/api-ref/public_sys-resources/danger_3.0-en-us.png b/docs/ces/api-ref/public_sys-resources/danger_3.0-en-us.png new file mode 100644 index 0000000000000000000000000000000000000000..47a9c723532a0ac410285e5152684262127922bf GIT binary patch literal 2771 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 literal 0 HcmV?d00001 diff --git a/docs/ces/api-ref/public_sys-resources/icon-arrowdn.gif b/docs/ces/api-ref/public_sys-resources/icon-arrowdn.gif new file mode 100644 index 0000000000000000000000000000000000000000..84eec9be2f2ce458e888f8a9b803f9387247726a GIT binary patch literal 68 zcmZ?wbhEHbzkByxQ$u Mo$o?7J5~m305MV#!~g&Q literal 0 HcmV?d00001 diff --git a/docs/ces/api-ref/public_sys-resources/icon-arrowrt.gif b/docs/ces/api-ref/public_sys-resources/icon-arrowrt.gif new file mode 100644 index 0000000000000000000000000000000000000000..39583d168d6db303b366b5b8c1780698a6bb6017 GIT binary patch literal 70 zcmZ?wbhEHbEMGZQ&sWI^~+e%qWysRPK%BSD+f4-fabAGq;|Cf|4nO{(o zMH%#n$oXf^sdM5SJ4e1UbEeM389O82RCB6M#VI=_KP%=$orn{5LVlIau{svV?3jS$ z$Q-F7am0>L02|Q2!ZN1G^Z2J`V#a3VX;G<~iYc3tSAnLeiI}hnc~O{UH5OwwCTPT} zks65+8-W$70S3`f30dfY7}$UY7M95y@-?2QvMPChphYF3!YbtLLIs*E%B)Oq4^fy^ z5+zoGJ>&tI*hU=i4-s$()c}KNsKh9AfEd_-1{V3`d>b_$i;xcz{y>Y0S(uP3>_P>a zLM((Fku(B;E{r2+xJ8u612VCVIG_oJ;Sj0;2GQ7rEa(6+umMf}M1C4=)Odu8AxQWG zEh;Aearj(=d;4Z^LLYN*6+asU?Nbl3^Q%D|{s@6Xj}(aZHwkoj-~bw*1FnSd;0aX! zUW<-TPD&b;6s;@zw7K~4mF9cDuK&BQ;b_N-Cj%R=CnEjde9%~1kk}vYY^@mTTNm%F z?mbrf*~d#iX;?ITDf(MHQdK;&p(ek&e9qe?*&A0E)mG(1s`J*pn^#ttId4vCXjV$j zj464u)2F9Q$V#0!dHk4(FDB#D&wP^f0*q1)G?4!%Xe>;ROD~Oee-}xfJUd+aa_0AK zFP$vgR2te>+%}b$hVw&Ni`yT>F5LNRM@_utk68Piwi5??BLBpCcb8mx|3c*1x!xZJ zKU!7(#h8s(^x)5*w=Z0K{=a9#qeoHU|0&%MiU0rr literal 0 HcmV?d00001 diff --git a/docs/ces/api-ref/public_sys-resources/icon-danger.gif b/docs/ces/api-ref/public_sys-resources/icon-danger.gif new file mode 100644 index 0000000000000000000000000000000000000000..079c79b263f4b48089f3b3256154c73e7699593f GIT binary patch literal 1086 zcmW+#YfRQ<6hA3LZMyP?V}KhnEtF{Q4vGxS52AozEVM85nq$#%tv8gRF!3GhgM?_) zd5Luv3SKrXFTGCpn$y>EMGZQ&sWI^~+e%qWysRPK%BSD+f4-fabAGq;|Cf|4nO{(o zMH%#n$oXf^sdM5SJ4e1UbEeM389O82RCB6M#VI=_KP%=$orn{5LVlIau{svV?3jS$ z$Q-F7am0>L02|Q2!ZN1G^Z2J`V#a3VX;G<~iYc3tSAnLeiI}hnc~O{UH5OwwCTPT} zks65+8-W$70S3`f30dfY7}$UY7M95y@-?2QvMPChphYF3!YbtLLIs*E%B)Oq4^fy^ z5+zoGJ>&tI*hU=i4-s$()c}KNsKh9AfEd_-1{V3`d>b_$i;xcz{y>Y0S(uP3>_P>a zLM((Fku(B;E{r2+xJ8u612VCVIG_oJ;Sj0;2GQ7rEa(6+umMf}M1C4=)Odu8AxQWG zEh;Aearj(=d;4Z^LLYN*6+asU?Nbl3^Q%D|{s@6Xj}(aZHwkoj-~bw*1FnSd;0aX! zUW<-TPD&b;6s;@zw7K~4mF9cDuK&BQ;b_N-Cj%R=CnEjde9%~1kk}vYY^@mTTNm%F z?mbrf*~d#iX;?ITDf(MHQdK;&p(ek&e9qe?*&A0E)mG(1s`J*pn^#ttId4vCXjV$j zj464u)2F9Q$V#0!dHk4(FDB#D&wP^f0*q1)G?4!%Xe>;ROD~Oee-}xfJUd+aa_0AK zFP$vgR2te>+%}b$hVw&Ni`yT>F5LNRM@_utk68Piwi5??BLBpCcb8mx|3c*1x!xZJ zKU!7(#h8s(^x)5*w=Z0K{=a9#qeoHU|0&%MiU0rr literal 0 HcmV?d00001 diff --git a/docs/ces/api-ref/public_sys-resources/icon-huawei.gif b/docs/ces/api-ref/public_sys-resources/icon-huawei.gif new file mode 100644 index 0000000000000000000000000000000000000000..a31d60f895af919d33855217ca02daf4093136d7 GIT binary patch literal 2767 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 GE&l)<3Z_>8 literal 0 HcmV?d00001 diff --git a/docs/ces/api-ref/public_sys-resources/icon-notice.gif b/docs/ces/api-ref/public_sys-resources/icon-notice.gif new file mode 100644 index 0000000000000000000000000000000000000000..409070650a49518feb1624c624d814c3bfa63d2e GIT binary patch literal 962 zcmb7D&r8&C5S<{wSd_qn6)U)w5LOaRh!N}_*49lD)S!dZp@M<3gPIX|@UR9-fz+X3 zAaT9)OY{xZtO-;RC85Vab;JEUNIMS5f^r$7-e%-XK`j{0+N$CsgpRd6B1wp z8dw-cH^rU^H4`&7qgabf)l^K`l!66{q9$U(CKRO5%W5pfY)s&YQ6n`HBR0ZTum%`N zgC%I8hQ+`JG_WvCAt-W$sIn@BKCDG1qQWW^a=`*c7G+i@s0S(ZDv1&+K_2`7O-#cM z=m!ZX1Z#kSG+3e)Jg^wpfCd(Yb5TZ)U=a!DwsG z)Z`|1ejMK4ap%CHj;%+>T6=D++5I=uBbQ$fZ48cf{hV1}9&Njl-I}i7e0#6Hdug@s zsr-57_=gLr&9Ros$k}}M>tJ77=hEJ}iPaZ%8|P+gUbS|Oj}5I{|5nZZc)C1$e*Rj` d`09hYXJ4M@PhCx)dHK8WZo1*|*q+^V@*ncduk8Q; literal 0 HcmV?d00001 diff --git a/docs/ces/api-ref/public_sys-resources/icon-tip.gif b/docs/ces/api-ref/public_sys-resources/icon-tip.gif new file mode 100644 index 0000000000000000000000000000000000000000..c47bae05c9fd17c02a851d96cfac67bf194498d8 GIT binary patch literal 879 zcmchWKWmj?48@OdDOZPr)a61!OE4yGD)salg#|^Ix$qIEF#uk)V>D{95e^!2r`i+9t# zTMu5YtUcd+@#gp0tDE;9ug>oLIzL$6dOx4-t#2PKExu1KulwoYeD?Os#mVO%AMWih HO|EMGZQ&sWI^~+e%qWysRPK%BSD+f4-fabAGq;|Cf|4nO{(o zMH%#n$oXf^sdM5SJ4e1UbEeM389O82RCB6M#VI=_KP%=$orn{5LVlIau{svV?3jS$ z$Q-F7am0>L02|Q2!ZN1G^Z2J`V#a3VX;G<~iYc3tSAnLeiI}hnc~O{UH5OwwCTPT} zks65+8-W$70S3`f30dfY7}$UY7M95y@-?2QvMPChphYF3!YbtLLIs*E%B)Oq4^fy^ z5+zoGJ>&tI*hU=i4-s$()c}KNsKh9AfEd_-1{V3`d>b_$i;xcz{y>Y0S(uP3>_P>a zLM((Fku(B;E{r2+xJ8u612VCVIG_oJ;Sj0;2GQ7rEa(6+umMf}M1C4=)Odu8AxQWG zEh;Aearj(=d;4Z^LLYN*6+asU?Nbl3^Q%D|{s@6Xj}(aZHwkoj-~bw*1FnSd;0aX! zUW<-TPD&b;6s;@zw7K~4mF9cDuK&BQ;b_N-Cj%R=CnEjde9%~1kk}vYY^@mTTNm%F z?mbrf*~d#iX;?ITDf(MHQdK;&p(ek&e9qe?*&A0E)mG(1s`J*pn^#ttId4vCXjV$j zj464u)2F9Q$V#0!dHk4(FDB#D&wP^f0*q1)G?4!%Xe>;ROD~Oee-}xfJUd+aa_0AK zFP$vgR2te>+%}b$hVw&Ni`yT>F5LNRM@_utk68Piwi5??BLBpCcb8mx|3c*1x!xZJ zKU!7(#h8s(^x)5*w=Z0K{=a9#qeoHU|0&%MiU0rr literal 0 HcmV?d00001 diff --git a/docs/ces/api-ref/public_sys-resources/note_3.0-en-us.png b/docs/ces/api-ref/public_sys-resources/note_3.0-en-us.png new file mode 100644 index 0000000000000000000000000000000000000000..57a0e1f53377b28fd80ceb393b035f8d9b8b392a GIT binary patch literal 1080 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