本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用已與您共用的第三方私有擴充功能
<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) 許可。

無論您是使用 的 [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/register-type.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/register-type.html)命令 AWS CLI，還是 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)命令，都是如此。

如需詳細資訊，請參閱*服務授權參考*中的 [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)：從您的帳戶中移除私有擴充功能或擴充功能版本。