region Property

The region the class will make requests against.

Syntax

def get_region() -> str: ...
def set_region(value: str) -> None: ...

region = property(get_region, set_region)

Default Value

"us-east-1"

Remarks

This property control which region the class will make requests against. By default the class uses us-east-1. This property should be changed to create or access resources in other regions.

Regions:

Important: Each "region" supported by Linode's Object Storage service is actually a completely standalone storage cluster. These clusters do not interact with each other in any way, which causes the following non-standard behaviors:

• Bucket names may be reused in each region (however, they must still be "globally" unique within each region).
• The list_buckets method will only return buckets located in the currently-selected region; there is no way to retrieve a list of all regions' buckets.
• Similarly, the bucket_exists and get_bucket_location methods only consider buckets located in the currently-selected region.
• The copy_object method cannot be used to copy objects to a bucket in another region.

The class will always convert this property's value to lowercase. If this property is cleared, the class will reset it to the default value.