Amazon Simple Storage Service

2016/04/18 - Amazon Simple Storage Service - 2 new 1 updated api methods

PutBucketAccelerateConfiguration (new) Link ¶

Sets the accelerate configuration of an existing bucket.

Request Syntax

client.put_bucket_accelerate_configuration(
    Bucket='string',
    AccelerateConfiguration={
        'Status': 'Enabled'|'Suspended'
    }
)
type Bucket

string

param Bucket

[REQUIRED] Name of the bucket for which the accelerate configuration is set.

type AccelerateConfiguration

dict

param AccelerateConfiguration

[REQUIRED] Specifies the Accelerate Configuration you want to set for the bucket.

  • Status (string) -- The accelerate configuration of the bucket.

returns

None

GetBucketAccelerateConfiguration (new) Link ¶

Returns the accelerate configuration of a bucket.

Request Syntax

client.get_bucket_accelerate_configuration(
    Bucket='string'
)
type Bucket

string

param Bucket

[REQUIRED] Name of the bucket for which the accelerate configuration is retrieved.

rtype

dict

returns

Response Syntax

{
    'Status': 'Enabled'|'Suspended'
}

Response Structure

  • (dict) --

    • Status (string) -- The accelerate configuration of the bucket.

PutObjectAcl (updated) Link ¶
Changes (request)
{'VersionId': 'string'}

uses the acl subresource to set the access control list (ACL) permissions for an object that already exists in a bucket

Request Syntax

client.put_object_acl(
    ACL='private'|'public-read'|'public-read-write'|'authenticated-read'|'aws-exec-read'|'bucket-owner-read'|'bucket-owner-full-control',
    AccessControlPolicy={
        'Grants': [
            {
                'Grantee': {
                    'DisplayName': 'string',
                    'EmailAddress': 'string',
                    'ID': 'string',
                    'Type': 'CanonicalUser'|'AmazonCustomerByEmail'|'Group',
                    'URI': 'string'
                },
                'Permission': 'FULL_CONTROL'|'WRITE'|'WRITE_ACP'|'READ'|'READ_ACP'
            },
        ],
        'Owner': {
            'DisplayName': 'string',
            'ID': 'string'
        }
    },
    Bucket='string',
    ContentMD5='string',
    GrantFullControl='string',
    GrantRead='string',
    GrantReadACP='string',
    GrantWrite='string',
    GrantWriteACP='string',
    Key='string',
    RequestPayer='requester',
    VersionId='string'
)
type ACL

string

param ACL

The canned ACL to apply to the object.

type AccessControlPolicy

dict

param AccessControlPolicy
  • Grants (list) -- A list of grants.

    • (dict) --

      • Grantee (dict) --

        • DisplayName (string) -- Screen name of the grantee.

        • EmailAddress (string) -- Email address of the grantee.

        • ID (string) -- The canonical user ID of the grantee.

        • Type (string) -- [REQUIRED] Type of grantee

        • URI (string) -- URI of the grantee group.

      • Permission (string) -- Specifies the permission given to the grantee.

  • Owner (dict) --

    • DisplayName (string) --

    • ID (string) --

type Bucket

string

param Bucket

[REQUIRED]

type ContentMD5

string

param ContentMD5

type GrantFullControl

string

param GrantFullControl

Allows grantee the read, write, read ACP, and write ACP permissions on the bucket.

type GrantRead

string

param GrantRead

Allows grantee to list the objects in the bucket.

type GrantReadACP

string

param GrantReadACP

Allows grantee to read the bucket ACL.

type GrantWrite

string

param GrantWrite

Allows grantee to create, overwrite, and delete any object in the bucket.

type GrantWriteACP

string

param GrantWriteACP

Allows grantee to write the ACL for the applicable bucket.

type Key

string

param Key

[REQUIRED]

type RequestPayer

string

param RequestPayer

Confirms that the requester knows that she or he will be charged for the request. Bucket owners need not specify this parameter in their requests. Documentation on downloading objects from requester pays buckets can be found at http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html

type VersionId

string

param VersionId

VersionId used to reference a specific version of the object.

rtype

dict

returns

Response Syntax

{
    'RequestCharged': 'requester'
}

Response Structure

  • (dict) --

    • RequestCharged (string) -- If present, indicates that the requester was successfully charged for the request.