快速入门

python -m pip install .

# -*- coding: utf-8 -*-
import inspect
from qcloud_cos import CosConfig, CosS3Client

get_args = getattr(inspect, 'getfullargspec', None) or inspect.getargspec
checks = (
    (CosConfig.__init__, ('EnableRapidDomain',)),
    (CosS3Client.create_bucket, ('VpcId', 'SubnetId', 'Zone')),
)
for method, required in checks:
    if not set(required).issubset(get_args(method).args):
        raise RuntimeError('SDK 与高性能桶测试交付版本不匹配')
for name in ('create_session', 'rename_object'):
    if not hasattr(CosS3Client, name):
        raise RuntimeError('SDK 缺少高性能桶接口：' + name)
print('Rapid SDK API check OK')

# -*- coding=utf-8 -*-
import os
from qcloud_cos import CosConfig, CosS3Client

secret_id = os.environ['COS_SECRET_ID']
secret_key = os.environ['COS_SECRET_KEY']
region = 'ap-guangzhou'

# 高性能桶经 VPC 内网 HTTP 80 端口接入，SDK 的网关 DNS 负载均衡也仅对 HTTP 请求生效；SDK 默认 https，此处需显式指定 http。
config = CosConfig(
    Scheme='http',
    Region=region,
    SecretId=secret_id,
    SecretKey=secret_key,
    Token=os.environ.get('COS_SECURITY_TOKEN'),
    EnableRapidDomain=True)
client = CosS3Client(config)

# 高性能桶完整名称，形如 <BucketName>-x--<APPID>。
bucket = 'examplebucket-x--1250000000'

# -*- coding=utf-8 -*-
import os
from qcloud_cos import CosConfig, CosS3Client

# 高性能桶经 VPC 内网 HTTP 80 端口接入，SDK 的网关 DNS 负载均衡也仅对 HTTP 请求生效；SDK 默认 https，此处需显式指定 http。
config = CosConfig(
    Scheme='http',
    Region='ap-guangzhou',
    SecretId=os.environ['COS_SECRET_ID'],
    SecretKey=os.environ['COS_SECRET_KEY'],
    Token=os.environ.get('COS_SECURITY_TOKEN'),
    EnableRapidDomain=True)
client = CosS3Client(config)

bucket = 'examplebucket-x--1250000000'
key = 'quickstart/hello.txt'

# 上传对象。首次对高性能桶发起请求时，SDK 会自动创建 session 并签名。
client.put_object(Bucket=bucket, Key=key, Body=b'hello rapid bucket')
print('PutObject OK')

# 下载对象。
resp = client.get_object(Bucket=bucket, Key=key)
body = resp['Body'].get_raw_stream().read()
print('GetObject OK: %s' % body)