# 共有されているサードパーティーのプライベート拡張機能を使用する
<a name="registry-private"></a>

共有されているサードパーティーのプライベート拡張機能を使用するには、まずそれらを使用するアカウントとリージョンで、CloudFormation に*登録*する必要があります。拡張を登録すると、そのコピーがアカウントの CloudFormation レジストリにアップロードされ、アクティブ化されます。プライベート拡張を登録すると、その AWS アカウント とリージョンの CloudFormation レジストリに表示され、スタックテンプレートで使用できます。

**Topics**
+ [サードパーティーのプライベート拡張の登録のための IAM アクセス許可](#registry-register-permissions)
+ [プライベート拡張機能を操作するためによく使用される AWS CLI コマンド](#registry-commonly-used-commands-private-extensions)
+ [アカウントにサードパーティーのプライベート拡張機能を登録する](registry-register-private-extension.md)
+ [アカウントからのサードパーティープライベート拡張機能の削除](registry-private-deregister-extension.md)

## サードパーティーのプライベート拡張の登録のための IAM アクセス許可
<a name="registry-register-permissions"></a>

プライベート拡張の登録の一環として、拡張の登録の一環として、拡張のプロジェクトパッケージを含む Amazon S3 バケットを指定します。このパッケージには、登録する拡張に必要なソースファイルが含まれています。拡張を登録するユーザーは、Amazon S3 バケット内のプロジェクトパッケージにアクセスできる必要があります。これを行うには、ユーザーは、拡張パッケージに対する [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) アクセス許可を持っている必要があります。

これは、AWS CLI の [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/register-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/register-type.html) コマンドを使用している場合でも、CloudFormation CLI の [https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-cli-submit.html](https://docs.aws.amazon.com/cloudformation-cli/latest/userguide/resource-type-cli-submit.html) コマンドを使用している場合でも当てはまります。

詳細については、「*サービス認可リファレンス*」の「[Actions, resources, and condition keys for Amazon S3](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazons3.html)」を参照してください。

## プライベート拡張機能を操作するためによく使用される AWS CLI コマンド
<a name="registry-commonly-used-commands-private-extensions"></a>

プライベート拡張機能を操作するために一般的に使用されるコマンドは次のとおりです。
+  [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/register-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/register-type.html) は、プライベート拡張機能をアカウントに登録します。
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type-registration.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type-registration.html) は、登録リクエストの現在のステータスを返します。
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/list-types.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/list-types.html) は、アカウントの拡張機能を一覧表示します。
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-type.html) は、現在の設定データなど、特定の拡張機能または特定の拡張機能バージョンに関する詳細情報を返します。
+ アカウント内の拡張機能の設定データを指定し、フックを無効または有効にする [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-configuration.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-configuration.html)。
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-default-version.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/set-type-default-version.html) は、どのバージョンの拡張機能がデフォルトバージョンであるかを指定します。
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/deregister-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/deregister-type.html) は、アカウントからプライベート拡張機能または拡張機能バージョンを削除します。