AppendBlobClient class

Crea una instancia de AppendBlobClient. Este método acepta una dirección URL codificada o una dirección URL no codificada que apunta a un blob anexado. La cadena de dirección URL codificada NO se escapará dos veces, solo se escaparán los caracteres especiales de la ruta de acceso de dirección URL. Si un nombre de blob incluye ? o %, el nombre del blob debe estar codificado en la dirección URL.

new AppendBlobClient(url: string, pipeline: PipelineLike)

Parámetros

Crea una instancia de AppendBlobClient. Este método acepta una dirección URL codificada o una dirección URL no codificada que apunta a un blob anexado. La cadena de dirección URL codificada NO se escapará dos veces, solo se escaparán los caracteres especiales de la ruta de acceso de dirección URL. Si un nombre de blob incluye ? o %, el nombre del blob debe estar codificado en la dirección URL.

new AppendBlobClient(url: string, credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)

Parámetros

Crea una instancia de AppendBlobClient.

new AppendBlobClient(connectionString: string, containerName: string, blobName: string, options?: StoragePipelineOptions)

Parámetros

Nombre del contenedor de almacenamiento al que está asociado el blob.

string containerName

Valor de propiedad

Nombre del blob.

string name

Valor de propiedad

accountName: string

Valor de propiedad

heredado deblobClient.accountName

Por ejemplo, AnonymousCredential, StorageSharedKeyCredential o cualquier credencial del paquete de @azure/identity para autenticar las solicitudes al servicio. También puede proporcionar un objeto que implemente la interfaz TokenCredential. Si no se especifica, se usa AnonymousCredential.

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Valor de propiedad

heredado deblobClient.credential

Valor de cadena de dirección URL codificada.

url: string

Valor de propiedad

heredado deblobClient.url

Confirma un nuevo bloque de datos al final del blob en anexos existente.

Consulte https://docs.microsoft.com/rest/api/storageservices/append-block

function appendBlock(body: RequestBodyType, contentLength: number, options?: AppendBlobAppendBlockOptions): Promise<AppendBlobAppendBlockResponse>

Parámetros

const content = "Hello World!";

// Create a new append blob and append data to the blob.
const newAppendBlobClient = containerClient.getAppendBlobClient("<blob name>");
await newAppendBlobClient.create();
await newAppendBlobClient.appendBlock(content, content.length);

// Append data to an existing append blob.
const existingAppendBlobClient = containerClient.getAppendBlobClient("<blob name>");
await existingAppendBlobClient.appendBlock(content, content.length);

Devoluciones

La operación Append Block confirma un nuevo bloque de datos al final de un blob anexado existente donde el contenido se lee desde una dirección URL de origen.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/append-block-from-url

function appendBlockFromURL(sourceURL: string, sourceOffset: number, count: number, options?: AppendBlobAppendBlockFromURLOptions): Promise<AppendBlobAppendBlockFromUrlResponse>

Parámetros

Devoluciones

Crea un blob anexado de 0 longitudes. Llame a AppendBlock para anexar datos a un blob en anexos.

Consulte https://docs.microsoft.com/rest/api/storageservices/put-blob

function create(options?: AppendBlobCreateOptions): Promise<AppendBlobCreateResponse>

Parámetros

const appendBlobClient = containerClient.getAppendBlobClient("<blob name>");
await appendBlobClient.create();

Devoluciones

Crea un blob anexado de 0 longitudes. Llame a AppendBlock para anexar datos a un blob en anexos. Si el blob con el mismo nombre ya existe, el contenido del blob existente permanecerá sin cambios.

Consulte https://docs.microsoft.com/rest/api/storageservices/put-blob

function createIfNotExists(options?: AppendBlobCreateIfNotExistsOptions): Promise<AppendBlobCreateIfNotExistsResponse>

Parámetros

Devoluciones

Sella el blob en anexos, lo que hace que sea de solo lectura.

function seal(options?: AppendBlobSealOptions): Promise<AppendBlobAppendBlockResponse>

Parámetros

Devoluciones

Crea un nuevo objeto AppendBlobClient idéntico al origen, pero con la marca de tiempo de instantánea especificada. Proporcione "" quitará la instantánea y devolverá un cliente al blob base.

function withSnapshot(snapshot: string): AppendBlobClient

Parámetros

Devoluciones

Nuevo objeto AppendBlobClient idéntico al origen, pero con la marca de tiempo de instantánea especificada.

Anula una operación de copia asincrónica pendiente de blob y deja un blob de destino con una longitud cero y metadatos completos. Versión 2012-02-12 y posteriores.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/abort-copy-blob

