List BlobsList Blobs

L' List Blobs opération retourne une liste des objets BLOB sous le conteneur spécifié.The List Blobs operation returns a list of the blobs under the specified container.

RequêteRequest

La demande List Blobs peut être construite comme indiqué ci-dessous.The List Blobs request may be constructed as follows. HTTPS est recommandé.HTTPS is recommended. Remplacez moncompte par le nom de votre compte de stockage :Replace myaccount with the name of your storage account:

MéthodeMethod URI de requêteRequest URI Version HTTPHTTP Version
GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list HTTP/1.1HTTP/1.1

URI du service de stockage émuléEmulated storage service URI

Lorsque vous élaborez une demande pour le service de stockage émulé, spécifiez le nom d'hôte de l'émulateur et le port de service BLOB sous la forme 127.0.0.1:10000, suivi du nom de compte de stockage émulé :When making a request against the emulated storage service, specify the emulator hostname and Blob service port as 127.0.0.1:10000, followed by the emulated storage account name:

MéthodeMethod URI de requêteRequest URI Version HTTPHTTP Version
GET http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list HTTP/1.1HTTP/1.1

Pour plus d’informations, consultez utilisation de l’émulateur de stockage Azure pour le développement et le test.For more information, see Using the Azure Storage Emulator for Development and Testing.

Paramètres URIURI Parameters

Les paramètres supplémentaires suivants peuvent être spécifiés dans l'URI.The following additional parameters may be specified on the URI.

ParamètreParameter DescriptionDescription
prefix facultatif.Optional. Filtre les résultats pour renvoyer uniquement les objets blob dont le nom commence par le préfixe spécifié.Filters the results to return only blobs whose names begin with the specified prefix.
delimiter facultatif.Optional. Lorsque la demande inclut ce paramètre, l'opération renvoie un élément BlobPrefix dans le corps de la réponse en tant qu'espace réservé pour tous les objets blob dont le nom commence par la même sous-chaîne jusqu'au caractère de délimitation.When the request includes this parameter, the operation returns a BlobPrefix element in the response body that acts as a placeholder for all blobs whose names begin with the same substring up to the appearance of the delimiter character. Le délimiteur peut être un caractère ou une chaîne.The delimiter may be a single character or a string.
marker facultatif.Optional. Valeur de chaîne qui identifie la partie de la liste à renvoyer avec l'opération de liste suivante.A string value that identifies the portion of the list to be returned with the next list operation. L'opération renvoie une valeur de marqueur dans le corps de la réponse si la liste renvoyée n'était pas terminée.The operation returns a marker value within the response body if the list returned was not complete. La valeur de marqueur peut ensuite être utilisée dans un appel suivant pour demander l'ensemble d'éléments de liste suivant.The marker value may then be used in a subsequent call to request the next set of list items.

La valeur de marqueur est opaque au client.The marker value is opaque to the client.
maxresults facultatif.Optional. Spécifie le nombre maximal d'objets blob à renvoyer, y compris tous les éléments BlobPrefix.Specifies the maximum number of blobs to return, including all BlobPrefix elements. Si la demande ne spécifie pas maxresults, ou spécifie une valeur supérieure à 5 000, le serveur renvoie jusqu'à 5 000 éléments.If the request does not specify maxresults or specifies a value greater than 5,000, the server will return up to 5,000 items.

La définition de maxresults à une valeur inférieure ou égale à zéro entraîne un code de réponse d'erreur 400 (Demande incorrecte).Setting maxresults to a value less than or equal to zero results in error response code 400 (Bad Request).
include={snapshots,metadata,uncommittedblobs,copy,deleted,tags,versions} facultatif.Optional. Spécifie un ou plusieurs datasets à inclure dans la réponse :Specifies one or more datasets to include in the response:

- snapshots: Spécifie que les instantanés doivent être inclus dans l’énumération.- snapshots: Specifies that snapshots should be included in the enumeration. Les instantanés sont répertoriés du plus ancien au plus récent dans la réponse.Snapshots are listed from oldest to newest in the response.
- metadata: Spécifie que les métadonnées d’objet BLOB doivent être retournées dans la réponse.- metadata: Specifies that blob metadata be returned in the response.
- uncommittedblobs: Spécifie que les objets BLOB pour lesquels des blocs ont été téléchargés, mais qui n’ont pas été validés à l’aide de la liste de blocs put, doivent être inclus dans la réponse.- uncommittedblobs: Specifies that blobs for which blocks have been uploaded, but which have not been committed using Put Block List, be included in the response.
- copy: Version 2012-02-12 et versions ultérieures.- copy: Version 2012-02-12 and newer. Spécifie que les métadonnées associées à une opération Copy Blob actuelle ou antérieure doivent être incluses dans la réponse.Specifies that metadata related to any current or previous Copy Blob operation should be included in the response.
-deleted: Version 2017-07-29 et versions ultérieures.-deleted: Version 2017-07-29 and newer. Spécifie que les objets BLOB supprimés de manière réversible doivent être inclus dans la réponse.Specifies that soft deleted blobs should be included in the response.
-tags: Version 2019-12-12 et versions ultérieures.-tags: Version 2019-12-12 and newer. Spécifie que les balises d’index d’objet BLOB définies par l’utilisateur doivent être incluses dans la réponse.Specifies that user-defined Blob Index tags should be included in the response.
-versions: Version 2019-12-12 et versions ultérieures.-versions: Version 2019-12-12 and newer. Spécifie que les versions des objets BLOB doivent être incluses dans l’énumération.Specifies that Versions of blobs should be included in the enumeration.

Pour spécifier plusieurs de ces options dans l'URI, vous devez séparer chaque option par une virgule encodée dans l'URL (« %82 »).To specify more than one of these options on the URI, you must separate each option with a URL-encoded comma ("%82").
timeout facultatif.Optional. Le paramètre timeout est exprimé en secondes.The timeout parameter is expressed in seconds. Pour plus d’informations, consultez définition de délais d’attente pour les opérations de service BLOB.For more information, see Setting Timeouts for Blob Service Operations.

