VENDITE: 1-800-867-1389

List Containers

Aggiornamento: novembre 2013

Tramite l'operazione List Containers viene restituito un elenco dei contenitori nell'account specificato.

La richiesta List Containers può essere costruita nel modo seguente. Si consiglia di utilizzare HTTPS. Sostituire myaccount con il nome dell'account di archiviazione:

 

Metodo URI della richiesta Versione HTTP

GET

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

HTTP/1.1

Si noti che l'URI deve sempre includere la barra (/) per separare il nome host dal percorso e dalle parti di una query dell'URI. Nel caso dell'operazione List Containers, la parte del percorso dell'URI è vuota.

Quando si effettua una richiesta nel servizio di archiviazione emulato, specificare il nome host dell'emulatore e la porta del servizio Blob come 127.0.0.1:10000, seguiti dal nome dell'account di archiviazione emulato:

 

Metodo URI della richiesta Versione HTTP

GET

http://127.0.0.1:10000/devstoreaccount1?comp=list

HTTP/1.1

Si noti che l'archiviazione emulata supporta solo Blob di dimensioni non superiori a 2 GB.

Per altre informazioni, vedere Uso dell'emulatore di archiviazione di Azure per lo sviluppo e il test e Differenze tra l'emulatore di archiviazione e i Servizi di archiviazione Azure.

Nell'URI della richiesta è possibile specificare i parametri aggiuntivi seguenti.

 

Parametro Descrizione

prefix

Facoltativo. Filtra i risultati in modo che vengano restituiti solo i contenitori i cui nomi iniziano con il prefisso specificato.

marker

Facoltativo. Valore stringa che identifica la parte dell'elenco da restituire con l'operazione elenco successiva. L'operazione restituisce un valore marcatore all'interno del corpo della risposta se l'elenco restituito non è completo. Il valore marcatore può essere utilizzato in una chiamata successiva per richiedere il set successivo di elementi dell'elenco.

Il valore marcatore risulta opaco al client.

maxresults

Facoltativo. Specifica il numero massimo di contenitori da restituire. Se la richiesta non specifica maxresults, o specifica un valore maggiore di 5.000, il server restituirà fino a 5.000 elementi. Se il parametro è impostato su un valore minore o uguale a zero, il server restituirà il codice di stato 400 (Richiesta non valida).

include=metadata

Facoltativo. Includere questo parametro per specificare che i metadati del contenitore vengano restituiti come parte del corpo della risposta.

Si noti che i metadati richiesti con questo parametro devono essere archiviati in base alle restrizioni di denominazione imposte dalla versione 2009-09-19 del servizio Blob. A partire da questa versione, i nomi dei metadati devono essere conformi alle convenzioni di denominazione per gli identificatori C#.

timeout

Facoltativo. Il parametro timeout viene espresso in secondi. Per altre informazioni, vedere Impostazione di timeout per le operazioni del servizio Blob.

Nella tabella seguente vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

 

Intestazione della richiesta Descrizione

Authorization

Obbligatorio. Specifica lo schema di autenticazione, il nome dell'account e la firma. Per altre informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

Date o x-ms-date

Obbligatorio. Specifica l'ora UTC (Coordinated Universal Time) per la richiesta. Per altre informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

x-ms-version

Obbligatoria per tutte le richieste autenticate. Specifica la versione dell'operazione da utilizzare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi di archiviazione di Azure.

x-ms-client-request-id

Facoltativo. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 KB che viene registrato nei log di analisi quando la registrazione di Analisi archiviazione è abilitata. L'utilizzo di questa intestazione è consigliato per la correlazione tra le attività sul lato client e le richieste ricevute dal server. Per altre informazioni vedere Informazioni sulla registrazione di Analisi archiviazione e l'articolo relativo all'utilizzo di log per tenere traccia delle richiesta di archiviazione nella registrazione di Azure.

Vedere la sezione Richiesta e risposta di esempio più avanti in questo argomento.

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni di risposta e il corpo della risposta nel formato XML.

Un'operazione completata correttamente restituisce il codice di stato 200 (OK).

Per informazioni sui codici di stato, vedere Codici ed errori di stato.

Nella risposta per questa operazione sono incluse le intestazioni riportate di seguito; La risposta include inoltre intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1.

 

Intestazione della risposta Descrizione

Content-Type

Intestazione HTTP/1.1 standard. Specifica il formato in cui vengono restituiti i risultati. Questo valore è attualmente application/xml.

x-ms-request-id

Questa intestazione identifica in modo univoco la richiesta effettuata e può essere utilizzata per risolvere i problemi relativi alla richiesta. Per altre informazioni, vedere Risoluzione dei problemi relativi alle operazioni dell'API.

x-ms-version

Indica la versione del servizio Blob utilizzata per eseguire la richiesta. Questa intestazione viene restituita per le richieste effettuate nella versione 2009-09-19 e successive.

Date

Valore data/ora UTC generato dal servizio che indica l'ora in cui è stata avviata la risposta.

Il formato del corpo della risposta è il seguente.

