JavaScript için Azure Visual Studio Kaynak Sağlayıcısı istemci kitaplığı - sürüm 4.0.0-beta.2

Bu paket, Azure Visual Studio Kaynak Sağlayıcısı istemcisi için bir izomorfik SDK (hem Node.js hem de tarayıcılarda çalışır) içerir.

Azure Resource Manager aracılığıyla Visual Studio Team Services kaynaklarını yönetmek için bu API'leri kullanın. Tüm görev işlemleri HTTP/1.1 protokol belirtimine uygundur ve her bir işlem, istek hakkındaki bilgileri almak için kullanılabilen bir x-ms-request-id üst bilgisi döndürür. Bu kaynaklara gönderilen isteklerin güvenli olduğundan emin olmanız gerekir. Daha fazla bilgi için bkz. /rest/api/index.

Kaynak kodu | Paket (NPM) | API başvuru belgeleri | Örnekleri

Başlarken

Şu anda desteklenen ortamlar

• Node.jsLTS sürümleri
• Safari, Chrome, Edge ve Firefox'un en son sürümleri.

Daha fazla ayrıntı için destek ilkemize bakın.

Önkoşullar

• Bir Azure aboneliği.

@azure/arm-visualstudio paketini yükleyin

ile npmJavaScript için Azure Visual Studio Kaynak Sağlayıcısı istemci kitaplığını yükleyin:

npm install @azure/arm-visualstudio

Oluşturma ve kimlik doğrulaması VisualStudioResourceProviderClient

Azure Visual Studio Kaynak Sağlayıcısı API'sine erişmek üzere bir istemci nesnesi oluşturmak için Azure Visual Studio Kaynak Sağlayıcısı kaynağınızın ve değerinin credentialolması gerekirendpoint. Azure Visual Studio Kaynak Sağlayıcısı istemcisi kimlik doğrulaması için Azure Active Directory kimlik bilgilerini kullanabilir. Azure Visual Studio Kaynak Sağlayıcısı kaynağınızın uç noktasını Azure Portal'da bulabilirsiniz.

@azure/kimlik kitaplığından veya mevcut bir AAD Belirtecinden kimlik bilgilerini kullanarak Azure Active Directory ile kimlik doğrulaması yapabilirsiniz.

Aşağıda gösterilen DefaultAzureCredential sağlayıcısını veya Azure SDK ile sağlanan diğer kimlik bilgisi sağlayıcılarını kullanmak için lütfen paketi yükleyin @azure/identity :

npm install @azure/identity

Ayrıca hizmet sorumlunuza uygun rolü atayarak yeni bir AAD uygulaması kaydetmeniz ve Azure Visual Studio Kaynak Sağlayıcısı'na erişim vermeniz gerekir (not: gibi "Owner" roller gerekli izinleri vermez). AAD uygulamasının istemci kimliği, kiracı kimliği ve istemci gizli dizisi değerlerini ortam değişkenleri olarak ayarlayın: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Azure AD Uygulaması oluşturma hakkında daha fazla bilgi için bu kılavuzu gözden geçirin.

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 Paketi

Bu istemci kitaplığını tarayıcıda kullanmak için önce bir paketleyici kullanmanız gerekir. Bunun nasıl yapılacağının ayrıntıları için lütfen paketleme belgelerimize bakın.

Önemli kavramlar

VisualStudioResourceProviderClient

VisualStudioResourceProviderClient , Azure Visual Studio Kaynak Sağlayıcısı istemci kitaplığını kullanan geliştiriciler için birincil arabirimdir. Azure Visual Studio Kaynak Sağlayıcısı hizmetinin erişebileceğiniz farklı özelliklerini anlamak için bu istemci nesnesinde yöntemleri keşfedin.

Sorun giderme

Günlüğe Kaydetme

Günlüğe kaydetmenin etkinleştirilmesi hatalarla ilgili yararlı bilgilerin ortaya çıkarılmasına yardımcı olabilir. HTTP isteklerinin ve yanıtlarının günlüğünü görmek için ortam değişkenini AZURE_LOG_LEVEL olarak infoayarlayın. Alternatif olarak, günlüğü çalışma zamanında içinde çağrılarak setLogLevel@azure/loggeretkinleştirilebilir:

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

Günlükleri etkinleştirme hakkında daha ayrıntılı yönergeler için @azure/günlükçü paketi belgelerine bakabilirsiniz.

Sonraki adımlar

Bu kitaplığın nasıl kullanılacağına ilişkin ayrıntılı örnekler için lütfen samples dizinine göz atın.

Katkıda bulunma

Bu kitaplığa katkıda bulunmak isterseniz, kodu derleme ve test etme hakkında daha fazla bilgi edinmek için lütfen katkıda bulunma kılavuzunu okuyun.

İlgili projeler

• JavaScript için Microsoft Azure SDK