Condividi tramite

ContainerClient class

  • Riferimento
Pacchetto:
@azure/storage-blob

ContainerClient rappresenta un URL del contenitore di Archiviazione di Azure che consente di modificare i BLOB.

Extends
StorageClient

Costruttori

ContainerClient(string, PipelineLike)

Crea un'istanza di ContainerClient. Questo metodo accetta un URL che punta a un contenitore. La stringa URL codificata non verrà eliminata due volte, verranno escape solo caratteri speciali nel percorso URL. Se un nome BLOB include ? o %, il nome del BLOB deve essere codificato nell'URL.
ContainerClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Crea un'istanza di ContainerClient. Questo metodo accetta un URL che punta a un contenitore. La stringa URL codificata non verrà eliminata due volte, verranno escape solo caratteri speciali nel percorso URL. Se un nome BLOB include ? o %, il nome del BLOB deve essere codificato nell'URL.
ContainerClient(string, string, StoragePipelineOptions)

Crea un'istanza di ContainerClient.

Proprietà

accountName
containerName

Nome del contenitore.
credential

Ad esempio AnonymousCredential, StorageSharedKeyCredential o qualsiasi credenziale del @azure/identity pacchetto per autenticare le richieste al servizio. È anche possibile fornire un oggetto che implementa l'interfaccia TokenCredential. Se non specificato, viene utilizzato AnonymousCredential.
url

Valore stringa URL codificato.

Metodi

create(ContainerCreateOptions)

Crea un nuovo contenitore nell'account specificato. Se un contenitore con lo stesso nome esiste già, l'operazione ha esito negativo.
createIfNotExists(ContainerCreateOptions)

Crea un nuovo contenitore nell'account specificato. Se il contenitore con lo stesso nome esiste già, non viene modificato.
delete(ContainerDeleteMethodOptions)

Contrassegna il contenitore specificato per l'eliminazione. Il contenitore e tutti i BLOB in esso contenuti verranno eliminati in seguito durante un'operazione di Garbage Collection.
deleteBlob(string, ContainerDeleteBlobOptions)

Contrassegna il BLOB o lo snapshot specificati per l'eliminazione. Il Blob verrà eliminato in seguito durante un'operazione di Garbage Collection. Si noti che per eliminare un Blob, è necessario eliminare tutti i relativi snapshot. È possibile eliminare entrambi contemporaneamente con l'operazione Elimina BLOB.
deleteIfExists(ContainerDeleteMethodOptions)

Contrassegna il contenitore specificato per l'eliminazione se esiste. Il contenitore e tutti i BLOB in esso contenuti verranno eliminati in seguito durante un'operazione di Garbage Collection.
exists(ContainerExistsOptions)

Restituisce true se la risorsa del contenitore di Azure rappresentata da questo client esiste; false in caso contrario. NOTA: usare questa funzione con cura poiché un contenitore esistente potrebbe essere eliminato da altri client o applicazioni. Viceversa nuovi contenitori con lo stesso nome potrebbero essere aggiunti da altri client o applicazioni dopo il completamento di questa funzione.
generateSasUrl(ContainerGenerateSasUrlOptions)

Disponibile solo per ContainerClient costruito con una credenziale di chiave condivisa. Genera un URI di firma di accesso condiviso del servizio BLOB in base alle proprietà e ai parametri client passati. La firma di accesso condiviso viene firmata dalla credenziale della chiave condivisa del client.
getAccessPolicy(ContainerGetAccessPolicyOptions)

Ottiene le autorizzazioni per il contenitore specificato. Le autorizzazioni indicano se i dati del contenitore sono accessibili pubblicamente. AVVISO: la data JavaScript perderà potenzialmente la precisione durante l'analisi di startsOn e la scadenza delle stringhe. Ad esempio, new Date("2018-12-31T03:44:23.8827891Z").toISOString() otterrà "2018-12-31T03:44:23.882Z".
getAppendBlobClient(string)

Crea un oggetto <xref:AppendBlobClient>
getBlobBatchClient()

Crea un oggetto BlobBatchClient per eseguire operazioni batch.
getBlobClient(string)

Crea un oggetto <xref:BlobClient>
getBlobLeaseClient(string)

