調用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 | 返回結果:
|
樣本
請求樣本
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. | 執行個體找不到,請核對執行個體狀態。 |
訪問錯誤中心查看更多錯誤碼。