Tiltási listaPut Block List

A Put Block List művelet egy blobot ír a blobot alkotó blokk-azonosítók listájának megadásával.The Put Block List operation writes a blob by specifying the list of block IDs that make up the blob. A Blobok részeként való íráshoz egy blokkot kell sikeresen írni a kiszolgálóra egy korábbi put blokk művelettel.In order to be written as part of a blob, a block must have been successfully written to the server in a prior Put Block operation.

Meghívhatja, Put Block List hogy frissítsen egy blobot úgy, hogy csak a megváltozott blokkokat tölti fel, majd véglegesíti az új és a meglévő blokkokat.You can call Put Block List to update a blob by uploading only those blocks that have changed, then committing the new and existing blocks together. Ehhez meg kell adnia, hogy el kell-e végezni a blokk véglegesítését a letiltott blokkolási listáról vagy a nem véglegesített tiltások listájáról, vagy a blokk legutóbb feltöltött verzióját, amely a listához tartozhat.You can do this by specifying whether to commit a block from the committed block list or from the uncommitted block list, or to commit the most recently uploaded version of the block, whichever list it may belong to.

KérésRequest

A Put Block List kérést a következőképpen lehet kiépíteni.The Put Block List request may be constructed as follows. A HTTPS használata javasolt.HTTPS is recommended. Cserélje le a MyAccount nevet a Storage-fiók nevére:Replace myaccount with the name of your storage account:

PUT metódus kérésének URI-jaPUT Method Request URI HTTP-verzióHTTP Version
https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=blocklist HTTP/1.1HTTP/1.1

Emulált tárolási szolgáltatás URI-jaEmulated Storage Service URI

Amikor kérelmet küld az emulált tárolási szolgáltatáshoz, adja meg az emulátor állomásneve és Blob service portot 127.0.0.1:10000 , amelyet az emulált Storage-fiók neve követ:When making a request against the emulated storage service, specify the emulator hostname and Blob service port as 127.0.0.1:10000, followed by the emulated storage account name:

PUT metódus kérésének URI-jaPUT Method Request URI HTTP-verzióHTTP Version
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=blocklist HTTP/1.1HTTP/1.1

A Storage Emulator csak 2 GiB-ig támogatja a Blobok méretét.The storage emulator only supports blob sizes up to 2 GiB.

További információ: Az Azure Storage Emulator használata fejlesztéshez és teszteléshez.For more information, see Using the Azure Storage Emulator for Development and Testing.

URI-paraméterekURI Parameters

A kérelem URI-azonosítójában a következő további paraméterek is megadhatók.The following additional parameters may be specified on the request URI.

ParaméterParameter LeírásDescription
timeout Választható.Optional. A timeout paraméter másodpercben van megadva.The timeout parameter is expressed in seconds. További információ: időtúllépések beállítása a blob Service-műveletekhez.For more information, see Setting Timeouts for Blob Service Operations.

KérelemfejlécekRequest Headers

A következő táblázat ismerteti a kötelező és választható kérelmek fejléceit.The following table describes required and optional request headers.

Kérelem fejléceRequest Header LeírásDescription
Authorization Kötelező.Required. Megadja az engedélyezési sémát, a fiók nevét és az aláírást.Specifies the authorization scheme, account name, and signature. További információ: kérelmek engedélyezése az Azure Storage-ba.For more information, see Authorize requests to Azure Storage.
Date vagy x-ms-dateDate or x-ms-date Kötelező.Required. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját.Specifies the Coordinated Universal Time (UTC) for the request. További információ: kérelmek engedélyezése az Azure Storage-ba.For more information, see Authorize requests to Azure Storage.
x-ms-version Minden jóváhagyott kérelemhez szükséges.Required for all authorized requests. Megadja a kérelemhez használni kívánt művelet verzióját.Specifies the version of the operation to use for this request. További információ: verziószámozás az Azure Storage Services szolgáltatásban.For more information, see Versioning for the Azure Storage Services.
Content-Length Kötelező.Required. A kérelem tartalmának hossza bájtban megadva.The length of the request content in bytes. Ez a fejléc a blokkok listájának tartalmának hosszára hivatkozik, nem maga a blob.This header refers to the content length of the list of blocks, not of the blob itself.
Content-MD5 Választható.Optional. A kérelem tartalmának MD5 kivonata.An MD5 hash of the request content. Ezzel a kivonattal ellenőrizheti a kérelem tartalmának integritását a szállítás során.This hash is used to verify the integrity of the request content during transport. Ha a két kivonat nem egyezik, a művelet sikertelen lesz, hibakód: 400 (hibás kérés).If the two hashes do not match, the operation will fail with error code 400 (Bad Request).