En-têtes de requêteRequest Headers

Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.The following table describes required and optional request headers.

En-tête de requêteRequest Header DescriptionDescription
Authorization Obligatoire.Required. Spécifie le schéma d’autorisation, le nom de compte et la signature.Specifies the authorization scheme, account name, and signature. Pour plus d’informations, consultez autoriser les demandes dans le stockage Azure.For more information, see Authorize requests to Azure Storage.
Date ou x-ms-dateDate or x-ms-date Obligatoire.Required. Spécifie la date/heure en temps universel coordonné (UTC) pour la requête.Specifies the Coordinated Universal Time (UTC) for the request. Pour plus d’informations, consultez autoriser les demandes dans le stockage Azure.For more information, see Authorize requests to Azure Storage.
x-ms-version Obligatoire pour toutes les demandes autorisées, facultatif pour les demandes anonymes.Required for all authorized requests, optional for anonymous requests. Spécifie la version de l'opération à utiliser pour cette demande.Specifies the version of the operation to use for this request. Pour plus d’informations, consultez contrôle de version pour les services de stockage Azure.For more information, see Versioning for the Azure Storage Services.
x-ms-client-request-id facultatif.Optional. Fournit une valeur opaque générée par le client avec une limite de 1 Kio de caractères qui est enregistrée dans les journaux d’analyse lorsque la journalisation de l’analyse de stockage est activée.Provides a client-generated, opaque value with a 1 KiB character limit that is recorded in the analytics logs when storage analytics logging is enabled. L’utilisation de cet en-tête est fortement recommandée pour la mise en corrélation des activités côté client avec les requêtes reçues par le serveur.Using this header is highly recommended for correlating client-side activities with requests received by the server. Pour plus d’informations, consultez à propos de la journalisation des Storage Analytics et de la journalisation Azure : utilisation des journaux pour suivre les demandes de stockage.For more information, see About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests.

Corps de la demandeRequest Body

Aucun.None.

Exemple de demandeSample Request

Consultez énumération des ressources d’objet BLOB pour obtenir un exemple de demande.See Enumerating Blob Resources for a sample request.

LutteResponse

La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et un corps de réponse au format XML.The response includes an HTTP status code, a set of response headers, and a response body in XML format.

Code d’étatStatus Code

Une opération réussie envoie le code d'état 200 (OK).A successful operation returns status code 200 (OK).

Pour plus d’informations sur les codes d’État, consultez codes d’État et d’erreur.For information about status codes, see Status and Error Codes.

En-têtes de réponseResponse Headers

La réponse de l'opération inclut les en-têtes suivants.The response for this operation includes the following headers. La réponse peut aussi inclure des en-têtes HTTP standard supplémentaires.The response may also include additional standard HTTP headers. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.All standard headers conform to the HTTP/1.1 protocol specification.

En-tête de réponseResponse header DescriptionDescription
Content-Type Spécifie le format dans lequel les résultats sont renvoyés.Specifies the format in which the results are returned. Actuellement, cette valeur est application/xml.Currently this value is application/xml.
x-ms-request-id Cet en-tête identifie de façon unique la demande qui a été effectuée et peut être utilisé pour résoudre les problèmes de la demande.This header uniquely identifies the request that was made and can be used for troubleshooting the request. Pour plus d’informations, consultez Troubleshooting API Operations.For more information, see Troubleshooting API Operations.
x-ms-version Indique la version du service BLOB utilisée pour exécuter la demande.Indicates the version of the Blob service used to execute the request. Cet en-tête est renvoyé pour les demandes effectuées avec la version du 19/09/2009 et ultérieure.This header is returned for requests made using version 2009-09-19 and newer.

Cet en-tête est également retourné pour les demandes anonymes sans version spécifiée si le conteneur était marqué pour un accès public à l'aide de la version du 19/09/2009 du service BLOB.This header is also returned for anonymous requests without a version specified if the container was marked for public access using the 2009-09-19 version of the Blob service.
Date Une valeur de date/heure UTC générée par le service qui indique le moment auquel la réponse a été initiée.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
x-ms-client-request-id Cet en-tête peut être utilisé pour dépanner les demandes et les réponses correspondantes.This header can be used to troubleshoot requests and corresponding responses. La valeur de cet en-tête est égale à la valeur de l' x-ms-client-request-id en-tête si elle est présente dans la demande et que la valeur est supérieure à 1024 caractères ASCII visibles.The value of this header is equal to the value of the x-ms-client-request-id header if it is present in the request and the value is at most 1024 visible ASCII characters. Si l' x-ms-client-request-id en-tête n’est pas présent dans la demande, cet en-tête ne sera pas présent dans la réponse.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.

Corps de la réponseResponse Body

Le format de la réponse XML est le suivant.The format of the XML response is as follows.

Notez que les éléments Prefix, Marker, MaxResults, et Delimiter sont présents uniquement s'ils ont été spécifiés dans l'URI de la demande.Note that the Prefix, Marker, MaxResults, and Delimiter elements are present only if they were specified on the request URI. L'élément NextMarker a une valeur uniquement si les résultats de liste ne sont pas terminés.The NextMarker element has a value only if the list results are not complete.

Les instantanés, les métadonnées d'objet blob, et les objets blob non validés sont inclus dans la réponse uniquement s'ils sont spécifiés avec le paramètre include dans l'URI de la demande.Snapshots, blob metadata, and uncommitted blobs are included in the response only if they are specified with the include parameter on the request URI.

À partir de la version du 19/09/2009, les propriétés de l'objet blob sont encapsulées dans un élément Properties.In version 2009-09-19 and newer, the blob's properties are encapsulated within a Properties element.

