全部产品
云市场

Python SDK使用方法

更新时间:2019-05-29 10:01:33

下载地址

AIRec Python SDK 的下载地址是:https://pypi.org/project/aliyun-python-sdk-airec
SDK 源码地址:https://github.com/aliyun/aliyun-openapi-python-sdk/tree/master/aliyun-python-sdk-airec

使用步骤

为快速开始使用 AIRec Python SDK,请按照如下步骤进行。

步骤1 创建阿里云账号

具体方法请参考 阿里云账号注册流程
为了更好地使用阿里云服务,建议尽快完成实名认证,否则部分阿里云服务将无法使用。

步骤2 获取阿里云访问密钥

为了使用 AIRec Python SDK,您必须申请阿里云的 访问秘钥

登录阿里云 秘钥管理页面 。选择一对用于 SDK 的访问密钥对。如果没有,请创建一对新访问密钥,且保证它处于启用状态。有关如何创建访问密钥,参见 准备流程

步骤3 安装阿里云 Python SDK

完成以下操作安装 Python SDK:

  1. 安装 SDK 核心库

    • 如果您使用 Python 2.x,执行以下命令,安装阿里云SDK核心库:

      1. pip install aliyun-python-sdk-core
    • 如果您使用 Python 3.x,执行以下命令,安装阿里云SDK核心库:

      1. pip install aliyun-python-sdk-core-v3
  2. 安装云产品 AIRec 的 SDK

执行以下命令,安装 AIRec 的 SDK

  1. pip install aliyun-python-sdk-airec

步骤4 开始使用SDK

以推送文档的方法 PushDocument 为例,介绍使用阿里云Python SDK的3个主要步骤:

  1. 创建 Client。在创建 Client实例时,您需要获取 Region ID、AccessKey ID 和 AccessKey Secret。
  2. 设置 Endpoint
  3. 创建 Request 并设置参数。
  4. 发起请求并处理应答或异常。
  1. #!/usr/bin/python
  2. # coding=utf-8
  3. from aliyunsdkcore.client import AcsClient
  4. from aliyunsdkcore.acs_exception.exceptions import ClientException
  5. from aliyunsdkcore.acs_exception.exceptions import ServerException
  6. from aliyunsdkairec.request.v20181012.PushDocumentRequest import PushDocumentRequest
  7. # 创建 AcsClient 实例
  8. client = (
  9. "<your-access-key-id>",
  10. "<your-access-key-secret>",
  11. "<your-region-id>"
  12. );
  13. # 设置 Endpoint
  14. # 传入 RegionId、roduct 名称、服务接入地址
  15. client.add_endpoint("cn-hangzhou", "Airec", "airec.cn-hangzhou.aliyuncs.com")
  16. # 创建 Request,并设置参数
  17. # 创建一个对应方法的 Request,类的命名规则一般为 API 的方法名加上 Request。
  18. # 如获推送文档的 API 方法名为 PushDocument,那么对应的请求类名就是 PushDocumentRequest
  19. request = PushDocumentRequest()
  20. request.set_InstanceId("airec-cn-mp90z9q9i001")
  21. request.set_TableName("item")
  22. # 设置 Request的参数
  23. content = "[{\"cmd\":\"ADD\",\"fields\":{\"id\":\"qww\",\"name\":\"xzdfsffds\"}},{\"cmd\":\"ADD\",\"fields\":{\"id\":\"13224\",\"name\":\"zdfsdg\"}}]"
  24. request.set_content(content)
  25. request.set_content_type("application/json")
  26. # 使用 Client 对应的方法传入 Request,获得 Response 和处理异常。
  27. try:
  28. response = client.do_action_with_exception(request)
  29. print response
  30. except ClientException as e:
  31. print e
  32. except ServerException as e:
  33. print e