使用 VPC Lattice 连接到您的 VPC 中的私有资源

Amazon Bedrock AgentCore 支持私有连接到您的 AWS VPC 内或与您的 VPC 相连的本地环境中的资源，例如私有 MCP 服务器、内部 REST API 或数据库，而无需将这些服务暴露给公共互联网。

私有连接是使用 Amazon VPC 莱迪思资源网关和资源配置建立的。有关两种支持的模式（托管和自管莱迪思）的详细信息，请参阅支持的 VPC出口模式。

重要概念

支持的 Amazon Bedrock 服务 AgentCore

以下 Amazon Bedrock AgentCore 服务支持 VPC Lattice 的 VPC 出口：

支持的 VPC 出口模式

Amazon Bedrock AgentCore 支持两种配置 VPC 莱迪思连接的模式：

下表汇总了主要区别：

有关 VPC Lattice 定价详情，请参阅亚马逊 VPC Lattice 定价。

选项 1：托管 VPC 资源

使用托管 VPC 资源，您可以提供您的 VPC、子网和可选的安全组信息。 AgentCore 代表您处理 VPC Lattice 资源网关的创建和生命周期管理以及资源配置。托管资源网关是您的 VPC 中 ENI 的包装。您无法对其进行修改、配置或与之交互。 AgentCore 拥有其整个生命周期，包括创建、重复使用和删除。

AgentCore 使用AWSServiceRoleForBedrockAgentCoreGatewayNetwork服务关联角色在您的账户中创建和管理 VPC Lattice 资源网关。首次使用托管私有终端节点创建网关目标时，会自动创建此角色。有关此角色的更多信息，请参阅网关服务相关角色。

先决条件

在使用托管私有终端节点创建网关目标之前，请确保满足以下条件：

使用托管私有端点创建目标

要使用托管私有终端节点创建资源，请在创建请求中包含该privateEndpoint.managedVpcResource块。

{
  ...
  "privateEndpoint": {
    "managedVpcResource": {
      "vpcIdentifier": "vpc-0abc123def456",
      "subnetIds": ["subnet-0abc123", "subnet-0def456"],
      "endpointIpAddressType": "IPV4",
      "securityGroupIds": ["sg-0abc123def"]
    }
  },
  ...
}

该managedVpcResource区块接受以下字段：

查看托管资源

资源创建完成后，调用相关的 Get API（例如GetGatewayTarget），查看代表您 AgentCore 创建的托管 VPC Lattice 资源。这些将在响应的privateEndpointManagedResources字段中返回：

{
  ...
  "status": "READY",
  "privateEndpoint": {
    "managedVpcResource": {
      "vpcIdentifier": "vpc-0abc123def456",
      "subnetIds": ["subnet-0abc123", "subnet-0def456"],
      "endpointIpAddressType": "IPV4",
      "securityGroupIds": ["sg-0abc123def"]
    }
  },
  "privateEndpointManagedResources": [
    {
      "domain": "my-server.internal.example.com",
      "resourceGatewayArn": "arn:aws:vpc-lattice:us-east-1:123456789012:resourcegateway/rgw-abc123"
    }
  ]
}

resourceGatewayArn是在您的账户中 AgentCore 创建的 VPC 莱迪思资源网关的 ARN。 AgentCore 管理此资源的整个生命周期：它对具有匹配的 VPC 和子网配置的目标重复使用相同的资源网关，并在任何目标不再使用该资源时将其删除。

选项 2： Self-managed 莱迪思资源

使用自我管理的莱迪思，您可以自己创建和管理VPC莱迪思资源网关和资源配置，然后向提供资源配置标识符。 AgentCore如果您已经配置了VPC Lattice资源，需要在多个服务之间共享资源配置，或者需要控制莱迪思的资源生命周期，请使用此选项。

先决条件

在使用自行管理的私有终端节点创建网关目标之前，请完成以下步骤：

