List BlobsList Blobs

La List Blobs operación devuelve una lista de los blobs en el contenedor especificado.The List Blobs operation returns a list of the blobs under the specified container.

SolicitudRequest

La solicitud List Blobs se puede construir como sigue.The List Blobs request may be constructed as follows. Se recomienda HTTPS.HTTPS is recommended. Reemplace mi cuenta por el nombre de la cuenta de almacenamiento:Replace myaccount with the name of your storage account:

MétodoMethod URI de la solicitudRequest URI Versión HTTPHTTP Version
GET https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=list HTTP/1.1HTTP/1.1

URI del servicio de almacenamiento emuladoEmulated storage service URI

Al realizar una solicitud en el servicio de almacenamiento emulado, especifique el nombre de host del emulador y el puerto del servicio Blob como 127.0.0.1:10000, seguido del nombre de la cuenta de almacenamiento emulado: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étodoMethod URI de la solicitudRequest URI Versión HTTPHTTP Version
GET http://127.0.0.1:10000/devstoreaccount1/mycontainer?restype=container&comp=list HTTP/1.1HTTP/1.1

Para obtener más información, vea uso del emulador de Azure Storage para desarrollo y pruebas.For more information, see Using the Azure Storage Emulator for Development and Testing.

Parámetros de identificador URIURI Parameters

Se pueden especificar los parámetros adicionales siguientes en el URI.The following additional parameters may be specified on the URI.

ParámetroParameter DescripciónDescription
prefix Opcional.Optional. Filtra los resultados para devolver solo los blobs cuyos nombres empiezan por el prefijo especificado.Filters the results to return only blobs whose names begin with the specified prefix.
delimiter Opcional.Optional. Si la solicitud incluye este parámetro, la operación devuelve un elemento BlobPrefix en el cuerpo de respuesta que actúa como un marcador de posición para todos los blobs cuyos nombres comienzan por la misma subcadena hasta que aparece el carácter delimitador.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. El delimitador puede ser un carácter o una cadena.The delimiter may be a single character or a string.
marker Opcional.Optional. Valor de cadena que identifica la parte de la lista que se va a devolver con la siguiente operación de lista.A string value that identifies the portion of the list to be returned with the next list operation. La operación devuelve un valor de marcador en el cuerpo de respuesta si la lista devuelta no estaba completa.The operation returns a marker value within the response body if the list returned was not complete. Este valor de marcador se puede utilizar en una llamada subsiguiente para solicitar el siguiente conjunto de elementos de lista.The marker value may then be used in a subsequent call to request the next set of list items.

El valor de marcador es opaco para el cliente.The marker value is opaque to the client.
maxresults Opcional.Optional. Especifica el número máximo de blobs que se van a devolver, incluidos todos los elementos BlobPrefix.Specifies the maximum number of blobs to return, including all BlobPrefix elements. Si la solicitud no especifica maxresults, o especifica un valor superior a 5.000, el servidor devolverá un máximo de 5.000 elementos.If the request does not specify maxresults or specifies a value greater than 5,000, the server will return up to 5,000 items.

Si se establece maxresults en un valor menor o igual que cero, se devolverá el código de respuesta de error 400 (Solicitud incorrecta).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} Opcional.Optional. Especifica uno o más conjuntos de datos que se deben incluir en la respuesta:Specifies one or more datasets to include in the response:

- snapshots: Especifica que las instantáneas deben incluirse en la enumeración.- snapshots: Specifies that snapshots should be included in the enumeration. Las instantáneas aparecen ordenadas de más antigua a más reciente en la respuesta.Snapshots are listed from oldest to newest in the response.
- metadata: Especifica que los metadatos de BLOB se devuelvan en la respuesta.- metadata: Specifies that blob metadata be returned in the response.
- uncommittedblobs: Especifica que los blobs para los que se han cargado los bloques, pero que no se han confirmado mediante Put Block List, se incluyen en la respuesta.- 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: Versión 2012-02-12 y versiones más recientes.- copy: Version 2012-02-12 and newer. Especifica que se deben incluir en la respuesta los metadatos relacionados con cualquier operación Copy Blob actual o previa.Specifies that metadata related to any current or previous Copy Blob operation should be included in the response.
-deleted: Versión 2017-07-29 y versiones más recientes.-deleted: Version 2017-07-29 and newer. Especifica que los blobs eliminados temporalmente deben incluirse en la respuesta.Specifies that soft deleted blobs should be included in the response.
-tags: Versión 2019-12-12 y versiones más recientes.-tags: Version 2019-12-12 and newer. Especifica que las etiquetas de índice de BLOB definidas por el usuario deben incluirse en la respuesta.Specifies that user-defined Blob Index tags should be included in the response.
-versions: Versión 2019-12-12 y versiones más recientes.-versions: Version 2019-12-12 and newer. Especifica que las versiones de los blobs se deben incluir en la enumeración.Specifies that Versions of blobs should be included in the enumeration.

