Tároló visszaállítása

Cikk
02/12/2024

A Restore Container művelet visszaállítja egy helyreállíthatóan törölt tároló tartalmát és tulajdonságait egy adott tárolóba. A Restore Container művelet verziószám és újabb verziókban 2019-12-12 érhető el.

Kérés

Restore Container A kérést létrehozhatja egy érvényes, megosztott kulccsal, fiók közös hozzáférésű jogosultságkóddal vagy szerepköralapú hozzáférés-vezérléssel engedélyezett kéréssel.

Metódus	Kérés URI-ja	HTTP-verzió
`PUT`	`https://myaccount.blob.core.windows.net/destinationcontainer?restype=container&comp=undelete`	HTTP/1.1
`PUT`	`https://myaccount.blob.core.windows.net/destinationcontainer?restype=container&comp=undelete&sv=validsastoken`	HTTP/1.1

URI-paraméterek

A kérelem URI-ján a következő további paramétereket adhatja meg.

Paraméter	Leírás
`restype`	Kötelező. A `restype` paraméter értékének a következőnek kell lennie `container`: .
`comp`	Kötelező. A `comp` paraméter értékének a következőnek kell lennie `undelete`: .
`timeout`	Választható. A `timeout` paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása Blob Storage-műveletekhez.

Kérésfejlécek

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