À partir de la version du 19/09/2009, List Blobs renvoie les éléments renommés suivants dans le corps de la réponse :Beginning with version 2009-09-19, List Blobs returns the following renamed elements in the response body:

  • Last-Modified (précédemment LastModified)Last-Modified (previously LastModified)

  • Content-Length (précédemment Size)Content-Length (previously Size)

  • Content-Type (précédemment ContentType)Content-Type (previously ContentType)

  • Content-Encoding (précédemment ContentEncoding)Content-Encoding (previously ContentEncoding)

  • Content-Language (précédemment ContentLanguage)Content-Language (previously ContentLanguage)

L'élément Content-MD5 s'affiche pour les objets blob créés à partir de la version du 19/09/2009.The Content-MD5 element appears for blobs created with version 2009-09-19 and newer. Dans la version 2012-02-12 et les versions ultérieures, le service BLOB calcule la Content-MD5 valeur lorsque vous téléchargez un objet blob à l’aide de l' objet put BLOB, mais ne le calcule pas lorsque vous créez un objet blob à l’aide de la liste Put Block.In version 2012-02-12 and newer, the Blob service calculates the Content-MD5 value when you upload a blob using Put Blob, but does not calculate this when you create a blob using Put Block List. Vous pouvez définir explicitement la Content-MD5 valeur lorsque vous créez l’objet BLOB, ou en appelant les opérations Put Block List ou Set Blob Properties .You can explicitly set the Content-MD5 value when you create the blob, or by calling Put Block List or Set Blob Properties operations.

Pour les versions 2009-09-19 et ultérieures, mais antérieures à la version 2015-02-21, List Blobs l’appel de sur un conteneur qui inclut des objets BLOB d’ajout échoue avec le code d’état 409 (FeatureVersionMismatch) si le résultat de la liste contient un objet blob d’ajout.For versions from 2009-09-19 and newer but prior to version 2015-02-21, calling List Blobs on a container that includes append blobs will fail with status code 409 (FeatureVersionMismatch) if the result of listing contains an append blob.

LeaseState et LeaseDuration apparaissent uniquement dans la version 2012-02-12 et les versions ultérieures.LeaseState and LeaseDuration appear only in version 2012-02-12 and later.

CopyId, CopyStatus , CopySource , CopyProgress , CopyCompletionTime et CopyStatusDescription apparaissent uniquement dans la version 2012-02-12 et les versions ultérieures, lorsque cette opération comprend le include={copy} paramètre.CopyId, CopyStatus, CopySource, CopyProgress, CopyCompletionTime, and CopyStatusDescription only appear in version 2012-02-12 and later, when this operation includes the include={copy} parameter. Ces éléments n'apparaissent pas si cet objet blob n'a jamais été la destination dans une opération Copy Blob, ou si cet objet blob a été modifié après une opération Copy Blob avec Set Blob Properties, Put Blob ou Put Block List.These elements do not appear if this blob has never been the destination in a Copy Blob operation, or if this blob has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List. Ces éléments n’apparaissent pas non plus avec un objet BLOB créé par l' objet blob de copie avant la version 2012-02-12.These elements also do not appear with a blob created by Copy Blob before version 2012-02-12.

Dans la version du 15/08/2013 et les versions ultérieures, l'élément EnumerationResults contient un attribut ServiceEndpoint spécifiant le point de terminaison d'objet blob, et un champ ContainerName indiquant le nom du conteneur.In version 2013-08-15 and newer, the EnumerationResults element contains a ServiceEndpoint attribute specifying the blob endpoint, and a ContainerName field specifying the name of the container. Dans les versions précédentes, ces deux attributs étaient combinés dans le champ ContainerName.In previous versions these two attributes were combined together in the ContainerName field. En outre, dans la version du 15/08/2013 et les versions ultérieures, l'élément Url sous Blob a été supprimé.Also in version 2013-08-15 and newer, the Url element under Blob has been removed.

Pour la version 2015-02-21 et les versions ultérieures, List Blobs retourne les objets BLOB de tous les types (objets BLOB de bloc, de page et d’ajout).For version 2015-02-21 and above, List Blobs returns blobs of all types (block, page, and append blobs).

Pour la version 2015-12-11 et les versions ultérieures, List Blobs retourne l' ServerEncrypted élément.For version 2015-12-11 and above, List Blobs returns the ServerEncrypted element. Cet élément a la valeur true si l’objet BLOB et les métadonnées d’application sont entièrement chiffrés, et false sinon.This element is set to true if the blob and application metadata are completely encrypted, and false otherwise.

Pour la version 2016-05-31 et les versions ultérieures, List Blobs retourne l' IncrementalCopy élément pour les objets BLOB de copie incrémentielle et les instantanés dont la valeur est définie sur true .For version 2016-05-31 and above, List Blobs returns the IncrementalCopy element for incremental copy blobs and snapshots with the value set to true.

Pour la version 2017-04-17 et versions ultérieures, List Blobs retourne l' AccessTier élément si un niveau d’accès a été défini explicitement.For version 2017-04-17 and above, List Blobs returns the AccessTier element if an access tier has been explicitly set. Pour obtenir la liste des niveaux d’objets BLOB de pages Premium autorisés, consultez stockage Premium hautes performances et disques managés pour les machines virtuelles.For a list of allowed premium page blob tiers, see High-performance Premium Storage and managed disks for VMs. Pour le stockage d’objets BLOB ou les comptes usage général v2, les valeurs valides sont Hot / Cool / Archive .For Blob Storage or General Purpose v2 accounts, valid values are Hot/Cool/Archive. Si l’objet blob est en attente de réalimentation, l' ArchiveStatus élément est retourné avec l’une des valeurs valides rehydrate-pending-to-hot / rehydrate-pending-to-cool .If the blob is in rehydrate pending state then ArchiveStatus element is returned with one of the valid values rehydrate-pending-to-hot/rehydrate-pending-to-cool. Pour plus d’informations sur la hiérarchisation des objets BLOB de blocs , consultez niveaux de stockage chaud, froid et Archive.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

