激活账户中的第三方公有扩展

激活公有扩展以在您的账户中使用

1. 登录到 AWS Management Console 并打开 AWS CloudFormation 控制台 https://console.aws.amazon.com/cloudformation。

2. 在屏幕顶部的导航栏中，选择您的 AWS 区域。

3. 从导航窗格的注册表下，选择公共扩展程序。

4. 使用筛选条件选择扩展类型，然后选择第三方。（AWS 发布的扩展默认已激活。）

5. 选择扩展，然后选择激活。

   如果有多个版本的扩展可用，则您可以使用版本菜单选择要激活的扩展版本。默认为最新版本。

6. 对于扩展程序名称，您可以保留使用默认设置选项，或选择覆盖默认设置，然后输入要与此扩展程序一起使用的扩展程序类型别名。别名必须遵循扩展类型的推荐格式。有关更多信息，请参阅 使用别名以引用扩展。

7. 如果要激活的扩展程序是钩子或资源类型，那么对于执行角色 ARN，请指定调用扩展程序时 CloudFormation 要承担的 IAM 角色。有关更多信息，请参阅 配置具有 IAM 权限的执行角色和公有扩展访问权限的信任策略。

8. 对于日志配置，如果需要，则为扩展程序指定日志配置信息。例如：

   {
       "logRoleArn": "arn:aws:iam::account:role/rolename",
       "logGroupName": "log-group-name"
   }

   日志记录配置信息并非必需，但建议用于调试目的。要使用带有挂钩的日志记录配置，请添加与指定的执行角色相同的信任策略，以便日志角色可以将日志写入日志组。

   logRoleArn 和 logGroupName 键名称应区分大小写。

9. 对于版本控制、自动更新，请选择接收更新的方式。

   • On（开）- 自动更新为最新次要版本。主要版本手动更新。

   • Off（关）- 永不自动更新为最新版本。所有版本均手动更新。

   有关更多信息，请参阅 自动使用新版本的扩展。

指定配置数据

1. 对于配置，选择立即配置，然后选择激活扩展。

   CloudFormation 将显示 Configure extension（配置扩展）页面。要查看扩展的当前配置架构，请确保 View configuration schema（查看配置架构）已激活。

2. 在配置 JSON 文本框中，输入一个 JSON 字符串，该字符串表示要为此扩展指定的配置数据。您指定的 JSON 必须根据扩展的配置架构进行验证。

3. 选择配置扩展程序。

1. 对于配置，选择稍后配置，然后选择激活扩展。

2. 激活扩展后，您可以通过从已激活的扩展页面导航到该扩展并提供配置数据以对其进行配置。

激活公有挂钩以在您的账户中使用（AWS CLI）

1. 获取并保存挂钩的 ARN。您可以使用 AWS Management Console 或 AWS CLI 获取挂钩的 ARN。有关更多信息，请参阅查看 CloudFormation 注册表中可用和已激活的扩展。

   export HOOK_TYPE_ARN="arn:aws:cloudformation:us-west-2:123456789012:type/hook/Organization-Service-Hook/"

2. 使用 set-type-configuration 命令指定配置数据。为 --configuration 传递的 JSON 必须根据挂钩的配置架构进行验证。要激活所有堆栈操作的挂钩，必须在 HookConfiguration 部分中将 HookInvocationStatus 属性设置为 ENABLED。

   aws cloudformation set-type-configuration \
     --configuration "{"CloudFormationConfiguration":{"HookConfiguration":{"HookInvocationStatus": "ENABLED", "FailureMode": "FAIL", "Properties":{}}}}" \
     --type-arn $HOOK_TYPE_ARN --region us-west-2

   有关 HookConfiguration 配置选项的更多信息，请参阅《AWS CloudFormation Hooks User Guide》中的 Hook configuration schema syntax reference。

激活公有扩展以在您的账户中使用 (AWS CLI)

• 使用 activate-type 命令来激活扩展，并指定在发布扩展的新次要版本时是否自动更新扩展。

  下面的示例指定要为此账户激活的公有扩展的公共 Amazon 资源名称 (ARN)。此外，它指定 CloudFormation 在每次发布新的次要版本时更新扩展。

  aws cloudformation activate-type \
    --public-type-arn public_extension_ARN \
    --execution-role arn:aws:iam::123456789012:role/my-execution-role \
    --auto-update true --region us-west-2

  此命令返回已激活扩展的 ARN。

  {
      "Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Resource-Example"
  }