全部產品
Search

搜尋本產品

    Simple Log Service：GetMetricStore

    文件中心

    Simple Log Service：GetMetricStore

    更新時間：Jul 24, 2026

    查詢時序庫。

    介面說明

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

    • 此介面需要指定一個已存在的時序庫。

    • 請求語法中的 Host 由 Project 名稱和日誌服務 Endpoint 構成，您需要在 Host 中指定 Project。

    • 已建立並取得 AccessKey。更多資訊，請參見存取金鑰。

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

    • 已明確您查詢日誌所屬的 Project 名稱、所屬地域等資訊。如何查詢，請參見管理 Project。

    • 一個 Project 中，最多建立 200 個 Logstore 或 MetricStore。

    • 當時序資料儲存時間達到您所設定的資料儲存時間後，資料將被刪除。

    調試

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

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    log:GetMetricStore

    get

    *MetricStore

    acs:log:{#regionId}:{#accountId}:project/{#project}/metricstore/{#name}

    		 無 無

    請求文法

    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

    資料在熱儲存層中的儲存時間，單位為天。

    60
    infrequentAccessTTL

    integer

    低頻儲存，單位為天。

    30
    appendMeta

    boolean

    是否記錄公網 IP 位址和日誌接收時間。

    false
    shardingPolicy ShardingPolicy

    雜湊寫入設定。

    processorId

    string

    時序庫關聯的寫入處理器 id。

    樣本

    正常返回樣本

    JSON格式

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

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    404 MetricStoreNotExist The specified metricstore xxx does not exist.

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

    變更歷史

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