Azure Subscription client library for JavaScript - versión 3.0.0

Este paquete contiene un SDK isomórfico (se ejecuta tanto en Node.js como en exploradores) para el cliente de suscripción de Azure.

Vínculos clave:

Cómo empezar

Entornos admitidos actualmente

Consulte nuestra de directiva de soporte técnico de para obtener más información.

Prerequisites

Instalación del paquete @azure/arm-resources-subscriptions

Instale la biblioteca cliente de suscripción de Azure para JavaScript con npm:

npm install @azure/arm-resources-subscriptions

Creación y autenticación de un SubscriptionClient

Para crear un objeto de cliente para acceder a la API de suscripción de Azure, necesitará el endpoint recurso de suscripción de Azure y un credentialarchivo . El cliente de suscripción de Azure puede usar credenciales de Azure Active Directory para autenticarse. Puede encontrar el punto de conexión del recurso de suscripción de Azure en Azure Portal.

Puedes autenticarte con Azure Active Directory usando una credencial de la biblioteca @azure/identity o un token AAD existente.

Para utilizar el proveedor DefaultAzureCredential que se muestra a continuación, u otros proveedores de credenciales proporcionados con el SDK de Azure, por favor instale el paquete @azure/identity:

npm install @azure/identity

También deberá registrar una nueva aplicación de AAD y conceder acceso a la suscripción de Azure asignando el rol adecuado a la entidad de servicio (nota: los roles no "Owner" concederán los permisos necesarios).

Para más información sobre cómo crear una aplicación de AD Azure, consulta esta guía.

Con Node.js y entornos similares a nodos, puede usar la clase DefaultAzureCredential para autenticar al cliente.

import { SubscriptionClient } from "@azure/arm-resources-subscriptions";
import { DefaultAzureCredential } from "@azure/identity";

const client = new SubscriptionClient(new DefaultAzureCredential());

En el caso de los entornos del explorador, use el InteractiveBrowserCredential del paquete de @azure/identity para autenticarse.

import { InteractiveBrowserCredential } from "@azure/identity";
import { SubscriptionClient } from "@azure/arm-resources-subscriptions";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new SubscriptionClient(credential);

Paquete de JavaScript

Para usar esta biblioteca cliente en el explorador, primero debe usar un agrupador. Para obtener más información sobre cómo hacerlo, consulte nuestra documentación de agrupación de .

Conceptos clave

SuscripciónCliente

SubscriptionClient es la interfaz principal para los desarrolladores que usan la biblioteca cliente de suscripción de Azure. Explore los métodos de este objeto de cliente para comprender las diferentes características del servicio de suscripción de Azure a las que puede acceder.

Troubleshooting

Logging

Habilitar el registro puede ayudar a descubrir información útil sobre errores. Para ver un registro de solicitudes y respuestas HTTP, establezca la variable de entorno AZURE_LOG_LEVEL en info. Como alternativa, el registro se puede habilitar en tiempo de ejecución llamando a setLogLevel en el @azure/logger:

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

setLogLevel("info");

Para obtener instrucciones más detalladas sobre cómo habilitar los registros, puede consultar los documentos del paquete de @azure/registrador.

Pasos siguientes

Eche un vistazo al directorio ejemplos para obtener ejemplos detallados sobre cómo usar esta biblioteca.

Contributing

Si desea contribuir a esta biblioteca, lea la guía de contribución de para obtener más información sobre cómo compilar y probar el código.

  • Last updated on