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

# Amazon Personalize リソースへのタグ追加
<a name="tags-add"></a>

Amazon Personalize コンソール、 AWS Command Line Interface (AWS CLI)、または AWS SDKs を使用して、Amazon Personalize リソースからタグキーと値を追加、表示、更新、削除できます。次の例では、Amazon Personalize データセットグループにタグを追加する方法を示しています。同じ方法で、他の Amazon Personalize リソースにタグを追加できます。

**Topics**
+ [タグの追加 (コンソール)](#add-tag-console)
+ [タグの追加 (AWS CLI)](#add-tag-cli)
+ [タグの追加 (AWS SDKs)](#add-tag-sdk)

## タグの追加 (コンソール)
<a name="add-tag-console"></a>



Amazon Personalize コンソールでリソースを作成するときに、Amazon Personalize コンソールでオプションのタグを追加できます。次の例では、データセットグループにタグを追加します。

**新しいデータセットグループにタグを追加するには**

1. [https://console.aws.amazon.com/personalize/home](https://console.aws.amazon.com/personalize/home) で Amazon Personalize コンソールを開き、アカウントにサインインします。

1. [**データセットグループの作成]** を選択します。

1. **[名前]** に名前を入力します。

1. **[ドメイン]** では、ドメインを選択します。

1. **[タグ]** セクションで **[新しいタグを追加する]** を選択します。

1. **[Key]** (キー) と **[Value]** (値) で、適切な値を入力します。

   例えば、それぞれ **Environment** および **Test** などです。

1. タグをさらに追加するには、**[Add new tag]** (新しいタグを追加) を選択します。

   1 つのリソースに最大 50 個のタグを追加できます。

1. **[Next]** (次へ) を選択し、リソースの作成を続行します。

既存のリソースにタグを追加するのも同様です。リソースを選択し、「**タグ**」フィールドを使用してタグを追加します。

## タグの追加 (AWS CLI)
<a name="add-tag-cli"></a>

 AWS Command Line Interface (AWS CLI) を使用して、リソースの作成時にタグを追加したり、既存のリソースにタグを追加したりできます。

**Topics**
+ [リソース作成時のタグの追加](#create-resource-with-tags-cli)
+ [既存のリソースにタグを追加する](#add-tag-existing-resource-cli)

### リソース作成時のタグの追加
<a name="create-resource-with-tags-cli"></a>

新しいリソースを作成し、 を使用してタグを追加するには AWS CLI、リソースに適切な`create`コマンドを使用し、 `tags`パラメータと値を含めます。例えば、次のコマンドは、ECOMMERCE ドメインに対して `myDatasetGroup` という名前の新しいドメインデータセットグループを作成し、次のタグを追加します。`Environment` タグキーには `Test` タグ値、`Owner` タグキーには `xyzCorp` 値を追加します。

```
aws personalize create-dataset-group \
--name myDatasetGroup \
--domain ECOMMERCE \
--tags tagKey=Environment,tagValue=Test tagKey=Owner,tagValue=xyzCorp
```

Amazon Personalize リソースの作成に使用できるコマンドの詳細については、[「Amazon Personalize AWS CLI コマンドリファレンス](https://docs.aws.amazon.com/cli/latest/reference/personalize/)」を参照してください。

### 既存のリソースにタグを追加する
<a name="add-tag-existing-resource-cli"></a>

既存のリソースにタグを追加するには、`tag-resource` コマンドを使用します。リソースの ARN を指定し、`tags` パラメータにタグキーと値を指定します。

```
aws personalize tag-resource \
--resource-arn resource ARN \
--tags tagKey=key,tagValue=value
```

## タグの追加 (AWS SDKs)
<a name="add-tag-sdk"></a>

 AWS SDKs を使用して、リソースの作成時にタグを追加したり、既存のリソースにタグを追加したりできます。

**Topics**
+ [リソース作成時のタグの追加](#create-resource-with-tags-sdk)
+ [既存のリソースにタグを追加する](#add-tag-existing-resource-sdk)

### リソース作成時のタグの追加
<a name="create-resource-with-tags-sdk"></a>

新しいリソースを作成し、 AWS SDKs を使用してタグを追加するには、適切な`create`方法を使用します。`tags` パラメータを使用して、各タグのキーと値のペアを指定します。例えば、次のコードは、ECOMMERCE ドメインに対して `myDatasetGroup` という名前の新しいドメインデータセットグループを作成し、次のタグを追加します。`Environment` タグキーには `Test` タグ値、`Owner` タグキーには `xyzCorp` 値を追加します。

------
#### [ SDK for Python (Boto3) ]

```
import boto3

personalize = boto3.client('personalize')

response = personalize.create_dataset_group(
  name = 'myDatasetGroup',
  domain = 'ECOMMERCE',
  tags = [
    {
      'tagKey': 'Environment',
      'tagValue': 'Test'
    },
    {
      'tagKey': 'Owner',
      'tagValue': 'xyzCorp'    
    }
  ]    
)
dsg_arn = response['datasetGroupArn']

description = personalize.describe_dataset_group(datasetGroupArn = dsg_arn)['datasetGroup']

print('Name: ' + description['name'])
print('ARN: ' + description['datasetGroupArn'])
print('Status: ' + description['status'])
```

------
#### [ SDK for Java 2.x ]

```
public static String createDomainDatasetGroup(PersonalizeClient personalizeClient, 
                                              String datasetGroupName,
                                              String domain) {
    
    try {
         
        ArrayList <Tag> tags = new ArrayList<>();

        Tag tag1 = Tag.builder()
                .tagKey("Environment")
                .tagValue("Test")
                .build();
        tags.add(tag1);
        Tag tag2 = Tag.builder()
                .tagKey("Owner")
                .tagValue("xyzCorp")
                .build();
        tags.add(tag2);
    
        CreateDatasetGroupRequest createDatasetGroupRequest = CreateDatasetGroupRequest.builder()
                .name(datasetGroupName)
                .domain(domain)
                .tags(tags)
                .build();
        return personalizeClient.createDatasetGroup(createDatasetGroupRequest).datasetGroupArn();
    } catch (PersonalizeException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
    return "";
}
```

------

### 既存のリソースにタグを追加する
<a name="add-tag-existing-resource-sdk"></a>

次のコードは、既存の Amazon Personalize リソースにタグを追加する方法を示しています。タグを追加するリソースの Amazon リソースネーム (ARN) を指定し、タグごとにキーと値のペアを指定します。

------
#### [ SDK for Python (Boto3) ]

```
import boto3
personalize = boto3.client('personalize')

add_tags_response = personalize.tag_resource(
  resourceArn = "resourceArn",
  tags = [
    {
      'tagKey': 'Environment',
      'tagValue': 'Test'
    },
    {
      'tagKey': 'Owner',
      'tagValue': 'xyzCorp'    
    }
  ]    
)
```

------
#### [ SDK for Java 2.x ]

```
public static void tagResource(PersonalizeClient personalizeClient, 
                                              String resourceArn,
                                              String domain) {
    
    try {
         
         ArrayList <Tag> tagList = new ArrayList<>();

          Tag tag1 = Tag.builder()
                  .tagKey("Environment")
                  .tagValue("Test")
                  .build();
          tags.add(tag1);
          Tag tag2 = Tag.builder()
                  .tagKey("Owner")
                  .tagValue("xyzCorp")
                  .build();
          tags.add(tag2);
    
        TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                .resourceArn(resourceArn)
                .tags(tagList)
                .build();
                
        personalizeClient.tagResource(tagResourceRequest);
        System.out.println("Tags have been added to "+ resourceArn);
        
    } catch (PersonalizeException e) {
        System.out.println(e.awsErrorDetails().errorMessage());
    }
    return "";
}
```

------