Ottenere un oggetto <xref:BlobLeaseClient> che gestisce i lease nel contenitore.
getBlockBlobClient(string)

Crea un oggetto <xref:BlockBlobClient>
getPageBlobClient(string)

Crea un oggetto <xref:PageBlobClient>
getProperties(ContainerGetPropertiesOptions)

Restituisce tutti i metadati definiti dall'utente e le proprietà di sistema per il contenitore specificato. I dati restituiti non includono l'elenco di BLOB del contenitore.
listBlobsByHierarchy(string, ContainerListBlobsOptions)

Restituisce un iteratore iteratore iteratore asincrono per elencare tutti i BLOB in base alla gerarchia. nell'account specificato. .byPage() restituisce un iteratore iteratore iteratore asincrono per elencare i BLOB in base alla gerarchia nelle pagine.

Esempio di uso for await della sintassi:

for await (const item of containerClient.listBlobsByHierarchy("/")) {
  if (item.kind === "prefix") {
    console.log(`\tBlobPrefix: ${item.name}`);
  } else {
    console.log(`\tBlobItem: name - ${item.name}, last modified - ${item.properties.lastModified}`);
  }
}

Esempio con iter.next():

let iter = containerClient.listBlobsByHierarchy("/", { prefix: "prefix1/" });
let entity = await iter.next();
while (!entity.done) {
  let item = entity.value;
  if (item.kind === "prefix") {
    console.log(`\tBlobPrefix: ${item.name}`);
  } else {
    console.log(`\tBlobItem: name - ${item.name}, last modified - ${item.properties.lastModified}`);
  }
  entity = await iter.next();
}

Esempio con byPage():

console.log("Listing blobs by hierarchy by page");
for await (const response of containerClient.listBlobsByHierarchy("/").byPage()) {
  const segment = response.segment;
  if (segment.blobPrefixes) {
    for (const prefix of segment.blobPrefixes) {
      console.log(`\tBlobPrefix: ${prefix.name}`);
    }
  }
  for (const blob of response.segment.blobItems) {
    console.log(`\tBlobItem: name - ${blob.name}, last modified - ${blob.properties.lastModified}`);
  }
}

Esempio di uso del paging con dimensioni massime della pagina:

console.log("Listing blobs by hierarchy by page, specifying a prefix and a max page size");

let i = 1;
for await (const response of containerClient.listBlobsByHierarchy("/", { prefix: "prefix2/sub1/"}).byPage({ maxPageSize: 2 })) {
  console.log(`Page ${i++}`);
  const segment = response.segment;

  if (segment.blobPrefixes) {
    for (const prefix of segment.blobPrefixes) {
      console.log(`\tBlobPrefix: ${prefix.name}`);
    }
  }

  for (const blob of response.segment.blobItems) {
    console.log(`\tBlobItem: name - ${blob.name}, last modified - ${blob.properties.lastModified}`);
  }
}
listBlobsFlat(ContainerListBlobsOptions)

Restituisce un iteratore iteratore iteratore asincrono per elencare tutti i BLOB nell'account specificato. .byPage() restituisce un iteratore iteratore iterabile asincrono per elencare i BLOB nelle pagine.

Esempio di uso for await della sintassi:

// Get the containerClient before you run these snippets,
// Can be obtained from `blobServiceClient.getContainerClient("<your-container-name>");`
let i = 1;
for await (const blob of containerClient.listBlobsFlat()) {
  console.log(`Blob ${i++}: ${blob.name}`);
}

Esempio con iter.next():

let i = 1;
let iter = containerClient.listBlobsFlat();
let blobItem = await iter.next();
while (!blobItem.done) {
  console.log(`Blob ${i++}: ${blobItem.value.name}`);
  blobItem = await iter.next();
}

Esempio con byPage():

// passing optional maxPageSize in the page settings
let i = 1;
for await (const response of containerClient.listBlobsFlat().byPage({ maxPageSize: 20 })) {
  for (const blob of response.segment.blobItems) {
    console.log(`Blob ${i++}: ${blob.name}`);
  }
}

Esempio di uso del paging con un marcatore:

let i = 1;
let iterator = containerClient.listBlobsFlat().byPage({ maxPageSize: 2 });
let response = (await iterator.next()).value;

// Prints 2 blob names
for (const blob of response.segment.blobItems) {
  console.log(`Blob ${i++}: ${blob.name}`);
}

