

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

# Amazon FSx リソースのタグ付け
<a name="tag-resources"></a>

ファイルシステムやその他の FSx for Windows ファイルサーバーリソースを管理しやすくするために、独自のメタデータをタグの形式で各リソースに割り当てることができます。タグを使用すると、例えば用途別、所有者別、環境別などのさまざまな方法で AWS リソースを分類できます。これは同じタイプのリソースが多数ある場合に役立ちます。割り当てたタグに基づいて、特定のリソースをすばやく識別できます。このトピックでは、タグとその作成方法について説明します。

**Topics**
+ [タグの基本](#tag-basics)
+ [リソースのタグ付け](#tagging-your-resources)
+ [タグの制限](#tag-restrictions)
+ [リソースにタグを付けるために必要なアクセス許可](#tags-iam)

## タグの基本
<a name="tag-basics"></a>

タグとはAWS リソースに割り当てるラベルです。タグはそれぞれ、1 つのキーとオプションの 1 つの値で設定されており、どちらもお客様側が定義します。

タグを使用すると、例えば用途別、所有者別、環境別などのさまざまな方法で AWS リソースを分類できます。たとえば、アカウントの FSx for Windows File Server ファイルシステムに一連のタグを定義して、各インスタンスの所有者とスタックレベルを追跡できます。

各リソースタイプのニーズを満たす一連のタグキーを考案することをお勧めします。一貫性のある一連のタグキーを使用することで、リソースの管理が容易になります。追加したタグに基づいてリソースを検索およびフィルタリングできます。効果的なリソースのタグ付け戦略を実装する方法の詳細については、AWS ホワイトペーパーの [タグ付けのベストプラクティス](https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/welcome.html) を参照してください。

タグは Amazon FSx に対してセマンティックな意味は持たず、文字列として厳密に解釈されます。また、タグは自動的にリソースに割り当てられます。タグのキーと値は編集でき、タグはリソースからいつでも削除できます。タグの値を空の文字列に設定することはできますが、タグの値を null に設定することはできません。特定のリソースについて既存のタグと同じキーを持つタグを追加した場合、以前の値は新しい値によって上書きされます。リソースを削除すると、リソースのタグも削除されます。

FSx for Windows ファイルサーバー API、AWSCLI、またはAWS SDK を使用している場合は、`TagResource`API アクションを使用して既存のリソースにタグを適用できます。ースに適用できます。さらに、リソース作成アクションによってはリソースの作成時にリソースのタグを指定できます。リソースの作成時にタグを適用できない場合はリソース作成プロセスがロールバックされます。これにより、リソースがタグ付きで作成されるか、まったく作成されないようになるため、タグ付けされていないリソースが存在することがなくなります。作成時にリソースにタグ付けすることで、リソース作成後にカスタムタグ付けスクリプティングを実行する必要がなくなります。作成時にユーザーがリソースにタグ付けできるようにする方法については、「[リソース作成時にタグ付けするアクセス許可の付与](using-tags-fsx.md#supported-iam-actions-tagging)」を参照してください。

## リソースのタグ付け
<a name="tagging-your-resources"></a>

アカウントに存在する FSx for Windows File Server リソースにタグ付けさせることができます。Amazon FSx コンソールを使用している場合は、関連するリソース画面のタグタブを使用して、リソースにタグを適用できます。リソースを作成するときは、Name キーに値を適用できます。また、新しいファイルシステムを作成するときに、選択したタグを適用できます。コンソールは Name タグに従ってリソースを整理できますが、このタグは FSx for Windows File Server サービスに対して意味を持ちません。

IAM ポリシーのタグベースのリソースレベルのアクセス権限を、作成時のタグ付けをサポートする FSx for Windows File Server API アクションに適用して、作成時にリソースにタグ付けできるユーザーとグループをきめ細かく制御できます。リソースは作成時から適切に保護されます。タグはリソースに即座に適用されるため、リソースの使用を制御するタグベースのリソースレベルアクセス権限がただちに有効になります。リソースはより正確に追跡および報告されます。新しいリソースにタグ付けの使用を適用し、リソースで設定されるタグキーと値をコントロールできます。

また、IAM ポリシーの`TagResource`および`UntagResource`FSx for Windows File Server API アクションにリソースレベルのアクセス許可を適用して、既存のリソースに設定するタグキーと値を制御することもできます。

請求用リソースへのタグ付けの詳細については*AWS Billing ユーザーガイド*の「[コスト配分タグの使用](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html)」を参照してください。

## タグの制限
<a name="tag-restrictions"></a>

タグには以下のような基本制限があります。
+ リソースあたりのタグの最大数 - 50 件
+ タグキーはリソースごとにそれぞれ一意である必要があります。また、各タグキーに設定できる値は 1 つのみです。
+ キーの最大長 - UTF-8 の 128 Unicode 文字
+ 値の最大長 - UTF-8 の 256 Unicode 文字
+ FSx for Windows File Server タグで使用できる文字は、UTF-8 で表現可能な文字、数字、スペース、および\$1-=.\$1:/@です。
+ タグのキーと値は大文字と小文字が区別されます。
+ `aws:` プレフィックスは AWS 用に限定されています。タグにこのプレフィックスが付いたタグキーがある場合、タグのキーまたは値を編集、削除することはできません。`aws:` プレフィックスを持つタグは、リソースあたりのタグ数の制限にはカウントされません。

タグのみに基づいてリソースを削除することはできません。削除するには、リソース識別子を指定する必要があります。例えば、`DeleteMe` というタグキーでタグ付けされたファイルシステムを削除するには、fs-1234567890abcdef0 などのファイルシステムリソース識別子で `DeleteFileSystem` アクションを使用する必要があります。

公開リソースまたは共有リソースにタグを付ける場合、割り当てるタグは AWS アカウント でのみ使用できます。他の AWS アカウント はタグにアクセスできません。共有リソースへのタグベースのアクセスコントロールの場合、各 AWS アカウント は、リソースへのアクセスをコントロールするために独自のタグのセットを割り当てる必要があります。

## リソースにタグを付けるために必要なアクセス許可
<a name="tags-iam"></a>

作成時に Amazon FSx リソースにタグ付けする際に必要なアクセス許可の詳細については、「[リソース作成時にタグ付けするアクセス許可の付与](using-tags-fsx.md#supported-iam-actions-tagging)」を参照してください。タグを使用して IAM ポリシーで Amazon FSx リソースへのアクセスを制限する方法の詳細については、「[タグを使用した Amazon FSx リソースへのアクセスのコントロール](using-tags-fsx.md#restrict-fsx-access-tags)」を参照してください。