本文介绍如何初始化Python SDK。

使用Python SDK时,大部分操作都是通过oss2.Service和oss2.Bucket两个类进行。

  • oss2.Service类用于列举存储空间。
  • oss2.Bucket类用于上传、下载、删除文件以及对存储空间进行各种配置。

初始化这两个类时,需要指定Endpoint。其中oss2.Service类不支持自定义域名访问。关于Endpoint的更多信息,请参见访问域名和数据中心自定义访问域名

初始化oss2.Service类

具体操作,请参见列举存储空间

初始化oss2.Bucket类

  • 使用OSS域名初始化

    以下代码用于使用OSS域名初始化。

    # -*- coding: utf-8 -*-
    import oss2
    
    # 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。
    auth = oss2.Auth('yourAccessKeyId', 'yourAccessKeySecret')
    
    # yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1(杭州)为例,Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
    endpoint = 'yourEndpoint'
    
    # 填写Bucket名称。
    bucket = oss2.Bucket(auth, endpoint, 'examplebucket')                    
  • 使用自定义域名初始化

    下面的代码用于使用自定义域名初始化:

    # -*- coding: utf-8 -*-
    import oss2
    # 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。
    auth = oss2.Auth('yourAccessKeyId', 'yourAccessKeySecret')
    
    # 自定义域名以my-domain.com为例。
    cname = 'http://my-domain.com'
    
    # 填写Bucket名称,并设置is_cname=True来开启CNAME。CNAME是指将自定义域名绑定到存储空间。
    bucket = oss2.Bucket(auth, cname, 'examplebucket', is_cname=True)                    
  • 设置连接超时时间

    以下代码用于设置连接超时时间:

    # -*- coding: utf-8 -*-
    import oss2
    
    # 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。
    auth = oss2.Auth('yourAccessKeyId', 'yourAccessKeySecret')
    
    # yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1(杭州)为例,Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
    endpoint = 'yourEndpoint'
    
    # 填写Bucket名称,并设置连接超时时间为30秒。
    bucket = oss2.Bucket(auth, endpoint, 'examplebucket', connect_timeout=30)                    
  • 关闭CRC数据校验

    上传和下载文件时默认开启CRC数据校验,确保上传和下载过程的数据完整性。

    警告 强烈建议您不要关闭CRC数据校验功能。如果您关闭此功能,则阿里云不保证上传和下载过程数据的完整性。

    以下代码用于关闭CRC数据校验。

    # -*- coding: utf-8 -*-
    import oss2
    
    # 阿里云账号AccessKey拥有所有API的访问权限,风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维,请登录RAM控制台创建RAM用户。
    auth = oss2.Auth('yourAccessKeyId', 'yourAccessKeySecret')
    
    # yourEndpoint填写Bucket所在地域对应的Endpoint。以华东1(杭州)为例,Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
    endpoint = 'yourEndpoint'
    
    # 填写Bucket名称,并设置enable_crc=False来关闭CRC数据校验。
    bucket = oss2.Bucket(auth, endpoint, 'examplebucket', enable_crc=False)