Ez a fejléc a kérelem tartalmához van társítva, és nem a blob tartalmával.This header is associated with the request content, and not with the content of the blob itself.
x-ms-content-crc64 Választható.Optional. A kérelem tartalmának crc64 kivonata.An crc64 hash of the request content. Ezzel a kivonattal ellenőrizheti a kérelem tartalmának integritását a szállítás során.This hash is used to verify the integrity of the request content during transport. Ha a két kivonat nem egyezik, a művelet sikertelen lesz, hibakód: 400 (hibás kérés).If the two hashes do not match, the operation will fail with error code 400 (Bad Request).

Ez a fejléc a kérelem tartalmához van társítva, és nem a blob tartalmával.This header is associated with the request content, and not with the content of the blob itself.

Ha a Content-MD5 és az x-MS-Content-crc64 fejlécek is jelen vannak, a kérelem 400 (hibás kérelem) sikertelen lesz.If both Content-MD5 and x-ms-content-crc64 headers are present, the request will fail with a 400 (Bad Request).

Ezt a fejlécet a versions2019-02-02-es vagy újabb verziója támogatja.This header is supported in versions2019-02-02 or later.
x-ms-blob-cache-control Választható.Optional. Beállítja a BLOB gyorsítótár-vezérlőjét.Sets the blob’s cache control. Ha meg van adva, ezt a tulajdonságot a blob tárolja, és egy olvasási kéréssel tért vissza.If specified, this property is stored with the blob and returned with a read request.

Ha ez a tulajdonság nincs megadva a kérelemben, akkor a rendszer törli a blobot, ha a kérelem sikeres.If this property is not specified with the request, then it is cleared for the blob if the request is successful.
x-ms-blob-content-type Választható.Optional. Beállítja a blob tartalomtípusát.Sets the blob’s content type. Ha meg van adva, ezt a tulajdonságot a blob tárolja, és egy olvasási kéréssel tért vissza.If specified, this property is stored with the blob and returned with a read request.

Ha a tartalomtípus nincs megadva, akkor az alapértelmezett típusra van beállítva, amely a következő: application/octet-stream .If the content type is not specified, then it is set to the default type, which is application/octet-stream.
x-ms-blob-content-encoding Választható.Optional. Beállítja a blob tartalmának kódolását.Sets the blob’s content encoding. Ha meg van adva, ezt a tulajdonságot a blob tárolja, és egy olvasási kéréssel tért vissza.If specified, this property is stored with the blob and returned with a read request.

Ha ez a tulajdonság nincs megadva a kérelemben, akkor a rendszer törli a blobot, ha a kérelem sikeres.If this property is not specified with the request, then it is cleared for the blob if the request is successful.
x-ms-blob-content-language Választható.Optional. Állítsa be a blob tartalmának nyelvét.Set the blob’s content language. Ha meg van adva, ezt a tulajdonságot a blob tárolja, és egy olvasási kéréssel tért vissza.If specified, this property is stored with the blob and returned with a read request.

Ez a tulajdonság nincs megadva a kérelemben, és a rendszer törli a blobot, ha a kérelem sikeres.this property is not specified with the request, then it is cleared for the blob if the request is successful.
x-ms-blob-content-md5 Választható.Optional. A blob tartalmának MD5-kivonata.An MD5 hash of the blob content. Ez a kivonat nincs érvényesítve, mivel az egyes blokkokhoz tartozó kivonatok érvényesítése megtörtént az egyes feltöltések során.This hash is not validated, as the hashes for the individual blocks were validated when each was uploaded.

A blob lekérése művelet a Content-MD5 válasz fejlécében szereplő fejléc értékét adja vissza.The Get Blob operation returns the value of this header in the Content-MD5 response header.

Ha ez a tulajdonság nincs megadva a kérelemben, akkor a rendszer törli a blobot, ha a kérelem sikeres.If this property is not specified with the request, then it is cleared for the blob if the request is successful.
x-ms-meta-name:value Választható.Optional. A blobhoz társított, felhasználó által definiált név-érték párok.User-defined name-value pairs associated with the blob.

