objectstorage

class pulumi_openstack.objectstorage.Container(resource_name, opts=None, container_read=None, container_sync_key=None, container_sync_to=None, container_write=None, content_type=None, force_destroy=None, metadata=None, name=None, region=None, versioning=None, __name__=None, __opts__=None)

Manages a V1 container resource within OpenStack.

Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • container_read (pulumi.Input[str]) – Sets an access control list (ACL) that grants read access. This header can contain a comma-delimited list of users that can read the container (allows the GET method for all objects in the container). Changing this updates the access control list read access.
  • container_sync_key (pulumi.Input[str]) – The secret key for container synchronization. Changing this updates container synchronization.
  • container_sync_to (pulumi.Input[str]) – The destination for container synchronization. Changing this updates container synchronization.
  • container_write (pulumi.Input[str]) – Sets an ACL that grants write access. Changing this updates the access control list write access.
  • content_type (pulumi.Input[str]) – The MIME type for the container. Changing this updates the MIME type.
  • force_destroy (pulumi.Input[bool]) – A boolean that indicates all objects should be deleted from the container so that the container can be destroyed without error. These objects are not recoverable.
  • metadata (pulumi.Input[dict]) – Custom key/value pairs to associate with the container. Changing this updates the existing container metadata.
  • name (pulumi.Input[str]) – A unique name for the container. Changing this creates a new container.
  • region (pulumi.Input[str]) – The region in which to create the container. If omitted, the region argument of the provider is used. Changing this creates a new container.
  • versioning (pulumi.Input[dict]) – Enable object versioning. The structure is described below.
container_read = None

Sets an access control list (ACL) that grants read access. This header can contain a comma-delimited list of users that can read the container (allows the GET method for all objects in the container). Changing this updates the access control list read access.

container_sync_key = None

The secret key for container synchronization. Changing this updates container synchronization.

container_sync_to = None

The destination for container synchronization. Changing this updates container synchronization.

container_write = None

Sets an ACL that grants write access. Changing this updates the access control list write access.

content_type = None

The MIME type for the container. Changing this updates the MIME type.

force_destroy = None

A boolean that indicates all objects should be deleted from the container so that the container can be destroyed without error. These objects are not recoverable.

metadata = None

Custom key/value pairs to associate with the container. Changing this updates the existing container metadata.

name = None

A unique name for the container. Changing this creates a new container.

region = None

The region in which to create the container. If omitted, the region argument of the provider is used. Changing this creates a new container.

versioning = None

Enable object versioning. The structure is described below.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
class pulumi_openstack.objectstorage.ContainerObject(resource_name, opts=None, container_name=None, content=None, content_disposition=None, content_encoding=None, content_type=None, copy_from=None, delete_after=None, delete_at=None, detect_content_type=None, etag=None, metadata=None, name=None, object_manifest=None, region=None, source=None, __name__=None, __opts__=None)

Manages a V1 container object resource within OpenStack.

Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • container_name (pulumi.Input[str]) – A unique (within an account) name for the container. The container name must be from 1 to 256 characters long and can start with any character and contain any pattern. Character set must be UTF-8. The container name cannot contain a slash (/) character because this character delimits the container and object name. For example, the path /v1/account/www/pages specifies the www container, not the www/pages container.
  • content (pulumi.Input[str]) – A string representing the content of the object. Conflicts with source and copy_from.
  • content_disposition (pulumi.Input[str]) – A string which specifies the override behavior for the browser. For example, this header might specify that the browser use a download program to save this file rather than show the file, which is the default.
  • content_encoding (pulumi.Input[str]) – A string representing the value of the Content-Encoding metadata.
  • content_type (pulumi.Input[str]) – A string which sets the MIME type for the object.
  • copy_from (pulumi.Input[str]) – A string representing the name of an object used to create the new object by copying the copy_from object. The value is in form {container}/{object}. You must UTF-8-encode and then URL-encode the names of the container and object before you include them in the header. Conflicts with source and content.
  • delete_after (pulumi.Input[int]) – An integer representing the number of seconds after which the system removes the object. Internally, the Object Storage system stores this value in the X-Delete-At metadata item.
  • delete_at (pulumi.Input[str]) – An string representing the date when the system removes the object. For example, “2015-08-26” is equivalent to Mon, Wed, 26 Aug 2015 00:00:00 GMT.
  • detect_content_type (pulumi.Input[bool]) – If set to true, Object Storage guesses the content type based on the file extension and ignores the value sent in the Content-Type header, if present.
  • etag (pulumi.Input[str]) – Used to trigger updates. The only meaningful value is ${md5(file(“path/to/file”))}.

:param pulumi.Input[dict] metadata :param pulumi.Input[str] name: A unique name for the object. :param pulumi.Input[str] object_manifest: A string set to specify that this is a dynamic large

