Amazon Pinpoint リソースからプログラムでタグを削除する

次の例は、AWS CLI と Amazon Pinpoint REST API を使用して、Amazon Pinpoint リソースにタグ (キーと値) を削除する方法を示しています。サポートされている AWS SDK を使用して、リソースからタグを削除することもできます。

1 回のオペレーションで複数の Amazon Pinpoint リソースからタグを削除するには、 のリソースグループのタグ付けオペレーション AWS CLI またはAWS Resource Groups タグ付け API を使用します。タグキーではなく、特定のタグ値のみをリソースから削除するには、そのリソースのタグを更新します。

API を使用してタグを削除する

Amazon Pinpoint REST API を使用してリソースからタグを削除するには、DELETE リクエストを Tags URI に送信します。この URI では、タグを削除するリソースの Amazon リソースネーム (ARN) を含め、その後に tagKeys パラメータと削除するタグを続けます。例:

https://endpoint/v1/tags/resource-arn?tagKeys=key

コードの説明は以下のとおりです。

• endpoint は、リソースをホストする AWS リージョンの Amazon Pinpoint エンドポイントです。

• resource-arn は、タグを削除するリソースの ARN です。

• key は、リソースから削除するタグです。

すべてのパラメータは、URL エンコードする必要があります。

複数のタグキーとそれらに関連付けられた値の両方をリソースから削除するには、削除するさらなるタグそれぞれの tagKeys パラメータと引数を、アンパサンド (&) で区切って追加します。例:

https://endpoint/v1/tags/resource-arn?tagKeys=key1&tagKeys=key2

すべてのパラメータは、URL エンコードする必要があります。

を使用してタグを削除する AWS CLI

を使用してリソースからタグを削除するには AWS CLI、 untag-resource コマンドを実行します。次の例に示すように、tag-keys パラメータと引数を含めます。

Linux, macOS, or Unix

$ aws pinpoint untag-resource \
  --resource-arn resource-arn \
  --tag-keys key1 key2

Windows Command Prompt

C:\> aws pinpoint untag-resource ^
     --resource-arn resource-arn ^
     --tag-keys key1 key2

上の例に、以下の変更を加えます。

• resource-arn を、タグを削除するリソースの ARN に置き換えます。

• key1 と key2 を、リソースから削除するタグのキーに置き換えます。