Megosztás a következőn keresztül:

JavaScripthez készült Azure Visual Studio erőforrás-szolgáltató ügyfélkódtár – 4.0.0-beta.2-es verzió

Ez a csomag egy izomorf SDK-t tartalmaz (Node.js és böngészőkben egyaránt fut) az Azure Visual Studio Resource Provider-ügyfélhez.

Ezekkel az API-kkal kezelheti a Visual Studio Team Services-erőforrásokat az Azure Resource Manager keresztül. Minden feladatművelet megfelel a HTTP/1.1-protokoll specifikációinak, és minden művelet egy x-ms-request-id fejléccel tér vissza, amelyből a kérelemmel kapcsolatos információ kapható. Gondoskodnia kell arról, hogy az ezekhez az erőforrásokhoz irányuló kérelmek biztonságosak legyenek. További információ: /rest/api/index.

Forráskód | Csomag (NPM) | API-referenciadokumentáció | Minták

Első lépések

Jelenleg támogatott környezetek

További részletekért tekintse meg támogatási szabályzatunkat .

Előfeltételek

Telepítse a(z) @azure/arm-visualstudio csomagot

Telepítse a JavaScripthez készült Azure Visual Studio erőforrás-szolgáltató ügyfélkódtárat a következővel npm:

npm install @azure/arm-visualstudio

Hozzon létre és hitelesítsen egy VisualStudioResourceProviderClient

Az Azure Visual Studio Erőforrás-szolgáltató API eléréséhez ügyfélobjektum létrehozásához szüksége lesz az endpoint Azure Visual Studio erőforrás-szolgáltatói erőforrására és egy credential. Az Azure Visual Studio erőforrás-szolgáltató ügyfél az Azure Active Directory hitelesítő adatait használhatja a hitelesítéshez. Az Azure Visual Studio erőforrás-szolgáltatói erőforrás végpontját az Azure Portalon találja.

Az Azure Active Directoryval hitelesítést végezhet a @azure/identitástárból vagy egy meglévő AAD-jogkivonatból származó hitelesítő adatokkal.

Az alább látható DefaultAzureCredential szolgáltató vagy az Azure SDK-hoz biztosított egyéb hitelesítőadat-szolgáltatók használatához telepítse a @azure/identity csomagot:

npm install @azure/identity

Emellett regisztrálnia kell egy új AAD-alkalmazást, és hozzáférést kell biztosítania az Azure Visual Studio erőforrás-szolgáltatójához úgy, hogy hozzárendeli a megfelelő szerepkört a szolgáltatásnévhez (megjegyzés: az olyan szerepkörök, mint például "Owner" nem biztosítják a szükséges engedélyeket). Állítsa be az AAD-alkalmazás ügyfélazonosítójának, bérlőazonosítójának és titkos ügyfélkulcsának értékeit környezeti változókként: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Az Azure AD-alkalmazások létrehozásával kapcsolatos további információkért tekintse meg ezt az útmutatót.

const { VisualStudioResourceProviderClient } = require("@azure/arm-visualstudio");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new VisualStudioResourceProviderClient(new DefaultAzureCredential(), subscriptionId);

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new VisualStudioResourceProviderClient(credential, subscriptionId);

JavaScript-csomag

Ahhoz, hogy ezt az ügyfélkódtárat a böngészőben használhassa, először egy kötegelőt kell használnia. Ennek részleteiért tekintse meg a csomagküldő dokumentációt.

Fő fogalmak

VisualStudioResourceProviderClient

VisualStudioResourceProviderClient az Azure Visual Studio erőforrás-szolgáltató ügyfélkódtárát használó fejlesztők elsődleges felülete. Az ügyfélobjektum metódusainak megismerése az Azure Visual Studio erőforrás-szolgáltató szolgáltatásának különböző funkcióinak megismeréséhez.

Hibaelhárítás

Naplózás

A naplózás engedélyezése segíthet a hibákról szóló hasznos információk feltárásában. A HTTP-kérések és válaszok naplójának megtekintéséhez állítsa a környezeti változót a AZURE_LOG_LEVEL értékre info. A naplózás futásidőben is engedélyezhető a következő hívással setLogLevel@azure/logger:

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

A naplók engedélyezésére vonatkozó részletesebb útmutatásért tekintse meg a @azure/logger csomag dokumentációt.

Következő lépések

A kódtár használatára vonatkozó részletes példákért tekintse meg a mintakönyvtárat.

Közreműködés

Ha hozzá szeretne járulni ehhez a kódtárhoz, olvassa el a közreműködői útmutatót , amelyből többet is megtudhat a kód összeállításáról és teszteléséről.

Megjelenések

  • Last updated on