» alicloud_oss_buckets

This data source provides the OSS buckets of the current Alibaba Cloud user.

» Example Usage

data "alicloud_oss_buckets" "oss_buckets_ds" {
  name_regex = "sample_oss_bucket"
}

output "first_oss_bucket_name" {
  value = "${data.alicloud_oss_buckets.oss_buckets_ds.buckets.0.name}"
}

» Argument Reference

The following arguments are supported:

  • name_regex - (Optional) A regex string to filter results by bucket name.
  • output_file - (Optional) File name where to save data source results (after running terraform plan).

» Attributes Reference

The following attributes are exported in addition to the arguments listed above:

  • names - A list of bucket names.
  • buckets - A list of buckets. Each element contains the following attributes:
    • name - Bucket name.
    • acl - Bucket access control list. Possible values: private, public-read and public-read-write.
    • extranet_endpoint - Internet domain name for accessing the bucket from outside.
    • intranet_endpoint - Intranet domain name for accessing the bucket from an ECS instance in the same region.
    • location - Region of the data center where the bucket is located.
    • owner - Bucket owner.
    • storage_class - Object storage type. Possible values: Standard, IA and Archive.
    • creation_date - Bucket creation date.
    • cors_rules - A list of CORS rule configurations. Each element contains the following attributes:
    • allowed_origins - The origins allowed for cross-domain requests. Multiple elements can be used to specify multiple allowed origins. Each rule allows up to one wildcard "*". If "*" is specified, cross-domain requests of all origins are allowed.
    • allowed_methods - Specify the allowed methods for cross-domain requests. Possible values: GET, PUT, DELETE, POST and HEAD.
    • allowed_headers - Control whether the headers specified by Access-Control-Request-Headers in the OPTIONS prefetch command are allowed. Each header specified by Access-Control-Request-Headers must match a value in AllowedHeader. Each rule allows up to one wildcard “*” .
    • expose_headers - Specify the response headers allowing users to access from an application (for example, a Javascript XMLHttpRequest object). The wildcard "*" is not allowed.
    • max_age_seconds - Specify the cache time for the returned result of a browser prefetch (OPTIONS) request to a specific resource.
    • website - A list of one element containing configuration parameters used when the bucket is used as a website. It contains the following attributes:
    • index_document - Key of the HTML document containing the home page.
    • error_document - Key of the HTML document containing the error page.
    • logging - A list of one element containing configuration parameters used for storing access log information. It contains the following attributes:
    • target_bucket - Bucket for storing access logs.
    • target_prefix - Prefix of the saved access log file paths.
    • referer_config - A list of one element containing referer configuration. It contains the following attributes:
    • allow_empty - Indicate whether the access request referer field can be empty.
    • referers - Referer access whitelist.
    • lifecycle_rule - A list CORS of lifecycle configurations. When Lifecycle is enabled, OSS automatically deletes the objects or transitions the objects (to another storage class) corresponding the lifecycle rules on a regular basis. Each element contains the following attributes:
    • id - Unique ID of the rule.
    • prefix - Prefix applicable to a rule. Only those objects with a matching prefix can be affected by the rule.
    • enabled - Indicate whether the rule is enabled or not.
    • expiration - A list of one element containing expiration attributes of an object. It contains the following attributes:
      • date - Date after which the rule to take effect. The format is like 2017-03-09.
      • days - Indicate the number of days after the last object update until the rules take effect.
    • server_side_encryption_rule - A configuration of default encryption for a bucket. It contains the following attributes:
    • sse_algorithm - The server-side encryption algorithm to use.
    • tags - A mapping of tags.
    • versioning - If present , the versioning state has been set on the bucket. It contains the following attribute.
      • status - A bucket versioning state. Possible values:Enabled and Suspended.