Compartir a través de


Azure Blob Storage REST API (API de REST de Almacenamiento de blobs de Azure)

Azure Blob Storage almacena datos binarios y de texto como objetos en la nube. Blob Storage ofrece los siguientes recursos: la cuenta de almacenamiento, los contenedores y los blobs. En la cuenta de almacenamiento, los contenedores proporcionan una manera de organizar conjuntos de blobs.

Puede almacenar datos binarios y de texto en cualquiera de los tipos siguientes de blobs:

  • Blobs en bloques, que están optimizados para la transmisión por secuencias.

  • Blobs en anexos, que están optimizados para las operaciones de anexión.

  • Blobs en páginas, que están optimizados para operaciones aleatorias de lectura y escritura, y que proporcionan la capacidad de escribir en un intervalo de bytes en un blob.

Para más información, consulte Uso de los blobs en bloques, los blobs en anexión y los blobs en páginas.

La API REST para Blob Storage define las operaciones HTTP en la cuenta de almacenamiento, los contenedores y los blobs. La API incluye las operaciones que se muestran en la tabla siguiente.

Operación Tipo de recurso Descripción
Enumerador de contenedores Cuenta Muestra todos los contenedores de una cuenta de almacenamiento.
Establecer propiedades de Blob Storage Cuenta Establece las propiedades de Blob Storage, incluida la configuración de registro y métricas, y la versión predeterminada del servicio.
Obtener propiedades de Blob Storage Cuenta Obtiene las propiedades de Blob Storage, incluida la configuración de registro y métricas, y la versión de servicio predeterminada.
Solicitud de blob preparatoria Cuenta Consulta las reglas de uso compartido de recursos entre orígenes (CORS) para Blob Storage, antes de enviar la solicitud real.
Obtención de estadísticas de Blob Storage Cuenta Recupera estadísticas relacionadas con la replicación de Blob Storage. Esta operación solo está disponible en el extremo de la ubicación secundaria cuando está habilitada la replicación con redundancia geográfica con acceso de lectura para la cuenta de almacenamiento.
Obtener información de la cuenta Cuenta Devuelve el nombre de la SKU y el tipo de cuenta de la cuenta especificada.
Obtención de la clave de delegación de usuarios Cuenta Obtiene una clave que se puede usar para firmar una firma de acceso compartido de delegación de usuarios. Esta firma concede acceso a los recursos de Blob Storage mediante credenciales de Microsoft Entra.
Creación de un contenedor Contenedor Crea un contenedor en una cuenta de almacenamiento.
Get Container Properties Contenedor Devuelve todos los metadatos definidos por el usuario y las propiedades del sistema de un contenedor.
Get Container Metadata Contenedor Solo devuelve los metadatos definidos por el usuario de un contenedor.
Establecimiento de metadatos de contenedor Contenedor Establece los metadatos definidos por el usuario de un contenedor.
Get Container ACL Contenedor Obtiene la directiva de acceso público y todas las directivas de acceso almacenadas del contenedor.
Establecer lista de control de acceso de contenedor Contenedor Establece la directiva de acceso público y todas las directivas de acceso almacenadas del contenedor.
Lease Container Contenedor Establece y administra un bloqueo en un contenedor para las operaciones de eliminación.
Delete Container Contenedor Elimina el contenedor y los blobs que contiene.
Enumeración de blobs Contenedor Muestra todos los blobs de un contenedor.
Put Blob Blobs en bloques, de anexión y en páginas Crea un nuevo blob o reemplaza un blob existente dentro de un contenedor.
Get Blob Blobs en bloques, de anexión y en páginas Lee o descarga un blob de Blob Storage, incluidos sus metadatos definidos por el usuario y las propiedades del sistema.
Get Blob Properties Blobs en bloques, de anexión y en páginas Devuelve todas las propiedades del sistema y los metadatos definidos por el usuario en el blob.
Set Blob Properties Blobs en bloques, de anexión y en páginas Establece las propiedades del sistema definidas para un blob existente.
Establecer expiración de blobs Blobs en bloques Establece la hora de expiración de un blob existente.
Get Blob Metadata Blobs en bloques, de anexión y en páginas Recupera todos los metadatos definidos por el usuario de un blob o una instantánea existentes.
Set Blob Metadata Blobs en bloques, de anexión y en páginas Establece los metadatos definidos por el usuario de un blob existente.
Obtener etiquetas de blobs Blobs en bloques, de anexión y en páginas Recupera etiquetas definidas por el usuario de un blob existente.
Establecer etiquetas de blobs Blobs en bloques, de anexión y en páginas Establece etiquetas definidas por el usuario de un blob existente que forman un índice secundario.
Búsqueda de blobs por etiquetas Blobs en bloques, de anexión y en páginas Listas blobs por sus etiquetas definidas por el usuario.
Delete Blob Blobs en bloques, de anexión y en páginas Marca un blob para su eliminación.
Undelete Blob Blobs en bloques, de anexión y en páginas Restaura el contenido y los metadatos de un blob eliminado temporalmente o todas las instantáneas eliminadas temporalmente asociadas.
Concesión de blobs Blobs en bloques, de anexión y en páginas Establece y administra un bloqueo en las operaciones de escritura y eliminación. Para eliminar un blob bloqueado o escribir en él, el cliente debe proporcionar el identificador de concesión.
Snapshot Blob Blobs en bloques, de anexión y en páginas Crea una instantánea de solo lectura de un blob.
Copy Blob Blobs en bloques, de anexión y en páginas Copia un blob de origen en un blob de destino en esta cuenta de almacenamiento o en otra cuenta de almacenamiento.
Abort Copy Blob Blobs en bloques, de anexión y en páginas Detiene una operación pendiente Copy Blob y deja un blob de destino con longitud cero y metadatos completos.
Put Block Solo blobs en bloques Crea un nuevo bloque que se confirmará como parte de un blob en bloques.
Put Block From URL Solo blobs en bloques Crea un nuevo bloque que se va a confirmar como parte de un blob en bloques donde el contenido se lee desde una dirección URL.
Put Block List Solo blobs en bloques Confirma un blob mediante la especificación del conjunto de identificadores de bloque que componen el blob en bloques.
Get Block List Solo blobs en bloques Recupera la lista de bloques que se han cargado como parte de un blob en bloques.
Consultar el contenido del blob Solo blobs en bloques Aplica una instrucción Lenguaje de consulta estructurado simple (SQL) en el contenido de un blob y devuelve solo el subconjunto consultado de los datos.
Set Blob Tier Blobs en bloques y blobs en páginas Establece el nivel de un blob.
Put Page Solo blobs en páginas Escribe un intervalo de páginas en un blob en páginas.
Get Page Ranges (Conseguir intervalos de páginas) Solo blobs en páginas Devuelve una lista de intervalos de páginas válidos para un blob en páginas o una instantánea de un blob en páginas.
Incremental Copy Blob (Copia incremental del blob) Solo blobs en páginas Copia una instantánea de un blob en páginas de origen en un blob en páginas de destino. Solo se transfieren los cambios diferenciales.
Append Block Solo blobs en anexos Escribe un bloque de datos al final de un blob en anexos.

En esta sección

Conceptos de Blob Storage

Operaciones en la cuenta (Blob Storage)

Operaciones con contenedores

Operaciones en blobs

Operaciones en blobs (cuentas habilitadas para espacios de nombres jerárquicos)

Consulte también

REST de servicios de almacenamiento