VENTES: 1-800-867-1389
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

Liste d'objets BLOB

 

Le List Blobs opération énumère la liste d'objets BLOB sous le conteneur spécifié.

Le List Blobs demande peut être construite comme suit. HTTPS est recommandée. Remplacez myaccount avec le nom de votre compte de stockage :

(Méthode)

URI de la demande

Version HTTP

GET

https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list

HTTP/1.1

Lorsque vous élaborez une demande au service de stockage émulé, spécifiez le nom d'hôte de l'émulateur et un port de service Blob en tant que 127.0.0.1:10000, suivie du nom de compte de stockage émulé :

(Méthode)

URI de la demande

Version HTTP

GET

http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list

HTTP/1.1

Pour plus d'informations, consultez à l'aide de l'émulateur de stockage Azure pour le développement et le test.

Les paramètres supplémentaires suivants peuvent être spécifiés dans l'URI.

Paramètre

Description

prefix

Facultatif. Filtres les résultats pour retourner uniquement les objets BLOB dont les noms commencent par le préfixe spécifié.

delimiter

Facultatif. Lorsque la demande inclut ce paramètre, l'opération retourne un BlobPrefix élément dans le corps de réponse qui agit comme un espace réservé pour tous les objets BLOB dont les noms commencent par la même sous-chaîne jusqu'au caractère du délimiteur. Le délimiteur peut être un caractère unique ou une chaîne.

marker

Facultatif. Valeur de chaîne qui identifie la partie de la liste à renvoyer à l'opération suivante de la liste. L'opération retourne une valeur de marqueur dans le corps de réponse si la liste renvoyée n'était pas terminée. La valeur de marqueur peut ensuite être utilisée dans un appel suivant pour demander l'ensemble suivant d'éléments de liste.

La valeur de marqueur est opaque au client.

maxresults

Facultatif. Spécifie le nombre maximal d'objets BLOB à renvoyer, y compris tous les BlobPrefix éléments. 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.

Paramètre maxresults à une valeur inférieure ou égale à zéro entraîne réponse indiquant une erreur de code 400 (demande incorrecte).

include={snapshots,metadata,uncommittedblobs,copy}

Facultatif. Spécifie un ou plusieurs jeux de données à inclure dans la réponse :

  • snapshots: Spécifie que les instantanés doivent être inclus dans l'énumération. Les instantanés sont répertoriés du plus ancien au plus récent dans la réponse.

  • metadata: Spécifie que les métadonnées d'objets blob retourné dans la réponse.

  • uncommittedblobs: Spécifie que les objets BLOB pour les blocs qui ont été téléchargés, mais qui n'ont pas été validé à l'aide de Placez la liste de blocage, inclus dans la réponse.

  • copy: La version 2012-02-12 et les versions ultérieures. Indique que les métadonnées liées à n'importe quel cours ou précédente Copy Blob doit être compris dans la réponse.

Pour spécifier plusieurs de ces options dans l'URI, vous devez séparer chaque option par une virgule codée URL (« % 82 »).

timeout

Facultatif. Le timeout paramètre est exprimé en secondes. Pour plus d'informations, consultez Définition de délais d'expiration pour les opérations du service BLOB.

Le tableau suivant décrit les en-têtes de demande obligatoires et facultatifs.

En-tête de demande

Description

Authorization

Requis. Spécifie le schéma d'authentification, le nom de compte et la signature. Pour plus d'informations, consultez Authentification pour les services Azure Storage.

Date ou x-ms-date

Requis. Spécifie le temps universel coordonné (UTC) pour la demande. Pour plus d'informations, consultez Authentification pour les services Azure Storage.

x-ms-version

Obligatoire pour toutes les demandes authentifiées, facultatifs pour les demandes anonymes. Spécifie la version de l'opération à utiliser pour cette demande. Pour plus d'informations, consultez Contrôle de version des Services de stockage Azure.

x-ms-client-request-id

Facultatif. Fournit une valeur opaque générée par le client avec une limite de caractère de 1 Ko qui est enregistrée dans les journaux d'analyse lors de la journalisation storage analytics est activée. À l'aide de cet en-tête est fortement recommandée pour mettre en corrélation des activités côté client avec les requêtes reçues par le serveur. Pour plus d'informations, consultez À propos de la journalisation Storage Analytics et journalisation Azure : à l'aide de journaux pour suivre les demandes de stockage.

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.

