翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon WorkSpaces アプリケーション API、 AWS SDK、または AWS CLI を使用したタグの操作
<a name="basic-tagging-API-SDK-CLI"></a>

WorkSpaces アプリケーション API、 AWS SDK、または AWS コマンドラインインターフェイス (AWS CLI) を使用している場合は、 `tags`パラメータで次の WorkSpaces アプリケーションオペレーションを使用して、新しいリソースを作成するときにタグを追加できます。

**注記**  
タグのキーと値にはスペースを使用できます。 AWS CLI を使用するときにスペースを指定するには、「\$1s」を使用します (引用符なし）。


| タスク | AWS CLI | API 操作 | 
| --- | --- | --- | 
| 新しいフリートに 1 つ以上のタグを追加する | [create-fleet](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-fleet.html)  |  [CreateFleet](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateFleet.html#AppStream2-CreateFleet-request-Tags)  | 
| 新しいイメージビルダーに 1 つ以上のタグを追加する | [create-imagebuilder](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-imagebuilder.html) |  [CreateImageBuilder](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateImageBuilder.html#AppStream2-CreateImageBuilder-request-Tags)  | 
| 新しいスタックに 1 つ以上のタグを追加する |  [create-stack](https://docs.aws.amazon.com/cli/latest/reference/appstream/create-stack.html)  |  [CreateStack](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_CreateStack.html#AppStream2-CreateStack-request-Tags)  | 

次の WorkSpaces アプリケーションオペレーションを使用して、既存のリソースのタグを追加、編集、削除、または一覧表示できます。


| タスク | AWS CLI | API 操作 | 
| --- | --- | --- | 
| リソースの 1 つ以上のタグを追加または上書きする | [タグリソース](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html)  |  [TagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_TagResource.html)  | 
| リソースの 1 つ以上のタグを削除する | [タグなしリソース](https://docs.aws.amazon.com/cli/latest/reference/appstream/untag-resource.html)  |  [UntagResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_UntagResource.html)  | 
| リソースの 1 つ以上のタグを一覧表示する |  [list-tags-for-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/list-tags-for-resource.html)  |  [ListTagsForResource](https://docs.aws.amazon.com/appstream2/latest/APIReference/API_ListTagsForResource.html)  | 

WorkSpaces Applications API、 AWS SDK、または CLI AWS アクションを使用して既存の WorkSpaces Applications リソースのタグを追加、編集、削除、または一覧表示する場合は、Amazon リソースネーム (ARN) を使用してリソースを指定します。ARN は AWS リソースを一意に識別し、次の一般的な構文を使用します。

```
arn:aws:appstream:region:account:resourceType/resourceName
```

***region***  
リソースが作成された AWS リージョン ( など`us-east-1`)。

***アカウント***  
 AWS アカウント ID。ハイフンなし (例: `123456789012`)。

***resourceType***  
リソースのタイプ。、`image-builder`、`image`、`fleet`および の WorkSpaces Applications リソースタイプにタグを付けることができます`stack`。

***resourceName***  
リソースの名前。

たとえば、CLI [describe-fleets ](https://docs.aws.amazon.com/cli/latest/reference/appstream/describe-fleets.html)コマンドを使用して WorkSpaces アプリケーションフリートの ARN AWS を取得できます。次の コマンドをコピーします。

```
aws appstream describe-fleets
```

`TestFleet` という名前の単一のフリートを含む環境の場合、このリソースの ARN は、次のような JSON 出力に表示されます。

```
"Arn": "arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet"
```

このリソースの ARN を取得した後、[tag-resource](https://docs.aws.amazon.com/cli/latest/reference/appstream/tag-resource.html) コマンドを使用して 2 つのタグを追加できます。

```
aws appstream tag-resource --resource arn:awsappstream:us-east-1:123456789012:fleet/TestFleet --tags Environment=Test,Department=IT
```

最初のタグ `Environment=Test` は、フリートがテスト環境であることを示します。2 番目のタグ `Department=IT` は、フリートが IT 部門に属していることを示します。

次のコマンドを使用して、フリートに追加した 2 つのタグをリストできます。

```
aws appstream list-tags-for-resource --resource arn:aws:appstream:us-east-1:123456789012:fleet/TestFleet
```

この例の JSON 出力は次のとおりです。

```
{
    "Tags": {
       "Environment" : "Test",
       "Department" : "IT"
    }
}
```