CreateMetricStore - Simple Log Service - Alibaba Cloud Documentation Center

Creates a Metricstore to store metric data.

Operation description

Metricstores are used to store metric data. For more information, see Metric data.

Host consists of a project name and a Simple Log Service endpoint. You must specify a project in Host.
An AccessKey pair is created and obtained. For more information, see AccessKey pair.

The AccessKey pair of an Alibaba Cloud account has permissions on all API operations. Using these credentials to perform operations in Simple Log Service is a high-risk operation. We recommend that you use a Resource Access Management (RAM) user to call API operations or perform routine O&M. To create a RAM user, log on to the RAM console. Make sure that the RAM user has the management permissions on Simple Log Service resources. For more information, see Create a RAM user and authorize the RAM user to access Simple Log Service.

The information that is required to query metric data is obtained. The information includes the name of the project to which the metric data belong and the region of the project. For more information, see Manage a project.
You can create up to 200 Logstores or Metricstores in a project.
Metric data is automatically deleted when the retention period of the metric data ends.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

POST /metricstores HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
project	string	Yes	The name of the project.	my-project
body	object	No
name	string	Yes	The name of the Metricstore.	my_metric_store
ttl	integer	Yes	The retention period of the metric data in the Metricstore. Unit: days.	7
shardCount	integer	Yes	The number of shards in the Metricstore.	2
autoSplit	boolean	No	Specifies whether to enable automatic sharding.	true
maxSplitShard	integer	No	The maximum number of shards into which existing shards can be automatically split. This parameter is valid only when you set the autoSplit parameter to true.	64
mode	string	No	The type of the Metricstore. For example, you can set the parameter to standard to query Standard Metricstores.	standard
metricType	string	No	The type of the metric data. Example: prometheus.	prometheus

Response parameters

Parameter	Type	Description	Example
headers	object
Server	string	The name of the server.	nginx
Content-Type	string	The content type of the response body.	application/json
Content-Length	string	The content length of the response body.	0
Connection	string	Indicates whether the connection is persistent. Valid values: close and keep-alive. close: The connection is non-persistent. A new TCP connection is established for each HTTP request. keep-alive: The connection is persistent. After a TCP connection is established, the connection remains open, and no more time or bandwidth is consumed to establish new connections.	close
Date	string	The time at which the response was returned.	Sun, 27 May 2018 08:25:04 GMT
x-log-requestid	string	The request ID.	5B0A6B60BB6EE39764D458B5

Examples

Sample success responses

JSONformat

{}

Error codes

HTTP status code	Error code	Error message	Description
400	MetricStoreAlreadyExist	The specified metricstore xxx already exists.	The specified metricstore xxx already exists.

For a list of error codes, visit the Service error codes.

Change history

Change time	Summary of changes	Operation
2024-09-19	The Error code has changed	View Change Details
2024-08-28	Add Operation	View Change Details