Une opération réussie renvoie le code d'état 200 (OK).

Pour plus d'informations sur les codes d'état, consultez Codes d'erreur et d'état.

La réponse pour cette opération inclut les en-têtes suivants. La réponse peut également inclure des en-têtes HTTP standard supplémentaires. Tous les en-têtes standards se conforment à la spécification du protocole HTTP/1.1.

En-tête de réponse

Description

Content-Type

Spécifie le format dans lequel les résultats sont retournés. Actuellement, cette valeur est 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ée pour résoudre la demande. Pour plus d'informations, consultez Dépannage des opérations d'API.

x-ms-version

Indique la version du service d'objets Blob utilisé pour exécuter la demande. Cet en-tête est renvoyé pour les demandes effectuées à l'aide de la version 2009-09-19 et ultérieures.

Cet en-tête est également retourné pour les demandes anonymes sans version spécifiée si le conteneur a été marqué pour un accès public à l'aide de la version 2009-09-19 du service Blob.

Date

Une valeur de date/heure UTC générée par le service qui indique l'heure à laquelle la réponse a été initiée.

Le format de la réponse XML est comme suit.

Notez que le préfixe, marqueur, MaxResults, et délimiteur éléments sont présents uniquement s'ils ont été spécifiés dans l'URI de requête. Le NextMarker élément a une valeur uniquement si les résultats de liste ne sont pas terminées.

Captures instantanées, les métadonnées d'objets blob et les objets BLOB non validés est inclus dans la réponse uniquement si elles sont spécifiées avec la include paramètre sur l'URI de requête.

Dans la version 2009-09-19 et versions ultérieures, les propriétés de l'objet blob sont encapsulées dans un propriétés élément.

Dans la version 2013-08-15 et versions ultérieures, le EnumerationResults élément contient un ServiceEndpoint attribut spécifiant le point de terminaison d'objets blob et un ContainerName champ spécifiant le nom du conteneur. Dans les versions précédentes ces deux attributs étaient combinés dans le ContainerName champ. Également dans la version 2013-08-15 et versions ultérieures, le Url élément sous Blob a été supprimé.

Pour la version 2015-02-21 et version ultérieure, liste d'objets BLOB retourne des objets BLOB de tous les types (bloquer, page et ajoutez les objets BLOB).

Pour les versions 2009-09-19 et mais plus récente avant la version 2015-02-21, appelant liste d'objets BLOB sur un conteneur qui inclut append BLOB échouera avec le code d'état 409 (FeatureVersionMismatch) si le résultat de la liste contient un objet BLOB d'ajout.

<?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>
      <Properties>
        <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>
        <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>
      </Properties>
      <Metadata>   
        <Name>value</Name>
      </Metadata>
    </Blob>
    <BlobPrefix>
      <Name>blob-prefix</Name>
    </BlobPrefix>
  </Blobs>
  <NextMarker />
</EnumerationResults>

LeaseState et LeaseDuration apparaissent uniquement dans la version 2012-02-12 et versions ultérieures.

CopyId, CopyStatus, copydir, CopyProgress, CopyCompletionTime, et CopyStatusDescription apparaissent uniquement dans la version 2012-02-12 et versions ultérieures, lorsque cette opération inclut le include={copy} paramètre. Ces éléments n'apparaissent pas si cet objet blob n'a jamais été la destination dans un Copy Blob opération, ou si cet objet blob a été modifié après une conclu Copy Blob à l'aide de l'opération Set Blob Properties, Put Blob, ou Put Block List. Ces éléments n'apparaissent pas avec un objet blob créé par Copy Blob avant la version 2012-02-12.

System_CAPS_noteRemarque

Depuis la version 2009-09-19, List Blobs renvoie ce qui suit renommé des éléments dans le corps de réponse :

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

  • Content-Length (précédemment taille)

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

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

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

Le Content-MD5 élément s'affiche pour les objets BLOB créées avec la version 2009-09-19 et ultérieures. Dans la version 2012-02-12 et les versions ultérieures, le service Blob calcule le Content-MD5 lorsque vous téléchargez un objet blob à l'aide de la valeur Put Blob, mais ne le calcule ne pas lorsque vous créez un objet blob à l'aide de Placez la liste de blocage. Vous pouvez définir explicitement le Content-MD5 valeur lorsque vous créez l'objet blob, ou en appelant Placez la liste de blocage ou Set Blob Properties operations.

