使用GetMetricStore API查詢時序庫配置-Log Service-阿里雲

介面說明

時序庫可用於儲存時序資料。此介面僅用於查詢時序庫的配置，若要查詢時序庫中的時序資料，可參見查詢與分析以及 GetLogsV2 。

此介面需要指定一個已存在的時序庫。
請求文法中的 Host 由 Project 名稱和Log Service Endpoint 構成，您需要在 Host 中指定 Project。
已建立並擷取 AccessKey。更多資訊，請參見存取金鑰。

阿里雲帳號 AccessKey 擁有所有 API 的存取權限，風險很高。強烈建議您建立並使用 RAM 使用者進行 API 訪問或日常營運。RAM 使用者需具備動作記錄服務資源的許可權。具體操作，請參見建立 RAM 使用者及授權。

已明確您查詢日誌所屬的 Project 名稱、所屬地區等資訊。如何查詢，請參見管理 Project。
一個 Project 中，最多建立 200 個 Logstore 或 MetricStore。
當時序資料儲存時間達到您所設定的資料儲存時間後，資料將被刪除。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求文法

GET /metricstores/{name} HTTP/1.1

路徑參數

名稱	類型	必填	描述	樣本值
name	string	是	時序庫名稱	my_metric_store

請求參數

名稱	類型	必填	描述	樣本值
project	string	是	記錄項目名稱	my-project

返回參數

名稱	類型	描述	樣本值
	object	返回結構體
name	string	時序庫名稱	my_metric_store
ttl	integer	儲存時間，單位為天	7
shardCount	integer	shard 分區數量	2
autoSplit	boolean	是否開啟自動分裂	true
maxSplitShard	integer	shard 最大自動分裂數量	64
mode	string	時序庫規格類型，例如 standard	standard
metricType	string	時序庫種類，例如 prometheus	prometheus
createTime	integer	建立時間，unix 時間戳記	1698933894
lastModifyTime	integer	最後更新時間，unix 時間戳記	1712023974
hot_ttl	integer	資料在熱儲存層中的儲存時間，單位為天。
infrequentAccessTTL	integer	低頻儲存，單位為天。
appendMeta	boolean
shardingPolicy	ShardingPolicy

樣本

正常返回樣本

JSON格式

{
  "name": "my_metric_store",
  "ttl": 7,
  "shardCount": 2,
  "autoSplit": true,
  "maxSplitShard": 64,
  "mode": "standard",
  "metricType": "prometheus",
  "createTime": 1698933894,
  "lastModifyTime": 1712023974,
  "hot_ttl": 0,
  "infrequentAccessTTL": 0,
  "appendMeta": true,
  "shardingPolicy": {
    "shardGroup": {
      "keys": [
        "userId"
      ],
      "groupCount": 8
    },
    "shardHash": {
      "keys": [
        "instanceId"
      ],
      "maxHashCount": 2
    },
    "queryActiveTime": 1764659409
  }
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
404	MetricStoreNotExist	The specified metricstore xxx does not exist.	參數中所指定的時序庫不存在

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。