A 2009-09-19-es verziótól kezdődően a metaadatok neveinek meg kell felelniük a C# azonosítókelnevezési szabályainak.Beginning with version 2009-09-19, metadata names must adhere to the naming rules for C# identifiers.
x-ms-encryption-scope Választható.Optional. A blob titkosításához használt titkosítási hatókört jelzi.Indicates the encryption scope to use to encrypt the blob. Ennek az értéknek meg kell egyeznie a véglegesítés alatt álló összes blokk titkosításához használt titkosítási hatókörrel.This value must match the encryption scope used to encrypt all the blocks that are being committed. Ezt a fejlécet a 2019-02-02-es vagy újabb verziók támogatják.This header is supported in versions 2019-02-02 or later.
x-ms-tags Választható.Optional. Beállítja a megadott lekérdezési karakterlánc kódolású címkéit a blobon.Sets the given query-string encoded tags on the blob. További információért tekintse meg a megjegyzéseket.See the Remarks for additional information. Támogatott a 2019-12-12-es és újabb verziókban.Supported in version 2019-12-12 and newer.
x-ms-lease-id:<ID> Kötelező, ha a blob aktív bérlettel rendelkezik.Required if the blob has an active lease. Ha a műveletet egy aktív bérlettel rendelkező blobon szeretné elvégezni, adja meg a fejléc érvényes címbérleti AZONOSÍTÓját.To perform this operation on a blob with an active lease, specify the valid lease ID for this header.
x-ms-client-request-id Választható.Optional. Egy ügyfél által generált, átlátszatlan értéket biztosít, amely 1 KiB karakteres korláttal rendelkezik, amely az elemzési naplókban van rögzítve, ha engedélyezve van a Storage Analytics naplózása.Provides a client-generated, opaque value with a 1 KiB character limit that is recorded in the analytics logs when storage analytics logging is enabled. 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.Using this header is highly recommended for correlating client-side activities with requests received by the server. További információ: tudnivalók a Storage Analytics naplózásáról és az Azure-naplózásról: a tárolási kérelmek nyomon követésére szolgáló naplók használata.For more information, see About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests.
x-ms-blob-content-disposition Választható.Optional. Beállítja a blob Content-Disposition fejlécét.Sets the blob’s Content-Disposition header. Elérhető a 2013-08-15-es és újabb verziókhoz.Available for versions 2013-08-15 and later.

A Content-Disposition fejléc mező további információkat közvetít a válasz hasznos adatainak feldolgozásáról, valamint további metaadatok csatolásához is használható.The Content-Disposition header field conveys additional information about how to process the response payload, and also can be used to attach additional metadata. Ha például a értékre attachment van állítva, az azt jelzi, hogy a felhasználó-ügynök nem jeleníti meg a választ, hanem a Mentés másként párbeszédpanelt jeleníti meg.For example, if set to attachment, it indicates that the user-agent should not display the response, but instead show a Save As dialog.

A blob beolvasása és a blob-tulajdonságok beolvasása művelet válasza magában foglalja a Content-hajlam fejlécet.The response from the Get Blob and Get Blob Properties operations includes the content-disposition header.
x-ms-access-tier Választható.Optional. 2018-11-09-es és újabb verzió.Version 2018-11-09 and newer. Megadja a blobon beállítani kívánt szintet.Indicates the tier to be set on a blob. A blokk Blobok esetében a blob Storage vagy az általános célú v2-fiókok esetében csak a 2018-11-09-es és újabb verziókkal támogatott.For block blobs, supported on blob storage or general purpose v2 accounts only with version 2018-11-09 and newer. A blob-rétegek blokkjának érvényes értékei a következők: Hot / Cool / Archive .Valid values for block blob tiers are Hot/Cool/Archive. A blob-rétegek blokkolásával kapcsolatos részletes információkért lásd: gyakori, ritka elérésű és archív tárolási szintek.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

A művelet a feltételes fejlécek használatát is támogatja, hogy csak akkor véglegesítse a tiltási listát, ha a megadott feltétel teljesül.This operation also supports the use of conditional headers to commit the block list only if a specified condition is met. További információ: feltételes fejlécek megadása a blob Service-műveletekhez.For more information, see Specifying Conditional Headers for Blob Service Operations.

Kérések fejlécei (ügyfél által biztosított titkosítási kulcsok)Request Headers (Customer-provided encryption keys)

A 2019-02-02-es verziótól kezdve a következő fejlécek adhatók meg a kérésen a Blobok ügyfél által megadott kulccsal való titkosításához.Beginning with version 2019-02-02, the following headers may be specified on the request to encrypt a blob with a customer-provided key. Az ügyfél által megadott kulccsal (és a megfelelő fejlécekkel) történő titkosítás nem kötelező.Encryption with a customer-provided key (and the corresponding set of headers) is optional.

Kérelem fejléceRequest header LeírásDescription
x-ms-encryption-key Kötelező.Required. A Base64 kódolású AES-256 titkosítási kulcs.The Base64-encoded AES-256 encryption key.
x-ms-encryption-key-sha256 Kötelező.Required. A titkosítási kulcs Base64 kódolású SHA256 kivonata.The Base64-encoded SHA256 hash of the encryption key.
x-ms-encryption-algorithm: AES256 Kötelező.Required. Meghatározza a titkosításhoz használandó algoritmust.Specifies the algorithm to use for encryption. A fejléc értékének a következőnek kell lennie: AES256 .The value of this header must be AES256.

Kérelem törzseRequest Body