function abortCopyFromURL(copyId: string, options?: BlobAbortCopyFromURLOptions): Promise<BlobAbortCopyFromURLResponse>

Parámetros

Devoluciones

heredado deBlobClient.abortCopyFromURL

Copia de forma asincrónica un blob en un destino dentro de la cuenta de almacenamiento. Este método devuelve un sondeo de operación de larga duración que permite esperar indefinidamente hasta que se complete la copia. También puede cancelar una copia antes de que se complete llamando a cancelOperation en el sondeo. Tenga en cuenta que la devolución de llamada onProgress no se invocará si la operación se completa en la primera solicitud y si se intenta cancelar una copia completada, se producirá un error.

En la versión 2012-02-12 y versiones posteriores, el origen de una operación de copia de blobs puede ser un blob confirmado en cualquier cuenta de Azure Storage. A partir de la versión 2015-02-21, el origen de una operación de copia de blobs puede ser un archivo de Azure en cualquier cuenta de Azure Storage. Solo las cuentas de almacenamiento creadas el 7 de junio de 2012 solo permiten que la operación Copiar blob se copie desde otra cuenta de almacenamiento.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob

Ejemplo de uso del sondeo automático:

const copyPoller = await blobClient.beginCopyFromURL('url');
const result = await copyPoller.pollUntilDone();

Ejemplo de uso del sondeo manual:

const copyPoller = await blobClient.beginCopyFromURL('url');
while (!poller.isDone()) {
   await poller.poll();
}
const result = copyPoller.getResult();

Ejemplo de uso de actualizaciones de progreso:

const copyPoller = await blobClient.beginCopyFromURL('url', {
  onProgress(state) {
    console.log(`Progress: ${state.copyProgress}`);
  }
});
const result = await copyPoller.pollUntilDone();

Ejemplo con un intervalo de sondeo cambiante (valor predeterminado de 15 segundos):

const copyPoller = await blobClient.beginCopyFromURL('url', {
  intervalInMs: 1000 // poll blob every 1 second for copy progress
});
const result = await copyPoller.pollUntilDone();

Ejemplo de uso de la cancelación de copia:

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

Devoluciones

heredado deBlobClient.beginCopyFromURL

Crea una instantánea de solo lectura de un blob.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/snapshot-blob

function createSnapshot(options?: BlobCreateSnapshotOptions): Promise<BlobCreateSnapshotResponse>

Parámetros

Devoluciones

Heredado deBlobClient.createSnapshot

Marca el blob o la instantánea especificados para su eliminación. El blob se elimina más adelante durante la recolección de elementos no utilizados. Tenga en cuenta que para eliminar un blob, debe eliminar todas sus instantáneas. Puede eliminar ambos al mismo tiempo con la operación Eliminar blob.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob

function delete(options?: BlobDeleteOptions): Promise<BlobDeleteResponse>

Parámetros

Devoluciones

Heredado deBlobClient.delete

Marca el blob o la instantánea especificados para su eliminación si existe. El blob se elimina más adelante durante la recolección de elementos no utilizados. Tenga en cuenta que para eliminar un blob, debe eliminar todas sus instantáneas. Puede eliminar ambos al mismo tiempo con la operación Eliminar blob.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob

function deleteIfExists(options?: BlobDeleteOptions): Promise<BlobDeleteIfExistsResponse>

Parámetros

Devoluciones

Heredado deBlobClient.deleteIfExists

Elimine la directiva de immutablility en el blob.

function deleteImmutabilityPolicy(options?: BlobDeleteImmutabilityPolicyOptions): Promise<BlobDeleteImmutabilityPolicyResponse>

Parámetros

Devoluciones

Heredado deBlobClient.deleteImmutabilityPolicy

Lee o descarga un blob del sistema, incluidos sus metadatos y propiedades. También puede llamar a Get Blob para leer una instantánea.

• En Node.js, los datos devuelven en una secuencia legibleStreamBody legible
• En los exploradores, los datos se devuelven en un blobBody de promesa

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob

function download(offset?: number, count?: number, options?: BlobDownloadOptions): Promise<BlobDownloadResponseParsed>

Parámetros

// 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);
});
}

// 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);
  });
}

Devoluciones

heredado deBlobClient.download

SOLO ESTÁ DISPONIBLE EN NODE.JS RUNTIME.

Descarga un blob de Azure en paralelo a un búfer. El desplazamiento y el recuento son opcionales, descarga todo el blob si no se proporcionan.

