将 Apigee 与数据驻留功能搭配使用

本文档介绍了如何将 Apigee 界面、 Apigee API 以及 MessageLogging 和 PublishMessage 政策与数据驻留搭配使用。

如需详细了解 Apigee 中的数据驻留，请参阅 数据驻留简介。

将 Apigee 界面与数据驻留搭配使用

如需使用数据驻留访问 Apigee 界面，请根据您的数据驻留要求访问以下任一控制台：

管辖区控制台会按如下方式更改界面与服务的互动：

  • 您只能选择与所选控制平面位置一致的资源位置。
  • 创建端点连接时，您只能选择与组织的资源位置政策一致的 服务连接 。这可以防止不在允许位置的专用目标进行 访问 。

将 Apigee API 与数据驻留搭配使用

如需使用数据驻留访问 Apigee API，请使用 将区域级 端点用于数据驻留中所述的以下区域级端点。

使用 Apigee API 时，如果您使用的区域被控制软件包禁止，您将收到 Permission Denied 错误。

将 MessageLogging 和 PublishMessage 政策与数据驻留搭配使用

以下部分介绍了如何更新 MessageLogging 和 PublishMessage 政策的政策定义，以支持数据驻留。

将 MessageLogging 政策与数据驻留搭配使用

使用 MessageLogging 政策时，如需支持数据驻留 请更新政策定义，将 <Endpoint> 元素添加到 <CloudLogging> 元素 并将其设置为用于消息日志记录的区域级端点，如下所示：

logging.CONTROL_PLANE_LOCATION.rep.googleapis.com:443。

CONTROL_PLANE_LOCATION 是预配期间指定的物理位置， Apigee 控制平面数据 将存储在该位置。

如果您未添加 <Endpoint> 元素，该政策将默认使用全球端点。

例如，以下政策定义使用区域级端点在消息日志记录中 us 区域：

<MessageLogging name="LogToCloudLogging">
    <CloudLogging>
        <LogName>projects/{organization.name}/logs/{log.id}</LogName>
        <Message contentType="application/json">{"{message.queryparam.key}": "{message.queryparam.value}"}</Message>
        <Labels>
            <Label>
                <Key>key1</Key>
                <Value>value1</Value>
            </Label>
            <Label>
                <Key>key2</Key>
                <Value>value2</Value>
            </Label>
        </Labels>
        <ResourceType>api</ResourceType>
        <Endpoint>logging.us.rep.googleapis.com:443</Endpoint>
    </CloudLogging>
</MessageLogging>

如需了解详情， 请参阅 MessageLogging 政策。

将 PublishMessage 政策与数据驻留搭配使用

如需支持数据驻留，在使用 PublishMessage 政策时，您必须 更新政策定义，将 <Endpoint> 元素添加到 <CloudPubSub> 元素 并将其设置为用于 Pub/Sub 消息传递的区域级端点，如下所示：

pubsub.CONTROL_PLANE_LOCATION.rep.googleapis.com:443。

CONTROL_PLANE_LOCATION 是预配期间指定的物理位置， Apigee 控制平面数据 将存储在该位置。

如果您未添加 <Endpoint> 元素，该政策将默认使用全球端点。

例如，以下政策定义使用区域级端点在 us 区域中进行 Pub/Sub 消息传递：

<PublishMessage async="false" continueOnError="false" enabled="true" name="Publish to Pub/Sub">
    <DisplayName>Publish to Pub/Sub</DisplayName>
    <Description>Publish to Pub/Sub</Description>
    <CloudPubSub>
        <Topic>projects/{organization.name}/topics/{topic.name}</Topic>
        <Endpoint>pubsub.us.rep.googleapis.com:443</Endpoint>
    </CloudPubSub>
</PublishMessage>

如需了解详情， 请参阅 PublishMessage 政策。