全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
日志服务

配置

更新时间:2018-03-20 15:57:17

就如同使用 API 和日志服务服务端交互一样,使用 SDK 也需要指定一些基本配置。目前,所有语言的 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 的服务入口仅支持 HTTP 协议。
  • 如果在阿里云 ECS 虚拟机内使用 SDK,您还可以使用内网 Endpoint 避免公网带宽开销,具体请参考 服务入口

访问秘钥(AccessKey)

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

注意

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

示例

如果您需要访问在“华东 1 (杭州)”Region 下的 Project,且当前已经拥有一对处于启用状态的访问秘钥对。

访问秘钥对:

  1. AccessKeyId = "bq2sjzesjmo86kq35behupbq"
  2. AccessKeySecret = "4fdO2fTDDnZPU/L7CHNdemB2Nsk="

则可以通过如下方式创建 Client 实例:

Java
  1. String endpoint = "cn-hangzhou.log.aliyuncs.com"; //“华东 1 (杭州)” Region 的日志服务入口。
  2. String accessKeyId = "bq2sjzesjmo86kq35behupbq"; //用户访问秘钥对中的 AccessKeyId。
  3. String accessKeySecret = "4fdO2fTDDnZPU/L7CHNdemB2Nsk=";//用户访问秘钥对中的 AccessKeySecret。
  4. Client client = new Client(endpoint, accessKeyId, acccessKeySecret);
  5. //use client to operate log service project......
.NET(C#)
  1. String endpoint = "cn-hangzhou.log.aliyuncs.com"; //“华东 1 (杭州)” Region 的日志服务入口。
  2. String accessKeyId = "bq2sjzesjmo86kq35behupbq"; //用户访问秘钥对中的 AccessKeyId。
  3. String accessKeySecret = "4fdO2fTDDnZPU/L7CHNdemB2Nsk=";//用户访问秘钥对中的 AccessKeySecret。
  4. SLSClient client = new SLSClient(endpoint, accessKeyId, accessKeySecret);
  5. //use client to operate sls project......
PHP
  1. $endpoint = 'cn-hangzhou.log.aliyuncs.com'; //“华东 1 (杭州)” Region 的日志服务入口。
  2. $accessKeyId = 'bq2sjzesjmo86kq35behupbq'; //用户访问秘钥对中的 AccessKeyId。
  3. $accessKey = '4fdO2fTDDnZPU/L7CHNdemB2Nsk=';//用户访问秘钥对中的 AccessKeySecret。
  4. $client = new Aliyun_Sls_Client($endpoint, $accessKeyId, $accessKey);
  5. //use client to operate sls project......
Python
  1. # “华东 1 (杭州)” Region 的日志服务入口。
  2. endpoint = 'cn-hangzhou.log.aliyuncs.com'
  3. # 用户访问秘钥对中的 AccessKeyId。
  4. accessKeyId = 'bq2sjzesjmo86kq35behupbq'
  5. # 用户访问秘钥对中的 AccessKeySecret。
  6. accessKey = '4fdO2fTDDnZPU/L7CHNdemB2Nsk='
  7. client = LogClient(endpoint, accessKeyId, accessKey)
  8. #use client to operate log project......
本文导读目录