Delen via

ContainerClient class

  • Referentie
Pakket:
@azure/storage-blob

Een ContainerClient vertegenwoordigt een URL naar de Azure Storage-container, zodat u de blobs kunt bewerken.

Uitbreiding

StorageClient

Constructors

ContainerClient(string, PipelineLike)

Hiermee maakt u een exemplaar van ContainerClient. Deze methode accepteert een URL die verwijst naar een container. Gecodeerde URL-tekenreeks wordt NIET tweemaal escaped, alleen speciale tekens in HET URL-pad worden escaped. Als een blobnaam de naam bevat? of %, moet de blobnaam in de URL worden gecodeerd.
ContainerClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Hiermee maakt u een exemplaar van ContainerClient. Deze methode accepteert een URL die verwijst naar een container. Gecodeerde URL-tekenreeks wordt NIET tweemaal escaped, alleen speciale tekens in HET URL-pad worden escaped. Als een blobnaam de naam bevat? of %, moet de blobnaam in de URL worden gecodeerd.
ContainerClient(string, string, StoragePipelineOptions)

Hiermee maakt u een exemplaar van ContainerClient.

Eigenschappen

containerName

De naam van de container.

Overgenomen eigenschappen

accountName
credential

Zoals AnonymousCredential, StorageSharedKeyCredential of referenties van het @azure/identity-pakket om aanvragen voor de service te verifiëren. U kunt ook een object opgeven waarmee de TokenCredential-interface wordt geïmplementeerd. Als dit niet is opgegeven, wordt AnonymousCredential gebruikt.
url

Gecodeerde URL-tekenreekswaarde.

Methoden

create(ContainerCreateOptions)

Hiermee maakt u een nieuwe container onder het opgegeven account. Als de container met dezelfde naam al bestaat, mislukt de bewerking.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/create-container Naamgevingsregels: Zie https://learn.microsoft.com/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata
createIfNotExists(ContainerCreateOptions)

Hiermee maakt u een nieuwe container onder het opgegeven account. Als de container met dezelfde naam al bestaat, wordt deze niet gewijzigd.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/create-container Naamgevingsregels: Zie https://learn.microsoft.com/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata
delete(ContainerDeleteMethodOptions)

Markeert de opgegeven container voor verwijdering. De container en eventuele blobs in de container worden later verwijderd tijdens de garbagecollection.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/delete-container
deleteBlob(string, ContainerDeleteBlobOptions)

Markeert de opgegeven blob of momentopname voor verwijdering. De blob wordt later verwijderd tijdens de garbagecollection. Als u een blob wilt verwijderen, moet u alle momentopnamen ervan verwijderen. U kunt beide tegelijk verwijderen met de bewerking Blob verwijderen.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/delete-blob
deleteIfExists(ContainerDeleteMethodOptions)

Markeert de opgegeven container voor verwijdering als deze bestaat. De container en eventuele blobs in de container worden later verwijderd tijdens de garbagecollection.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/delete-container
exists(ContainerExistsOptions)

Retourneert waar als de Azure-containerresource die wordt vertegenwoordigd door deze client bestaat; anders onwaar.

OPMERKING: gebruik deze functie met zorg omdat een bestaande container kan worden verwijderd door andere clients of toepassingen. Omgekeerd kunnen nieuwe containers met dezelfde naam worden toegevoegd door andere clients of toepassingen nadat deze functie is voltooid.
findBlobsByTags(string, ContainerFindBlobByTagsOptions)

Retourneert een asynchrone iterator om alle blobs met opgegeven tag onder de opgegeven container te vinden.

.byPage() retourneert een asynchrone iterator om de blobs in pagina's weer te geven.

Voorbeeld van for await syntaxis:

let i = 1;
for await (const blob of containerClient.findBlobsByTags("tagkey='tagvalue'")) {
  console.log(`Blob ${i++}: ${blob.name}`);
}

