Apigee mit Datenstandort verwenden

In diesem Dokument wird beschrieben, wie Sie die Apigee-Benutzeroberfläche, Apigee API und die Richtlinien MessageLogging und PublishMessage mit Datenstandort verwenden.

Weitere Informationen zum Datenstandort in Apigee finden Sie unter Einführung in Datenstandorte.

Apigee-Benutzeroberfläche mit Datenstandort verwenden

Wenn Sie mit Datenstandort auf die Apigee-Benutzeroberfläche zugreifen möchten, rufen Sie je nach Ihren Anforderungen an den Datenstandort eine der folgenden Konsolen auf:

• Datenstandort (nur im Ruhezustand): Google Cloud Konsole
• Erweiterter Datenstandort: Gerichtsbarkeitskonsole

Die Gerichtsbarkeitskonsole ändert die UI-Interaktionen mit Diensten wie folgt:

• Sie können nur Ressourcenstandorte auswählen, die mit dem ausgewählten Standort der Steuerungsebene übereinstimmen.
• Beim Erstellen von Endpunktanhängen können Sie nur Dienstanhänge auswählen, die mit der Richtlinie für Ressourcenstandorte Ihrer Organisation übereinstimmen. Dadurch wird der Zugriff durch ein privates Ziel verhindert, das sich nicht an einem zulässigen Standort befindet.

Apigee API mit Datenstandort verwenden

Wenn Sie mit Datenstandort auf die Apigee API zugreifen möchten, verwenden Sie die folgenden regionalen Endpunkte, die unter Regionale Endpunkte für den Datenstandort verwenden beschrieben werden.

Wenn Sie die Apigee API verwenden, wird der Permission Denied Fehler angezeigt, wenn Sie eine Region verwenden, die durch das Kontrollpaket verboten ist.

Richtlinien MessageLogging und PublishMessage mit Datenstandort verwenden

In den folgenden Abschnitten wird beschrieben, wie Sie die Richtliniendefinitionen für die MessageLogging und PublishMessage Richtlinien aktualisieren, um den Datenstandort zu unterstützen.

MessageLogging-Richtlinie mit Datenstandort verwenden

Wenn Sie die MessageLogging-Richtlinie verwenden, um den Datenstandort zu unterstützen, aktualisieren Sie die Richtliniendefinition, um das Element <Endpoint> dem Element <CloudLogging> hinzuzufügen und es auf den regionalen Endpunkt festzulegen, der für die Nachrichtenprotokollierung verwendet werden soll:

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

Wichtig: Wenn Sie VPC Service Controls mit Datenstandort verwenden, müssen Sie den folgenden regionalen Endpunkt verwenden: CONTROL_PLANE_LOCATION-logging.googleapis.com.

CONTROL_PLANE_LOCATION ist der physische Standort, der bei der Bereitstellung angegeben wurde, an dem die Daten der Apigee-Steuerungsebene gespeichert werden.

Wenn Sie das Element <Endpoint> nicht hinzufügen, wird standardmäßig der globale Endpunkt verwendet.

In der folgenden Richtliniendefinition wird beispielsweise der regionale Endpunkt für die Nachrichtenprotokollierung in der us Region verwendet:

<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>

Weitere Informationen finden Sie unter MessageLogging-Richtlinie.

PublishMessage-Richtlinie mit Datenstandort verwenden

Wenn Sie die PublishMessage-Richtlinie verwenden, müssen Sie die Richtliniendefinition aktualisieren, um den Datenstandort zu unterstützen. Fügen Sie dem <CloudPubSub> Element das <Endpoint> Element hinzu und legen Sie es auf den regionalen Endpunkt fest, der für die Pub/Sub-Nachrichtenübermittlung verwendet werden soll:

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

Wichtig: Wenn Sie VPC Service Controls mit Datenstandort verwenden, müssen Sie das Element <Endpoint> auf den folgenden regionalen Endpunkt festlegen:

CONTROL_PLANE_LOCATION-pubsub.googleapis.com

CONTROL_PLANE_LOCATION ist der physische Standort, der bei der Bereitstellung angegeben wurde, an dem die Daten der Apigee-Steuerungsebene gespeichert werden.

Wenn Sie das Element <Endpoint> nicht hinzufügen, wird standardmäßig der globale Endpunkt verwendet.

In der folgenden Richtliniendefinition wird beispielsweise der regionale Endpunkt für die Pub/Sub -Nachrichtenübermittlung in der us-Region verwendet:

<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>

Weitere Informationen finden Sie unter PublishMessage-Richtlinie.