為Project綁定標籤,每次調用API只能為一個Project綁定標籤,可一次綁定多個標籤。
介面說明
介面說明
請求文法中 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:TagResources | 不同類型資源對應不同格式。 - 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程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
log:TagResources |
create |
*Project
|
|
無 |
請求文法
POST /tag HTTP/1.1
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| body |
object |
是 |
請求結構體。 |
|
| resourceType |
string |
是 |
資源的類型。
|
project |
| resourceId |
array |
是 |
資源的 id 列表,只允許填入 1 個資源,只允許為單個資源綁定標籤。 |
|
|
string |
否 |
資源 ID。以日誌庫為例,projectName 代表專案名稱,#為拼接字元,logstore 為日誌庫名稱。
|
ali-test-project |
|
| tags |
array<object> |
是 |
標籤列表。一次最多支援 20 個標籤索引值對。 |
|
|
object |
否 |
資源標籤。 |
||
| key |
string |
是 |
標籤的鍵。格式要求如下:
|
key1 |
| value |
string |
是 |
標籤的值。格式要求如下:
|
value1 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
當前API暫無返回參數
樣本
正常返回樣本
JSON格式
{}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。