Voorbeeld van iter.next():

let i = 1;
const iter = containerClient.findBlobsByTags("tagkey='tagvalue'");
let blobItem = await iter.next();
while (!blobItem.done) {
  console.log(`Blob ${i++}: ${blobItem.value.name}`);
  blobItem = await iter.next();
}

Voorbeeld van byPage():

// passing optional maxPageSize in the page settings
let i = 1;
for await (const response of containerClient.findBlobsByTags("tagkey='tagvalue'").byPage({ maxPageSize: 20 })) {
  if (response.blobs) {
    for (const blob of response.blobs) {
      console.log(`Blob ${i++}: ${blob.name}`);
    }
  }
}

Voorbeeld van het gebruik van paging met een markering:

let i = 1;
let iterator = containerClient.findBlobsByTags("tagkey='tagvalue'").byPage({ maxPageSize: 2 });
let response = (await iterator.next()).value;

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

// Gets next marker
let marker = response.continuationToken;
// Passing next marker as continuationToken
iterator = containerClient
  .findBlobsByTags("tagkey='tagvalue'")
  .byPage({ continuationToken: marker, maxPageSize: 10 });
response = (await iterator.next()).value;

// Prints blob names
if (response.blobs) {
  for (const blob of response.blobs) {
     console.log(`Blob ${i++}: ${blob.name}`);
  }
}
generateSasUrl(ContainerGenerateSasUrlOptions)

Alleen beschikbaar voor ContainerClient die is samengesteld met een gedeelde sleutelreferentie.

Hiermee wordt een SAS-URI (Shared Access Signature) voor Blob Container Service gegenereerd op basis van de clienteigenschappen en parameters die zijn doorgegeven. De SAS wordt ondertekend door de gedeelde sleutelreferentie van de client.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
getAccessPolicy(ContainerGetAccessPolicyOptions)

Hiermee haalt u de machtigingen voor de opgegeven container op. De machtigingen geven aan of containergegevens openbaar toegankelijk zijn.

WAARSCHUWING: JavaScript-datum verliest mogelijk precisie bij het parseren van startsOn- en expiresOn-tekenreeksen. Nieuwe datum("2018-12-31T03:44:23.8827891Z").toISOString() krijgt bijvoorbeeld '2018-12-31T03:44:23.882Z'.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/get-container-acl
getAccountInfo(ContainerGetAccountInfoOptions)

De bewerking Accountgegevens ophalen retourneert de SKU-naam en het accounttype voor het opgegeven account. De bewerking Accountgegevens ophalen is beschikbaar in serviceversies vanaf versie 2018-03-28.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/get-account-information
getAppendBlobClient(string)

Hiermee maakt u een AppendBlobClient-
getBlobBatchClient()

Hiermee maakt u een BlobBatchClient-object om batchbewerkingen uit te voeren.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/blob-batch
getBlobClient(string)

Hiermee maakt u een BlobClient-
getBlobLeaseClient(string)

Haal een BlobLeaseClient- op waarmee leases voor de container worden beheerd.
getBlockBlobClient(string)

Hiermee maakt u een BlockBlobClient-
getPageBlobClient(string)

Hiermee maakt u een PageBlobClient-
getProperties(ContainerGetPropertiesOptions)

Retourneert alle door de gebruiker gedefinieerde metagegevens en systeemeigenschappen voor de opgegeven container. De geretourneerde gegevens bevatten niet de lijst met blobs van de container.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/get-container-properties

WAARSCHUWING: het metadata object dat in het antwoord wordt geretourneerd, bevat de sleutels in kleine letters, zelfs als ze oorspronkelijk hoofdletters bevatten. Dit verschilt van de metagegevenssleutels die worden geretourneerd door de listContainers methode van BlobServiceClient met behulp van de optie includeMetadata, waarmee de oorspronkelijke behuizing wordt behouden.
listBlobsByHierarchy(string, ContainerListBlobsOptions)