Pour la version 2017-04-17 et les versions ultérieures, List Blobs retourne l' AccessTierInferred élément sur le stockage d’objets BLOB ou les comptes usage général v2.For version 2017-04-17 and above, List Blobs returns the AccessTierInferred element on Blob Storage or General Purpose v2 accounts. Si l’objet blob de blocs n’a pas le niveau d’accès défini, nous déduisons le niveau des propriétés de compte de stockage et cette valeur est définie sur true .If the block blob does not have the access tier set then we infer tier from storage account properties and this value is set to true. Cet en-tête est présent uniquement si le niveau est déduit à partir de la propriété de compte.This header is present only if the tier is inferred from the account property. Pour plus d’informations sur la hiérarchisation des objets BLOB de blocs , consultez niveaux de stockage chaud, froid et Archive.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

Pour la version 2017-04-17 et les versions ultérieures, List Blobs retourne l' AccessTierChangeTime élément sur le stockage d’objets BLOB ou les comptes usage général v2.For version 2017-04-17 and above, List Blobs returns the AccessTierChangeTime element on Blob Storage or General Purpose v2 accounts. Cette valeur est retournée uniquement si le niveau sur l’objet blob de blocs a été défini.This is returned only if tier on block blob was ever set. Le format de date est conforme à la RFC 1123.The date format follows RFC 1123. Pour plus d’informations, consultez représentation des valeurs de Date-Time dans les en-têtes.For more information, see Representation of Date-Time Values in Headers. Pour plus d’informations sur la hiérarchisation des objets BLOB de blocs , consultez niveaux de stockage chaud, froid et Archive.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

Pour la version 2017-07-29 et versions ultérieures, Deleted DeletedTime et RemainingRetentionDays apparaissent lorsque cette opération comprend le include={deleted} paramètre.For version 2017-07-29 and above, Deleted, DeletedTime and RemainingRetentionDays appear when this operation includes the include={deleted} parameter. Ces éléments n’apparaissent pas si cet objet BLOB n’a pas été supprimé.These elements do not appear if this blob was not deleted. Ces éléments s’affichent pour les objets BLOB ou les instantanés qui sont supprimés avec l' DELETE opération quand la fonctionnalité de suppression réversible a été activée.These elements appear for blob or snapshot that are deleted with DELETE operation when soft delete feature was enabled. Deleted l’élément a la valeur true pour les objets BLOB et les instantanés qui sont supprimés de manière réversible.Deleted element is set to true for blobs and snapshots that are soft deleted. Deleted-Time correspond à l’heure à laquelle l’objet BLOB a été supprimé.Deleted-Time corresponds to time when the blob was deleted. RemainingRetentionDays indique le nombre de jours après lequel un objet BLOB supprimé de manière réversible sera définitivement supprimé par le service BLOB.RemainingRetentionDays indicates number of days after which soft deleted blob will be permanently deleted by blob service.

Pour la version 2017-11-09 et les versions ultérieures, Creation-Time retourne l’heure à laquelle cet objet BLOB a été créé.For version 2017-11-09 and above, Creation-Time returns the time at which this blob was created.

Pour la version 2019-02-02 et versions ultérieures, List Blobs retourne l' CustomerProvidedKeySha256 élément si l’objet blob est chiffré avec une clé fournie par le client.For version 2019-02-02 and above, List Blobs returns the CustomerProvidedKeySha256 element if the blob is encrypted with a customer-provided key. La valeur sera définie sur le hachage SHA-256 de la clé utilisée pour chiffrer l’objet BLOB.The value will be set to the SHA-256 hash of the key used to encrypt the blob. En outre, si l’opération inclut le include={metadata} paramètre et que des métadonnées d’application sont présentes sur un objet BLOB chiffré avec une clé fournie par le client, l' Metadata élément aura un Encrypted="true" attribut pour indiquer que l’objet BLOB a des métadonnées qui ne peuvent pas être déchiffrées dans le cadre de l' List Blobs opération.Additionally, if the operation includes the include={metadata} parameter and there is application metadata present on a blob encrypted with a customer-provided key, the Metadata element will have an Encrypted="true" attribute to indicate that the blob has metadata which cannot be decrypted as part of the List Blobs operation. Appelez obtenir des propriétés d’objet BLOB ou obtenir les métadonnées d’objet BLOB avec la clé fournie par le client pour accéder aux métadonnées de ces objets BLOB.Call Get Blob Properties or Get Blob Metadata with the customer-provided key to access the metadata for these blobs.

Pour la version 2019-02-02 et versions ultérieures, List Blobs retourne l' EncryptionScope élément si l’objet blob est chiffré avec une étendue de chiffrement.For version 2019-02-02 and above, List Blobs returns the EncryptionScope element if the blob is encrypted with an encryption scope. La valeur sera définie sur le nom de la portée de chiffrement utilisée pour chiffrer l’objet BLOB.The value will be set to the name of the encryption scope used to encrypt the blob. Si l’opération comprend le include={metadata} paramètre, les métadonnées d’application sur l’objet BLOB sont déchiffrées de manière transparente et disponibles dans l' Metadata élément.If the operation includes the include={metadata} parameter, application metadata on the blob will be transparently decrypted and available in the Metadata element.

Pour la version 2019-12-12 et les versions ultérieures, List Blobs retourne l' RehydratePriority élément sur le stockage d’objets BLOB ou les comptes usage général v2 si l’objet est dans un état d’attente de réalimentation.For version 2019-12-12 and above, List Blobs returns the RehydratePriority element on Blob Storage or General Purpose v2 accounts if object is in rehydrate pending state. Les valeurs valides sont High / Standard .Valid values are High/Standard. Pour plus d’informations sur la hiérarchisation des objets BLOB de blocs , consultez niveaux de stockage chaud, froid et Archive.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

