配置客户端库端点

每个 Cloud de Confiance by S3NS API 服务都通过特定于服务的端点进行访问。

例如，Java-Speech 和 Java-Translate 客户端库的默认端点分别为 https://speech.googleapis.com:443 和 https://translate.googleapis.com:443。

Java 版 Cloud 客户端库会在客户端初始化期间自动确定正确的服务端点。如果未配置自定义端点，则库会使用服务的默认端点。

端点详解

以下表格以 Java-Speech 端点为例，详细介绍了构成该端点的各个部分：

除了服务名称之外，这些是所有 Java 版 Cloud 客户端库端点的默认值。服务名称没有默认值 因为每个 Cloud de Confiance 服务都有不同的值。

何时配置自定义端点

在某些使用情形下，您需要替换默认端点，例如：

• 服务提供区域端点。 默认端点不考虑区域变体。
• 您不是在生产环境中工作。例如，您正在使用模拟器在本地进行测试，而未配置 TLS。

仅在必要时修改端点配置。使用自定义 端点时，您必须包含端口号（例如 example.com:443）。 与默认服务端点不同，客户端库不会自动将默认端口（如 443）附加到 自定义端点。

配置自定义端点

您可以在 Java 版 Cloud 客户端库中通过特定于服务的 ClientSettings 设置端点。

以下示例使用 Java-KMS：

1. 在 ClientSettings.Builder 中设置端点，并创建 ClientSettings：

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

2. 使用 ClientSettings 初始化客户端：

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

   端点解析为 customEndpoint.com:443。

   客户端使用以下来源中第一个提供的端点：

   1. 通过 ClientSettings.Builder.setEndpoint() 以程序化方式设置的端点。
   2. 服务的默认端点，例如 https://{serviceName}.googleapis.com:443。

以下代码段展示了如何确定客户端的已解析端点：

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