Si la liste de contrôle d'accès (ACL) du conteneur est définie sur Autoriser l'accès anonyme au conteneur, n'importe quel client peut appeler cette opération. Dans le cas contraire, cette opération peut être appelée par le propriétaire du compte et par toute personne ayant une Signature d'accès partagé qui a l'autorisation de liste d'objets BLOB dans un conteneur.

Propriétés des objets BLOB dans la réponse

Si vous avez demandé que les objets BLOB non validés être inclus dans l'énumération, notez que certaines propriétés ne sont pas définies tant que l'objet blob est validé, certaines propriétés ne peuvent pas être retournées dans la réponse.

Le x-ms-blob-numéro de séquence élément est renvoyé uniquement pour les objets BLOB de page.

Pour les objets BLOB de page, la valeur retournée dans le Content-Length élément correspond à la valeur de l'objet blob x-ms-blob-content-length en-tête.

Le Content-MD5 élément apparaît dans le corps de la réponse uniquement s'il a été défini sur l'objet blob à l'aide de la version 2009-09-19 ou version ultérieure. Vous pouvez définir le Content-MD5 propriété lorsque l'objet blob est créé ou en appelant Set Blob Properties. Dans la version 2012-02-12 et les versions ultérieures, Put Blob jeux valeur MD5 de bloc d'un objet blob même lorsque les Put Blob demande n'inclut pas d'en-tête MD5.

Métadonnées dans la réponse

Le métadonnées élément est présent uniquement si le include=metadata paramètre a été spécifié dans l'URI. Dans le métadonnées élément, la valeur de chaque paire nom-valeur est indiquée dans un élément correspondant au nom de la paire.

Notez que les métadonnées demandées avec ce paramètre doivent être stockées conformément aux restrictions d'affectation de noms imposées par la version 2009-09-19 du service Blob. À partir de cette version, tous les noms de métadonnées doivent respecter les conventions d'affectation de noms de identificateurs c#.

Si une paire nom-valeur de métadonnées viole les restrictions d'affectation de noms appliquées par la version 2009-09-19, le corps de réponse indique le nom problématique dans une x-ms-non valide-name élément, comme indiqué dans le fragment XML suivant :


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

Instantanés dans la réponse

Les instantanés sont répertoriés dans la réponse uniquement si la include=snapshots paramètre a été spécifié dans l'URI. Les instantanés répertoriés dans la réponse n'incluent pas les LeaseStatus élément, sous forme d'instantanés ne peuvent pas avoir de baux actifs.

Si vous appelez List Blobs avec un délimiteur, vous ne pouvez également inclure des instantanés dans l'énumération. Une requête qui inclut à la fois renvoie une erreur InvalidQueryParameter (code d'état HTTP 400 – demande incorrecte).

Objets BLOB non validés dans la réponse

Objets BLOB non validés est répertoriés dans la réponse uniquement si la include=uncommittedblobs paramètre a été spécifié dans l'URI. Objets BLOB non validés répertoriés dans la réponse ne comprennent aucun des éléments suivants :

  • Dernière modification

  • ETag

  • Type de contenu

  • Encodage de contenu

  • Content-Language

  • Content-MD5

  • Contrôle du cache

  • Métadonnées

Retourner des jeux de résultats à l'aide d'une valeur de marqueur

Si vous spécifiez une valeur pour le maxresults paramètre et le nombre d'objets BLOB à renvoyer dépasse cette valeur, ou dépasse la valeur par défaut maxresults, le corps de la réponse contient un NextMarker élément qui indique l'objet blob suivant à retourner dans une demande suivante. Pour renvoyer l'ensemble suivant d'éléments, spécifiez la valeur de NextMarker comme paramètre de marqueur sur l'URI de la demande suivante.

Notez que la valeur de NextMarker doit être traité comme opaque.

À l'aide d'un délimiteur pour parcourir l'espace de noms d'objets Blob