Pour la version 2019-12-12 et les versions ultérieures, List Blobs retourne l' VersionId élément pour les objets BLOB et les versions BLOB générées lorsque le contrôle de version est activé sur le compte.For version 2019-12-12 and above, List Blobs returns the VersionId element for blobs and generated blob versions when Versioning is enabled on the account.

Pour la version 2019-12-12 et versions ultérieures, List Blobs retourne l' IsCurrentVersion élément pour la version actuelle de l’objet BLOB avec la valeur définie sur true , pour le différencier des versions générées automatiquement en lecture seule.For version 2019-12-12 and above, List Blobs returns the IsCurrentVersion element for the current version of the blob with the value set to true, to differentiate it from the read-only automatically generated versions.

Pour la version 2019-12-12 et les versions ultérieures, List Blobs retourne l' TagCount élément pour les objets BLOB avec des balises.For version 2019-12-12 and above, List Blobs returns the TagCount element for blobs with any tags. L' Tags élément apparaît uniquement lorsque cette opération comprend le include={tags} paramètre.The Tags element appears only when this operation includes the include={tags} parameter. Ces éléments ne s’affichent pas s’il n’existe aucune balise sur l’objet BLOB.These elements do not appear if there are no tags on the blob.

Pour la version 2020-02-10 et les versions ultérieures, List Blobs retourne l' LastAccessTime élément.For version 2020-02-10 and above, List Blobs returns the LastAccessTime element. Les éléments indiquent la date du dernier accès aux données de l’objet BLOB en fonction de la stratégie de suivi de la dernière heure d’accès du compte de stockage.The elements shows when the blob's data was last accessed according to the storage account's last access time tracking policy. L’élément n’est pas retourné si le compte de stockage n’a pas de stratégie de suivi de la dernière heure d’accès ou si la stratégie est désactivée.The element will not be returned if the storage account does not have a last access time tracking policy, or the policy is disabled. Pour plus d’informations sur la définition de la stratégie de suivi de la dernière heure d’accès du compte, consultez API du service BLOB.For information about setting account's last access time tracking policy, see Blob Service API. L' LastAccessTime élément n’effectue pas le suivi de la dernière heure d’accès aux métadonnées de l’objet BLOB.The LastAccessTime element does not track the last time when the blob's metadata is accessed.

<?xml version="1.0" encoding="utf-8"?>  
<EnumerationResults ServiceEndpoint="http://myaccount.blob.core.windows.net/"  ContainerName="mycontainer">  
  <Prefix>string-value</Prefix>  
  <Marker>string-value</Marker>  
  <MaxResults>int-value</MaxResults>  
  <Delimiter>string-value</Delimiter>  
  <Blobs>  
    <Blob>  
      <Name>blob-name</name>  
      <Snapshot>date-time-value</Snapshot>  
      <VersionId>date-time-vlue</VersionId>
      <IsCurrentVersion>true</IsCurrentVersion>
      <Deleted>true</Deleted>
      <Properties> 
        <Creation-Time>date-time-value</Creation-Time>
        <Last-Modified>date-time-value</Last-Modified>  
        <Etag>etag</Etag>  
        <Content-Length>size-in-bytes</Content-Length>  
        <Content-Type>blob-content-type</Content-Type>  
        <Content-Encoding />  
        <Content-Language />  
        <Content-MD5 />  
        <Cache-Control />  
        <x-ms-blob-sequence-number>sequence-number</x-ms-blob-sequence-number>  
        <BlobType>BlockBlob|PageBlob|AppendBlob</BlobType>  
        <AccessTier>tier</AccessTier>  
        <LeaseStatus>locked|unlocked</LeaseStatus>  
        <LeaseState>available | leased | expired | breaking | broken</LeaseState>  
        <LeaseDuration>infinite | fixed</LeaseDuration>  
        <CopyId>id</CopyId>  
        <CopyStatus>pending | success | aborted | failed </CopyStatus>  
        <CopySource>source url</CopySource>  
        <CopyProgress>bytes copied/bytes total</CopyProgress>  
        <CopyCompletionTime>datetime</CopyCompletionTime>  
        <CopyStatusDescription>error string</CopyStatusDescription>  
        <ServerEncrypted>true</ServerEncrypted> 
        <CustomerProvidedKeySha256>encryption-key-sha256</CustomerProvidedKeySha256>
        <EncryptionScope>encryption-scope-name</EncryptionScope>
        <IncrementalCopy>true</IncrementalCopy>
        <AccessTierInferred>true</AccessTierInferred>
        <AccessTierChangeTime>datetime</AccessTierChangeTime>
        <DeletedTime>datetime</DeletedTime>
        <RemainingRetentionDays>no-of-days</RemainingRetentionDays>
        <TagCount>number of tags between 1 to 10</TagCount>
        <RehydratePriority>rehydrate priority</RehydratePriority>
      </Properties>  
      <Metadata>     
        <Name>value</Name>  
      </Metadata>  
      <Tags>
          <TagSet>
              <Tag>
                  <Key>TagName</Key>
                  <Value>TagValue</Value>
              </Tag>
          </TagSet>
      </Tags>
      <OrMetadata />
    </Blob>  
    <BlobPrefix>  
      <Name>blob-prefix</Name>  
    </BlobPrefix>  
  </Blobs>  
  <NextMarker />  
</EnumerationResults>  

Exemple de réponseSample Response

Consultez énumération des ressources d’objet BLOB pour obtenir un exemple de réponse.See Enumerating Blob Resources for a sample response.

L'Authorization

Si la liste de contrôle d'accès (ACL) du conteneur autorise l'accès anonyme au conteneur, n'importe quel client peut appeler cette opération.If the container's access control list (ACL) is set to allow anonymous access to the container, any client may call this operation. Dans le cas contraire, cette opération peut être appelée par le propriétaire du compte ou par toute personne avec une signature d'accès partagé qui dispose des autorisations pour répertorier les objets blob dans un conteneur.Otherwise, this operation can be called by the account owner and by anyone with a Shared Access Signature that has permission to list blobs in a container.

