Overview

The Python SDK provides examples for getting request signatures, pre-signed URLs, and pre-signed download URLs. The method for getting a pre-signed URL is the same whether you are using permanent or temporary keys, with the only difference being that the latter requires x-cos-security-token included in the header or query_string.

Getting Signatures

Description

The SDK allows you to obtain a signature for a specified operation. This feature is commonly used for signature distribution to mobile devices.

Method prototype

get_auth(Method, Bucket, Key, Expired=300, Headers={}, Params={})

Upload request sample

response = client.get_auth(
    Method='PUT',
    Bucket='examplebucket-1250000000',
    Key='exampleobject'
)

Download request sample

response = client.get_auth(
    Method='GET',
    Bucket='examplebucket-1250000000',
    Key='exampleobject'
)

Sample request with all parameters

response = client.get_auth(
    Method='PUT'|'POST'|'GET'|'DELETE'|'HEAD',
    Bucket='examplebucket-1250000000',
    Key='exampleobject',
    Expired=300,
    Headers={
        'Content-Length': 'string',
        'Content-MD5': 'string'
    },
    Params={
        'param1': 'string',
        'param2': 'string'
    }
)

Parameter description

Response description

The signature value for the corresponding operation is returned upon success.

Getting Pre-Signed URLs

Description

The SDK allows you to get a pre-signed URL that can be used for distribution purposes.

Upload request sample

response = client.get_presigned_url(
    Method='PUT',
    Bucket='examplebucket-1250000000',
    Key='exampleobject'
)

Download request sample

response = client.get_presigned_url(
    Method='GET',
    Bucket='examplebucket-1250000000',
    Key='exampleobject'
)

Method prototype

get_presigned_url(Bucket, Key, Method, Expired=300, Params={}, Headers={})

Sample request

response = client.get_presigned_url(
    Bucket='examplebucket-1250000000',
    Key='exampleobject',
    Method='PUT'|'POST'|'GET'|'DELETE'|'HEAD',
    Expired=300,
    Headers={
        'Content-Length': 'string',
        'Content-MD5': 'string'
    },
    Params={
        'param1': 'string',
        'param2': 'string'
    }
)

Parameter description

Response description

A pre-signed URL is returned upon success.

Getting Pre-Signed Download URLs

Description

The SDK allows you to get a pre-signed download URL that can be used to directly download an object.

Method prototype

get_presigned_download_url(Bucket, Key, Expired=300, Params={}, Headers={})

Sample request

response = client.get_presigned_download_url(
    Bucket='examplebucket-1250000000',
    Key='exampleobject',
    Expired=300,
    Headers={
        'Content-Length': 'string',
        'Content-MD5': 'string'
    },
    Params={
        'param1': 'string',
        'param2': 'string'
    }
)

Parameter description

Response description

A pre-signed download URL is returned upon success.