设置 VPC 莱迪思资源以实现自我管理连接

您的 IAM 委托人还需要以下权限 AgentCore 才能代表您将资源配置与 AgentCore 服务网络关联起来：

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "vpc-lattice:GetResourceConfiguration",
        "vpc-lattice:CreateServiceNetworkResourceAssociation",
        "vpc-lattice:GetServiceNetworkResourceAssociation",
        "vpc-lattice:ListServiceNetworkResourceAssociations",
        "vpc-lattice:AssociateViaAWSService"
      ],
      "Resource": "*"
    }
  ]
}

使用自行管理的私有终端节点创建目标

要使用自行管理的私有终端节点创建资源，请在创建请求中包含该privateEndpoint.selfManagedLatticeResource块：

{
  ...
  "privateEndpoint": {
    "selfManagedLatticeResource": {
      "resourceConfigurationIdentifier": "arn:aws:vpc-lattice:us-east-1:123456789012:resourceconfiguration/rcfg-abc123"
    }
  },
  ...
}

resourceConfigurationIdentifier可以是 ARN 或 VPC 莱迪思资源配置的 ID。 AgentCore 使用您的凭证（通过转发访问会话）将资源配置与 AgentCore 服务网络相关联。

资源创建完成后，Get API 响应会在privateEndpointManagedResources字段resourceAssociationArn中包含。如果您创建多个指向相同资源配置的资源，则 AgentCore 会自动重复使用现有的服务网络资源关联。

Cross-account 私有资源

您可以 AgentCore 连接到与拥有网关的 AWS 账户不同的账户中的私有资源。对于管理集中式网关而各个服务团队拥有私有资源的平台团队来说，这是一种常见的模式。

资源所有者账户必须使用 AWS RAM 与网关所有者账户共享 VPC Lattice 资源配置。然后，网关所有者账户在创建网关目标时提供共享资源配置标识符。

以下步骤总结了跨账户设置：

设置跨账户私有连接

通过中间域路由流量

您可以使用该routingDomain字段通过中间组件（例如 VPC 终端节点、内部 Application Load Balancer 或 Network Load Balancer）路由流量，而不是直接路由到目标域。当您想将多个私有资源整合到单个入口点后面时（例如，通过单个 VPC 终端节点路由多个私有 API 网关以减少资源配置数量和相关成本），这很有用。

使用路由域时，您为目标指定的域（在 MCP 端点网址或 OpenAPI 服务器网址中）应是资源的实际 DNS 名称。routingDomain是一个单独的域， AgentCore 用于设置 VPC Lattice 资源配置。在调用时， AgentCore 通过路由域路由流量，但使用实际目标域作为 TLS SNI 主机名发送请求，这样您的资源就会收到发往其实际域的请求。

路由域可以是路由到 VPC 内私有资源的任何域。常见选项包括：

以下步骤描述了使用路由域时的流量：

示例：带有 VPCE 路由域的私有 API Gateway

以下示例说明如何使用私有 API Gateway 的 VPCE 域作为路由域为私有 API Gateway 创建网关目标。目标 URL 是私有 API Gateway 主机名，routingDomain是 VPCE DNS 名称：

{
  "name": "my-private-apigw-target",
  "privateEndpoint": {
    "managedVpcResource": {
      "vpcIdentifier": "vpc-0123456789abcdef0",
      "subnetIds": ["subnet-0123456789abcdef0", "subnet-0abcdef1234567890"],
      "endpointIpAddressType": "IPV4",
      "routingDomain": "<vpce-id>.execute-api.us-east-1.vpce.amazonaws.com"
    }
  },
  "targetConfiguration": {
    "mcp": {
      "openApiSchema": {
        "inlinePayload": "<OpenAPI spec JSON with server URL matching the public certificate domain, for example https://<api-id>.execute-api.<region>.amazonaws.com>"
      }
    }
  }
}

私有证书的解决方法：ALB