Retourneert een asynchrone iterator om alle blobs per hiërarchie weer te geven. onder het opgegeven account.

.byPage() retourneert een asynchrone iterator om de blobs per hiërarchie in pagina's weer te geven.

Voorbeeld van for await syntaxis:

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

Voorbeeld van 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}`);
  }
  entity = await iter.next();
}

Voorbeeld van 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}`);
  }
}

Voorbeeld van het gebruik van paging met een maximaal paginaformaat:

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}`);
  }
}
listBlobsFlat(ContainerListBlobsOptions)

Retourneert een asynchrone iterator om alle blobs onder het opgegeven account weer te geven.

.byPage() retourneert een asynchrone iterator om de blobs in pagina's weer te geven.

Voorbeeld van for await syntaxis:

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

Voorbeeld van 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();
}

Voorbeeld van 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}`);
  }
}

Voorbeeld van het gebruik van paging met een markering:

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)

Hiermee stelt u de machtigingen voor de opgegeven container in. De machtigingen geven aan of blobs in een container openbaar toegankelijk zijn.

Wanneer u machtigingen voor een container instelt, worden de bestaande machtigingen vervangen. Als er geen toegang of containerAcl is opgegeven, wordt de bestaande container-ACL verwijderd.

Wanneer u een opgeslagen toegangsbeleid instelt voor een container, kan het tot 30 seconden duren voordat het van kracht wordt. Tijdens dit interval mislukt een handtekening voor gedeelde toegang die is gekoppeld aan het opgeslagen toegangsbeleid met statuscode 403 (Verboden), totdat het toegangsbeleid actief wordt.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/set-container-acl
setMetadata(Metadata, ContainerSetMetadataOptions)

Hiermee stelt u een of meer door de gebruiker gedefinieerde naam-waardeparen in voor de opgegeven container.

Als er geen optie is opgegeven of als er geen metagegevens zijn gedefinieerd in de parameter, worden de metagegevens van de container verwijderd.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/set-container-metadata
uploadBlockBlob(string, RequestBodyType, number, BlockBlobUploadOptions)

Hiermee maakt u een nieuwe blok-blob of werkt u de inhoud van een bestaande blok-blob bij.

Als u een bestaande blok-blob bijwerkt, worden alle bestaande metagegevens in de blob overschreven. Gedeeltelijke updates worden niet ondersteund; de inhoud van de bestaande blob wordt overschreven met de nieuwe inhoud. Als u een gedeeltelijke update van een blok-blob wilt uitvoeren, gebruikt u stageBlock en commitBlockList.

Dit is een niet-parallelle uploadmethode. Gebruik uploadFile, uploadStream of uploadBrowserData voor betere prestaties bij gelijktijdige uploading.

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

Constructordetails

ContainerClient(string, PipelineLike)

Hiermee maakt u een exemplaar van ContainerClient. Deze methode accepteert een URL die verwijst naar een container. Gecodeerde URL-tekenreeks wordt NIET tweemaal escaped, alleen speciale tekens in HET URL-pad worden escaped. Als een blobnaam de naam bevat? of %, moet de blobnaam in de URL worden gecodeerd.

new ContainerClient(url: string, pipeline: PipelineLike)

Parameters

url

string

Een URL-tekenreeks die verwijst naar de Azure Storage-container, zoals 'https://myaccount.blob.core.windows.net/mycontainer". U kunt een SAS toevoegen als u AnonymousCredential gebruikt, zoals 'https://myaccount.blob.core.windows.net/mycontainer?sasString".

pipeline
PipelineLike

Roep newPipeline() aan om een standaardpijplijn te maken of geef een aangepaste pijplijn op.

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

Hiermee maakt u een exemplaar van ContainerClient. Deze methode accepteert een URL die verwijst naar een container. Gecodeerde URL-tekenreeks wordt NIET tweemaal escaped, alleen speciale tekens in HET URL-pad worden escaped. Als een blobnaam de naam bevat? of %, moet de blobnaam in de URL worden gecodeerd.

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

