Blob-laag instellen

Artikel
08/29/2021
6 minuten om te lezen

Met Set Blob Tier deze bewerking stelt u de toegangslaag in op een blob. De bewerking is toegestaan op een pagina-blob in een Premium Storage-account en op een blok-blob in een blob-opslagaccount of v2-account voor algemeen gebruik. De laag van een Premium-pagina-blob bepaalt de toegestane grootte, IOPS en bandbreedte van de blob. De laag van een blok-blob bepaalt Hot / Cool / Archive het opslagtype. Met deze bewerking wordt de ETag van de blob niet bijgewerkt.

Zie Opslaglagen voor Hot, Cool en Archive voor gedetailleerde informatie over opslaglagen op blok-blobniveau.

Aanvraag

De Set Blob Tier aanvraag kan als volgt worden samengesteld. HTTPS wordt aanbevolen. Vervang myaccount door de naam van uw opslagaccount en myblob door de blobnaam waarvoor de laag moet worden gewijzigd.

Methode	Aanvraag-URI	HTTP-versie
`PUT`	`https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=tier`	HTTP/1.1

URI-parameters

De volgende aanvullende parameters kunnen worden opgegeven op de aanvraag-URI.

Parameter	Beschrijving
`snapshot`	Optioneel. De momentopnameparameter is een ondoorzichtige waarde die, indien aanwezig, de blob-momentopname opgeeft waarop `DateTime` de laag moet worden ingesteld. Zie Een momentopname van een blob maken voor meer informatie over het werken met blob-momentopnamen
`versionid`	Optioneel voor versies 2019-12-12 en hoger. De parameter versionid is een ondoorzichtige waarde die, indien aanwezig, de versie van de blob opgeeft waarop `DateTime` de laag moet worden ingesteld.
`timeout`	Optioneel. De time-outparameter wordt uitgedrukt in seconden. Zie Time-outs instellen voor Blob Service-bewerkingen voor meer informatie.

Aanvraagheaders

In de volgende tabel worden de vereiste en optionele aanvraagheaders beschreven.