Le delimiter paramètre permet à l'appelant de parcourir l'espace de noms d'objets blob à l'aide d'un délimiteur configuré par l'utilisateur. 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. Le délimiteur peut être un caractère unique ou une chaîne. Lorsque la demande inclut ce paramètre, l'opération retourne un BlobPrefix élément. Le BlobPrefix élément est renvoyé à la place de tous les objets BLOB dont les noms commencent par la même sous-chaîne jusqu'au caractère du délimiteur. La valeur de la BlobPrefix élément est substring + delimiter, où sous-chaîne est la sous-chaîne commune qui débute un ou plusieurs noms d'objets blob, et délimiteur est la valeur de la délimiteur paramètre.

Vous pouvez utiliser la valeur de BlobPrefix pour effectuer un appel ultérieur à la liste d'objets BLOB qui commencent par ce préfixe, en spécifiant la valeur BlobPrefix pour la prefix paramètre sur l'URI de requête.

Notez que chaque BlobPrefix élément renvoyé est comptabilisé dans le nombre maximal de résultats, tout comme chaque Blob élément.

Objets BLOB est répertoriés par ordre alphabétique dans le corps de réponse avec majuscules répertoriées en premier.

Erreurs de copie dans CopyStatusDescription

CopyStatusDescription contient plus d'informations sur la Copy Blob Échec.

  • Lorsqu'une tentative de copie échoue et que le service Blob réessaie l'opération, CopyStatus a en attente, et CopyStatusDescription texte décrit l'échec qui se sont produites lors de la dernière tentative de copie.

  • Lors de la CopyStatus est défini sur n'a pas pu, le CopyStatusDescription texte décrit l'erreur qui a provoqué l'opération de copie échoue.

Le tableau suivant décrit les trois champs de chaque CopyStatusDescription valeur.

Composant

Description

Code d'état HTTP

Entier de 3chiffres standard indiquant la défaillance.

Code d'erreur

Mot clé décrivant l'erreur qui est fourni par Azure dans l'élément < ErrorCode >. Si aucun élément < ErrorCode > s'affiche, un mot clé contenant le texte d'erreur standard associé au code d'état HTTP à 3 chiffres dans la spécification HTTP est utilisé. Consultez Codes d'erreur d'API REST courants.

Informations

Description détaillée de l'échec, de guillemets.

Le tableau suivant décrit les CopyStatus et CopyStatusDescription valeurs courantes des scénarios d'échec.

System_CAPS_importantImportant

Texte de description indiqué ici peuvent changer sans avertissement, même sans un changement de version, par conséquent, ne comptez pas sur ce texte exact correspondant.

Scénario

Valeur CopyStatus

Valeur CopyStatusDescription

Copie terminée avec succès.

opération réussie

empty

Utilisateur a abandonné l'opération de copie avant d'être terminée.

abandonnée

empty

Une erreur s'est produite lors de la lecture à partir de l'objet blob source pendant une opération de copie, mais l'opération va être retentée.

en attente

502 BadGateway « a rencontré une erreur récupérable lors de la lecture de la source. Va réessayer. Heure de la défaillance : < heure > »

Une erreur s'est produite lors de l'écriture de l'objet blob de destination d'une opération de copie, mais l'opération va être retentée.

en attente

Type 500 InternalServerError » a rencontré une erreur renouvelable. Va réessayer. Heure de la défaillance : < heure > »

Une erreur irrécupérable s'est produite lors de la lecture à partir de l'objet blob source d'une opération de copie.

Échec de la

404 ResourceNotFound « Échec de la copie lors de la lecture de la source. »

System_CAPS_noteRemarque

Lorsque vous signalez ce sous-jacent erreur, Azure retourne ResourceNotFound dans l'élément < ErrorCode >. Si aucun élément < ErrorCode > n'apparaît dans la réponse, une norme de représentation de chaîne de l'état HTTP tel que introuvable s'affiche.

Le délai d'expiration limitant copie toutes les opérations s'est écoulé. (Le délai d'expiration est actuellement 2 semaines.)

Échec de la

500 OperationCancelled « la copie a dépassé le délai maximal autorisé. »

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. (Ce délai d'attente empêche une nouvelle tentative d'une source de mauvaise pendant 2 semaines avant l'échec).

Échec de la

500 OperationCancelled « La copie a échoué lors de la lecture de la source ».

Cela vous a-t-il été utile ?
(1500 caractères restants)
Merci pour vos suggestions.
Afficher:
© 2016 Microsoft