Kérelem fejléce	Leírás
`Authorization`	Kötelező. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérelmek engedélyezése az Azure Storage-ba.
`Date or 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érelmek engedélyezése az Azure Storage-ba.
`x-ms-version`	Minden engedélyezett kéréshez szükséges. A kérelemhez használandó művelet verzióját adja meg. Ehhez a művelethez a verziónak vagy újabbnak kell lennie `2018-03-28` . További információ: Az Azure Storage-szolgáltatások verziószámozása.
`x-ms-client-request-id`	Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibibyte (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: Azure Blob Storage figyelése.
`x-ms-deleted-container-name`	Kötelező. Ezzel a fejléccel egyedileg azonosíthatja a helyreállíthatóan törölt tárolót, amelyet vissza kell állítani.
`x-ms-deleted-container-version`	Kötelező. Ezzel a fejléccel egyedileg azonosíthatja a helyreállíthatóan törölt tárolót, amelyet vissza kell állítani. Ezt az értéket a `deleted` művelet lekérdezési paraméterében `include` szereplő érték megadásával szerezheti `List Containers` be. További információ: Tárolók listázása.

A kérés törzse

Nincsenek.

Reagálás

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

Állapotkód

A sikeres művelet a 201-et (Létrehozva) á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 további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.

Válaszfejléc	Description
`x-ms-request-id`	Egyedileg azonosítja a kérést, amely a kérés hibaelhárításához használható. További információ: API-műveletek hibaelhárítása.
`x-ms-version`	2009-09-19-es és újabb verzió. A kérés futtatásához használt Azure Blob Storage verzióját jelzi.
`Date`	UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. Ezt az értéket a szolgáltatás hozza létre.
`Content-Length`	A kérelem törzsének hossza. Ehhez a művelethez a tartalom hossza mindig nulla.

Választörzs

Nincsenek.

Mintaválasz

Response Status:  
HTTP/1.1 201 OK  
  
Response Headers:  
Date: Mon, 15 Jun 2020 12:43:08 GMT  
x-ms-version: 2019-12-12  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
Content-Length: 0

Engedélyezés

Az azure storage-beli adathozzáférési műveletek meghívásakor engedélyezésre van szükség. A műveletet a Restore Container következő szakaszokban leírtak szerint engedélyezheti.

Az Azure Storage támogatja a Microsoft Entra ID használatát a blobadatokra irányuló kérések engedélyezéséhez. A Microsoft Entra ID azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy rendszerbiztonsági tagnak. A rendszerbiztonsági tag lehet felhasználó, csoport, alkalmazás-szolgáltatásnév vagy Azure által felügyelt identitás. A rendszerbiztonsági tag hitelesítését a Microsoft Entra ID végzi egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob Storage-ra irányuló kérések engedélyezésére használható.

További információ a Microsoft Entra ID használatával történő engedélyezésről: Blobokhoz való hozzáférés engedélyezése Microsoft Entra ID használatával.

Engedélyek

A következő RBAC-műveletek szükségesek ahhoz, hogy egy Microsoft Entra felhasználó, csoport vagy szolgáltatásnév meghívhassa a Restore Container műveletet, valamint a legkevésbé kiemelt, beépített Azure RBAC-szerepkörhöz, amely tartalmazza ezt a műveletet:

Azure RBAC-művelet: Microsoft.Storage/storageAccounts/blobServices/containers/write
Legkevésbé kiemelt beépített szerepkör: Storage-blobadatok közreműködője

A szerepkörök Azure RBAC használatával történő hozzárendelésével kapcsolatos további információkért lásd: Azure-szerepkör hozzárendelése blobadatokhoz való hozzáféréshez.

A közös hozzáférésű jogosultságkód (SAS) biztonságos delegált hozzáférést biztosít a tárfiók erőforrásaihoz. Az SAS-sel részletesen szabályozhatja, hogy az ügyfél hogyan férhet hozzá az adatokhoz. Megadhatja, hogy az ügyfél milyen erőforráshoz férhet hozzá, milyen engedélyekkel rendelkezik ezekhez az erőforrásokhoz, és mennyi ideig érvényes az SAS.

A Restore Container művelet támogatja a fiók SAS használatával történő engedélyezést.

Ha a tárfiók megosztott kulcshoz való hozzáférése nem engedélyezett, a fiók SAS-jogkivonata nem lesz engedélyezve a Blob Storage felé irányuló kérés esetén. További információ: A megosztott kulcs letiltása hogyan befolyásolja az SAS-jogkivonatokat.

Fiók SAS-fiókja

A fiók SAS-jének védelme a tárfiók kulcsával történik. A fiókalapú SAS egy vagy több tárolószolgáltatás erőforrásaihoz nyújt hozzáférést. A szolgáltatáson vagy a felhasználódelegálási SAS-en keresztül elérhető összes művelet fiók SAS-en keresztül is elérhető.

Az alábbi táblázat az aláírt erőforrástípust és az aláírt engedélyeket mutatja, hogy mikor delegáljon hozzáférést:

Művelet	Aláírt szolgáltatás	Aláírt erőforrástípus	Aláírt engedély
Tároló visszaállítása	Blob (b)	Tároló (c)	Írás (w)

További információ a fiók SAS-járól: Fiók SAS létrehozása.

Megjegyzések

A tárolótörlés adatmegőrzési szabályzatát a tárerőforrás-szolgáltató használatával állíthatja be a fiókon.
A megadott tároló nem létezhet a Restore Container művelet végrehajtásakor.
Ha a megadott tároló létezik, a Restore Container művelet 409-zel (Ütközés) fog meghiúsulni.
Ha a helyreállíthatóan törölt tároló nem létezik, már használatban van egy Restore Container művelet forrásaként, vagy túllépte a megőrzési napjait, a művelet 409-re (ütközés) fog meghiúsulni.

Számlázás

A díjszabási kérések a Blob Storage API-kat használó ügyfelektől, közvetlenül a Blob Storage REST API-ból vagy egy Azure Storage-ügyfélkódtárból származhatnak. Ezek a kérések tranzakciónkénti díjakat halmoznak fel. A tranzakció típusa befolyásolja a fiók terhelését. Az olvasási tranzakciók például más számlázási kategóriába tartoznak, mint az írási tranzakciók. Az alábbi táblázat a tárfiók típusa alapján a kérelmek számlázási kategóriáját Restore Container mutatja be:

Művelet	Tárfiók típusa	Számlázási kategória
Tároló visszaállítása	Prémium szintű blokkblob Standard általános célú v2 Standard általános célú v1	Tárolóműveletek listázása és létrehozása

A megadott számlázási kategória díjszabásával kapcsolatos további információkért lásd: Azure Blob Storage Díjszabás.