Si desea especificar varias de estas opciones en el URI, debe separarlas mediante una coma codificada para 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 Opcional.Optional. El parámetro timeout se expresa en segundos.The timeout parameter is expressed in seconds. Para obtener más información, consulte configuración de tiempos de espera para las operaciones de BLOB Service.For more information, see Setting Timeouts for Blob Service Operations.

Encabezados de solicitudRequest Headers

En la tabla siguiente se describen los encabezados de solicitud requeridos y opcionales.The following table describes required and optional request headers.

Encabezado de solicitudRequest Header DescripciónDescription
Authorization Obligatorio.Required. Especifica el esquema de autorización, el nombre de cuenta y la firma.Specifies the authorization scheme, account name, and signature. Para obtener más información, consulte autorización de solicitudes para Azure Storage.For more information, see Authorize requests to Azure Storage.
Date o x-ms-dateDate or x-ms-date Obligatorio.Required. Especifica la hora universal coordinada (UTC) de la solicitud.Specifies the Coordinated Universal Time (UTC) for the request. Para obtener más información, consulte autorización de solicitudes para Azure Storage.For more information, see Authorize requests to Azure Storage.
x-ms-version Obligatorio para todas las solicitudes autorizadas, es opcional para las solicitudes anónimas.Required for all authorized requests, optional for anonymous requests. Especifica la versión de la operación que se utiliza para esta solicitud.Specifies the version of the operation to use for this request. Para obtener más información, vea control de versiones de los servicios de Azure Storage.For more information, see Versioning for the Azure Storage Services.
x-ms-client-request-id Opcional.Optional. Proporciona un valor opaco generado por el cliente con un límite de 1 KiB de caracteres que se registra en los registros de análisis cuando el registro de análisis de almacenamiento está habilitado.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. Se recomienda encarecidamente usar este encabezado para correlacionar las actividades del lado cliente con las solicitudes recibidas por el servidor.Using this header is highly recommended for correlating client-side activities with requests received by the server. Para obtener más información, consulte acerca del registro de Storage Analytics y el registro de Azure: uso de registros para realizar un seguimiento de las solicitudes de almacenamiento.For more information, see About Storage Analytics Logging and Azure Logging: Using Logs to Track Storage Requests.

Cuerpo de la solicitudRequest Body

Ninguno.None.

Solicitud de ejemploSample Request

Consulte enumeración de recursos de BLOB para una solicitud de ejemplo.See Enumerating Blob Resources for a sample request.

AnteResponse

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta en formato XML.The response includes an HTTP status code, a set of response headers, and a response body in XML format.

Código de estadoStatus Code

Una operación correcta devuelve el código de estado 200 Correcto.A successful operation returns status code 200 (OK).

Para obtener información sobre los códigos de estado, vea códigos de estado y de error.For information about status codes, see Status and Error Codes.

Encabezados de respuestaResponse Headers

La respuesta para esta operación incluye los encabezados siguientes.The response for this operation includes the following headers. La respuesta también puede incluir otros encabezados HTTP estándar.The response may also include additional standard HTTP headers. Todos los encabezados estándar cumplen la especificación del protocolo HTTP/1.1.All standard headers conform to the HTTP/1.1 protocol specification.

Encabezado de respuestaResponse header DescripciónDescription
Content-Type Especifica el formato en el que se devuelven los resultados.Specifies the format in which the results are returned. Actualmente, este valor es application/xml.Currently this value is application/xml.
x-ms-request-id Este encabezado identifica de forma única la solicitud que se realizó y se puede utilizar para solucionar problemas relacionados con esta.This header uniquely identifies the request that was made and can be used for troubleshooting the request. Para obtener más información, consulte solución de problemas de las operaciones de API.For more information, see Troubleshooting API Operations.
x-ms-version Indica la versión del servicio Blob utilizado para ejecutar la solicitud.Indicates the version of the Blob service used to execute the request. Este encabezado se devuelve para las solicitudes realizadas con la versión 2009-09-19 y versiones más recientes.This header is returned for requests made using version 2009-09-19 and newer.