Advertencia: los búferes solo pueden admitir archivos de hasta un gigabyte en sistemas de 32 bits o aproximadamente dos gigabytes en sistemas de 64 bits debido a limitaciones de Node.js/V8. En el caso de los blobs de mayor tamaño, considere la posibilidad de downloadToFile.

function downloadToBuffer(buffer: Buffer, offset?: number, count?: number, options?: BlobDownloadToBufferOptions): Promise<Buffer>

Parámetros

Devoluciones

heredado deBlobClient.downloadToBuffer

SOLO ESTÁ DISPONIBLE EN NODE.JS RUNTIME.

Descarga un blob de Azure en paralelo a un búfer. El desplazamiento y el recuento son opcionales, descarga todo el blob si no se proporcionan.

Advertencia: los búferes solo pueden admitir archivos de hasta un gigabyte en sistemas de 32 bits o aproximadamente dos gigabytes en sistemas de 64 bits debido a limitaciones de Node.js/V8. En el caso de los blobs de mayor tamaño, considere la posibilidad de downloadToFile.

function downloadToBuffer(offset?: number, count?: number, options?: BlobDownloadToBufferOptions): Promise<Buffer>

Parámetros

Devoluciones

heredado deBlobClient.downloadToBuffer

SOLO ESTÁ DISPONIBLE EN NODE.JS RUNTIME.

Descarga un blob de Azure en un archivo local. Se produce un error si la ruta de acceso del archivo especificada ya se cierra. El desplazamiento y el recuento son opcionales, pasan 0 y sin definir respectivamente para descargar todo el blob.

function downloadToFile(filePath: string, offset?: number, count?: number, options?: BlobDownloadOptions): Promise<BlobDownloadResponseParsed>

Parámetros

Devoluciones

Los datos de respuesta para la operación de descarga de blobs, pero con readableStreamBody establecido en indefinido, ya que su contenido ya está leído y escrito en un archivo local en la ruta de acceso especificada.

Heredado deBlobClient.downloadToFile

Devuelve true si el recurso de blob de Azure representado por este cliente existe; False en caso contrario.

NOTA: Use esta función con cuidado, ya que otros clientes o aplicaciones pueden eliminar un blob existente. Viceversa, es posible que otros clientes o aplicaciones agreguen nuevos blobs después de que se complete esta función.

function exists(options?: BlobExistsOptions): Promise<boolean>

Parámetros

Devoluciones

heredado deBlobClient.exists

Solo está disponible para BlobClient construido con una credencial de clave compartida.

Genera un URI de firma de acceso compartido (SAS) de Blob Service basado en las propiedades y parámetros del cliente pasados. La SAS está firmada por la credencial de clave compartida del cliente.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas

function generateSasUrl(options: BlobGenerateSasUrlOptions): Promise<string>

Parámetros

Devoluciones

El URI de SAS que consta del URI del recurso representado por este cliente, seguido del token de SAS generado.

Heredado deBlobClient.generateSasUrl

La operación Obtener información de la cuenta devuelve el nombre de SKU y el tipo de cuenta de la cuenta especificada. La operación Obtener información de la cuenta está disponible en las versiones de servicio a partir de la versión 2018-03-28.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/get-account-information

function getAccountInfo(options?: BlobGetAccountInfoOptions): Promise<BlobGetAccountInfoResponse>

Parámetros

Devoluciones

Datos de respuesta para la operación Obtener información de la cuenta de servicio.

heredado deBlobClient.getAccountInfo

Crea un objeto AppendBlobClient.

function getAppendBlobClient(): AppendBlobClient

Devoluciones

Heredado deBlobClient.getAppendBlobClient

Obtenga un BlobLeaseClient que administre concesiones en el blob.

function getBlobLeaseClient(proposeLeaseId?: string): BlobLeaseClient

Parámetros

Devoluciones

Nuevo objeto BlobLeaseClient para administrar concesiones en el blob.

Heredado deBlobClient.getBlobLeaseClient

Crea un objeto BlockBlobClient.

function getBlockBlobClient(): BlockBlobClient

Devoluciones

Heredado deBlobClient.getBlockBlobClient

Crea un objeto PageBlobClient.

function getPageBlobClient(): PageBlobClient

Devoluciones

Heredado deBlobClient.getPageBlobClient

Devuelve todos los metadatos definidos por el usuario, las propiedades HTTP estándar y las propiedades del sistema para el blob. No devuelve el contenido del blob.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties

ADVERTENCIA: El objeto metadata devuelto en la respuesta tendrá sus claves en minúsculas, incluso si originalmente contenían caracteres en mayúsculas. Esto difiere de las claves de metadatos devueltas por los métodos de ContainerClient que enumeran blobs mediante la opción includeMetadata, que conservará su mayúscula y minúscula original.

