Alibaba Cloud SDK:Configuración de endpoints

Este tema describe la configuración de endpoints para el SDK actualizado.

Darabonba SDK permite especificar el endpoint al que se envían las solicitudes de API mediante dos modos. A continuación, se describen los modos por prioridad en orden descendente:

1. Endpoint definido por el usuario: En este modo, especifique un endpoint exacto al inicializar un cliente del SDK. Consulte un endpoint si visita

   Busque la página principal del producto en OpenAPI Developer Portal. Para obtener más información, consulte el final de este documento. Versión de TypeScript:

   import * as $OpenApi from '@alicloud/openapi-client';
   
   export default class Client {
     static async main(): Promise<void> {
       const config = new $OpenApi.Config({
         // Omit the credential configuration.
         // The endpoint that you want to specify.
         endpoint: 'Endpoint'
       });
     }
   }

   JavaScript:

   const { Config } = require('@alicloud/openapi-client');
   
   async function main() {
     const config = new Config({
       // Omit the credential configuration.
       // The endpoint that you want to specify.
       endpoint: 'Endpoint'
     });
   }

1. Endpoint concatenado: En este modo, especifique un ID de región para que Darabonba SDK genere un endpoint. Este modo solo surte efecto si el SDK de un servicio de Alibaba Cloud cuenta con un archivo de datos de endpoints. De lo contrario, se genera una excepción y se devuelve el mensaje de error config.endpoint can not be empty al inicializar un cliente del SDK. En este caso, debe especificar un endpoint exacto. Para ver un ejemplo de archivo de datos de endpoints, consulte ECS endpoint data file. Si la región a la que desea acceder no está incluida en el archivo de datos, el endpoint de la región se genera con el formato ${Code of the Alibaba Cloud service}.${Region ID}.aliyuncs.com. El siguiente código de ejemplo muestra cómo especificar un endpoint concatenado en TypeScript:

   import * as $OpenApi from '@alicloud/openapi-client';
   
   export default class Client {
     static async main(): Promise<void> {
       const config = new $OpenApi.Config({
         // Omit the credential configuration.
         // The region that you want to access.
         regionId: 'RegionId'
       });
     }
   }

JavaScript:

const { default: Ecs20140526 } = require('@alicloud/ecs20140526');
const { Config } = require('@alicloud/openapi-client');
async function main() {
  const config = new Config({
    // Omit the credential configuration.
    // The region that you want to access.
    regionId: 'RegionId'
  });
}

El SDK actualizado admite dos configuraciones de endpoint para la carga de archivos:

• El endpoint de una plataforma abierta que se utiliza para la autenticación. Configure un endpoint de virtual private cloud (VPC) para solicitar información de autenticación a través de una VPC. Esta información de autenticación se usa para cargar archivos. El siguiente código de ejemplo muestra cómo configurar el endpoint de una plataforma abierta en TypeScript:

  import Facebody20191230, * as $Facebody20191230 from '@alicloud/facebody20191230';
  import * as $OpenApi from '@alicloud/openapi-client';
  import * as $Util from '@alicloud/tea-util';
  import { createReadStream } from 'fs';
  
  export default class Client {
    static async main(): Promise<void> {
      const config = new $OpenApi.Config({
        // Omit the credential configuration.
        // The region that you want to access.
        regionId: 'RegionId',
        // The endpoint of the open platform.
        openPlatformEndpoint: 'openplatform-vpc.cn-shanghai.aliyuncs.com'
      });
      const client = new Facebody20191230(config);
      const request = new $Facebody20191230.DetectBodyCountAdvanceRequest({
        imageURLObject: createReadStream("The directory of the file that you want to upload on your computer"),
      });
      // Create a RuntimeObject instance and configure runtime parameters. 
      const runtime = new $Util.RuntimeOptions({});
      const resp = await client.DetectBodyCountAdvance(request, runtime);
      console.log(resp.headers);
      console.log(resp.body);
    }
  }

  Versión de JavaScript:

  const { default: Facebody20191230, DetectBodyCountAdvanceRequest } = require('@alicloud/facebody20191230');
  const { Config } = require('@alicloud/openapi-client');
  const { RuntimeOptions } = require('@alicloud/tea-util');
  const { createReadStream } = require('fs');
  
  async function main() {
    const config = new Config({
      // Omit the credential configuration.
      // The region to access.
      regionId: 'RegionId',
      // Set the authentication URL.
      openPlatformEndpoint: 'openplatform-vpc.cn-shanghai.aliyuncs.com',
    });
    const client = new Facebody20191230(config);
    const request = new DetectBodyCountAdvanceRequest({
      imageURLObject: createReadStream("path/to/local/file"),
    });
    // Create a RuntimeObject instance and set runtime parameters.
    const runtime = new RuntimeOptions({});
    const resp = await client.DetectBodyCountAdvance(request, runtime);
    console.log(resp.headers);
    console.log(resp.body);
  }

