Endpunkte der Clientbibliothek konfigurieren

Auf jeden Cloud de Confiance by S3NS API-Dienst wird über einen dienstspezifischen Endpunkt zugegriffen.

Die Java-Clientbibliotheken für Speech und Translate haben beispielsweise die Standardendpunkte https://speech.googleapis.com:443 und https://translate.googleapis.com:443.

Die Cloud-Clientbibliotheken für Java ermitteln den korrekten Dienstendpunkt automatisch bei der Clientinitialisierung. Wenn kein benutzerdefinierter Endpunkt konfiguriert ist, verwenden die Bibliotheken den Standardendpunkt des Dienstes.

Anatomie eines Endpunkts

In der folgenden Tabelle sind die Abschnitte aufgeführt, aus denen der Java-Speech-Endpunkt besteht:

Dies sind die Standardwerte aller Cloud-Clientbibliotheken für Java-Endpunkte, mit Ausnahme des Dienstnamens. Der Dienstname hat keinen Standardwert da jeder Cloud de Confiance Dienst einen anderen Wert hat.

Wann sollte ein benutzerdefinierter Endpunkt konfiguriert werden?

Es gibt bestimmte Anwendungsfälle, in denen der Standardendpunkt ersetzt werden muss, z. B.:

• Der Dienst bietet regionale Endpunkte. Der Standardendpunkt berücksichtigt keine regionalen Varianten.
• Sie arbeiten nicht in der Produktionsumgebung. Beispielsweise testen Sie lokal mit einem Emulator, ohne TLS zu konfigurieren.

Ändern Sie die Endpunktkonfiguration nur, wenn dies erforderlich ist. Wenn Sie einen benutzerdefinierten Endpunkt verwenden, müssen Sie die Portnummer angeben (z. B. example.com:443). Die Clientbibliotheken hängen nicht automatisch einen Standardport wie 443 an benutzerdefinierte Endpunkte an, wie sie es bei Standarddienstendpunkten tun.

Benutzerdefinierten Endpunkt konfigurieren

Sie können den Endpunkt über die dienstspezifischen ClientSettings in den Cloud-Clientbibliotheken für Java festlegen.

Im folgenden Beispiel wird Java-KMS verwendet:

1. Legen Sie den Endpunkt in den ClientSettings.Builder fest und erstellen Sie den ClientSettings:

   // Replace with your desired endpoint
   String endpoint = "customEndpoint.com:443";
   KeyManagementServiceSettings keyManagementServiceSettings =
    KeyManagementServiceSettings.newBuilder()
       .setEndpoint(endpoint)
       .build();
   

2. Initiieren Sie den Client mit ClientSettings:

   try (KeyManagementServiceClient keyManagementServiceClient =
     KeyManagementServiceClient.create(keyManagementServiceSettings)) {
     ...
   }
   

   Der Endpunkt wird in customEndpoint.com:443 aufgelöst.

   Der Client verwendet den Endpunkt aus der ersten der folgenden Quellen, die einen Endpunkt bereitstellt:

   1. Der Endpunkt, der programmatisch über ClientSettings.Builder.setEndpoint() festgelegt wurde.
   2. Der Standardendpunkt des Dienstes, z. B. https://{serviceName}.googleapis.com:443.

Das folgende Snippet zeigt, wie der aufgelöste Endpunkt des Clients ermittelt wird:

// The client's settings class contains a getter for the endpoint
keyManagementServiceClient.getSettings().getEndpoint();