Create Objects

Create objects in an S3 bucket.

Source code • Permissions

The body of an object can be a file path or inline data.

Usage

Input

Parameter	Description	Type	Required	Default value
bucket	Name of the S3 bucket to create objects in	string	Yes	None
object	Object to create. Repeat for multiple objects. Format: key body	string	Yes	None
prefix	Prefix to filter objects by	string	No	None
region	Region for operation	string	No	Session default
debug	Increase log verbosity	bool	No	False
silent	Decrease log verbosity	bool	No	False
output	Output format table	string	No	None
session	Established session	object	No	None

Output

Returns a list of objects that failed the creation:

['object1', 'object2']

Examples

Create examples/object1 and examples/object2 in example-bucket:

aaws s3 create_objects --bucket example-bucket --object examples/object1 /path/to/file --object examples/object2 "inline data"

Input

Parameter	Description	Type	Required	Default value
bucket	Name of the S3 bucket to create objects in	string	Yes	None
objects	Objects to create. Format: [{"Key":"example", "Body": "data"}]	list(dict)	Yes	None
prefix	Prefix to filter objects by	string	No	None
region	Region for operation	string	No	Session default
debug	Log verbosity	bool	No	False
session	Established session	object	No	None

Output

Returns a list of objects that failed the creation:

['object1', 'object2']

Examples

Create examples/object1 and examples/object2 in example-bucket:

from avtomat_aws import s3

response = s3.create_objects(bucket='example-bucket',
                             objects=[{"Key": "examples/object1", "Body": "/path/to/file"},
                                      {"Key": "examples/object2", "Body": "inline data"}])