Aanvraagkoptekst	Description
`Authorization`	Vereist. Hiermee geeft u het autorisatieschema, de naam van het opslagaccount en de handtekening op. Zie Aanvragen voor toegang tot Azure Storage voor meer Azure Storage.
`Date` of `x-ms-date`	Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen voor toegang tot Azure Storage voor meer Azure Storage.
`x-ms-access-tier`	Vereist. Geeft de laag aan die moet worden ingesteld op de blob. Zie High performance Premium Storage and managed disks for VMs (Hoogwaardige en beheerde schijven voor VM's) voor een lijst met toegestane Premium-pagina-bloblagen. Voor blobopslag of een v2-account voor algemeen gebruik zijn geldige waarden `Hot` / `Cool` / `Archive` . Zie Opslaglagen voor Hot, Cool en Archive voor gedetailleerde informatie over opslaglagen op blobniveau van een standaardblobaccount.
`x-ms-version`	Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking moet worden gebruikt voor deze aanvraag. Zie Versioning for the Azure Storage Services (Versie Azure Storage Services) voor meer informatie.
`x-ms-client-request-id`	Optioneel. Biedt een door de client gegenereerde, ondoorzichtige waarde met een tekenlimiet van 1 kB die wordt vastgelegd in de analyselogboeken wanneer logboekregistratie van opslaganalyse is ingeschakeld. Het gebruik van deze header wordt ten zeerste aanbevolen voor het correleren van activiteiten aan clientzijde met aanvragen die door de server worden ontvangen. Zie About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests voor meer informatie.
`x-ms-rehydrate-priority`	Optioneel. Geeft de prioriteit aan waarmee een gearchiveerde blob moet worden gerehydrateerd. Ondersteund op versie 2019-02-02 en hoger voor blok-blobs. Geldige waarden zijn `High` / `Standard` . De prioriteit kan slechts één keer worden ingesteld op een blob voor versies vóór 2020-06-12; deze header wordt genegeerd bij volgende aanvragen. De standaardprioriteitsinstelling is `Standard` . Vanaf versie 2020-06-12 kan de prioriteit voor rehydratatie worden bijgewerkt nadat deze eerder is ingesteld. De prioriteitsinstelling kan worden gewijzigd van in door Bloblaag instellen aan te roepen met deze header ingesteld op en in te stellen op dezelfde `Standard` `High` waarde als eerder `High` `x-ms-access-tier` ingesteld. De prioriteitsinstelling kan niet worden verlaagd van `High` naar `Standard` .

Deze bewerking ondersteunt ook het gebruik van voorwaardelijke headers om de blob alleen in lagen op te lagen als aan een opgegeven voorwaarde wordt voldaan. Zie Specifying Conditional Headers for Blob Service Operations (Voorwaardelijke headers opgeven voor blobservicebewerkingen) voor meer informatie.

Aanvraagbody

Geen.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Statuscode

Een geslaagde bewerking retourneert statuscode 200 (OK) als de nieuwe laag onmiddellijk van kracht wordt, of statuscode 202 (Geaccepteerd) als de overgang naar de nieuwe laag in behandeling is. Voor de blobbewerking van het Premium-account retourneert de bewerking statuscode 200 (OK). Voor blok-blobs worden in de onderstaande tabel de HTTP-statuscodes beschreven die worden geretourneerd op basis van de huidige laag en de aangevraagde laag van de blob:

	Ingesteld op hot-laag	Ingesteld op cool-laag	Instellen op archieflaag
Blob in hot-laag	200	200	200
Blob in cool-laag	200	200	200
Blob in archieflaag	202	202	200
Blob in archieflaag, rehydrateren naar hot	202	409	409
Blob in archieflaag, rehydrateren naar cool	409	202	409

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Het antwoord voor deze bewerking bevat de onderstaande headers. Het antwoord kan ook aanvullende standaard HTTP-headers bevatten. Alle standaardheaders voldoen aan de HTTP/1.1-protocolspecificatie.

Reactieheader	Description
`x-ms-request-id`	Deze header identificeert op unieke manier de aanvraag die is gemaakt en kan worden gebruikt voor het oplossen van problemen met de aanvraag. Zie Troubleshooting API Operations (Problemen met API-bewerkingen oplossen) voor meer informatie.
`x-ms-version`	Geeft de versie aan van de Blob service gebruikt om de aanvraag uit te voeren. Deze header wordt geretourneerd voor aanvragen voor versie 2009-09-19 en hoger.
`x-ms-client-request-id`	Deze header kan worden gebruikt om problemen met aanvragen en bijbehorende antwoorden op te lossen. De waarde van deze header is gelijk aan de waarde van de header als deze aanwezig is in de aanvraag en de waarde uit `x-ms-client-request-id` 1024 zichtbare ASCII-tekens bestaat. Als de `x-ms-client-request-id` header niet aanwezig is in de aanvraag, is deze header niet aanwezig in het antwoord.

Autorisatie

Deze bewerking kan alleen worden aangeroepen door de eigenaar van het opslagaccount en door iedereen met een Shared Access Signature die toestemming heeft om naar deze blob of de container te schrijven.

Opmerkingen

Het instellen van de laag van een blob voor pagina-blobs in Premium-accounts heeft de volgende beperkingen:

De nieuwe bloblaag is mogelijk niet lager dan de bestaande.
De nieuwe bloblaag moet geschikt zijn voor de inhoudslengte van de blob. Zie High Performance Premium Storage managed disks for VMs (Hoge prestaties en beheerde schijven voor VM's) voor een lijst met lagen en toegestane inhoudslengte.

Voor het instellen van de blok-bloblaag voor een Blob Storage- of Algemeen v2-account gelden de volgende beperkingen:

Instellingslaag voor een momentopname is toegestaan vanaf REST-versie 2019-12-12.
Momentopnamen die zijn gelaagd voor archivering, kunnen niet worden gerehydrateerd naar de momentopname. bijvoorbeeld de momentopname kan niet worden teruggebracht naar de laag Hot/Cool. De enige manier om de gegevens op te halen uit een gearchiveerde momentopname of versie is door deze naar een nieuwe blob te kopiëren.
Als de versie een hoofd-blob is, kan deze weer worden gerehydrateerd naar Hot of Cool.
Momentopnamen of versies met een gearchiveerde status mogen niet worden gepromoveerd naar root.
Wanneer versieren is ingeschakeld, resulteert het verwijderen van de hoofd-blob in rehydratatie in behandeling in annulering van rehydratatie en heeft de versie de status Gearchiveerd.
Als een blob wordt overschreven wanneer deze de status In behandeling en Voorlopig verwijderd heeft, resulteert dit in annulering van rehydratatie en wordt de versie of voorlopig verwijderde momentopname gearchiveerd.

De lijst met ondersteunde lagen wordt niet beperkt door de aanvraagversie en nieuwe lagen kunnen in de toekomst worden toegevoegd.

Notitie