Azure Marketplace client library for JavaScript - versie 1.0.0

Dit pakket bevat een isomorfe SDK (draait zowel in Node.js als in browsers) voor de Azure Marketplace-client.

REST API's voor Private Marketplace

Sleutelkoppelingen:

Aan de slag

Momenteel ondersteunde omgevingen

Zie ons ondersteuningsbeleid voor meer informatie.

Prerequisites

Het @azure/arm-marketplace-pakket installeren

Installeer de Azure Marketplace-clientbibliotheek voor JavaScript met npm:

npm install @azure/arm-marketplace

Een MarketplaceClient maken en verifiëren

Om een clientobject te maken dat toegang krijgt tot de Azure Marketplace API, heb je de endpoint van je Azure Marketplace-resource en een credential. De Azure Marketplace-client kan Azure Active Directory-inloggegevens gebruiken om te authenticeren. Je kunt het eindpunt voor je Azure Marketplace-resource vinden in de Azure Portal.

Je kunt je authenticeren bij Azure Active Directory met een inloggegevens uit de bibliotheek @azure/identity of een bestaande AAD Token.

Als u de DefaultAzureCredential- provider wilt gebruiken die hieronder wordt weergegeven, of andere referentieproviders die zijn opgegeven bij de Azure SDK, installeert u het @azure/identity-pakket:

npm install @azure/identity

Je moet ook een nieuwe AAD-applicatie registreren en toegang verlenen tot Azure Marketplace door de geschikte rol toe te wijzen aan je serviceprincipe (let op: rollen zoals "Owner" geven niet de benodigde rechten).

Voor meer informatie over hoe je een Azure AD-applicatie maakt, kijk dan op deze gids.

Met Node.js- en Node-achtige omgevingen kunt u de DefaultAzureCredential-klasse gebruiken om de client te verifiëren.

import { MarketplaceClient } from "@azure/arm-marketplace";
import { DefaultAzureCredential } from "@azure/identity";

const client = new MarketplaceClient(new DefaultAzureCredential());

Gebruik voor browseromgevingen de InteractiveBrowserCredential uit het @azure/identity-pakket om te verifiëren.

import { InteractiveBrowserCredential } from "@azure/identity";
import { MarketplaceClient } from "@azure/arm-marketplace";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new MarketplaceClient(credential);

JavaScript-bundel

Als u deze clientbibliotheek in de browser wilt gebruiken, moet u eerst een bundelaar gebruiken. Raadpleeg onze bundeldocumentatievoor meer informatie over hoe u dit doet.

belangrijke concepten

MarktplaatsClient

MarketplaceClient is de primaire interface voor ontwikkelaars die de Azure Marketplace-clientbibliotheek gebruiken. Verken de methoden op dit clientobject om de verschillende functies van de Azure Marketplace-dienst te begrijpen waar je toegang toe hebt.

Troubleshooting

Logging

Het inschakelen van logboekregistratie kan helpen nuttige informatie over fouten te ontdekken. Als u een logboek met HTTP-aanvragen en -antwoorden wilt zien, stelt u de omgevingsvariabele AZURE_LOG_LEVEL in op info. U kunt logboekregistratie ook tijdens runtime inschakelen door setLogLevel aan te roepen in de @azure/logger:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

Voor meer gedetailleerde instructies over het inschakelen van logboeken, kunt u de @azure/logger pakketdocumentenbekijken.

Volgende stappen 

Bekijk de voorbeelden map voor gedetailleerde voorbeelden over het gebruik van deze bibliotheek.

Contributing

Als u een bijdrage wilt leveren aan deze bibliotheek, leest u de gids voor bijdragen voor meer informatie over het bouwen en testen van de code.