Parameters

url

string

Een URL-tekenreeks die verwijst naar de Azure Storage-container, zoals 'https://myaccount.blob.core.windows.net/mycontainer". U kunt een SAS toevoegen als u AnonymousCredential gebruikt, zoals 'https://myaccount.blob.core.windows.net/mycontainer?sasString".

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Zoals AnonymousCredential, StorageSharedKeyCredential of referenties van het @azure/identity-pakket om aanvragen voor de service te verifiëren. U kunt ook een object opgeven waarmee de TokenCredential-interface wordt geïmplementeerd. Als dit niet is opgegeven, wordt AnonymousCredential gebruikt.

options
StoragePipelineOptions

Facultatief. Opties voor het configureren van de HTTP-pijplijn.

ContainerClient(string, string, StoragePipelineOptions)

Hiermee maakt u een exemplaar van ContainerClient.

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

Parameters

connectionString

string

Verbindingsreeks voor het account of een SAS-verbindingsreeks van een Azure-opslagaccount. [ Opmerking: de verbindingsreeks van het account kan alleen worden gebruikt in NODE.JS runtime. ] Voorbeeld van accountverbindingsreeks - voorbeeld van DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net SAS-verbindingsreeks - 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

Containernaam.

options
StoragePipelineOptions

Facultatief. Opties voor het configureren van de HTTP-pijplijn.

Eigenschapdetails

containerName

De naam van de container.

string containerName

Waarde van eigenschap

string

Details van overgenomen eigenschap

accountName 

accountName: string

Waarde van eigenschap

string

overgenomen van StorageClient.accountName

credential

Zoals AnonymousCredential, StorageSharedKeyCredential of referenties van het @azure/identity-pakket om aanvragen voor de service te verifiëren. U kunt ook een object opgeven waarmee de TokenCredential-interface wordt geïmplementeerd. Als dit niet is opgegeven, wordt AnonymousCredential gebruikt.

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Waarde van eigenschap

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

overgenomen van StorageClient.credential

url

Gecodeerde URL-tekenreekswaarde.

url: string

Waarde van eigenschap

string

overgenomen van StorageClient.url

Methodedetails

create(ContainerCreateOptions)

Hiermee maakt u een nieuwe container onder het opgegeven account. Als de container met dezelfde naam al bestaat, mislukt de bewerking.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/create-container Naamgevingsregels: Zie https://learn.microsoft.com/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata

function create(options?: ContainerCreateOptions): Promise<ContainerCreateResponse>

Parameters

options
ContainerCreateOptions

Opties voor het maken van containers.

Voorbeeldgebruik:

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

Retouren

Promise<ContainerCreateResponse>

createIfNotExists(ContainerCreateOptions)

Hiermee maakt u een nieuwe container onder het opgegeven account. Als de container met dezelfde naam al bestaat, wordt deze niet gewijzigd.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/create-container Naamgevingsregels: Zie https://learn.microsoft.com/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata

function createIfNotExists(options?: ContainerCreateOptions): Promise<ContainerCreateIfNotExistsResponse>

Parameters

options
ContainerCreateOptions

Retouren

Promise<ContainerCreateIfNotExistsResponse>

delete(ContainerDeleteMethodOptions)

Markeert de opgegeven container voor verwijdering. De container en eventuele blobs in de container worden later verwijderd tijdens de garbagecollection.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/delete-container

function delete(options?: ContainerDeleteMethodOptions): Promise<ContainerDeleteResponse>

Parameters

options
ContainerDeleteMethodOptions

Opties voor de bewerking Container verwijderen.

Retouren

Promise<ContainerDeleteResponse>

deleteBlob(string, ContainerDeleteBlobOptions)