RemarquesRemarks

Propriétés d'objet blob dans la réponseBlob Properties in the Response

Si vous avez demandé que les objets blob non validés soient inclus dans l'énumération, notez que certaines propriétés ne sont pas définies tant que l'objet blob n'est pas validé, c'est pourquoi certaines de ces propriétés peuvent ne pas être renvoyées dans la réponse.If you have requested that uncommitted blobs be included in the enumeration, note that some properties are not set until the blob is committed, so some properties may not be returned in the response.

L'élément x-ms-blob-sequence-number est renvoyé uniquement pour des objets blob de pages.The x-ms-blob-sequence-number element is only returned for page blobs.

L' OrMetadata élément est retourné uniquement pour les objets BLOB de blocs.The OrMetadata element is only returned for block blobs.

Pour des objets blob de pages, la valeur renvoyée dans l'élément Content-Length correspond à la valeur de l'en-tête x-ms-blob-content-length de l'objet blob.For page blobs, the value returned in the Content-Length element corresponds to the value of the blob's x-ms-blob-content-length header.

L'élément Content-MD5 s'affiche dans le corps de la réponse uniquement s'il a été défini dans l'objet blob à l'aide de la version du 19/09/2009 ou d'une version ultérieure.The Content-MD5 element appears in the response body only if it has been set on the blob using version 2009-09-19 or later. Vous pouvez définir la Content-MD5 propriété lorsque l’objet blob est créé ou en appelant les Propriétés Set Blob.You can set the Content-MD5 property when the blob is created or by calling Set Blob Properties. À partir de la version du 12/02/2012, Put Blob définit la valeur MD5 de l'objet blob de blocs même si la demande Put Blob n'inclut pas d'en-tête MD5.In version 2012-02-12 and newer, Put Blob sets a block blob’s MD5 value even when the Put Blob request doesn’t include an MD5 header.

Métadonnées dans la réponseMetadata in the Response

L'élément Metadata peut être présent uniquement si le paramètre include=metadata a été spécifié dans l'URI.The Metadata element is present only if the include=metadata parameter was specified on the URI. Dans l'élément Metadata, la valeur de chaque paire nom-valeur est indiquée dans un élément correspondant au nom de la paire.Within the Metadata element, the value of each name-value pair is listed within an element corresponding to the pair's name.

Notez que les métadonnées demandées avec ce paramètre doivent être stockées conformément aux restrictions d'attribution de nom imposées par la version du 19/09/2009 du service BLOB.Note that metadata requested with this parameter must be stored in accordance with the naming restrictions imposed by the 2009-09-19 version of the Blob service. À compter de cette version, tous les noms de métadonnées doivent respecter les conventions d’affectation de noms pour les identificateurs C#.Beginning with this version, all metadata names must adhere to the naming conventions for C# identifiers.

Si une paire nom-valeur de métadonnées viole les restrictions d'attribution de noms imposées par la version du 19/09/2009, le corps de la réponse indique le nom problématique dans un élément x-ms-invalid-name, comme indiqué dans le fragment XML suivant :If a metadata name-value pair violates the naming restrictions enforced by the 2009-09-19 version, the response body indicates the problematic name within an x-ms-invalid-name element, as shown in the following XML fragment:

  
…  
<Metadata>  
  <MyMetadata1>first value</MyMetadata1>  
  <MyMetadata2>second value</MyMetadata2>  
  <x-ms-invalid-name>invalid-metadata-name</x-ms-invalid-name>  
</Metadata>  
…  
  

Balises dans la réponseTags in the Response

L' Tags élément est présent uniquement si le include=tags paramètre a été spécifié dans l’URI et s’il existe des balises sur l’objet BLOB.The Tags element is present only if the include=tags parameter was specified on the URI and if there are tags on the blob. Au sein de l' TagSet élément, jusqu’à 10 Tag éléments sont retournés, chacun contenant le key et value des balises d’index d’objet BLOB définies par l’utilisateur.Within the TagSet element, up to 10 Tag elements are returned, each containing the key and value of the user-defined Blob Index tags. L’ordre des balises n’est pas garanti dans la réponse.The ordering of tags is not guaranteed in the response.

Les Tags éléments et ne TagCount sont pas retournés s’il n’y a aucune balise sur l’objet BLOB.The Tags and TagCount elements are not returned if there are no tags on the blob.

Le service de stockage maintient une cohérence forte entre un objet BLOB et ses balises, mais l’index secondaire est finalement cohérent.The storage service maintains strong consistency between a blob and its tags, but the secondary index is eventually consistent. Les balises peuvent être visibles dans une réponse aux objets BLOB de liste avant d’être visibles pour rechercher des objets BLOB par des balises.Tags may be visible in a response to List Blobs before they are visible to Find Blobs by Tags operations.

Instantanés dans la réponseSnapshots in the Response

Les instantanés sont répertoriés dans la réponse uniquement si le paramètre include=snapshots a été spécifié dans l'URI.Snapshots are listed in the response only if the include=snapshots parameter was specified on the URI. Les instantanés répertoriés dans la réponse n'incluent pas l'élément LeaseStatus, car les instantanés ne peuvent pas avoir de baux actifs.Snapshots listed in the response do not include the LeaseStatus element, as snapshots cannot have active leases.

Si vous appelez List Blobs avec un délimiteur, vous ne pouvez pas également inclure des instantanés dans l'énumération.If you call List Blobs with a delimiter, you cannot also include snapshots in the enumeration. Une demande qui inclut les deux renvoie une erreur InvalidQueryParameter (code d'état HTTP 400 – Demande incorrecte).A request that includes both returns an InvalidQueryParameter error (HTTP status code 400 – Bad Request).

Objets blob non validés dans la réponseUncommitted Blobs in the Response

