Alibaba Cloud SDK:Configuração de endpoint

Este tópico descreve a configuração de endpoint para o SDK atualizado.

O Darabonba SDK permite especificar o endpoint para envio de requisições de API em dois modos. A lista a seguir descreve os modos por ordem decrescente de prioridade:

1. Endpoint definido pelo usuário: neste modo, especifique um endpoint exato ao inicializar um cliente do SDK. Consulte um endpoint acessando

   Pesquise a página home do product no OpenAPI Developer Portal. Para mais informações, consulte o final deste documento. Versão 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: neste modo, especifique um ID de região para que o Darabonba SDK gere um endpoint. Esse modo só funciona se o SDK de um service da Alibaba Cloud possuir um arquivo de dados de endpoint. Caso contrário, o sistema lança uma exceção e retorna a mensagem de erro config.endpoint can not be empty durante a inicialização do cliente do SDK. Nessa situação, especifique um endpoint exato. Para ver um exemplo de arquivo de dados de endpoint, consulte ECS endpoint data file. Se a região desejada não estiver incluída no arquivo de dados, o endpoint dessa região será gerado no formato ${Code of the Alibaba Cloud service}.${Region ID}.aliyuncs.com. O código de exemplo a seguir mostra como especificar um endpoint concatenado em 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'
  });
}

O SDK atualizado oferece suporte a duas configurações de endpoint para uploads de arquivo:

• Endpoint da plataforma aberta usado para autenticação. Configure um endpoint de Virtual Private Cloud (VPC) para solicitar informações de autenticação via VPC. Essas informações são utilizadas nos uploads de arquivo. O código de exemplo a seguir demonstra como configurar o endpoint da plataforma aberta em 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);
    }
  }

  Versão 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);
  }

• Endereço para upload de arquivos. Em uma VPC ou rede interna, utilize um endereço de rede interna para fazer o upload dos arquivos. 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);
    }
  }

  Versão 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);
  }

Encontre os endpoints dos products no Developer Portal:

1. Na página home do Developer Portal, selecione um cloud product, como ECS, para abrir a página home do product. Essa página fornece acesso à pesquisa de API, depuração de teste, diagnósticos e estatísticas de chamadas.

1. Localize a lista de regiões do service na página home do product. A lista exibe o endereço de endpoint de cada região.

2. Encontre a região desejada e copie o endpoint correspondente.

Também é possível pesquisar das seguintes formas:

Na aba API Debugging do OpenAPI Explorer, localize a operação de API que deseja chamar e selecione o endereço do service (região). Mude para a seção de código de exemplo do SDK. No código de exemplo gerado automaticamente, localize a linha onde o endpoint está definido; esse é o endpoint necessário.