Crea contenitore
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale.
Traduzione
Originale

Crea contenitore

 

Il Create Container operazione crea un nuovo contenitore con l'account specificato. Se il contenitore con lo stesso nome esiste già, l'operazione ha esito negativo.

La risorsa di contenitore include i metadati e proprietà per tale contenitore. Non include un elenco dei BLOB presenti nel contenitore.

Il Create Container richiesta può essere costruita come indicato di seguito. È consigliato HTTPS. Il mycontainer valore può includere solo caratteri minuscoli. Sostituire myaccount con il nome dell'account di archiviazione:

Metodo

URI della richiesta

Versione HTTP

PUT

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

HTTP/1.1

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

Metodo

URI della richiesta

Versione HTTP

PUT

http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container

HTTP/1.1

Per ulteriori informazioni, vedere utilizzando l'emulatore di archiviazione di Azure per lo sviluppo e Testing e le differenze tra l'emulatore di archiviazione e servizi di archiviazione Azure.

I seguenti parametri aggiuntivi possono essere specificati nell'URI della richiesta.

Parametro

Descrizione

timeout

Parametro facoltativo. Il timeout parametro viene espresso in secondi. Per ulteriori informazioni, vedere Impostazione dei 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 di schema di autenticazione, nome dell'account e firma. Per ulteriori informazioni, vedere Autenticazione per i servizi di archiviazione di Azure.

Date o x-ms-date

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

x-ms-version

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

x-ms-meta-name:value

Parametro facoltativo. Una coppia nome-valore da associare al contenitore come metadati.

Si noti che a partire dalla versione 2009-09-19, i nomi dei metadati devono rispettare le regole di denominazione per gli identificatori c#.

x-ms-blob-public-access 

Parametro facoltativo. Specifica se i dati nel contenitore sono accessibili pubblicamente e il livello di accesso. I valori possibili sono:

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

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

Se questa intestazione non è incluso nella richiesta, i dati del contenitore sono privati per il proprietario dell'account.

x-ms-client-request-id

Parametro 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. Uso di questa intestazione è fortemente consigliato per correlazione delle attività lato client con le richieste ricevute dal server. Per ulteriori informazioni, vedere Informazioni sulla registrazione di analisi archiviazione e registrazione di Azure: Uso dei log per tenere traccia delle richieste di archiviazione.

Request Syntax: PUT https://myaccount.blob.core.windows.net/mycontainer?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 Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

La risposta include un codice di stato HTTP e un set di intestazioni di risposta.

Un'operazione completata correttamente restituisce il codice di stato 201 (creato).

Per informazioni sui codici di stato, vedere Lo stato e i codici di errore.

La risposta per questa operazione include le intestazioni seguenti. La risposta può inoltre includere intestazioni HTTP standard aggiuntive. Rispettare tutte le intestazioni standard di specifica del protocollo HTTP/1.1.

Intestazione della risposta

Descrizione

ETag

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

Last-Modified

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

Qualsiasi operazione che modifichi il contenitore o le proprietà o metadati Aggiorna ora dell'ultima modifica. Operazioni sui blob non influenzano l'ora dell'ultima modifica del contenitore.

x-ms-request-id

Questa intestazione identifica in modo univoco la richiesta effettuata e può essere utilizzata per la richiesta di risoluzione dei problemi. Per ulteriori informazioni, vedere Risoluzione dei problemi relativi a operazioni dell'API 

x-ms-version

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

Date

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

Response Status: HTTP/1.1 201 Created Response Headers: Transfer-Encoding: chunked Date: Sun, 25 Sep 2011 23:00:12 GMT ETag: “0x8CB14C3E29B7E82” Last-Modified: Sun, 25 Sep 2011 23:00:06 GMT x-ms-version: 2011-08-18 Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0

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

Contenitori vengono creati immediatamente sotto l'account di archiviazione. Non è possibile annidare un contenitore in un altro.

Facoltativamente, è possibile creare un contenitore predefinito o radice per l'account di archiviazione. Il contenitore radice può essere dedotto da un URL che richiede una risorsa blob. Il contenitore radice consente di fare riferimento a un blob dal livello superiore della gerarchia dell'account di archiviazione, senza fare riferimento al nome del contenitore.

Per aggiungere il contenitore radice all'account di archiviazione, creare un contenitore denominato $root. Creare la richiesta nel modo seguente:

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 Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=

È possibile specificare i metadati per un contenitore in fase di che creazione includendo uno o più intestazioni di metadati nella richiesta. Il formato per l'intestazione di metadati è x-ms-meta-name:value.

Se un contenitore con lo stesso nome viene eliminato quando Create Container viene chiamato, il server restituirà il codice di stato 409 (conflitto), con informazioni di errore aggiuntivo, che indica che il contenitore viene eliminato.

Mostra:
© 2016 Microsoft