Este encabezado también se devuelve para las solicitudes anónimas sin una versión especificada si el contenedor se marcó para acceso público utilizando la versión 2009-09-19 del servicio 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 Valor de fecha y hora UTC generado por el servicio que indica la hora a la que se inició la respuesta.A UTC date/time value generated by the service that indicates the time at which the response was initiated.
x-ms-client-request-id Este encabezado se puede usar para solucionar problemas de las solicitudes y las respuestas correspondientes.This header can be used to troubleshoot requests and corresponding responses. El valor de este encabezado es igual al valor del x-ms-client-request-id encabezado si está presente en la solicitud y el valor tiene como máximo 1024 caracteres 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 el x-ms-client-request-id encabezado no está presente en la solicitud, este encabezado no estará presente en la respuesta.If the x-ms-client-request-id header is not present in the request, this header will not be present in the response.

Cuerpo de la respuestaResponse Body

El formato de la respuesta XML es el siguiente.The format of the XML response is as follows.

Tenga en cuenta que los elementos Prefix, Marker, MaxResults y Delimiter solo están presentes si se especificaron en el URI de solicitud.Note that the Prefix, Marker, MaxResults, and Delimiter elements are present only if they were specified on the request URI. El elemento NextMarker tiene un valor solo si los resultados de la lista no están completos.The NextMarker element has a value only if the list results are not complete.

Las instantáneas, los metadatos del blob y los blobs sin confirmar se incluyen en la respuesta solo si se especifican mediante el parámetro include en el URI de solicitud.Snapshots, blob metadata, and uncommitted blobs are included in the response only if they are specified with the include parameter on the request URI.

En la versión 2009-09-19 y versiones más recientes, las propiedades del blob se encapsulan en un elemento Properties.In version 2009-09-19 and newer, the blob's properties are encapsulated within a Properties element.

A partir de la versión 2009-09-19, List Blobs devuelve en el cuerpo de respuesta los elementos siguientes cuyo nombre ha cambiado:Beginning with version 2009-09-19, List Blobs returns the following renamed elements in the response body:

  • Last-Modified (anteriormente LastModified)Last-Modified (previously LastModified)

  • Content-Length (anteriormente Size)Content-Length (previously Size)

  • Content-Type (anteriormente ContentType)Content-Type (previously ContentType)

  • Content-Encoding (anteriormente ContentEncoding)Content-Encoding (previously ContentEncoding)

  • Content-Language (anteriormente ContentLanguage)Content-Language (previously ContentLanguage)

El elemento Content-MD5 aparece para los blobs creados con la versión 2009-09-19 y versiones más recientes.The Content-MD5 element appears for blobs created with version 2009-09-19 and newer. En la versión 2012-02-12 y versiones más recientes, el Blob service calcula el Content-MD5 valor al cargar un BLOB mediante Put BLOB, pero no lo calcula cuando se crea un BLOB mediante Put Block List.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. Puede establecer explícitamente el Content-MD5 valor al crear el BLOB o al llamar a las operaciones Put Block List o 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.

En el caso de las versiones de 2009-09-19 y más recientes, pero antes de la versión 2015-02-21, la llamada a List Blobs en un contenedor que incluye blobs en anexos producirá un error con el código de estado 409 (FeatureVersionMismatch) si el resultado de la lista contiene un BLOB en anexos.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 y LeaseDuration solo aparecen en la versión 2012-02-12 y posteriores.LeaseState and LeaseDuration appear only in version 2012-02-12 and later.

CopyId, CopyStatus, CopySource, CopyProgress, CopyCompletionTime y CopyStatusDescription solo aparecen en la versión 2012-02-12 y versiones posteriores, cuando esta operación incluye el parámetro include={copy}.CopyId, CopyStatus, CopySource, CopyProgress, CopyCompletionTime, and CopyStatusDescription only appear in version 2012-02-12 and later, when this operation includes the include={copy} parameter. Estos elementos no aparecen si el blob no ha sido nunca el destino de una operación Copy Blob, o si el blob se ha modificado después de una operación Copy Blob finalizada, mediante Set Blob Properties, Put Blob o 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. Estos elementos tampoco aparecen con un BLOB creado por copiar BLOB antes de la versión 2012-02-12.These elements also do not appear with a blob created by Copy Blob before version 2012-02-12.

En la versión 2013-08-15 y posteriores, el elemento EnumerationResults contiene un atributo ServiceEndpoint que especifica el extremo del blob y un campo ContainerName que especifica el nombre del contenedor.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. En las versiones anteriores, estos dos atributos estaban combinados en el campo ContainerName.In previous versions these two attributes were combined together in the ContainerName field. Además, en la versión 2013-08-15 y posteriores, se ha quitado el elemento Url de Blob.Also in version 2013-08-15 and newer, the Url element under Blob has been removed.