A kérelem törzsében megadhatja, hogy a Blob service mely blokkokat kell ellenőriznie a kért blokkban.In the request body, you can specify which block list the Blob service should check for the requested block. Így a teljes blob feltöltése helyett egy meglévő blobot is frissíthet az egyes blokkok beszúrásával, cseréjével vagy törlésével.In this way you can update an existing blob by inserting, replacing, or deleting individual blocks, rather than reuploading the entire blob. Miután feltöltötte a megváltoztatott blokkot vagy blokkokat, véglegesítheti a blob új verzióját úgy, hogy véglegesíti az új blokkokat a megőrizni kívánt meglévő blokkokkal együtt.Once you've uploaded the block or blocks that have changed, you can commit a new version of the blob by committing the new blocks together with the existing blocks that you wish to keep.

A Blobok frissítéséhez megadhatja, hogy a szolgáltatásnak meg kell-e keresnie egy blokk-azonosítót a véglegesített blokkok listájában, a nem véglegesített tiltások listájában vagy a nem véglegesített tiltások listájában, majd a véglegesített blokkok listájában.To update a blob, you can specify that the service should look for a block ID in the committed block list, in the uncommitted block list, or in the uncommitted block list first and then in the committed block list. A használni kívánt megközelítés kiválasztásához adja meg a blokk AZONOSÍTÓját a kérelem törzsében a megfelelő XML-elemen belül, a következőképpen:To indicate which approach to use, specify the block ID within the appropriate XML element within the request body, as follows:

  • Adja meg a blokk AZONOSÍTÓját az Committed elemen belül annak jelzésére, hogy a blob Service csak az elnevezett blokkhoz tartozó véglegesített blokkolási listán kell keresnie.Specify the block ID within the Committed element to indicate that the Blob service should search only the committed block list for the named block. Ha a blokk nem található a véglegesített tiltások listájában, akkor nem kerül a blob részeként, és a Blob service a 400-as állapotkódot (hibás kérelem) fogja visszaadni.If the block is not found in the committed block list, it will not be written as part of the blob, and the Blob service will return status code 400 (Bad Request).

  • Adja meg a blokk AZONOSÍTÓját az Uncommitted elemen belül annak jelzésére, hogy a blob Service csak az elnevezett blokk nem véglegesített blokkolási listáját kell keresnie.Specify the block ID within the Uncommitted element to indicate that the Blob service should search only the uncommitted block list for the named block. Ha a blokk nem található a nem véglegesített tiltások listájában, nem kerül a blob részeként, és a Blob service 400 (hibás kérelem) állapotkódot ad vissza.If the block is not found in the uncommitted block list, it will not be written as part of the blob, and the Blob service will return status code 400 (Bad Request).

  • Adja meg a blokk AZONOSÍTÓját az Latest elemen belül annak jelzéséhez, hogy a blob Service először a nem véglegesített blokkolási listán kell keresnie.Specify the block ID within the Latest element to indicate that the Blob service should first search the uncommitted block list. Ha a blokk a nem véglegesített listán található, akkor a blokk legújabb verziója, és a blobba kell írni.If the block is found in the uncommitted list, that version of the block is the latest and should be written to the blob. Ha a blokk nem található a nem véglegesített listában, akkor a szolgáltatásnak a megnevezett blokkhoz tartozó véglegesített blokkolási listán kell keresnie, és a blokkot a blobba kell írnia, ha az megtalálható.If the block is not found in the uncommitted list, then the service should search the committed block list for the named block and write that block to the blob if it is found.

A jelen verziójának kérelem törzse a Put Block List következő XML-formátumot használja:The request body for this version of Put Block List uses following XML format:

<?xml version="1.0" encoding="utf-8"?>  
<BlockList>  
  <Committed>first-base64-encoded-block-id</Committed>  
  <Uncommitted>second-base64-encoded-block-id</Uncommitted>  
  <Latest>third-base64-encoded-block-id</Latest>  
  ...  
</BlockList>  
  

KérésmintaSample Request

Ennek bemutatásához Put Block List tegyük fel, hogy három olyan blokkot töltött fel, amelyet véglegesíteni kíván.To demonstrate Put Block List, assume you have uploaded three blocks that you now wish to commit. Az alábbi példa egy új blobot véglegesít, amely jelzi, hogy a felsorolt blokkok legújabb verzióját kell használni.The following example commits a new blob by indicating that the latest version of each block listed should be used. Nem szükséges tudni, hogy ezek a blokkok már véglegesítve lettek-e.It's not necessary to know whether these blocks have already been committed.

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=blocklist HTTP/1.1  
  
Request Headers:  
x-ms-date: Wed, 31 Aug 2011 00:17:43 GMT  
x-ms-version: 2011-08-18  
Content-Type: text/plain; charset=UTF-8  
Authorization: SharedKey myaccount:DJ5QZSVONZ64vAhnN/wxcU+Pt5HQSLAiLITlAU76Lx8=  
Content-Length: 133  
  
Request Body:  
<?xml version="1.0" encoding="utf-8"?>  
<BlockList>  
  <Latest>AAAAAA==</Latest>  
  <Latest>AQAAAA==</Latest>  
  <Latest>AZAAAA==</Latest>  