object manifest object. The value is the container and object name prefix of the segment objects in the form container/prefix. You must UTF-8-encode and then URL-encode the names of the container and prefix before you include them in this header.
Parameters:
  • region (pulumi.Input[str]) – The region in which to create the container. If omitted, the region argument of the provider is used. Changing this creates a new container.
  • source (pulumi.Input[str]) – A string representing the local path of a file which will be used as the object’s content. Conflicts with source and copy_from.
container_name = None

A unique (within an account) name for the container. The container name must be from 1 to 256 characters long and can start with any character and contain any pattern. Character set must be UTF-8. The container name cannot contain a slash (/) character because this character delimits the container and object name. For example, the path /v1/account/www/pages specifies the www container, not the www/pages container.

content = None

A string representing the content of the object. Conflicts with source and copy_from.

content_disposition = None

A string which specifies the override behavior for the browser. For example, this header might specify that the browser use a download program to save this file rather than show the file, which is the default.

content_encoding = None

A string representing the value of the Content-Encoding metadata.

content_length = None

If the operation succeeds, this value is zero (0) or the length of informational or error text in the response body.

content_type = None

A string which sets the MIME type for the object.

copy_from = None

A string representing the name of an object used to create the new object by copying the copy_from object. The value is in form {container}/{object}. You must UTF-8-encode and then URL-encode the names of the container and object before you include them in the header. Conflicts with source and content.

date = None

The date and time the system responded to the request, using the preferred format of RFC 7231 as shown in this example Thu, 16 Jun 2016 15:10:38 GMT. The time is always in UTC.

delete_after = None

An integer representing the number of seconds after which the system removes the object. Internally, the Object Storage system stores this value in the X-Delete-At metadata item.

delete_at = None

An string representing the date when the system removes the object. For example, “2015-08-26” is equivalent to Mon, Wed, 26 Aug 2015 00:00:00 GMT.

detect_content_type = None

If set to true, Object Storage guesses the content type based on the file extension and ignores the value sent in the Content-Type header, if present.

etag = None

Used to trigger updates. The only meaningful value is ${md5(file(“path/to/file”))}.

last_modified = None

The date and time when the object was last modified. The date and time stamp format is ISO 8601: CCYY-MM-DDThh:mm:ss±hh:mm For example, 2015-08-27T09:49:58-05:00. The ±hh:mm value, if included, is the time zone as an offset from UTC. In the previous example, the offset value is -05:00.

name = None

A unique name for the object.

object_manifest = None

A string set to specify that this is a dynamic large object manifest object. The value is the container and object name prefix of the segment objects in the form container/prefix. You must UTF-8-encode and then URL-encode the names of the container and prefix before you include them in this header.

region = None

The region in which to create the container. If omitted, the region argument of the provider is used. Changing this creates a new container.

source = None

A string representing the local path of a file which will be used as the object’s content. Conflicts with source and copy_from.

trans_id = None

A unique transaction ID for this request. Your service provider might need this value if you report a problem.

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
class pulumi_openstack.objectstorage.TempUrl(resource_name, opts=None, container=None, method=None, object=None, regenerate=None, region=None, split=None, ttl=None, __name__=None, __opts__=None)

Use this resource to generate an OpenStack Object Storage temporary URL.

The temporary URL will be valid for as long as TTL is set to (in seconds). Once the URL has expired, it will no longer be valid, but the resource will remain in place. If you wish to automatically regenerate a URL, set the regenerate argument to true. This will create a new resource with a new ID and URL.

Parameters:
  • resource_name (str) – The name of the resource.
  • opts (pulumi.ResourceOptions) – Options for the resource.
  • container (pulumi.Input[str]) – The container name the object belongs to.
  • method (pulumi.Input[str]) – The method allowed when accessing this URL. Valid values are GET, and POST. Default is GET.
  • object (pulumi.Input[str]) – The object name the tempurl is for.
  • regenerate (pulumi.Input[bool]) – Whether to automatically regenerate the URL when it has expired. If set to true, this will create a new resource with a new ID and new URL. Defaults to false.
  • region (pulumi.Input[str]) – The region the tempurl is located in.

:param pulumi.Input[str] split :param pulumi.Input[int] ttl: The TTL, in seconds, for the URL. For how long it should

be valid.
container = None

The container name the object belongs to.

method = None

The method allowed when accessing this URL. Valid values are GET, and POST. Default is GET.

object = None

The object name the tempurl is for.

regenerate = None

Whether to automatically regenerate the URL when it has expired. If set to true, this will create a new resource with a new ID and new URL. Defaults to false.

region = None

The region the tempurl is located in.

ttl = None

The TTL, in seconds, for the URL. For how long it should be valid.

url = None

The URL

translate_output_property(prop)

Provides subclasses of Resource an opportunity to translate names of output properties into a format of their choosing before writing those properties to the resource object.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str
translate_input_property(prop)

Provides subclasses of Resource an opportunity to translate names of input properties into a format of their choosing before sending those properties to the Pulumi engine.

Parameters:prop (str) – A property name.
Returns:A potentially transformed property name.
Return type:str