全部產品
Search

搜尋本產品

    Simple Log Service：ListTagResources - 列出資源標籤

    文件中心

    Simple Log Service：ListTagResources - 列出資源標籤

    更新時間：Dec 23, 2025

    列出所查詢資源的標籤列表，可以一次查詢多個同類型的資源，也可以按標籤索引值過濾查詢。

    介面說明

    介面說明

    • 請求文法中 Host 由 Project 名稱和Log Service Endpoint 構成，您需要在 Host 中指定 Project。

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

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

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

    • 鑒權規則，請參見鑒權概覽。目前支援的資源套件括 project、logstore、dashboard、machineGroup 和 logtailConfig。

    鑒權資源

    下表列出了 API 對應的授權資訊。您可以在 RAM 權限原則語句的 Action 元素中添加該資訊，用於為 RAM 使用者或 RAM 角色授予調用此 API 的許可權。

    動作（Action）授權策略中的資源描述方式（Resource）
    log:ListTagResources
    不同類型資源對應不同格式。
    -acs:log:{#regionId}:{#accountId}:project/{#ProjectName}
    -acs:log:${regionName}:${accountId}:project/${projectName}/logstore/${logstoreName}
    -acs:log:${regionName}:${accountId}:project/${projectName}/dashboard/${dashboardName}
    -acs:log:${regionName}:${accountId}:project/${projectName}/machinegroup/${machineGroupName}
    -acs:log:${regionName}:${accountId}:project/${projectName}/logtailconfig/${logtailConfigName}





    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    log:ListTagResources

    get

    *Project

    acs:log:{#regionId}:{#accountId}:project/{#ProjectName}
    • log:TLSVersion
    		 無

    請求文法

    GET /tags HTTP/1.1

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    resourceType

    string

    是

    資源的類型。

    • project：專案。

    • logstore：日誌庫。

    • dashboard：儀錶盤。

    • machinegroup：機器組。

    • logtailconfig：logtail 配置。

    枚舉值：

    • project :

      project

    project
    resourceId

    array

    否

    查詢的資源 ID 列表。resourceId 與 tags 應至少存在一個。

    string

    否

    資源 ID。以日誌庫為例，projectName 代表專案名稱，#為拼接字元，logstore 為日誌庫名稱。

    • project：projectName

    • logstore：projectName#logstore

    • dashboard：projectName#dashboard

    • machinegroup：projectName#machinegroup

    • logtailconfig：projectName#logtailconfig

    ali-test-project
    tags

    array<object>

    否

    精確查詢時，用於過濾的標籤索引值對。resourceId 與 tags 應至少配置一個。

    最多設定 20 個 tag。

    object

    否

    用於過濾查詢的標籤索引值對。

    key

    string

    是

    查詢時用於過濾標籤的鍵，例如 key 為"test-key"時，只會返回綁定了標籤鍵為"test-key"的資源。

    key1
    value

    string

    否

    查詢時用於過濾標籤的值，當值為 null 時表示只根據 key 過濾。

    value1

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    返回結構體。

    nextToken

    string

    下一個查詢開始 Token。

    caeba0bbb2be03f84eb48b699f0a4883
    tagResources

    array<object>

    返回的標籤列表。

    object

    綁定了標籤的資源。

    resourceId

    string

    資源 ID。

    ali-test-project
    resourceType

    string

    資源類型。

    project
    tagKey

    string

    標籤的鍵。

    key1
    tagValue

    string

    標籤的值。

    value1

    樣本

    正常返回樣本

    JSON格式

    {
  "nextToken": "caeba0bbb2be03f84eb48b699f0a4883",
  "tagResources": [
    {
      "resourceId": "ali-test-project",
      "resourceType": "project",
      "tagKey": "key1",
      "tagValue": "value1"
    }
  ]
}

    錯誤碼

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

    變更歷史

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