alicloud_oss_bucket_cname

Provides a OSS Bucket Cname resource.

Customizing Bucket domains.

For information about OSS Bucket Cname and how to use it, see What is Bucket Cname.

-> NOTE: Available since v1.233.0.

Example Usage

Basic Usage

variable "name" {
  default = "terraform-example"
}

provider "alicloud" {
  region = "cn-hangzhou"
}

resource "alicloud_oss_bucket" "CreateBucket" {
  bucket        = var.name
  storage_class = "Standard"
}

resource "alicloud_oss_bucket_cname_token" "defaultZaWJfG" {
  bucket = alicloud_oss_bucket.CreateBucket.bucket
  domain = "tftestacc.com"
}

resource "alicloud_alidns_record" "defaultnHqm5p" {
  status      = "ENABLE"
  line        = "default"
  rr          = "_dnsauth"
  type        = "TXT"
  domain_name = "tftestacc.com"
  priority    = "1"
  value       = alicloud_oss_bucket_cname_token.defaultZaWJfG.token
  ttl         = "600"
  lifecycle {
    ignore_changes = [
      value,
    ]
  }
}

resource "alicloud_oss_bucket_cname" "default" {
  bucket = alicloud_oss_bucket.CreateBucket.bucket
  domain = alicloud_alidns_record.defaultnHqm5p.domain_name
}

Argument Reference

The following arguments are supported:

• bucket - (Required, ForceNew) The bucket to which the custom domain name belongs
• certificate - (Optional, List) The container for the certificate configuration. See certificate below.
• delete_certificate - (Optional) Whether to delete the certificate.
• domain - (Required, ForceNew) User-defined domain name
• force - (Optional) Whether to force overwrite certificate.
• previous_cert_id - (Optional) The current certificate ID. If the Force value is not true, the OSS Server checks whether the value matches the current certificate ID. If the value does not match, an error is reported.

certificate

The certificate supports the following:

• cert_id - (Optional, Computed) Certificate Identifier
• certificate - (Optional) The certificate public key.
• private_key - (Optional) The certificate private key.

Attributes Reference

The following attributes are exported:

• id - The ID of the resource supplied above.The value is formulated as <bucket>:<domain>.
• certificate - The container for the certificate configuration.
  • creation_date - Certificate creation time
  • fingerprint - Certificate Fingerprint
  • status - Certificate Status
  • type - Certificate Type
  • valid_end_date - Certificate validity period end time
  • valid_start_date - Certificate validity period start time
• status - Cname status

Timeouts

The timeouts block allows you to specify timeouts for certain actions:

• create - (Defaults to 5 mins) Used when create the Bucket Cname.
• delete - (Defaults to 5 mins) Used when delete the Bucket Cname.
• update - (Defaults to 5 mins) Used when update the Bucket Cname.

Import

OSS Bucket Cname can be imported using the id, e.g.

$ terraform import alicloud_oss_bucket_cname.example <bucket>:<domain>