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
Operaciones en la cuenta (Blob Storage)
Operaciones en blobs (cuentas habilitadas para espacios de nombres jerárquicos)