</BlockList>  
  

Ezután tegyük fel, hogy frissíteni kívánja a blobot.Next, assume that you wish to update the blob. Az új blob a következő módosításokat fogja tartalmazni:The new blob will have the following changes:

  • Egy új, AZONOSÍTÓval rendelkező blokk ANAAAA== .A new block with ID ANAAAA==. Ezt a blokkot először fel kell tölteni a put blokk hívásával, és a nem véglegesített blokkolási listában jelennek meg, amíg meg nem történik a hívás Put Block List .This block must first be uploaded with a call to Put Block and will appear in the uncommitted block list until the call to Put Block List.

  • A blokk frissített verziója AZONOSÍTÓval AZAAAA== .An updated version of the block with ID AZAAAA==. Ezt a blokkot először fel kell tölteni a put blokk hívásával, és a nem véglegesített blokkolási listában jelennek meg, amíg meg nem történik a hívás Put Block List .This block must first be uploaded with a call to Put Block and will appear in the uncommitted block list until the call to Put Block List.

  • A blokk eltávolítása az AZONOSÍTÓval AAAAAA== .Removal of the block with the ID AAAAAA==. Mivel a következő hívás nem tartalmazza ezt a blokkot Put Block List , a rendszer hatékonyan eltávolítja a blokkot a blobból.Given that this block is not included in the next call to Put Block List, the block will effectively be removed from the blob.

Az alábbi példa azt a hívást mutatja, Put Block List amely a blob frissítését tartalmazza:The following example shows the call to Put Block List that updates the blob:

Request Syntax:  
PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=blocklist HTTP/1.1  
  
Request Headers:  
x-ms-date: Wed, 31 Aug 2009 00:17:43 GMT  
x-ms-version: 2011-08-18  
Content-Type: text/plain; charset=UTF-8  
Authorization: SharedKey myaccount:DJ5QZSVONZ64vAhnN/wxcU+Pt5HQSLAiLITlAU76Lx8=  
Content-Length: 133  
  
Request Body:  
<?xml version="1.0" encoding="utf-8"?>  
<BlockList>  
  <Uncommitted>ANAAAA==</Uncommitted>  
  <Committed>AQAAAA==</Committed>  
  <Uncommitted>AZAAAA==</Uncommitted>  
</BlockList>  
  

ReagálásResponse

A válasz tartalmazza a HTTP-állapotkódot és a válasz fejlécek egy készletét.The response includes an HTTP status code and a set of response headers.

ÁllapotkódStatus Code

Egy sikeres művelet A 201-as állapotkódot (létrehozva) adja vissza.A successful operation returns status code 201 (Created).

Az állapotkódok részletes ismertetését lásd: állapot-és hibakódok.For information about status codes, see Status and Error Codes.

VálaszfejlécekResponse Headers

A műveletre adott válasz a következő fejléceket tartalmazza.The response for this operation includes the following headers. A válasz további szabványos HTTP-fejléceket is tartalmazhat.The response may also include additional standard HTTP headers. Minden szabványos fejléc megfelel a http/1.1 protokoll specifikációjának.All standard headers conform to the HTTP/1.1 protocol specification.

ReagálásResponse LeírásokDescriptions
ETag Az entitás címkéje olyan értéket tartalmaz, amelyet az ügyfél a GET/PUT kérelem fejlécének használatával feltételes műveleteket hajthat végre If-Match .The entity tag contains a value that the client can use to perform conditional GET/PUT operations by using the If-Match request header. Ha a kérelem verziója 2011-08-18 vagy újabb, a ETag értéke idézőjelek között lesz.If the request version is 2011-08-18 or newer, the ETag value will be in quotes.
Last-Modified A blob utolsó módosításának dátuma és időpontja.The date/time that the blob was last modified. A dátumformátum az RFC 1123-et követi.The date format follows RFC 1123. További információ: Date-Time értékek ábrázolása a fejlécekben.For more information, see Representation of Date-Time Values in Headers.

Minden olyan művelet, amely módosítja a blobot, beleértve a blob metaadatainak vagy tulajdonságainak frissítését, megváltoztatja a blob utolsó módosításának időpontját.Any operation that modifies the blob, including an update of the blob's metadata or properties, changes the last modified time of the blob.
Content-MD5 Ezt a fejlécet adja vissza a rendszer, hogy az ügyfél ellenőrizzék az üzenet tartalmának integritását.This header is returned so that the client can check for message content integrity. Ez a fejléc a kérelem tartalmára hivatkozik, ami azt jelenti, hogy ebben az esetben a blokkok listája, és nem a blob tartalma.This header refers to the content of the request, meaning, in this case, the list of blocks, and not the content of the blob itself. A versions2019-02-02-es vagy újabb verziói esetén ezt a fejlécet csak akkor adja vissza a rendszer, ha a kérelemnél ez a fejléc szerepel.For versions2019-02-02 or later, This header is only returned when the request has this header.
x-ms-content-crc64 A 2019-02-02-es és újabb verziók esetén a rendszer ezt a fejlécet adja vissza, hogy az ügyfél ellenőrizzék az üzenet tartalmának integritását.For versions 2019-02-02 and later, this header is returned so that the client can check for message content integrity. Ez a fejléc a kérelem tartalmára hivatkozik, ami azt jelenti, hogy ebben az esetben a blokkok listája, és nem a blob tartalma.This header refers to the content of the request, meaning, in this case, the list of blocks, and not the content of the blob itself.