Les objets blobs non validés sont répertoriés dans la réponse uniquement si le paramètre include=uncommittedblobs a été spécifié dans l'URI.Uncommitted blobs are listed in the response only if the include=uncommittedblobs parameter was specified on the URI. Les objets blob non validés répertoriés dans la réponse n'incluent pas les éléments suivants :Uncommitted blobs listed in the response do not include any of the following elements:

  • Last-Modified

  • Etag

  • Content-Type

  • Content-Encoding

  • Content-Language

  • Content-MD5

  • Cache-Control

  • Metadata

Objets BLOB supprimés dans la réponseDeleted Blobs in the Response

Les objets BLOB supprimés sont répertoriés dans la réponse uniquement si le include=deleted paramètre a été spécifié dans l’URI.Deleted blobs are listed in the response only if the include=deleted parameter was specified on the URI. Les objets BLOB supprimés figurant dans la réponse n’incluent pas les éléments de bail comme les objets BLOB supprimés ne peuvent pas avoir de baux actifs.Deleted blobs listed in the response do not include the Lease elements as deleted blobs cannot have active leases.

Les instantanés supprimés sont inclus dans la réponse de liste si include=deleted,snapshot a été spécifié dans l’URI.Deleted snapshots are included in list response if include=deleted,snapshot was specified on the URI.

Métadonnées de réplication d’objets dans la réponseObject Replication Metadata in the Response

L' OrMetadata élément est présent lorsqu’une stratégie de réplication d’objet a été évaluée sur un objet BLOB et que l’appel des objets BLOB de liste a été effectué à l’aide de la version 2019-12-12 ou ultérieure.The OrMetadata element is present when an Object Replication policy has been evaluated on a blob and the List Blobs call was made using version 2019-12-12 or later. Dans l'élément OrMetadata, la valeur de chaque paire nom-valeur est indiquée dans un élément correspondant au nom de la paire.Within the OrMetadata element, the value of each name-value pair is listed within an element corresponding to the pair's name. Le format de nom est or-{policy-id}_{rule-id} , où {policy-id} est un GUID qui représente l’identificateur de la stratégie de réplication d’objets sur le compte de stockage et {rule-id} est un GUID qui représente l’identificateur de la règle sur le conteneur de stockage.The format of name is or-{policy-id}_{rule-id}, where {policy-id} is a guid representing the object replication policy identifier on the storage account and {rule-id} is a guid representing the rule identifier on the storage container. Les valeurs valides sont complete / failed .Valid values are complete/failed.

  
…  
<OrMetadata>  
  <or-e524bba7-4323-4b93-91f8-d09d5d0b7057_d86c51de-ef02-4264-bdcf-dcd389a6c7ac>complete</or-e524bba7-4323-4b93-91f8-d09d5d0b7057_d86c51de-ef02-4264-bdcf-dcd389a6c7ac>  
  <or-2b302b5d-fcd5-44d6-a5ed-455bf27e17ea_4a398ff5-2a89-4090-879b-10248f23428e>failed</or-2b302b5d-fcd5-44d6-a5ed-455bf27e17ea_4a398ff5-2a89-4090-879b-10248f23428e>  
</OrMetadata>  
…  
  

Renvoi de jeux de résultats en utilisant une valeur MarkerReturning Result Sets Using a Marker Value

Si vous spécifiez une valeur pour le paramètre maxresults et que le nombre d'objets blob à renvoyer dépasse cette valeur, ou dépasse la valeur par défaut pour maxresults, le corps de la réponse contient un élément NextMarker qui indique l'objet blob suivant à renvoyer dans une demande suivante.If you specify a value for the maxresults parameter and the number of blobs to return exceeds this value, or exceeds the default value for maxresults, the response body will contain a NextMarker element that indicates the next blob to return on a subsequent request. Pour renvoyer l'ensemble suivant d'éléments, spécifiez la valeur de NextMarker comme paramètre de marqueur dans l'URI pour la demande suivante.To return the next set of items, specify the value of NextMarker as the marker parameter on the URI for the subsequent request.

Notez que la valeur de NextMarker doit être traitée comme opaque.Note that the value of NextMarker should be treated as opaque.

Utilisation d'un délimiteur pour parcourir l'espace de noms d'objets blobUsing a Delimiter to Traverse the Blob Namespace

Le paramètre delimiter permet à l'appelant de parcourir l'espace de noms d'objet blob en utilisant un délimiteur configuré par l'utilisateur.The delimiter parameter enables the caller to traverse the blob namespace by using a user-configured delimiter. De cette façon, vous pouvez parcourir une hiérarchie virtuelle d'objets blob, comme s'il s'agissait d'un système de fichiers.In this way, you can traverse a virtual hierarchy of blobs as though it were a file system. Le délimiteur peut être un caractère ou une chaîne.The delimiter may be a single character or a string. Lorsque la demande comprend ce paramètre, l'opération renvoie un élément BlobPrefix.When the request includes this parameter, the operation returns a BlobPrefix element. L'élément BlobPrefix est renvoyé à la place de tous les objets blob dont le nom commence par la même sous-chaîne jusqu'au caractère du délimiteur.The BlobPrefix element is returned in place of all blobs whose names begin with the same substring up to the appearance of the delimiter character. La valeur de l'élément BlobPrefix est substring+delimiter, où substring est la sous-chaîne commune qui débute un ou plusieurs noms d'objet blob, et delimiter est la valeur du paramètre delimiter.The value of the BlobPrefix element is substring+delimiter, where substring is the common substring that begins one or more blob names, and delimiter is the value of the delimiter parameter.

Vous pouvez utiliser la valeur de BlobPrefix pour appeler la liste des objets blob qui commencent par ce préfixe, en indiquant la valeur de BlobPrefix pour le paramètre prefix dans l'URI de la demande.You can use the value of BlobPrefix to make a subsequent call to list the blobs that begin with this prefix, by specifying the value of BlobPrefix for the prefix parameter on the request URI.

