BlockBlobClient Classe
- java.
lang. Object - com.
azure. storage. blob. specialized. BlobClientBase - com.
azure. storage. blob. specialized. BlockBlobClient
- com.
- com.
public final class BlockBlobClient
extends BlobClientBase
Client vers un objet blob de blocs. Il peut uniquement être instancié via un SpecializedBlobClientBuilder ou via la méthode getBlockBlobClient(). Cette classe ne contient aucun état sur un objet blob particulier, mais elle est plutôt un moyen pratique d’envoyer des requêtes appropriées à la ressource sur le service.
Pour plus d’informations, consultez Azure Docs .
Récapitulatif du champ
Modificateur et type | Champ et description |
---|---|
static final int |
MAX_BLOCKS
Indique le nombre maximal de blocs autorisé dans un objet blob de blocs. |
static final int |
MAX_STAGE_BLOCK_BYTES
Déprécié
Utilisez MAX_STAGE_BLOCK_BYTES_LONG.
Indique le nombre maximal d’octets pouvant être envoyés dans un appel à l’étape |
static final long |
MAX_STAGE_BLOCK_BYTES_LONG
Indique le nombre maximal d’octets pouvant être envoyés dans un appel à l’étape |
static final int |
MAX_UPLOAD_BLOB_BYTES
Déprécié
Utiliser MAX_STAGE_BLOCK_BYTES_LONG.
Indique le nombre maximal d’octets pouvant être envoyés dans un appel à charger. |
static final long |
MAX_UPLOAD_BLOB_BYTES_LONG
Indique le nombre maximal d’octets pouvant être envoyés dans un appel à charger. |
Résumé de la méthode
Modificateur et type | Méthode et description |
---|---|
Block |
commitBlockList(List<String> base64BlockIds)
Écrit un objet blob en spécifiant la liste des ID de bloc qui doivent créer l’objet blob. |
Block |
commitBlockList(List<String> base64BlockIds, boolean overwrite)
Écrit un objet blob en spécifiant la liste des ID de bloc qui doivent créer l’objet blob. |
Response<Block |
commitBlockListWithResponse(BlockBlobCommitBlockListOptions options, Duration timeout, Context context)
Écrit un objet blob en spécifiant la liste des ID de bloc qui doivent créer l’objet blob. |
Response<Block |
commitBlockListWithResponse(List<String> base64BlockIds, BlobHttpHeaders headers, Map<String,String> metadata, AccessTier tier, BlobRequestConditions requestConditions, Duration timeout, Context context)
Écrit un objet blob en spécifiant la liste des ID de bloc qui doivent créer l’objet blob. |
Blob |
getBlobOutputStream()
Crée et ouvre un flux de sortie pour écrire des données dans l’objet blob de blocs. |
Blob |
getBlobOutputStream(boolean overwrite)
Crée et ouvre un flux de sortie pour écrire des données dans l’objet blob de blocs. |
Blob |
getBlobOutputStream(BlobRequestConditions requestConditions)
Crée et ouvre un flux de sortie pour écrire des données dans l’objet blob de blocs. |
Blob |
getBlobOutputStream(ParallelTransferOptions parallelTransferOptions, BlobHttpHeaders headers, Map<String,String> metadata, AccessTier tier, BlobRequestConditions requestConditions)
Crée et ouvre un flux de sortie pour écrire des données dans l’objet blob de blocs. |
Blob |
getBlobOutputStream(BlockBlobOutputStreamOptions options)
Crée et ouvre un flux de sortie pour écrire des données dans l’objet blob de blocs. |
Blob |
getBlobOutputStream(BlockBlobOutputStreamOptions options, Context context)
Crée et ouvre un flux de sortie pour écrire des données dans l’objet blob de blocs. |
Block |
getCustomerProvidedKeyClient(CustomerProvidedKey customerProvidedKey)
Crée un nouveau BlockBlobClient avec le |
Block |
getEncryptionScopeClient(String encryptionScope)
Crée un nouveau BlockBlobClient avec le |
Block |
listBlocks(BlockListType listType)
Retourne la liste des blocs qui ont été chargés dans le cadre d’un objet blob de blocs à l’aide du filtre de liste de blocs spécifié. |
Response<Block |
listBlocksWithResponse(BlockListType listType, String leaseId, Duration timeout, Context context)
Retourne la liste des blocs qui ont été chargés dans le cadre d’un objet blob de blocs à l’aide du filtre de liste de blocs spécifié. |
Response<Block |
listBlocksWithResponse(BlockBlobListBlocksOptions options, Duration timeout, Context context)
Retourne la liste des blocs qui ont été chargés dans le cadre d’un objet blob de blocs à l’aide du filtre de liste de blocs spécifié. |
Seekable |
openSeekableByteChannelWrite(BlockBlobSeekableByteChannelWriteOptions options)
Ouvre un canal d’octets pouvant être recherché en mode écriture seule pour charger l’objet blob. |
void |
stageBlock(String base64BlockId, BinaryData data)
Charge le bloc spécifié dans la « zone de préproduction » de l’objet blob de blocs pour être validé ultérieurement par un appel à valider |
void |
stageBlock(String base64BlockId, InputStream data, long length)
Charge le bloc spécifié dans la « zone de préproduction » de l’objet blob de blocs pour être validé ultérieurement par un appel à valider |
void |
stageBlockFromUrl(String base64BlockId, String sourceUrl, BlobRange sourceRange)
Crée un bloc à commiter dans le cadre d’un objet blob où le contenu est lu à partir d’une URL. |
Response<Void> |
stageBlockFromUrlWithResponse(BlockBlobStageBlockFromUrlOptions options, Duration timeout, Context context)
Crée un bloc à commiter dans le cadre d’un objet blob où le contenu est lu à partir d’une URL. |
Response<Void> |
stageBlockFromUrlWithResponse(String base64BlockId, String sourceUrl, BlobRange sourceRange, byte[] sourceContentMd5, String leaseId, BlobRequestConditions sourceRequestConditions, Duration timeout, Context context)
Crée un bloc à commiter dans le cadre d’un objet blob où le contenu est lu à partir d’une URL. |
Response<Void> |
stageBlockWithResponse(BlockBlobStageBlockOptions options, Duration timeout, Context context)
Charge le bloc spécifié dans la « zone de préproduction » de l’objet blob de blocs pour être validé ultérieurement par un appel à valider |
Response<Void> |
stageBlockWithResponse(String base64BlockId, InputStream data, long length, byte[] contentMd5, String leaseId, Duration timeout, Context context)
Charge le bloc spécifié dans la « zone de préproduction » de l’objet blob de blocs pour être validé ultérieurement par un appel à valider |
Block |
upload(BinaryData data)
Crée un objet blob de blocs. |
Block |
upload(BinaryData data, boolean overwrite)
Crée un objet blob de blocs ou met à jour le contenu d’un objet blob de blocs existant. |
Block |
upload(InputStream data, long length)
Crée un objet blob de blocs. |
Block |
upload(InputStream data, long length, boolean overwrite)
Crée un objet blob de blocs ou met à jour le contenu d’un objet blob de blocs existant. |
Block |
uploadFromUrl(String sourceUrl)
Crée un objet blob de blocs ou met à jour le contenu d’un objet blob de blocs existant. |
Block |
uploadFromUrl(String sourceUrl, boolean overwrite)
Crée un objet blob de blocs ou met à jour le contenu d’un objet blob de blocs existant. |
Response<Block |
uploadFromUrlWithResponse(BlobUploadFromUrlOptions options, Duration timeout, Context context)
Crée un objet blob de blocs ou met à jour le contenu d’un objet blob de blocs existant. |
Response<Block |
uploadWithResponse(BlockBlobSimpleUploadOptions options, Duration timeout, Context context)
Crée un objet blob de blocs ou met à jour le contenu d’un objet blob de blocs existant. |
Response<Block |
uploadWithResponse(InputStream data, long length, BlobHttpHeaders headers, Map<String,String> metadata, AccessTier tier, byte[] contentMd5, BlobRequestConditions requestConditions, Duration timeout, Context context)
Crée un objet blob de blocs ou met à jour le contenu d’un objet blob de blocs existant. |
Méthodes héritées de BlobClientBase
Méthodes héritées de java.lang.Object
Détails du champ
MAX_BLOCKS
public static final int MAX_BLOCKS
Indique le nombre maximal de blocs autorisé dans un objet blob de blocs.
MAX_STAGE_BLOCK_BYTES
@Deprecated
public static final int MAX_STAGE_BLOCK_BYTES
Déprécié
Indique le nombre maximal d’octets pouvant être envoyés dans un appel à stageBlock.
MAX_STAGE_BLOCK_BYTES_LONG
public static final long MAX_STAGE_BLOCK_BYTES_LONG
Indique le nombre maximal d’octets pouvant être envoyés dans un appel à stageBlock.
MAX_UPLOAD_BLOB_BYTES
@Deprecated
public static final int MAX_UPLOAD_BLOB_BYTES
Déprécié
Indique le nombre maximal d’octets pouvant être envoyés dans un appel à charger.
MAX_UPLOAD_BLOB_BYTES_LONG
public static final long MAX_UPLOAD_BLOB_BYTES_LONG
Indique le nombre maximal d’octets pouvant être envoyés dans un appel à charger.
Détails de la méthode
commitBlockList
public BlockBlobItem commitBlockList(List
Écrit un objet blob en spécifiant la liste des ID de bloc qui doivent créer l’objet blob. Pour être écrit dans le cadre d’un objet blob, un bloc doit avoir été correctement écrit sur le serveur dans une opération stageBlock précédente. Vous pouvez appeler commitBlockList pour mettre à jour un objet blob en chargeant uniquement les blocs qui ont changé, puis en validant ensemble les blocs nouveaux et existants. Tous les blocs non spécifiés dans la liste de blocs et supprimés définitivement. Pour plus d’informations, consultez Azure Docs.
Exemples de code
System.out.printf("Committing block list completed. Last modified: %s%n",
client.commitBlockList(Collections.singletonList(base64BlockId)).getLastModified());
Paramètres:
String
en base64 qui spécifie les ID de bloc à commiter.
Retours:
commitBlockList
public BlockBlobItem commitBlockList(List
Écrit un objet blob en spécifiant la liste des ID de bloc qui doivent créer l’objet blob. Pour être écrit dans le cadre d’un objet blob, un bloc doit avoir été correctement écrit sur le serveur dans une opération stageBlock précédente. Vous pouvez appeler commitBlockList pour mettre à jour un objet blob en chargeant uniquement les blocs qui ont changé, puis en validant ensemble les blocs nouveaux et existants. Tous les blocs non spécifiés dans la liste de blocs et supprimés définitivement. Pour plus d’informations, consultez Azure Docs.
Exemples de code
boolean overwrite = false; // Default behavior
System.out.printf("Committing block list completed. Last modified: %s%n",
client.commitBlockList(Collections.singletonList(base64BlockId), overwrite).getLastModified());
Paramètres:
String
en base64 qui spécifie les ID de bloc à commiter.
Retours:
commitBlockListWithResponse
public Response
Écrit un objet blob en spécifiant la liste des ID de bloc qui doivent créer l’objet blob. Pour être écrit dans le cadre d’un objet blob, un bloc doit avoir été correctement écrit sur le serveur dans une opération stageBlock précédente. Vous pouvez appeler commitBlockList pour mettre à jour un objet blob en chargeant uniquement les blocs qui ont changé, puis en validant ensemble les blocs nouveaux et existants. Tous les blocs non spécifiés dans la liste de blocs et supprimés définitivement. Pour plus d’informations, consultez Azure Docs.
Pour éviter le remplacement, passez « * » à setIfNoneMatch(String ifNoneMatch).
Exemples de code
BlobHttpHeaders headers = new BlobHttpHeaders()
.setContentMd5("data".getBytes(StandardCharsets.UTF_8))
.setContentLanguage("en-US")
.setContentType("binary");
Map<String, String> metadata = Collections.singletonMap("metadata", "value");
Map<String, String> tags = Collections.singletonMap("tag", "value");
BlobRequestConditions requestConditions = new BlobRequestConditions()
.setLeaseId(leaseId)
.setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
Context context = new Context("key", "value");
System.out.printf("Committing block list completed with status %d%n",
client.commitBlockListWithResponse(
new BlockBlobCommitBlockListOptions(Collections.singletonList(base64BlockId)).setHeaders(headers)
.setMetadata(metadata).setTags(tags).setTier(AccessTier.HOT)
.setRequestConditions(requestConditions), timeout, context)
.getStatusCode());
Paramètres:
Retours:
commitBlockListWithResponse
public Response
Écrit un objet blob en spécifiant la liste des ID de bloc qui doivent créer l’objet blob. Pour être écrit dans le cadre d’un objet blob, un bloc doit avoir été correctement écrit sur le serveur dans une opération stageBlock précédente. Vous pouvez appeler commitBlockList pour mettre à jour un objet blob en chargeant uniquement les blocs qui ont changé, puis en validant ensemble les blocs nouveaux et existants. Tous les blocs non spécifiés dans la liste de blocs et supprimés définitivement. Pour plus d’informations, consultez Azure Docs.
Pour éviter le remplacement, passez « * » à setIfNoneMatch(String ifNoneMatch).
Exemples de code
BlobHttpHeaders headers = new BlobHttpHeaders()
.setContentMd5(MessageDigest.getInstance("MD5").digest("data".getBytes(StandardCharsets.UTF_8)))
.setContentLanguage("en-US")
.setContentType("binary");
Map<String, String> metadata = Collections.singletonMap("metadata", "value");
BlobRequestConditions requestConditions = new BlobRequestConditions()
.setLeaseId(leaseId)
.setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
Context context = new Context("key", "value");
System.out.printf("Committing block list completed with status %d%n",
client.commitBlockListWithResponse(Collections.singletonList(base64BlockId), headers, metadata,
AccessTier.HOT, requestConditions, timeout, context).getStatusCode());
Paramètres:
String
en base64 qui spécifie les ID de bloc à commiter.
Retours:
getBlobOutputStream
public BlobOutputStream getBlobOutputStream()
Crée et ouvre un flux de sortie pour écrire des données dans l’objet blob de blocs.
Remarque : Nous vous recommandons d’appeler write avec des mémoires tampons de taille raisonnable. Vous pouvez le faire en encapsulant le BlobOutputStream obtenu ci-dessous avec un BufferedOutputStream.
Retours:
getBlobOutputStream
public BlobOutputStream getBlobOutputStream(boolean overwrite)
Crée et ouvre un flux de sortie pour écrire des données dans l’objet blob de blocs.
Remarque : Nous vous recommandons d’appeler write avec des mémoires tampons de taille raisonnable. Vous pouvez le faire en encapsulant le BlobOutputStream obtenu ci-dessous avec un BufferedOutputStream.
Paramètres:
Retours:
getBlobOutputStream
public BlobOutputStream getBlobOutputStream(BlobRequestConditions requestConditions)
Crée et ouvre un flux de sortie pour écrire des données dans l’objet blob de blocs. Si l’objet blob existe déjà sur le service, il est remplacé.
Pour éviter le remplacement, passez « * » à setIfNoneMatch(String ifNoneMatch).
Remarque : Nous vous recommandons d’appeler write avec des mémoires tampons de taille raisonnable. Vous pouvez le faire en encapsulant le BlobOutputStream obtenu ci-dessous avec un BufferedOutputStream.
Paramètres:
Retours:
getBlobOutputStream
public BlobOutputStream getBlobOutputStream(ParallelTransferOptions parallelTransferOptions, BlobHttpHeaders headers, Map
Crée et ouvre un flux de sortie pour écrire des données dans l’objet blob de blocs. Si l’objet blob existe déjà sur le service, il est remplacé.
Pour éviter le remplacement, passez « * » à setIfNoneMatch(String ifNoneMatch).
Remarque : Nous vous recommandons d’appeler write avec des mémoires tampons de taille raisonnable. Vous pouvez le faire en encapsulant le BlobOutputStream obtenu ci-dessous avec un BufferedOutputStream.
Paramètres:
Retours:
getBlobOutputStream
public BlobOutputStream getBlobOutputStream(BlockBlobOutputStreamOptions options)
Crée et ouvre un flux de sortie pour écrire des données dans l’objet blob de blocs. Si l’objet blob existe déjà sur le service, il est remplacé.
Pour éviter le remplacement, passez « * » à setIfNoneMatch(String ifNoneMatch).
Remarque : Nous vous recommandons d’appeler write avec des mémoires tampons de taille raisonnable. Vous pouvez le faire en encapsulant le BlobOutputStream obtenu ci-dessous avec un BufferedOutputStream.
Paramètres:
Retours:
getBlobOutputStream
public BlobOutputStream getBlobOutputStream(BlockBlobOutputStreamOptions options, Context context)
Crée et ouvre un flux de sortie pour écrire des données dans l’objet blob de blocs. Si l’objet blob existe déjà sur le service, il est remplacé.
Pour éviter le remplacement, passez « * » à setIfNoneMatch(String ifNoneMatch).
Remarque : Nous vous recommandons d’appeler write avec des mémoires tampons de taille raisonnable. Vous pouvez le faire en encapsulant le BlobOutputStream obtenu ci-dessous avec un BufferedOutputStream.
Paramètres:
Retours:
getCustomerProvidedKeyClient
public BlockBlobClient getCustomerProvidedKeyClient(CustomerProvidedKey customerProvidedKey)
Crée un nouveau BlockBlobClient avec le customerProvidedKey
spécifié.
Remplacements:
BlockBlobClient.getCustomerProvidedKeyClient(CustomerProvidedKey customerProvidedKey)Paramètres:
null
pour utiliser aucune clé fournie par le CustomerProvidedKey client.
Retours:
customerProvidedKey
.getEncryptionScopeClient
public BlockBlobClient getEncryptionScopeClient(String encryptionScope)
Crée un nouveau BlockBlobClient avec le encryptionScope
spécifié.
Remplacements:
BlockBlobClient.getEncryptionScopeClient(String encryptionScope)Paramètres:
null
pour utiliser aucune étendue de chiffrement.
Retours:
encryptionScope
.listBlocks
public BlockList listBlocks(BlockListType listType)
Retourne la liste des blocs qui ont été chargés dans le cadre d’un objet blob de blocs à l’aide du filtre de liste de blocs spécifié. Pour plus d’informations, consultez Azure Docs.
Exemples de code
BlockList block = client.listBlocks(BlockListType.ALL);
System.out.println("Committed Blocks:");
block.getCommittedBlocks().forEach(b -> System.out.printf("Name: %s, Size: %d", b.getName(), b.getSizeLong()));
System.out.println("Uncommitted Blocks:");
block.getUncommittedBlocks().forEach(b -> System.out.printf("Name: %s, Size: %d", b.getName(), b.getSizeLong()));
Paramètres:
Retours:
listBlocksWithResponse
public Response
Retourne la liste des blocs qui ont été chargés dans le cadre d’un objet blob de blocs à l’aide du filtre de liste de blocs spécifié. Pour plus d’informations, consultez Azure Docs.
Exemples de code
Context context = new Context("key", "value");
BlockList block = client.listBlocksWithResponse(BlockListType.ALL, leaseId, timeout, context).getValue();
System.out.println("Committed Blocks:");
block.getCommittedBlocks().forEach(b -> System.out.printf("Name: %s, Size: %d", b.getName(), b.getSizeLong()));
System.out.println("Uncommitted Blocks:");
block.getUncommittedBlocks().forEach(b -> System.out.printf("Name: %s, Size: %d", b.getName(), b.getSizeLong()));
Paramètres:
Retours:
listBlocksWithResponse
public Response
Retourne la liste des blocs qui ont été chargés dans le cadre d’un objet blob de blocs à l’aide du filtre de liste de blocs spécifié. Pour plus d’informations, consultez Azure Docs.
Exemples de code
Context context = new Context("key", "value");
BlockList block = client.listBlocksWithResponse(new BlockBlobListBlocksOptions(BlockListType.ALL)
.setLeaseId(leaseId)
.setIfTagsMatch(tags), timeout, context).getValue();
System.out.println("Committed Blocks:");
block.getCommittedBlocks().forEach(b -> System.out.printf("Name: %s, Size: %d", b.getName(), b.getSizeLong()));
System.out.println("Uncommitted Blocks:");
block.getUncommittedBlocks().forEach(b -> System.out.printf("Name: %s, Size: %d", b.getName(), b.getSizeLong()));
Paramètres:
Retours:
openSeekableByteChannelWrite
public SeekableByteChannel openSeekableByteChannelWrite(BlockBlobSeekableByteChannelWriteOptions options)
Ouvre un canal d’octets pouvant être recherché en mode écriture seule pour charger l’objet blob.
Paramètres:
Retours:
SeekableByteChannel
qui représente le canal à utiliser pour écrire dans l’objet blob.stageBlock
public void stageBlock(String base64BlockId, BinaryData data)
Charge le bloc spécifié dans la « zone intermédiaire » de l’objet blob de blocs pour être validé ultérieurement par un appel à commitBlockList. Pour plus d’informations, consultez Azure Docs.
Exemples de code
BinaryData binaryData = BinaryData.fromStream(data, length);
client.stageBlock(base64BlockId, binaryData);
Paramètres:
String
en Base64 qui spécifie l’ID de ce bloc. Notez que tous les ID de bloc d’un objet blob donné doivent avoir la même longueur.
BinaryData
doit avoir une longueur définie et doit être relue si les nouvelles tentatives sont activées (valeur par défaut). Consultez BinaryData#isReplayable().
stageBlock
public void stageBlock(String base64BlockId, InputStream data, long length)
Charge le bloc spécifié dans la « zone intermédiaire » de l’objet blob de blocs pour être validé ultérieurement par un appel à commitBlockList. Pour plus d’informations, consultez Azure Docs.
Exemples de code
client.stageBlock(base64BlockId, data, length);
Paramètres:
String
en Base64 qui spécifie l’ID de ce bloc. Notez que tous les ID de bloc d’un objet blob donné doivent avoir la même longueur.
stageBlockFromUrl
public void stageBlockFromUrl(String base64BlockId, String sourceUrl, BlobRange sourceRange)
Crée un bloc à commiter dans le cadre d’un objet blob où le contenu est lu à partir d’une URL. Pour plus d’informations, consultez Azure Docs.
Exemples de code
client.stageBlockFromUrl(base64BlockId, sourceUrl, new BlobRange(offset, count));
Paramètres:
String
en Base64 qui spécifie l’ID de ce bloc. Notez que tous les ID de bloc d’un objet blob donné doivent avoir la même longueur.
stageBlockFromUrlWithResponse
public Response
Crée un bloc à commiter dans le cadre d’un objet blob où le contenu est lu à partir d’une URL. Pour plus d’informations, consultez Azure Docs.
Exemples de code
BlobRequestConditions sourceRequestConditions = new BlobRequestConditions()
.setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
Context context = new Context("key", "value");
System.out.printf("Staging block from URL completed with status %d%n",
client.stageBlockFromUrlWithResponse(new BlockBlobStageBlockFromUrlOptions(base64BlockId, sourceUrl)
.setSourceRange(new BlobRange(offset, count)).setLeaseId(leaseId)
.setSourceRequestConditions(sourceRequestConditions), timeout, context).getStatusCode());
Paramètres:
Retours:
stageBlockFromUrlWithResponse
public Response
Crée un bloc à commiter dans le cadre d’un objet blob où le contenu est lu à partir d’une URL. Pour plus d’informations, consultez Azure Docs.
Exemples de code
BlobRequestConditions sourceRequestConditions = new BlobRequestConditions()
.setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
Context context = new Context("key", "value");
System.out.printf("Staging block from URL completed with status %d%n",
client.stageBlockFromUrlWithResponse(base64BlockId, sourceUrl, new BlobRange(offset, count), null,
leaseId, sourceRequestConditions, timeout, context).getStatusCode());
Paramètres:
String
en Base64 qui spécifie l’ID de ce bloc. Notez que tous les ID de bloc d’un objet blob donné doivent avoir la même longueur.
Retours:
stageBlockWithResponse
public Response
Charge le bloc spécifié dans la « zone intermédiaire » de l’objet blob de blocs pour être validé ultérieurement par un appel à commitBlockList. Pour plus d’informations, consultez Azure Docs.
Exemples de code
Context context = new Context("key", "value");
BinaryData binaryData = BinaryData.fromStream(data, length);
BlockBlobStageBlockOptions options = new BlockBlobStageBlockOptions(base64BlockId, binaryData)
.setContentMd5(md5)
.setLeaseId(leaseId);
System.out.printf("Staging block completed with status %d%n",
client.stageBlockWithResponse(options, timeout, context).getStatusCode());
Paramètres:
Retours:
stageBlockWithResponse
public Response
Charge le bloc spécifié dans la « zone intermédiaire » de l’objet blob de blocs pour être validé ultérieurement par un appel à commitBlockList. Pour plus d’informations, consultez Azure Docs.
Exemples de code
Context context = new Context("key", "value");
System.out.printf("Staging block completed with status %d%n",
client.stageBlockWithResponse(base64BlockId, data, length, md5, leaseId, timeout, context).getStatusCode());
Paramètres:
String
en Base64 qui spécifie l’ID de ce bloc. Notez que tous les ID de bloc d’un objet blob donné doivent avoir la même longueur.
Retours:
upload
public BlockBlobItem upload(BinaryData data)
Crée un objet blob de blocs. Par défaut, cette méthode ne remplace pas un objet blob existant. La mise à jour d'un objet blob de blocs existant remplace toutes les métadonnées existantes de l'objet blob. Les mises à jour partielles ne sont pas prises en charge avec PutBlob ; le contenu de l’objet blob existant est remplacé par le nouveau contenu. Pour effectuer une mise à jour partielle d’un objet blob de blocs, utilisez PutBlock et PutBlockList. Pour plus d’informations, consultez Azure Docs.
Exemples de code
BinaryData binaryData = BinaryData.fromStream(data, length);
System.out.printf("Uploaded BlockBlob MD5 is %s%n",
Base64.getEncoder().encodeToString(client.upload(binaryData).getContentMd5()));
Paramètres:
BinaryData
doit avoir une longueur définie et doit être relectable si les nouvelles tentatives sont activées (la valeur par défaut), consultez BinaryData#isReplayable().
Retours:
upload
public BlockBlobItem upload(BinaryData data, boolean overwrite)
Crée un objet blob de blocs ou met à jour le contenu d’un objet blob de blocs existant. La mise à jour d'un objet blob de blocs existant remplace toutes les métadonnées existantes de l'objet blob. Les mises à jour partielles ne sont pas prises en charge avec PutBlob ; le contenu de l’objet blob existant est remplacé par le nouveau contenu. Pour effectuer une mise à jour partielle d’un objet blob de blocs, utilisez PutBlock et PutBlockList. Pour plus d’informations, consultez Azure Docs.
Exemples de code
boolean overwrite = false;
BinaryData binaryData = BinaryData.fromStream(data, length);
System.out.printf("Uploaded BlockBlob MD5 is %s%n",
Base64.getEncoder().encodeToString(client.upload(binaryData, overwrite).getContentMd5()));
Paramètres:
BinaryData
doit avoir une longueur définie et doit être relectable si les nouvelles tentatives sont activées (la valeur par défaut), consultez BinaryData#isReplayable().
Retours:
upload
public BlockBlobItem upload(InputStream data, long length)
Crée un objet blob de blocs. Par défaut, cette méthode ne remplace pas un objet blob existant. La mise à jour d'un objet blob de blocs existant remplace toutes les métadonnées existantes de l'objet blob. Les mises à jour partielles ne sont pas prises en charge avec PutBlob ; le contenu de l’objet blob existant est remplacé par le nouveau contenu. Pour effectuer une mise à jour partielle d’un objet blob de blocs, utilisez PutBlock et PutBlockList. Pour plus d’informations, consultez Azure Docs.
Exemples de code
System.out.printf("Uploaded BlockBlob MD5 is %s%n",
Base64.getEncoder().encodeToString(client.upload(data, length).getContentMd5()));
Paramètres:
Retours:
upload
public BlockBlobItem upload(InputStream data, long length, boolean overwrite)
Crée un objet blob de blocs ou met à jour le contenu d’un objet blob de blocs existant. La mise à jour d'un objet blob de blocs existant remplace toutes les métadonnées existantes de l'objet blob. Les mises à jour partielles ne sont pas prises en charge avec PutBlob ; le contenu de l’objet blob existant est remplacé par le nouveau contenu. Pour effectuer une mise à jour partielle d’un objet blob de blocs, utilisez PutBlock et PutBlockList. Pour plus d’informations, consultez Azure Docs.
Exemples de code
boolean overwrite = false;
System.out.printf("Uploaded BlockBlob MD5 is %s%n",
Base64.getEncoder().encodeToString(client.upload(data, length, overwrite).getContentMd5()));
Paramètres:
Retours:
uploadFromUrl
public BlockBlobItem uploadFromUrl(String sourceUrl)
Crée un objet blob de blocs ou met à jour le contenu d’un objet blob de blocs existant.
La mise à jour d'un objet blob de blocs existant remplace toutes les métadonnées existantes de l'objet blob. Les mises à jour partielles ne sont pas prises en charge avec PutBlobFromUrl ; le contenu de l’objet blob existant est remplacé par le nouveau contenu. Pour plus d’informations, consultez Azure Docs.
Exemples de code
System.out.printf("Uploaded BlockBlob from URL, MD5 is %s%n",
Base64.getEncoder().encodeToString(client.uploadFromUrl(sourceUrl).getContentMd5()));
Paramètres:
Retours:
uploadFromUrl
public BlockBlobItem uploadFromUrl(String sourceUrl, boolean overwrite)
Crée un objet blob de blocs ou met à jour le contenu d’un objet blob de blocs existant.
La mise à jour d'un objet blob de blocs existant remplace toutes les métadonnées existantes de l'objet blob. Les mises à jour partielles ne sont pas prises en charge avec PutBlobFromUrl ; le contenu de l’objet blob existant est remplacé par le nouveau contenu. Pour plus d’informations, consultez Azure Docs.
Exemples de code
boolean overwrite = false;
System.out.printf("Uploaded BlockBlob from URL, MD5 is %s%n",
Base64.getEncoder().encodeToString(client.uploadFromUrl(sourceUrl, overwrite).getContentMd5()));
Paramètres:
Retours:
uploadFromUrlWithResponse
public Response
Crée un objet blob de blocs ou met à jour le contenu d’un objet blob de blocs existant.
La mise à jour d'un objet blob de blocs existant remplace toutes les métadonnées existantes de l'objet blob. Les mises à jour partielles ne sont pas prises en charge avec PutBlobFromUrl ; le contenu de l’objet blob existant est remplacé par le nouveau contenu. Pour plus d’informations, consultez Azure Docs.
Pour éviter le remplacement, passez « * » à setIfNoneMatch(String ifNoneMatch).
Exemples de code
BlobHttpHeaders headers = new BlobHttpHeaders()
.setContentMd5(MessageDigest.getInstance("MD5").digest("data".getBytes(StandardCharsets.UTF_8)))
.setContentLanguage("en-US")
.setContentType("binary");
Map<String, String> metadata = Collections.singletonMap("metadata", "value");
Map<String, String> tags = Collections.singletonMap("tag", "value");
byte[] md5 = MessageDigest.getInstance("MD5").digest("data".getBytes(StandardCharsets.UTF_8));
BlobRequestConditions requestConditions = new BlobRequestConditions()
.setLeaseId(leaseId)
.setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
Context context = new Context("key", "value");
System.out.printf("Uploaded BlockBlob MD5 is %s%n", Base64.getEncoder()
.encodeToString(client.uploadFromUrlWithResponse(new BlobUploadFromUrlOptions(sourceUrl)
.setHeaders(headers).setTags(tags).setTier(AccessTier.HOT).setContentMd5(md5)
.setDestinationRequestConditions(requestConditions), timeout, context)
.getValue()
.getContentMd5()));
Paramètres:
Retours:
uploadWithResponse
public Response
Crée un objet blob de blocs ou met à jour le contenu d’un objet blob de blocs existant. La mise à jour d'un objet blob de blocs existant remplace toutes les métadonnées existantes de l'objet blob. Les mises à jour partielles ne sont pas prises en charge avec PutBlob ; le contenu de l’objet blob existant est remplacé par le nouveau contenu. Pour effectuer une mise à jour partielle d’un objet blob de blocs, utilisez PutBlock et PutBlockList. Pour plus d’informations, consultez Azure Docs.
Pour éviter le remplacement, passez « * » à setIfNoneMatch(String ifNoneMatch).
Exemples de code
BlobHttpHeaders headers = new BlobHttpHeaders()
.setContentMd5(MessageDigest.getInstance("MD5").digest("data".getBytes(StandardCharsets.UTF_8)))
.setContentLanguage("en-US")
.setContentType("binary");
Map<String, String> metadata = Collections.singletonMap("metadata", "value");
Map<String, String> tags = Collections.singletonMap("tag", "value");
byte[] md5 = MessageDigest.getInstance("MD5").digest("data".getBytes(StandardCharsets.UTF_8));
BlobRequestConditions requestConditions = new BlobRequestConditions()
.setLeaseId(leaseId)
.setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
Context context = new Context("key", "value");
System.out.printf("Uploaded BlockBlob MD5 is %s%n", Base64.getEncoder()
.encodeToString(client.uploadWithResponse(new BlockBlobSimpleUploadOptions(data, length)
.setHeaders(headers).setMetadata(metadata).setTags(tags).setTier(AccessTier.HOT).setContentMd5(md5)
.setRequestConditions(requestConditions), timeout, context)
.getValue()
.getContentMd5()));
Paramètres:
Retours:
uploadWithResponse
public Response
Crée un objet blob de blocs ou met à jour le contenu d’un objet blob de blocs existant. La mise à jour d'un objet blob de blocs existant remplace toutes les métadonnées existantes de l'objet blob. Les mises à jour partielles ne sont pas prises en charge avec PutBlob ; le contenu de l’objet blob existant est remplacé par le nouveau contenu. Pour effectuer une mise à jour partielle d’un objet blob de blocs, utilisez PutBlock et PutBlockList. Pour plus d’informations, consultez Azure Docs.
Pour éviter le remplacement, passez « * » à setIfNoneMatch(String ifNoneMatch).
Exemples de code
BlobHttpHeaders headers = new BlobHttpHeaders()
.setContentMd5(MessageDigest.getInstance("MD5").digest("data".getBytes(StandardCharsets.UTF_8)))
.setContentLanguage("en-US")
.setContentType("binary");
Map<String, String> metadata = Collections.singletonMap("metadata", "value");
byte[] md5 = MessageDigest.getInstance("MD5").digest("data".getBytes(StandardCharsets.UTF_8));
BlobRequestConditions requestConditions = new BlobRequestConditions()
.setLeaseId(leaseId)
.setIfUnmodifiedSince(OffsetDateTime.now().minusDays(3));
Context context = new Context("key", "value");
System.out.printf("Uploaded BlockBlob MD5 is %s%n", Base64.getEncoder()
.encodeToString(client.uploadWithResponse(data, length, headers, metadata, AccessTier.HOT, md5,
requestConditions, timeout, context)
.getValue()
.getContentMd5()));
Paramètres:
Retours:
S’applique à
Azure SDK for Java