使用SDK与日志服务的服务器端进行交互时需要指定一些基本配置,本文介绍SDK的基本配置信息。
目前,所有语言的SDK都定义了一个Client类作为入口类,这些基本配置信息在该入口类的构造时指定。
具体包括如下几项:
- 服务入口(Endpoint):确认Client需要访问的服务入口。
- 阿里云访问密钥(AccessKey ID,AccessKey secret):指定Client访问日志服务时使用的访问密钥。
下面详细说明这两个配置的使用方式。
服务入口(Endpoint)
- 当选择Client的Endpoint时,必须要保证您需要访问的Project的地域和Endpoint对应的地域一致,否则SDK将无法访问您指定的Project。
- 由于Client实例只能在构造时指定该服务入口,如果需要访问不同地域里的Project,则需要用不同的Endpoint构建不同的Client实例。
- 目前,所有API的服务入口均支持HTTPS协议和HTTP协议。
- 如果在阿里云ECS虚拟机内使用SDK,您还可以使用内网Endpoint来避免公网带宽开销,具体请参见服务入口。
访问密钥(AccessKey)
- 您的账号下可以拥有多组访问密钥对,但在构造Client时指定的AccessKey ID和AccessKey secret必须成对,否则无法通过服务端的安全验证。
- 指定的访问密钥对必须处于启用状态,否则会被服务端拒绝请求。同样,您也可以到云控制台查看访问密钥的状态。
示例
AccessKeyId = "bq2sjzesjmo**************"
AccessKeySecret = "4fdO2fTDDnZPU/*************"
- Java
String endpoint = "地域id.example.com"; //在实际使用中,请按照您实际的服务入口和接入方式编写。 String accessKeyId = "bq2sjzesjmo**************"; //用户访问密钥对中的AccessKey ID。 String accessKeySecret = "4fdO2fTDDnZPU/*************";//用户访问密钥对中的AccessKey secret。 Client client = new Client(endpoint, accessKeyId, accessKeySecret); //use client to operate log service project......
- .NET(C#)
String endpoint = "地域id.example.com"; // 在实际使用中,请按照您实际的服务入口和接入方式编写。 String accessKeyId = "bq2sjzesjmo**************"; //用户访问密钥对中的AccessKey ID。 String accessKeySecret = "4fdO2fTDDnZPU/*************";//用户访问密钥对中的AccessKey secret。 SLSClient client = new SLSClient(endpoint, accessKeyId, accessKeySecret); //use client to operate sls project......
- PHP
$endpoint = '地域id.example.com'; //在实际使用中,请按照您实际的服务入口和接入方式编写。 $accessKeyId = 'bq2sjzesjmo**************'; //用户访问密钥对中的AccessKey ID。 $accessKey = '4fdO2fTDDnZPU/*************';//用户访问密钥对中的AccessKey secret。 $client = new Aliyun_Sls_Client($endpoint, $accessKeyId, $accessKey); //use client to operate sls project......
- Python
# // 在实际使用中,请按照您实际的服务入口和接入方式编写。 endpoint = '地域id.example.com' # 用户访问密钥对中的AccessKey ID。 accessKeyId = 'bq2sjzesjmo*************' # 用户访问密钥对中的AccessKey secret。 accessKey = '4fdO2fTDDnZPU/*************' client = LogClient(endpoint, accessKeyId, accessKey) #use client to operate log project......