API REST do Armazenamento de Blobs do Azure
Armazenamento de Blobs do Azure armazena dados binários e de texto como objetos na nuvem. O Armazenamento de Blobs oferece os seguintes recursos: a conta de armazenamento, os contêineres e os blobs. Na sua conta de armazenamento, os contêineres fornecem uma forma de organizar conjuntos de blobs.
Você pode armazenar texto e dados binários em qualquer um dos seguintes dois tipos de blobs:
Blobs de blocos, que são otimizados para streaming.
Acrescente blobs, que são otimizados para operações de acréscimo.
Blobs de página, que são otimizados para operações aleatórias de leitura/gravação, e que fornecem a capacidade de gravar em um intervalo de bytes em um blob.
Para saber mais, confira Compreendendo blobs de blocos, blobs de acréscimo e blobs de páginas.
A API REST para Armazenamento de Blobs define operações HTTP na conta de armazenamento, contêineres e blobs. A API inclui as operações listadas na tabela a seguir.
| Operação | Tipo de recurso | Descrição |
|---|---|---|
| Listar contêineres | Conta | Lista todos os contêineres em uma conta de armazenamento. |
| Definir propriedades de armazenamento de blobs | Conta | Define as propriedades do Armazenamento de Blobs, incluindo configurações de log e métricas, e a versão padrão do serviço. |
| Obter propriedades de armazenamento de blobs | Conta | Obtém as propriedades Armazenamento de Blobs, incluindo configurações de log e métricas, e a versão de serviço padrão. |
| Solicitação de blob de pré-vôo | Conta | Consulta as regras de CORS (Compartilhamento de Recursos entre Origens) para Armazenamento de Blobs, antes de enviar a solicitação real. |
| Obter estatísticas de armazenamento de blobs | Conta | Recupera estatísticas relacionadas à replicação do Armazenamento de Blobs. Esta operação só estará disponível no ponto de extremidade de local secundário quando a replicação geograficamente redundante de acesso de leitura estiver habilitada para a conta de armazenamento. |
| Obter informações da conta | Conta | Retorna o nome do SKU e o tipo de conta da conta especificada. |
| Obter chave de delegação de usuário | Conta | Obtém uma chave que pode ser usada para assinar uma assinatura de acesso compartilhado de delegação de usuário. Essa assinatura concede acesso a recursos no Armazenamento de Blobs usando Microsoft Entra credenciais. |
| Create Container | Contêiner | Criar um novo contêiner em uma conta de armazenamento. |
| Obter Propriedades de Contêiner | Contêiner | Retorna todos os metadados e as propriedades de sistema de um contêiner definidos pelo usuário. |
| Get Container Metadata | Contêiner | Retorna somente metadados definidos pelo usuário de um contêiner. |
| Definir Metadados de Contêiner | Contêiner | Define metadados definidos pelo usuário de um contêiner. |
| Get Container ACL | Contêiner | Obtém a política de acesso público e todas as políticas de acesso armazenadas para o contêiner. |
| Definir ACL do contêiner | Contêiner | Define a política de acesso público e todas as políticas de acesso armazenadas para o contêiner. |
| Lease Container | Contêiner | Estabelece e gerencia um bloqueio em um contêiner para operações de exclusão. |
| Delete Container | Contêiner | Exclui o contêiner e todos os blobs que contêm. |
| Listar Blobs | Contêiner | Lista todos os blobs em um contêiner. |
| Put Blob | Bloquear, acrescentar e blobs de páginas | Cria um novo blob ou substitui um blob existente em um contêiner. |
| Get Blob | Bloquear, acrescentar e blobs de páginas | Lê ou baixa um blob do Armazenamento de Blobs, incluindo seus metadados definidos pelo usuário e propriedades do sistema. |
| Obter propriedades do blob | Bloquear, acrescentar e blobs de páginas | Retorna todas as propriedades de sistema e metadados definidos pelo usuário no blob. |
| Set Blob Properties | Bloquear, acrescentar e blobs de páginas | Define valores para as propriedades do sistema definidas para um blob existente. |
| Definir expiração de blob | Blobs de bloco | Define o tempo de expiração para um blob existente. |
| Get Blob Metadata | Bloquear, acrescentar e blobs de páginas | Recupera todos os metadados definidos pelo usuário de um blob ou instantâneo existente. |
| Set Blob Metadata | Bloquear, acrescentar e blobs de páginas | Define metadados definidos pelo usuário de um blob existente. |
| Obter marcas de blob | Bloquear, acrescentar e blobs de páginas | Recupera marcas definidas pelo usuário de um blob existente. |
| Definir marcas de blob | Bloquear, acrescentar e blobs de páginas | Define marcas definidas pelo usuário de um blob existente que formam um índice secundário. |
| Localizar blobs por marcas | Bloquear, acrescentar e blobs de páginas | Listas blobs por suas marcas definidas pelo usuário. |
| Excluir blob | Bloquear, acrescentar e blobs de páginas | Marca um blob para exclusão. |
| Restaurar blob | Bloquear, acrescentar e blobs de páginas | Restaura o conteúdo e os metadados de um blob de exclusão reversível ou todos os instantâneos excluídos temporariamente associados. |
| Concessão de blob | Bloquear, acrescentar e blobs de páginas | Estabelece e gerencia um bloqueio em operações de gravação e exclusão. Para excluir ou gravar em um blob bloqueado, um cliente deve fornecer a ID de concessão. |
| Blob de instantâneo | Bloquear, acrescentar e blobs de páginas | Cria um instantâneo somente leitura de um blob. |
| Copiar blob | Bloquear, acrescentar e blobs de páginas | Copia um blob de origem para um blob de destino nessa conta de armazenamento ou em outra conta de armazenamento. |
| Anular copiar Blob | Bloquear, acrescentar e blobs de páginas | Interrompe uma operação pendente Copy Blob e deixa um blob de destino com comprimento zero e metadados completos. |
| Put Block | Somente blobs de blocos | Cria um novo bloco a ser confirmado como parte de um blob de bloco. |
| Colocar Bloco da URL | Somente blobs de blocos | Cria um novo bloco a ser confirmado como parte de um blob de blocos em que o conteúdo é lido de uma URL. |
| Put Block List | Somente blobs de blocos | Confirma um blob especificando o conjunto de IDs de bloco que compõem o blob de bloco. |
| Get Block List | Somente blobs de blocos | Recupera a lista de blocos que foram carregados como parte de um blob de blocos. |
| Conteúdo do Blob de Consultas | Somente blobs de blocos | Aplica uma instrução SQL (linguagem SQL simples) no conteúdo de um blob e retorna apenas o subconjunto consultado dos dados. |
| Definir camada do blob | Blobs de blocos e de páginas | Define a camada de um blob. |
| Colocar Página | Blobs de páginas somente | Grava um intervalo de páginas em um blob de páginas. |
| OBter Intervalos de Página | Blobs de páginas somente | Retorna uma lista de intervalos de página válidos para um blob de página ou um instantâneo de um blob de páginas. |
| Blob de Cópia Incremental | Blobs de páginas somente | Copia um instantâneo de um blob de página de origem para um blob de página de destino. Somente alterações diferenciais são transferidas. |
| Acrescentar Bloco | Blobs de acréscimo somente | Grava um bloco de dados no final de um blob de acréscimo. |
Nesta seção
Conceitos do Armazenamento de Blobs
Operações na conta (Armazenamento de Blobs)
Operações em blobs (contas hierárquicas habilitadas para namespace)