Ange eller ändra åtkomstnivån för en blockblob med Java
Den här artikeln visar hur du anger eller ändrar åtkomstnivån för en blockblob med hjälp av Azure Storage-klientbiblioteket för Java.
Förutsättningar
- Den här artikeln förutsätter att du redan har ett projekt konfigurerat för att fungera med Azure Blob Storage-klientbiblioteket för Java. Mer information om hur du konfigurerar projektet, inklusive paketinstallation, tillägg
import
av direktiv och skapande av ett auktoriserat klientobjekt finns i Komma igång med Azure Storage och Java. - Auktoriseringsmekanismen måste ha behörighet att ange blobens åtkomstnivå. Mer information finns i auktoriseringsvägledningen för följande REST API-åtgärd:
Om blockblobåtkomstnivåer
För att hantera kostnader för lagringsbehov kan det vara bra att organisera dina data baserat på hur ofta de används och hur länge de behöver behållas. Azure Storage erbjuder olika åtkomstnivåer så att du kan lagra dina blobdata på det mest kostnadseffektiva sättet baserat på hur de används.
Åtkomstnivåer för blobdata
Azure Storage-åtkomstnivåer omfattar:
- Frekvent nivå – en onlinenivå som är optimerad för att lagra data som används eller ändras ofta. Den frekventa nivån har de högsta lagringskostnaderna, men de lägsta åtkomstkostnaderna.
- Lågfrekvent nivå – en onlinenivå som är optimerad för lagring av data som sällan används eller ändras. Data på lågfrekvent nivå ska lagras i minst 30 dagar. Den lågfrekventa nivån har lägre lagringskostnader och högre åtkomstkostnader jämfört med den frekventa nivån.
- Kall nivå – en onlinenivå som är optimerad för lagring av data som inte används sällan eller ändras. Data på nivån Infrekvent ska lagras i minst 90 dagar. Den infrekventa åtkomstnivån har lägre lagringskostnader och högre åtkomstkostnader jämfört med lågfrekvent lagringsnivå.
- Arkivnivå – en offlinenivå som är optimerad för lagring av data som sällan används och som har flexibla svarstidskrav i timmar. Data på arkivnivån ska lagras i minst 180 dagar.
Mer information om åtkomstnivåer finns i Åtkomstnivåer för blobdata.
Även om en blob finns på arkivåtkomstnivån anses den vara offline och kan inte läsas eller ändras. För att kunna läsa eller ändra data i en arkiverad blob måste du först extrahera bloben till en onlinenivå. Mer information om hur du extraherar en blob från arkivnivån till en onlinenivå finns i Blob rehydrering från arkivnivån.
Begränsningar
Att ange åtkomstnivån tillåts endast för blockblobar. Mer information om begränsningar för att ange en blockblobs åtkomstnivå finns i Ange BLOB-nivå (REST API).
Kommentar
Om du vill ange åtkomstnivån till Cold
java måste du använda en lägsta klientbiblioteksversion på 12.21.0.
Ange åtkomstnivån för en blob under uppladdningen
Du kan ange åtkomstnivån för en blob vid uppladdning med hjälp av klassen BlobUploadFromFileOptions . Följande kodexempel visar hur du anger åtkomstnivån när du laddar upp en blob:
public void uploadBlobWithAccessTier(BlobContainerClient blobContainerClient, Path filePath) {
String fileName = filePath.getFileName().toString();
BlobClient blobClient = blobContainerClient.getBlobClient(fileName);
BlobUploadFromFileOptions options = new BlobUploadFromFileOptions(filePath.toString())
.setTier(AccessTier.COOL);
try {
Response<BlockBlobItem> blockBlob = blobClient.uploadFromFileWithResponse(options, null, null);
} catch (UncheckedIOException ex) {
System.err.printf("Failed to upload from file: %s%n", ex.getMessage());
}
}
Mer information om hur du laddar upp en blob med Java finns i Ladda upp en blob med Java.
Ändra åtkomstnivån för en befintlig blockblob
Du kan ändra åtkomstnivån för en befintlig blockblob med någon av följande metoder:
I följande kodexempel visas hur du ändrar åtkomstnivån till Lågfrekvent för en befintlig blob:
public void changeBlobAccessTier(BlobClient blobClient) {
// Change the blob's access tier to cool
blobClient.setAccessTier(AccessTier.COOL);
}
Om du extraherar en arkiverad blob använder du metoden setAccessTierWithResponse . Ange parametern tier
till ett giltigt AccessTier-värde för HOT
, COOL
, COLD
eller ARCHIVE
. Du kan också ange parametern priority
till ett giltigt RehydratePriority-värde HIGH
eller STANDARD
.
I följande kodexempel visas hur du extraherar en arkiverad blob genom att ändra åtkomstnivån till Frekvent:
public void rehydrateBlobSetAccessTier(BlobClient blobClient) {
// Rehydrate the blob to hot tier using a standard rehydrate priority
blobClient.setAccessTierWithResponse(
AccessTier.HOT,
RehydratePriority.STANDARD,
null,
null,
null);
}
Metoden setAccessTierWithResponse kan också acceptera en BlobSetAccessTierOptions-parameter för att ange konfigurationsalternativ.
Kopiera en blob till en annan åtkomstnivå
Du kan ändra åtkomstnivån för en befintlig blockblob genom att ange en åtkomstnivå som en del av en kopieringsåtgärd. Om du vill ändra åtkomstnivån under en kopieringsåtgärd använder du klassen BlobBeginCopyOptions .
Du kan använda metoden setTier för att ange värdet AccessTier som HOT
, COOL
, COLD
eller ARCHIVE
. Om du extraherar en blob från arkivnivån med en kopieringsåtgärd använder du metoden setRehydratePriority för att ange värdet RehydratePriority som HIGH
eller STANDARD
.
I följande kodexempel visas hur du återställer en arkiverad blob till frekvent nivå med hjälp av en kopieringsåtgärd:
public void rehydrateBlobUsingCopy(
BlobClient sourceArchiveBlob,
BlobClient destinationRehydratedBlob) {
// Note: the destination blob must have a different name than the archived source blob
// Start the copy operation and wait for it to complete
final SyncPoller<BlobCopyInfo, Void> poller = destinationRehydratedBlob.beginCopy(
new BlobBeginCopyOptions(sourceArchiveBlob.getBlobUrl())
.setTier(AccessTier.HOT)
.setRehydratePriority(RehydratePriority.STANDARD));
PollResponse<BlobCopyInfo> response = poller
.waitUntil(LongRunningOperationStatus.SUCCESSFULLY_COMPLETED);
}
Mer information om hur du kopierar en blob med Java finns i Kopiera en blob med Java.
Resurser
Mer information om hur du ställer in åtkomstnivåer med hjälp av Azure Blob Storage-klientbiblioteket för Java finns i följande resurser.
REST API-åtgärder
Azure SDK för Java innehåller bibliotek som bygger på Azure REST API, så att du kan interagera med REST API-åtgärder via välbekanta Java-paradigm. Klientbiblioteksmetoderna för att ange åtkomstnivåer använder följande REST API-åtgärd:
- Ange blobnivå (REST API)
Klientbiblioteksresurser
Kodexempel
Se även
Feedback
https://aka.ms/ContentUserFeedback.
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i:Skicka och visa feedback för