Biblioteca de clientes REST do Azure OnlineExperimentation para JavaScript – versão 1.0.0-beta.1

2025-06-16

Serviço de Experimentação Online do Azure

Confie fortemente em nossos documentos de cliente REST para usar essa biblioteca

Links de chave:

código-fonte
do NPM (pacote )

Como começar

Ambientes com suporte no momento

Versões lts de Node.js

Pré-requisitos

Você deve ter uma assinatura do Azure para usar esse pacote.

Instalar o pacote `@azure-rest/onlineexperimentation`

Instale a biblioteca de clientes REST do cliente REST do Azure OnlineExperimentation para JavaScript com npm:

npm install @azure-rest/onlineexperimentation

Criar e autenticar um `OnlineExperimentationClient`

A inicialização da biblioteca de clientes da Experimentação Online do Azure requer dois parâmetros:

O endpoint valor da propriedade do Microsoft.OnlineExperimentation/workspaces recurso.
A TokenCredential para autenticação, a abordagem mais simples é usar DefaultAzureCredential a @azure/identity partir da biblioteca.

import { DefaultAzureCredential } from "@azure/identity";
import { OnlineExperimentationClient } from "@azure-rest/onlineexperimentation";

const endpoint = process.env.AZURE_ONLINEEXPERIMENTATION_ENDPOINT || "<endpoint>";
const credential = new DefaultAzureCredential();
// Initialize a client with default API version
const client = OnlineExperimentationClient(endpoint, credential);

Exemplos

Conjunto completo de exemplos que demonstram operações de API individuais.
Exemplo demonstrando o ciclo de vida do gerenciamento de métricas de experimento: TypeScript e JavaScript.

Início rápido - Inicializar métricas de experimento de cliente e lista

A inicialização da biblioteca de clientes REST do Azure OnlineExperimentation requer dois parâmetros:

O endpoint valor da propriedade do Microsoft.OnlineExperimentation/workspaces recurso.
A TokenCredential para autenticação, a abordagem mais simples é usar DefaultAzureCredential.

import { DefaultAzureCredential } from "@azure/identity";
import {
  OnlineExperimentationClient,
  isUnexpected,
  paginate,
} from "@azure-rest/onlineexperimentation";

const endpoint = process.env.AZURE_ONLINEEXPERIMENTATION_ENDPOINT || "<endpoint>";
const credential = new DefaultAzureCredential();
const client = OnlineExperimentationClient(endpoint, credential);
const listResponse = await client.path("/experiment-metrics").get({
  queryParameters: {
    top: 10,
    skip: 0,
  },
});
if (isUnexpected(listResponse)) {
  throw listResponse;
}
for await (const metric of paginate(client, listResponse)) {
  // Access metric properties
  const id = metric.id;
  const name = metric.displayName;
}

Resolução de problemas

Registro

Habilitar o registro em log pode ajudar a descobrir informações úteis sobre falhas. Para ver um log de solicitações e respostas HTTP, defina a variável de ambiente AZURE_LOG_LEVEL como info. Como alternativa, o registro em log pode ser habilitado em runtime chamando setLogLevel no @azure/logger:

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

setLogLevel("info");

Para obter instruções mais detalhadas sobre como habilitar logs, você pode examinar os documentos do pacote @azure/agente.

Compartilhar via