Para la versión 2015-02-21 y posteriores, List Blobs devuelve los blobs de todos los tipos (blobs en bloques, páginas y anexos).For version 2015-02-21 and above, List Blobs returns blobs of all types (block, page, and append blobs).

Para la versión 2015-12-11 y versiones posteriores, List Blobs devuelve el ServerEncrypted elemento.For version 2015-12-11 and above, List Blobs returns the ServerEncrypted element. Este elemento se establece en true si el BLOB y los metadatos de la aplicación están totalmente cifrados, y de false lo contrario.This element is set to true if the blob and application metadata are completely encrypted, and false otherwise.

En la versión 2016-05-31 y versiones posteriores, List Blobs devuelve el IncrementalCopy elemento para los blobs de copia incremental e instantáneas con el valor establecido en 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.

En la versión 2017-04-17 y versiones posteriores, List Blobs devuelve el AccessTier elemento si se ha establecido explícitamente un nivel de acceso.For version 2017-04-17 and above, List Blobs returns the AccessTier element if an access tier has been explicitly set. Para obtener una lista de los niveles de BLOB en páginas Premium permitidos, consulte Premium Storage de alto rendimiento y discos administrados para máquinas virtuales.For a list of allowed premium page blob tiers, see High-performance Premium Storage and managed disks for VMs. En el caso de las cuentas Blob Storage o De uso general V2, los valores válidos son Hot / Cool / Archive .For Blob Storage or General Purpose v2 accounts, valid values are Hot/Cool/Archive. Si el BLOB está en estado rehidratado pendiente, ArchiveStatus se devuelve el elemento con uno de los valores válidos 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. Para obtener información detallada sobre la organización en niveles de blobs en bloques , consulte niveles de almacenamiento de acceso frecuente, esporádico y de archivo.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

Para la versión 2017-04-17 y versiones posteriores, List Blobs devuelve el AccessTierInferred elemento en las cuentas Blob Storage o de uso general V2.For version 2017-04-17 and above, List Blobs returns the AccessTierInferred element on Blob Storage or General Purpose v2 accounts. Si el BLOB en bloques no tiene establecido el nivel de acceso, se infiere el nivel de las propiedades de la cuenta de almacenamiento y este valor se establece en 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. Este encabezado solo está presente si el nivel se deduce de la propiedad de cuenta.This header is present only if the tier is inferred from the account property. Para obtener información detallada sobre la organización en niveles de blobs en bloques , consulte niveles de almacenamiento de acceso frecuente, esporádico y de archivo.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

Para la versión 2017-04-17 y versiones posteriores, List Blobs devuelve el AccessTierChangeTime elemento en las cuentas Blob Storage o de uso general V2.For version 2017-04-17 and above, List Blobs returns the AccessTierChangeTime element on Blob Storage or General Purpose v2 accounts. Solo se devuelve si se ha establecido el nivel en el BLOB en bloques.This is returned only if tier on block blob was ever set. El formato de la fecha sigue las convenciones de RFC 1123.The date format follows RFC 1123. Para obtener más información, vea representación de valores de Date-Time en encabezados.For more information, see Representation of Date-Time Values in Headers. Para obtener información detallada sobre la organización en niveles de blobs en bloques , consulte niveles de almacenamiento de acceso frecuente, esporádico y de archivo.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

Para la versión 2017-07-29 y posteriores Deleted , DeletedTime y RemainingRetentionDays aparecen cuando esta operación incluye el include={deleted} parámetro.For version 2017-07-29 and above, Deleted, DeletedTime and RemainingRetentionDays appear when this operation includes the include={deleted} parameter. Estos elementos no aparecen si no se eliminó el BLOB.These elements do not appear if this blob was not deleted. Estos elementos aparecen para el BLOB o la instantánea que se eliminan con la DELETE operación cuando se habilitó la característica de eliminación temporal.These elements appear for blob or snapshot that are deleted with DELETE operation when soft delete feature was enabled. Deleted el elemento se establece en true para los blobs e instantáneas que se eliminan temporalmente.Deleted element is set to true for blobs and snapshots that are soft deleted. Deleted-Time corresponde a la hora a la que se eliminó el BLOB.Deleted-Time corresponds to time when the blob was deleted. RemainingRetentionDays indica el número de días después del cual BLOB Service eliminará permanentemente el BLOB eliminado temporalmente.RemainingRetentionDays indicates number of days after which soft deleted blob will be permanently deleted by blob service.

Para la versión 2017-11-09 y posteriores, Creation-Time devuelve la hora a la que se creó este BLOB.For version 2017-11-09 and above, Creation-Time returns the time at which this blob was created.