function getProperties(options?: BlobGetPropertiesOptions): Promise<BlobGetPropertiesResponse>

Parámetros

Devoluciones

heredado deBlobClient.getProperties

Obtiene las etiquetas asociadas al blob subyacente.

function getTags(options?: BlobGetTagsOptions): Promise<BlobGetTagsResponse>

Parámetros

Devoluciones

heredado deBlobClient.getTags

Establece el nivel en un blob. La operación se permite en un blob en páginas en una cuenta de Premium Storage y en un blob en bloques en una cuenta de almacenamiento de blobs (solo almacenamiento con redundancia local). El nivel de un blob en páginas Premium determina el tamaño permitido, las IOPS y el ancho de banda del blob. El nivel de un blob en bloques determina el tipo de almacenamiento de acceso frecuente, esporádico o de archivo. Esta operación no actualiza la etiqueta ETag del blob.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-tier

function setAccessTier(tier: string, options?: BlobSetTierOptions): Promise<BlobSetTierResponse>

Parámetros

Devoluciones

Heredado deBlobClient.setAccessTier

Establece las propiedades del sistema en el blob.

Si no se proporciona ningún valor o ningún valor proporcionado para los encabezados HTTP de blob especificados, estos encabezados HTTP de blob sin un valor se borrarán.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties

function setHTTPHeaders(blobHTTPHeaders?: BlobHTTPHeaders, options?: BlobSetHTTPHeadersOptions): Promise<BlobSetHTTPHeadersResponse>

Parámetros

Devoluciones

Heredado deBlobClient.setHTTPHeaders

Establezca la directiva de inmutabilidad en el blob.

function setImmutabilityPolicy(immutabilityPolicy: BlobImmutabilityPolicy, options?: BlobSetImmutabilityPolicyOptions): Promise<BlobSetImmutabilityPolicyResponse>

Parámetros

Devoluciones

Heredado deBlobClient.setImmutabilityPolicy

Establezca la suspensión legal en el blob.

function setLegalHold(legalHoldEnabled: boolean, options?: BlobSetLegalHoldOptions): Promise<BlobSetLegalHoldResponse>

Parámetros

Devoluciones

Heredado deBlobClient.setLegalHold

Establece los metadatos definidos por el usuario para el blob especificado como uno o varios pares nombre-valor.

Si no se proporciona ninguna opción o ningún metadato definido en el parámetro , se quitarán los metadatos del blob.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata

function setMetadata(metadata?: Metadata, options?: BlobSetMetadataOptions): Promise<BlobSetMetadataResponse>

Parámetros

Devoluciones

heredado deblobClient.setMetadata

Establece etiquetas en el blob subyacente. Un blob puede tener hasta 10 etiquetas. Las claves de etiqueta deben tener entre 1 y 128 caracteres. Los valores de etiqueta deben tener entre 0 y 256 caracteres. Los caracteres válidos de clave y valor incluyen letras minúsculas y mayúsculas, dígitos (0-9), espacio (' '), más ('+'), menos ('-'), punto ('.'), barra diagonal ('/'), dos puntos (':'), iguales ('=') y subrayado bajo ('_') .

function setTags(tags: Tags, options?: BlobSetTagsOptions): Promise<BlobSetTagsResponse>

Parámetros

Devoluciones

Heredado deBlobClient.setTags

La operación Copy From URL sincrónica copia un blob o un recurso de Internet en un nuevo blob. No devolverá una respuesta hasta que se complete la copia.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/copy-blob-from-url

function syncCopyFromURL(copySource: string, options?: BlobSyncCopyFromURLOptions): Promise<BlobCopyFromURLResponse>

Parámetros

Devoluciones

heredado deblobClient.syncCopyFromURL

Restaura el contenido y los metadatos del blob eliminado temporalmente y las instantáneas eliminadas temporalmente asociadas. Undelete Blob solo se admite en la versión 2017-07-29 o posterior.

Consulte https://docs.microsoft.com/en-us/rest/api/storageservices/undelete-blob

function undelete(options?: BlobUndeleteOptions): Promise<BlobUndeleteResponse>

Parámetros

Devoluciones

heredado deblobClient.undelete

Crea un nuevo objeto BlobClient que apunta a una versión de este blob. Proporcione "" quitará el versionId y devolverá un cliente al blob base.

function withVersion(versionId: string): BlobClient

Parámetros

Devoluciones

Nuevo objeto BlobClient que apunta a la versión de este blob.

Heredado deBlobClient.withVersion