Blob-laag instellen

De Set Blob Tier bewerking stelt 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 blobopslag- 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//CoolArchive het opslagtype. Met deze bewerking wordt de ETag van de blob niet bijgewerkt.

Zie Dynamische, statische en archiefopslaglagen voor gedetailleerde informatie over lagen 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 parameter momentopname is een ondoorzichtige DateTime waarde die, wanneer aanwezig, de blob-momentopname opgeeft waarop de laag moet worden ingesteld. Zie Een momentopname van een blob maken voor meer informatie over het werken met blobmomentopnamen
versionid Optioneel voor versies 2019-12-12 en hoger. De parameter versionid is een ondoorzichtige DateTime waarde die, indien aanwezig, de versie van de blob specificeert waarop de laag moet worden ingesteld.
timeout Optioneel. De time-outparameter wordt uitgedrukt in seconden. Zie Time-outs voor blobservicebewerkingen instellen voor meer informatie.

Aanvraagheaders

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

Aanvraagkoptekst Beschrijving
Authorization Vereist. Hiermee geeft u het autorisatieschema, de naam van het opslagaccount en de handtekening op. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie.
Date of x-ms-date Vereist. Geef de Coordinated Universal Time (UTC) op voor de aanvraag. Zie Aanvragen voor Azure Storage autoriseren voor meer informatie.
x-ms-access-tier Vereist. Geeft aan dat de laag moet worden ingesteld voor de blob. Zie High Performance Premium Storage en beheerde schijven voor VM's voor een lijst met toegestane Premium-pagina-bloblagen. Voor blob-opslag of v2-account voor algemeen gebruik zijn Hot//CoolArchivegeldige waarden. Zie Dynamische, statische en archiefopslaglagen voor gedetailleerde informatie over opslaglagen op blob-niveau van standaardblobaccounts.
x-ms-version Vereist voor alle geautoriseerde aanvragen. Hiermee geeft u de versie van de bewerking te gebruiken voor deze aanvraag. Zie Versiebeheer voor de 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 Over Opslaganalyse logboekregistratie en Azure-logboekregistratie voor meer informatie: logboeken gebruiken om Storage aanvragen bij te houden.
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 eenmaal op een blob worden ingesteld voor versies vóór 2020-06-12; deze header wordt genegeerd voor volgende aanvragen. De standaardinstelling voor prioriteit is Standard.

Vanaf versie 2020-06-12 kan de reactivatieprioriteit worden bijgewerkt nadat deze eerder is ingesteld. De prioriteitsinstelling kan worden gewijzigd van Standard in High door set-bloblaag aan te roepen met deze header ingesteld op High en in te stellen x-ms-access-tier op dezelfde waarde als eerder ingesteld. De prioriteitsinstelling kan niet worden verlaagd van High naar Standard.

Deze bewerking ondersteunt ook het gebruik van voorwaardelijke headers om de blob alleen te tieren als aan een opgegeven voorwaarde wordt voldaan. Zie Voorwaardelijke headers opgeven voor Blob Service-bewerkingen 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 de Premium-accountpagina wordt statuscode 200 (OK) geretourneerd. Voor blok-blobs worden in de onderstaande tabel de HTTP-statuscodes beschreven die zijn geretourneerd op basis van de huidige laag en de aangevraagde laag van de blob:

Laag Instellen op dynamische laag Ingesteld op statische laag Instellen op archieflaag
Blob in dynamische laag 200 200 200
Blob in statische laag 200 200 200
Blob in archieflaag 202 202 200
Blob in archieflaag, reactiveren naar dynamisch 202 409 409
Blob in archieflaag, reactiveren naar statisch 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 Beschrijving
x-ms-request-id Deze header identificeert de aanvraag die is gemaakt en kan worden gebruikt voor het oplossen van problemen met de aanvraag. Zie Problemen met API-bewerkingen oplossen voor meer informatie.
x-ms-version Geeft de versie van de Blob-service aan die wordt gebruikt om de aanvraag uit te voeren. Deze header wordt geretourneerd voor aanvragen die zijn gedaan op basis van 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 x-ms-client-request-id header als deze aanwezig is in de aanvraag en de waarde maximaal 1024 zichtbare ASCII-tekens bevat. 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 gemachtigd is 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:

Het instellen van de laag van de blok-blob in een blobopslag- of v2-account voor algemeen gebruik heeft de volgende beperkingen:

  • Instellingslaag op een momentopname is toegestaan vanaf REST-versie 2019-12-12.
  • Momentopnamen die zijn gelaagd om te archiveren, kunnen niet opnieuw worden gerehydrateerd in de momentopname. De momentopname kan niet worden teruggezet naar de laag Dynamisch/Statisch. Alleen een manier om de gegevens op te halen uit een gearchiveerde momentopname of -versie is dat te kopiëren naar een nieuwe blob.
  • Als de versie een hoofd-blob is, kan deze weer worden gerehydrateerd naar Dynamisch of Statisch.
  • Momentopnamen of versies met de gearchiveerde status mogen niet worden gepromoveerd naar de hoofdmap.
  • Wanneer versiebeheer is ingeschakeld, zal het verwijderen van de hoofd-blob wanneer in rehydrate in behandeling is, leiden tot annulering van rehydrate en wordt de versie gearchiveerd.
  • Als een blob wordt overschreven wanneer een rehydrate in behandeling is en de status Softdeleted is, resulteert dit in annulering van rehydrate en heeft de versie of softdeleted snapshot de status Archived.

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

Notitie

Zie Dynamische, statische en archiefopslaglagen voor gedetailleerde informatie over lagen op blok-blobniveau.

Zie ook

Aanvragen voor Azure Storage autoriseren
Status- en foutcodes
Foutcodes voor blob-services
Time-outs instellen voor Blob Service-bewerkingen