Alibaba Cloud SDK：Konfigurasikan sebuah titik akhir

Darabonba SDK memungkinkan Anda menentukan titik akhir untuk pengiriman permintaan API dalam dua mode. Berikut adalah penjelasan mode tersebut berdasarkan prioritas secara menurun:

1. Titik Akhir yang Ditentukan Pengguna: Dalam mode ini, Anda dapat menentukan titik akhir yang tepat saat menginisialisasi klien SDK. Anda dapat memeriksa titik akhir dengan mengunjungi

   OpenAPI Explorer. Untuk informasi lebih lanjut tentang cara memeriksa titik akhir di OpenAPI Explorer, lihat bagian "Memeriksa sebuah Titik Akhir" dari topik ini. Kode sampel berikut memberikan contoh cara menentukan titik akhir yang ditentukan pengguna dalam TypeScript:

   import * as $OpenApi from '@alicloud/openapi-client';
   
   export default class Client {
     static async main(): Promise<void> {
       const config = new $OpenApi.Config({
         // Hilangkan konfigurasi kredensial.
         // Titik akhir yang ingin Anda tentukan.
         endpoint: 'Endpoint'
       });
     }
   }

   Kode sampel berikut memberikan contoh cara menentukan titik akhir yang ditentukan pengguna dalam JavaScript:

   const { Config } = require('@alicloud/openapi-client');
   
   async function main() {
     const config = new Config({
       // Hilangkan konfigurasi kredensial.
       // Titik akhir yang ingin Anda tentukan.
       endpoint: 'Endpoint'
     });
   }

2. Titik akhir gabungan: Dalam mode ini, Anda dapat menentukan ID wilayah untuk Darabonba SDK guna menghasilkan titik akhir. Mode ini hanya berlaku jika SDK layanan Alibaba Cloud memiliki file data titik akhir. Jika tidak, pengecualian akan dilemparkan dengan pesan kesalahan config.endpoint can not be empty saat Anda menginisialisasi klien SDK. Dalam situasi ini, Anda harus menentukan titik akhir yang sesuai. Untuk detail lebih lanjut tentang contoh file data titik akhir, lihat file data titik akhir ECS. Jika wilayah yang ingin diakses tidak tercantum dalam file data tersebut, titik akhir wilayah akan dihasilkan dalam format ${Kode Layanan Alibaba Cloud}.${ID Wilayah}.aliyuncs.com. Kode sampel berikut menunjukkan cara menentukan titik akhir gabungan dalam TypeScript:

import * as $OpenApi from '@alicloud/openapi-client';

export default class Client {
  static async main(): Promise<void> {
    const config = new $OpenApi.Config({
      // Hilangkan konfigurasi kredensial.
      // Wilayah yang ingin Anda akses.
      regionId: 'RegionId'
    });
  }
}

Kode sampel berikut menunjukkan cara menentukan titik akhir gabungan dalam JavaScript:

const { default: Ecs20140526 } = require('@alicloud/ecs20140526');
const { Config } = require('@alicloud/openapi-client');
async function main() {
  const config = new Config({
    // Hilangkan konfigurasi kredensial.
    // Wilayah yang ingin Anda akses.
    regionId: 'RegionId'
  });
}

Anda dapat mengonfigurasi dua titik akhir untuk mengunggah file di Darabonba SDK.

• Titik Akhir Platform Terbuka yang digunakan untuk otentikasi. Anda dapat mengonfigurasi titik akhir virtual private cloud (VPC) untuk meminta informasi otentikasi melalui VPC. Informasi otentikasi digunakan untuk unggahan file. Kode sampel berikut memberikan contoh cara mengonfigurasi titik akhir platform terbuka dalam 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({
        // Hilangkan konfigurasi kredensial.
        // Wilayah yang ingin Anda akses.
        regionId: 'RegionId',
        // Titik akhir platform terbuka.
        openPlatformEndpoint: 'openplatform-vpc.cn-shanghai.aliyuncs.com'
      });
      const client = new Facebody20191230(config);
      const request = new $Facebody20191230.DetectBodyCountAdvanceRequest({
        imageURLObject: createReadStream("Direktori file yang ingin Anda unggah di komputer Anda"),
      });
      // Buat instance RuntimeObject dan konfigurasikan parameter waktu proses. 
      const runtime = new $Util.RuntimeOptions({});
      const resp = await client.DetectBodyCountAdvance(request, runtime);
      console.log(resp.headers);
      console.log(resp.body);
    }
  }

  Kode sampel berikut memberikan contoh cara mengonfigurasi titik akhir platform terbuka dalam 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({
      // Hilangkan konfigurasi kredensial.
      // Wilayah yang ingin Anda akses.
      regionId: 'RegionId',
      // Titik akhir platform terbuka.
      openPlatformEndpoint: 'openplatform-vpc.cn-shanghai.aliyuncs.com'
    });
    const client = new Facebody20191230(config);
    const request = new DetectBodyCountAdvanceRequest({
      imageURLObject: createReadStream("Direktori file yang ingin Anda unggah di komputer Anda"),
    });
    // Buat instance RuntimeObject dan konfigurasikan parameter waktu proses. 
    const runtime = new RuntimeOptions({});
    const resp = await client.DetectBodyCountAdvance(request, runtime);
    console.log(resp.headers);
    console.log(resp.body);
  }

