Amazon Personalize リソースへのタグ追加 - Amazon Personalize
タグの追加 (コンソール)タグの追加 (AWS CLI)タグの追加 (AWS SDK)

Amazon Personalize リソースへのタグ追加

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

タグの追加 (コンソール)

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

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

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

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

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

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

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

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

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

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

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

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

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

タグの追加 (AWS CLI)

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

リソース作成時のタグの追加

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 コマンドレファレンス」を参照してください。

既存のリソースにタグを追加する

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

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

タグの追加 (AWS SDK)

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

リソース作成時のタグの追加

新しいリソースを作成し、AWS SDK を使用してタグを追加するには、適切な 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 "";
}

既存のリソースにタグを追加する

次のコードは、既存の 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 "";
}