All Products
Search
Document Center

Alibaba Cloud SDK:Konfigurasi Titik Akhir

Last Updated:Sep 02, 2026

Topik ini menjelaskan konfigurasi titik akhir untuk SDK yang telah ditingkatkan.

Catatan

Titik akhir adalah nama domain dari API Layanan Alibaba Cloud. Misalnya, titik akhir Elastic Compute Service (ECS) dapat berupa ecs.cn-hangzhou.aliyuncs.com. Setiap Layanan Alibaba Cloud memiliki titik akhir uniknya sendiri, yang dapat berbeda tergantung pada wilayahnya.

Pengaturan Titik Akhir

Darabonba SDK memungkinkan Anda menentukan titik akhir tujuan permintaan API dalam dua mode, yang diurutkan berdasarkan prioritas dari tertinggi ke terendah:

  1. Titik akhir yang ditentukan pengguna: Dalam mode ini, Anda dapat menentukan titik akhir secara eksplisit saat menginisialisasi klien SDK. Titik akhir tersebut dapat ditemukan dengan mengunjungi

    Anda dapat mencari halaman utama produk di OpenAPI Developer Portal. Untuk informasi selengkapnya, lihat bagian akhir dokumen ini. Versi 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'
      });
    }

2. Titik akhir hasil penggabungan: Dalam mode ini, Anda cukup menentukan ID wilayah agar Darabonba SDK menghasilkan titik akhir secara otomatis. Mode ini hanya berlaku jika SDK suatu Layanan Alibaba Cloud menyertakan file data titik akhir. Jika tidak, SDK akan melemparkan pengecualian dan mengembalikan pesan error config.endpoint can not be empty saat Anda menginisialisasi client SDK. Dalam kasus tersebut, Anda harus menentukan titik akhir secara eksplisit. Contoh file data titik akhir tersedia di file data titik akhir ECS. Jika wilayah yang ingin Anda akses tidak tercantum dalam file tersebut, titik akhir wilayah tersebut akan dibuat dalam format ${Kode Layanan Alibaba Cloud}.${ID Wilayah}.aliyuncs.com. Contoh berikut menunjukkan cara menentukan titik akhir hasil penggabungan dalam 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'
  });
}

Titik Akhir Upload File

SDK yang telah ditingkatkan mendukung dua konfigurasi titik akhir untuk upload file:

  • Titik akhir platform terbuka yang digunakan untuk autentikasi. Anda dapat mengonfigurasi titik akhir virtual private cloud (VPC) untuk meminta informasi autentikasi melalui VPC, yang kemudian digunakan untuk upload file. Contoh berikut menunjukkan 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({
          // 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 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);
    }
  • Alamat untuk mengunggah file. Di dalam VPC atau jaringan internal, Anda dapat menggunakan alamat jaringan internal untuk mengunggah file. 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 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);
    }

Lampiran: Menemukan titik akhir

Anda dapat menemukan titik akhir produk di atau Developer Portal:

  1. Di halaman utama Developer Portal, pilih produk cloud seperti ECS untuk membuka halaman utama produk tersebut. Halaman ini menyediakan akses ke pencarian API, debugging percobaan, diagnostik, dan statistik pemanggilan.

2. Temukan daftar wilayah layanan di halaman utama produk. Daftar tersebut menampilkan alamat titik akhir untuk setiap wilayah.

3. Pilih wilayah yang ingin Anda gunakan dan salin titik akhir wilayah tersebut.

Anda juga dapat mencari dengan cara berikut:

Di tab Debugging API OpenAPI Explorer, temukan operasi API yang ingin Anda panggil dan pilih alamat layanan (wilayah). Beralihlah ke bagian contoh kode SDK. Di dalam contoh kode yang dihasilkan secara otomatis, temukan baris tempat titik akhir diatur—itu adalah titik akhir yang Anda butuhkan.