Biblioteca de cliente do Fornecedor de Recursos do Azure Visual Studio para JavaScript – versão 4.0.0-beta.2
Este pacote contém um SDK isomórfico (executado tanto no Node.js como nos browsers) para o cliente do Fornecedor de Recursos do Azure Visual Studio.
Utilize estas APIs para gerir os recursos do Visual Studio Team Services através do Resource Manager do Azure. Todas as operações de tarefas estão em conformidade com a especificação do protocolo HTTP/1.1 e cada operação devolve um cabeçalho x-ms-request-id que pode ser utilizado para obter informações sobre o pedido. Deve certificar-se de que os pedidos efetuados a estes recursos estão protegidos. Para obter mais informações, consulte /rest/api/index.
Código fonte | Pacote (NPM) | Documentação | de referência da APIExemplos
Introdução
Ambientes atualmente suportados
- Versões LTS do Node.js
- Versões mais recentes do Safari, Chrome, Edge e Firefox.
Veja a nossa política de suporte para obter mais detalhes.
Pré-requisitos
- Uma subscrição do Azure.
Instalar o pacote @azure/arm-visualstudio
Instale a biblioteca de cliente do Fornecedor de Recursos do Azure Visual Studio para JavaScript com npm
:
npm install @azure/arm-visualstudio
Criar e autenticar um VisualStudioResourceProviderClient
Para criar um objeto de cliente para aceder à API do Fornecedor de Recursos do Azure Visual Studio, precisará do recurso do Fornecedor de Recursos do endpoint
Azure Visual Studio e de um credential
. O cliente do Fornecedor de Recursos do Azure Visual Studio pode utilizar credenciais do Azure Active Directory para autenticar.
Pode encontrar o ponto final do recurso do Fornecedor de Recursos do Azure Visual Studio no Portal do Azure.
Pode autenticar com o Azure Active Directory com uma credencial da biblioteca de @azure/identidade ou de um Token do AAD existente.
Para utilizar o fornecedor DefaultAzureCredential mostrado abaixo ou outros fornecedores de credenciais fornecidos com o SDK do Azure, instale o @azure/identity
pacote:
npm install @azure/identity
Também terá de registar uma nova aplicação do AAD e conceder acesso ao Fornecedor de Recursos do Azure Visual Studio ao atribuir a função adequada ao principal de serviço (nota: funções como "Owner"
não irão conceder as permissões necessárias).
Defina os valores do ID de cliente, do ID do inquilino e do segredo do cliente da aplicação do AAD como variáveis de ambiente: AZURE_CLIENT_ID
, , AZURE_TENANT_ID
AZURE_CLIENT_SECRET
.
Para obter mais informações sobre como criar uma Aplicação Azure AD veja este guia.
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);
Pacote JavaScript
Para utilizar esta biblioteca de cliente no browser, primeiro tem de utilizar um bundler. Para obter detalhes sobre como fazê-lo, veja a nossa documentação de agrupamento.
Conceitos-chave
VisualStudioResourceProviderClient
VisualStudioResourceProviderClient
é a interface principal para programadores que utilizam a biblioteca de cliente do Fornecedor de Recursos do Azure Visual Studio. Explore os métodos neste objeto de cliente para compreender as diferentes funcionalidades do serviço Fornecedor de Recursos do Azure Visual Studio a que pode aceder.
Resolução de problemas
Registo
Ativar o registo pode ajudar a descobrir informações úteis sobre falhas. Para ver um registo de pedidos e respostas HTTP, defina a variável de AZURE_LOG_LEVEL
ambiente como info
. Em alternativa, o registo pode ser ativado no runtime ao chamar setLogLevel
no @azure/logger
:
const { setLogLevel } = require("@azure/logger");
setLogLevel("info");
Para obter instruções mais detalhadas sobre como ativar os registos, pode ver os documentos do pacote @azure/logger.
Passos seguintes
Veja o diretório de exemplos para obter exemplos detalhados sobre como utilizar esta biblioteca.
Contribuir
Se quiser contribuir para esta biblioteca, leia o guia de contribuição para saber mais sobre como criar e testar o código.
Projetos relacionados
Azure SDK for JavaScript