Compartilhar via


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 contêineres

Operações em blobs

Operações em blobs (contas hierárquicas habilitadas para namespace)

Confira também

REST dos serviços de armazenamento