Blobcontainers vermelden met JavaScript of TypeScript

• .NET
• Java
• JavaScript
• Python
• Go

Wanneer u de containers in een Azure Storage-account uit uw code weergeeft, kunt u verschillende opties opgeven om te beheren hoe resultaten worden geretourneerd vanuit Azure Storage. In dit artikel wordt beschreven hoe u containers weergeeft met behulp van de Azure Storage-clientbibliotheek voor JavaScript.

Vereisten

• In de voorbeelden in dit artikel wordt ervan uitgegaan dat u al een project hebt ingesteld voor gebruik met de Azure Blob Storage-clientbibliotheek voor JavaScript. Zie Aan de slag met Azure Blob Storage en JavaScript voor meer informatie over het instellen van uw project, inclusief pakketinstallatie, het importeren van modules en het maken van een geautoriseerd clientobject voor gebruik met gegevensbronnen.
• Het autorisatiemechanisme moet machtigingen hebben om blobcontainers weer te geven. Zie de autorisatierichtlijnen voor de volgende REST API-bewerking voor meer informatie:
  • Containers vermelden

Over opties voor containervermelding

Wanneer u containers uit uw code opgeeft, kunt u opties opgeven om te beheren hoe resultaten worden geretourneerd vanuit Azure Storage. U kunt het aantal resultaten opgeven dat moet worden geretourneerd in elke set resultaten en vervolgens de volgende sets ophalen. U kunt de resultaten ook filteren op een voorvoegsel en containermetagegevens retourneren met de resultaten. Deze opties worden beschreven in de volgende secties.

Als u containers in uw opslagaccount wilt weergeven, roept u de volgende methode aan:

• BlobServiceClient.listContainers

Met deze methode wordt een lijst met ContainerItem-objecten geretourneerd. Containers worden lexicografisch gesorteerd op naam.

Beheren hoeveel resultaten worden geretourneerd

Standaard retourneert een vermeldingsbewerking maximaal 5000 resultaten tegelijk, maar u kunt het aantal resultaten opgeven dat elke vermeldingsbewerking moet retourneren. De voorbeelden in dit artikel laten zien hoe u resultaten op pagina's kunt retourneren.

Resultaten filteren met een voorvoegsel

Als u de lijst met containers wilt filteren, geeft u een tekenreeks op voor de prefix parameter in ServiceListContainersOptions. De tekenreeks voor het voorvoegsel kan een of meer tekens bevatten. Azure Storage retourneert vervolgens alleen de containers waarvan de namen beginnen met dat voorvoegsel.

Containermetagegevens opnemen

Als u containermetagegevens wilt opnemen met de resultaten, stelt u de includeMetadata parameter true in op ServiceListContainersOptions. Azure Storage bevat metagegevens voor elke container die wordt geretourneerd, zodat u de containermetagegevens niet afzonderlijk hoeft op te halen.

Verwijderde containers opnemen

Als u voorlopig verwijderde containers wilt opnemen met de resultaten, stelt u de includeDeleted parameter in ServiceListContainersOptions in.

Codevoorbeeld: Containers vermelden

In het volgende voorbeeld worden asynchroon de containers in een opslagaccount weergegeven die beginnen met een opgegeven voorvoegsel. Het voorbeeld bevat containers die beginnen met het opgegeven voorvoegsel en retourneert het opgegeven aantal resultaten per aanroep naar de vermeldingsbewerking. Vervolgens wordt het vervolgtoken gebruikt om het volgende segment met resultaten op te halen. Het voorbeeld retourneert ook containermetagegevens met de resultaten.

JavaScript

async function listContainers(blobServiceClient, containerNamePrefix) {

  const options = {
    includeDeleted: false,
    includeMetadata: true,
    includeSystem: true,
    prefix: containerNamePrefix
  }

  console.log("Containers (by page):");
  for await (const response of blobServiceClient.listContainers(options).byPage({
    maxPageSize: 20,
  })) {
    console.log("- Page:");
    if (response.containerItems) {
      for (const container of response.containerItems) {
        console.log(`  - ${container.name}`);
      }
    }
  }
}

TypeScript

// return up to 5000 containers
async function listContainers(
  blobServiceClient: BlobServiceClient,
  containerNamePrefix: string
): Promise<void> {
  
  const options: ServiceListContainersOptions = {
    includeDeleted: false,
    includeMetadata: true,
    includeSystem: true,
    prefix: containerNamePrefix
  };

  console.log("Containers (by page):");
  for await (const response of blobServiceClient.listContainers().byPage({
    maxPageSize: 20,
  })) {
    console.log("- Page:");
    if (response.containerItems) {
      for (const container of response.containerItems) {
        console.log(`  - ${container.name}`);
      }
    }
  }
}

Resources

Zie de volgende resources voor meer informatie over het weergeven van containers met behulp van de Azure Blob Storage-clientbibliotheek voor JavaScript.

REST API-bewerkingen

De Azure SDK voor JavaScript bevat bibliotheken die zijn gebaseerd op de Azure REST API, zodat u kunt communiceren met REST API-bewerkingen via bekende JavaScript-paradigma's. De clientbibliotheekmethoden voor het weergeven van containers gebruiken de volgende REST API-bewerking:

• Containers (REST API) vermelden

Codevoorbeelden

• Voorbeelden van JavaScript- en TypeScript-code weergeven uit dit artikel (GitHub)

Clientbibliotheekbronnen

• Referentiedocumentatie voor clientbibliotheek
• Broncode van clientbibliotheek
• Package (npm)

Zie ook

• Blob-resources inventariseren

Clientbibliotheekbronnen

• Referentiedocumentatie voor clientbibliotheek
• Broncode van clientbibliotheek
• Package (npm)