Elimina contenitore

L'operazione Delete Container elimina il contenitore specificato.

Richiedi

È possibile costruire la richiesta di Delete Container come indicato di seguito. Si consiglia HTTPS. Sostituire myaccount con il nome dell'account di archiviazione.

Method	URI della richiesta	Versione HTTP
DELETE	https://myaccount.blob.core.windows.net/mycontainer?restype=container	HTTP/1.1

URI del servizio di archiviazione emulato

Quando si effettua una richiesta per il servizio di archiviazione emulato, specificare il nome host dell'emulatore e la porta di archiviazione BLOB di Azure come 127.0.0.1:10000, seguiti dal nome dell'account di archiviazione emulato.

Method	URI della richiesta	Versione HTTP
DELETE	http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container	HTTP/1.1

Per altre informazioni, vedere Usare l'emulatore Azurite per lo sviluppo di Archiviazione di Azure locale.

Parametri URI

Puoi specificare il seguente parametro aggiuntivo sull'URI della richiesta.

Parametro	Description
timeout	Optional. Il parametro timeout è espresso in secondi. Per altre informazioni, vedere Impostazione dei timeout per le operazioni di archiviazione BLOB.

Header di richiesta

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

Intestazione della richiesta	Description
Authorization	Required. Specifica lo schema di autorizzazione, il nome dell'account e la firma. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
Date oppure x-ms-date	Required. Specifica l'ora UTC (Coordinated Universal Time) per la richiesta. Per altre informazioni, vedere Autorizzare le richieste ad Archiviazione di Azure.
x-ms-lease-id: <ID>	Richiesto per la versione 2012-02-12 e successive se il container ha un leasing attivo. Per chiamare Delete Container un container che ha un contratto di locazione attivo, specifica l'ID del leasing in questa intestazione di credito. Se questo intestazione non viene specificato quando c'è un contratto di locazione attivo, Delete Container restituisce un errore 409 (Conflitto). Se specifichi l'ID del leasing sbagliato, o un ID di leasing su un container che non ha un contratto attivo, Delete Container restituisce un errore 412 (Precondizione fallita).
x-ms-version	Obbligatorio per tutte le richieste autorizzate. Specifica la versione dell'operazione da utilizzare per questa richiesta. Per ulteriori informazioni, consultare Controllo delle versioni per i servizi di Archiviazione di Azure.
x-ms-client-request-id	Optional. Fornisce un valore opaco generato dal client con un limite di caratteri di 1 kibibyte (KiB) registrato nei log quando viene configurata la registrazione. È consigliabile usare questa intestazione per correlare le attività sul lato client alle richieste ricevute dal server. Per altre informazioni, vedere Monitorare l'archiviazione BLOB di Azure.

Questa operazione supporta anche l'uso di intestazioni condizionali per eliminare il contenitore solo se viene soddisfatta una condizione specificata. Per altre informazioni, vedere Specifica di intestazioni condizionali per le operazioni di archiviazione BLOB.

Corpo della richiesta

Nessuno.

Esempio di richiesta

Request Syntax:  
DELETE 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 21:44:34 GMT  
Authorization: SharedKey devstoreaccount1:t7mf5htNuwLFX9g0S2LDdRtRn1FQzMAluBvHy1QPpnM=  

Risposta

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

Codice di stato

Un'operazione riuscita restituisce il codice di stato 202 (accettato). Per informazioni sui codici di stato, vedere Stato e codici di errore.

Intestazioni di risposta

La risposta per questa operazione include le intestazioni seguenti. La risposta può includere anche intestazioni HTTP standard aggiuntive. Tutte le intestazioni standard sono conformi alla specifica del protocollo HTTP/1.1 .

Intestazione della risposta	Description
x-ms-request-id	Questa intestazione identifica in modo univoco la richiesta effettuata e può essere usata per la risoluzione dei problemi della richiesta. Per ulteriori informazioni, consulta Risoluzione dei problemi relativi alle operazioni API.
x-ms-version	Indica la versione dell'archiviazione BLOB usata per eseguire la richiesta. Questa intestazione viene restituita per le richieste effettuate rispetto alla versione 2009-09-19 e successive.
Date	Valore di data/ora UTC che indica l'ora in cui è stata avviata la risposta. Il servizio genera questo valore.
x-ms-client-request-id	È possibile usare questa intestazione per risolvere i problemi relativi alle richieste e alle risposte corrispondenti. Il valore di questa intestazione è uguale al valore dell'intestazione x-ms-client-request-id , se presente nella richiesta. Il valore è al massimo 1.024 caratteri ASCII visibili. Se l'intestazione x-ms-client-request-id non è presente nella richiesta, questa intestazione non sarà presente nella risposta.

Corpo della risposta

Nessuno.

Risposta di esempio

Response Status:  
HTTP/1.1 202 Accepted  
  
Response Headers:  
Transfer-Encoding: chunked  
Content-Type: application/xml  
Date: Sun, 25 Sep 2011 21:45:00 GMT  
x-ms-version: 2011-08-18  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  