A rendszer ezt a fejlécet adja vissza, ha Content-md5 a kérelemben nem szerepel a fejléc.This header is returned when Content-md5 header is not present in the request.
x-ms-request-id Ez a fejléc egyedileg azonosítja a kérést, és felhasználható a kérelem hibaelhárítására.This header uniquely identifies the request that was made and can be used for troubleshooting the request. További információ: az API-műveletek hibaelhárítása.For more information, see Troubleshooting API Operations.
x-ms-version A kérelem végrehajtásához használt Blob service verziószámát jelzi.Indicates the version of the Blob service used to execute the request. A rendszer ezt a fejlécet adja vissza a 2009-09-19-es vagy újabb verzióra irányuló kérésekhez.This header is returned for requests made against version 2009-09-19 and later.
Date A szolgáltatás által generált UTC dátum/idő érték, amely a válasz elindításának időpontját jelzi.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
x-ms-request-server-encrypted: true/false 2015-12-11-es vagy újabb verzió.Version 2015-12-11 or newer. A fejléc értéke úgy van beállítva, hogy a true kérelem tartalmának titkosítása a megadott algoritmussal sikeres legyen, false ellenkező esetben pedig.The value of this header is set to true if the contents of the request are successfully encrypted using the specified algorithm, and false otherwise.
x-ms-encryption-key-sha256 2019-02-02-es vagy újabb verzió.Version 2019-02-02 or newer. Ezt a fejlécet akkor adja vissza a rendszer, ha a kérelem ügyfél által biztosított kulcsot használt a titkosításhoz, így az ügyfél gondoskodhat arról, hogy a kérelem tartalma a megadott kulccsal legyen titkosítva.This header is returned if the request used a customer-provided key for encryption, so the client can ensure the contents of the request are successfully encrypted using the provided key.
x-ms-encryption-scope 2019-02-02-es vagy újabb verzió.Version 2019-02-02 or newer. A rendszer ezt a fejlécet adja vissza, ha a kérelem titkosítási hatókört használ, így az ügyfél gondoskodhat arról, hogy a kérelem tartalma a titkosítási hatókörön keresztül sikeresen titkosítva legyen.This header is returned if the request used an encryption scope, so the client can ensure the contents of the request are successfully encrypted using the encryption scope.
x-ms-version-id: <DateTime> 2019-12-12-es és újabb verzió.Version 2019-12-12 and newer. Ez a fejléc egy átlátszatlan DateTime értéket ad vissza, amely egyedileg azonosítja a blobot.This header returns an opaque DateTime value that uniquely identifies the blob. A fejléc értéke a blob verziószámát jelöli, és a következő kérelmekben használható a blob eléréséhez.The value of this header indicates the version of the blob, and may be used in subsequent requests to access the blob.
x-ms-client-request-id Ez a fejléc a kérelmek és a hozzájuk tartozó válaszok megoldásához használható.This header can be used to troubleshoot requests and corresponding responses. A fejléc értéke megegyezik a fejléc értékével, ha az szerepel x-ms-client-request-id a kérelemben, és az érték legfeljebb 1024 látható ASCII-karakterből áll.The value of this header is equal to the value of the x-ms-client-request-id header if it is present in the request and the value is at most 1024 visible ASCII characters. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, ez a fejléc nem jelenik meg a válaszban.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.

MintaválaszSample Response

Response Status:  
HTTP/1.1 201 Created  
  
Response Headers:  
Transfer-Encoding: chunked  
x-ms-content-crc64: 77uWZTolTHU  
Date: Sun, 25 Sep 2011 00:17:44 GMT  
ETag: “0x8CB172A360EC34B”  
Last-Modified: Sun, 25 Sep 2011 00:17:43 GMT  
x-ms-version: 2011-08-18  
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0  
x-ms-version-id: <DateTime>  

EngedélyezésAuthorization

Ezt a műveletet a fiók tulajdonosa, illetve a megosztott hozzáférési aláírással rendelkező felhasználók is meghívhatják, amelyek engedéllyel rendelkeznek a blobba vagy a tárolóba való írásra.This operation can be called by the account owner and by anyone with a Shared Access Signature that has permission to write to this blob or its container.