En la versión 2019-02-02 y versiones posteriores, List Blobs devuelve el CustomerProvidedKeySha256 elemento si el BLOB se cifra con una clave proporcionada por el cliente.For version 2019-02-02 and above, List Blobs returns the CustomerProvidedKeySha256 element if the blob is encrypted with a customer-provided key. El valor se establecerá en el hash SHA-256 de la clave utilizada para cifrar el BLOB.The value will be set to the SHA-256 hash of the key used to encrypt the blob. Además, si la operación incluye el include={metadata} parámetro y hay metadatos de aplicación presentes en un BLOB cifrado con una clave proporcionada por el cliente, el Metadata elemento tendrá un Encrypted="true" atributo para indicar que el BLOB tiene metadatos que no se pueden descifrar como parte de la List Blobs operación.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. Llame a Get BLOB Properties u obtenga metadatos de BLOB con la clave proporcionada por el cliente para acceder a los metadatos de estos BLOBs.Call Get Blob Properties or Get Blob Metadata with the customer-provided key to access the metadata for these blobs.

En la versión 2019-02-02 y versiones posteriores, List Blobs devuelve el EncryptionScope elemento si el BLOB está cifrado con un ámbito de cifrado.For version 2019-02-02 and above, List Blobs returns the EncryptionScope element if the blob is encrypted with an encryption scope. El valor se establecerá en el nombre del ámbito de cifrado usado para cifrar el BLOB.The value will be set to the name of the encryption scope used to encrypt the blob. Si la operación incluye el include={metadata} parámetro, los metadatos de la aplicación en el BLOB se descifrarán de forma transparente y estarán disponibles en el Metadata elemento.If the operation includes the include={metadata} parameter, application metadata on the blob will be transparently decrypted and available in the Metadata element.

En la versión 2019-12-12 y versiones posteriores, List Blobs devuelve el RehydratePriority elemento de Blob Storage o de uso general V2 si el objeto está en estado rehidratado pendiente.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. Los valores válidos son High / Standard .Valid values are High/Standard. Para obtener información detallada sobre la organización en niveles de blobs en bloques , consulte niveles de almacenamiento de acceso frecuente, esporádico y de archivo.For detailed information about block blob tiering see Hot, cool and archive storage tiers.

Para la versión 2019-12-12 y posteriores, List Blobs devuelve el VersionId elemento para los blobs y las versiones de BLOB generadas cuando el control de versiones está habilitado en la cuenta.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.

En la versión 2019-12-12 y versiones posteriores, List Blobs devuelve el IsCurrentVersion elemento para la versión actual del BLOB con el valor establecido en true , para diferenciarlo de las versiones generadas automáticamente de solo lectura.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.

En la versión 2019-12-12 y versiones posteriores, List Blobs devuelve el TagCount elemento para los blobs con cualquier etiqueta.For version 2019-12-12 and above, List Blobs returns the TagCount element for blobs with any tags. El Tags elemento solo aparece cuando esta operación incluye el include={tags} parámetro.The Tags element appears only when this operation includes the include={tags} parameter. Estos elementos no aparecen si no hay ninguna etiqueta en el BLOB.These elements do not appear if there are no tags on the blob.

Para la versión 2020-02-10 y versiones posteriores, List Blobs devuelve el LastAccessTime elemento.For version 2020-02-10 and above, List Blobs returns the LastAccessTime element. Los elementos muestran Cuándo se obtuvo acceso por última vez a los datos del BLOB según la Directiva de seguimiento de hora del último acceso de la cuenta de almacenamiento.The elements shows when the blob's data was last accessed according to the storage account's last access time tracking policy. El elemento no se devolverá si la cuenta de almacenamiento no tiene una directiva de seguimiento de tiempo de acceso más reciente o la Directiva está deshabilitada.The element will not be returned if the storage account does not have a last access time tracking policy, or the policy is disabled. Para obtener más información sobre cómo establecer la Directiva de seguimiento de hora del último acceso de la cuenta, consulte API de BLOB Service.For information about setting account's last access time tracking policy, see Blob Service API. El LastAccessTime elemento no realiza un seguimiento de la última vez que se tiene acceso a los metadatos del 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>  

Respuesta de ejemploSample Response

Consulte enumeración de recursos de BLOB para obtener una respuesta de ejemplo.See Enumerating Blob Resources for a sample response.

OnAuthorization

Si se establece la lista de control de acceso (ACL) del contenedor para permitir el acceso anónimo al contenedor, cualquier cliente puede llamar a esta operación.If the container's access control list (ACL) is set to allow anonymous access to the container, any client may call this operation. En caso contrario, esta operación la puede realizar el propietario de la cuenta y cualquiera que disponga de una firma de acceso compartido con permiso para enumerar blobs en un contenedor.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.

