Trabalhando com o contêiner raiz

Artigo
06/27/2023

Um contêiner raiz funciona como um contêiner padrão para sua conta de armazenamento. Uma conta de armazenamento pode ter um contêiner raiz. O contêiner raiz deve ser explicitamente criado e deve ser chamado de $root.

Um blob armazenado no contêiner raiz pode ser resolvido sem referência ao nome do contêiner raiz, de modo que um blob pode ser resolvido no nível superior da hierarquia da conta de armazenamento. Por exemplo, faça referência a um blob que resida no contêiner raiz da seguinte maneira:

https://myaccount.blob.core.windows.net/mywebpage.html

Gerenciando o contêiner raiz

Para usar o contêiner raiz com sua conta de armazenamento, crie um novo contêiner denominado $root. A solicitação de exemplo a seguir mostra como criar o contêiner raiz:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/$root?restype=container HTTP/1.1  
  
Request Headers:  
x-ms-version: 2011-08-18  
x-ms-date: Sun, 25 Sep 2011 22:50:32 GMT  
x-ms-meta-Name: StorageSample  
x-ms-blob-public-access: container  
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

Você também pode excluir o contêiner raiz se ele não for mais necessário.

Assim como outros contêineres, o contêiner raiz pode ser disponibilizado para acesso público anônimo. Você pode tornar o contêiner público definindo o x-ms-blob-public-access cabeçalho quando o contêiner é criado ou chamando Definir ACL de Contêiner depois que ele já existir. Consulte Restringir o acesso aos contêineres e Blobs (a página pode estar em inglês) para obter mais informações.

Se o contêiner raiz estiver presente, ele aparecerá quando você executar a operação Listar Contêineres na conta de armazenamento.

Quando você executa uma operação de Blobs de Lista no contêiner raiz, o contêiner raiz não aparece nas URLs de recurso para os blobs retornados. A sintaxe de solicitação a seguir mostra como chamar List Blobs no contêiner raiz:

GET https://myaccount.blob.core.windows.net/$root?restype=container&comp=list HTTP/1.1

Importante

Um blob no contêiner raiz não pode incluir uma barra (/) no nome.

Exemplos

Os exemplos a seguir mostram como trabalhar com os recursos do contêiner e blob, incluindo o contêiner raiz:

Operações GET

Para listar os contêineres em uma conta de armazenamento:

GET https://myaccount.blob.core.windows.net/?comp=list

Para obter as propriedades de um contêiner:

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container

Para listar os blobs em um contêiner denominado mycontainer:

GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list

Para listar os blobs no contêiner raiz:

GET https://myaccount.blob.core.windows.net/$root?restype=container&comp=list

Para ler um blob denominado myfile de um contêiner denominado mycontainer:

GET https://myaccount.blob.core.windows.net/mycontainer/myfile

Para ler um blob denominado myphoto do contêiner raiz:

GET https://myaccount.blob.core.windows.net/myphoto

Você também pode fazer referência explicitamente ao contêiner raiz:

GET https://myaccount.blob.core.windows.net/$root/myphoto

Para ler os metadados de blob em um blob no contêiner raiz:

GET https://myaccount.blob.core.windows.net/myphoto?comp=metadata

Você também pode fazer referência explicitamente ao contêiner raiz:

GET https://myaccount.blob.core.windows.net/$root/myphoto?comp=metadata

Observação

Evite incluir uma barra (/) ao fazer referência a um blob no contêiner raiz. Por exemplo, um URL como a mostrado a seguir agora resulta no código de status 400 (Solicitação Incorreta):

https://myaccount.blob.core.windows.net/myblob/

No exemplo anterior, o serviço Blob lê o nome do contêiner como myblob e espera ver um nome de blob depois da barra. A solicitação está incorreta devido à ausência do nome do blob.

O URL a seguir é válido para uma operação em um blob no contêiner raiz:

https://myaccount.blob.core.windows.net/myblob

Operações PUT

Para criar um contêiner denominado mycontainer:

  
PUT https://myaccount.blob.core.windows.net/mycontainer?restype=container

Para criar um blob denominado myblob no contêiner raiz:

  
PUT https://myaccount.blob.core.windows.net/myblob

Você também pode especificar explicitamente o contêiner raiz:

  
PUT https://myaccount.blob.core.windows.net/$root/myblob

Para criar um blob denominado myblob em um contêiner denominado mycontainer:

PUT https://myaccount.blob.core.windows.net/mycontainer/myblob

Para criar um blob denominado photos/myphoto em um contêiner denominado mycontainer:

PUT https://myaccount.blob.core.windows.net/mycontainer/photos/myphoto

Para definir metadados em um blob denominado myblob no contêiner raiz:

  
PUT https://myaccount.blob.core.windows.net/myblob?comp=metadata

Operações DELETE

Para excluir um contêiner denominado mycontainer:

  
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container

Para excluir o contêiner raiz:

  
DELETE https://myaccount.blob.core.windows.net/$root?restype=container

Para excluir o blob myblob do contêiner raiz:

  
DELETE https://myaccount.blob.core.windows.net/myblob