Documentação do Oracle Cloud Infrastructure

Suporte ao Estilo Hospedado da API de Compatibilidade com Amazon S3 no Object Storage

Saiba como a API de Compatibilidade com Amazon S3 do Object Storage suporta URLs de estilo hospedado virtual da AWS.

A Oracle Cloud Infrastructure (OCI) agora suporta as seguintes maneiras de tratar objetos:

  • Estilo de caminho: Os URLs têm o seguinte formato:
    https://<namespace>.compat.objectstorage.<region>.oci.customer-oci.com/<bucket_name>/<object_name>
  • Estilo virtual hospedado: Os URLs têm o seguinte formato:
    https://<bucket_name>.vhcompat.objectstorage.<region>.oci.customer-oci.com/<object_name>

    Aqui, o nome do bucket faz parte do nome do domínio no URL e somente <object_name> faz parte do caminho.

    Observação

    Somente os buckets criados com os pontos finais de estilo hospedado virtual podem usar URLs de estilo hospedado virtual. Crie esses buckets com APIs e SDKs do S3. Não é possível usar a CLI ou a Console do OCI para criar buckets de estilo hospedados virtuais com os pontos finais de estilo hospedados virtuais.

Anteriormente, a API de Compatibilidade com Amazon S3 do serviço Object Storage só oferecia suporte ao estilo de caminho usando o seguinte formato:

https://<namespace>.compat.objectstorage.<region>.oci.customer-oci.com/<bucket_name>/<object_name>

em que <namespace> representa o namespace do serviço Object Storage que serve como o contêiner de nível superior para todos os buckets e objetos.

Quando sua conta do OCI é criada, cada tenant do OCI recebe um nome de namespace exclusivo do Object Storage imutável e gerado pelo sistema. O namespace abrange todos os compartimentos em todas as regiões. Os nomes de bucket devem ser exclusivos em um namespace. Embora o namespace seja específico da região, o próprio nome do namespace é o mesmo em todas as regiões.

O OCI adicionou suporte para acesso ao estilo hospedado virtual, permitindo que você inclua o nome do bucket como parte do subdomínio no URL. Você pode usar URLs de estilo hospedado virtual com o novo ponto final ao acessar o Object Storage com o AWS SDK:

https://<bucket_name>.vhcompat.objectstorage.<region>.oci.customer-oci.com/<object_name>
Observação

Ao usar URLs de estilo hospedado virtual com o OCI, o nome do bucket deve ser exclusivo em todos os tenants da mesma região.

Considere o seguinte para entender o comportamento dos buckets:

  • Os buckets criados com o URL de estilo hospedado virtual têm a garantia de serem exclusivos em todos os tenants da região.
  • Não é possível criar um bucket com um nome que já esteja em uso na mesma região usando o URL de estilo hospedado virtual.
  • Se você tiver buckets existentes criados com o URL de estilo de caminho, eles não poderão ser acessados por meio do URL de estilo hospedado virtual.
  • Você ainda pode usar o URL no estilo de caminho para acessar os buckets existentes, pois o suporte ao acesso no estilo de caminho continuará.

A tabela a seguir mostra o acesso ao bucket:

Acesso à API Nativa S3 Acesso ao Estilo de Caminho S3 Acesso ao Estilo Hospedado Virtual
Buckets Criados Usando a API Nativa do OCI ✓ ✓
Buckets Criados Usando a API de estilo de Caminho S3 do OCI ✓ ✓
Buckets Criados Usando a API de Estilo Virtual S3 do OCI ✓ ✓ ✓
Observação

Nesta versão, somente novos buckets criados usando o URL de estilo hospedado virtual suportarão acesso de estilo hospedado virtual.

Acessando Recursos do Serviço Object Storage entre Tenancies

Ao trabalhar com suporte ao estilo hospedado virtual com a API de Compatibilidade com Amazon S3, para acessar e compartilhar recursos com outra organização que tenha sua própria tenancy, todas as APIs de objetos, upload em várias partes e tags são suportadas para acesso entre tenancies. As APIs de bucket, no entanto, estão limitadas às seguintes operações:

Observação

O PutBucket, que cria um bucket, não é suportado para operações entre tenancies com suporte ao estilo hospedado virtual com a API S3 do OCI.

Para obter mais informações sobre como acessar recursos do serviço Object Storage entre tenancies, consulte Acessando Recursos do Serviço Object Storage entre Tenancies.