Tároló törlése

A Delete Container művelet megjelöli a megadott tárolót törlésre. A tároló és a benne található blobok később törlődnek a szemétgyűjtés során.

Kérés

A Delete Container kérés a következőképpen építhető fel. HTTPS használata ajánlott. Cserélje le a myaccount nevet a tárfiókja nevére:

Metódus Kérés URI-ja HTTP-verzió
DELETE https://myaccount.blob.core.windows.net/mycontainer?restype=container HTTP/1.1

Emulált tárolási szolgáltatás URI-ja

Amikor kérést ad az emulált társzolgáltatáshoz, adja meg az emulátor állomásnevét és Blob service portot a következőként: , majd az emulált tárfiók 127.0.0.1:10000 neve:

Metódus Kérés URI-ja HTTP-verzió
DELETE http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container HTTP/1.1

További információ: Using the Azure Storage Emulator for Development and Testing (Az Azure Storage Emulator használata fejlesztéshez és teszteléshez).

URI-paraméterek

A kérelem URI-ján a következő további paraméterek is meg lehetnek adva.

Paraméter Leírás
timeout Választható. A timeout paraméter másodpercben van kifejezve. További információkért lásd: Időtúllépések beállítása Blob Service-műveletekhez.

Kérelemfejlécek

Az alábbi táblázat a kötelező és nem kötelező kérelemfejléceket ismerteti.

Kérelem fejléce Description
Authorization Kötelező. Megadja az engedélyezési sémát, a fiók nevét és az aláírást. További információkért lásd: Az Azure Storage.
Date vagy x-ms-date Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információkért lásd: Az Azure Storage.
x-ms-lease-id: <ID> A 2012-02-12-es és újabb verziókhoz szükséges, ha a tároló aktív bérletet rendelkezik. Ha aktív bérletet tartalmazó tárolón kell hívást hívnia, ebben a fejlécben adja meg a Delete Container bérletazonosítót. Ha ez a fejléc nincs megadva aktív bérlet esetén, a Delete Container értéket ad 409 (Conflict) vissza. Ha nem megfelelő bérletazonosítót vagy bérletazonosítót ad meg egy olyan tárolón, amely nem rendelkezik aktív bérletel, a Delete Container értéket adja 412 (Precondition failed) vissza.
x-ms-version Minden engedélyezett kérelemhez szükséges. Megadja a kéréshez használni szükséges művelet verzióját. További információ: Versioning for the Azure Storage Services (Az Azure Storage Services verziószámozása).
x-ms-client-request-id Választható. 1 KiB karakterkorlátú, ügyfél által létrehozott, átlátszatlan értéket biztosít, amely a Storage Analytics-naplózás engedélyezése esetén rögzítve van az elemzési naplókban. A fejléc használata erősen ajánlott az ügyféloldali tevékenységek és a kiszolgáló által kapott kérések összevetéséhez. További információ: About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests (A Storage Analytics naplózása és az Azure-naplózás:Naplók használata a kérelmek nyomon követéséhez).

Ez a művelet csak akkor támogatja a feltételes fejlécek használatát a tároló törlésére, ha teljesül egy adott feltétel. További információ: Feltételes fejlécek megadása a Blob service műveleteihez.

Kérelem törzse

Nincsenek.

Kérésminta

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=  

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot és válaszfejléceket.

Állapotkód

A sikeres művelet a 202 (Elfogadva) állapotkódot adja vissza.

Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok.

Válaszfejlécek

A műveletre adott válasz a következő fejléceket tartalmazza. A válasz tartalmazhat további szabványos HTTP-fejléceket is. Minden standard fejléc megfelel a HTTP/1.1 protokoll specifikációnak.

Válaszfejléc Description
x-ms-request-id Ez a fejléc egyedileg azonosítja a kérést, amely a kérés hibaelhárítása esetén használható. További információ: API-műveletek hibaelhárítása.
x-ms-version A kérés végrehajtásához Blob service használt alkalmazásverziót jelzi. Ez a fejléc lesz visszaadva a 2009-09-19-es vagy újabb verzióra vonatkozó kérések esetén.
Date A szolgáltatás által létrehozott UTC-dátum/idő érték, amely a válasz kezdeményezésének időpontját jelzi.
x-ms-client-request-id Ez a fejléc használható a kérések és a megfelelő válaszok hibaelhárítása érdekében. Ennek a fejlécnek az értéke megegyezik a fejléc értékével, ha az a kérelemben található, és az érték legalább x-ms-client-request-id 1024 látható ASCII-karakter. Ha a fejléc nem található meg a kérésben, ez a fejléc nem lesz x-ms-client-request-id jelen a válaszban.

Válasz törzse

Nincsenek.

Mintaválasz

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  

Engedélyezés

Ezt a műveletet csak a fiók tulajdonosa hívhatja meg.

Megjegyzések

Egy tároló törlésekor legalább 30 másodpercig nem lehet azonos nevű tárolót létrehozni; előfordulhat, hogy a tároló 30 másodpercnél tovább nem lesz elérhető, ha a szolgáltatás még feldolgozta a kérést. A tároló törlése közben az azonos nevű tároló létrehozására tett kísérletek a 409-es (Ütközés) állapotkóddal meghiúsulnak, és a szolgáltatás további hibainformációkat ad vissza, amelyek azt jelzik, hogy a tároló törlése folyamatban van. Minden más művelet, beleértve a tárolóban lévő blobok műveleteit is, a 404-es (Nem található) állapotkóddal meghiúsul a tároló törlése közben.

Lásd még

Állapot- és hibakódok
Blob Service-hibakódok
Feltételes fejlécek megadása Blob Service-műveletekhez