Armazenamento de Blobs do Azure API REST

Armazenamento de Blobs do Azure armazena texto e dados binários como objetos na cloud. O Armazenamento de Blobs oferece os seguintes recursos: a conta de armazenamento, os contentores e os blobs. Na sua conta de armazenamento, os contentores fornecem uma forma de organizar conjuntos de blobs.

Pode armazenar texto e dados binários num dos seguintes tipos de blobs:

  • Blobs de blocos, que estão otimizados para transmissão em fluxo.

  • Blobs de acréscimo, otimizados para operações de acréscimo.

  • Blobs de páginas, otimizados para operações aleatórias de leitura/escrita, e que fornecem a capacidade de escrever num intervalo de bytes num blob.

Para obter mais informações, veja Compreender 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, contentores e blobs. A API inclui as operações listadas na tabela seguinte.

Operação Tipo de recurso Description
Listar Contentores Conta Lista todos os contentores numa conta de armazenamento.
Definir Propriedades de Armazenamento de Blobs Conta Define as propriedades do Armazenamento de Blobs, incluindo as definições de registo e métricas e a versão de serviço predefinida.
Obter Propriedades de Armazenamento de Blobs Conta Obtém as propriedades Armazenamento de Blobs, incluindo definições de registo e métricas, e a versão de serviço predefinida.
Pedido de Blobs de Pré-voo Conta Consulta as regras de Partilha de Recursos Entre Origens (CORS) para o Armazenamento de Blobs, antes de enviar o pedido real.
Obter Estatísticas de Armazenamento de Blobs Conta Obtém estatísticas relacionadas com a replicação do Armazenamento de Blobs. Esta operação só está disponível no ponto final de localização secundária quando a replicação georredundante de acesso de leitura está ativada para a conta de armazenamento.
Obter Informações da Conta Conta Devolve o nome do SKU e o tipo de conta da conta especificada.
Obter Chave de Delegação de Utilizador Conta Obtém uma chave que pode ser utilizada para assinar uma assinatura de acesso partilhado de delegação de utilizador. Esta assinatura concede acesso a recursos no Armazenamento de Blobs com as credenciais do Azure Active Directory (Azure AD).
Criar Contentor Contentor Cria um novo contentor na conta de armazenamento.
Obter Propriedades do Contentor Contentor Devolve todos os metadados definidos pelo utilizador e as propriedades do sistema de um contentor.
Obter Metadados de Contentor Contentor Devolve apenas os metadados definidos pelo utilizador de um contentor.
Definir Metadados de Contentor Contentor Define os metadados definidos pelo utilizador de um contentor.
Obter ACL de Contentor Contentor Obtém a política de acesso público e quaisquer políticas de acesso armazenadas para o contentor.
Definir ACL de Contentor Contentor Define a política de acesso público e quaisquer políticas de acesso armazenadas para o contentor.
Contentor de Concessão Contentor Estabelece e gere um bloqueio num contentor para operações de eliminação.
Eliminar Contentor Contentor Elimina o contentor e os blobs que contém.
Listar Blobs Contentor Lista todos os blobs num contentor.
Colocar o Blob Blobs de blocos, acréscimos e páginas Cria um novo blob ou substitui um blob existente num contentor.
Obter Blob Blobs de blocos, acréscimos e páginas Lê ou transfere um blob do Armazenamento de Blobs, incluindo os metadados definidos pelo utilizador e as propriedades do sistema.
Get Blob Properties (Obter Propriedades do Blob) Blobs de blocos, acréscimos e páginas Devolve todas as propriedades do sistema e metadados definidos pelo utilizador no blob.
Definir Propriedades do Blob Blobs de blocos, acréscimos e páginas Define as propriedades do sistema definidas para um blob existente.
Definir Expiração do Blob Blobs de blocos Define o tempo de expiração para um blob existente.
Obter Metadados de Blobs Blobs de blocos, acréscimos e páginas Obtém todos os metadados definidos pelo utilizador de um blob ou instantâneo existente.
Definir Metadados de Blobs Blobs de blocos, acréscimos e páginas Define os metadados definidos pelo utilizador de um blob existente.
Obter Etiquetas de Blobs Blobs de blocos, acréscimos e páginas Obtém etiquetas definidas pelo utilizador de um blob existente.
Definir Etiquetas de Blobs Blobs de blocos, acréscimos e páginas Define etiquetas definidas pelo utilizador de um blob existente que formam um índice secundário.
Localizar Blobs por Etiquetas Blobs de blocos, acréscimos e páginas Lista blobs pelas etiquetas definidas pelo utilizador.
Eliminar Blob Blobs de blocos, acréscimos e páginas Marca um blob para eliminação.
Anular a eliminação de Blobs Blobs de blocos, acréscimos e páginas Restaura os conteúdos e metadados de um blob eliminado de forma recuperável ou todos os instantâneos de eliminação recuperável associados.
Blob de Concessão Blobs de blocos, acréscimos e páginas Estabelece e gere um bloqueio nas operações de escrita e eliminação. Para eliminar ou escrever num blob bloqueado, um cliente tem de fornecer o ID de concessão.
Blob de Instantâneo Blobs de blocos, acréscimos e páginas Cria um instantâneo só de leitura de um blob.
Copiar Blob Blobs de blocos, acréscimos e páginas Copia um blob de origem para um blob de destino nesta conta de armazenamento ou noutra conta de armazenamento.
Abortar Blob de Cópia Blobs de blocos, acréscimos e páginas Para uma operação pendente Copy Blob e deixa um blob de destino com comprimento zero e metadados completos.
Colocar Bloco Apenas blobs de blocos Cria um novo bloco a ser consolidado como parte de um blob de blocos.
Colocar Bloco a Partir do URL Apenas blobs de blocos Cria um novo bloco a ser consolidado como parte de um blob de blocos onde os conteúdos são lidos a partir de um URL.
Put Block List Apenas blobs de blocos Consolida um blob ao especificar o conjunto de IDs de bloco que compõem o blob de blocos.
Obter Lista de Bloqueios Apenas blobs de blocos Obtém a lista de blocos que foram carregados como parte de um blob de blocos.
Conteúdo do Blob de Consultas Apenas blobs de blocos Aplica uma instrução de linguagem SQL (Structured Query Language) simples (SQL) nos conteúdos de um blob e devolve apenas o subconjunto consultado dos dados.
Definir Camada de Blob Blobs de blocos e páginas Define a camada de um blob.
Colocar Página Apenas blobs de páginas Escreve um intervalo de páginas num blob de páginas.
Obter Intervalos de Páginas Apenas blobs de páginas Devolve uma lista de intervalos de página válidos para um blob de páginas ou um instantâneo de um blob de páginas.
Blob de Cópia Incremental Apenas blobs de páginas Copia um instantâneo de um blob de página de origem para um blob de página de destino. Apenas são transferidas alterações diferenciais.
Bloco de Acréscimo Acrescentar apenas blobs Escreve um bloco de dados no final de um blob de acréscimo.

Nesta secção

Conceitos do Armazenamento de Blobs

Operações na conta (Armazenamento de Blobs)

Operações em contentores

Operações em blobs

Operações em blobs (contas com espaço de nomes hierárquico ativado)

Ver também

REST dos serviços de armazenamento