Partager via

CloudBlob Classe

  • Référence
Paquet:
com.microsoft.azure.storage.blob
  • java.lang.Object

public class CloudBlob implements ListBlobItem

Représente un objet blob Microsoft Azure. Il s’agit de la classe de base pour les CloudBlockBlob classes et CloudPageBlob .

Récapitulatif du champ

Modificateur et type Champ et description
CloudBlobClient blobServiceClient

Représente le client d’objets blob.

CloudBlobDirectory parent

Représente le répertoire de l’objet blob.

int streamMinimumReadSizeInBytes

Contient la taille de lecture minimale lors de l’utilisation d’un BlobInputStream.

int streamWriteSizeInBytes

Contient le nombre d’octets à mettre en mémoire tampon lors de l’écriture dans un BlobOutputStream (objets blob de blocs et de pages).

Récapitulatif du constructeur

Constructeur Description
CloudBlob(final BlobType type, final StorageUri uri, final String snapshotID, final StorageCredentials credentials)

Crée un instance de la classe à l’aide de l’URI, de l’ID instantané et du client d’objet blob cloud spécifiés.
CloudBlob(final BlobType type, String blobName, String snapshotID, CloudBlobContainer container)

Crée une instance de la classe à l’aide du type, du nom, de l’ID instantané et du conteneur spécifiés.
CloudBlob(final CloudBlob otherBlob)

Crée une instance de la classe en copiant les valeurs d’un autre objet blob.

Résumé de la méthode

Modificateur et type Méthode et description
final void abortCopy(final String copyId)

Interrompt une opération de copie d'objet blob en cours.
final void abortCopy(final String copyId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Interrompt une opération de copie d'objet blob en cours.
final String acquireLease()

Acquiert un nouveau bail infini sur l’objet blob.
final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId)

Acquiert un nouveau bail sur l’objet blob avec la durée de bail spécifiée et l’ID de bail proposé.
final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Acquiert un nouveau bail sur l’objet blob avec l’heure de bail, l’ID de bail proposé, les options de demande et le contexte d’opération spécifiés.
final void assertCorrectBlobType()

Affirme que l’objet blob a le type d’objet blob correct spécifié dans les attributs d’objet blob.
void assertNoWriteOperationForSnapshot()

Affirme que l’opération d’écriture n’est pas effectuée pour instantané.

final long breakLease(final Integer breakPeriodInSeconds)

Interrompt le bail et s’assure qu’un autre client ne peut pas acquérir un nouveau bail tant que la période de bail actuelle n’a pas expiré.
final long breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Interrompt le bail existant, en utilisant les options de demande et le contexte d’opération spécifiés, et garantit qu’un autre client ne peut pas acquérir un nouveau bail tant que la période de bail actuelle n’a pas expiré.
final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition)

Remplace l’ID de bail existant par l’ID de bail proposé.
final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Remplace l’ID de bail existant par l’ID de bail proposé avec les conditions d’accès, les options de demande et le contexte d’opération spécifiés.
final CloudBlob createSnapshot()

