すべてのプロダクト
Search
ドキュメントセンター

Elasticsearch:UntagResources

最終更新日:Mar 17, 2025

ユーザーリソースタグの関連付けを削除します。

この操作を呼び出すときは、次の項目に注意してください。

  • ユーザータグのみ削除できます。
    説明 ユーザーラベルは、ユーザーがインスタンスに手動で追加したラベルです。システムタグは、Alibaba Cloud サービスがインスタンスに追加するタグです。システムラベルは、表示ラベルと非表示ラベルに分けられます。
  • リソースに関連付けられていないリソースタグの関連付けを削除する場合は、タグを削除する必要があります。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストヘッダー

この操作では、共通のリクエストパラメーターのみを使用します。 詳細については、「共通パラメーター」をご参照ください。

リクエスト構文

DELETE /openapi/tags HTTPS|HTTP

リクエストパラメーター

パラメータータイプ必須説明
ResourceIdsString必須["es-cn-09k1rocex0006****","es-cn-oew1rgiev0009****"]

削除するリソースリスト。

ResourceTypeString必須INSTANCE

リソースのタイプ。 INSTANCE に固定されています。

TagKeysStringいいえ["tagKey1","tagKey2"]

削除するタグのリスト。 リストには最大 20 個のサブアイテムを含めることができます。

AllBooleanいいえfalse

すべてのパーツを削除するかどうかを指定します。 デフォルト値: false 。 このパラメーターは、TagKeys が指定されていない場合にのみ有効です。

  • All=true TagKeys が空で、リソース下のすべてのリソースタグの関連付けが削除されたときに、この操作を呼び出します。 タグのないリソースの場合、インターフェイスは処理されず、成功が返されます。TagKeys が空で、リソース下のすべてのリソース タグ関係が削除された場合。タグのないリソースの場合、インターフェイスは処理されず、成功が返されます。
  • TagKeys が null で、All=false の場合、API は処理されず、成功が返されます。
  • TagKeys は空ではありません。 All は、この操作が呼び出されたときに、true か false かに関係なく無視されます。
  • 指定された TagKeys された後、この操作を呼び出して、リソースから指定されたタグを削除できます。 指定されたタグがリソースに存在しない場合、指定されたタグは処理されません。
  • リクエストされたリソースが存在しない場合、この操作を呼び出すと、システムは InvalidResourceId.NotFound を返します。

レスポンスパラメーター

パラメータータイプ説明
RequestIdStringF99407AB-2FA9-489E-A259-40CF6D******

リクエストの ID。

ResultBooleantrue

結果を返します。

  • 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エラーコードエラーメッセージ説明
400InstanceNotFound指定された instanceId は存在しません。指定されたインスタンスが見つからないために返されるエラーメッセージ。 インスタンスの状態を確認してください。

エラーコードのリストについては、API エラーセンターをご覧ください。