全部產品
Search
文件中心

Elasticsearch:UntagResources

更新時間:Jan 15, 2025

調用UntagResources,刪除使用者資源標籤關係。

調用該介面時,請注意:

  • 只能刪除使用者標籤。
    說明 使用者標籤是指使用者手動給執行個體添加的標籤。對應的系統標籤是指雲產品(即阿里雲服務)給使用者執行個體添加的標籤。系統標籤分為可見標籤和不可見標籤。
  • 對於沒有關聯任何資源的標籤,在刪除資源標籤關係時,對應標籤也要被刪除。

調試

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

要求標頭

該介面使用公用要求標頭,無特殊要求標頭。請參見公用請求參數文檔。

請求文法

DELETE /openapi/tags HTTP/1.1

請求參數

名稱 類型 位置 是否必選 樣本值 描述
ResourceIds String Query ["es-cn-09k1rocex0006****","es-cn-oew1rgiev0009****"]

要刪除的資源清單。

ResourceType String Query INSTANCE

資源類型。固定為INSTANCE

TagKeys String Query ["tagKey1","tagKey2"]

要刪除的標籤列表,最多包含20個子項。

All Boolean Query false

是否全部刪除,預設為false。僅當TagKeys為空白時有效。

  • 當TagKeys為空白,且All = true時,調用該介面會刪除資源下所有的資源標籤關係。對於沒有標籤的資源,不處理介面,並返回成功。
  • 當傳入TagKeys為空白,同時All = false時,不處理介面,並返回成功。
  • TagKeys不為空白,All無論為true或者false,調用該介面會忽略此欄位。
  • 指定TagKeys後,調用該介面會刪除資源上指定的標籤。當資源上不存在指定標籤時,將不處理該標籤。
  • 如果資源不存在,調用該介面會返回InvalidResourceId.NotFound

返回資料

名稱 類型 樣本值 描述
RequestId String F99407AB-2FA9-489E-A259-40CF6D******

請求ID。

Result Boolean true

返回結果:

  • true:刪除成功
  • false:刪除失敗

樣本

請求樣本

DELETE /openapi/tags?ResourceType=INSTANCE&ResourceIds=%5B%22es-cn-09k1rocex0006****%22%5D HTTP/1.1
公用要求標頭

正常返回樣本

JSON格式

{
    "Result":true,
    "RequestId": "3D8795D9-8FF5-46B2-86E6-E3B40*******"
}

錯誤碼

HttpCode 錯誤碼 錯誤資訊 描述
400 InstanceNotFound The instanceId provided does not exist. 執行個體找不到,請核對執行個體狀態。

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