Markeert de opgegeven blob of momentopname voor verwijdering. De blob wordt later verwijderd tijdens de garbagecollection. Als u een blob wilt verwijderen, moet u alle momentopnamen ervan verwijderen. U kunt beide tegelijk verwijderen met de bewerking Blob verwijderen.

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

function deleteBlob(blobName: string, options?: ContainerDeleteBlobOptions): Promise<BlobDeleteResponse>

Parameters

blobName

string

options
ContainerDeleteBlobOptions

Opties voor de bewerking Blob Verwijderen.

Retouren

Promise<BlobDeleteResponse>

Antwoordgegevens voor het verwijderen van blobs blokkeren.

deleteIfExists(ContainerDeleteMethodOptions)

Markeert de opgegeven container voor verwijdering als deze bestaat. De container en eventuele blobs in de container worden later verwijderd tijdens de garbagecollection.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/delete-container

function deleteIfExists(options?: ContainerDeleteMethodOptions): Promise<ContainerDeleteIfExistsResponse>

Parameters

options
ContainerDeleteMethodOptions

Opties voor de bewerking Container verwijderen.

Retouren

Promise<ContainerDeleteIfExistsResponse>

exists(ContainerExistsOptions)

Retourneert waar als de Azure-containerresource die wordt vertegenwoordigd door deze client bestaat; anders onwaar.

OPMERKING: gebruik deze functie met zorg omdat een bestaande container kan worden verwijderd door andere clients of toepassingen. Omgekeerd kunnen nieuwe containers met dezelfde naam worden toegevoegd door andere clients of toepassingen nadat deze functie is voltooid.

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

Parameters

options
ContainerExistsOptions

Retouren

Promise<boolean>

findBlobsByTags(string, ContainerFindBlobByTagsOptions)

Retourneert een asynchrone iterator om alle blobs met opgegeven tag onder de opgegeven container te vinden.

.byPage() retourneert een asynchrone iterator om de blobs in pagina's weer te geven.

Voorbeeld van for await syntaxis:

let i = 1;
for await (const blob of containerClient.findBlobsByTags("tagkey='tagvalue'")) {
  console.log(`Blob ${i++}: ${blob.name}`);
}

Voorbeeld van iter.next():

let i = 1;
const iter = containerClient.findBlobsByTags("tagkey='tagvalue'");
let blobItem = await iter.next();
while (!blobItem.done) {
  console.log(`Blob ${i++}: ${blobItem.value.name}`);
  blobItem = await iter.next();
}

Voorbeeld van byPage():

// passing optional maxPageSize in the page settings
let i = 1;
for await (const response of containerClient.findBlobsByTags("tagkey='tagvalue'").byPage({ maxPageSize: 20 })) {
  if (response.blobs) {
    for (const blob of response.blobs) {
      console.log(`Blob ${i++}: ${blob.name}`);
    }
  }
}

Voorbeeld van het gebruik van paging met een markering:

let i = 1;
let iterator = containerClient.findBlobsByTags("tagkey='tagvalue'").byPage({ maxPageSize: 2 });
let response = (await iterator.next()).value;

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

// Gets next marker
let marker = response.continuationToken;
// Passing next marker as continuationToken
iterator = containerClient
  .findBlobsByTags("tagkey='tagvalue'")
  .byPage({ continuationToken: marker, maxPageSize: 10 });
response = (await iterator.next()).value;

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

function findBlobsByTags(tagFilterSqlExpression: string, options?: ContainerFindBlobByTagsOptions): PagedAsyncIterableIterator<FilterBlobItem, ContainerFindBlobsByTagsSegmentResponse, PageSettings>

Parameters

tagFilterSqlExpression

string

Met de parameter where kan de aanroeper query's uitvoeren op blobs waarvan de tags overeenkomen met een bepaalde expressie. De opgegeven expressie moet waar opleveren voor een blob die in de resultaten moet worden geretourneerd. De syntaxisregel [OData - ABNF] filter definieert de formele grammatica voor de waarde van de waar queryparameter; Er wordt echter alleen een subset van de OData-filtersyntaxis ondersteund in de Blob-service.