// Gets next marker
let marker = response.continuationToken;

// Passing next marker as continuationToken

iterator = containerClient.listBlobsFlat().byPage({ continuationToken: marker, maxPageSize: 10 });
response = (await iterator.next()).value;

// Prints 10 blob names
for (const blob of response.segment.blobItems) {
  console.log(`Blob ${i++}: ${blob.name}`);
}
setAccessPolicy(PublicAccessType, SignedIdentifier[], ContainerSetAccessPolicyOptions)

Imposta le autorizzazioni per il contenitore specificato. Le autorizzazioni indicano se i BLOB di un contenitore sono accessibili pubblicamente. Quando si impostano le autorizzazioni per un contenitore, le autorizzazioni esistenti vengono sostituite. Se non viene fornito alcun accesso o contenitoreAcl, l'ACL del contenitore esistente verrà rimosso.

La creazione di un criterio di accesso archiviato in un contenitore potrebbe richiedere fino a 30 secondi. Durante questo intervallo una firma di accesso condiviso associata ai criteri di accesso archiviati avrà esito negativo e verrà restituito il codice di stato 403 (Accesso negato), finché il criterio non risulterà attivo.
setMetadata(Metadata, ContainerSetMetadataOptions)

Imposta una o più coppie nome-valore definite dall'utente per il contenitore specificato. Se non è stata specificata alcuna opzione o nessun metadato definito nel parametro, i metadati del contenitore verranno rimossi.
uploadBlockBlob(string, HttpRequestBody, number, BlockBlobUploadOptions)

Crea un nuovo BLOB in blocchi o aggiorna il contenuto di un BLOB in blocchi esistente. L'aggiornamento di un Blob in blocchi esistente comporta la sovrascrittura dei metadati esistenti nel Blob. Gli aggiornamenti parziali non sono supportati; il contenuto del BLOB esistente viene sovrascritto con il nuovo contenuto. Per eseguire un aggiornamento parziale di un BLOB in blocchi, usare <xref:BlockBlobClient.stageBlock> e <xref:BlockBlobClient.commitBlockList>.

Si tratta di un metodo di caricamento non parallelo, usare <xref:BlockBlobClient.uploadFile><xref:BlockBlobClient.uploadStream> o <xref:BlockBlobClient.uploadBrowserData> per ottenere prestazioni migliori con il caricamento della concorrenza.

Dettagli costruttore

ContainerClient(string, PipelineLike)

Crea un'istanza di ContainerClient. Questo metodo accetta un URL che punta a un contenitore. La stringa URL codificata non verrà eliminata due volte, verranno escape solo caratteri speciali nel percorso URL. Se un nome BLOB include ? o %, il nome del BLOB deve essere codificato nell'URL.

new ContainerClient(url: string, pipeline: PipelineLike)

Parametri

url

string

Stringa URL che punta al contenitore di archiviazione di Azure, ad esempio "https://myaccount.blob.core.windows.net/mycontainer". È possibile aggiungere una firma di accesso condiviso se si usa AnonymousCredential, ad esempio "https://myaccount.blob.core.windows.net/mycontainer?sasString".

pipeline
PipelineLike

Chiamare newPipeline() per creare una pipeline predefinita o fornire una pipeline personalizzata.

ContainerClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Crea un'istanza di ContainerClient. Questo metodo accetta un URL che punta a un contenitore. La stringa URL codificata non verrà eliminata due volte, verranno escape solo caratteri speciali nel percorso URL. Se un nome BLOB include ? o %, il nome del BLOB deve essere codificato nell'URL.

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

Parametri

url

string

Stringa URL che punta al contenitore di archiviazione di Azure, ad esempio "https://myaccount.blob.core.windows.net/mycontainer". È possibile aggiungere una firma di accesso condiviso se si usa AnonymousCredential, ad esempio "https://myaccount.blob.core.windows.net/mycontainer?sasString".

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Ad esempio AnonymousCredential, StorageSharedKeyCredential o qualsiasi credenziale del @azure/identity pacchetto per autenticare le richieste al servizio. È anche possibile fornire un oggetto che implementa l'interfaccia TokenCredential. Se non specificato, viene usata AnonymousCredential.