ObservacionesRemarks

Propiedades del blob en la respuestaBlob Properties in the Response

Si ha solicitado la inclusión de blobs sin confirmar en la enumeración, tenga en cuenta que algunas propiedades no se establecen hasta que se confirma el blob, de modo que es posible que no se devuelvan en la respuesta.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.

El elemento x-ms-blob-sequence-number solo se devuelve para los blobs en páginas.The x-ms-blob-sequence-number element is only returned for page blobs.

El OrMetadata elemento solo se devuelve para los blobs en bloques.The OrMetadata element is only returned for block blobs.

En los blobs en páginas, el valor devuelto en el elemento Content-Length corresponde al valor del encabezado x-ms-blob-content-length del 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.

El elemento Content-MD5 solo aparece en el cuerpo de respuesta si se ha establecido en el blob con la versión 2009-09-19 o versiones posteriores.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. Puede establecer la Content-MD5 propiedad cuando se crea el BLOB o llamando a SET BLOB Properties.You can set the Content-MD5 property when the blob is created or by calling Set Blob Properties. En la versión 2012-02-12 y en las versiones más recientes, Put Blob establece el valor MD5 de un blob en bloques incluso si la solicitud Put Blob no incluye un encabezado 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.

Metadatos en la respuestaMetadata in the Response

El elemento Metadata está presente solo si se especificó el parámetro include=metadata en el URI.The Metadata element is present only if the include=metadata parameter was specified on the URI. Dentro del elemento Metadata, el valor de cada par nombre-valor aparece en un elemento que corresponde al nombre del par.Within the Metadata element, the value of each name-value pair is listed within an element corresponding to the pair's name.

Tenga en cuenta que los metadatos solicitados con este parámetro deben almacenarse de acuerdo con las restricciones de nomenclatura impuestas por la versión 2009-09-19 del servicio 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. A partir de esta versión, todos los nombres de metadatos deben cumplir las convenciones de nomenclatura para los identificadores de C#.Beginning with this version, all metadata names must adhere to the naming conventions for C# identifiers.

Si un par nombre-valor de metadatos infringe las restricciones de nomenclatura impuestas por la versión 2009-09-19, el cuerpo de respuesta indica el nombre problemático en un elemento x-ms-invalid-name, tal como se muestra en el fragmento XML siguiente: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>  
…  
  

Etiquetas en la respuestaTags in the Response

El Tags elemento solo está presente si se include=tags ha especificado el parámetro en el URI y si hay etiquetas en el 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. Dentro del TagSet elemento, Tag se devuelven hasta 10 elementos, cada uno de los cuales contiene key y value de las etiquetas de índice de BLOB definidas por el usuario.Within the TagSet element, up to 10 Tag elements are returned, each containing the key and value of the user-defined Blob Index tags. No se garantiza el orden de las etiquetas en la respuesta.The ordering of tags is not guaranteed in the response.

Los Tags TagCount elementos y no se devuelven si no hay ninguna etiqueta en el BLOB.The Tags and TagCount elements are not returned if there are no tags on the blob.

El servicio de almacenamiento mantiene una coherencia fuerte entre un BLOB y sus etiquetas, pero el índice secundario es coherente en última instancia.The storage service maintains strong consistency between a blob and its tags, but the secondary index is eventually consistent. Las etiquetas pueden estar visibles en una respuesta a los blobs de lista antes de que sean visibles para encontrar blobs mediante operaciones de etiquetas.Tags may be visible in a response to List Blobs before they are visible to Find Blobs by Tags operations.

Instantáneas en la respuestaSnapshots in the Response

Las instantáneas aparecen en la respuesta solo si se especificó el parámetro include=snapshots en el URI.Snapshots are listed in the response only if the include=snapshots parameter was specified on the URI. Las instantáneas que aparecen en la respuesta no incluyen el elemento LeaseStatus, ya que las instantáneas no pueden tener concesiones activas.Snapshots listed in the response do not include the LeaseStatus element, as snapshots cannot have active leases.

Si llama a List Blobs con un delimitador, no podrá incluir instantáneas en la enumeración.If you call List Blobs with a delimiter, you cannot also include snapshots in the enumeration. Las solicitudes que incluyan ambos devolverán un error InvalidQueryParameter (código de estado HTTP 400 – Solicitud incorrecta).A request that includes both returns an InvalidQueryParameter error (HTTP status code 400 – Bad Request).

Blobs sin confirmar en la respuestaUncommitted Blobs in the Response