VPC 出口要求您的目标终端节点具有公开信任的 TLS 证书。如果您的私有资源使用私有证书颁发机构 (CA) 颁发的证书，则建议的解决方法是在资源前面放置一个内部 Application Load Balancer (ALB)。

以下步骤描述了流量：

步骤 1：申请公共 ACM 证书

向 ACM 申请您拥有的域的公共证书。此域名将用作目标 URL。有关说明，请参阅《Cer tificate Manager 用户指南》中的申请公共 AWS 证书。

步骤 2：创建内部 ALB

在与您的私有资源相同的 VPC 中创建内部 Application Load Balancer。有关说明，请参阅 Elast ic Load Balancing 用户指南中的创建应用程序负载均衡器。确保将方案设置为internal。

步骤 3：创建 IP-based 目标组

在端口 443 (HTTPS) 上创建目标类型ip指向私有资源的 IP 地址的目标组，并将您的私有资源注册为目标。有关说明，请参阅《El astic Load Balancing 用户指南》中的创建目标组。

步骤 4：使用主机标头转换创建 HTTPS 侦听器

使用公共 ACM 证书在端口 443 上创建 HTTPS 侦听器。添加侦听器规则，在转发之前将主机标头从公共域转换为私有资源的域。

aws elbv2 create-listener \
  --load-balancer-arn <alb-arn> \
  --protocol HTTPS \
  --port 443 \
  --certificates CertificateArn=<acm-certificate-arn> \
  --default-actions '[{
    "Type": "forward",
    "TargetGroupArn": "<target-group-arn>",
    "ForwardConfig": {
      "TargetGroups": [{"TargetGroupArn": "<target-group-arn>", "Weight": 1}]
    }
  }]'

然后修改监听器规则以添加主机标头转换：

aws elbv2 modify-rule \
  --rule-arn <default-rule-arn> \
  --actions '[{
    "Type": "forward",
    "TargetGroupArn": "<target-group-arn>",
    "ForwardConfig": {
      "TargetGroups": [{"TargetGroupArn": "<target-group-arn>", "Weight": 1}]
    }
  }]' \
  --transforms '[{
    "Type": "host-header",
    "HostHeaderConfig": {
      "Values": ["my-server.my-company.internal"]
    }
  }]'

步骤 5：配置私有终端节点

使用 ALB DNS 名称作为routingDomain并使用公共证书域作为目标 URL。

{
  ...
  "privateEndpoint": {
    "managedVpcResource": {
      "vpcIdentifier": "<vpc-id>",
      "subnetIds": ["<subnet-id-1>", "<subnet-id-2>"],
      "endpointIpAddressType": "IPV4",
      "routingDomain": "internal-my-alb-1234567890.us-west-2.elb.amazonaws.com"
    }
  },
  ...
}

目标配置中的目标 URL 应使用https://my-server.my-company.com（公共证书域），而不是私有域。

Service-linked VPC 出口的角色

当您使用托管私有终端节点 (managedVpcResource) 创建网关目标时， AgentCore 使用AWSServiceRoleForBedrockAgentCoreGatewayNetwork服务相关角色在您的账户中创建和管理 VPC Lattice 资源网关。如果您的 IAM 委托人具有所需的iam:CreateServiceLinkedRole权限，则在您首次创建托管私有终端节点目标时会自动创建此角色。

服务相关角色具有以下关键特征：

有关创建、编辑和删除此角色的完整策略文档和说明，请参阅 Gateway 服务相关角色。

目标状态和故障排除

使用私有终端节点创建资源后，该资源将在 AgentCore 设置 VPC Lattice 资源并建立服务网络关联时进入CREATING状态。您可以通过调用相关的 Get API（例如GetGatewayTarget）并检查status和statusReasons字段来监控状态。

下表描述了常见状态值及其含义：

下表描述了常见问题及其解决方案：

限制和注意事项

使用 VPC 出口进行以下操作时，请注意以下限制： AgentCore