Notez que chaque élément BlobPrefix renvoyé est comptabilisé dans le résultat, tout comme chaque élément Blob.Note that each BlobPrefix element returned counts toward the maximum result, just as each Blob element does.

Les objets blob sont répertoriés en ordre alphabétique dans le corps de la réponse, avec les lettres majuscules répertoriées en premier.Blobs are listed in alphabetical order in the response body, with upper-case letters listed first.

Erreurs de copie dans CopyStatusDescriptionCopy errors in CopyStatusDescription

CopyStatusDescription contient des informations supplémentaires sur l'échec Copy Blob.CopyStatusDescription contains more information about the Copy Blob failure.

  • Lorsqu'une tentative de copie échoue et que le service BLOB réessaie l'opération, CopyStatus a la valeur pending, et le texte CopyStatusDescription décrit l'échec qui peut avoir eu lieu pendant la dernière tentative de copie.When a copy attempt fails and the Blob service is still retrying the operation, CopyStatus is set to pending, and the CopyStatusDescription text describes the failure that may have occurred during the last copy attempt.

  • Lorsque CopyStatus a la valeur failed, le texte CopyStatusDescription décrit l'erreur qui a provoqué l'échec de l'opération de copie.When CopyStatus is set to failed, the CopyStatusDescription text describes the error that caused the copy operation to fail.

Le tableau suivant décrit les trois champs de chaque valeur CopyStatusDescription.The following table describes the three fields of every CopyStatusDescription value.

ComposantComponent DescriptionDescription
Code d'état HTTPHTTP status code Entier de 3chiffres standard indiquant la défaillance.Standard 3-digit integer specifying the failure.
Code d'erreurError code Mot clé décrivant l’erreur fournie par Azure dans l’élément <ErrorCode > .Keyword describing error that is provided by Azure in the <ErrorCode> element. Si aucun <élément ErrorCode n' > apparaît, un mot clé contenant le texte d’erreur standard associé au code d’État http à 3 chiffres dans la spécification http est utilisé.If no <ErrorCode> element appears, a keyword containing standard error text associated with the 3-digit HTTP status code in the HTTP specification is used. Consultez codes d’erreur de l’API REST courantes.See Common REST API Error Codes.
InformationInformation Description détaillée de l'échec, entre guillemets.Detailed description of failure, in quotes.

Le tableau suivant décrit les valeurs CopyStatus et CopyStatusDescription des scénarios d'échec courants.The following table describes the CopyStatus and CopyStatusDescription values of common failure scenarios.

Important

Le texte de description indiqué ici peut changer sans avertissement, même sans modification de version, il peut donc ne pas être exactement identique.Description text shown here can change without warning, even without a version change, so do not rely on matching this exact text.

ScénarioScenario Valeur CopyStatusCopyStatus value Valeur CopyStatusDescriptionCopyStatusDescription value
L'opération de copie s'est terminée avec succès.Copy operation completed successfully. successsuccess emptyempty
Opération de copie abandonnée par l'utilisateur avant qu'elle se soit terminée.User aborted copy operation before it completed. abortedaborted emptyempty
Une défaillance s'est produite lors de la lecture de l'objet blob source pendant une opération de copie, mais l'opération sera réessayée.A failure occurred when reading from the source blob during a copy operation, but the operation will be retried. en attentepending 502 BadGateway « Erreur autorisant une nouvelle tentative lors de la lecture de la source.502 BadGateway "Encountered a retryable error when reading the source. Nouvelle tentative.Will retry. Heure de la défaillance : <heure > »Time of failure: <time>"
Une défaillance s'est produite lors de la lecture de l'objet blob de destination d'une opération de copie, mais l'opération sera réessayée.A failure occurred when writing to the destination blob of a copy operation, but the operation will be retried. en attentepending 500 InternalServerError « Erreur autorisant une nouvelle tentative.500 InternalServerError "Encountered a retryable error. Nouvelle tentative.Will retry. Heure de la défaillance : <heure > »Time of failure: <time>"
Une défaillance irrécupérable s'est produite lors de la lecture de l'objet blob source d'une opération de copie.An unrecoverable failure occurred when reading from the source blob of a copy operation. échecfailed 404 ResourceNotFound « échec de la copie lors de la lecture de la source. »404 ResourceNotFound "Copy failed when reading the source." Remarque : Lorsque vous signalez cette erreur sous-jacente, Azure retourne ResourceNotFound dans l’élément <ErrorCode > .Note: When reporting this underlying error, Azure returns ResourceNotFound in the <ErrorCode> element. Si aucun <élément ErrorCode n' > apparaissait dans la réponse, une représentation sous forme de chaîne standard de l’État http tel que NotFound s’affiche.If no <ErrorCode> element appeared in the response, a standard string representation of the HTTP status such as NotFound would appear.
Le délai d'expiration limitant toutes les opérations de copie s'est écoulé.The timeout period limiting all copy operations elapsed. (Actuellement le délai d'expiration est de 2 semaines.)(Currently the timeout period is 2 weeks.) échecfailed 500 OperationCancelled « La copie a dépassé le temps maximal alloué. »500 OperationCancelled "The copy exceeded the maximum allowed time."
L'opération de copie a échoué trop souvent lors de la lecture de la source, et n'a pas atteint un ratio minimum de tentatives de succès.The copy operation failed too often when reading from the source, and didn’t meet a minimum ratio of attempts to successes. (Ce délai d'expiration a empêché une nouvelle tentative d'une source de mauvaise qualité pendant 2 semaines avant d'échouer).(This timeout prevents retrying a very poor source over 2 weeks before failing). échecfailed 500 OperationCancelled « La copie a échoué lors de la lecture de la source. »500 OperationCancelled "The copy failed when reading the source."

Voir aussiSee also

Codes d’État et d’erreur Status and Error Codes
Codes d’erreur de service BLOBBlob Service Error Codes