Los blobs sin confirmar aparecen en la respuesta solo si se especificó el parámetro include=uncommittedblobs en el URI.Uncommitted blobs are listed in the response only if the include=uncommittedblobs parameter was specified on the URI. Los blobs sin confirmar que aparecen en la respuesta no incluyen ninguno de los elementos siguientes: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

Blobs eliminados en la respuestaDeleted Blobs in the Response

Los blobs eliminados se muestran en la respuesta solo si include=deleted se especificó el parámetro en el URI.Deleted blobs are listed in the response only if the include=deleted parameter was specified on the URI. Los blobs eliminados que aparecen en la respuesta no incluyen los elementos de concesión , ya que los blobs eliminados no pueden tener concesiones activas.Deleted blobs listed in the response do not include the Lease elements as deleted blobs cannot have active leases.

Las instantáneas eliminadas se incluyen en la respuesta de la lista si include=deleted,snapshot se especificó en el URI.Deleted snapshots are included in list response if include=deleted,snapshot was specified on the URI.

Metadatos de replicación de objetos en la respuestaObject Replication Metadata in the Response

El OrMetadata elemento está presente cuando se ha evaluado una directiva de replicación de objetos en un BLOB y la llamada a la lista de blobs se realizó con la versión 2019-12-12 o posterior.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. Dentro del elemento OrMetadata, el valor de cada par nombre-valor aparece en un elemento que corresponde al nombre del par.Within the OrMetadata element, the value of each name-value pair is listed within an element corresponding to the pair's name. El formato del nombre es or-{policy-id}_{rule-id} , donde {policy-id} es un GUID que representa el identificador de la Directiva de replicación de objetos en la cuenta de almacenamiento y {rule-id} es un GUID que representa el identificador de la regla en el contenedor de almacenamiento.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. Los valores válidos son 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>  
…  
  

Devolver conjuntos de resultados mediante un valor de marcadorReturning Result Sets Using a Marker Value

Si especifica un valor para el parámetro maxresults y el número de blobs que se van a devolver supera este valor, o supera el valor predeterminado de maxresults, el cuerpo de respuesta contendrá un elemento NextMarker que indica el siguiente blob que se debe devolver en una solicitud subsiguiente.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. Para devolver el siguiente conjunto de elementos, especifique el valor de NextMarker como el parámetro de marcador en el URI para la solicitud siguiente.To return the next set of items, specify the value of NextMarker as the marker parameter on the URI for the subsequent request.

Tenga en cuenta que el valor de NextMarker se debe tratar como opaco.Note that the value of NextMarker should be treated as opaque.

Utilizar un delimitador para recorrer el espacio de nombres del blobUsing a Delimiter to Traverse the Blob Namespace

El parámetro delimiter permite al autor de la llamada recorrer el espacio de nombres del blob utilizando un delimitador configurado por el usuario.The delimiter parameter enables the caller to traverse the blob namespace by using a user-configured delimiter. De esta manera, puede recorrer una jerarquía virtual de blobs como si fuera un sistema de archivos.In this way, you can traverse a virtual hierarchy of blobs as though it were a file system. El delimitador puede ser un carácter o una cadena.The delimiter may be a single character or a string. Si la solicitud incluye este parámetro, la operación devuelve un elemento BlobPrefix.When the request includes this parameter, the operation returns a BlobPrefix element. El elemento BlobPrefix se devuelve en lugar de todos los blobs cuyos nombres comienzan por la misma subcadena hasta que aparece el carácter delimitador.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. El valor del BlobPrefix elemento es SUBSTRING + Delimiter, donde SUBSTRING es la subcadena común que comienza uno o más nombres de BLOB, y Delimiter es el valor del parámetro 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.

Puede utilizar el valor de BlobPrefix para hacer una llamada subsiguiente que permita enumerar los blobs que comienzan por este prefijo, especificando el valor de BlobPrefix para el parámetro prefix en el URI de solicitud.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.

Tenga en cuenta que cada elemento BlobPrefix devuelto se tiene en cuenta para calcular el número máximo de resultados, de la misma manera que los elementos Blob.Note that each BlobPrefix element returned counts toward the maximum result, just as each Blob element does.

Los blobs se muestran en el cuerpo de respuesta en orden alfabético, con las letras mayúsculas en primer lugar.Blobs are listed in alphabetical order in the response body, with upper-case letters listed first.

Errores de copia en CopyStatusDescriptionCopy errors in CopyStatusDescription