options
StoragePipelineOptions

Facoltativa. Opzioni per configurare la pipeline HTTP.

ContainerClient(string, string, StoragePipelineOptions)

Crea un'istanza di ContainerClient.

new ContainerClient(connectionString: string, containerName: string, options?: StoragePipelineOptions)

Parametri

connectionString

string

Stringa di connessione dell'account o stringa di connessione SAS di un account di archiviazione di Azure. [ Nota : la stringa di connessione dell'account può essere usata solo nel runtime di NODE.JS. ] Esempio di stringa di connessione account -DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net Esempio di stringa di connessione 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 del contenitore.

options
StoragePipelineOptions

Facoltativa. Opzioni per configurare la pipeline HTTP.

Dettagli proprietà

accountName 

accountName: string

Valore della proprietà

string

containerName

Nome del contenitore.

string containerName

Valore della proprietà

string

credential

Ad esempio AnonymousCredential, StorageSharedKeyCredential o qualsiasi credenziale del @azure/identity pacchetto per autenticare le richieste al servizio. È anche possibile fornire un oggetto che implementa l'interfaccia TokenCredential. Se non specificato, viene utilizzato AnonymousCredential.

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Valore della proprietà

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

url

Valore stringa URL codificato.

url: string

Valore della proprietà

string

Dettagli metodo

create(ContainerCreateOptions)

Crea un nuovo contenitore nell'account specificato. Se un contenitore con lo stesso nome esiste già, l'operazione ha esito negativo.

function create(options?: ContainerCreateOptions)

Parametri

options
ContainerCreateOptions

Opzioni per l'operazione Crea contenitore.

Esempio di utilizzo:

const containerClient = blobServiceClient.getContainerClient("<container name>");
const createContainerResponse = await containerClient.create();
console.log("Container was created successfully", createContainerResponse.requestId);

Restituisce

Promise<ContainerCreateResponse>

createIfNotExists(ContainerCreateOptions)

Crea un nuovo contenitore nell'account specificato. Se il contenitore con lo stesso nome esiste già, non viene modificato.

function createIfNotExists(options?: ContainerCreateOptions)

Parametri

options
ContainerCreateOptions

Restituisce

Promise<ContainerCreateIfNotExistsResponse>

delete(ContainerDeleteMethodOptions)

Contrassegna il contenitore specificato per l'eliminazione. Il contenitore e tutti i BLOB in esso contenuti verranno eliminati in seguito durante un'operazione di Garbage Collection.

function delete(options?: ContainerDeleteMethodOptions)

Parametri

options
ContainerDeleteMethodOptions

Opzioni per l'operazione Eliminazione contenitore.

Restituisce

Promise<ContainerDeleteResponse>

deleteBlob(string, ContainerDeleteBlobOptions)

Contrassegna il BLOB o lo snapshot specificati per l'eliminazione. Il Blob verrà eliminato in seguito durante un'operazione di Garbage Collection. Si noti che per eliminare un Blob, è necessario eliminare tutti i relativi snapshot. È possibile eliminare entrambi contemporaneamente con l'operazione Elimina BLOB.

function deleteBlob(blobName: string, options?: ContainerDeleteBlobOptions)

Parametri

blobName

string

options
ContainerDeleteBlobOptions

Opzioni per l'operazione di eliminazione BLOB.

Restituisce

Promise<BlobDeleteResponse>

Bloccare i dati di risposta all'eliminazione BLOB.

deleteIfExists(ContainerDeleteMethodOptions)

Contrassegna il contenitore specificato per l'eliminazione se esiste. Il contenitore e tutti i BLOB in esso contenuti verranno eliminati in seguito durante un'operazione di Garbage Collection.

function deleteIfExists(options?: ContainerDeleteMethodOptions)

Parametri

options
ContainerDeleteMethodOptions

Opzioni per l'operazione Eliminazione contenitore.

Restituisce

Promise<ContainerDeleteIfExistsResponse>

exists(ContainerExistsOptions)

Restituisce true se la risorsa del contenitore di Azure rappresentata da questo client esiste; false in caso contrario. NOTA: usare questa funzione con cura poiché un contenitore esistente potrebbe essere eliminato da altri client o applicazioni. Viceversa nuovi contenitori con lo stesso nome potrebbero essere aggiunti da altri client o applicazioni dopo il completamento di questa funzione.