<?xml version="1.0" encoding="utf-8"?>
<EnumerationResults ServiceEndpoint="https://myaccount.blob.core.windows.net">
  <Prefix>string-value</Prefix>
  <Marker>string-value</Marker>
  <MaxResults>int-value</MaxResults>
  <Containers>
    <Container>
      <Name>container-name</Name>
      <Properties>
        <Last-Modified>date/time-value</Last-Modified>
        <Etag>etag</Etag>
        <LeaseStatus>locked | unlocked</LeaseStatus>
        <LeaseState>available | leased | expired | breaking | broken</LeaseState>
        <LeaseDuration>infinite | fixed</LeaseDuration>      
      </Properties>
      <Metadata>
        <metadata-name>value</metadata-name>
      </Metadata>
    </Container>
  </Containers>
  <NextMarker>marker-value</NextMarker>
</EnumerationResults>

LeaseStatus, LeaseState e LeaseDuration risultano unicamente nella versione 2012-02-12 e successive.

A partire dalla versione 2013-08-15, l'attributo AccountName per l'elemento EnumerationResults è stato rinominato in ServiceEndpoint. Anche l'elemento URL è stato rimosso dall'elemento Container. Nelle versioni precedenti alla 2013-08-15, l'URL del contenitore, come specificato dal campo URL, non include il parametro restype=container. Se si utilizza questo valore per effettuare altre richieste nei contenitori enumerati, assicurarsi di aggiungere questo parametro per indicare che il tipo di risorsa è un contenitore.

Gli elementi Prefix, Marker e MaxResults sono presenti solo se sono stati specificati nell'URI. L'elemento NextMarker contiene un valore solo se i risultati dell'elenco non sono completi.

L'elemento Metadata è presente solo se il parametro include=metadata è stato specificato nell'URI. Nell'elemento Metadata il valore di ogni coppia nome-valore è elencato in un elemento corrispondente al nome della coppia.

Se una coppia nome-valore dei metadati viola le restrizioni di denominazione imposte dalla versione 2009-09-19, il corpo della risposta indica il nome problematico in un elemento x-ms-invalid-name, come illustrato nel frammento XML seguente:


      <Metadata>
        <MyMetadata1>first value</MyMetadata1>
        <MyMetadata2>second value</MyMetadata2>
        <x-ms-invalid-name>invalid-metadata-name</x-ms-invalid-name>
      </Metadata>

noteNota
A partire dalla versione 2009-09-19, il corpo della risposta per List Containers restituisce l'ora dell'ultima modifica del contenitore in un elemento denominato Last-Modified. Nelle versioni precedenti questo elemento è denominato LastModified.

Vedere la sezione Richiesta e risposta di esempio più avanti in questo argomento.

Solo il proprietario dell'account può chiamare questa operazione.

Se si specifica un valore per il parametro maxresults e il numero dei contenitori da restituire supera questo valore o il valore predefinito per maxresults, il corpo della risposta contiene un elemento NextMarker che indica il contenitore successivo da restituire su una richiesta successiva. Per restituire il set successivo di elementi, specificare il valore NextMarker come parametro marcatore nell'URI per la richiesta successiva.

Si noti che il valore NextMarker deve essere considerato opaco.

I contenitori sono elencati in ordine alfabetico nel corpo della risposta.

L'operazione List Containers scade dopo 30 secondi.

L'URI di esempio seguente richiede l'elenco di contenitori per un account, impostando su 3 il numero massimo di risultati da restituire per l'operazione iniziale.

GET https://myaccount.blob.core.windows.net/?comp=list&maxresults=3 HTTP/1.1

La richiesta viene inviata con queste intestazioni:

x-ms-version: 2013-08-15
x-ms-date: Wed, 23 Oct 2013 22:08:44 GMT
Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/D5Gy0fXvg=

Il codice di stato e le intestazioni della risposta vengono restituiti nel modo seguente:

HTTP/1.1 200 OK
Transfer-Encoding: chunked
Content-Type: application/xml
Date: Wed, 23 Oct 2013 22:08:54 GMT
x-ms-version: 2013-08-15
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0 

L'XML della risposta per questa richiesta è il seguente. Si noti che l'elemento NextMarker segue il set di contenitori e include il nome del contenitore successivo da restituire.

<?xml version="1.0" encoding="utf-8"?>
<EnumerationResults ServiceEndpoint="https://myaccount.blob.core.windows.net/">
  <MaxResults>3</MaxResults>
  <Containers>
    <Container>
      <Name>audio</Name>
      <Properties>
        <Last-Modified>Wed, 23 Oct 2013 20:39:39 GMT</Last-Modified>
        <Etag>0x8CACB9BD7C6B1B2</Etag>
      </Properties>
    </Container>
    <Container>
      <Name>images</Name>
      <Properties>
        <Last-Modified>Wed, 23 Oct 2013 20:39:39 GMT</Last-Modified>
        <Etag>0x8CACB9BD7C1EEEC</Etag>
      </Properties>
    </Container>
    <Container>
      <Name>textfiles</Name>
      <Properties>
        <Last-Modified>Wed, 23 Oct 2013 20:39:39 GMT</Last-Modified>
        <Etag>0x8CACB9BD7BACAC3</Etag>
      </Properties>
    </Container>
  </Containers>
  <NextMarker>video</NextMarker>
</EnumerationResults>

L'operazione elenco successiva specifica il marcatore nell'URI della richiesta, come illustrato di seguito. Il set successivo di risultati viene restituito a partire dal contenitore specificato dal marcatore.

https://myaccount.blob.core.windows.net/?comp=list&maxresults=3&marker=video

Il documento è risultato utile?
(1500 caratteri rimanenti)
Grazie per i commenti inviati.
Mostra:
© 2014 Microsoft