翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS IoT 1-Click リソースにタグを付ける
AWS IoT 1-Click リソースを管理しやすくするために、タグを使用して任意の ARNベースのリソースに独自のメタデータを割り当てることができます。この章では、タグとその作成方法について説明します。
タグの基本
タグを使用すると、AWS IoT 1-Click リソースを目的、所有者、環境などさまざまな形で分類できます。これは、同じ型のリソースが多数ある場合に役立ちます。割り当てたタグに基づいて特定のリソースをすばやく検索および識別できます。タグはそれぞれ、1 つのキーとオプションの値で構成され、どちらもユーザーが定義します。たとえば、特定の管理者またはアカウントが所有する複数のボタンに対して、タグのセットを定義できます。追加したタグに基づいてリソースを検索およびフィルタリングできます。ニーズを満たす一連のタグキーをリソースタイプごとに考案されることをお勧めします。一貫性のあるタグキーセットを使用することで、リソースの管理が容易になります。詳細については、「AWS タグ付け戦略
また、AWS コストを分類して追跡するためにもタグを使用できます。タグをリソースに適用すると、AWS はタグ別に利用量とコストを集計したカンマ区切り値 (CSV) ファイルとしてコスト配分レポートを作成します。自社のカテゴリ (たとえばコストセンター、アプリケーション名、所有者) を表すタグを適用すると、複数のサービスにわたってコストを分類することができます。コスト配分のためのタグの使用の詳細については、コスト配分タグの使用()AWS Billing and Cost Management ユーザーガイド。
使いやすいように、AWS マネジメントコンソールでタグエディタを使用すると、統一された方法で一元的にタグを作成および管理できます。詳細については、「」を参照してください。タグエディターの使用がAWS マネジメントコンソールの開始方法。
AWS CLI および AWS IoT 1-Click デバイスおよびプロジェクト API を使用してタグを操作することもできます。タグを作成するときに AWS IoT 1-Click プロジェクトおよびデバイスをタグに関連付けるには、タグ以下のコマンドで入力します。
-
CreateProject (プロジェクト API)
-
要求の確定 (デバイス API)
既存のリソースのタグを追加、変更あるいは削除するには、次のコマンドを使用できます。
| AWS IoT 1-Clickプロジェクト API(プロジェクト ARN を使用) | AWS IoT 1-Clickデバイス API(デバイス ARN を使用) |
|---|---|
| TagResource | Tag
|
| ListTagsForResource | |
| UntagResource |
タグのキーと値は編集でき、タグはリソースからいつでも削除できます。タグの値を空の文字列に設定することはできますが、タグの値を null に設定することはできません。特定のリソースについて既存のタグと同じキーを持つタグを追加した場合、古い値は新しい値によって上書きされます。リソースを削除すると、リソースに関連付けられているすべてのタグも削除されます。
タグの制限
タグには以下のような基本制限があります。
-
リソースあたりのタグの最大数 – 50
-
キーの最大長:127 文字 (Unicode) (UTF-8)
-
値の最大長:255 文字 (Unicode) (UTF-8)
-
タグのキーと値は大文字と小文字が区別されます。
-
タグの名前または値に aws: プレフィックスは使用しないでください。このプレフィックスは AWS 用に予約されています。このプレフィックスが含まれるタグの名前または値は編集または削除できません。このプレフィックスを持つタグは、リソースあたりのタグ数の制限時には計算されません。
-
複数のサービス間およびリソース間でタグ付けスキーマを使用する場合、他のサービスでも許可される文字に制限が適用されることがあるのでご注意ください。一般的に使用が許可される文字は、UTF-8 で表現できる文字、スペース、数字と、特殊文字 (+ - = . _ : / @) です。