Ha egy kérelem címkét ad meg a x-ms-tags kérelem fejlécében, a hívónak meg kell felelnie a blob-címkék beállítása művelet engedélyezési követelményeinek.If a request specifies tags with the x-ms-tags request header, the caller must meet the authorization requirements of the Set Blob Tags operation.

MegjegyzésekRemarks

A Put Block List művelet kikényszeríti azt a sorrendet, amelyben a blokkokat össze kell kapcsolni egy blob létrehozásához.The Put Block List operation enforces the order in which blocks are to be combined to create a blob.

Ugyanaz a blokk-azonosító több alkalommal is megadható a blokkok listájában.The same block ID can be specified more than one time in the list of blocks. Ha egy blokk-azonosító egynél több alkalommal van megadva, akkor a rendszer a végső véglegesített blob blokk listájában szereplő egyes helyein lévő bájtok tartományát jelöli.If a block ID is specified more than one time, it will represent the range of bytes in each of those locations in the block list for the final committed blob. Ha egy blokk-azonosító egynél többször jelenik meg a listában, akkor a blokk-azonosító mindkét példányát ugyanabban a blokkok listájában kell megadni.If a block ID appears more than once in the list, both instances of the block ID must be specified within the same block list. Más szóval, mindkét példányt meg kell adni az Committed elemben, a Uncommitted elemben vagy a Latest elemben.In other words, both instances must be specified within the Committed element, the Uncommitted element, or the Latest element.

A segítségével Put Block List egy meglévő blobot úgy módosíthat, hogy beszúrja, frissíti vagy törli az egyes blokkokat anélkül, hogy újra kellene feltöltenie a teljes blobot.With Put Block List, you can modify an existing blob by inserting, updating, or deleting individual blocks, without uploading the whole blob again. Megadhatja a blokkolt letiltási és a nem véglegesített blokkok listáját is, hogy új blobot hozzon létre, vagy egy meglévő blob tartalmát frissítse.You can specify block IDs from both the current committed block list and the uncommitted block list to create a new blob or update the content of an existing blob. Ily módon frissítheti a blobot úgy, hogy néhány új blokkot ad meg a nem véglegesített blokkolási listáról, a többit pedig a véglegesített blokkok listájáról, amely már része a meglévő blobnak.In this way, you can update a blob by specifying a few new blocks from the uncommitted block list, and the rest from the committed block list, which are already part of the existing blob.

Ha egy blokk-azonosító van megadva a Latest elemben, és ugyanaz a blokk-azonosító létezik a véglegesített és a nem véglegesített tiltási listákban is, akkor Put Block List véglegesíti a blokkot a nem véglegesített blokkolási listából.If a block ID is specified in the Latest element, and the same block ID exists in both the committed and uncommitted block lists, Put Block List commits the block from the uncommitted block list. Ha a blokkolási azonosító létezik a véglegesített tiltások listájában, de nem a nem véglegesített blokkok listájában, akkor Put Block List véglegesíti a blokkot a véglegesített blokk listából.If the block ID exists in the committed block list but not in the uncommitted block list, then Put Block List commits the block from the committed block list.

A blokk-Blobok egyes blokkai eltérő méretűek lehetnek.Each block in a block blob can be a different size. A blokk Blobok legfeljebb 50 000 véglegesített blokkot tartalmazhatnak.A block blob can include a maximum of 50,000 committed blocks. A blobhoz köthető nem véglegesített blokkok maximális száma 100 000.The maximum number of uncommitted blocks that may be associated with a blob is 100,000. A következő táblázat a szolgáltatás verziójában engedélyezett maximális blokk-és blob-méreteket ismerteti:The following table describes the maximum block and blob sizes permitted by service version:

Szolgáltatás verziójaService version Maximális blokk mérete (Put blokkon keresztül)Maximum block size (via Put Block) BLOB maximális mérete (Put blokk lista használatával)Maximum blob size (via Put Block List) BLOB maximális mérete egyszeri írási művelettel (Put blobon keresztül)Maximum blob size via single write operation (via Put Blob)
2019-12-12-es és újabb verziókVersion 2019-12-12 and later 4000 MiB4000 MiB Körülbelül 190,7 TiB (4000 MiB X 50 000 blokk)Approximately 190.7 TiB (4000 MiB X 50,000 blocks) 5000 MiB (előzetes verzió)5000 MiB (preview)
2016-05-31-es verzió az 2019-07-07-es verzióvalVersion 2016-05-31 through version 2019-07-07 100 MiB100 MiB Körülbelül 4,75 TiB (100 MiB X 50 000 blokk)Approximately 4.75 TiB (100 MiB X 50,000 blocks) 256 MiB256 MiB
2016-05-31 előtti verziókVersions prior to 2016-05-31 4 MiB4 MiB Körülbelül 195 GiB (4 MiB X 50 000 blokk)Approximately 195 GiB (4 MiB X 50,000 blocks) 64 MiB64 MiB

