Todos os produtos
Search
Central de documentação

Object Storage Service:Create a bucket with Terraform

Última atualização: Jul 05, 2026

O Terraform é uma ferramenta de código aberto para gerenciar recursos de nuvem como código. Crie e configure um bucket do OSS usando o Terraform.

Nota

Execute o código de exemplo deste tutorial com um único clique em. Executar agora

Pré-requisitos

Nota

Alguns recursos deste tutorial podem gerar custos. Libere-os quando não forem mais necessários.

Recursos utilizados

Crie um bucket

  1. Crie um diretório e um arquivo main.tf. Adicione o código a seguir ao arquivo main.tf.

    variable "region"{
      default = "cn-beijing"
    }
    
    provider "alicloud"{
      region = var.region
    }
    
    resource "random_uuid" "default" {
    }
    
    # Create a bucket.
    resource "alicloud_oss_bucket" "bucket" {
      bucket = substr("tf-example-${replace(random_uuid.default.result, "-", "")}", 0, 16)
    }
    
    # Set the access control for the bucket.
    resource "alicloud_oss_bucket_acl" "bucket-ac"{
      bucket = alicloud_oss_bucket.bucket.id
      acl = "private"
    }
    
  2. Inicialize o ambiente do Terraform.

    terraform init

    Saída esperada em caso de sucesso:

    Terraform has been successfully initialized!
    
    You may now begin working with Terraform. Try running "terraform plan" to see
    any changes that are required for your infrastructure. All Terraform commands
    should now work.
    
    If you ever set or change modules or backend configuration for Terraform,
    rerun this command to reinitialize your working directory. If you forget, other
    commands will detect it and remind you to do so if necessary.
  3. Aplique a configuração.

    terraform apply

    Insira yes quando solicitado e pressione Enter. Saída esperada em caso de sucesso:

    You can apply this plan to save these new output values to the Terraform state, without changing any real infrastructure.
    
    Do you want to perform these actions?
      Terraform will perform the actions described above.
      Only 'yes' will be accepted to approve.
    
      Enter a value: yes
    
    Apply complete! Resources: 3 added, 0 changed, 0 destroyed.
  4. Verifique os resultados.

    Terraform show

    Execute o comando a seguir para visualizar os recursos criados:

    terraform show

    image

    Console

    1. Faça login no console do OSS e clique em Buckets para visualizar seu bucket.

      image

    2. Clique em no seu Bucket Name e acesse Permission Control > ACL para verificar a ACL.

      image

Limpeza de recursos

Execute o comando a seguir para liberar recursos que não são mais necessários (Comandos comuns).

terraform destroy

Exemplo completo

Nota

Execute o código de exemplo deste tutorial com um único clique em. Executar agora

Código de exemplo

variable "region"{
  default = "cn-beijing"
}

provider "alicloud"{
  region = var.region
}

resource "random_uuid" "default" {
}

# Create a bucket.
resource "alicloud_oss_bucket" "bucket" {
  bucket = substr("tf-example-${replace(random_uuid.default.result, "-", "")}", 0, 16)
}

# Set the access control for the bucket.
resource "alicloud_oss_bucket_acl" "bucket-ac"{
  bucket = alicloud_oss_bucket.bucket.id
  acl = "private"
}

Explore exemplos específicos do produto em Mais exemplos completos.