メニュー
Amazon ElastiCache
ユーザーガイド (API Version 2015-02-02)

AWS CLI を使用したコスト配分タグの管理

AWS CLI を使用して、コスト配分タグを追加、変更、または削除できます。

コスト配分タグは、ElastiCache リソースに適用されます。リソースの内容や ARN の指定方法は、エンジンやクラスターの構造によって異なります。

  • Memcached: タグはクラスターに適用されます。

    サンプル arn: arn:aws:elasticache:us-west-2:1234567890:cluster:mymemcached

  • Redis: タグは個々のノードに適用されます。このため、タグは、レプリケーションを持つ Redis クラスター内のノードに別々に適用できます。

    サンプル arn

    • Redis (クラスターモードが無効) レプリケーションなし:

      サンプル arn: arn:aws:elasticache:us-west-2:1234567890:cluster:myredis

    • Redis (クラスターモードが無効) レプリケーションあり:

      サンプル arn: arn:aws:elasticache:us-west-2:1234567890:cluster:myredis-001

    • Redis (クラスターモードが有効):

      サンプル arn: arn:aws:elasticache:us-west-2:1234567890:cluster:myredis-0001-001

  • バックアップ (Redis): タグは、バックアップに適用されます。

    サンプル arn: arn:aws:elasticache:us-west-2:1234567890:snapshot:myredisbackup

AWS CLI を使用したタグのリスト表示

AWS CLI の以下のオペレーションを使用して、既存の ElastiCache リソースのタグをリスト表示できます。 list-tags-for-resource オペレーション.

次のコードは、AWS CLI を使用して、us-west-2 リージョンの Memcached クラスター myCluster のタグをリスト表示します。

Linux, macOS, or Unix 用:

Copy
aws elasticache list-tags-for-resource \ --resource-name arn:aws:elasticache:us-west-2:0123456789:cluster:myCluster

Windows の場合:

Copy
aws elasticache list-tags-for-resource ^ --resource-name arn:aws:elasticache:us-west-2:0123456789:cluster:myCluster

このオペレーションの出力は、リソースのすべてのタグを示した次のリストのようになります。

{
   "TagList": [
      {
         "Value": "10110",
         "Key": "CostCenter"
      },
      {
         "Value": "EC2",
         "Key": "Service"
      }
   ]
}

リソースにタグが見つからない場合は、空の TagList が出力されます。

{
   "TagList": []
}

詳細については、ElastiCache の AWS CLI 「 list-tags-for-resource」を参照してください。

AWS CLI を使用したタグの追加

AWS CLI の add-tags-to-resource CLI オペレーションを使用して、既存の ElastiCache リソースにタグを追加できます。タグキーがリソースに存在しない場合は、キーと値がリソースに追加されます。キーが既にリソースに存在する場合、キーに関連付けられた値は新しい値に更新されます。

次のコードは、AWS CLI を使用して、us-west-2 リージョンのリソース myClusterServiceRegion というキーを追加し、それぞれの値を elasticacheus-west-2 に設定します。

Linux, macOS, or Unix 用:

Copy
aws elasticache add-tags-to-resource \ --resource-name arn:aws:elasticache:us-west-2:0123456789:cluster:memcluster \ --tags Key=Service,Value=elasticache \ Key=Region,Value=us-west-2

Windows の場合:

Copy
aws elasticache add-tags-to-resource ^ --resource-name arn:aws:elasticache:us-west-2:0123456789:cluster:memcluster ^ --tags Key=PM ^ Key=Region,Value=us-west-2

このオペレーションの出力は、次のオペレーションのリソースのすべてのタグを示した以下のリストのようになります。

{
   "TagList": [
      {
         "Value": "10110",
         "Key": "CostCenter"
      },
      {
         "Value": "EC2",
         "Key": "Service"
      },
      {
         "Value": "",
         "Key": "PM"
      },
      {
         "Value": "us-west-2",
         "Key": "Region"
      }
   ]
}

詳細については、ElastiCache の AWS CLI 「 add-tags-to-resource」を参照してください。

AWS CLI のオペレーション create-cache-clusterを使用して新しいクラスターを作成するとき、または、オペレーション create-replication-groupを使用して新しいレプリケーショングループを作成するときに、クラスターにタグを追加できます。ElastiCache マネジメントコンソールでは、リソースの作成時にタグを追加できないことに注意してください。クラスターやレプリケーショングループを作成した後は、コンソールを使用してリソースにタグを追加できます。

AWS CLI を使用したタグの変更

AWS CLI を使用して、ElastiCache リソースのタグを変更できます。

タグの値を変更するには:

  • 使用アイテム add-tags-to-resource を使用して、新しいタグを追加するか、既存のタグに関連付けられている値を変更します。

  • 使用アイテム remove-tags-from-resource を使用して、リソースから指定したタグを削除します。

どちらのオペレーションでも、指定のリソースのタグとその値を示すリストが出力されます。

AWS CLI を使用したタグの削除

AWS CLI の以下のオペレーションを使用して、既存の ElastiCache リソースのタグを削除できます。 remove-tags-from-resource オペレーション.

次のコードでは、AWS CLI を使用して、(Service) と (Region) というキーのタグを us-west-2 リージョンのリソース (myCluster) から削除します。

Linux, macOS, or Unix 用:

Copy
aws elasticache remove-tags-from-resource \ --resource-name arn:aws:elasticache:us-west-2:0123456789:cluster:myCluster \ --tag-keys PM Service

Windows の場合:

Copy
aws elasticache remove-tags-from-resource ^ --resource-name arn:aws:elasticache:us-west-2:0123456789:cluster:myCluster ^ --tag-keys PM Service

このオペレーションの出力は、次のオペレーションのリソースのすべてのタグを示した以下のリストのようになります。

{
   "TagList": [
      {
         "Value": "10110",
         "Key": "CostCenter"
      },
      {
         "Value": "us-west-2",
         "Key": "Region"
      }
   ]
}

詳細については、ElastiCache の AWS CLI 「 remove-tags-from-resource」を参照してください。