CopyStatusDescription contiene más información sobre el error de Copy Blob.CopyStatusDescription contains more information about the Copy Blob failure.

  • Cuando se produce un error en un intento de copia y Blob service sigue reintentando la operación, CopyStatus se establece en pending, y el texto de CopyStatusDescription describe el error que puede haber ocurrido durante el último intento de copia.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.

  • Si CopyStatus se establece en failed, el texto de CopyStatusDescription describe el error que provocó la operación de copia incorrecta.When CopyStatus is set to failed, the CopyStatusDescription text describes the error that caused the copy operation to fail.

En la tabla siguiente se describen los tres campos de cada valor de CopyStatusDescription.The following table describes the three fields of every CopyStatusDescription value.

ComponenteComponent DescripciónDescription
Código de estado HTTPHTTP status code Número entero de 3 dígitos estándar que especifica el error.Standard 3-digit integer specifying the failure.
Código de errorError code Palabra clave que describe el error que proporciona Azure en el elemento <ErrorCode > .Keyword describing error that is provided by Azure in the <ErrorCode> element. Si no aparece ningún > elemento ErrorCode <, se usa una palabra clave que contiene el texto de error estándar asociado al código de estado http de 3 dígitos en la especificación http.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. Consulte los códigos de error comunesde la API de REST.See Common REST API Error Codes.
InformaciónInformation Descripción detallada del error, entre comillas.Detailed description of failure, in quotes.

En la tabla siguiente se describen los valores de CopyStatus y CopyStatusDescription en escenarios de error comunes.The following table describes the CopyStatus and CopyStatusDescription values of common failure scenarios.

Importante

El texto de la descripción mostrado aquí puede cambiar sin previo aviso, incluso antes de un cambio de versión, por lo que no debe usarlo literalmente para detectar condiciones de error.Description text shown here can change without warning, even without a version change, so do not rely on matching this exact text.

EscenarioScenario Valor de CopyStatusCopyStatus value Valor de CopyStatusDescriptionCopyStatusDescription value
Operación de copia completada correctamente.Copy operation completed successfully. successsuccess emptyempty
El usuario ha anulado la operación de copia antes de que se haya completado.User aborted copy operation before it completed. abortedaborted emptyempty
Se produjo un error al leer el blob de origen durante una operación de copia, pero la operación se volverá a intentar.A failure occurred when reading from the source blob during a copy operation, but the operation will be retried. pendingpending 502 BadGateway "Al leer el origen se encontró un error que se puede reintentar.502 BadGateway "Encountered a retryable error when reading the source. Se volverá a intentar.Will retry. Hora del error: <hora > "Time of failure: <time>"
Se produjo un error al escribir en el blob de destino durante una operación de copia, pero la operación se volverá a intentar.A failure occurred when writing to the destination blob of a copy operation, but the operation will be retried. pendingpending 500 InternalServerError "Se encontró un error que se puede volver a intentar.500 InternalServerError "Encountered a retryable error. Se volverá a intentar.Will retry. Hora del error: <hora > "Time of failure: <time>"
Se produjo un error irrecuperable al leer el blob de origen durante una operación de copia.An unrecoverable failure occurred when reading from the source blob of a copy operation. con erroresfailed 404 ResourceNotFound "Error en la copia al leer el origen."404 ResourceNotFound "Copy failed when reading the source." Nota: Al notificar este error subyacente, Azure vuelve ResourceNotFound en el elemento <ErrorCode > .Note: When reporting this underlying error, Azure returns ResourceNotFound in the <ErrorCode> element. Si no aparecía ningún > elemento <ErrorCode en la respuesta, aparecerá una representación de cadena estándar del estado de http como NotFound .If no <ErrorCode> element appeared in the response, a standard string representation of the HTTP status such as NotFound would appear.
El tiempo de espera que limita todas las operaciones de copia realizadas.The timeout period limiting all copy operations elapsed. (En la actualidad, el tiempo de espera es de 2 semanas).(Currently the timeout period is 2 weeks.) con erroresfailed 500 OperationCancelled "La copia superó el tiempo máximo permitido."500 OperationCancelled "The copy exceeded the maximum allowed time."
La operación de copia produjo errores muy frecuentes al leer del origen y no alcanzó la relación mínima entre intentos y operaciones correctas.The copy operation failed too often when reading from the source, and didn’t meet a minimum ratio of attempts to successes. (Este tiempo de espera impide que se produzcan reintentos en un origen deficiente durante 2 semanas antes de que se produzca un error).(This timeout prevents retrying a very poor source over 2 weeks before failing). con erroresfailed 500 OperationCancelled "Error en la copia al leer el origen."500 OperationCancelled "The copy failed when reading the source."

Vea tambiénSee also

Códigos de estado y de error Status and Error Codes
Códigos de error del servicio BLOBBlob Service Error Codes