本文中含有需要您注意的重要提示信息，忽略该信息可能对您的业务造成影响，请务必仔细阅读。
Client是日志服务Java SDK的客户端，它为调用者提供了一系列的方法，可以用来创建Project和Logstore、写入日志、读取日志等。使用Java SDK发起请求，您需要初始化一个Client实例，并根据需要修改默认配置项。
前提条件
操作步骤
以下提供两种初始化方式，请按需选择：
AK初始化：AK是长期有效的，可直接用于API调用，适合不需要频繁更换凭证的稳定场景。
STS初始化：STS生成的临时访问凭证，适用于需要动态、临时授权的场合。
初始化Client
public Client(String endpoint, String accessKeyId, String accessKeySecret)请求参数
变量 | 类型 | 是否必填 | 说明 | 示例值 |
endpoint | String | 是 | 服务入口（Endpoint）是访问阿里云服务的入口点，通常是一个URL，它指定了服务的访问协议、主机名、端口和路径等信息，客户端可以使用这些信息与服务进行通信。日志服务的Endpoint分为：
|
|
accessKeyId | String | 是 |
| yourAccessKeyID |
accessKeySecret | String | 是 | 使用AK配置访问凭证，则为阿里云账号（主账号）和RAM用户（子账号）的AccessKey Secret，用于验证您拥有该AccessKey ID的密码。具体参见配置访问凭证。 | yourAccessKeySecret |
示例代码
V4签名算法采用更复杂的加密和签名方式，提供了更高的安全性，V1签名算法相对比较简单，可按需选择：
package com.test.controller;
import com.aliyun.openservices.log.Client;
import com.aliyun.openservices.log.http.client.ClientConfiguration;
import com.aliyun.openservices.log.http.signer.SignVersion;
public class Sample {
public static void main(String[] args) throws Exception {
// 日志服务的服务接入点。此处以北京为例，其它地域请根据实际情况填写
String endpoint = "cn-beijing.log.aliyuncs.com";
// 本示例从环境变量中获取 AccessKey ID 和 AccessKey Secret。
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
ClientConfiguration clientConfiguration = new ClientConfiguration();
clientConfiguration.setRegion("cn-beijing");
clientConfiguration.setSignatureVersion(SignVersion.V4);
Client client = new Client(endpoint,
accessKeyId,
accessKeySecret,
clientConfiguration);
}
}package com.test.controller;
import com.aliyun.openservices.log.Client;
public class Sample {
public static void main(String[] args) throws Exception {
// 日志服务的服务接入点。此处以北京为例，其它地域请根据实际情况填写
String endpoint = "cn-beijing.log.aliyuncs.com";
// 本示例从环境变量中获取 AccessKey ID 和 AccessKey Secret。
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
Client client = new Client(endpoint, accessKeyId, accessKeySecret);
}
}初始化Client
Client(String endpoint, CredentialsProvider credentialsProvider) ;请求参数
变量 | 类型 | 是否必填 | 说明 | 示例值 |
endpoint | String | 是 | 服务入口（Endpoint）是访问阿里云服务的入口点，通常是一个URL，它指定了服务的访问协议、主机名、端口和路径等信息，客户端可以使用这些信息与服务进行通信。日志服务的Endpoint分为：
|
|
accessKeyId | String | 是 | 使用STS配置访问凭证，则为AssumeRole接口返回参数Credentials中的AccessKeyId。 | yourAccessKeyID |
accessKeySecret | String | 是 | 使用STS配置访问凭证，则为AssumeRole接口返回参数Credentials中的AccessKeySecret。 | yourAccessKeySecret |
securityToken | String | 是 | 使用STS配置访问凭证，则为AssumeRole接口返回参数Credentials中的SecurityToken。 | CAIStwJ1q6Ft5B2yfSjIr5TcPtTFoLF71PC6TEKG1************= |
示例代码
package com.test.controller;
import com.aliyun.openservices.log.Client;
import com.aliyun.openservices.log.common.auth.DefaultCredentials;
import com.aliyun.openservices.log.common.auth.StaticCredentialsProvider;
public class Sample {
public static void main(String[] args) throws Exception {
// 日志服务的服务接入点。此处以北京为例，其它地域请根据实际情况填写
String endpoint = "cn-beijing.log.aliyuncs.com";
// 本示例从环境变量中获取AssumeRole接口返回参数Credentials中的AccessKeyId。
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
// 本示例从环境变量中获取AssumeRole接口返回参数Credentials中的AccessKeySecret。
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
// 本示例从环境变量中获取AssumeRole接口返回参数Credentials中的SecurityToken。
String securityToken = System.getenv("ALIBABA_CLOUD_STS_TOKEN");
Client client = new Client(endpoint, new StaticCredentialsProvider(
new DefaultCredentials(accessKeyId, accessKeySecret, securityToken)
));
}
}相关文档
初始化Client后，您可以调用接口实现创建Project、写入日志等操作，请参见Java SDK快速入门。
- 本页导读 （1）
- 前提条件
- 操作步骤
- 相关文档