function exists(options?: ContainerExistsOptions)

Parametri

options
ContainerExistsOptions

Restituisce

Promise<boolean>

generateSasUrl(ContainerGenerateSasUrlOptions)

Disponibile solo per ContainerClient costruito con una credenziale di chiave condivisa. Genera un URI di firma di accesso condiviso del servizio BLOB in base alle proprietà e ai parametri client passati. La firma di accesso condiviso viene firmata dalla credenziale della chiave condivisa del client.

function generateSasUrl(options: ContainerGenerateSasUrlOptions)

Parametri

options
ContainerGenerateSasUrlOptions

Parametri facoltativi.

Restituisce

Promise<string>

URI di firma di accesso condiviso costituito dall'URI alla risorsa rappresentata da questo client, seguito dal token di firma di accesso condiviso generato.

getAccessPolicy(ContainerGetAccessPolicyOptions)

Ottiene le autorizzazioni per il contenitore specificato. Le autorizzazioni indicano se i dati del contenitore sono accessibili pubblicamente. AVVISO: la data JavaScript perderà potenzialmente la precisione durante l'analisi di startsOn e la scadenza delle stringhe. Ad esempio, new Date("2018-12-31T03:44:23.8827891Z").toISOString() otterrà "2018-12-31T03:44:23.882Z".

function getAccessPolicy(options?: ContainerGetAccessPolicyOptions)

Parametri

options
ContainerGetAccessPolicyOptions

Opzioni per l'operazione Get Access Policy del contenitore.

Restituisce

Promise<ContainerGetAccessPolicyResponse>

getAppendBlobClient(string)

Crea un oggetto <xref:AppendBlobClient>

function getAppendBlobClient(blobName: string)

Parametri

blobName

string

Nome del BLOB di accodamento

Restituisce

AppendBlobClient

getBlobBatchClient()

Crea un oggetto BlobBatchClient per eseguire operazioni batch.

function getBlobBatchClient()

Restituisce

BlobBatchClient

Nuovo oggetto BlobBatchClient per questo contenitore.

getBlobClient(string)

Crea un oggetto <xref:BlobClient>

function getBlobClient(blobName: string)

Parametri

blobName

string

Nome di UN BLOB

Restituisce

BlobClient

Nuovo oggetto BlobClient per il nome del BLOB specificato.

getBlobLeaseClient(string)

Ottenere un oggetto <xref:BlobLeaseClient> che gestisce i lease nel contenitore.

function getBlobLeaseClient(proposeLeaseId?: string)

Parametri

proposeLeaseId

string

ID lease proposto iniziale.

Restituisce

BlobLeaseClient

Nuovo oggetto BlobLeaseClient per la gestione dei lease nel contenitore.

getBlockBlobClient(string)

Crea un oggetto <xref:BlockBlobClient>

function getBlockBlobClient(blobName: string)

Parametri

blobName

string

Un nome BLOB in blocchi

Esempio di utilizzo:

const content = "Hello world!";

const blockBlobClient = containerClient.getBlockBlobClient("<blob name>");
const uploadBlobResponse = await blockBlobClient.upload(content, content.length);

Restituisce

BlockBlobClient

getPageBlobClient(string)

Crea un oggetto <xref:PageBlobClient>

function getPageBlobClient(blobName: string)

Parametri

blobName

string

Un nome BLOB di pagine

Restituisce

PageBlobClient

getProperties(ContainerGetPropertiesOptions)

Restituisce tutti i metadati definiti dall'utente e le proprietà di sistema per il contenitore specificato. I dati restituiti non includono l'elenco di BLOB del contenitore.

function getProperties(options?: ContainerGetPropertiesOptions)

Parametri

options
ContainerGetPropertiesOptions

Opzioni per l'operazione Get Properties del contenitore.

Restituisce

Promise<ContainerGetPropertiesResponse>

listBlobsByHierarchy(string, ContainerListBlobsOptions)

Restituisce un iteratore iteratore iteratore asincrono per elencare tutti i BLOB in base alla gerarchia. nell'account specificato. .byPage() restituisce un iteratore iteratore iteratore asincrono per elencare i BLOB in base alla gerarchia nelle pagine.

