Biblioteca cliente Azure ConnectedCache para JavaScript - versão 1.0.0

Esse pacote contém um SDK isomórfico (executado em Node.js e em navegadores) para o cliente Azure ConnectedCache.

Microsoft Connected Cache Rest Api versão 2023-05-01-preview

Links principais:

Como começar

Ambientes com suporte no momento

Veja nossa política suporte para mais detalhes.

Pré-requisitos

Instalar o pacote @azure/arm-connectedcache

Instale a biblioteca de clientes do Azure ConnectedCache para JavaScript com npm:

npm install @azure/arm-connectedcache

Criar e autenticar um ConnectedCacheClient

Para criar um objeto cliente para acessar a API do Azure ConnectedCache, você precisará do endpoint do recurso do Azure ConnectedCache e de um credential. O cliente Azure ConnectedCache pode usar credenciais do Azure Active Directory para autenticar. Você pode encontrar o ponto de extremidade do recurso Azure ConnectedCache nodo Portal do Azure .

Você pode autenticar com Azure Active Directory usando uma credencial da biblioteca @azure/identity ou um Token AAD existente.

Para usar o provedor DefaultAzureCredential mostrado abaixo, ou outros provedores de credenciais fornecidos com o SDK do Azure, por favor, instale o pacote @azure/identity:

npm install @azure/identity

Você também precisará registrar um novo aplicativo do AAD e conceder acesso ao Azure ConnectedCache atribuindo a função adequada à entidade de serviço (observação: funções como "Owner" não concederão as permissões necessárias). Defina os valores da ID do cliente, da ID do locatário e do segredo do cliente do aplicativo AAD como variáveis de ambiente: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

Para mais informações sobre como criar um aplicativo de AD Azure, confira este guia.

Usando ambientes semelhantes a Node.js e nó, você pode usar a classe DefaultAzureCredential para autenticar o cliente.

import { ConnectedCacheClient } from "@azure/arm-connectedcache";
import { DefaultAzureCredential } from "@azure/identity";

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

Para ambientes de navegador, use o InteractiveBrowserCredential do pacote @azure/identity para autenticar.

import { InteractiveBrowserCredential } from "@azure/identity";
import { ConnectedCacheClient } from "@azure/arm-connectedcache";

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new ConnectedCacheClient(credential, subscriptionId);

Pacote JavaScript

Para usar essa biblioteca de clientes no navegador, primeiro você precisa usar um empacotador. Para obter detalhes sobre como fazer isso, consulte nossa documentação de agrupamento.

Conceitos principais

ConnectedCacheClient

ConnectedCacheClient é a interface principal para desenvolvedores que usam a biblioteca de clientes do Azure ConnectedCache. Explore os métodos neste objeto cliente para entender os diferentes recursos do serviço Azure ConnectedCache que você pode acessar.

Solução de problemas

Registro em log

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 consultar os documentos do pacote @azure/logger.

Contributing

Se você quiser contribuir para esta biblioteca, por favor leia o guia contribuição para saber mais sobre como construir e testar o código.