Compartir a través de

Biblioteca cliente de AzureTerraformResourceProvider para JavaScript

  • Artículo

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

La API de administración de Azure Terraform proporciona un conjunto RESTful de servicios web que se usan para administrar los recursos de Azure Terraform.

Vínculos clave:

  • paquete de (NPM)
  • documentación de referencia de api de

Empezar

Entornos admitidos actualmente

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

Prerrequisitos

  • Una suscripción de Azure .

Instalación del paquete @azure/arm-terraform

Instale la biblioteca cliente azureTerraformResourceProvider para JavaScript con npm:

npm install @azure/arm-terraform

Creación y autenticación de un AzureTerraformClient

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

Puede autenticarse con Azure Active Directory mediante una credencial de la biblioteca de de @azure/identidad o un token de AAD existente.

Para usar el proveedor de de DefaultAzureCredential que se muestra a continuación u otros proveedores de credenciales proporcionados con el SDK de Azure, instale el paquete de :

npm install @azure/identity

También deberá registrar una nueva aplicación de AAD y conceder acceso a AzureTerraformResourceProvider asignando el rol adecuado a la entidad de servicio (nota: los roles como "Owner" no concederán los permisos necesarios). Establezca los valores del identificador de cliente, el identificador de inquilino y el secreto de cliente de la aplicación de AAD como variables de entorno: AZURE_CLIENT_ID, AZURE_TENANT_ID, AZURE_CLIENT_SECRET.

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

const { AzureTerraformClient } = require("@azure/arm-terraform");
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 AzureTerraformClient(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 AzureTerraformClient(credential, subscriptionId);

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

AzureTerraformClient

AzureTerraformClient es la interfaz principal para los desarrolladores que usan la biblioteca cliente AzureTerraformResourceProvider. Explore los métodos de este objeto de cliente para comprender las distintas características del servicio AzureTerraformResourceProvider al que puede acceder.

Solución de problemas

Registro

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:

const { setLogLevel } = require("@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.

Contribuyendo

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.