Authorization

L'autorizzazione è necessaria quando si chiama un'operazione di accesso ai dati in Archiviazione di Azure. È possibile autorizzare l'operazione di Delete Container come descritto di seguito.

Importante

Microsoft consiglia di usare l'ID Microsoft Entra con identità gestite per autorizzare le richieste ad Archiviazione di Azure. Microsoft Entra ID offre maggiore sicurezza e facilità d'uso rispetto all'autorizzazione con chiave condivisa.

Microsoft Entra ID (scelta consigliata)

Archiviazione di Azure supporta l'uso di Microsoft Entra ID per autorizzare le richieste ai dati BLOB. Con Microsoft Entra ID è possibile usare il controllo degli accessi in base al ruolo di Azure per concedere le autorizzazioni a un'entità di sicurezza. L'entità di sicurezza può essere un utente, un gruppo, un'entità servizio applicazione o un'identità gestita di Azure. L'entità di sicurezza viene autenticata da Microsoft Entra ID per restituire un token OAuth 2.0. Il token può quindi essere usato per autorizzare una richiesta relativa al servizio BLOB.

Per altre informazioni sull'autorizzazione con Microsoft Entra ID, vedere Autorizzare l'accesso ai BLOB usando Microsoft Entra ID.

Permissions

Di seguito è riportata l'azione controllo degli accessi in base al ruolo necessaria per un utente, un gruppo, un'identità gestita o un'entità servizio di Microsoft Entra per chiamare l'operazione di Delete Container e il ruolo controllo degli accessi in base al ruolo di Azure con privilegi minimi che include questa azione:

• Azure RBAC azione:Microsoft. Storage/storageAccounts/blobServices/container/delete
• Ruolo predefinito con privilegi minimi:Collaboratore ai dati dei BLOB di archiviazione

Per altre informazioni sull'assegnazione dei ruoli tramite il controllo degli accessi in base al ruolo di Azure, vedere Assegnare un ruolo di Azure per l'accesso ai dati BLOB.

Una firma di accesso condiviso fornisce accesso delegato sicuro alle risorse in un account di archiviazione. Con una firma di accesso condiviso è possibile controllare in modo granulare il modo in cui un client può accedere ai dati. È possibile specificare quale risorsa può accedere al client, quali autorizzazioni hanno per tali risorse e per quanto tempo la firma di accesso condiviso è valida.

L'operazione Delete Container supporta l'autorizzazione tramite una firma di accesso condiviso dell'account.

Quando l'accesso con chiave condivisa non è consentito per l'account di archiviazione, un token di firma di accesso condiviso dell'account non sarà consentito in una richiesta all'archiviazione BLOB. Per altre informazioni, vedere Comprendere in che modo la chiave condivisa influisce sui token di firma di accesso condiviso.

Firma di accesso condiviso (SAS) dell'account

Una firma di accesso condiviso (SAS) di un account è protetta con la chiave del relativo account di archiviazione. Una SAS di account delega l'accesso alle risorse in uno o più servizi di archiviazione. Tutte le operazioni disponibili tramite un SAS per il servizio o la delega utente sono disponibili anche tramite un SAS per l'account.

La tabella seguente indica il tipo di risorsa firmata e le autorizzazioni firmate per specificare quando si delega l'accesso:

Operation	Servizio firmato	Tipo di risorsa firmato	Autorizzazione firmata
Elimina contenitore	BLOB (b)	Contenitore (c)	Cancellare (d)

Per altre informazioni sulla firma di accesso condiviso dell'account, vedere Creare una firma di accesso condiviso dell'account.

L'operazione di Delete Container supporta autorizzazione con chiave condivisa. L'autorizzazione con le chiavi dell'account non è consigliata per la maggior parte degli scenari, perché è meno sicura.

Microsoft consiglia di non consentire l'autorizzazione della chiave condivisa per l'account di archiviazione, quando possibile. Per altre informazioni, vedere Impedire l'autorizzazione con chiave condivisa.

Remarks

Quando un contenitore viene eliminato, un contenitore con lo stesso nome non può essere creato per almeno 30 secondi. Il contenitore potrebbe non essere disponibile per più di 30 secondi se il servizio sta ancora elaborando la richiesta. Mentre il contenitore viene eliminato, i tentativi di creare un container con lo stesso nome falliscono con il codice di stato 409 (Conflitto). Il servizio indica che il contenitore viene eliminato. Le operazioni sui blob all'interno del contenitore, inclusi letture e scritture, possono continuare ad avere successo fino a 30 secondi dopo l'accettazione della richiesta di cancellazione. Dopo questo periodo, tutte le operazioni sul container e sui suoi blob falliscono con il codice di stato 404 (Non trovato).

Billing

Gli account di archiviazione non vengono addebitati per Delete Container le richieste.

Vedere anche

Stato e codici di erroregestione rete virtuale di Azure codici di erroreSpecificazione di header condizionali per operazioni gestione rete virtuale di Azure