Esempio di uso for await della sintassi:

for await (const item of containerClient.listBlobsByHierarchy("/")) {
  if (item.kind === "prefix") {
    console.log(`\tBlobPrefix: ${item.name}`);
  } else {
    console.log(`\tBlobItem: name - ${item.name}, last modified - ${item.properties.lastModified}`);
  }
}

Esempio con iter.next():

let iter = containerClient.listBlobsByHierarchy("/", { prefix: "prefix1/" });
let entity = await iter.next();
while (!entity.done) {
  let item = entity.value;
  if (item.kind === "prefix") {
    console.log(`\tBlobPrefix: ${item.name}`);
  } else {
    console.log(`\tBlobItem: name - ${item.name}, last modified - ${item.properties.lastModified}`);
  }
  entity = await iter.next();
}

Esempio con byPage():

console.log("Listing blobs by hierarchy by page");
for await (const response of containerClient.listBlobsByHierarchy("/").byPage()) {
  const segment = response.segment;
  if (segment.blobPrefixes) {
    for (const prefix of segment.blobPrefixes) {
      console.log(`\tBlobPrefix: ${prefix.name}`);
    }
  }
  for (const blob of response.segment.blobItems) {
    console.log(`\tBlobItem: name - ${blob.name}, last modified - ${blob.properties.lastModified}`);
  }
}

Esempio di uso del paging con dimensioni massime della pagina:

console.log("Listing blobs by hierarchy by page, specifying a prefix and a max page size");

let i = 1;
for await (const response of containerClient.listBlobsByHierarchy("/", { prefix: "prefix2/sub1/"}).byPage({ maxPageSize: 2 })) {
  console.log(`Page ${i++}`);
  const segment = response.segment;

  if (segment.blobPrefixes) {
    for (const prefix of segment.blobPrefixes) {
      console.log(`\tBlobPrefix: ${prefix.name}`);
    }
  }

  for (const blob of response.segment.blobItems) {
    console.log(`\tBlobItem: name - ${blob.name}, last modified - ${blob.properties.lastModified}`);
  }
}

function listBlobsByHierarchy(delimiter: string, options?: ContainerListBlobsOptions)

Parametri

delimiter

string

Carattere o stringa utilizzata per definire la gerarchia virtuale

options
ContainerListBlobsOptions

Opzioni per elencare l'operazione blob.

Restituisce

PagedAsyncIterableIterator<Object & BlobPrefix | Object & BlobItem, ContainerListBlobHierarchySegmentResponse>

listBlobsFlat(ContainerListBlobsOptions)

Restituisce un iteratore iteratore iteratore asincrono per elencare tutti i BLOB nell'account specificato. .byPage() restituisce un iteratore iteratore iterabile asincrono per elencare i BLOB nelle pagine.

Esempio di uso for await della sintassi:

// Get the containerClient before you run these snippets,
// Can be obtained from `blobServiceClient.getContainerClient("<your-container-name>");`
let i = 1;
for await (const blob of containerClient.listBlobsFlat()) {
  console.log(`Blob ${i++}: ${blob.name}`);
}

Esempio con iter.next():

let i = 1;
let iter = containerClient.listBlobsFlat();
let blobItem = await iter.next();
while (!blobItem.done) {
  console.log(`Blob ${i++}: ${blobItem.value.name}`);
  blobItem = await iter.next();
}

Esempio con byPage():

// passing optional maxPageSize in the page settings
let i = 1;
for await (const response of containerClient.listBlobsFlat().byPage({ maxPageSize: 20 })) {
  for (const blob of response.segment.blobItems) {
    console.log(`Blob ${i++}: ${blob.name}`);
  }
}

Esempio di uso del paging con un marcatore:

let i = 1;
let iterator = containerClient.listBlobsFlat().byPage({ maxPageSize: 2 });
let response = (await iterator.next()).value;

// Prints 2 blob names
for (const blob of response.segment.blobItems) {
  console.log(`Blob ${i++}: ${blob.name}`);
}

// Gets next marker
let marker = response.continuationToken;

// Passing next marker as continuationToken

iterator = containerClient.listBlobsFlat().byPage({ continuationToken: marker, maxPageSize: 10 });
response = (await iterator.next()).value;