Ha Put Block List egy meglévő blob frissítését hívja meg, a rendszer felülírja a blob meglévő tulajdonságait és metaadatait.When you call Put Block List to update an existing blob, the blob's existing properties and metadata are overwritten. A meglévő Pillanatképek azonban megmaradnak a blobban.However, any existing snapshots are retained with the blob. A feltételes kérések fejléceit használva csak akkor hajthatja végre a műveletet, ha a megadott feltétel teljesül.You can use the conditional request headers to perform the operation only if a specified condition is met.

Ha a Put Block List művelet egy hiányzó blokk miatt meghiúsul, akkor fel kell töltenie a hiányzó blokkot.If the Put Block List operation fails due to a missing block, you will need to upload the missing block.

Ha a Put Block Put Block List legutóbbi sikeres műveletet követően egy héten belül nincsenek sikeres hívások a blobon, a nem véglegesített blokkok lesznek begyűjtve Put Block .Any uncommitted blocks will be garbage collected if there are no successful calls to Put Block or Put Block List on the blob within a week following the last successful Put Block operation. Ha a put blobot a blobra hívja, a rendszer minden nem véglegesített blokkot begyűjt.If Put Blob is called on the blob, any uncommitted blocks will be garbage collected.

Ha címkék vannak megadva a x-ms-tags fejlécben, akkor a lekérdezési karakterláncnak kell lennie.If tags are provided in the x-ms-tags header, they must be query-string encoded. A kulcsok és értékek címkézésének meg kell felelnie az elnevezési és a hosszúsági követelményeknek a blob-címkék beállítása beállításban meghatározottak szerint.Tag keys and values must conform to the naming and length requirements as specified in Set Blob Tags. Emellett a x-ms-tags fejlécben legfeljebb 2 KiB méretű címke szerepelhet.Further, the x-ms-tags header may contain tags up to 2 KiB in size. Ha további címkékre van szükség, használja a blob-címkék beállítása műveletet.If more tags are required, use the Set Blob Tags operation.

Ha a blob aktív bérlettel rendelkezik, az ügyfélnek meg kell adnia egy érvényes bérlet-azonosítót a kérelemben a tiltólista végrehajtásához.If the blob has an active lease, the client must specify a valid lease ID on the request in order to commit the block list. Ha az ügyfél nem ad meg címbérlet-azonosítót, vagy érvénytelen címbérlet-azonosítót ad meg, akkor a Blob service a 412 állapotkódot adja vissza (az előfeltétel meghiúsult).If the client does not specify a lease ID, or specifies an invalid lease ID, the Blob service returns status code 412 (Precondition Failed). Ha az ügyfél címbérlet-azonosítót ad meg, de a blob nem rendelkezik aktív bérlettel, a Blob service a 412-as állapotkódot is adja vissza (az előfeltétel sikertelen).If the client specifies a lease ID but the blob does not have an active lease, the Blob service also returns status code 412 (Precondition Failed). Ha az ügyfél egy olyan blobon ad meg címbérlet-azonosítót, amely még nem létezik, akkor a Blob service a 2013-08-15-es vagy újabb verzióra irányuló kérések esetén a 412-as állapotkódot adja vissza (az előfeltétel meghiúsulása). a korábbi verziók esetében a Blob service a 201 (létrehozva) állapotkódot fogja visszaadni.If the client specifies a lease ID on a blob that does not yet exist, the Blob service will return status code 412 (Precondition Failed) for requests made against version 2013-08-15 and later; for prior versions the Blob service will return status code 201 (Created).

Ha a blob aktív bérlettel rendelkezik, és a Put Block List blob frissítését hívja meg, a bérlet a frissített blobon marad.If the blob has an active lease and you call Put Block List to update the blob, the lease is maintained on the updated blob.

Put Block List csak a Blobok blokkolására vonatkozik.Put Block List applies only to block blobs. Az Put Block List oldal blobjának hívása a 400-as állapotkód (hibás kérelem) alapján történt.Calling Put Block List on a page blob results in status code 400 (Bad Request).

Az archivált Blobok felülírása meghiúsul, és a blob felülírása a hot / cool régi blob rétegét örökli, ha az x-MS-Access-réteg fejléc nincs megadva.Overwriting an archived blob will fail and overwriting a hot/cool blob will inherit the tier from the old blob if x-ms-access-tier header is not provided.

Lásd még:See Also

A blokk-Blobok, a Blobok hozzáfűzése és az oldal Blobok ismertetése Understanding Block Blobs, Append Blobs, and Page Blobs
Az Azure Storage-ba irányuló kérelmek engedélyezése Authorize requests to Azure Storage
Állapot-és hibakódok Status and Error Codes
BLOB Service-hibakódok Blob Service Error Codes
BLOB Service-műveletek időtúllépésének beállításaSetting Timeouts for Blob Service Operations