• Titik Akhir yang Digunakan untuk Mengunggah File. Anda dapat mengonfigurasi titik akhir internal untuk mengunggah file melalui jaringan internal atau VPC. Kode sampel berikut memberikan contoh cara mengonfigurasi titik akhir yang digunakan untuk mengunggah file dalam 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({
        // Hilangkan konfigurasi kredensial.
        // Wilayah yang ingin Anda akses.
        regionId: 'RegionId',
        // Titik akhir platform terbuka.
        openPlatformEndpoint: 'openplatform-vpc.cn-shanghai.aliyuncs.com',
        // Titik akhir OSS yang ingin Anda gunakan untuk mengunggah file. Jika Anda menetapkan tipe titik akhir ke internal, Anda dapat menggunakan titik akhir internal untuk mengunggah file ke OSS melalui VPC atau jaringan klasik. Jika Anda menetapkan tipe titik akhir ke accelerate, Anda dapat menggunakan titik akhir yang dipercepat di luar Tiongkok untuk mengunggah file ke OSS.
        endpointType: 'internal'
      });
      const client = new Facebody20191230(config);
      const request = new $Facebody20191230.DetectBodyCountAdvanceRequest({
        imageURLObject: createReadStream("Direktori file yang ingin Anda unggah di komputer Anda"),
      });
      // Buat instance RuntimeObject dan konfigurasikan parameter waktu proses. 
      const runtime = new $Util.RuntimeOptions({});
      const resp = await client.DetectBodyCountAdvance(request, runtime);
      console.log(resp.headers);
      console.log(resp.body);
    }
  }

  Kode sampel berikut memberikan contoh cara mengonfigurasi titik akhir yang digunakan untuk mengunggah file dalam 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({
      // Hilangkan konfigurasi kredensial.
      // Wilayah yang ingin Anda akses.
      regionId: 'RegionId',
      // Titik akhir platform terbuka.
      openPlatformEndpoint: 'openplatform-vpc.cn-shanghai.aliyuncs.com',
      // Titik akhir OSS yang ingin Anda gunakan untuk mengunggah file. Jika Anda menetapkan tipe titik akhir ke internal, Anda dapat menggunakan titik akhir internal untuk mengunggah file ke OSS melalui VPC atau jaringan klasik. Jika Anda menetapkan tipe titik akhir ke accelerate, Anda dapat menggunakan titik akhir yang dipercepat di luar Tiongkok untuk mengunggah file ke OSS.
      endpointType: 'internal'
    });
    const client = new Facebody20191230(config);
    const request = new DetectBodyCountAdvanceRequest({
      imageURLObject: createReadStream("Direktori file yang ingin Anda unggah di komputer Anda"),
    });
    // Buat instance RuntimeObject dan konfigurasikan parameter waktu proses. 
    const runtime = new RuntimeOptions({});
    const resp = await client.DetectBodyCountAdvance(request, runtime);
    console.log(resp.headers);
    console.log(resp.body);
  }

Anda dapat memeriksa sebuah titik akhir di atau OpenAPI Explorer.

1. Pilih layanan Alibaba Cloud di halaman utama OpenAPI Explorer. Sebagai contoh, Anda dapat memilih ECS.

2. Klik tab Wilayah.

3. Temukan wilayah yang ingin Anda tentukan dan salin titik akhir wilayah tersebut.

Anda juga dapat menggunakan metode berikut untuk memeriksa sebuah titik akhir:

Di tab Debugging API OpenAPI Explorer, temukan operasi API yang ingin Anda panggil dan konfigurasikan parameter RegionId. OpenAPI Explorer secara otomatis menghasilkan kode sampel SDK dari mana Anda dapat memperoleh titik akhir.