options
ContainerFindBlobByTagsOptions

Opties voor het zoeken van blobs op tags.

Retouren

PagedAsyncIterableIterator<FilterBlobItem, ContainerFindBlobsByTagsSegmentResponse, PageSettings>

generateSasUrl(ContainerGenerateSasUrlOptions)

Alleen beschikbaar voor ContainerClient die is samengesteld met een gedeelde sleutelreferentie.

Hiermee wordt een SAS-URI (Shared Access Signature) voor Blob Container Service gegenereerd op basis van de clienteigenschappen en parameters die zijn doorgegeven. De SAS wordt ondertekend door de gedeelde sleutelreferentie van de client.

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

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

Parameters

options
ContainerGenerateSasUrlOptions

Optionele parameters.

Retouren

Promise<string>

De SAS-URI die bestaat uit de URI voor de resource die wordt vertegenwoordigd door deze client, gevolgd door het gegenereerde SAS-token.

getAccessPolicy(ContainerGetAccessPolicyOptions)

Hiermee haalt u de machtigingen voor de opgegeven container op. De machtigingen geven aan of containergegevens openbaar toegankelijk zijn.

WAARSCHUWING: JavaScript-datum verliest mogelijk precisie bij het parseren van startsOn- en expiresOn-tekenreeksen. Nieuwe datum("2018-12-31T03:44:23.8827891Z").toISOString() krijgt bijvoorbeeld '2018-12-31T03:44:23.882Z'.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/get-container-acl

function getAccessPolicy(options?: ContainerGetAccessPolicyOptions): Promise<ContainerGetAccessPolicyResponse>

Parameters

options
ContainerGetAccessPolicyOptions

Opties voor de bewerking Toegangsbeleid voor container ophalen.

Retouren

Promise<ContainerGetAccessPolicyResponse>

getAccountInfo(ContainerGetAccountInfoOptions)

De bewerking Accountgegevens ophalen retourneert de SKU-naam en het accounttype voor het opgegeven account. De bewerking Accountgegevens ophalen is beschikbaar in serviceversies vanaf versie 2018-03-28.

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

function getAccountInfo(options?: ContainerGetAccountInfoOptions): Promise<ContainerGetAccountInfoResponse>

Parameters

options
ContainerGetAccountInfoOptions

Opties voor de bewerking Accountgegevens ophalen van service.

Retouren

Promise<ContainerGetAccountInfoResponse>

Antwoordgegevens voor de bewerking Accountgegevens ophalen van service.

getAppendBlobClient(string)

Hiermee maakt u een AppendBlobClient-

function getAppendBlobClient(blobName: string): AppendBlobClient

Parameters

blobName

string

Een toevoeg-blobnaam

Retouren

AppendBlobClient

getBlobBatchClient()

Hiermee maakt u een BlobBatchClient-object om batchbewerkingen uit te voeren.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/blob-batch

function getBlobBatchClient(): BlobBatchClient

Retouren

BlobBatchClient

Een nieuw BlobBatchClient-object voor deze container.

getBlobClient(string)

Hiermee maakt u een BlobClient-

function getBlobClient(blobName: string): BlobClient

Parameters

blobName

string

Een blobnaam

Retouren

BlobClient

Een nieuw BlobClient-object voor de opgegeven blobnaam.

getBlobLeaseClient(string)

Haal een BlobLeaseClient- op waarmee leases voor de container worden beheerd.

function getBlobLeaseClient(proposeLeaseId?: string): BlobLeaseClient

Parameters

proposeLeaseId

string

Oorspronkelijke voorgestelde lease-id.

Retouren

BlobLeaseClient

Een nieuw BlobLeaseClient-object voor het beheren van leases op de container.

