搭配資料落地功能使用 Apigee

本文說明如何搭配資料落地功能，使用 Apigee UI、Apigee API，以及 MessageLogging 和 PublishMessage 政策。

如要進一步瞭解 Apigee 的資料落地功能，請參閱「資料落地簡介」。

搭配資料落地設定使用 Apigee 使用者介面

如要透過資料落地功能存取 Apigee 使用者介面，請根據資料落地需求存取下列任一控制台：

管轄區控制台會以以下方式改變服務的 UI 互動：

  • 您只能選取與所選控制層位置一致的資源位置。
  • 建立端點附件時，您只能選取與貴機構資源位置政策一致的服務附件。這樣一來，不在允許位置的私人目標就無法存取。

搭配資料落地設定使用 Apigee API

如要存取 Apigee API 並使用資料落地功能，請使用這篇文章中說明的區域端點。

使用 Apigee API 時，如果使用控制套件禁止的區域，系統會傳回 Permission Denied 錯誤。

搭配資料落地設定使用 MessageLogging 和 PublishMessage 政策

以下各節說明如何更新 MessageLogging 和 PublishMessage 政策的政策定義，以支援資料落地。

搭配資料落地設定使用 MessageLogging 政策

使用 MessageLogging 政策時，如要支援資料落地，請更新政策定義，在 <CloudLogging> 元素中新增 <Endpoint> 元素，並將其設為用於記錄訊息的區域端點，如下所示：

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 政策」。