• La dirección para la carga de archivos. En una VPC o una red interna, utilice una dirección de red interna para cargar archivos. TypeScript:

  import Facebody20191230, * as $Facebody20191230 from '@alicloud/facebody20191230';
  import * as $OpenApi from '@alicloud/openapi-client';
  import * as $Util from '@alicloud/tea-util';
  import { createReadStream } from 'fs';
  
  export default class Client {
    static async main(): Promise<void> {
      const config = new $OpenApi.Config({
        // Omit the credential configuration.
        // The region that you want to access.
        regionId: 'RegionId',
        // The endpoint of the open platform.
        openPlatformEndpoint: 'openplatform-vpc.cn-shanghai.aliyuncs.com',
        // The OSS endpoint that you want to use to upload the file. If you set the endpoint type to internal, you can use an internal endpoint to upload the file to OSS over a VPC or the classic network. If you set the endpoint type to accelerate, you can use an accelerated endpoint outside China to upload the file to OSS.
        endpointType: 'internal'
      });
      const client = new Facebody20191230(config);
      const request = new $Facebody20191230.DetectBodyCountAdvanceRequest({
        imageURLObject: createReadStream("The directory of the file that you want to upload on your computer"),
      });
      // Create a RuntimeObject instance and configure runtime parameters. 
      const runtime = new $Util.RuntimeOptions({});
      const resp = await client.DetectBodyCountAdvance(request, runtime);
      console.log(resp.headers);
      console.log(resp.body);
    }
  }

  Versión de JavaScript:

  const { default: Facebody20191230, DetectBodyCountAdvanceRequest } = require('@alicloud/facebody20191230');
  const { Config } = require('@alicloud/openapi-client');
  const { RuntimeOptions } = require('@alicloud/tea-util');
  const { createReadStream } = require('fs');
  async function main() {
    const config = new Config({
      // Omit the credential configuration.
      // The region to access.
      regionId: 'RegionId',
      // Set the authentication URL.
      openPlatformEndpoint: 'openplatform-vpc.cn-shanghai.aliyuncs.com',
      // Set the OSS upload URL. 'internal' is for VPC and classic network. 'accelerate' is for accelerated domain names outside China.
      endpointType: 'internal'
    });
    const client = new Facebody20191230(config);
    const request = new DetectBodyCountAdvanceRequest({
      imageURLObject: createReadStream("path/to/local/file"),
    });
    // Create a RuntimeObject instance and set runtime parameters.
    const runtime = new RuntimeOptions({});
    const resp = await client.DetectBodyCountAdvance(request, runtime);
    console.log(resp.headers);
    console.log(resp.body);
  }

Encuentre los endpoints de los productos en Developer Portal:

1. En la página principal de Developer Portal, seleccione un producto en la nube, como ECS, para abrir la página principal del producto. Dicha página ofrece accesos a la búsqueda de API, depuración de prueba, diagnósticos y estadísticas de llamadas.

1. Localice la lista de regiones del servicio en la página principal del producto. La lista muestra la dirección del endpoint de cada región.

2. Busque la región que desea especificar y copie el endpoint correspondiente.

También puede buscar de las siguientes maneras:

En la pestaña API Debugging de OpenAPI Explorer, busque la operación de API que desea invocar y seleccione la dirección del servicio (región). Cambie a la sección de código de ejemplo del SDK. En el código de ejemplo generado automáticamente, localice la línea donde se establece el endpoint; ese es el endpoint que necesita.