Crée un instantané de l'objet blob.
final CloudBlob createSnapshot(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Crée une instantané de l’objet blob à l’aide des options de requête et du contexte d’opération spécifiés.
final CloudBlob createSnapshot(final HashMap<String, String> metadata, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Crée une instantané de l’objet blob à l’aide des options de requête et du contexte d’opération spécifiés.
final void delete()

Supprime l'objet blob.

Si une stratégie de rétention de suppression est activée sur le service, l’objet blob est conservé pendant une période spécifiée, avant d’être supprimé définitivement par garbage collection.
final void delete(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Supprime l’objet blob à l’aide des options de instantané et de requête spécifiées, ainsi que du contexte d’opération.

Si une stratégie de rétention de suppression est activée sur le service, l’objet blob est conservé pendant une période spécifiée, avant d’être supprimé définitivement par garbage collection.

Un objet blob associé à des instantanés ne peut pas être supprimé, à moins de supprimer aussi les instantanés. Si un objet blob a des instantanés, utilisez la DELETE_SNAPSHOTS_ONLY valeur ou INCLUDE_SNAPSHOTS dans le paramètre pour spécifier la façon dont les instantanés doivent être gérés lorsque l’objet blob est supprimé.
final boolean deleteIfExists()

Supprime l’objet blob s’il existe.

Un objet blob associé à des instantanés ne peut pas être supprimé, à moins de supprimer aussi les instantanés. Si un objet blob a des instantanés, utilisez la DELETE_SNAPSHOTS_ONLY valeur ou INCLUDE_SNAPSHOTS dans le paramètre pour spécifier la façon dont les instantanés doivent être gérés lorsque l’objet blob est supprimé.
final boolean deleteIfExists(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Supprime l’objet blob s’il existe, à l’aide des options de instantané et de requête spécifiées, ainsi que du contexte d’opération.

Un objet blob associé à des instantanés ne peut pas être supprimé, à moins de supprimer aussi les instantanés. Si un objet blob a des instantanés, utilisez la DELETE_SNAPSHOTS_ONLY valeur ou INCLUDE_SNAPSHOTS dans le paramètre pour spécifier la façon dont les instantanés doivent être gérés lorsque l’objet blob est supprimé.
final void download(final OutputStream outStream)

Télécharge le contenu d'un objet blob vers un flux de données.
final void download(final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Télécharge le contenu d’un objet blob dans un flux à l’aide des options de requête et du contexte d’opération spécifiés.
AccountInformation downloadAccountInfo()

Obtient des informations relatives au compte de stockage dans lequel réside cet objet blob.
AccountInformation downloadAccountInfo(BlobRequestOptions options, OperationContext opContext)

Obtient des informations relatives au compte de stockage dans lequel réside cet objet blob.
StorageRequest<ServiceClient, CloudBlob, AccountInformation> downloadAccountInformationImpl(final RequestOptions options)
final void downloadAttributes()

Remplit les propriétés et les métadonnées d'un objet blob.

Cette méthode remplit les propriétés système de l’objet blob et les métadonnées définies par l’utilisateur. Avant de lire ou de modifier les propriétés ou métadonnées d’un objet blob, appelez cette méthode ou sa surcharge pour récupérer les dernières valeurs des propriétés et métadonnées de l’objet blob à partir du service de stockage Microsoft Azure.
final void downloadAttributes(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Remplit les propriétés et métadonnées d’un objet blob à l’aide des options de requête et du contexte d’opération spécifiés.

Cette méthode remplit les propriétés système de l’objet blob et les métadonnées définies par l’utilisateur. Avant de lire ou de modifier les propriétés ou métadonnées d’un objet blob, appelez cette méthode ou sa surcharge pour récupérer les dernières valeurs des propriétés et métadonnées de l’objet blob à partir du service de stockage Microsoft Azure.
final void downloadRange(final long offset, final Long length, final OutputStream outStream)

Télécharge le contenu d'un objet blob vers un flux de données.
final void downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Télécharge le contenu d’un objet blob dans un flux à l’aide des options de requête et du contexte d’opération spécifiés.
final int downloadRangeInternal(final long blobOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Télécharge une plage d’octets de l’objet blob vers la mémoire tampon d’octets donnée.
final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset)

Télécharge une plage d’octets de l’objet blob vers la mémoire tampon d’octets donnée.
final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Télécharge une plage d’octets de l’objet blob vers la mémoire tampon d’octets donnée, à l’aide des options de requête et du contexte d’opération spécifiés.
final int downloadToByteArray(final byte[] buffer, final int bufferOffset)

Télécharge une plage d’octets de l’objet blob vers la mémoire tampon d’octets donnée.
final int downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Télécharge une plage d’octets de l’objet blob vers la mémoire tampon d’octets donnée, à l’aide des options de requête et du contexte d’opération spécifiés.
void downloadToFile(final String path)

Télécharge un objet blob en stockant le contenu dans un fichier.
void downloadToFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Télécharge un objet blob en stockant le contenu dans un fichier.
final boolean exists()

Vérifie si l’objet blob existe.
final boolean exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Vérifie si l’objet blob existe à l’aide des options de requête et du contexte d’opération spécifiés.
String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier)

Retourne une signature d’accès partagé pour l’objet blob à l’aide de l’identificateur de stratégie de groupe et du contexte d’opération spécifiés. Notez qu’il ne contient pas le début « ? ».
String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)

Retourne une signature d’accès partagé pour l’objet blob à l’aide de l’identificateur de stratégie de groupe et du contexte d’opération spécifiés. Notez qu’il ne contient pas le début « ? ».
String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols, boolean skipDecoding)

Retourne une signature d’accès partagé pour l’objet blob à l’aide de l’identificateur de stratégie de groupe et du contexte d’opération spécifiés. Notez qu’il ne contient pas le début « ? ».
String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier)

Retourne une signature d’accès partagé pour l’objet blob à l’aide de l’identificateur de stratégie de groupe et du contexte d’opération spécifiés. Notez qu’il ne contient pas le début « ? ».
String generateUserDelegationSharedAccessSignature(final UserDelegationKey delegationKey, final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final IPRange ipRange, final SharedAccessProtocols protocols)

Retourne une signature d’accès partagé basée sur une clé de délégation utilisateur pour l’objet blob à l’aide de l’identificateur de stratégie de groupe et du contexte d’opération spécifiés. Notez qu’il ne contient pas le début « ? ».

String generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy)

Retourne une signature d’accès partagé basée sur une clé de délégation utilisateur pour l’objet blob à l’aide de l’identificateur de stratégie de groupe et du contexte d’opération spécifiés. Notez qu’il ne contient pas le début « ? ».

final CloudBlobContainer getContainer()

Retourne le conteneur de l’objet blob.
CopyState getCopyState()

Retourne l’état de copie de l’objet blob.
final HashMap<String, String> getMetadata()

Retourne les métadonnées de l’objet blob.
final String getName()

Retourne le nom de l’objet blob.
final CloudBlobDirectory getParent()

Retourne le parent de l’élément blob.
String getParentNameFromURI(final StorageUri resourceAddress, final String delimiter, final CloudBlobContainer container)

Récupère le nom parent d’un URI d’objet blob.
final BlobProperties getProperties()

Retourne les propriétés de l’objet blob.
final StorageUri getQualifiedStorageUri()

Retourne l’URI qualifié instantané et/ou de signature d’accès partagé pour cet objet blob.

<xreftitle>Deprecated</xreftitle>

<xrefdescription>

  <p>use <xref uid="com.microsoft.azure.storage.blob.CloudBlob.getSnapshotQualifiedStorageUri()" data-throw-if-not-resolved="false" data-raw-source="getSnapshotQualifiedStorageUri()"></xref> instead.</p>

</xrefdescription>

final URI getQualifiedUri()

Retourne l’URI qualifié instantané ou de signature d’accès partagé pour cet objet blob.

<xreftitle>Deprecated</xreftitle>

<xrefdescription>

  <p>use <xref uid="com.microsoft.azure.storage.blob.CloudBlob.getSnapshotQualifiedUri()" data-throw-if-not-resolved="false" data-raw-source="getSnapshotQualifiedUri()"></xref> instead.</p>

</xrefdescription>

final CloudBlobClient getServiceClient()

Retourne le client de service Blob associé à l’objet blob.
final String getSnapshotID()

Obtient l’ID d’instantané d’objet blob.
final StorageUri getSnapshotQualifiedStorageUri()

Retourne l’URI de l’objet blob pour les emplacements principal et secondaire, y compris les informations de chaîne de requête si l’objet blob est un instantané.
final URI getSnapshotQualifiedUri()

Retourne l’URI absolu de l’objet blob, y compris les informations de chaîne de requête si l’objet blob est un instantané.
final StorageUri getStorageUri()

Retourne la liste des URI pour tous les emplacements.
final int getStreamMinimumReadSizeInBytes()

Retourne la taille de lecture minimale lors de l’utilisation d’un BlobInputStream.
final int getStreamWriteSizeInBytes()

Obtient le nombre d’octets à mettre en mémoire tampon lors de l’écriture dans un BlobOutputStream (objets blob de blocs et de pages).
final StorageUri getTransformedAddress(final OperationContext opContext)

Retourne l’URI transformé pour la ressource si les informations d’identification données nécessitent une transformation.
final URI getUri()

Retourne l’URI de cet objet blob.
final boolean isSnapshot()

Indique si cet objet blob est un instantané.
final BlobInputStream openInputStream()

Ouvre un flux d’entrée d’objet blob pour télécharger l’objet blob.

Utilisez setStreamMinimumReadSizeInBytes(final int minimumReadSize) pour configurer la taille de lecture.
final BlobInputStream openInputStream(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ouvre un flux d’entrée d’objet blob pour télécharger l’objet blob à l’aide des options de requête et du contexte d’opération spécifiés.

Utilisez setStreamMinimumReadSizeInBytes(final int minimumReadSize) pour configurer la taille de lecture.
final BlobInputStream openInputStream(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ouvre un flux d’entrée d’objet blob pour télécharger l’objet blob à l’aide des options de requête et du contexte d’opération spécifiés. Si l’objet blob est déchiffré au fur et à mesure qu’il est téléchargé, la validation MD5 finale est ignorée.

Utilisez setStreamMinimumReadSizeInBytes(final int minimumReadSize) pour configurer la taille de lecture.
final void releaseLease(final AccessCondition accessCondition)

Libère le bail sur l'objet blob.
final void releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Libère le bail sur l’objet blob à l’aide des options de requête et du contexte d’opération spécifiés.
final void renewLease(final AccessCondition accessCondition)

Renouvelle un bail existant.
final void renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Renouvelle un bail existant à l’aide des options de requête et du contexte d’opération spécifiés.
final void setContainer(final CloudBlobContainer container)

Définit le conteneur pour l’objet blob.
final void setMetadata(final HashMap<String, String> metadata)

Définit les métadonnées de l’objet blob.
final void setProperties(final BlobProperties properties)

Définit les propriétés de l’objet blob.
final void setSnapshotID(final String snapshotID)

Définit l’ID de instantané de l’objet blob.
void setStorageUri(final StorageUri storageUri)

Définit la liste des URI pour tous les emplacements.
void setStreamMinimumReadSizeInBytes(final int minimumReadSize)

Définit la taille de lecture minimale lors de l’utilisation d’un BlobInputStream.
abstract void setStreamWriteSizeInBytes(int streamWriteSizeInBytes)

Définit le nombre d’octets à mettre en mémoire tampon lors de l’écriture dans un BlobOutputStream (objets blob de blocs et de pages).
final String startCopy(final URI source)

Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un URI dans un nouvel objet blob.
final String startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un URI vers un nouvel objet blob, en utilisant les conditions d’accès, l’ID de bail, les options de demande et le contexte d’opération spécifiés.
final String startCopy(final URI source, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un URI vers un nouvel objet blob, à l’aide du niveau d’objet blob de page Premium, des conditions d’accès, de l’ID de bail, des options de demande et du contexte d’opération spécifiés.

Remarque : la définition de premiumPageBlobTier est uniquement prise en charge pour les comptes Premium.

final String startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un URI vers un nouvel objet blob, à l’aide du niveau d’objet blob de page Premium, des conditions d’accès, de l’ID de bail, des options de demande et du contexte d’opération spécifiés.

Remarque : la définition de premiumPageBlobTier est uniquement prise en charge pour les comptes Premium.

final String startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un URI vers un nouvel objet blob, en utilisant le niveau d’objet blob de page Premium spécifié, la priorité de réalimentation, les conditions d’accès, l’ID de bail, les options de demande et le contexte d’opération spécifiés.

Remarque : la définition de premiumPageBlobTier est uniquement prise en charge pour les comptes Premium.

StorageRequest<CloudBlobClient, CloudBlob, String> startCopyImpl(final URI source, final String contentMd5, final boolean syncCopy, final boolean incrementalCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, final BlobRequestOptions options)
final void undelete()

Supprime un objet blob et tous ses instantanés qui ont été supprimés de manière réversible.
final void undelete(BlobRequestOptions options, OperationContext opContext)

Supprime un objet blob qui a été supprimé de manière réversible à l’aide des options de requête et du contexte d’opération spécifiés.

L’opération annuler la suppression d’objets blob restaure le contenu et les métadonnées de l’objet blob supprimé de manière réversible et tous ses instantanés. La tentative de suppression d’un objet blob ou d’un instantané qui n’est pas supprimé de manière réversible réussit sans aucune modification.
void updateEtagAndLastModifiedFromResponse(HttpURLConnection request)
void updateLengthFromResponse(HttpURLConnection request)
abstract void upload(InputStream sourceStream, long length)

Charge les données du flux source dans l’objet blob. Si l’objet blob existe déjà sur le service, il sera remplacé.
abstract void upload(InputStream sourceStream, long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Charge les données de flux source dans l’objet blob à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés. Si l’objet blob existe déjà sur le service, il sera remplacé.
void uploadFromByteArray(final byte[] buffer, final int offset, final int length)

Charge un objet blob à partir de données dans un tableau d’octets. Si l’objet blob existe déjà sur le service, il sera remplacé.
void uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Charge un objet blob à partir de données dans un tableau d’octets. Si l’objet blob existe déjà sur le service, il sera remplacé.
void uploadFromFile(final String path)

Charge un objet blob à partir d’un fichier. Si l’objet blob existe déjà sur le service, il sera remplacé.
void uploadFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Charge un objet blob à partir d’un fichier. Si l’objet blob existe déjà sur le service, il sera remplacé.
final void uploadMetadata()

Charge les métadonnées de l’objet blob sur le service de stockage.

Utilisez downloadAttributes() pour récupérer les valeurs les plus récentes pour les propriétés et les métadonnées de l’objet blob à partir du service de stockage Microsoft Azure.
final void uploadMetadata(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Charge les métadonnées de l’objet blob sur le service de stockage à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés.

Utilisez downloadAttributes() pour récupérer les valeurs les plus récentes pour les propriétés et les métadonnées de l’objet blob à partir du service de stockage Microsoft Azure.
final void uploadProperties()

Mises à jour les propriétés de l’objet blob au service de stockage.

Utilisez downloadAttributes() pour récupérer les valeurs les plus récentes pour les propriétés et les métadonnées de l’objet blob à partir du service de stockage Microsoft Azure.
final void uploadProperties(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Mises à jour les propriétés de l’objet blob à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés.

Utilisez downloadAttributes() pour récupérer les valeurs les plus récentes pour les propriétés et les métadonnées de l’objet blob à partir du service de stockage Microsoft Azure.
static<T extends CloudBlob, R> void validateCPKHeaders(StorageRequest<CloudBlobClient, T, R> request, BlobRequestOptions options, boolean upload)

Si les options de requête contiennent un CPK, validez les en-têtes de réponse associés.

Détails du champ

blobServiceClient

protected CloudBlobClient blobServiceClient

Représente le client d’objets blob.

parent

protected CloudBlobDirectory parent

Représente le répertoire de l’objet blob.

streamMinimumReadSizeInBytes

protected int streamMinimumReadSizeInBytes= Constants.DEFAULT_MINIMUM_READ_SIZE_IN_BYTES

Contient la taille de lecture minimale lors de l’utilisation d’un BlobInputStream.

streamWriteSizeInBytes

protected int streamWriteSizeInBytes= Constants.DEFAULT_STREAM_WRITE_IN_BYTES

Contient le nombre d’octets à mettre en mémoire tampon lors de l’écriture dans un BlobOutputStream (objets blob de blocs et de pages).

Détails du constructeur

CloudBlob

protected CloudBlob(final BlobType type, final StorageUri uri, final String snapshotID, final StorageCredentials credentials)

Crée un instance de la classe à l’aide de l’URI, de l’ID instantané et du client d’objet blob cloud spécifiés.

Parameters:

type - Valeur BlobType qui représente le type de l’objet blob.
uri - Objet StorageUri qui représente l’URI de l’objet blob, en commençant par le nom du conteneur.
snapshotID - String qui représente la version instantané, le cas échéant.
credentials - Objet StorageCredentials utilisé pour authentifier l’accès.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

CloudBlob

protected CloudBlob(final BlobType type, String blobName, String snapshotID, CloudBlobContainer container)

Crée une instance de la classe à l’aide du type, du nom, de l’ID instantané et du conteneur spécifiés.

Parameters:

type - Valeur BlobType qui représente le type de l’objet blob.
blobName - Le nom de l’objet Blob.
snapshotID - String qui représente la version instantané, le cas échéant.
container - Référence au conteneur parent.

Throws:

URISyntaxException - Si l’URI de ressource n’est pas valide.

CloudBlob

protected CloudBlob(final CloudBlob otherBlob)

Crée une instance de la classe en copiant les valeurs d’un autre objet blob.

Parameters:

otherBlob - Objet CloudBlob qui représente l’objet blob à copier.

Détails de la méthode

abortCopy

public final void abortCopy(final String copyId)

Interrompt une opération de copie d'objet blob en cours.

Parameters:

copyId - Objet String qui identifie l’opération de copie.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

abortCopy

public final void abortCopy(final String copyId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Interrompt une opération de copie d'objet blob en cours.

Parameters:

copyId - Objet String qui identifie l’opération de copie.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

acquireLease

public final String acquireLease()

Acquiert un nouveau bail infini sur l’objet blob.

Returns:

String qui représente l’ID de bail.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

acquireLease

public final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId)

Acquiert un nouveau bail sur l’objet blob avec la durée de bail spécifiée et l’ID de bail proposé.

Parameters:

leaseTimeInSeconds - Integer qui spécifie l’intervalle de temps pendant lequel acquérir le bail, en secondes. Si la valeur est null, un bail infini sera acquis. Si elle n’est pas null, la valeur doit être supérieure à zéro.
proposedLeaseId - String qui représente l’ID de bail proposé pour le nouveau bail, ou null si aucun ID de bail n’est proposé.

Returns:

String qui représente l’ID de bail.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

acquireLease

public final String acquireLease(final Integer leaseTimeInSeconds, final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Acquiert un nouveau bail sur l’objet blob avec l’heure de bail, l’ID de bail proposé, les options de demande et le contexte d’opération spécifiés.

Parameters:

leaseTimeInSeconds - Integer qui spécifie l’intervalle de temps pendant lequel acquérir le bail, en secondes. Si la valeur est null, un bail infini sera acquis. Si elle n’est pas null, la valeur doit être supérieure à zéro.
proposedLeaseId - String qui représente l’ID de bail proposé pour le nouveau bail, ou null si aucun ID de bail n’est proposé.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé (CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Le contexte est utilisé pour suivre les demandes adressées au service de stockage et pour fournir des informations d’exécution supplémentaires sur l’opération.

Returns:

String qui représente l’ID de bail.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

assertCorrectBlobType

protected final void assertCorrectBlobType()

Affirme que l’objet blob a le type d’objet blob correct spécifié dans les attributs d’objet blob.

Throws:

StorageException - Si un type d’objet blob incorrect est utilisé.

assertNoWriteOperationForSnapshot

protected void assertNoWriteOperationForSnapshot()

Affirme que l’opération d’écriture n’est pas effectuée pour instantané.

breakLease

public final long breakLease(final Integer breakPeriodInSeconds)

Interrompt le bail et s’assure qu’un autre client ne peut pas acquérir un nouveau bail tant que la période de bail actuelle n’a pas expiré.

Parameters:

breakPeriodInSeconds - Spécifie le délai d’attente, en secondes, jusqu’à ce que le bail actuel soit rompu. Si la valeur est null, la période de résiliation est le reste du bail actuel ou zéro pour les baux infinis.

Returns:

long qui spécifie l’heure, en secondes, restante dans la période de bail.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

breakLease

public final long breakLease(final Integer breakPeriodInSeconds, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Interrompt le bail existant, en utilisant les options de demande et le contexte d’opération spécifiés, et garantit qu’un autre client ne peut pas acquérir un nouveau bail tant que la période de bail actuelle n’a pas expiré.

Parameters:

breakPeriodInSeconds - Integer qui spécifie le délai d’attente, en secondes, jusqu’à ce que le bail actuel soit rompu. Si la valeur est null, la période de résiliation est le reste du bail actuel ou zéro pour les baux infinis.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé (CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Le contexte est utilisé pour suivre les demandes adressées au service de stockage et pour fournir des informations d’exécution supplémentaires sur l’opération.

Returns:

long qui représente le temps restant, en secondes, dans la période de bail.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

changeLease

public final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition)

Remplace l’ID de bail existant par l’ID de bail proposé.

Parameters:

proposedLeaseId - String qui représente l’ID de bail proposé pour le nouveau bail, ou null si aucun ID de bail n’est proposé.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob. L’ID de bail doit être défini avec une condition d’accès.

Returns:

String qui représente le nouvel ID de bail.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

changeLease

public final String changeLease(final String proposedLeaseId, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Remplace l’ID de bail existant par l’ID de bail proposé avec les conditions d’accès, les options de demande et le contexte d’opération spécifiés.

Parameters:

proposedLeaseId - String qui représente l’ID de bail proposé pour le nouveau bail, ou null si aucun ID de bail n’est proposé.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob. L’ID de bail doit être défini avec une condition d’accès.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé (CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Le contexte est utilisé pour suivre les demandes adressées au service de stockage et pour fournir des informations d’exécution supplémentaires sur l’opération.

Returns:

String qui représente le nouvel ID de bail.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

createSnapshot

public final CloudBlob createSnapshot()

Crée un instantané de l'objet blob.

Returns:

Objet CloudBlob qui représente le instantané de l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

createSnapshot

public final CloudBlob createSnapshot(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Crée une instantané de l’objet blob à l’aide des options de requête et du contexte d’opération spécifiés.

Parameters:

accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

Objet CloudBlob qui représente le instantané de l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

createSnapshot

public final CloudBlob createSnapshot(final HashMap metadata, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Crée une instantané de l’objet blob à l’aide des options de requête et du contexte d’opération spécifiés.

Parameters:

metadata - Collection de paires nom-valeur définissant les métadonnées du instantané ou null.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

Objet CloudBlob qui représente le instantané de l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

delete

public final void delete()

Supprime l'objet blob.

Si une stratégie de rétention de suppression est activée sur le service, l’objet blob est conservé pendant une période spécifiée, avant d’être supprimé définitivement par garbage collection.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

delete

public final void delete(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Supprime l’objet blob à l’aide des options de instantané et de requête spécifiées, ainsi que du contexte d’opération.

Si une stratégie de rétention de suppression est activée sur le service, l’objet blob est conservé pendant une période spécifiée, avant d’être supprimé définitivement par garbage collection.

Un objet blob associé à des instantanés ne peut pas être supprimé, à moins de supprimer aussi les instantanés. Si un objet blob a des instantanés, utilisez la DELETE_SNAPSHOTS_ONLY valeur ou INCLUDE_SNAPSHOTS dans le paramètre pour spécifier la façon dont les instantanés doivent être gérés lorsque l’objet blob est supprimé.

Parameters:

deleteSnapshotsOption - Objet DeleteSnapshotsOption qui indique s’il faut supprimer uniquement les instantanés ou l’objet blob et ses instantanés.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

deleteIfExists

public final boolean deleteIfExists()

Supprime l’objet blob s’il existe.

Un objet blob associé à des instantanés ne peut pas être supprimé, à moins de supprimer aussi les instantanés. Si un objet blob a des instantanés, utilisez la DELETE_SNAPSHOTS_ONLY valeur ou INCLUDE_SNAPSHOTS dans le paramètre pour spécifier la façon dont les instantanés doivent être gérés lorsque l’objet blob est supprimé.

Returns:

true si l’objet blob a été supprimé ; sinon, false.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

deleteIfExists

public final boolean deleteIfExists(final DeleteSnapshotsOption deleteSnapshotsOption, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Supprime l’objet blob s’il existe, à l’aide des options de instantané et de requête spécifiées, ainsi que du contexte d’opération.

Un objet blob associé à des instantanés ne peut pas être supprimé, à moins de supprimer aussi les instantanés. Si un objet blob a des instantanés, utilisez la DELETE_SNAPSHOTS_ONLY valeur ou INCLUDE_SNAPSHOTS dans le paramètre pour spécifier la façon dont les instantanés doivent être gérés lorsque l’objet blob est supprimé.

Parameters:

deleteSnapshotsOption - Objet DeleteSnapshotsOption qui indique s’il faut supprimer uniquement les instantanés, ou l’objet blob et ses instantanés.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

true si l’objet blob existait et a été supprimé ; Sinon false

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

download

public final void download(final OutputStream outStream)

Télécharge le contenu d'un objet blob vers un flux de données.

Parameters:

outStream - Objet OutputStream qui représente le flux cible.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

download

public final void download(final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Télécharge le contenu d’un objet blob dans un flux à l’aide des options de requête et du contexte d’opération spécifiés.

Parameters:

outStream - Objet OutputStream qui représente le flux cible.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

downloadAccountInfo

public AccountInformation downloadAccountInfo()

Obtient des informations relatives au compte de stockage dans lequel réside cet objet blob.

Returns:

Objet AccountInformation pour le compte de stockage donné.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

downloadAccountInfo

public AccountInformation downloadAccountInfo(BlobRequestOptions options, OperationContext opContext)

Obtient des informations relatives au compte de stockage dans lequel réside cet objet blob.

Parameters:

options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

Objet AccountInformation pour le compte de stockage donné.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

downloadAccountInformationImpl

protected StorageRequest downloadAccountInformationImpl(final RequestOptions options)

Parameters:

options

downloadAttributes

public final void downloadAttributes()

Remplit les propriétés et les métadonnées d'un objet blob.

Cette méthode remplit les propriétés système de l’objet blob et les métadonnées définies par l’utilisateur. Avant de lire ou de modifier les propriétés ou métadonnées d’un objet blob, appelez cette méthode ou sa surcharge pour récupérer les dernières valeurs des propriétés et métadonnées de l’objet blob à partir du service de stockage Microsoft Azure.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

downloadAttributes

public final void downloadAttributes(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Remplit les propriétés et métadonnées d’un objet blob à l’aide des options de requête et du contexte d’opération spécifiés.

Cette méthode remplit les propriétés système de l’objet blob et les métadonnées définies par l’utilisateur. Avant de lire ou de modifier les propriétés ou métadonnées d’un objet blob, appelez cette méthode ou sa surcharge pour récupérer les dernières valeurs des propriétés et métadonnées de l’objet blob à partir du service de stockage Microsoft Azure.

Parameters:

accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

downloadRange

public final void downloadRange(final long offset, final Long length, final OutputStream outStream)

Télécharge le contenu d'un objet blob vers un flux de données.

Parameters:

offset - long qui représente le décalage à utiliser comme point de départ pour la source.
length - Long qui représente le nombre d’octets à lire ou null.
outStream - Objet OutputStream qui représente le flux cible.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

downloadRange

public final void downloadRange(final long offset, final Long length, final OutputStream outStream, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Télécharge le contenu d’un objet blob dans un flux à l’aide des options de requête et du contexte d’opération spécifiés.

Parameters:

offset - long qui représente le décalage à utiliser comme point de départ pour la source.
length - Long qui représente le nombre d’octets à lire ou null.
outStream - Objet OutputStream qui représente le flux cible.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

downloadRangeInternal

protected final int downloadRangeInternal(final long blobOffset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Télécharge une plage d’octets de l’objet blob vers la mémoire tampon d’octets donnée.

Parameters:

blobOffset - long qui représente le décalage dans l’objet blob pour commencer le téléchargement.
length - Long qui représente le nombre d’octets à lire.
buffer - Tableau byte qui représente la mémoire tampon dans laquelle écrire.
bufferOffset - int qui représente le décalage dans la mémoire tampon d’octets à commencer à écrire.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande.
opContext - Objet OperationContext utilisé pour suivre l’exécution de l’opération.

Returns:

Nombre total d'octets lus dans la mémoire tampon.

Throws:

StorageException - exception représentant toute erreur qui s’est produite pendant l’opération.

downloadRangeToByteArray

public final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset)

Télécharge une plage d’octets de l’objet blob vers la mémoire tampon d’octets donnée.

Parameters:

offset - long qui représente le décalage d’octets à utiliser comme point de départ pour la source.
length - Long qui représente le nombre d’octets à lire ou null.
buffer - Tableau byte qui représente la mémoire tampon vers laquelle les octets d’objet blob sont téléchargés.
bufferOffset - int qui représente le décalage d’octets à utiliser comme point de départ pour la cible.

Returns:

Nombre total d'octets lus dans la mémoire tampon.

Throws:

StorageException

downloadRangeToByteArray

public final int downloadRangeToByteArray(final long offset, final Long length, final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Télécharge une plage d’octets de l’objet blob vers la mémoire tampon d’octets donnée, à l’aide des options de requête et du contexte d’opération spécifiés.

Parameters:

offset - long qui représente le décalage d’octets à utiliser comme point de départ pour la source.
length - Long qui représente le nombre d’octets à lire ou null.
buffer - Tableau byte qui représente la mémoire tampon vers laquelle les octets d’objet blob sont téléchargés.
bufferOffset - int qui représente le décalage d’octets à utiliser comme point de départ pour la cible.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

Nombre total d'octets lus dans la mémoire tampon.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

downloadToByteArray

public final int downloadToByteArray(final byte[] buffer, final int bufferOffset)

Télécharge une plage d’octets de l’objet blob vers la mémoire tampon d’octets donnée.

Parameters:

buffer - Tableau byte qui représente la mémoire tampon vers laquelle les octets d’objet blob sont téléchargés.
bufferOffset - int qui représente le décalage d’octets à utiliser comme point de départ pour la cible.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

downloadToByteArray

public final int downloadToByteArray(final byte[] buffer, final int bufferOffset, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Télécharge une plage d’octets de l’objet blob vers la mémoire tampon d’octets donnée, à l’aide des options de requête et du contexte d’opération spécifiés.

Parameters:

buffer - Tableau byte qui représente la mémoire tampon vers laquelle les octets d’objet blob sont téléchargés.
bufferOffset - long qui représente le décalage d’octets à utiliser comme point de départ pour la cible.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

downloadToFile

public void downloadToFile(final String path)

Télécharge un objet blob en stockant le contenu dans un fichier.

Parameters:

path - String qui représente le chemin d’accès au fichier qui sera créé avec le contenu de l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
IOException

downloadToFile

public void downloadToFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Télécharge un objet blob en stockant le contenu dans un fichier.

Parameters:

path - String qui représente le chemin d’accès au fichier qui sera créé avec le contenu de l’objet blob.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
IOException

exists

public final boolean exists()

Vérifie si l’objet blob existe.

Returns:

true si l’objet blob existe , sinon false.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

exists

public final boolean exists(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Vérifie si l’objet blob existe à l’aide des options de requête et du contexte d’opération spécifiés.

Parameters:

accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

true si l’objet blob existe, sinon false.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier)

Retourne une signature d’accès partagé pour l’objet blob à l’aide de l’identificateur de stratégie de groupe et du contexte d’opération spécifiés. Notez qu’il ne contient pas le début « ? ».

Parameters:

policy - Objet SharedAccessPolicy qui représente la stratégie d’accès pour la signature d’accès partagé.
headers - Objet SharedAccessBlobHeaders qui représente les valeurs d’en-tête facultatives à définir pour un objet blob accessible avec cette signature d’accès partagé.
groupPolicyIdentifier - String qui représente la stratégie d’accès au niveau du conteneur.

Returns:

String qui représente la signature d’accès partagé.

Throws:

IllegalArgumentException - Si les informations d’identification ne sont pas valides ou si l’objet blob est un instantané.
InvalidKeyException - Si les informations d’identification ne sont pas valides.
StorageException - Si une erreur de service de stockage s’est produite.

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols)

Retourne une signature d’accès partagé pour l’objet blob à l’aide de l’identificateur de stratégie de groupe et du contexte d’opération spécifiés. Notez qu’il ne contient pas le début « ? ».

Parameters:

policy - Objet SharedAccessPolicy qui représente la stratégie d’accès pour la signature d’accès partagé.
headers - Objet SharedAccessBlobHeaders qui représente les valeurs d’en-tête facultatives à définir pour un objet blob accessible avec cette signature d’accès partagé.
groupPolicyIdentifier - String qui représente la stratégie d’accès au niveau du conteneur.
ipRange - Objet IPRange contenant la plage d’adresses IP autorisées.
protocols - SharedAccessProtocols représentant les protocoles Internet autorisés.

Returns:

String qui représente la signature d’accès partagé.

Throws:

IllegalArgumentException - Si les informations d’identification ne sont pas valides ou si l’objet blob est un instantané.
InvalidKeyException - Si les informations d’identification ne sont pas valides.
StorageException - Si une erreur de service de stockage s’est produite.

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final String groupPolicyIdentifier, final IPRange ipRange, final SharedAccessProtocols protocols, boolean skipDecoding)

Retourne une signature d’accès partagé pour l’objet blob à l’aide de l’identificateur de stratégie de groupe et du contexte d’opération spécifiés. Notez qu’il ne contient pas le début « ? ».

Parameters:

policy - Objet SharedAccessPolicy qui représente la stratégie d’accès pour la signature d’accès partagé.
headers - Objet SharedAccessBlobHeaders qui représente les valeurs d’en-tête facultatives à définir pour un objet blob accessible avec cette signature d’accès partagé.
groupPolicyIdentifier - String qui représente la stratégie d’accès au niveau du conteneur.
ipRange - Objet IPRange contenant la plage d’adresses IP autorisées.
protocols - SharedAccessProtocols représentant les protocoles Internet autorisés.
skipDecoding - boolean pour indiquer que les paramètres de requête ne doivent pas être décodés avant d’être signés. Cela ne doit être utilisé que si le client est sûr que les valeurs passées sont au format souhaité. Cela peut être utile dans certains scénarios où le client est utilisé pour générer une sap à un tiers qui n’utilisera pas ce kit de développement logiciel (SDK) pour effectuer les demandes.

Returns:

String qui représente la signature d’accès partagé.

Throws:

IllegalArgumentException - Si les informations d’identification ne sont pas valides ou si l’objet blob est un instantané.
InvalidKeyException - Si les informations d’identification ne sont pas valides.
StorageException - Si une erreur de service de stockage s’est produite.

generateSharedAccessSignature

public String generateSharedAccessSignature(final SharedAccessBlobPolicy policy, final String groupPolicyIdentifier)

Retourne une signature d’accès partagé pour l’objet blob à l’aide de l’identificateur de stratégie de groupe et du contexte d’opération spécifiés. Notez qu’il ne contient pas le début « ? ».

Parameters:

policy - Objet SharedAccessPolicy qui représente la stratégie d’accès pour la signature d’accès partagé.
groupPolicyIdentifier - String qui représente la stratégie d’accès au niveau du conteneur.

Returns:

String qui représente la signature d’accès partagé.

Throws:

IllegalArgumentException - Si les informations d’identification ne sont pas valides ou si l’objet blob est un instantané.
InvalidKeyException - Si les informations d’identification ne sont pas valides.
StorageException - Si une erreur de service de stockage s’est produite.

generateUserDelegationSharedAccessSignature

public String generateUserDelegationSharedAccessSignature(final UserDelegationKey delegationKey, final SharedAccessBlobPolicy policy, final SharedAccessBlobHeaders headers, final IPRange ipRange, final SharedAccessProtocols protocols)

Retourne une signature d’accès partagé basée sur une clé de délégation utilisateur pour l’objet blob à l’aide de l’identificateur de stratégie de groupe et du contexte d’opération spécifiés. Notez qu’il ne contient pas le début « ? ».

Parameters:

delegationKey - UserDelegationKey représentant la clé utilisée pour signer cette signature.
policy - Objet SharedAccessPolicy qui représente la stratégie d’accès pour la signature d’accès partagé.
headers - Objet SharedAccessBlobHeaders qui représente les valeurs d’en-tête facultatives à définir pour un objet blob accessible avec cette signature d’accès partagé.
ipRange - Objet IPRange contenant la plage d’adresses IP autorisées.
protocols - SharedAccessProtocols représentant les protocoles Internet autorisés.

Returns:

String qui représente la signature d’accès partagé.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

generateUserDelegationSharedAccessSignature

public String generateUserDelegationSharedAccessSignature(UserDelegationKey delegationKey, SharedAccessBlobPolicy policy)

Retourne une signature d’accès partagé basée sur une clé de délégation utilisateur pour l’objet blob à l’aide de l’identificateur de stratégie de groupe et du contexte d’opération spécifiés. Notez qu’il ne contient pas le début « ? ».

Parameters:

delegationKey - UserDelegationKey représentant la clé utilisée pour signer cette signature.
policy - Objet SharedAccessPolicy qui représente la stratégie d’accès pour la signature d’accès partagé.

Returns:

String qui représente la signature d’accès partagé.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

getContainer

public final CloudBlobContainer getContainer()

Retourne le conteneur de l’objet blob.

Overrides:

CloudBlob.getContainer()

Returns:

Objet CloudBlobContainer qui représente le conteneur de l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
URISyntaxException - Si l’URI de ressource n’est pas valide.

getCopyState

public CopyState getCopyState()

Retourne l’état de copie de l’objet blob.

Returns:

Objet CopyState qui représente l’état de copie de l’objet blob.

getMetadata

public final HashMap getMetadata()

Retourne les métadonnées de l’objet blob.

Returns:

Objet java.util.HashMap qui représente les métadonnées de l’objet blob.

getName

public final String getName()

Retourne le nom de l’objet blob.

Returns:

String qui représente le nom de l’objet blob.

getParent

public final CloudBlobDirectory getParent()

Retourne le parent de l’élément blob.

Overrides:

CloudBlob.getParent()

Returns:

Objet CloudBlobDirectory qui représente le répertoire parent de l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
URISyntaxException - Si l’URI de ressource n’est pas valide.

getParentNameFromURI

protected static String getParentNameFromURI(final StorageUri resourceAddress, final String delimiter, final CloudBlobContainer container)

Récupère le nom parent d’un URI d’objet blob.

Parameters:

resourceAddress - Objet StorageUri qui représente l’URI de la ressource.
delimiter - String qui spécifie le délimiteur de répertoire à utiliser.
container - Objet CloudBlobContainer qui représente le conteneur d’objets blob.

Returns:

String qui représente l’adresse parente d’un URI d’objet blob.

Throws:

URISyntaxException

getProperties

public final BlobProperties getProperties()

Retourne les propriétés de l’objet blob.

Returns:

Objet BlobProperties qui représente les propriétés de l’objet blob.

getQualifiedStorageUri

public final StorageUri getQualifiedStorageUri()

Retourne l’URI qualifié instantané et/ou de signature d’accès partagé pour cet objet blob.

<xreftitle>Deprecated</xreftitle>

<xrefdescription>

  <p>use <xref uid="com.microsoft.azure.storage.blob.CloudBlob.getSnapshotQualifiedStorageUri()" data-throw-if-not-resolved="false" data-raw-source="getSnapshotQualifiedStorageUri()"></xref> instead.</p>

</xrefdescription>

Returns:

Objet StorageUri qui représente le instantané ou la signature d’accès partagé.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
URISyntaxException - Si l’URI de ressource n’est pas valide.

getQualifiedUri

public final URI getQualifiedUri()

Retourne l’URI qualifié instantané ou de signature d’accès partagé pour cet objet blob.

<xreftitle>Deprecated</xreftitle>

<xrefdescription>

  <p>use <xref uid="com.microsoft.azure.storage.blob.CloudBlob.getSnapshotQualifiedUri()" data-throw-if-not-resolved="false" data-raw-source="getSnapshotQualifiedUri()"></xref> instead.</p>

</xrefdescription>

Returns:

Objet java.net.URI qui représente le instantané ou la signature d’accès partagé.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
URISyntaxException - Si l’URI de ressource n’est pas valide.

getServiceClient

public final CloudBlobClient getServiceClient()

Retourne le client de service Blob associé à l’objet blob.

Returns:

Objet CloudBlobClient qui représente le client.

getSnapshotID

public final String getSnapshotID()

Obtient l’ID d’instantané d’objet blob.

Returns:

String qui représente l’ID d’instantané d’objet blob.

getSnapshotQualifiedStorageUri

public final StorageUri getSnapshotQualifiedStorageUri()

Retourne l’URI de l’objet blob pour les emplacements principal et secondaire, y compris les informations de chaîne de requête si l’objet blob est un instantané.

Returns:

Objet StorageUri contenant les URI de l’objet blob pour les emplacements principal et secondaire, y compris instantané informations de requête si l’objet blob est un instantané.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
URISyntaxException - Si l’URI de ressource n’est pas valide.

getSnapshotQualifiedUri

public final URI getSnapshotQualifiedUri()

Retourne l’URI absolu de l’objet blob, y compris les informations de chaîne de requête si l’objet blob est un instantané.

Returns:

Objet java.net.URI spécifiant l’URI absolu de l’objet blob, y compris instantané informations de requête si l’objet blob est un instantané.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
URISyntaxException - Si l’URI de ressource n’est pas valide.

getStorageUri

public final StorageUri getStorageUri()

Retourne la liste des URI pour tous les emplacements.

Overrides:

CloudBlob.getStorageUri()

Returns:

StorageUri qui représente la liste des URI pour tous les emplacements.

getStreamMinimumReadSizeInBytes

public final int getStreamMinimumReadSizeInBytes()

Retourne la taille de lecture minimale lors de l’utilisation d’un BlobInputStream.

Returns:

int qui représente la taille de lecture minimale, en octets, lors de l’utilisation d’un BlobInputStream objet .

getStreamWriteSizeInBytes

public final int getStreamWriteSizeInBytes()

Obtient le nombre d’octets à mettre en mémoire tampon lors de l’écriture dans un BlobOutputStream (objets blob de blocs et de pages).

Returns:

int qui représente le nombre d’octets à mettre en mémoire tampon ou la taille d’un bloc, en octets.

getTransformedAddress

protected final StorageUri getTransformedAddress(final OperationContext opContext)

Retourne l’URI transformé pour la ressource si les informations d’identification données nécessitent une transformation.

Parameters:

opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

Objet StorageUri qui représente l’URI transformé.

Throws:

IllegalArgumentException - Si l’URI n’est pas absolu.
StorageException - Si une erreur de service de stockage s’est produite.
URISyntaxException - Si l’URI de ressource n’est pas valide.

getUri

public final URI getUri()

Retourne l’URI de cet objet blob.

Overrides:

CloudBlob.getUri()

Returns:

Objet java.net.URI qui représente l’URI de l’objet blob.

isSnapshot

public final boolean isSnapshot()

Indique si cet objet blob est un instantané.

Returns:

truesi l’objet blob est un instantané , sinonfalse.

openInputStream

public final BlobInputStream openInputStream()

Ouvre un flux d’entrée d’objet blob pour télécharger l’objet blob.

Utilisez setStreamMinimumReadSizeInBytes(final int minimumReadSize) pour configurer la taille de lecture.

Returns:

Objet InputStream qui représente le flux à utiliser pour la lecture à partir de l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

openInputStream

public final BlobInputStream openInputStream(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ouvre un flux d’entrée d’objet blob pour télécharger l’objet blob à l’aide des options de requête et du contexte d’opération spécifiés.

Utilisez setStreamMinimumReadSizeInBytes(final int minimumReadSize) pour configurer la taille de lecture.

Parameters:

accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

Objet InputStream qui représente le flux à utiliser pour la lecture à partir de l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

openInputStream

public final BlobInputStream openInputStream(final long offset, final Long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Ouvre un flux d’entrée d’objet blob pour télécharger l’objet blob à l’aide des options de requête et du contexte d’opération spécifiés. Si l’objet blob est déchiffré au fur et à mesure qu’il est téléchargé, la validation MD5 finale est ignorée.

Utilisez setStreamMinimumReadSizeInBytes(final int minimumReadSize) pour configurer la taille de lecture.

Parameters:

offset - long qui représente le décalage à utiliser comme point de départ pour la source.
length - Long qui représente le nombre d’octets à lire ou null.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

Objet InputStream qui représente le flux à utiliser pour la lecture à partir de l’objet blob.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

releaseLease

public final void releaseLease(final AccessCondition accessCondition)

Libère le bail sur l'objet blob.

Parameters:

accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob. Le LeaseID doit être défini sur AccessCondition.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

releaseLease

public final void releaseLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Libère le bail sur l’objet blob à l’aide des options de requête et du contexte d’opération spécifiés.

Parameters:

accessCondition - Objet AccessCondition qui représente les conditions d’accès pour l’objet blob. Le LeaseID doit être défini sur AccessCondition.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

renewLease

public final void renewLease(final AccessCondition accessCondition)

Renouvelle un bail existant.

Parameters:

accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob. Le LeaseID doit être défini sur AccessCondition.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

renewLease

public final void renewLease(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Renouvelle un bail existant à l’aide des options de requête et du contexte d’opération spécifiés.

Parameters:

accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob. Le LeaseID doit être défini sur AccessCondition.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

setContainer

protected final void setContainer(final CloudBlobContainer container)

Définit le conteneur pour l’objet blob.

Parameters:

container - Objet CloudBlobContainer qui représente le conteneur affecté à l’objet blob.

setMetadata

public final void setMetadata(final HashMap metadata)

Définit les métadonnées de l’objet blob.

Parameters:

metadata - Objet java.util.HashMap qui contient les métadonnées affectées à l’objet blob.

setProperties

protected final void setProperties(final BlobProperties properties)

Définit les propriétés de l’objet blob.

Parameters:

properties - Objet BlobProperties qui représente les propriétés affectées à l’objet blob.

setSnapshotID

protected final void setSnapshotID(final String snapshotID)

Définit l’ID de instantané de l’objet blob.

Parameters:

snapshotID - String qui représente l’ID de instantané affecté à l’objet blob.

setStorageUri

protected void setStorageUri(final StorageUri storageUri)

Définit la liste des URI pour tous les emplacements.

Parameters:

storageUri - StorageUri qui représente la liste des URI de tous les emplacements.

setStreamMinimumReadSizeInBytes

public void setStreamMinimumReadSizeInBytes(final int minimumReadSize)

Définit la taille de lecture minimale lors de l’utilisation d’un BlobInputStream.

Parameters:

minimumReadSize - int qui représente la taille minimale de bloc, en octets, pour la lecture à partir d’un objet blob lors de l’utilisation d’un BlobInputStream objet. Doit être supérieur ou égal à 16 Ko.

Throws:

IllegalArgumentException - Si minimumReadSize est inférieur à 16 Ko.

setStreamWriteSizeInBytes

public abstract void setStreamWriteSizeInBytes(int streamWriteSizeInBytes)

Définit le nombre d’octets à mettre en mémoire tampon lors de l’écriture dans un BlobOutputStream (objets blob de blocs et de pages).

Parameters:

streamWriteSizeInBytes - int qui représente le nombre d’octets à mettre en mémoire tampon ou la taille d’un bloc, en octets.

startCopy

public final String startCopy(final URI source)

Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un URI dans un nouvel objet blob.

Parameters:

source - URI java.net.URI source. Les URI pour les ressources en dehors d’Azure ne peuvent être copiés que dans des objets blob de blocs.

Returns:

String qui représente l’ID de copie associé à l’opération de copie.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

startCopy

public final String startCopy(final URI source, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un URI vers un nouvel objet blob, en utilisant les conditions d’accès, l’ID de bail, les options de demande et le contexte d’opération spécifiés.

Parameters:

source - URI java.net.URI source. Les URI pour les ressources en dehors d’Azure ne peuvent être copiés que dans des objets blob de blocs.
sourceAccessCondition - Objet AccessCondition qui représente les conditions d’accès de la source.
destinationAccessCondition - Objet AccessCondition qui représente les conditions d’accès pour la destination.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé (CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

String qui représente l’ID de copie associé à l’opération de copie.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

startCopy

protected final String startCopy(final URI source, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un URI vers un nouvel objet blob, à l’aide du niveau d’objet blob de page Premium, des conditions d’accès, de l’ID de bail, des options de demande et du contexte d’opération spécifiés.

Remarque : la définition de premiumPageBlobTier est uniquement prise en charge pour les comptes Premium.

Parameters:

source - URI java.net.URI source. Les URI pour les ressources en dehors d’Azure ne peuvent être copiés que dans des objets blob de blocs.
blobTierString - Chaîne qui représente le niveau de l’objet blob.
sourceAccessCondition - Objet AccessCondition qui représente les conditions d’accès de la source.
destinationAccessCondition - Objet AccessCondition qui représente les conditions d’accès pour la destination.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé (CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

String qui représente l’ID de copie associé à l’opération de copie.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

startCopy

protected final String startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un URI vers un nouvel objet blob, à l’aide du niveau d’objet blob de page Premium, des conditions d’accès, de l’ID de bail, des options de demande et du contexte d’opération spécifiés.

Remarque : la définition de premiumPageBlobTier est uniquement prise en charge pour les comptes Premium.

Parameters:

source - URI java.net.URI source. Les URI pour les ressources en dehors d’Azure ne peuvent être copiés que dans des objets blob de blocs.
contentMd5 - Valeur de hachage facultative utilisée pour garantir l’intégrité transactionnelle de l’opération. Peut être null ou vide.
syncCopy - boolean qui indique si la copie doit être effectuée de manière synchrone sur le service.
blobTierString - Chaîne qui représente le niveau de l’objet blob.
sourceAccessCondition - Objet AccessCondition qui représente les conditions d’accès de la source.
destinationAccessCondition - Objet AccessCondition qui représente les conditions d’accès pour la destination.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé (CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

String qui représente l’ID de copie associé à l’opération de copie.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

startCopy

protected final String startCopy(final URI source, String contentMd5, boolean syncCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, BlobRequestOptions options, OperationContext opContext)

Demande au service de commencer à copier le contenu, les propriétés et les métadonnées d’un URI vers un nouvel objet blob, en utilisant le niveau d’objet blob de page Premium spécifié, la priorité de réalimentation, les conditions d’accès, l’ID de bail, les options de demande et le contexte d’opération spécifiés.

Remarque : la définition de premiumPageBlobTier est uniquement prise en charge pour les comptes Premium.

Parameters:

source - URI java.net.URI source. Les URI pour les ressources en dehors d’Azure ne peuvent être copiés que dans des objets blob de blocs.
contentMd5 - Valeur de hachage facultative utilisée pour garantir l’intégrité transactionnelle de l’opération. Peut être null ou vide.
syncCopy - boolean qui indique si la copie doit être effectuée de manière synchrone sur le service.
blobTierString - Objet String qui représente le niveau de l’objet blob.
rehydratePriority - Objet RehydratePriority qui représente la priorité de réalimentation.
sourceAccessCondition - Objet AccessCondition qui représente les conditions d’accès de la source.
destinationAccessCondition - Objet AccessCondition qui représente les conditions d’accès pour la destination.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé (CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Returns:

String qui représente l’ID de copie associé à l’opération de copie.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

startCopyImpl

protected StorageRequest startCopyImpl(final URI source, final String contentMd5, final boolean syncCopy, final boolean incrementalCopy, final String blobTierString, final RehydratePriority rehydratePriority, final AccessCondition sourceAccessCondition, final AccessCondition destinationAccessCondition, final BlobRequestOptions options)

Parameters:

source
contentMd5
syncCopy
incrementalCopy
blobTierString
rehydratePriority
sourceAccessCondition
destinationAccessCondition
options

undelete

public final void undelete()

Supprime un objet blob et tous ses instantanés qui ont été supprimés de manière réversible.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

undelete

public final void undelete(BlobRequestOptions options, OperationContext opContext)

Supprime un objet blob qui a été supprimé de manière réversible à l’aide des options de requête et du contexte d’opération spécifiés.

L’opération annuler la suppression d’objets blob restaure le contenu et les métadonnées de l’objet blob supprimé de manière réversible et tous ses instantanés. La tentative de suppression d’un objet blob ou d’un instantané qui n’est pas supprimé de manière réversible réussit sans aucune modification.

Parameters:

options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

updateEtagAndLastModifiedFromResponse

protected void updateEtagAndLastModifiedFromResponse(HttpURLConnection request)

Parameters:

request

updateLengthFromResponse

protected void updateLengthFromResponse(HttpURLConnection request)

Parameters:

request

upload

public abstract void upload(InputStream sourceStream, long length)

Charge les données du flux source dans l’objet blob. Si l’objet blob existe déjà sur le service, il sera remplacé.

Parameters:

sourceStream - Objet InputStream qui représente le flux source à charger.
length - long qui représente la longueur des données de flux en octets, ou -1 si inconnu. La longueur doit être supérieure à zéro et un multiple de 512 pour les objets blob de pages.

Throws:

IOException - Si une exception d’E/S s’est produite.
StorageException - Si une erreur de service de stockage s’est produite.

upload

public abstract void upload(InputStream sourceStream, long length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Charge les données de flux source dans l’objet blob à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés. Si l’objet blob existe déjà sur le service, il sera remplacé.

Parameters:

sourceStream - Objet InputStream qui représente le flux source à charger.
length - Longueur des données de flux en octets ou -1 si elle est inconnue. La longueur doit être supérieure à zéro et un multiple de 512 pour les objets blob de pages.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

IOException - Si une exception d’E/S s’est produite.
StorageException - Si une erreur de service de stockage s’est produite.

uploadFromByteArray

public void uploadFromByteArray(final byte[] buffer, final int offset, final int length)

Charge un objet blob à partir de données dans un tableau d’octets. Si l’objet blob existe déjà sur le service, il sera remplacé.

Parameters:

buffer - Tableau byte qui représente les données à écrire dans l’objet blob.
offset - int qui représente le décalage du tableau d’octets à partir duquel démarrer le chargement des données.
length - int qui représente le nombre d’octets à charger à partir de la mémoire tampon d’entrée.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
IOException

uploadFromByteArray

public void uploadFromByteArray(final byte[] buffer, final int offset, final int length, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Charge un objet blob à partir de données dans un tableau d’octets. Si l’objet blob existe déjà sur le service, il sera remplacé.

Parameters:

buffer - Tableau byte qui représente les données à écrire dans l’objet blob.
offset - int qui représente le décalage du tableau d’octets à partir duquel démarrer le chargement des données.
length - int qui représente le nombre d’octets à charger à partir de la mémoire tampon d’entrée.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
IOException

uploadFromFile

public void uploadFromFile(final String path)

Charge un objet blob à partir d’un fichier. Si l’objet blob existe déjà sur le service, il sera remplacé.

Parameters:

path - String qui représente le chemin d’accès au fichier à charger.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
IOException

uploadFromFile

public void uploadFromFile(final String path, final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Charge un objet blob à partir d’un fichier. Si l’objet blob existe déjà sur le service, il sera remplacé.

Parameters:

path - String qui représente le chemin d’accès au fichier à charger.
accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.
IOException

uploadMetadata

public final void uploadMetadata()

Charge les métadonnées de l’objet blob sur le service de stockage.

Utilisez downloadAttributes() pour récupérer les valeurs les plus récentes pour les propriétés et les métadonnées de l’objet blob à partir du service de stockage Microsoft Azure.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

uploadMetadata

public final void uploadMetadata(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Charge les métadonnées de l’objet blob sur le service de stockage à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés.

Utilisez downloadAttributes() pour récupérer les valeurs les plus récentes pour les propriétés et les métadonnées de l’objet blob à partir du service de stockage Microsoft Azure.

Parameters:

accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

uploadProperties

public final void uploadProperties()

Mises à jour les propriétés de l’objet blob au service de stockage.

Utilisez downloadAttributes() pour récupérer les valeurs les plus récentes pour les propriétés et les métadonnées de l’objet blob à partir du service de stockage Microsoft Azure.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

uploadProperties

public final void uploadProperties(final AccessCondition accessCondition, BlobRequestOptions options, OperationContext opContext)

Mises à jour les propriétés de l’objet blob à l’aide de l’ID de bail, des options de demande et du contexte d’opération spécifiés.

Utilisez downloadAttributes() pour récupérer les valeurs les plus récentes pour les propriétés et les métadonnées de l’objet blob à partir du service de stockage Microsoft Azure.

Parameters:

accessCondition - Objet AccessCondition qui représente les conditions d'accès pour l'objet blob.
options - Objet BlobRequestOptions qui spécifie toutes les options supplémentaires pour la demande. La spécification null utilise les options de requête par défaut du client de service associé ( CloudBlobClient).
opContext - Objet OperationContext qui représente le contexte de l'opération actuelle. Cet objet est utilisé pour suivre les demandes au service de stockage, et fournir des informations d'exécution supplémentaires sur l'opération.

Throws:

StorageException - Si une erreur de service de stockage s’est produite.

validateCPKHeaders

protected static static void validateCPKHeaders(StorageRequest request, BlobRequestOptions options, boolean upload)

Si les options de requête contiennent un CPK, validez les en-têtes de réponse associés.

Parameters:

request - La demande de stockage à case activée la réponse de .
options - Options d’objet blob utilisées sur la demande.
upload - S’il s’agit d’un chargement ou si nous récupérons simplement des données.

Throws:

StorageException - Lève si CPK a été utilisé dans la demande et si la réponse a échoué à la validation.

S’applique à