// Prints 10 blob names
for (const blob of response.segment.blobItems) {
  console.log(`Blob ${i++}: ${blob.name}`);
}

function listBlobsFlat(options?: ContainerListBlobsOptions)

Parametri

options
ContainerListBlobsOptions

Opzioni per elencare i BLOB.

Restituisce

PagedAsyncIterableIterator<BlobItem, ContainerListBlobFlatSegmentResponse>

AsyncIterableIterator che supporta il paging.

setAccessPolicy(PublicAccessType, SignedIdentifier[], ContainerSetAccessPolicyOptions)

Imposta le autorizzazioni per il contenitore specificato. Le autorizzazioni indicano se i BLOB di un contenitore sono accessibili pubblicamente. Quando si impostano le autorizzazioni per un contenitore, le autorizzazioni esistenti vengono sostituite. Se non viene fornito alcun accesso o contenitoreAcl, l'ACL del contenitore esistente verrà rimosso.

La creazione di un criterio di accesso archiviato in un contenitore potrebbe richiedere fino a 30 secondi. Durante questo intervallo una firma di accesso condiviso associata ai criteri di accesso archiviati avrà esito negativo e verrà restituito il codice di stato 403 (Accesso negato), finché il criterio non risulterà attivo.

function setAccessPolicy(access?: PublicAccessType, containerAcl?: SignedIdentifier[], options?: ContainerSetAccessPolicyOptions)

Parametri

access
PublicAccessType

Livello di accesso pubblico ai dati nel contenitore.

containerAcl

SignedIdentifier[]

Matrice di elementi che hanno un ID univoco e i dettagli dei criteri di accesso.

options
ContainerSetAccessPolicyOptions

Opzioni per l'operazione Imposta criteri di accesso del contenitore.

Restituisce

Promise<ContainerSetAccessPolicyResponse>

setMetadata(Metadata, ContainerSetMetadataOptions)

Imposta una o più coppie nome-valore definite dall'utente per il contenitore specificato. Se non è stata specificata alcuna opzione o nessun metadato definito nel parametro, i metadati del contenitore verranno rimossi.

function setMetadata(metadata?: Metadata, options?: ContainerSetMetadataOptions)

Parametri

metadata
Metadata

Sostituire i metadati esistenti con questo valore. Se non viene specificato alcun valore, i metadati esistenti verranno rimossi.

options
ContainerSetMetadataOptions

Opzioni per l'operazione Imposta metadati del contenitore.

Restituisce

Promise<ContainerSetMetadataResponse>

uploadBlockBlob(string, HttpRequestBody, number, BlockBlobUploadOptions)

Crea un nuovo BLOB in blocchi o aggiorna il contenuto di un BLOB in blocchi esistente. L'aggiornamento di un Blob in blocchi esistente comporta la sovrascrittura dei metadati esistenti nel Blob. Gli aggiornamenti parziali non sono supportati; il contenuto del BLOB esistente viene sovrascritto con il nuovo contenuto. Per eseguire un aggiornamento parziale di un BLOB in blocchi, usare <xref:BlockBlobClient.stageBlock> e <xref:BlockBlobClient.commitBlockList>.

Si tratta di un metodo di caricamento non parallelo, usare <xref:BlockBlobClient.uploadFile><xref:BlockBlobClient.uploadStream> o <xref:BlockBlobClient.uploadBrowserData> per ottenere prestazioni migliori con il caricamento della concorrenza.

function uploadBlockBlob(blobName: string, body: HttpRequestBody, contentLength: number, options?: BlockBlobUploadOptions)

Parametri

blobName

string

Nome del BLOB in blocchi da creare o aggiornare.

body

HttpRequestBody

BLOB, string, ArrayBuffer, ArrayBufferView o una funzione che restituisce un nuovo flusso leggibile il cui offset proviene dall'origine dati.

contentLength

number

Lunghezza del corpo in byte. Usare Buffer.byteLength() per calcolare la lunghezza del corpo per una stringa, inclusi caratteri non con codifica Base64/Hex.

options
BlockBlobUploadOptions

Opzioni per configurare l'operazione di caricamento BLOB in blocchi.

Restituisce

Promise<Object>

Block Blob upload response data and the corrispondente BlockBlobClient instance.Block Blob upload response data and the corrispondente BlockBlobClient instance.