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, otimizados para transmissão em fluxo.
Blobs de acréscimo, que estão otimizados para operações de acréscimo.
Os 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 os blobs de blocos, os blobs de acréscimo e os blobs de páginas.
A API REST para o Armazenamento de Blobs define operações HTTP em relação à 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 | Listas todos os contentores numa conta de armazenamento. |
| Definir Propriedades do 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 do 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 Blob de Verificação Prévia | Conta | Consulta as regras de Partilha de Recursos Transversais à Origem (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 Microsoft Entra credenciais. |
| 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 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 quaisquer blobs que contenha. |
| Listar Blobs | Contentor | Listas 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 para um blob existente. |
| Definir Expiração do Blob | Blobs de blocos | Define a hora de expiração de 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 | Listas blobs pelas etiquetas definidas pelo utilizador. |
| Eliminar Blob | Blobs de blocos, acréscimos e páginas | Marca um blob para eliminação. |
| Anular eliminação do Blob | 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 eliminados de forma 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 o 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 Blocos | 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 Consulta | Apenas blobs de blocos | Aplica uma instrução 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ágina ou um instantâneo de um blob de página. |
| 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 | Apenas blobs de acréscimo | 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 blobs (contas com espaço de nomes hierárquico ativado)