使用 VPC 私有端点（预览）

创建VPC接口端点

1. 在App Services用户界面中，导航到 App Settings ，然后单击Private Endpoints标签页。

2. 单击 Add Private Endpoint，然后单击 General。

3. 在各自的字段中添加VPC ID和子网 ID（逗号分隔列表），然后点击Next 。

4. 复制生成的VPC Interface Endpoint Command 。 该命令应如下所示：

   aws ec2 create-vpc-endpoint \
     --vpc-endpoint-type Interface
     --service-name <App Services Endpoint Service Name> \
     --vpc-id <your-vpc-id> \
     --region <your-aws-deployment-region> \
     --subnet-ids <your-subnet-ids>

5. 在终端中，执行生成的Amazon Web Services CLI命令以创建VPC端点。

将私有端点添加到您的应用程序

现在您已经在 VPC 中创建了接口端点，您需要将其添加到您的应用中。

1. 在上一步中运行的 VPCID命令的输出中，或在CLIAmazon Web ServicesVPC 仪表盘的 端点详细信息 屏幕上，找到 Endpoint 。该值以vpce-开头。

2. 复制新VPC端点的ID并将其粘贴到App Services用户界面中的Your VPC Endpoint ID字段中，然后单击Next 。

3. 如果这是您创建的第一个私有端点，您将看到一个开关，您可以使用它来限制或开放 PrivateLink 连接之外的请求的所有访问权限。默认情况下，App Services 会阻塞 PrivateLink 连接之外的所有请求。此设置适用于该端点和您创建的所有其他端点。有关更多信息，请参阅更改访问限制。

4. 单击 Finish Endpoint Creation（连接）。

创建VPC接口端点

1. 调用列出VPC私有端点服务端点。

2. 筛选响应对象以查找应用的部署地区和要创建的端点类型的条目。

   curl https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/security/private_endpoint_service_infos \
   -H "Authorization: Bearer <access_token>"

   隐藏输出

   [
   {
      "cloud_provider_region": "aws-us-east-1",
      "service_name": "com.amazonaws.vpce.us-east-1.vpce-svc-0718bec2c0bdeab5c",
      "endpoint_type": "general"
   },
   ...
   ]

3. 从上一步中所需的条目中获取service_name字段。

4. VPC使用Amazon Web ServicesCLI 创建 端点 create-vpc-endpoint 命令。您需要App Services端点服务名称、 VPC ID 、子网 ID 和Amazon Web Services部署地区。 该命令应如下所示：

aws ec2 create-vpc-endpoint \
  --vpc-endpoint-type Interface
  --service-name <App Services Endpoint Service Name> \
  --vpc-id <your-vpc-id> \
  --region <your-aws-deployment-region> \
  --subnet-ids <your-subnet-ids>

将私有端点添加到您的应用程序

现在您已经在 VPC 中创建了接口端点，您需要将其添加到您的应用中。

1. 在上一步中运行的 VPCID命令的输出中，或在CLIAmazon Web ServicesVPC 仪表盘的 端点详细信息 屏幕上，找到 Endpoint 。该值以vpce-开头。

2. 获得VPC端点的ID后，使用端点ID、云部署地区和端点类型调用创建VPC私有端点。 示例，使用aws-us-east-1 ：

curl https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/security/private_endpoints \
  -X POST \
  -H "Authorization: Bearer <accessToken>" \
  -H "Content-Type: application/json" \
  -d '{
    "cloud_provider_region": "<your-cloud-deployment-region>",
    "cloud_provider_endpoint_id": "<your-vpc-endpoint-id>",
    "endpoint_type": "general",
    "comment": "Optional: add a comment describing the endpoint."
  }'

创建VPC接口端点

1. 在App Services用户界面中，导航到App Settings ，然后单击Private Endpoints标签页。

2. 单击 Add Private Endpoint，然后单击 Sync。

3. 在各自的字段中添加VPC ID和子网 ID（逗号分隔列表），然后点击Next 。

4. 复制生成的VPC Interface Endpoint Command 。 该命令应如下所示：

   aws ec2 create-vpc-endpoint \
     --vpc-endpoint-type Interface
     --service-name <App Services Endpoint Service Name> \
     --vpc-id <your-vpc-id> \
     --region <your-aws-deployment-region> \
     --subnet-ids <your-subnet-ids>

5. 在终端中，执行生成的Amazon Web Services CLI命令以创建VPC端点。

6. 您还必须使用App Services生成的命令创建常规端点。

将私有端点添加到您的应用程序

现在您已经在 VPC 中创建了接口端点，您需要将它们添加到您的应用中。

1. 在上一步中运行的 命令的输出中，或在 仪表盘的端点详细信息屏幕上，找到 Sync 和 GeneralVPC Endpoint IDs CLIAmazon Web ServicesVPC。该值以vpce-开头。

2. 复制新的VPC端点 ID，并将其粘贴到App Services用户界面中各自的Your VPC Endpoint ID字段中，然后单击Next 。

3. 如果这是您创建的第一个私有端点，您将看到一个开关，您可以使用它来限制或开放 PrivateLink 连接之外的请求的所有访问权限。默认情况下，App Services 会阻塞 PrivateLink 连接之外的所有请求。此设置适用于该端点和您创建的所有其他端点。有关更多信息，请参阅更改访问限制。

4. 您还必须按照本页面上创建一般私有端点的步骤创建一般私有端点。

5. 单击 Finish Endpoint Creation（连接）。

创建VPC接口端点

1. 调用列出VPC私有端点服务端点。

2. 筛选响应对象以查找应用的部署地区和要创建的端点类型的条目。

   curl https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/security/private_endpoint_service_infos \
   -H "Authorization: Bearer <access_token>"

   隐藏输出

   [
   {
      "cloud_provider_region": "aws-us-east-1",
      "service_name": "com.amazonaws.vpce.us-east-1.vpce-svc-0718bec2c0bdeab5c",
      "endpoint_type": "sync"
   },
   ...
   ]

3. 从上一步中所需的条目中获取service_name字段。

4. VPC使用Amazon Web ServicesCLI 创建 端点 create-vpc-endpoint 命令。您需要App Services端点服务名称、 VPC ID 、子网 ID 和Amazon Web Services部署地区。 该命令应如下所示：

aws ec2 create-vpc-endpoint \
  --vpc-endpoint-type Interface
  --service-name <App Services Endpoint Service Name> \
  --vpc-id <your-vpc-id> \
  --region <your-aws-deployment-region> \
  --subnet-ids <your-subnet-ids>

将私有端点添加到您的应用程序

现在您已经在 VPC 中创建了接口端点，您需要将其添加到您的应用中。

1. 在上一步中运行的 命令的输出中，或在 仪表盘的端点详细信息屏幕上，找到同步VPC 端点IDCLIAmazon Web ServicesVPC 。该值以vpce-开头。

2. 通过调用创建VPC私有端点及其端点ID、云部署地区和端点类型来创建同步私有端点。 示例，使用aws-us-east-1 ：

   curl https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/security/private_endpoints \
   -X POST \
   -H "Authorization: Bearer <accessToken>" \
   -H "Content-Type: application/json" \
   -d '{
      "cloud_provider_region": "<your-cloud-deployment-region>",
      "cloud_provider_endpoint_id": "<your-vpc-endpoint-id>",
      "endpoint_type": "sync",
      "comment": "Optional: add a comment describing the endpoint."
   }'

3. 您还必须按照本页面上创建一般私有端点的步骤创建一般私有端点。