getBlockBlobClient(string)

Hiermee maakt u een BlockBlobClient-

function getBlockBlobClient(blobName: string): BlockBlobClient

Parameters

blobName

string

Een blok-blobnaam

Voorbeeldgebruik:

const content = "Hello world!";

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

Retouren

BlockBlobClient

getPageBlobClient(string)

Hiermee maakt u een PageBlobClient-

function getPageBlobClient(blobName: string): PageBlobClient

Parameters

blobName

string

Een pagina-blobnaam

Retouren

PageBlobClient

getProperties(ContainerGetPropertiesOptions)

Retourneert alle door de gebruiker gedefinieerde metagegevens en systeemeigenschappen voor de opgegeven container. De geretourneerde gegevens bevatten niet de lijst met blobs van de container.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/get-container-properties

WAARSCHUWING: het metadata object dat in het antwoord wordt geretourneerd, bevat de sleutels in kleine letters, zelfs als ze oorspronkelijk hoofdletters bevatten. Dit verschilt van de metagegevenssleutels die worden geretourneerd door de listContainers methode van BlobServiceClient met behulp van de optie includeMetadata, waarmee de oorspronkelijke behuizing wordt behouden.

function getProperties(options?: ContainerGetPropertiesOptions): Promise<ContainerGetPropertiesResponse>

Parameters

options
ContainerGetPropertiesOptions

Opties voor de bewerking Eigenschappen ophalen van container.

Retouren

Promise<ContainerGetPropertiesResponse>

listBlobsByHierarchy(string, ContainerListBlobsOptions)

Retourneert een asynchrone iterator om alle blobs per hiërarchie weer te geven. onder het opgegeven account.

.byPage() retourneert een asynchrone iterator om de blobs per hiërarchie in pagina's weer te geven.

Voorbeeld van for await syntaxis:

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

Voorbeeld van 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}`);
  }
  entity = await iter.next();
}

Voorbeeld van 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}`);
  }
}

Voorbeeld van het gebruik van paging met een maximaal paginaformaat:

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

function listBlobsByHierarchy(delimiter: string, options?: ContainerListBlobsOptions): PagedAsyncIterableIterator<({ kind: "prefix" } & BlobPrefix) | ({ kind: "blob" } & BlobItem), ContainerListBlobHierarchySegmentResponse, PageSettings>

Parameters

delimiter

string

Het teken of de tekenreeks die wordt gebruikt om de virtuele hiërarchie te definiëren

options
ContainerListBlobsOptions

Opties voor het weergeven van een blobs-bewerking.

Retouren

PagedAsyncIterableIterator<({ kind: "prefix" } & BlobPrefix) | ({ kind: "blob" } & BlobItem), ContainerListBlobHierarchySegmentResponse, PageSettings>

listBlobsFlat(ContainerListBlobsOptions)

Retourneert een asynchrone iterator om alle blobs onder het opgegeven account weer te geven.

.byPage() retourneert een asynchrone iterator om de blobs in pagina's weer te geven.

Voorbeeld van for await syntaxis:

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

Voorbeeld van 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();
}

