阿里云日志服务配置

目前，所有语言的SDK都定义了一个Client类作为入口类，这些基本配置信息在该入口类的构造时指定。

具体包括如下几项：

• 服务入口（Endpoint）：确认Client需要访问的服务入口。
• 阿里云访问密钥（AccessKeyId/AccessKeySecret）：指定Client访问日志服务时使用的访问密钥。

下面详细说明这两个配置的使用方式。

服务入口（Endpoint）

当使用SDK时，首先需要明确访问的日志服务Project所在Region，例如华东1（杭州）、华北1（青岛）等，然后选择与其匹配的日志服务入口初始化Client。该服务入口与API中的服务入口定义一致。

• 当选择Client的Endpoint时，必须要保证您需要访问的Project的Region和Endpoint对应的Region一致，否则SDK将无法访问您指定的Project。
• 由于Client实例只能在构造时指定该服务入口，如果需要访问不同Region里的Project，则需要用不同的Endpoint构建不同的Client实例。
• 目前，所有API的服务入口均支持HTTPS/HTTP协议。
• 如果在阿里云ECS虚拟机内使用SDK，您还可以使用内网Endpoint来避免公网带宽开销，具体请参见服务入口。

访问密钥（AccessKey）

所有和日志服务端交互的请求都必须经过安全验证，而访问密钥就是用来对请求进行安全验证的关键因子，且以AccessKeyId和AccessKeySecret方式成对出现。在Client构造时需要指定两个参数：访问密钥对（AccessKeyId，AccessKeySecret）。所以，在使用SDK前，请在阿里云控制台密钥管理页面获取（或者创建）合适的密钥对。

说明

• 您的账号下可以拥有多组访问密钥对，但在构造Client时指定的AccessKeyId和AccessKeySecret必须成对，否则无法通过服务端的安全验证。
• 指定的访问密钥对必须处于启用状态，否则会被服务端拒绝请求。同样，您也可以到云控制台查看访问密钥的状态。

示例

如果您需要访问某个Project，且当前已经拥有一对处于启用状态的访问密钥对。如下所示：

AccessKeyId = "bq2sjzesjmo**************"
AccessKeySecret = "4fdO2fTDDnZPU/*************"

则可以如下实例化对应的Client实例：

• Java

  String endpoint = "regionid.example.com";       //在实际使用中，请按照您实际的服务入口和接入方式编写。
  String accessKeyId = "bq2sjzesjmo**************";        //用户访问密钥对中的 AccessKeyId。
  String accessKeySecret = "4fdO2fTDDnZPU/*************";//用户访问密钥对中的 AccessKeySecret。
  Client client = new Client(endpoint, accessKeyId, acccessKeySecret);
  //use client to operate log service project......

• .NET（C#）

  String endpoint = "regionid.example.com";       // 在实际使用中，请按照您实际的服务入口和接入方式编写。
  String accessKeyId = "bq2sjzesjmo**************";        //用户访问密钥对中的 AccessKeyId。
  String accessKeySecret = "4fdO2fTDDnZPU/*************";//用户访问密钥对中的 AccessKeySecret。
  SLSClient client = new SLSClient(endpoint, accessKeyId, accessKeySecret);
  //use client to operate sls project......

• PHP

  $endpoint = 'regionid.example.com'; //此处以hangzhou Region为例，在实际使用中，请按照您实际的服务入口和接入方式编写。
  $accessKeyId = 'bq2sjzesjmo**************';  //用户访问密钥对中的 AccessKeyId。
  $accessKey = '4fdO2fTDDnZPU/*************';//用户访问密钥对中的 AccessKeySecret。
  $client = new Aliyun_Sls_Client($endpoint, $accessKeyId, $accessKey);
  //use client to operate sls project......

• Python

  # // 在实际使用中，请按照您实际的服务入口和接入方式编写。
  endpoint = 'regionid.example.com'
  # 用户访问密钥对中的 AccessKeyId。
  accessKeyId = 'bq2sjzesjmo*************'
  # 用户访问密钥对中的 AccessKeySecret。
  accessKey = '4fdO2fTDDnZPU/*************'  
  client = LogClient(endpoint, accessKeyId, accessKey)
  #use client to operate log project......