VENDAS: 1-800-867-1389

Trabalho com o contêiner raiz (API REST)

Atualizado: novembro de 2013

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, agora você pode fazer referência a um blob que reside no contêiner raiz da seguinte maneira:

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

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 cabeçalho x-ms-blob-public-access na criação do contêiner, ou chamando Definir ACL do contêiner (API REST) depois da sua criação. Consulte Restringir o acesso a contêineres e blobs para obter mais informações.

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

Quando você executar uma operação Listar blobs (API REST) no contêiner raiz, este não aparecerá em URLs de recursos 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
ImportantImportante
Um blob no contêiner raiz não pode incluir uma barra (/) no nome.

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

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
noteObservaçã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

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

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

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


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

Consulte também

Isso foi útil para você?
(1500 caracteres restantes)
Agradecemos os seus comentários
A Microsoft está realizando uma pesquisa online para saber sua opinião sobre o site do MSDN. Se você optar por participar, a pesquisa online lhe será apresentada quando você sair do site do MSDN.

Deseja participar?
Mostrar:
© 2014 Microsoft