Updating a Compound Metric
Function
This API is used to update a compound metric.
Calling Method
For details, see Calling APIs.
URI
PUT /v2/{project_id}/design/compound-metrics
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| project_id | Yes | String | Project ID. For details about how to obtain the project ID, see Project ID and Account ID. |
Request Parameters
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| X-Auth-Token | Yes | String | IAM token, which is obtained by calling the IAM API for obtaining a user token (value of X-Subject-Token in the response header). This field is mandatory for authentication using tokens. |
| workspace | Yes | String | Workspace ID. For details about how to obtain the workspace ID, see Instance ID and Workspace ID. |
| X-Project-Id | No | String | Project ID. For details about how to obtain the project ID, see Project ID and Account ID. This parameter is mandatory for API requests that use AK/SK authentication in multi-project scenarios. |
| Content-Type | No | String | Default value: application/json;charset=UTF-8 This parameter is optional. If the body is available, this parameter is mandatory. If the body is unavailable, you do not need to set this parameter or verify it. |
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| id | No | String | Compound metric ID, which is a string. This parameter is mandatory for update. |
| name_en | Yes | String | Compound metric name in English |
| name_ch | Yes | String | Compound metric name |
| description | No | String | Description |
| dimension_group | Yes | String | Statistical dimension ID, which cannot be changed during update |
| compound_type | Yes | String | Compound metric type Enumerated values:
|
| comparison_type | No | String | Parallel comparison configuration. This parameter is mandatory when compound metric type is parallel growth rate. Enumerated values:
|
| metric_ids | No | Array of strings | Derivative metric. This parameter is mandatory when the compound metric type is PERIODICITY_VALUED_COMPARISON or INTERVAL_VALUED_COMPARISON. |
| metric_names | No | Array of strings | Indicates the indicator name. |
| compound_metric_ids | No | Array of strings | Compound metric information, which is an ID string |
| compound_metric_names | No | Array of strings | Compound metric name |
| cal_fn_ids | No | Array of strings | Reference function ID, which is a string |
| cal_exp | No | String | Calculation expression. This parameter is mandatory when the compound metric type is set to expression. It is in ${index_id} + ${compound#index_id} format, where index_id indicates the ID of the referenced derivative indicator and compound#index_id indicates the ID of the referenced composite indicator. |
| l2_id | No | String | Subject area ID. This parameter is read-only and does not need to be set during creation and update. |
| l3_id | Yes | String | Business object ID, which is a string |
| data_type | Yes | String | Field type |
| create_by | No | String | Creator. |
| update_by | No | String | Person who updates the information. |
| status | No | String | Release status of an entity. This parameter is read-only and does not need to be set during creation and update. Options:
|
| approval_info | No | ApprovalVO object | Approval information. This parameter is read-only. Latest review information about a business object, including the business details, reviewer information, and review time. |
| new_biz | No | BizVersionManageVO object | Service version management. This parameter is read-only. |
| monitor | No | MetricMonitorVO object | Indicates the metric monitoring information. |
| l1 | No | String | Chinese name of the subject area group. This parameter is read-only and does not need to be set when you create or update a subject area group. |
| l2 | No | String | Chinese name of the subject area. This parameter is read-only and does not need to be set during creation and update. |
| l3 | No | String | Chinese name of the business object. This parameter is read-only and does not need to be set during creation and update. |
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| id | No | String | Application ID, which is a string |
| tenant_id | No | String | Project ID. For details about how to obtain the project ID, see the API path parameter project_id. |
| name_ch | No | String | Chinese name of a service. |
| name_en | No | String | English name of a service. |
| biz_id | No | String | Business ID, which is a string |
| biz_type | No | String | Business entity type. Options:
|
| biz_info | No | String | Serialized service details. The type is string. |
| biz_info_obj | No | Object | Service details. The type is object. |
| biz_version | No | Integer | Service version. |
| biz_status | No | String | Release status of an entity. This parameter is read-only and does not need to be set during creation and update. Options:
|
| approval_status | No | String | Service approval status. This parameter is read-only. Options:
|
| approval_type | No | String | Service review type. Options:
|
| submit_time | No | String | Submitted At |
| create_by | No | String | Creator. |
| l1 | No | String | Chinese name of the subject area group. This parameter is read-only and does not need to be set when you create or update a subject area group. |
| l2 | No | String | Chinese name of the subject area. This parameter is read-only and does not need to be set during creation and update. |
| l3 | No | String | Chinese name of the business object. This parameter is read-only and does not need to be set during creation and update. |
| approval_time | No | String | Review time. |
| approver | No | String | Reviewer. |
| | No | String | Email address of the reviewer. |
| msg | No | String | Review information. |
| directory_path | No | String | Directory tree. |
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| id | No | String | Field ID, which is a string |
| biz_type | No | String | Business entity type. Options:
|
| biz_id | No | String | Business ID, which is a string |
| biz_info | No | String | Business object information. |
| status | No | String | Release status of an entity. This parameter is read-only and does not need to be set during creation and update. Options:
|
| Parameter | Mandatory | Type | Description |
|---|---|---|---|
| id | No | String | ID, which is a string |
| other_metric_ids | No | Array of strings | ID of another metric, which is a string |
| other_compound_metric_ids | No | Array of strings | ID of another composite index. |
| expression | No | String | Alarm expression. |
| metric_id | No | String | Mount pointer ID, which is a string |
| front_configs | No | String | Frontend expression configuration, which is used for front-end data restoration. |
| metric_type | No | String | Business entity type. Options:
|
Response Parameters
Status code: 200
| Parameter | Type | Description |
|---|---|---|
| data | data object | Number of successfully updated compound metrics |
| Parameter | Type | Description |
|---|---|---|
| value | CompoundMetricVO object | Result of updating compound metrics |
| Parameter | Type | Description |
|---|---|---|
| id | String | Compound metric ID, which is a string. This parameter is mandatory for update. |
| name_en | String | Compound metric name in English |
| name_ch | String | Compound metric name |
| description | String | Description |
| dimension_group | String | Statistical dimension ID, which cannot be changed during update |
| group_name | String | Granularity name, which is read-only. |
| group_code | String | Granularity code, which is read-only. |
| compound_type | String | Compound metric type Enumerated values:
|
| comparison_type | String | Parallel comparison configuration. This parameter is mandatory when compound metric type is parallel growth rate. Enumerated values:
|
| metric_ids | Array of strings | Derivative metric. This parameter is mandatory when the compound metric type is PERIODICITY_VALUED_COMPARISON or INTERVAL_VALUED_COMPARISON. |
| metric_names | Array of strings | Indicates the indicator name. |
| compound_metric_ids | Array of strings | Compound metric information, which is an ID string |
| compound_metric_names | Array of strings | Compound metric name |
| cal_fn_ids | Array of strings | Reference function ID, which is a string |
| cal_exp | String | Calculation expression. This parameter is mandatory when the compound metric type is set to expression. It is in ${index_id} + ${compound#index_id} format, where index_id indicates the ID of the referenced derivative indicator and compound#index_id indicates the ID of the referenced composite indicator. |
| l1_id | String | Subject area group ID, which is a read-only string |
| l2_id | String | Subject area ID. This parameter is read-only and does not need to be set during creation and update. |
| l3_id | String | Business object ID, which is a string |
| data_type | String | Field type |
| create_by | String | Creator. |
| update_by | String | Person who updates the information. |
| status | String | Release status of an entity. This parameter is read-only and does not need to be set during creation and update. Options:
|
| create_time | String | Creation time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
| update_time | String | Update time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
| approval_info | ApprovalVO object | Approval information. This parameter is read-only. Latest review information about a business object, including the business details, reviewer information, and review time. |
| new_biz | BizVersionManageVO object | Service version management. This parameter is read-only. |
| monitor | MetricMonitorVO object | Indicates the metric monitoring information. |
| l1 | String | Chinese name of the subject area group. This parameter is read-only and does not need to be set when you create or update a subject area group. |
| l2 | String | Chinese name of the subject area. This parameter is read-only and does not need to be set during creation and update. |
| l3 | String | Chinese name of the business object. This parameter is read-only and does not need to be set during creation and update. |
| summary_table_id | String | Summary table ID, which is a read-only string |
| Parameter | Type | Description |
|---|---|---|
| id | String | Application ID, which is a string |
| tenant_id | String | Project ID. For details about how to obtain the project ID, see the API path parameter project_id. |
| name_ch | String | Chinese name of a service. |
| name_en | String | English name of a service. |
| biz_id | String | Business ID, which is a string |
| biz_type | String | Business entity type. Options:
|
| biz_info | String | Serialized service details. The type is string. |
| biz_info_obj | Object | Service details. The type is object. |
| biz_version | Integer | Service version. |
| biz_status | String | Release status of an entity. This parameter is read-only and does not need to be set during creation and update. Options:
|
| approval_status | String | Service approval status. This parameter is read-only. Options:
|
| approval_type | String | Service review type. Options:
|
| submit_time | String | Submitted At |
| create_by | String | Creator. |
| l1 | String | Chinese name of the subject area group. This parameter is read-only and does not need to be set when you create or update a subject area group. |
| l2 | String | Chinese name of the subject area. This parameter is read-only and does not need to be set during creation and update. |
| l3 | String | Chinese name of the business object. This parameter is read-only and does not need to be set during creation and update. |
| approval_time | String | Review time. |
| approver | String | Reviewer. |
| | String | Email address of the reviewer. |
| msg | String | Review information. |
| directory_path | String | Directory tree. |
| Parameter | Type | Description |
|---|---|---|
| id | String | Field ID, which is a string |
| biz_type | String | Business entity type. Options:
|
| biz_id | String | Business ID, which is a string |
| biz_info | String | Business object information. |
| status | String | Release status of an entity. This parameter is read-only and does not need to be set during creation and update. Options:
|
| biz_version | Integer | Service version, which is read-only. |
| create_time | String | Creation time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
| update_time | String | Update time, which is read-only. The format complies with RFC3339 and is accurate to seconds. The UTC time zone is yyyy-mm-ddTHH:MM:SSZ, for example, 1970-01-01T00:00:00Z. |
| Parameter | Type | Description |
|---|---|---|
| id | String | ID, which is a string |
| other_metric_ids | Array of strings | ID of another metric, which is a string |
| other_metric_names | Array of strings | Name of another indicator. This parameter is read-only. |
| other_compound_metric_ids | Array of strings | ID of another composite index. |
| other_compound_metric_names | Array of strings | Name of another compound metric. |
| expression | String | Alarm expression. |
| metric_id | String | Mount pointer ID, which is a string |
| front_configs | String | Frontend expression configuration, which is used for front-end data restoration. |
| metric_type | String | Business entity type. Options:
|
Status code: 400
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Error code, for example, DS.6000, indicating that the request fails to be processed. |
| error_msg | String | Error message |
| data | Object | Returned data information. |
Status code: 401
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Error code, for example, DS.6000, indicating that the request fails to be processed. |
| error_msg | String | Error message |
| data | Object | Returned data information. |
Status code: 403
| Parameter | Type | Description |
|---|---|---|
| error_code | String | Error code, for example, DS.6000, indicating that the request fails to be processed. |
| error_msg | String | Error message |
| data | Object | Returned data information. |
Example Requests
Update a compound metric based on the following parameters.
PUT https://{endpoint}/v2/{project_id}/design/compound-metrics
{
"id" : "1300537267533774848",
"name_ch" : "Test a compound metric.",
"name_en" : "test_compound_index",
"l3_id" : "1169309252771299328",
"dimension_group" : "1169322847009742848",
"data_type" : "STRING",
"compound_type" : "EXPRESSION",
"monitor" : {
"id" : null,
"other_metric_ids" : [ ],
"other_compound_metric_ids" : [ ],
"expression" : "",
"metric_id" : "1300537267533774848",
"metric_type" : "COMPOUND_METRIC"
},
"description" : "",
"metric_ids" : [ "1300493917942329344", "1268168163686780928", "1181167466668310528" ],
"compound_metric_ids" : [ ],
"cal_exp" : "${1300493917942329344}+${1268168163686780928}+${1181167466668310528}"
} Example Responses
Status code: 200
The operation succeeds, and CompoundMetricVO is returned.
{
"value" : {
"id" : "1300537267533774848",
"name_en" : "test_compound_index",
"name_ch" : "Test a compound metric.",
"description" : "",
"dimension_group" : "1169322847009742848",
"group_name" : null,
"group_code" : null,
"compound_type" : "EXPRESSION",
"comparison_type" : null,
"metric_ids" : [ "1300493917942329344", "1268168163686780928", "1181167466668310528" ],
"metric_names" : null,
"compound_metric_ids" : [ ],
"compound_metric_names" : null,
"cal_fn_ids" : null,
"cal_exp" : "${1300493917942329344}+${1268168163686780928}+${1181167466668310528}",
"l1_id" : null,
"l2_id" : null,
"l3_id" : "1169309252771299328",
"data_type" : "STRING",
"create_by" : "test_user",
"update_by" : "test_user",
"status" : "DRAFT",
"create_time" : "2024-10-28T19:10:47+08:00",
"update_time" : "2024-10-28T19:20:23.085+08:00",
"approval_info" : null,
"new_biz" : null,
"monitor" : null,
"l1" : null,
"l2" : null,
"l3" : null,
"summary_table_id" : null
}
} Status code: 400
BadRequest
{
"error_code" : "DS.60xx",
"error_msg" : "The user request is illegal."
} Status code: 401
Unauthorized
{
"error_code" : "DS.60xx",
"error_msg" : "User authentication failed."
} Status code: 403
Forbidden
{
"error_code" : "DS.60xx",
"error_msg" : "The user does not have permission to call this API."
} Status Codes
| Status Code | Description |
|---|---|
| 200 | The operation succeeds, and CompoundMetricVO is returned. |
| 400 | BadRequest |
| 401 | Unauthorized |
| 403 | Forbidden |
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.