Azure ManagementGroupsAPI biblioteca cliente para JavaScript - versión 3.0.0

Este paquete contiene un SDK isomorfo (que se ejecuta tanto en Node.js como en navegadores) para Azure cliente ManagementGroupsAPI.

La API de Azure Management Groups permite la consolidación de múltiples suscripciones/recursos en una jerarquía organizativa y gestionar centralmente el control de acceso, las políticas, las alertas y los informes de esos recursos.

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-managementgroups

Instala la biblioteca cliente Azure ManagementGroupsAPI para JavaScript con npm:

npm install @azure/arm-managementgroups

Creación y autenticación de un ManagementGroupsAPI

Para crear un objeto cliente que pueda acceder a la API de Azure ManagementGroupsAPI, necesitarás el endpoint recurso de tu Azure ManagementGroupsAPI y un credentialrecurso . El cliente API de Azure ManagementGroupsAPI puede utilizar las credenciales de Azure Active Directory para autenticarse. Puedes encontrar el endpoint para tu recurso Azure ManagementGroupsAPI en el 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 tendrás que registrar una nueva aplicación AAD y conceder acceso a Azure ManagementGroupsAPI asignando el rol adecuado a tu principal de servicio (nota: roles como 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 { ManagementGroupsAPI } from "@azure/arm-managementgroups";
import { DefaultAzureCredential } from "@azure/identity";

const client = new ManagementGroupsAPI(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 { ManagementGroupsAPI } from "@azure/arm-managementgroups";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new ManagementGroupsAPI(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

ManagementGroupsAPI

ManagementGroupsAPIes la interfaz principal para desarrolladores que utilizan la biblioteca cliente Azure ManagementGroupsAPI. Explora los métodos en este objeto cliente para entender las diferentes características del servicio Azure ManagementGroupsAPI al que puedes 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