Blob elhelyezése URL-címről
A Put Blob From URL
művelet létrehoz egy új blokkblobot, amelyben a blob tartalma egy megadott URL-címről lesz olvasható. Ez az API a 2020-04-08-as verziótól érhető el.
A részleges frissítések nem támogatottak a Put Blob From URL
. Egy meglévő blob tartalma felülíródik az új blob tartalmával. Ha egy blokkblob tartalmának részleges frissítését forrás URL-cím használatával szeretné végrehajtani, használja a Put Block From URL
API-t Put Block List
.
A forrásblob mérete legfeljebb 5000 mebibyte (MiB) lehet.
Kérés
A Put Blob From URL
az alábbiak szerint hozhatja létre. Javasoljuk, hogy HTTPS-t használjon. Cserélje le myaccount a tárfiók nevére:
PUT metóduskérés URI-ja | HTTP-verzió |
---|---|
https://myaccount.blob.core.windows.net/mycontainer/myblob |
HTTP/1.1 |
Emulált tárolási szolgáltatás kérése
Amikor kérelmet küld az emulált tárolási szolgáltatásra, adja meg az emulátor gazdagépének nevét és a Blob-szolgáltatás portját 127.0.0.1:10000
, majd az emulált tárfiók nevét:
PUT metóduskérés URI-ja | HTTP-verzió |
---|---|
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob |
HTTP/1.1 |
A táremulátor csak 2 gibibájtos (GiB) blobméreteket támogat.
További információ: Azurite emulátor használata helyi Azure Storage-fejlesztési.
URI-paraméterek
A kérelem URI-ján a következő további paraméterek adhatók meg:
Paraméter | Leírás |
---|---|
timeout |
Szabadon választható. A timeout paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása blobszolgáltatás-műveletekhez. |
Kérelemfejlécek
A szükséges és nem kötelező kérelemfejléceket az alábbi táblázat ismerteti:
Kérelem fejléce | Leírás |
---|---|
Authorization |
Szükséges. 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-. |
Date vagy x-ms-date |
Szükséges. A kérelem koordinált egyetemes idejét (UTC) adja meg. További információ: Kérelmek engedélyezése az Azure Storage-. |
x-ms-version |
Minden engedélyezett kéréshez szükséges. A kérelemhez használni kívánt művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
Content-Length |
Szükséges. A kérelem törzsében továbbított bájtok számát adja meg. Ennek az élőfejnek az értékét 0-ra kell állítani. Ha a hossz nem 0, a művelet a 400-ás állapotkóddal (hibás kérés) meghiúsul. |
x-ms-copy-source:name |
Szükséges. A forrásblob URL-címét adja meg. Az érték legfeljebb 2 kibájt (KiB) hosszúságú URL-cím lehet, amely blobot határoz meg. Az értéknek URL-kódolásúnak kell lennie, ahogyan az egy kérelem URI-jában jelenik meg. A forrásblobnak nyilvánosnak kell lennie, vagy közös hozzáférésű jogosultságkóddal kell rendelkeznie. Ha a forrásblob nyilvános, a művelet végrehajtásához nincs szükség engedélyezésre. Ha a forrásblob mérete nagyobb, mint 5000 MiB, vagy ha a forrás nem ad vissza érvényes Content-Length értéket, a kérés a 409-es (Ütközés) állapotkóddal meghiúsul. Íme néhány példa a forrásobjektum URL-címére:- https://myaccount.blob.core.windows.net/mycontainer/myblob - https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime> - https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime> |
x-ms-copy-source-authorization: <scheme> <signature> |
Szabadon választható. Megadja a másolási forrás engedélyezési sémát és aláírást. További információ: Kérelmek engedélyezése az Azure Storage-. Megjegyzés: A Microsoft Entra csak tulajdonosi sémát támogat. Megjegyzés: Ha a forrásobjektum nyilvánosan elérhető, vagy a forrásobjektum egy tárfiókban van, és a x-ms-copy-source:name átadott SAS-jogkivonatot használja, akkor nincs szükség erre a fejlécre.Ez a fejléc a 2020-10-02-s és újabb verziókban támogatott. |
x-ms-blob-type: BlockBlob |
Szükséges. Megadja a létrehozandó blob típusát, amelynek BlockBlob kell lennie. Ha a blob típusa nem BlockBlob , a művelet a 400-es állapotkóddal (hibás kérelem) meghiúsul. |
Content-Type |
Szabadon választható. A blob MIME-tartalomtípusa. Az alapértelmezett típus a application/octet-stream . |
Content-Encoding |
Szabadon választható. Megadja, hogy mely tartalomkódolások lettek alkalmazva a blobra. Ez az érték akkor lesz visszaadva az ügyfélnek, ha a bloberőforráson a Blob lekérése műveletet hajtja végre. Az érték visszaadásakor az ügyfél a blobtartalom dekódolására használhatja. |
Content-Language |
Szabadon választható. Az erőforrás által használt természetes nyelveket adja meg. |
Cache-Control |
Szabadon választható. A Blob Storage tárolja ezt az értéket, de nem használja és nem módosítja. |
x-ms-source-content-md5 |
Szabadon választható. Az URI-ból származó blobtartalom MD5 kivonata. Ez a kivonat a blob integritásának ellenőrzésére szolgál az adatok URI-ból való átvitele során. Ha ez az élőfej meg van adva, a tárolási szolgáltatás összehasonlítja a másolási forrásból érkezett tartalom kivonatát ezzel a fejlécértékkel. Ha ez az élőfej nincs megadva, a Blob Storage létrehoz egy MD5 kivonatot. Ha a két kivonat nem egyezik, a művelet 400-es hibakóddal (hibás kérelem) meghiúsul. |
x-ms-content-crc64 |
Szabadon választható. A blobtartalom CRC64 kivonata. Ez a kivonat a blob integritásának ellenőrzésére szolgál az átvitel során. Ha ez a fejléc meg van adva, a tárolási szolgáltatás ellenőrzi az elküldött kivonatot. Ha a két kivonat nem egyezik, a művelet 400-es hibakóddal (hibás kérelem) meghiúsul. Ez a fejléc a 02-02-2019-es és újabb verziókban támogatott. Ha a Content-MD5 és az x-ms-content-crc64 fejléc is jelen van, a kérés 400-zal (hibás kéréssel) meghiúsul. |
x-ms-blob-content-type |
Szabadon választható. Beállítja a blob tartalomtípusát. |
x-ms-blob-content-encoding |
Szabadon választható. Beállítja a blob tartalomkódolását. |
x-ms-blob-content-language |
Szabadon választható. Beállítja a blob tartalomnyelvét. |
x-ms-blob-content-md5 |
Szabadon választható. Beállítja a blob MD5 kivonatát. |
x-ms-blob-cache-control |
Szabadon választható. Beállítja a blob gyorsítótár-vezérlését. |
x-ms-meta-name:value |
Szabadon választható. A blobhoz metaadatként társított név-érték párok. Megjegyzés: A 2009-09-19-es verziótól a metaadatok nevének meg kell felelnie C#-azonosítókelnevezési szabályainak. |
x-ms-encryption-scope |
Szabadon választható. A kérelem tartalmának titkosításához használandó titkosítási hatókör. Ez a fejléc a 2019-02-02-es és újabb verzióban támogatott. |
x-ms-tags |
Szabadon választható. Beállítja a megadott lekérdezési sztringbe kódolt címkéket a blobon. További információ: Megjegyzések szakasz. A 2019-12-12-es és újabb verziók támogatottak. |
x-ms-copy-source-tag-option |
Szabadon választható. A lehetséges értékek a CSERE vagy a MÁSOLÁS (kis- és nagybetűk megkülönböztetése). Az alapértelmezett érték a CSERE. Ha a COPY van megadva, a forrásblob címkéi át lesznek másolva a célblobba. A forrásblobnak privátnak kell lennie, és a kérésnek engedéllyel kell rendelkeznie ahhoz, hogy Blobcímkék lekérése a forrásblobon, és Blobcímkék beállítása a célblobon. Ez további hívást von maga után a Blobcímkék lekérése művelethez a forrásfiókon. A REPLACE a célblob x-ms-tags fejléce által megadott címkéket állítja be. Ha a REPLACE függvényt használja, és a x-ms-tags nem ad meg címkéket, a célblobban nincs címke beállítva. A COPY és a x-ms-tags megadása 409-et (ütközést) eredményez.A 2021-04-10-es és újabb verziók támogatottak. |
x-ms-copy-source-blob-properties |
Szabadon választható. Megadja a másolási forrás blobtulajdonságainak viselkedését. Ha True értékre van állítva, a forrásblob tulajdonságai át lesznek másolva az új blobba. Az alapértelmezett érték a True . |
x-ms-source-if-modified-since |
Szabadon választható. Egy DateTime érték. Adja meg ezt a feltételes fejlécet, hogy csak akkor helyezze el a blobot, ha a forrásblob a megadott dátum/idő óta módosult. Ha a forrásblob nem lett módosítva, a Blob Storage a 412-s állapotkódot adja vissza (az előkondicionálás sikertelen). Ez a fejléc nem adható meg, ha a forrás Azure Files-megosztás. |
x-ms-source-if-unmodified-since |
Szabadon választható. Egy DateTime érték. Adja meg ezt a feltételes fejlécet, hogy csak akkor helyezze el a blobot, ha a forrásblob a megadott dátum/idő óta nem lett módosítva. Ha a forrásblob módosult, a Blob Storage a 412-s állapotkódot adja vissza (az előkondicionálás sikertelen). Ez a fejléc nem adható meg, ha a forrás Azure Files-megosztás. |
x-ms-source-if-match |
Szabadon választható. ETag-érték. Adja meg ezt a feltételes fejlécet, hogy csak akkor helyezze el a forrásblobot, ha az ETag értéke megegyezik a megadott értékkel. Ha az ETag-értékek nem egyeznek, a Blob Storage a 412-s állapotkódot adja vissza (az előkondicionálás sikertelen). Ez a fejléc nem adható meg, ha a forrás Azure Files-megosztás. |
x-ms-source-if-none-match |
Szabadon választható. ETag-érték. Adja meg ezt a feltételes fejlécet, hogy csak akkor helyezze el a blobot, ha az ETag nem felel meg a megadott értéknek. Ha az értékek megegyeznek, a Blob Storage a 412-et adja vissza (az előkondicionálás sikertelen). Ez a fejléc nem adható meg, ha a forrás Azure Files-megosztás. |
If-Modified-Since |
Szabadon választható. Egy DateTime érték. Adja meg ezt a feltételes fejlécet, hogy csak akkor helyezze el a blobot, ha a célblob a megadott dátum/idő óta módosult. Ha a célblob nem lett módosítva, a Blob Storage a 412-s állapotkódot adja vissza (az előkondicionálás sikertelen). |
If-Unmodified-Since |
Szabadon választható. Egy DateTime érték. Adja meg ezt a feltételes fejlécet, hogy csak akkor helyezze el a blobot, ha a célblob a megadott dátum/idő óta nem lett módosítva. Ha a célblob módosult, a Blob Storage a 412-s állapotkódot adja vissza (az előkondicionálás sikertelen). |
If-Match |
Szabadon választható. ETag-érték. Adjon meg egy ETag-értéket a feltételes fejléchez, hogy csak akkor helyezze el a blobot, ha a megadott ETag érték megegyezik egy meglévő célblob ETag értékével. Ha a célblob ETagje nem egyezik a If-Match megadott ETag-ével, a Blob Storage a 412-s állapotkódot adja vissza (az előkondicionálás sikertelen). |
If-None-Match |
Szabadon választható. ETag-érték vagy helyettesítő karakter (*). Adjon meg egy ETag-értéket ehhez a feltételes fejléchez, hogy csak akkor helyezze el a blobot, ha a megadott ETag érték nem egyezik a célblob ETag értékével. Adja meg a helyettesítő karaktert (*), hogy csak akkor hajtsa végre a műveletet, ha a célblob nem létezik. Ha a megadott feltétel nem teljesül, a Blob Storage a 412-s állapotkódot adja vissza (az előfeltétel sikertelen). |
x-ms-lease-id:<ID> |
Akkor szükséges, ha a blob aktív bérletet kapott. Ha aktív bérlettel rendelkező blobon szeretné végrehajtani ezt a műveletet, adja meg a fejléc érvényes bérletazonosítóját. |
x-ms-blob-content-disposition |
Szabadon választható. Beállítja a blob Content-Disposition fejlécét. A 2013-08-15-ös és újabb verziókhoz érhető el.A Content-Disposition válaszfejléc mező további információkat közöl a válasz hasznos adatainak feldolgozásáról, és további metaadatok csatolására használható. Ha például a fejléc attachment értékre van állítva, az azt jelzi, hogy a felhasználói ügynök nem jelenítse meg a választ. Ehelyett egy Mentés másként párbeszédpanelt kell megjelenítenie a megadott blobnéven kívül más fájlnévvel.A Blob- lekérése és Blob tulajdonságainak lekérése művelet válasza tartalmazza a content-disposition fejlécet. |
Origin |
Szabadon választható. Megadja a kérés forrását. Ennek a fejlécnek a jelenléte a válasz forrásközi erőforrás-megosztási (CORS- ) fejléceit eredményezi. További információ: CORS-támogatás az Azure Storage-szolgáltatások. |
x-ms-client-request-id |
Szabadon választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibbyte (KiB) karakterkorláttal, amelyet a tárelemzési naplózás engedélyezésekor rögzít az elemzési 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. |
x-ms-access-tier |
Szabadon választható. A blobon beállítani kívánt szintet jelzi. A blokkblobszintek érvényes értékei a következők: Hot , Cool , Cold és Archive .
Megjegyzés: Cold szint támogatott a 2021-12-02-es és újabb verziókban.
Hot , Cool és Archive a 2018-11-09-es és újabb verziók támogatottak. A blokkblobok rétegzésével kapcsolatos további információkért lásd gyakori elérésű, ritka elérésű és archív tárolási szinteket. |
x-ms-expiry-option |
Szabadon választható. 2023-08-03-es és újabb verzió. A kérelem lejárati dátumának beállítását adja meg. További információ: ExpiryOption. Ez a fejléc érvényes a hierarchikus névtérrel rendelkező fiókokra. |
x-ms-expiry-time |
Szabadon választható. 2023-08-03-es és újabb verzió. Megadja, hogy a blob mikor járjon le. A lejárati dátum formátuma x-ms-expiry-option szerint változik. További információ: ExpiryOption. Ez a fejléc érvényes a hierarchikus névtérrel rendelkező fiókokra. |
Ez a művelet a feltételes fejlécek használatát is támogatja a blob írásához, ha egy adott feltétel teljesül. További információ: Feltételes fejlécek megadása a Blob Storage-műveletekhez.
Kérelemfejlécek (ügyfél által megadott titkosítási kulcsok)
A blob ügyfél által megadott kulccsal történő titkosítására vonatkozó kérelemben a következő fejlécek adhatók meg. Az ügyfél által megadott kulccsal (és a megfelelő fejléckészlettel) történő titkosítás nem kötelező.
Kérelem fejléce | Leírás |
---|---|
x-ms-encryption-key |
Szükséges. A Base64 kódolású AES-256 titkosítási kulcs. |
x-ms-encryption-key-sha256 |
Szükséges. A titkosítási kulcs Base64 kódolású SHA256 kivonata. |
x-ms-encryption-algorithm: AES256 |
Szükséges. Megadja a titkosításhoz használni kívánt algoritmust. A fejléc értékének AES256 kell lennie. |
Kérelem törzse
Egyik sem.
Mintakérés
Az alábbi példa egy blokkblob létrehozására irányuló kérelmet mutat be:
Request Syntax:
PUT https://myaccount.blob.core.windows.net/mycontainer/myblockblob HTTP/1.1
Request Headers:
x-ms-version: 2020-04-08
x-ms-date: <date>
Content-Type: text/plain; charset=UTF-8
x-ms-blob-content-disposition: attachment; filename="fname.ext"
x-ms-blob-type: BlockBlob
x-ms-meta-m1: v1
x-ms-meta-m2: v2
x-ms-copy-source: https://myaccount.blob.core.windows.net/mycontainer/myblob
x-ms-expiry-option: RelativeToNow
x-ms-expiry-time: 30000
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=
Content-Length: 0
Válasz
A válasz tartalmaz egy HTTP-állapotkódot és válaszfejléceket.
Állapotkód
A sikeres művelet a 201-ben (létrehozva) állapotkódot adja vissza.
További információ az állapotkódokról: Állapot- és hibakódok.
Válaszfejlécek
A művelet válasza 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 | Leírás |
---|---|
ETag |
Az ETag olyan értéket tartalmaz, amellyel az ügyfél feltételes PUT műveleteket hajthat végre a If-Match kérelemfejléc használatával. Az ETag érték idézőjelek közé van zárva. |
Last-Modified |
A blob utolsó módosításának dátuma/időpontja. A dátumformátum az RFC 1123-at követi. További információ: Dátum/idő értékek megjelenítése fejlécekben. A blob írási műveletei (beleértve a blob metaadatainak vagy tulajdonságainak frissítéseit is) módosítják a blob utolsó módosított időpontját. |
Content-MD5 |
Egy blokkblobot adott vissza, hogy az ügyfél ellenőrizhesse az üzenettartalmak integritását. A Content-MD5 visszaadott értéket a Blob Storage számítja ki. Ez az élőfej akkor is vissza lesz adva, ha a kérés nem tartalmaz Content-MD5 vagy x-ms-blob-content-md5 fejléceket. |
x-ms-content-crc64 |
Egy blokkblobot adott vissza, hogy az ügyfél ellenőrizhesse az üzenettartalmak integritását. A x-ms-content-crc64 visszaadott értéket a Blob Storage számítja ki. Ez a fejléc mindig vissza lesz adva. |
x-ms-request-id |
Egyedileg azonosítja a végrehajtott kérést, és segítségével elháríthatja a kérést. További információ: API-műveletek hibaelhárítása. |
x-ms-version |
A Blob Storage azon verziója, amelyet a kérés végrehajtásához használtak. |
Date |
A szolgáltatás által létrehozott UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. |
Access-Control-Allow-Origin |
Akkor adja vissza, ha a kérés tartalmaz egy Origin fejlécet, és a CORS engedélyezve van egy egyező szabálysal. Ez a fejléc a forráskérés fejlécének értékét adja vissza, ha van egyezés. |
Access-Control-Expose-Headers |
Akkor adja vissza, ha a kérés tartalmaz egy Origin fejlécet, és a CORS engedélyezve van egy egyező szabálysal. A válaszfejlécek listáját adja vissza, amelyeket elérhetővé kell tenni az ügyfél vagy a kérés kiállítója számára. |
Access-Control-Allow-Credentials |
Ha a kérés tartalmaz egy Origin fejlécet, és a CORS engedélyezve van egy olyan egyező szabálysal, amely nem engedélyezi az összes forrást. Ez a fejléc true van beállítva. |
x-ms-request-server-encrypted: true/false |
Ennek a fejlécnek az értéke true , ha a kérés tartalma sikeresen titkosítva van a megadott algoritmussal. Ellenkező esetben az érték false értékre van állítva. |
x-ms-encryption-key-sha256 |
Visszaadva, ha a kérés ügyfél által megadott kulcsot használt a titkosításhoz, hogy az ügyfél a megadott kulccsal biztosítsa a kérés tartalmának sikeres titkosítását. |
x-ms-encryption-scope |
Visszaadva, ha a kérelem titkosítási hatókört használt, így az ügyfél a titkosítási hatókör használatával meggyőződhet arról, hogy a kérés tartalma sikeresen titkosítva van. |
x-ms-version-id: <DateTime> |
Egy átlátszatlan DateTime értéket ad vissza, amely egyedileg azonosítja a blobot. Ennek az élőfejnek az értéke a blob verzióját jelzi, és a blob elérésére irányuló későbbi kérésekben is használható. |
Válasz törzse
Egyik sem.
Mintaválasz
Response Status:
HTTP/1.1 201 Created
Response Headers:
Transfer-Encoding: chunked
Content-MD5: sQqNsWTgdUEFt6mb5y4/5Q==
x-ms-content-crc64: 77uWZTolTHU
Date: <date>
ETag: "0x8CB171BA9E94B0B"
Last-Modified: <date>
Access-Control-Allow-Origin: http://contoso.com
Access-Control-Expose-Headers: Content-MD5
Access-Control-Allow-Credentials: True
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-version-id: <DateTime>
Felhatalmazás
Az Azure Storage-beli adathozzáférési műveletek meghívásához engedélyezésre van szükség. Az alábbi módon engedélyezheti a Put Blob From URL
műveletet.
Ha egy kérés a x-ms-tags
kérelemfejlécet tartalmazó címkéket ad meg, a hívónak meg kell felelnie a Blobcímkék beállítása művelet engedélyezési követelményeinek.
Fontos
A Microsoft azt javasolja, hogy felügyelt identitásokkal használja a Microsoft Entra ID-t az Azure Storage-kérelmek engedélyezéséhez. A Microsoft Entra ID kiváló biztonságot és egyszerű használatot biztosít a megosztott kulcsok engedélyezéséhez képest.
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-val azure-beli szerepköralapú hozzáférés-vezérléssel (Azure RBAC) adhat engedélyeket egy biztonsági tagnak. A biztonsági tag lehet felhasználó, csoport, alkalmazásszolgáltatásnév vagy Azure-beli felügyelt identitás. A biztonsági tagot a Microsoft Entra ID hitelesíti egy OAuth 2.0-jogkivonat visszaadásához. A jogkivonat ezután a Blob szolgáltatással kapcsolatos kérések engedélyezésére használható.
A Microsoft Entra ID használatával történő engedélyezésről további információt A blobok hozzáférésének engedélyezése a Microsoft Entra-azonosítóvalcímű témakörben talál.
Engedélyek
Az alábbiakban azokat az RBAC-műveletet soroljuk fel, amelyek szükségesek ahhoz, hogy egy Microsoft Entra-felhasználó, csoport, felügyelt identitás vagy szolgáltatásnév meghívja a Put Blob From URL
műveletet, valamint a legkevésbé kiemelt, beépített Azure RBAC-szerepkört, amely tartalmazza ezt a műveletet:
-
Azure RBAC-művelet:
- Új blokkblob létrehozása: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/add/action
- Meglévő blokkblob létrehozása vagy felülírása: Microsoft.Storage/storageAccounts/blobServices/containers/blobs/write
- Legkevésbé kiemelt beépített szerepkör:Storage Blob Data Közreműködő
A szerepkörök Azure RBAC-vel való hozzárendeléséről további információt Azure-szerepkör hozzárendelése a blobadatokhoz való hozzáféréshezcímű témakörben talál.
Megjegyzések
A Put Blob From URL
művelet a 2020-04-08-as verziótól támogatott.
A 2020-10-02-es és újabb verziókban a Microsoft Entra-hitelesítés támogatott a másolási művelet forrásához.
A forrásblob bármilyen típusú lehet, beleértve a blokkblobot, a hozzáfűző blobot vagy az oldalblobot. A cél blobnak azonban blokkblobnak kell lennie.
A Put Blob From URL
művelet mindig a teljes forrásblobot másolja. Bájttartomány vagy blokkok másolása nem támogatott. Részleges frissítések végrehajtásához tekintse meg Tiltás url-címrőlcímű témakört. A célblob lehet egy meglévő blokkblob, vagy lehet egy új blob, amelyet a művelet hozott létre.
Ha blokkblobot használ forrásobjektumként, a program minden véglegesített blobtartalmat másol. A blokklista azonban nem marad meg, és a nem véglegesített blokkok nem lesznek másolva. A célblob tartalma megegyezik a forrás tartalmával, de a véglegesített blokklista nem marad meg.
Blob tulajdonságainak és metaadatainak elhelyezése
Ha blokkblobot hoz létre másolási forrásból, a rendszer alapértelmezés szerint a forrásblobból másolja a szabványos blobtulajdonságokat. Ha az alkalmazás metaadatai meg van adva a kérelemben, a forrás blob metaadatainak másolása nélkül lesz tárolva. A HTTP-tartalomfejlécek explicit beállításához megadhatja a megfelelő fejlécet a kérelemben.
Content-Type
Content-Encoding
Content-Length
Cache-Control
Content-Disposition
A célblob mérete mindig megegyezik a forrásblob méretével. A Content-Length
fejlécnek 0-nak kell lennie a Put Blob From URL
kérelemben (mivel nincs kérelemtörzs), és a célblob tartalomhossz-tulajdonsága a forrás méretéből lesz levonva.
Blob elhelyezése URL-címből egyéni tulajdonságok
Put Blob From Url
ugyanazt a szemantikát követi, mint Put Blob
a szabványos HTTP-fejlécekhez társított egyéni tulajdonságok beállításához. További információ: Blob egyéni tulajdonságai
blobindexcímkék
Ha a célblob címkéi szerepelnek a x-ms-tags
fejlécben, akkor lekérdezési sztringet kell kódolniuk. A címkekulcsoknak és -értékeknek meg kell felelniük a Set Blob Tags
. Ezenkívül a x-ms-tags
fejléc legfeljebb 2 KiB címkét tartalmazhat. Ha további címkékre van szükség, használja a Set Blob Tags
műveletet.
Ha a címkék nincsenek megadva a x-ms-tags
fejlécben, azok nem lesznek átmásolva a forrásblobból.
Titkosítási hatókörök és ügyfél által megadott kulcsok
A Put Blob From URL
API a titkosítási hatóköröket és az ügyfél által megadott kulcsokat is támogatja a x-ms-encryption-scope
és x-ms-encryption-key
fejlécek használatával.
Ha a x-ms-copy-source
fejléc ugyanarra a forrásblobra hivatkozik, mint a célblob a kérelem URI-jában, a Put Blob From URL
művelet a blob szinkron helyszíni átírását hajtja végre. Ez lehetővé teszi egy blob újraírását egy másik titkosítási kulcs vagy titkosítási hatókör használatára.
Számlázás
A díjszabási kérések olyan ügyfelektől származhatnak, amelyek Blob Storage API-kat használnak közvetlenül a Blob Storage REST API-ból vagy egy Azure Storage-ügyfélkódtárból. Ezek a kérések tranzakciónkénti díjakat halmoznak fel. A tranzakció típusa hatással van a fiók díjának módjára. 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 Put Blob From URL
kérelmek számlázási kategóriáját mutatja be:
Művelet | Tárfiók típusa | Számlázási kategória |
---|---|---|
Blob elhelyezése URL-címről (célfiók1) | Prémium szintű blokkblob Standard általános célú v2 Standard általános célú v1 |
Írási műveletek |
Blob elhelyezése URL-címről (forrásfiók2) | Prémium szintű blokkblob Standard általános célú v2 Standard általános célú v1 |
Olvasási műveletek |
1A célfiók egy tranzakcióért lesz felszámítva az írás kezdeményezéséhez.
2A forrásfiók minden olvasási kéréshez egy tranzakciót bonyolít a forrásobjektumhoz.
Ezenkívül, ha a forrás- és célfiókok különböző régiókban (például az USA északi régiójában és az USA déli régiójában) találhatók, a kérés átviteléhez használt sávszélességet kimenő forgalomként számítjuk fel a forrás tárfiókra. Az ugyanazon régión belüli fiókok közötti kimenő forgalom ingyenes.
Végül egy másik nevű, ugyanazon tárfiókon belüli új blob létrehozása további tárerőforrásokat használ, így a művelet a tárfiók kapacitáshasználatával számolja fel a további erőforrásokat.
A megadott számlázási kategóriák díjszabásáról az Azure Blob Storage díjszabásának című témakörben olvashat.
Lásd még:
Az Azure Storage-állapot- és hibakódjainak engedélyezéseBlob szolgáltatás hibakódjaiIdőtúllépések beállítása blobszolgáltatás-műveletekhez