Voorbeeld van 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}`);
  }
}

Voorbeeld van het gebruik van paging met een markering:

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): PagedAsyncIterableIterator<BlobItem, ContainerListBlobFlatSegmentResponse, PageSettings>

Parameters

options
ContainerListBlobsOptions

Opties voor het weergeven van blobs.

Retouren

PagedAsyncIterableIterator<BlobItem, ContainerListBlobFlatSegmentResponse, PageSettings>

Een asyncIterableIterator die paging ondersteunt.

setAccessPolicy(PublicAccessType, SignedIdentifier[], ContainerSetAccessPolicyOptions)

Hiermee stelt u de machtigingen voor de opgegeven container in. De machtigingen geven aan of blobs in een container openbaar toegankelijk zijn.

Wanneer u machtigingen voor een container instelt, worden de bestaande machtigingen vervangen. Als er geen toegang of containerAcl is opgegeven, wordt de bestaande container-ACL verwijderd.

Wanneer u een opgeslagen toegangsbeleid instelt voor een container, kan het tot 30 seconden duren voordat het van kracht wordt. Tijdens dit interval mislukt een handtekening voor gedeelde toegang die is gekoppeld aan het opgeslagen toegangsbeleid met statuscode 403 (Verboden), totdat het toegangsbeleid actief wordt.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/set-container-acl

function setAccessPolicy(access?: PublicAccessType, containerAcl?: SignedIdentifier[], options?: ContainerSetAccessPolicyOptions): Promise<ContainerSetAccessPolicyResponse>

Parameters

access
PublicAccessType

Het niveau van openbare toegang tot gegevens in de container.

containerAcl

SignedIdentifier[]

Matrix van elementen met elk een unieke id en details van het toegangsbeleid.

options
ContainerSetAccessPolicyOptions

Opties voor de bewerking Toegangsbeleid instellen voor containers.

Retouren

Promise<ContainerSetAccessPolicyResponse>

setMetadata(Metadata, ContainerSetMetadataOptions)

Hiermee stelt u een of meer door de gebruiker gedefinieerde naam-waardeparen in voor de opgegeven container.

Als er geen optie is opgegeven of als er geen metagegevens zijn gedefinieerd in de parameter, worden de metagegevens van de container verwijderd.

Zie https://docs.microsoft.com/en-us/rest/api/storageservices/set-container-metadata

function setMetadata(metadata?: Metadata, options?: ContainerSetMetadataOptions): Promise<ContainerSetMetadataResponse>

Parameters

metadata
Metadata

Vervang bestaande metagegevens door deze waarde. Als er geen waarde is opgegeven, worden de bestaande metagegevens verwijderd.

options
ContainerSetMetadataOptions

Opties voor de bewerking Metagegevens van containerset.

Retouren

Promise<ContainerSetMetadataResponse>

uploadBlockBlob(string, RequestBodyType, number, BlockBlobUploadOptions)

Hiermee maakt u een nieuwe blok-blob of werkt u de inhoud van een bestaande blok-blob bij.

Als u een bestaande blok-blob bijwerkt, worden alle bestaande metagegevens in de blob overschreven. Gedeeltelijke updates worden niet ondersteund; de inhoud van de bestaande blob wordt overschreven met de nieuwe inhoud. Als u een gedeeltelijke update van een blok-blob wilt uitvoeren, gebruikt u stageBlock en commitBlockList.

Dit is een niet-parallelle uploadmethode. Gebruik uploadFile, uploadStream of uploadBrowserData voor betere prestaties bij gelijktijdige uploading.

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

function uploadBlockBlob(blobName: string, body: RequestBodyType, contentLength: number, options?: BlockBlobUploadOptions): Promise<{ blockBlobClient: BlockBlobClient, response: BlockBlobUploadResponse }>

Parameters

blobName

string

Naam van de blok-blob die u wilt maken of bijwerken.

body
HttpRequestBody

Blob, tekenreeks, ArrayBuffer, ArrayBufferView of een functie die een nieuwe leesbare stroom retourneert waarvan de offset afkomstig is van het begin van de gegevensbron.

contentLength

number

Lengte van hoofdtekst in bytes. Gebruik Buffer.byteLength() om de lengte van de hoofdtekst te berekenen voor een tekenreeks, inclusief niet-Base64/Hex-gecodeerde tekens.

options
BlockBlobUploadOptions

Opties voor het configureren van de bewerking Uploaden van blok-blobs.

Retouren

Promise<{ blockBlobClient: BlockBlobClient, response: BlockBlobUploadResponse }>

Antwoordgegevens voor het uploaden van blok-blob en het bijbehorende BlockBlobClient-exemplaar.