私有 API 的自定义域名的 API 提供方和 API 使用方任务
在您创建私有自定义域名时，您便成为了 API 提供方。当您调用私有自定义域名时，您就是 API 使用方。您可以从自己的 Amazon Web Services 账户使用私有自定义域名，也可以从其他 Amazon Web Services 账户使用。
以下部分介绍了在使用私有自定义域名时，API 提供方和 API 使用方所需完成的任务。如果您想在自己的 Amazon Web Services 账户中调用私有自定义域名，那么您既是 API 提供方，又是 API 使用方。如果您想在其他 Amazon Web Services 账户中调用私有自定义域，则根据 Amazon Organizations 中 API 提供方与 API 使用方之间的信任关系，Amazon RAM 可能会为您完成一些任务。
API 提供方的任务
API 提供方创建私有 API 并将其映射到自定义域名。
API 提供方管理两个资源策略来保护其私有自定义域名。第一个策略针对 execute-api 服务，控制哪些 VPC 端点可以调用您的私有自定义域名。在私有自定义域名配置中，这称为 policy。
第二个策略针对 Amazon API Gateway 管理服务，控制其他 Amazon Web Services 账户中的哪些 VPC 端点可以与您的私有自定义域名建立域名访问关联。VPC 端点需要与私有自定义域名建立域名访问关联才能调用它。在私有自定义域名配置中，这是 managementPolicy。您可以使用 Amazon RAM 或 API Gateway 来更新此策略。如果您不打算允许其他 Amazon Web Services 账户中的 VPC 端点调用您的自定义域名，则无需编辑 managementPolicy。
如果您是 API 提供方，则必须完成以下任务：
创建私有 API。
-
更新私有 API 的
policy，向您的 VPC 端点授予对您私有 API 的访问权限。 创建私有自定义域名。
-
更新私有自定义域名的
policy，向您的 VPC 端点授予对您私有自定义域名的访问权限。 创建基本路径映射，将私有 API 映射到私有自定义域名。
如果您想允许其他 Amazon Web Services 账户中的 API 使用方访问您的私有自定义域名，请执行以下操作：
-
更新您的私有自定义域名的
managementPolicy，允许其他账户中的 API 使用方将其 VPC 端点与您的私有自定义域名相关联。您可以使用以下方法执行此操作：- Amazon RAM
-
对于 Amazon RAM，如果 API 提供方和 API 使用方属于同一组织并使用 Amazon Organizations，则会自动接受提供方和使用方之间的资源共享。否则，您需要等待 API 使用方接受资源共享。我们建议您使用 Amazon RAM 共享您的私有自定义域名。
- API Gateway
-
对于 API Gateway，仅支持 Amazon CLI。您必须使用补丁操作更新您的私有自定义域名，并为
managementPolicy提供自己的策略文档。
-
更新您的私有自定义域名以及映射到该域名的所有私有 API 的
policy，授予对 API 使用方的 VPC 端点的访问权限。
有关如何向其他 Amazon Web Services 账户提供您的 API 的说明，请参阅 API 提供方：使用 Amazon RAM 共享您的私有自定义域名。
API 使用方的任务
API 使用方将其 VPC 端点与域名 ARN 关联，以便调用私有自定义域名。API 使用方不需要创建 API Gateway API。
如果您是 API 使用方，请执行以下操作：
-
在 Amazon VPC 中创建启用私有 DNS 的 VPC 端点。
-
（可选 – 使用 Amazon RAM 时）在资源共享后的 12 小时内，在 Amazon RAM 中接受私有自定义域资源共享。如果您和 API 提供方位于同一个组织中，则会自动接受资源共享。
-
获取私有自定义域名 ARN。由于私有自定义域名 URL 不唯一，因此您需要使用私有自定义域名 ARN，在您的 VPC 端点与私有自定义域名之间建立域名访问关联。您可以使用 Amazon RAM 检索私有自定义域名 ARN。
-
在 API Gateway 中将私有自定义域 ARN 与您的 VPC 端点相关联。这将在您的 VPC 端点与私有自定义域名之间创建安全连接。流量不会离开 Amazon 网络。
-
等待 API 提供方向您的 VPC 端点授予访问权限，使其能够访问私有自定义域名以及映射到私有自定义域名的任何私有 API。如果您既是 API 提供方又是 API 使用方，则可以向自己授予对 VPC 端点的调用访问权限。
-
创建 Route 53 私有托管区和 Route 53 记录，以便解析 Route 53 中的私有自定义域名。
有关如何使用其他 Amazon Web Services 账户中 API 的说明，请参阅 API 使用方：将您的 VPC 端点关联到与您共享的私有自定义域名。