ユーザーリソースタグの関連付けを削除します。
この操作を呼び出すときは、次の項目に注意してください。
- ユーザータグのみ削除できます。説明 ユーザーラベルは、ユーザーがインスタンスに手動で追加したラベルです。システムタグは、Alibaba Cloud サービスがインスタンスに追加するタグです。システムラベルは、表示ラベルと非表示ラベルに分けられます。
- リソースに関連付けられていないリソースタグの関連付けを削除する場合は、タグを削除する必要があります。
デバッグ
リクエストヘッダー
この操作では、共通のリクエストパラメーターのみを使用します。 詳細については、「共通パラメーター」をご参照ください。
リクエスト構文
DELETE /openapi/tags HTTPS|HTTPリクエストパラメーター
| パラメーター | タイプ | 必須 | 例 | 説明 |
| ResourceIds | String | 必須 | ["es-cn-09k1rocex0006****","es-cn-oew1rgiev0009****"] | 削除するリソースリスト。 |
| ResourceType | String | 必須 | INSTANCE | リソースのタイプ。 INSTANCE に固定されています。 |
| TagKeys | String | いいえ | ["tagKey1","tagKey2"] | 削除するタグのリスト。 リストには最大 20 個のサブアイテムを含めることができます。 |
| All | Boolean | いいえ | false | すべてのパーツを削除するかどうかを指定します。 デフォルト値: false 。 このパラメーターは、TagKeys が指定されていない場合にのみ有効です。 |
- All=true TagKeys が空で、リソース下のすべてのリソースタグの関連付けが削除されたときに、この操作を呼び出します。 タグのないリソースの場合、インターフェイスは処理されず、成功が返されます。TagKeys が空で、リソース下のすべてのリソース タグ関係が削除された場合。タグのないリソースの場合、インターフェイスは処理されず、成功が返されます。
- TagKeys が null で、All=false の場合、API は処理されず、成功が返されます。
- 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 | 指定された instanceId は存在しません。 | 指定されたインスタンスが見つからないために返されるエラーメッセージ。 インスタンスの状態を確認してください。 |
エラーコードのリストについては、API エラーセンターをご覧ください。