VENDITE: 1-800-867-1389

Get Container ACL

Aggiornamento: febbraio 2015

Tramite l'operazione Get Container ACL vengono ottenute le autorizzazioni per il contenitore specificato. Le autorizzazioni indicano se i dati del contenitore sono accessibili pubblicamente.

A partire dalla versione 2009-09-19, le autorizzazioni dei contenitori offrono le seguenti opzioni per gestire l'accesso ai contenitori stessi:

  • Accesso in lettura pubblico completo: i dati del contenitore e i dati BLOB possono essere letti tramite una richiesta anonima. I client possono enumerare i BLOB all'interno del contenitore tramite una richiesta anonima, ma non possono enumerare i contenitori all'interno dell'account di archiviazione.

  • Accesso in lettura pubblico solo per i BLOB: i dati BLOB presenti in questo contenitore possono essere letti attraverso una richiesta anonima, ma i dati del contenitore non sono disponibili. I client non possono enumerare i BLOB all'interno del contenitore tramite una richiesta anonima.

  • Nessun accesso in lettura pubblico: i dati del contenitore e i dati BLOB possono essere letti solo dal proprietario dell'account.

Get Container ACL restituisce anche dettagli sui criteri di accesso archiviati a livello di contenitore specificati nel contenitore che è possibile utilizzare con le firme di accesso condiviso. Per altre informazioni, vedere Definizione di un criterio di accesso archiviato.

L'accesso pubblico al contenitore è anonimo, come lo è quello effettuato attraverso una firma di accesso condiviso.

La richiesta Get Container ACL può essere costruita come segue. HTTPS is recommended. Sostituire myaccount con il nome dell'account di archiviazione:

 

Metodo URI richiesta Versione HTTP

GET/HEAD

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

HTTP/1.1

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 richiesta Versione HTTP

GET/HEAD

http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=acl

HTTP/1.1

Per altre informazioni, vedere Uso dell'emulatore di archiviazione di Azure per lo sviluppo e il test.

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

 

Parametro Descrizione

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 oppure 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-lease-id: <ID>

Facoltativa, versione 2012-02-12 e successive. Se specificata, Get Container ACL ha esito positivo solo se il lease del contenitore è attivo e corrisponde a questo ID. In assenza di un lease attivo o se l'ID non corrisponde, viene restituito 412 (Precondition Failed).

x-ms-version

Obbligatoria per tutte le richieste autenticate. Specifica la versione dell'operazione da usare per questa richiesta. Per altre informazioni, vedere Controllo delle versioni per i servizi Blob, di accodamento e tabelle in Windows 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'uso 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'uso di log per tenere traccia delle richiesta di archiviazione nella registrazione di Azure.

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

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

Per informazioni sui codici di stato, vedere Codici di stato e di errore.

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

 

Intestazione della risposta Descrizione

x-ms-blob-public-access

Indica se i dati nel contenitore sono accessibili pubblicamente e il livello di accesso. I valori possibili includono:

  • container: indica l'accesso in lettura pubblico completo per i dati del contenitore e del BLOB. I client possono enumerare i BLOB all'interno del contenitore tramite una richiesta anonima, ma non possono enumerare i contenitori all'interno dell'account di archiviazione.

  • blob: indica l'accesso in lettura pubblico per i BLOB. I dati BLOB presenti in questo contenitore possono essere letti attraverso una richiesta anonima, ma i dati del contenitore non sono disponibili. I client non possono enumerare i BLOB all'interno del contenitore tramite una richiesta anonima.

  • true: indica che il contenitore è stato contrassegnato per l'accesso in lettura pubblico completo utilizzando una versione precedente alla 2009-09-19.

Se questa intestazione non viene restituita nella risposta, il contenitore è privato per il proprietario dell'account.

ETag

Tag di entità per il contenitore. Se la versione della richiesta è 2011-08-18 o successive, il valore ETag sarà racchiuso tra virgolette.

Last-Modified

Restituisce la data e l'ora dell'ultima modifica apportata al contenitore. Il formato data è conforme a RFC 1123. Per altre informazioni, vedere Rappresentazione di valori di data e ora nelle intestazioni.

Qualsiasi operazione che comporta modifiche al contenitore o alle relative proprietà o metadati comporta l'aggiornamento dell'ora dell'ultima modifica. Le operazioni sui BLOB non influiscono sull'ora dell'ultima modifica del contenitore.

x-ms-request-id

Questa intestazione identifica in modo univoco la richiesta effettuata e può essere usata 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 usata 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.

Se per il contenitore sono stati specificati criteri di accesso a livello di contenitore, Get Container ACL restituisce l'identificatore firmato e i criteri di accesso nel corpo della risposta.

<?xml version="1.0" encoding="utf-8"?>
<SignedIdentifiers>
  <SignedIdentifier>
    <Id>unique-value</Id>
    <AccessPolicy>
      <Start>start-time</Start>
      <Expiry>expiry-time</Expiry>
      <Permission>abbreviated-permission-list</Permission>
    </AccessPolicy>
  </SignedIdentifier>
</SignedIdentifiers>

Response Status:
HTTP/1.1 200 OK

Response Headers:
Transfer-Encoding: chunked
x-ms-blob-public-access: container
Date: Sun, 25 Sep 2011 20:28:22 GMT
ETag: "0x8CAFB82EFF70C46"
Last-Modified: Sun, 25 Sep 2011 19:42:18 GMT
x-ms-version: 2011-08-18
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

<?xml version="1.0" encoding="utf-8"?>
<SignedIdentifiers>
  <SignedIdentifier> 
    <Id>MTIzNDU2Nzg5MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTI=</Id>
    <AccessPolicy>
      <Start>2009-09-28T08:49:37.0000000Z</Start>
      <Expiry>2009-09-29T08:49:37.0000000Z</Expiry>
      <Permission>rwd</Permission>
    </AccessPolicy>
  </SignedIdentifier>
</SignedIdentifiers>

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

Solo il proprietario dell'account può leggere i dati in un determinato account di archiviazione, a meno che non abbia specificato che i BLOB nel contenitore sono disponibili per l'accesso in lettura pubblico o abbia reso le risorse nel contenitore disponibili tramite una firma di accesso condiviso.

Il documento è risultato utile?
(1500 caratteri rimanenti)
Grazie per i commenti inviati.
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2015 Microsoft