PageBlobClient class
PageBlobClient define um conjunto de operações aplicáveis aos blobs de páginas.
- Extends
Construtores
Page |
Cria uma instância de PageBlobClient. |
Page |
Cria uma instância de PageBlobClient. Este método aceita um URL codificado ou um URL não codificado que aponta para um blob. A cadeia de URL codificada NÃO será escapada duas vezes, apenas os carateres especiais no caminho do URL serão escapados. Se um nome de blob incluir ? ou %, o nome do blob tem de ser codificado no URL. |
Page |
Cria uma instância de PageBlobClient. |
Propriedades
container |
O nome do contentor de armazenamento ao que o blob está associado. |
name | O nome do blob. |
Propriedades Herdadas
account |
|
credential | Tal como AnonymousCredential, StorageSharedKeyCredential ou qualquer credencial do |
url | Valor de cadeia de URL codificado. |
Métodos
clear |
Liberta as páginas especificadas do blob de páginas. Veja https://docs.microsoft.com/rest/api/storageservices/put-page |
create(number, Page |
Cria um blob de página do comprimento especificado. Chame uploadPages para carregar dados de dados para um blob de página. Veja https://docs.microsoft.com/rest/api/storageservices/put-blob |
create |
Cria um blob de página do comprimento especificado. Chame uploadPages para carregar dados de dados para um blob de página. Se o blob com o mesmo nome já existir, o conteúdo do blob existente permanecerá inalterado. Veja https://docs.microsoft.com/rest/api/storageservices/put-blob |
get |
Devolve a lista de intervalos de página válidos para um blob de página ou instantâneo de um blob de página. Veja https://docs.microsoft.com/rest/api/storageservices/get-page-ranges |
get |
Obtém a coleção de intervalos de páginas que diferem entre um instantâneo especificado e este blob de página. Veja https://docs.microsoft.com/rest/api/storageservices/get-page-ranges |
get |
Obtém a coleção de intervalos de páginas que diferem entre um instantâneo especificado e este blob de página para discos geridos. Veja https://docs.microsoft.com/rest/api/storageservices/get-page-ranges |
list |
Devolve um iterador iterável assíncrono à lista de intervalos de páginas de um blob de página. Veja https://docs.microsoft.com/rest/api/storageservices/get-page-ranges .byPage() devolve um iterador iterável assíncrono à lista de intervalos de páginas de um blob de página. Exemplo com
Exemplo com
Exemplo com
Exemplo com a paginação com um marcador:
|
list |
Devolve um iterador iterável assíncrono à lista de intervalos de páginas que diferem entre um instantâneo especificado e este blob de página. Veja https://docs.microsoft.com/rest/api/storageservices/get-page-ranges .byPage() devolve um iterador iterável assíncrono à lista de intervalos de páginas que diferem entre um instantâneo especificado e este blob de página. Exemplo com
Exemplo com
Exemplo com
Exemplo com a paginação com um marcador:
|
resize(number, Page |
Redimensiona o blob de página para o tamanho especificado (que tem de ser um múltiplo de 512). Veja https://docs.microsoft.com/rest/api/storageservices/set-blob-properties |
start |
Inicia uma operação para iniciar uma cópia incremental do instantâneo de um blob de página para este blob de página. O instantâneo é copiado de modo a que apenas as alterações diferenciais entre o instantâneo copiado anteriormente sejam transferidas para o destino. Os instantâneos copiados são cópias completas do instantâneo original e podem ser lidos ou copiados como habitualmente. Consulte Ver https://docs.microsoft.com/rest/api/storageservices/incremental-copy-blobhttps://docs.microsoft.com/en-us/azure/virtual-machines/windows/incremental-snapshots |
update |
Define o número de sequência de um blob de página. Veja https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties |
upload |
Escreve 1 ou mais páginas no blob de páginas. Os desvios de início e de fim têm de ser múltiplos de 512. Veja https://docs.microsoft.com/rest/api/storageservices/put-page |
upload |
A operação Carregar Páginas escreve um intervalo de páginas num blob de página onde os conteúdos são lidos a partir de um URL. Veja https://docs.microsoft.com/en-us/rest/api/storageservices/put-page-from-url |
with |
Cria um novo objeto PageBlobClient idêntico à origem, mas com o carimbo de data/hora do instantâneo especificado. Fornecer "" removerá o instantâneo e devolverá um Cliente ao blob base. |
Métodos Herdados
abort |
Aborta uma operação de Blob de Cópia assíncrona pendente e deixa um blob de destino com comprimento zero e metadados completos. Versão 2012-02-12 e mais recente. Veja https://docs.microsoft.com/en-us/rest/api/storageservices/abort-copy-blob |
begin |
Assíncronamente copia um blob para um destino na conta de armazenamento.
Este método devolve um poller de operação de execução prolongada que lhe permite aguardar indefinidamente até que a cópia seja concluída.
Também pode cancelar uma cópia antes de ser concluída ao chamar Na versão 2012-02-12 e posterior, a origem de uma operação Copiar Blob pode ser um blob consolidado em qualquer conta de armazenamento do Azure. A partir da versão 2015-02-21, a origem de uma operação Copiar Blob pode ser um ficheiro do Azure em qualquer conta de armazenamento do Azure. Apenas as contas de armazenamento criadas em ou depois de 7 de junho de 2012 permitem que a operação Copiar Blob copie a partir de outra conta de armazenamento. Veja https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob Exemplo através de consultas automáticas:
Exemplo de utilização de consultas manuais:
Exemplo com atualizações de progresso:
Exemplo com um intervalo de consulta alterado (predefinição 15 segundos):
Exemplo com o cancelamento de cópia:
|
create |
Cria um instantâneo só de leitura de um blob. Veja https://docs.microsoft.com/en-us/rest/api/storageservices/snapshot-blob |
delete(Blob |
Marca o blob ou instantâneo especificado para eliminação. O blob é posteriormente eliminado durante a recolha de lixo. Tenha em atenção que, para eliminar um blob, tem de eliminar todos os respetivos instantâneos. Pode eliminar ambos ao mesmo tempo com a operação Eliminar Blob. Veja https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob |
delete |
Marca o blob ou instantâneo especificado para eliminação, se existir. O blob é posteriormente eliminado durante a recolha de lixo. Tenha em atenção que, para eliminar um blob, tem de eliminar todos os respetivos instantâneos. Pode eliminar ambos ao mesmo tempo com a operação Eliminar Blob. Veja https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob |
delete |
Elimine a política de immutablility no blob. |
download(number, number, Blob |
Lê ou transfere um blob do sistema, incluindo os respetivos metadados e propriedades. Também pode chamar Obter Blob para ler um instantâneo.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob |
download |
APENAS DISPONÍVEL NO NODE.JS RUNTIME. Transfere um Blob do Azure em paralelo para uma memória intermédia. O deslocamento e a contagem são opcionais, transfere todo o blob se não forem fornecidos. Aviso: as memórias intermédias só podem suportar ficheiros até cerca de um gigabyte em sistemas de 32 bits ou cerca de dois gigabytes em sistemas de 64 bits devido a limitações de Node.js/V8. Para blobs maiores do que este tamanho, considere downloadToFile. |
download |
APENAS DISPONÍVEL NO NODE.JS RUNTIME. Transfere um Blob do Azure em paralelo para uma memória intermédia. O deslocamento e a contagem são opcionais, transfere todo o blob se não forem fornecidos. Aviso: as memórias intermédias só podem suportar ficheiros até cerca de um gigabyte em sistemas de 32 bits ou cerca de dois gigabytes em sistemas de 64 bits devido a limitações de Node.js/V8. Para blobs maiores do que este tamanho, considere downloadToFile. |
download |
APENAS DISPONÍVEL NO NODE.JS RUNTIME. Transfere um Blob do Azure para um ficheiro local. Falha se o caminho de ficheiro especificado já sair. O deslocamento e a contagem são opcionais, passam 0 e não são definidos, respetivamente, para transferir todo o blob. |
exists(Blob |
Devolve verdadeiro se o recurso de blob do Azure representado por este cliente existir; falso de outra forma. NOTA: utilize esta função com cuidado, uma vez que um blob existente pode ser eliminado por outros clientes ou aplicações. Os novos blobs vice-versa podem ser adicionados por outros clientes ou aplicações após a conclusão desta função. |
generate |
Disponível apenas para BlobClient construído com uma credencial de chave partilhada. Gera um URI de Assinatura de Acesso Partilhado (SAS) do Serviço blob com base nas propriedades e parâmetros do cliente transmitidos. A SAS é assinada pela credencial de chave partilhada do cliente. Veja https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas |
get |
Cria um objeto AppendBlobClient. |
get |
Obtenha um BlobLeaseClient que gere as concessões no blob. |
get |
Cria um objeto BlockBlobClient. |
get |
Cria um objeto PageBlobClient. |
get |
Devolve todos os metadados definidos pelo utilizador, propriedades HTTP padrão e propriedades do sistema para o blob. Não devolve o conteúdo do blob. Veja https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties AVISO: o |
get |
Obtém as etiquetas associadas ao blob subjacente. |
set |
Define a camada num blob. A operação é permitida num blob de página numa conta de armazenamento premium e num blob de blocos numa conta de armazenamento de blobs (apenas armazenamento localmente redundante). O escalão de um blob de página premium determina o tamanho permitido, o IOPS e a largura de banda do blob. A camada de um blob de blocos determina o tipo de armazenamento Frequente/Esporádico/Arquivo. Esta operação não atualiza o ETag do blob. Veja https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-tier |
set |
Define as propriedades do sistema no blob. Se não for fornecido nenhum valor ou nenhum valor fornecido para os cabeçalhos HTTP de blob especificados, estes cabeçalhos HTTP de blob sem um valor serão limpos. Veja https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties |
set |
Defina a política de imutablilidade no blob. |
set |
Defina a suspensão legal no blob. |
set |
Define metadados definidos pelo utilizador para o blob especificado como um ou mais pares nome-valor. Se não for fornecida nenhuma opção ou se não forem definidos metadados no parâmetro, os metadados do blob serão removidos. Veja https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata |
set |
Define etiquetas no blob subjacente. Um blob pode ter até 10 etiquetas. As teclas de etiqueta têm de ter entre 1 e 128 carateres. Os valores das etiquetas têm de ter entre 0 e 256 carateres. Os carateres de valor e chave de etiqueta válidos incluem letras minúsculas e maiúsculas, dígitos (0-9), espaço (' '), mais ('+'), subtração ('-'), ponto final ('.'), barra ('/'), dois pontos (':'), igual a ('=') e sublinhado ('_') . |
sync |
A operação copy from URL síncrona copia um blob ou um recurso da Internet para um novo blob. Não devolverá uma resposta até que a cópia esteja concluída. Veja https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob-from-url |
undelete(Blob |
Restaura os conteúdos e metadados do blob eliminado de forma recuperável e quaisquer instantâneos de eliminação recuperável associados. O Undelete Blob só é suportado na versão 2017-07-29 ou posterior. Veja https://docs.microsoft.com/en-us/rest/api/storageservices/undelete-blob |
with |
Cria um novo objeto BlobClient que aponta para uma versão deste blob. Fornecer "" removerá o versionId e devolverá um Cliente ao blob base. |
Detalhes do Construtor
PageBlobClient(string, PipelineLike)
Cria uma instância de PageBlobClient.
new PageBlobClient(url: string, pipeline: PipelineLike)
Parâmetros
- url
-
string
Uma cadeia de URL a apontar para o blob da página do Armazenamento do Azure, como "https://myaccount.blob.core.windows.net/mycontainer/pageblob". Pode acrescentar uma SAS se utilizar AnonymousCredential, como "https://myaccount.blob.core.windows.net/mycontainer/pageblob?sasString". Este método aceita um URL codificado ou um URL não codificado que aponta para um blob. A cadeia de URL codificada NÃO será escapada duas vezes, apenas os carateres especiais no caminho do URL serão escapados. No entanto, se um nome de blob incluir ? ou %, o nome do blob tem de ser codificado no URL. Tal como um blob com o nome "my?blob%", o URL deve ser "https://myaccount.blob.core.windows.net/mycontainer/my%3Fblob%25".
- pipeline
- PipelineLike
Chame newPipeline() para criar um pipeline predefinido ou forneça um pipeline personalizado.
PageBlobClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)
Cria uma instância de PageBlobClient. Este método aceita um URL codificado ou um URL não codificado que aponta para um blob. A cadeia de URL codificada NÃO será escapada duas vezes, apenas os carateres especiais no caminho do URL serão escapados. Se um nome de blob incluir ? ou %, o nome do blob tem de ser codificado no URL.
new PageBlobClient(url: string, credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)
Parâmetros
- url
-
string
Uma cadeia de cliente que aponta para o blob de páginas do Armazenamento do Azure, como "https://myaccount.blob.core.windows.net/mycontainer/pageblob". Pode acrescentar uma SAS se utilizar AnonymousCredential, como "https://myaccount.blob.core.windows.net/mycontainer/pageblob?sasString".
- credential
-
StorageSharedKeyCredential | AnonymousCredential | TokenCredential
Tal como AnonymousCredential, StorageSharedKeyCredential ou qualquer credencial do @azure/identity
pacote para autenticar pedidos no serviço. Também pode fornecer um objeto que implementa a interface TokenCredential. Se não for especificado, é utilizado AnonymousCredential.
- options
- StoragePipelineOptions
Opcional. Opções para configurar o pipeline HTTP.
PageBlobClient(string, string, string, StoragePipelineOptions)
Cria uma instância de PageBlobClient.
new PageBlobClient(connectionString: string, containerName: string, blobName: string, options?: StoragePipelineOptions)
Parâmetros
- connectionString
-
string
Cadeia de ligação de conta ou uma cadeia de ligação SAS de uma conta de armazenamento do Azure.
[ Nota - A cadeia de ligação de conta só pode ser utilizada no NODE.JS runtime. ] Exemplo de cadeia de ligação de conta -DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net
Exemplo de cadeia de ligação SAS - BlobEndpoint=https://myaccount.blob.core.windows.net/;QueueEndpoint=https://myaccount.queue.core.windows.net/;FileEndpoint=https://myaccount.file.core.windows.net/;TableEndpoint=https://myaccount.table.core.windows.net/;SharedAccessSignature=sasString
- containerName
-
string
Nome do contentor.
- blobName
-
string
Nome do blob.
- options
- StoragePipelineOptions
Opcional. Opções para configurar o pipeline HTTP.
Detalhes de Propriedade
containerName
O nome do contentor de armazenamento ao que o blob está associado.
string containerName
Valor de Propriedade
string
name
O nome do blob.
string name
Valor de Propriedade
string
Detalhes da Propriedade Herdada
accountName
credential
Tal como AnonymousCredential, StorageSharedKeyCredential ou qualquer credencial do @azure/identity
pacote para autenticar pedidos no serviço. Também pode fornecer um objeto que implementa a interface TokenCredential. Se não for especificado, é utilizado AnonymousCredential.
credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential
Valor de Propriedade
Herdado deBlobClient.credential
url
Detalhes de Método
clearPages(number, number, PageBlobClearPagesOptions)
Liberta as páginas especificadas do blob de páginas.
Veja https://docs.microsoft.com/rest/api/storageservices/put-page
function clearPages(offset?: number, count?: number, options?: PageBlobClearPagesOptions): Promise<PageBlobClearPagesResponse>
Parâmetros
- offset
-
number
Iniciar a posição de byte das páginas a limpar.
- count
-
number
Número de bytes a limpar.
- options
- PageBlobClearPagesOptions
Opções para a operação Limpar Páginas do Blob de Páginas.
Devoluções
Promise<PageBlobClearPagesResponse>
Dados de resposta para a operação Limpar Páginas do Blob de Páginas.
create(number, PageBlobCreateOptions)
Cria um blob de página do comprimento especificado. Chame uploadPages para carregar dados de dados para um blob de página.
Veja https://docs.microsoft.com/rest/api/storageservices/put-blob
function create(size: number, options?: PageBlobCreateOptions): Promise<PageBlobCreateResponse>
Parâmetros
- size
-
number
tamanho do blob de página.
- options
- PageBlobCreateOptions
Opções para a operação De Criação de Blobs de Páginas.
Devoluções
Promise<PageBlobCreateResponse>
Dados de resposta para a operação De Criação de Blobs de Páginas.
createIfNotExists(number, PageBlobCreateIfNotExistsOptions)
Cria um blob de página do comprimento especificado. Chame uploadPages para carregar dados de dados para um blob de página. Se o blob com o mesmo nome já existir, o conteúdo do blob existente permanecerá inalterado.
Veja https://docs.microsoft.com/rest/api/storageservices/put-blob
function createIfNotExists(size: number, options?: PageBlobCreateIfNotExistsOptions): Promise<PageBlobCreateIfNotExistsResponse>
Parâmetros
- size
-
number
tamanho do blob de página.
- options
- PageBlobCreateIfNotExistsOptions
Devoluções
Promise<PageBlobCreateIfNotExistsResponse>
getPageRanges(number, number, PageBlobGetPageRangesOptions)
Devolve a lista de intervalos de página válidos para um blob de página ou instantâneo de um blob de página.
Veja https://docs.microsoft.com/rest/api/storageservices/get-page-ranges
function getPageRanges(offset?: number, count?: number, options?: PageBlobGetPageRangesOptions): Promise<PageBlobGetPageRangesResponse>
Parâmetros
- offset
-
number
A iniciar a posição de byte dos intervalos de páginas.
- count
-
number
Número de bytes a obter.
- options
- PageBlobGetPageRangesOptions
Opções para a operação Obter Intervalos do Blob de Páginas.
Devoluções
Promise<PageBlobGetPageRangesResponse>
Dados de resposta para a operação Obter Intervalos de Blobs de Páginas.
getPageRangesDiff(number, number, string, PageBlobGetPageRangesDiffOptions)
Obtém a coleção de intervalos de páginas que diferem entre um instantâneo especificado e este blob de página.
Veja https://docs.microsoft.com/rest/api/storageservices/get-page-ranges
function getPageRangesDiff(offset: number, count: number, prevSnapshot: string, options?: PageBlobGetPageRangesDiffOptions): Promise<PageBlobGetPageRangesDiffResponse>
Parâmetros
- offset
-
number
Iniciar a posição de byte do blob de página
- count
-
number
Número de bytes para obter intervalos difusos.
- prevSnapshot
-
string
Carimbo de data/hora do instantâneo para obter a diferença.
- options
- PageBlobGetPageRangesDiffOptions
Opções para a operação De difusão Obter Intervalos de Páginas do Blob de Páginas.
Devoluções
Promise<PageBlobGetPageRangesDiffResponse>
Dados de resposta para a operação De difusão Obter Intervalo de Páginas do Blob de Páginas.
getPageRangesDiffForManagedDisks(number, number, string, PageBlobGetPageRangesDiffOptions)
Obtém a coleção de intervalos de páginas que diferem entre um instantâneo especificado e este blob de página para discos geridos.
Veja https://docs.microsoft.com/rest/api/storageservices/get-page-ranges
function getPageRangesDiffForManagedDisks(offset: number, count: number, prevSnapshotUrl: string, options?: PageBlobGetPageRangesDiffOptions): Promise<PageBlobGetPageRangesDiffResponse>
Parâmetros
- offset
-
number
Iniciar a posição de byte do blob de página
- count
-
number
Número de bytes para obter intervalos difusos.
- prevSnapshotUrl
-
string
URL do instantâneo para obter a diferença.
- options
- PageBlobGetPageRangesDiffOptions
Opções para a operação De difusão Obter Intervalos de Páginas do Blob de Páginas.
Devoluções
Promise<PageBlobGetPageRangesDiffResponse>
Dados de resposta para a operação De difusão Obter Intervalo de Páginas do Blob de Páginas.
listPageRanges(number, number, PageBlobListPageRangesOptions)
Devolve um iterador iterável assíncrono à lista de intervalos de páginas de um blob de página.
Veja https://docs.microsoft.com/rest/api/storageservices/get-page-ranges
.byPage() devolve um iterador iterável assíncrono à lista de intervalos de páginas de um blob de página.
Exemplo com for await
sintaxe:
// Get the pageBlobClient before you run these snippets,
// Can be obtained from `blobServiceClient.getContainerClient("<your-container-name>").getPageBlobClient("<your-blob-name>");`
let i = 1;
for await (const pageRange of pageBlobClient.listPageRanges()) {
console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}
Exemplo com iter.next()
:
let i = 1;
let iter = pageBlobClient.listPageRanges();
let pageRangeItem = await iter.next();
while (!pageRangeItem.done) {
console.log(`Page range ${i++}: ${pageRangeItem.value.start} - ${pageRangeItem.value.end}, IsClear: ${pageRangeItem.value.isClear}`);
pageRangeItem = await iter.next();
}
Exemplo com byPage()
:
// passing optional maxPageSize in the page settings
let i = 1;
for await (const response of pageBlobClient.listPageRanges().byPage({ maxPageSize: 20 })) {
for (const pageRange of response) {
console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}
}
Exemplo com a paginação com um marcador:
let i = 1;
let iterator = pageBlobClient.listPageRanges().byPage({ maxPageSize: 2 });
let response = (await iterator.next()).value;
// Prints 2 page ranges
for (const pageRange of response) {
console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}
// Gets next marker
let marker = response.continuationToken;
// Passing next marker as continuationToken
iterator = pageBlobClient.listPageRanges().byPage({ continuationToken: marker, maxPageSize: 10 });
response = (await iterator.next()).value;
// Prints 10 page ranges
for (const blob of response) {
console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}
function listPageRanges(offset?: number, count?: number, options?: PageBlobListPageRangesOptions): PagedAsyncIterableIterator<PageRangeInfo, PageBlobGetPageRangesResponseModel, PageSettings>
Parâmetros
- offset
-
number
A iniciar a posição de byte dos intervalos de páginas.
- count
-
number
Número de bytes a obter.
- options
- PageBlobListPageRangesOptions
Opções para a operação Obter Intervalos do Blob de Páginas.
Devoluções
Um asyncIterableIterator que suporta a paginação.
listPageRangesDiff(number, number, string, PageBlobListPageRangesDiffOptions)
Devolve um iterador iterável assíncrono à lista de intervalos de páginas que diferem entre um instantâneo especificado e este blob de página.
Veja https://docs.microsoft.com/rest/api/storageservices/get-page-ranges
.byPage() devolve um iterador iterável assíncrono à lista de intervalos de páginas que diferem entre um instantâneo especificado e este blob de página.
Exemplo com for await
sintaxe:
// Get the pageBlobClient before you run these snippets,
// Can be obtained from `blobServiceClient.getContainerClient("<your-container-name>").getPageBlobClient("<your-blob-name>");`
let i = 1;
for await (const pageRange of pageBlobClient.listPageRangesDiff()) {
console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}
Exemplo com iter.next()
:
let i = 1;
let iter = pageBlobClient.listPageRangesDiff();
let pageRangeItem = await iter.next();
while (!pageRangeItem.done) {
console.log(`Page range ${i++}: ${pageRangeItem.value.start} - ${pageRangeItem.value.end}, IsClear: ${pageRangeItem.value.isClear}`);
pageRangeItem = await iter.next();
}
Exemplo com byPage()
:
// passing optional maxPageSize in the page settings
let i = 1;
for await (const response of pageBlobClient.listPageRangesDiff().byPage({ maxPageSize: 20 })) {
for (const pageRange of response) {
console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}
}
Exemplo com a paginação com um marcador:
let i = 1;
let iterator = pageBlobClient.listPageRangesDiff().byPage({ maxPageSize: 2 });
let response = (await iterator.next()).value;
// Prints 2 page ranges
for (const pageRange of response) {
console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}
// Gets next marker
let marker = response.continuationToken;
// Passing next marker as continuationToken
iterator = pageBlobClient.listPageRangesDiff().byPage({ continuationToken: marker, maxPageSize: 10 });
response = (await iterator.next()).value;
// Prints 10 page ranges
for (const blob of response) {
console.log(`Page range ${i++}: ${pageRange.start} - ${pageRange.end}`);
}
function listPageRangesDiff(offset: number, count: number, prevSnapshot: string, options?: PageBlobListPageRangesDiffOptions): PagedAsyncIterableIterator<PageRangeInfo, PageBlobGetPageRangesDiffResponseModel, PageSettings>
Parâmetros
- offset
-
number
A iniciar a posição de byte dos intervalos de páginas.
- count
-
number
Número de bytes a obter.
- prevSnapshot
-
string
Carimbo de data/hora do instantâneo para obter a diferença.
Opções para a operação Obter Intervalos do Blob de Páginas.
Devoluções
Um asyncIterableIterator que suporta a paginação.
resize(number, PageBlobResizeOptions)
Redimensiona o blob de página para o tamanho especificado (que tem de ser um múltiplo de 512).
Veja https://docs.microsoft.com/rest/api/storageservices/set-blob-properties
function resize(size: number, options?: PageBlobResizeOptions): Promise<PageBlobResizeResponse>
Parâmetros
- size
-
number
Tamanho do destino
- options
- PageBlobResizeOptions
Opções para a operação de Redimensionamento de Blobs de Páginas.
Devoluções
Promise<PageBlobResizeResponse>
Dados de resposta para a operação Redimensionar Blobs de Páginas.
startCopyIncremental(string, PageBlobStartCopyIncrementalOptions)
Inicia uma operação para iniciar uma cópia incremental do instantâneo de um blob de página para este blob de página. O instantâneo é copiado de modo a que apenas as alterações diferenciais entre o instantâneo copiado anteriormente sejam transferidas para o destino. Os instantâneos copiados são cópias completas do instantâneo original e podem ser lidos ou copiados como habitualmente.
Consulte Ver https://docs.microsoft.com/rest/api/storageservices/incremental-copy-blobhttps://docs.microsoft.com/en-us/azure/virtual-machines/windows/incremental-snapshots
function startCopyIncremental(copySource: string, options?: PageBlobStartCopyIncrementalOptions): Promise<PageBlobCopyIncrementalResponse>
Parâmetros
- copySource
-
string
Especifica o nome do instantâneo do blob da página de origem. Por exemplo, https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=
Opções para a operação De Cópia Incremental de Blobs de Páginas.
Devoluções
Promise<PageBlobCopyIncrementalResponse>
Dados de resposta para a operação Incremental Cópia de Blobs de Páginas.
updateSequenceNumber(SequenceNumberActionType, number, PageBlobUpdateSequenceNumberOptions)
Define o número de sequência de um blob de página.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties
function updateSequenceNumber(sequenceNumberAction: SequenceNumberActionType, sequenceNumber?: number, options?: PageBlobUpdateSequenceNumberOptions): Promise<PageBlobUpdateSequenceNumberResponse>
Parâmetros
- sequenceNumberAction
- SequenceNumberActionType
Indica como o serviço deve modificar o número de sequência do blob.
- sequenceNumber
-
number
Necessário se sequenceNumberAction for máx. ou atualizar
Opções para a operação Número de Sequência de Atualizações de Blobs de Página.
Devoluções
Promise<PageBlobUpdateSequenceNumberResponse>
Dados de resposta para a operação Número de Sequência de Atualizações de Blobs de Páginas.
uploadPages(HttpRequestBody, number, number, PageBlobUploadPagesOptions)
Escreve 1 ou mais páginas no blob de páginas. Os desvios de início e de fim têm de ser múltiplos de 512.
Veja https://docs.microsoft.com/rest/api/storageservices/put-page
function uploadPages(body: HttpRequestBody, offset: number, count: number, options?: PageBlobUploadPagesOptions): Promise<PageBlobUploadPagesResponse>
Parâmetros
- body
- HttpRequestBody
Dados a carregar
- offset
-
number
Desvio do blob de página de destino
- count
-
number
Comprimento do conteúdo do corpo, também número de bytes a carregar
- options
- PageBlobUploadPagesOptions
Opções para a operação Carregar Páginas do Blob de Páginas.
Devoluções
Promise<PageBlobUploadPagesResponse>
Dados de resposta para a operação Carregar Páginas do Blob de Páginas.
uploadPagesFromURL(string, number, number, number, PageBlobUploadPagesFromURLOptions)
A operação Carregar Páginas escreve um intervalo de páginas num blob de página onde os conteúdos são lidos a partir de um URL.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/put-page-from-url
function uploadPagesFromURL(sourceURL: string, sourceOffset: number, destOffset: number, count: number, options?: PageBlobUploadPagesFromURLOptions): Promise<PageBlobUploadPagesFromURLResponse>
Parâmetros
- sourceURL
-
string
Especifique um URL para a origem de cópia, Assinatura de Acesso Partilhado (SAS) talvez seja necessário para autenticação
- sourceOffset
-
number
O desvio de origem a partir do qual copiar. Passar 0 para copiar a partir do início do blob de página de origem
- destOffset
-
number
Desvio do blob de página de destino
- count
-
number
Número de bytes a carregar a partir do blob de página de origem
Devoluções
Promise<PageBlobUploadPagesFromURLResponse>
withSnapshot(string)
Cria um novo objeto PageBlobClient idêntico à origem, mas com o carimbo de data/hora do instantâneo especificado. Fornecer "" removerá o instantâneo e devolverá um Cliente ao blob base.
function withSnapshot(snapshot: string): PageBlobClient
Parâmetros
- snapshot
-
string
O carimbo de data/hora do instantâneo.
Devoluções
Um novo objeto PageBlobClient idêntico à origem, mas com o carimbo de data/hora do instantâneo especificado.
Detalhes do Método Herdado
abortCopyFromURL(string, BlobAbortCopyFromURLOptions)
Aborta uma operação de Blob de Cópia assíncrona pendente e deixa um blob de destino com comprimento zero e metadados completos. Versão 2012-02-12 e mais recente.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/abort-copy-blob
function abortCopyFromURL(copyId: string, options?: BlobAbortCopyFromURLOptions): Promise<BlobAbortCopyFromURLResponse>
Parâmetros
- copyId
-
string
ID da operação Copiar do URL.
- options
- BlobAbortCopyFromURLOptions
Opções opcionais para a operação Abortar Cópia do URL do Blob.
Devoluções
Promise<BlobAbortCopyFromURLResponse>
Herdado deBlobClient.abortCopyFromURL
beginCopyFromURL(string, BlobBeginCopyFromURLOptions)
Assíncronamente copia um blob para um destino na conta de armazenamento.
Este método devolve um poller de operação de execução prolongada que lhe permite aguardar indefinidamente até que a cópia seja concluída.
Também pode cancelar uma cópia antes de ser concluída ao chamar cancelOperation
o poller.
Tenha em atenção que a chamada de retorno onProgress não será invocada se a operação for concluída no primeiro pedido e tentar cancelar uma cópia concluída resultará num erro.
Na versão 2012-02-12 e posterior, a origem de uma operação Copiar Blob pode ser um blob consolidado em qualquer conta de armazenamento do Azure. A partir da versão 2015-02-21, a origem de uma operação Copiar Blob pode ser um ficheiro do Azure em qualquer conta de armazenamento do Azure. Apenas as contas de armazenamento criadas em ou depois de 7 de junho de 2012 permitem que a operação Copiar Blob copie a partir de outra conta de armazenamento.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob
Exemplo através de consultas automáticas:
const copyPoller = await blobClient.beginCopyFromURL('url');
const result = await copyPoller.pollUntilDone();
Exemplo de utilização de consultas manuais:
const copyPoller = await blobClient.beginCopyFromURL('url');
while (!poller.isDone()) {
await poller.poll();
}
const result = copyPoller.getResult();
Exemplo com atualizações de progresso:
const copyPoller = await blobClient.beginCopyFromURL('url', {
onProgress(state) {
console.log(`Progress: ${state.copyProgress}`);
}
});
const result = await copyPoller.pollUntilDone();
Exemplo com um intervalo de consulta alterado (predefinição 15 segundos):
const copyPoller = await blobClient.beginCopyFromURL('url', {
intervalInMs: 1000 // poll blob every 1 second for copy progress
});
const result = await copyPoller.pollUntilDone();
Exemplo com o cancelamento de cópia:
const copyPoller = await blobClient.beginCopyFromURL('url');
// cancel operation after starting it.
try {
await copyPoller.cancelOperation();
// calls to get the result now throw PollerCancelledError
await copyPoller.getResult();
} catch (err) {
if (err.name === 'PollerCancelledError') {
console.log('The copy was cancelled.');
}
}
function beginCopyFromURL(copySource: string, options?: BlobBeginCopyFromURLOptions): Promise<PollerLikeWithCancellation<PollOperationState<BlobBeginCopyFromURLResponse>, BlobBeginCopyFromURLResponse>>
Parâmetros
- copySource
-
string
url para o Blob/Ficheiro do Azure de origem.
- options
- BlobBeginCopyFromURLOptions
Opções opcionais para a operação Iniciar Cópia a Partir do URL do Blob.
Devoluções
Promise<PollerLikeWithCancellation<PollOperationState<BlobBeginCopyFromURLResponse>, BlobBeginCopyFromURLResponse>>
Herdado deBlobClient.beginCopyFromURL
createSnapshot(BlobCreateSnapshotOptions)
Cria um instantâneo só de leitura de um blob.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/snapshot-blob
function createSnapshot(options?: BlobCreateSnapshotOptions): Promise<BlobCreateSnapshotResponse>
Parâmetros
- options
- BlobCreateSnapshotOptions
Opções opcionais para a operação Criar Instantâneo de Blobs.
Devoluções
Promise<BlobCreateSnapshotResponse>
Herdado deBlobClient.createSnapshot
delete(BlobDeleteOptions)
Marca o blob ou instantâneo especificado para eliminação. O blob é posteriormente eliminado durante a recolha de lixo. Tenha em atenção que, para eliminar um blob, tem de eliminar todos os respetivos instantâneos. Pode eliminar ambos ao mesmo tempo com a operação Eliminar Blob.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob
function delete(options?: BlobDeleteOptions): Promise<BlobDeleteResponse>
Parâmetros
- options
- BlobDeleteOptions
Opções opcionais para a operação de Eliminação de Blobs.
Devoluções
Promise<BlobDeleteResponse>
Herdado deBlobClient.delete
deleteIfExists(BlobDeleteOptions)
Marca o blob ou instantâneo especificado para eliminação, se existir. O blob é posteriormente eliminado durante a recolha de lixo. Tenha em atenção que, para eliminar um blob, tem de eliminar todos os respetivos instantâneos. Pode eliminar ambos ao mesmo tempo com a operação Eliminar Blob.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob
function deleteIfExists(options?: BlobDeleteOptions): Promise<BlobDeleteIfExistsResponse>
Parâmetros
- options
- BlobDeleteOptions
Opções opcionais para a operação de Eliminação de Blobs.
Devoluções
Promise<BlobDeleteIfExistsResponse>
Herdado deBlobClient.deleteIfExists
deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)
Elimine a política de immutablility no blob.
function deleteImmutabilityPolicy(options?: BlobDeleteImmutabilityPolicyOptions): Promise<BlobDeleteImmutabilityPolicyResponse>
Parâmetros
Opções opcionais para eliminar a política de imutabilidade no blob.
Devoluções
Promise<BlobDeleteImmutabilityPolicyResponse>
Herdado deBlobClient.deleteImmutabilityPolicy
download(number, number, BlobDownloadOptions)
Lê ou transfere um blob do sistema, incluindo os respetivos metadados e propriedades. Também pode chamar Obter Blob para ler um instantâneo.
- No Node.js, os dados são devolvidos num fluxo legível readableStreamBody
- Nos browsers, os dados são devolvidos num blobBody de promessa
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob
function download(offset?: number, count?: number, options?: BlobDownloadOptions): Promise<BlobDownloadResponseParsed>
Parâmetros
- offset
-
number
A partir da posição do blob a transferir, maior ou igual a 0
- count
-
number
A quantidade de dados a transferir, superior a 0. Será transferido para o fim quando não for definido
- options
- BlobDownloadOptions
Opções opcionais para a operação de Transferência de Blobs.
Utilização de exemplo (Node.js):
// Download and convert a blob to a string
const downloadBlockBlobResponse = await blobClient.download();
const downloaded = await streamToBuffer(downloadBlockBlobResponse.readableStreamBody);
console.log("Downloaded blob content:", downloaded.toString());
async function streamToBuffer(readableStream) {
return new Promise((resolve, reject) => {
const chunks = [];
readableStream.on("data", (data) => {
chunks.push(data instanceof Buffer ? data : Buffer.from(data));
});
readableStream.on("end", () => {
resolve(Buffer.concat(chunks));
});
readableStream.on("error", reject);
});
}
Utilização de exemplo (browser):
// Download and convert a blob to a string
const downloadBlockBlobResponse = await blobClient.download();
const downloaded = await blobToString(await downloadBlockBlobResponse.blobBody);
console.log(
"Downloaded blob content",
downloaded
);
async function blobToString(blob: Blob): Promise<string> {
const fileReader = new FileReader();
return new Promise<string>((resolve, reject) => {
fileReader.onloadend = (ev: any) => {
resolve(ev.target!.result);
};
fileReader.onerror = reject;
fileReader.readAsText(blob);
});
}
Devoluções
Promise<BlobDownloadResponseParsed>
Herdado deBlobClient.download
downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)
APENAS DISPONÍVEL NO NODE.JS RUNTIME.
Transfere um Blob do Azure em paralelo para uma memória intermédia. O deslocamento e a contagem são opcionais, transfere todo o blob se não forem fornecidos.
Aviso: as memórias intermédias só podem suportar ficheiros até cerca de um gigabyte em sistemas de 32 bits ou cerca de dois gigabytes em sistemas de 64 bits devido a limitações de Node.js/V8. Para blobs maiores do que este tamanho, considere downloadToFile.
function downloadToBuffer(buffer: Buffer, offset?: number, count?: number, options?: BlobDownloadToBufferOptions): Promise<Buffer>
Parâmetros
- buffer
-
Buffer
Memória intermédia a preencher, tem de ter um comprimento superior à contagem
- offset
-
number
A partir da posição do blob de blocos a transferir(em bytes)
- count
-
number
Quanta quantidade de dados (em bytes) a transferir. Será transferida para o fim ao passar indefinidamente
- options
- BlobDownloadToBufferOptions
BlobDownloadToBufferOptions
Devoluções
Promise<Buffer>
Herdado deBlobClient.downloadToBuffer
downloadToBuffer(number, number, BlobDownloadToBufferOptions)
APENAS DISPONÍVEL NO NODE.JS RUNTIME.
Transfere um Blob do Azure em paralelo para uma memória intermédia. O deslocamento e a contagem são opcionais, transfere todo o blob se não forem fornecidos.
Aviso: as memórias intermédias só podem suportar ficheiros até cerca de um gigabyte em sistemas de 32 bits ou cerca de dois gigabytes em sistemas de 64 bits devido a limitações de Node.js/V8. Para blobs maiores do que este tamanho, considere downloadToFile.
function downloadToBuffer(offset?: number, count?: number, options?: BlobDownloadToBufferOptions): Promise<Buffer>
Parâmetros
- offset
-
number
A partir da posição do blob de blocos a transferir(em bytes)
- count
-
number
Quanta quantidade de dados (em bytes) a transferir. Será transferida para o fim ao passar indefinidamente
- options
- BlobDownloadToBufferOptions
BlobDownloadToBufferOptions
Devoluções
Promise<Buffer>
Herdado deBlobClient.downloadToBuffer
downloadToFile(string, number, number, BlobDownloadOptions)
APENAS DISPONÍVEL NO NODE.JS RUNTIME.
Transfere um Blob do Azure para um ficheiro local. Falha se o caminho de ficheiro especificado já sair. O deslocamento e a contagem são opcionais, passam 0 e não são definidos, respetivamente, para transferir todo o blob.
function downloadToFile(filePath: string, offset?: number, count?: number, options?: BlobDownloadOptions): Promise<BlobDownloadResponseParsed>
Parâmetros
- filePath
-
string
- offset
-
number
A partir da posição do blob de blocos a transferir.
- count
-
number
Quanta quantidade de dados a transferir. Será transferido para o fim ao passar indefinido.
- options
- BlobDownloadOptions
Opções para opções de transferência de Blobs.
Devoluções
Promise<BlobDownloadResponseParsed>
Os dados de resposta para a operação de transferência de blobs, mas com readableStreamBody definidos como indefinidos, uma vez que o respetivo conteúdo já é lido e escrito num ficheiro local no caminho especificado.
Herdado deBlobClient.downloadToFile
exists(BlobExistsOptions)
Devolve verdadeiro se o recurso de blob do Azure representado por este cliente existir; falso de outra forma.
NOTA: utilize esta função com cuidado, uma vez que um blob existente pode ser eliminado por outros clientes ou aplicações. Os novos blobs vice-versa podem ser adicionados por outros clientes ou aplicações após a conclusão desta função.
function exists(options?: BlobExistsOptions): Promise<boolean>
Parâmetros
- options
- BlobExistsOptions
opções para a operação Existe.
Devoluções
Promise<boolean>
Herdado doBlobClient.existe
generateSasUrl(BlobGenerateSasUrlOptions)
Disponível apenas para BlobClient construído com uma credencial de chave partilhada.
Gera um URI de Assinatura de Acesso Partilhado (SAS) do Serviço blob com base nas propriedades e parâmetros do cliente transmitidos. A SAS é assinada pela credencial de chave partilhada do cliente.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
function generateSasUrl(options: BlobGenerateSasUrlOptions): Promise<string>
Parâmetros
- options
- BlobGenerateSasUrlOptions
Parâmetros opcionais.
Devoluções
Promise<string>
O URI de SAS que consiste no URI para o recurso representado por este cliente, seguido do token de SAS gerado.
Herdado deBlobClient.generateSasUrl
getAppendBlobClient()
Cria um objeto AppendBlobClient.
function getAppendBlobClient(): AppendBlobClient
Devoluções
Herdado deBlobClient.getAppendBlobClient
getBlobLeaseClient(string)
Obtenha um BlobLeaseClient que gere as concessões no blob.
function getBlobLeaseClient(proposeLeaseId?: string): BlobLeaseClient
Parâmetros
- proposeLeaseId
-
string
ID de concessão proposta inicial.
Devoluções
Um novo objeto BlobLeaseClient para gerir concessões no blob.
Herdado deBlobClient.getBlobLeaseClient
getBlockBlobClient()
Cria um objeto BlockBlobClient.
function getBlockBlobClient(): BlockBlobClient
Devoluções
Herdado deBlobClient.getBlockBlobClient
getPageBlobClient()
Cria um objeto PageBlobClient.
function getPageBlobClient(): PageBlobClient
Devoluções
Herdado deBlobClient.getPageBlobClient
getProperties(BlobGetPropertiesOptions)
Devolve todos os metadados definidos pelo utilizador, propriedades HTTP padrão e propriedades do sistema para o blob. Não devolve o conteúdo do blob.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties
AVISO: o metadata
objeto devolvido na resposta terá as respetivas teclas em minúsculas, mesmo que tenham originalmente carateres em maiúsculas. Isto difere das chaves de metadados devolvidas pelos métodos containerClient que listam blobs com a opção includeMetadata
, o que irá manter o seu invólucro original.
function getProperties(options?: BlobGetPropertiesOptions): Promise<BlobGetPropertiesResponse>
Parâmetros
- options
- BlobGetPropertiesOptions
Opções opcionais para a operação Obter Propriedades.
Devoluções
Promise<BlobGetPropertiesResponse>
Herdado deBlobClient.getProperties
getTags(BlobGetTagsOptions)
Obtém as etiquetas associadas ao blob subjacente.
function getTags(options?: BlobGetTagsOptions): Promise<BlobGetTagsResponse>
Parâmetros
- options
- BlobGetTagsOptions
Devoluções
Promise<BlobGetTagsResponse>
Herdado deBlobClient.getTags
setAccessTier(string, BlobSetTierOptions)
Define a camada num blob. A operação é permitida num blob de página numa conta de armazenamento premium e num blob de blocos numa conta de armazenamento de blobs (apenas armazenamento localmente redundante). O escalão de um blob de página premium determina o tamanho permitido, o IOPS e a largura de banda do blob. A camada de um blob de blocos determina o tipo de armazenamento Frequente/Esporádico/Arquivo. Esta operação não atualiza o ETag do blob.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-tier
function setAccessTier(tier: string, options?: BlobSetTierOptions): Promise<BlobSetTierResponse>
Parâmetros
- tier
-
string
A camada a definir no blob. Os valores válidos são Frequente, Esporádico ou Arquivo.
- options
- BlobSetTierOptions
Opções opcionais para a operação de Camada de Conjunto de Blobs.
Devoluções
Promise<BlobSetTierResponse>
Herdado deBlobClient.setAccessTier
setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)
Define as propriedades do sistema no blob.
Se não for fornecido nenhum valor ou nenhum valor fornecido para os cabeçalhos HTTP de blob especificados, estes cabeçalhos HTTP de blob sem um valor serão limpos.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties
function setHTTPHeaders(blobHTTPHeaders?: BlobHTTPHeaders, options?: BlobSetHTTPHeadersOptions): Promise<BlobSetHTTPHeadersResponse>
Parâmetros
- blobHTTPHeaders
- BlobHTTPHeaders
Se não for fornecido nenhum valor ou nenhum valor fornecido para os cabeçalhos HTTP de blob especificados, estes cabeçalhos HTTP de blob sem um valor serão limpos.
Um cabeçalho comum a definir está blobContentType
a permitir que o browser forneça funcionalidades com base no tipo de ficheiro.
- options
- BlobSetHTTPHeadersOptions
Opções opcionais para a operação Definir Cabeçalhos HTTP do Blob.
Devoluções
Promise<BlobSetHTTPHeadersResponse>
Herdado deBlobClient.setHTTPHeaders
setImmutabilityPolicy(BlobImmutabilityPolicy, BlobSetImmutabilityPolicyOptions)
Defina a política de imutablilidade no blob.
function setImmutabilityPolicy(immutabilityPolicy: BlobImmutabilityPolicy, options?: BlobSetImmutabilityPolicyOptions): Promise<BlobSetImmutabilityPolicyResponse>
Parâmetros
- immutabilityPolicy
- BlobImmutabilityPolicy
- options
- BlobSetImmutabilityPolicyOptions
Opções opcionais para definir a política de imutabilidade no blob.
Devoluções
Promise<BlobSetImmutabilityPolicyResponse>
Herdado deBlobClient.setImmutabilityPolicy
setLegalHold(boolean, BlobSetLegalHoldOptions)
Defina a suspensão legal no blob.
function setLegalHold(legalHoldEnabled: boolean, options?: BlobSetLegalHoldOptions): Promise<BlobSetLegalHoldResponse>
Parâmetros
- legalHoldEnabled
-
boolean
- options
- BlobSetLegalHoldOptions
Opções opcionais para definir a suspensão legal no blob.
Devoluções
Promise<BlobSetLegalHoldResponse>
Herdado deBlobClient.setLegalHold
setMetadata(Metadata, BlobSetMetadataOptions)
Define metadados definidos pelo utilizador para o blob especificado como um ou mais pares nome-valor.
Se não for fornecida nenhuma opção ou se não forem definidos metadados no parâmetro, os metadados do blob serão removidos.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata
function setMetadata(metadata?: Metadata, options?: BlobSetMetadataOptions): Promise<BlobSetMetadataResponse>
Parâmetros
- metadata
- Metadata
Substitua os metadados existentes por este valor. Se não for fornecido nenhum valor, os metadados existentes serão removidos.
- options
- BlobSetMetadataOptions
Opções opcionais para definir a operação de Metadados.
Devoluções
Promise<BlobSetMetadataResponse>
Herdado deBlobClient.setMetadata
setTags(Tags, BlobSetTagsOptions)
Define etiquetas no blob subjacente. Um blob pode ter até 10 etiquetas. As teclas de etiqueta têm de ter entre 1 e 128 carateres. Os valores das etiquetas têm de ter entre 0 e 256 carateres. Os carateres de valor e chave de etiqueta válidos incluem letras minúsculas e maiúsculas, dígitos (0-9), espaço (' '), mais ('+'), subtração ('-'), ponto final ('.'), barra ('/'), dois pontos (':'), igual a ('=') e sublinhado ('_') .
function setTags(tags: Tags, options?: BlobSetTagsOptions): Promise<BlobSetTagsResponse>
Parâmetros
- tags
- Tags
- options
- BlobSetTagsOptions
Devoluções
Promise<BlobSetTagsResponse>
Herdado deBlobClient.setTags
syncCopyFromURL(string, BlobSyncCopyFromURLOptions)
A operação copy from URL síncrona copia um blob ou um recurso da Internet para um novo blob. Não devolverá uma resposta até que a cópia esteja concluída.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob-from-url
function syncCopyFromURL(copySource: string, options?: BlobSyncCopyFromURLOptions): Promise<BlobCopyFromURLResponse>
Parâmetros
- copySource
-
string
O URL de origem a partir do qual copiar, Assinatura de Acesso Partilhado (SAS) talvez seja necessário para autenticação
- options
- BlobSyncCopyFromURLOptions
Devoluções
Promise<BlobCopyFromURLResponse>
Herdado deBlobClient.syncCopyFromURL
undelete(BlobUndeleteOptions)
Restaura os conteúdos e metadados do blob eliminado de forma recuperável e quaisquer instantâneos de eliminação recuperável associados. O Undelete Blob só é suportado na versão 2017-07-29 ou posterior.
Veja https://docs.microsoft.com/en-us/rest/api/storageservices/undelete-blob
function undelete(options?: BlobUndeleteOptions): Promise<BlobUndeleteResponse>
Parâmetros
- options
- BlobUndeleteOptions
Opções opcionais para a operação de Eliminação de Blobs.
Devoluções
Promise<BlobUndeleteResponse>
Herdado deBlobClient.undelete
withVersion(string)
Cria um novo objeto BlobClient que aponta para uma versão deste blob. Fornecer "" removerá o versionId e devolverá um Cliente ao blob base.
function withVersion(versionId: string): BlobClient
Parâmetros
- versionId
-
string
O versionId.
Devoluções
Um novo objeto BlobClient que aponta para a versão deste blob.
Herdado deBlobClient.withVersion