Documentação do Oracle Cloud Infrastructure

Atualizando um Bucket para Suportar URLs de Estilo Hospedados Virtual

Atualize um bucket para suportar URLs de estilo hospedado virtual.

Por padrão, o escopo do bucket é definido como o namespace da tenancy. Se os buckets atenderem aos seguintes critérios, eles poderão ser atualizados para um escopo de região que suporte URLs de estilo hospedado virtual:

  • O nome do bucket é exclusivo em todos os tenants da região.
  • Os nomes de bucket devem conter apenas letras minúsculas, números e hifens.
  • Os nomes de bucket não podem começar com um caractere de hífen e não podem conter caracteres de hífen consecutivos.
  • Os nomes de bucket devem ter no mínimo 3 e no máximo 63 caracteres.
  • O nome do bucket atua como um subdomínio; portanto, ele também deve seguir as regras de nomenclatura DNS padrão.

O escopo do bucket não poderá ser atualizado se o nome do bucket já estiver em uso na mesma região, não atender aos requisitos de caracteres ou não seguir as regras de nomenclatura do DNS.

    1. Na página de lista Buckets, localize o bucket do serviço Object Storage com o qual você deseja trabalhar. Para obter mais informações sobre a página listando buckets, consulte Listando Buckets do Serviço Object Storage.
      A página da lista Buckets é aberta. Todos os buckets do compartimento selecionado são exibidos em uma tabela.
    2. No menu Ações ao lado do bucket relevante, selecione Editar Escopo do Bucket.
      O painel Editar Escopos é aberto.
    3. Selecione REGIÃO.
    4. Selecione Atualizar.
      Observação

      Depois que o escopo do bucket for definido, uma atualização só poderá ser feita para alterar o escopo de NAMESPACE para REGION. O escopo do bucket não pode ser alterado de REGIÃO para NAMESPACE.

  • Use o comando oci os bucket update. Inclua o parâmetro public-access-type:

    oci os bucket update --name bucket-name  --bucket-scope REGION

    Por padrão, o escopo do bucket é namespace. Você pode especificar o parâmetro de escopo do bucket e um de seus valores suportados:

    • NAMESPACE: Permite apenas acesso no estilo de caminho ao bucket.
    • REGIÃO: Permite o acesso do URL de estilo de caminho e de estilo hospedado virtual ao bucket.
    Observação

    Depois que o escopo do bucket for definido, uma atualização só poderá ser feita para alterar o escopo de NAMESPACE para REGION. O escopo do bucket não pode ser alterado de REGIÃO para NAMESPACE.

    Por exemplo:

    oci os bucket update --name my-bucket  --bucket-scope REGION 
{
  "data": {
    "acl-group-id": null,
    "approximate-count": null,
    "approximate-size": null,
    "auto-tiering": "Disabled",
    "bucket-scope": "REGION",
    "compartment-id": "ocid1.compartment.oc1..exampleuniqueID",
    "created-by": "ocid1.user.oc1..exampleuniqueID",
    "defined-tags": {},
    "etag": "20449088-c034-4960-8291-5147c0d6f04f",
    "freeform-tags": {},
    "id": "ocid1.bucket.oc1..exampleuniqueID",
    "is-read-only": false,
    "kms-key-id": null,
    "metadata": {},
    "name": "my-bucket",
    "namespace": "MyNamespace",
    "object-events-enabled": false,
    "object-level-audit-mode": "Disabled",
    "object-lifecycle-policy-etag": null,
    "public-access-type": "NoPublicAccess",
    "replication-enabled": false,
    "storage-tier": "Standard",
    "time-created": "2026-03-17T18:26:52.359000+00:00",
    "versioning": "Disabled"
  },
  "etag": "20449088-c034-4960-8291-5147c0d6f04f"
}

    Para ver uma lista completa de parâmetros e valores para comandos CLI, consulte a Referência de Comando CLI.

  • Esta tarefa não pode ser executada com a API.