Topik ini menjelaskan cara mengonfigurasi titik akhir di Alibaba Cloud Darabonba SDK.
Titik akhir adalah nama domain dari API layanan Alibaba Cloud. Sebagai contoh, titik akhir Elastic Compute Service (ECS) dapat berupa ecs.cn-hangzhou.aliyuncs.com. Setiap layanan Alibaba Cloud memiliki titik akhir uniknya sendiri. Titik akhir suatu layanan mungkin berbeda berdasarkan wilayah.
Konfigurasikan sebuah titik akhir ke mana permintaan API dikirim
Darabonba SDK memungkinkan Anda menentukan titik akhir pengiriman permintaan API dalam dua mode. Berikut ini adalah penjelasan mode tersebut berdasarkan prioritas menurun:
Titik Akhir yang Ditentukan Pengguna: Dalam mode ini, Anda dapat menentukan titik akhir saat menginisialisasi klien SDK. Untuk memeriksa titik akhir, kunjungi
OpenAPI Explorer. Informasi lebih lanjut tentang cara memeriksa titik akhir di OpenAPI Explorer dapat ditemukan di bagian "Query an endpoint" dari topik ini.
use Darabonba\OpenApi\Models\Config;
$config = new Config([]);
// Hilangkan konfigurasi kredensial.
$config->endpoint = "<endpoint>";2. Titik Akhir Gabungan: Dalam mode ini, Anda dapat menentukan ID wilayah agar Darabonba SDK 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 hal ini, Anda harus menentukan titik akhir yang tepat. Informasi lebih lanjut tentang contoh file data titik akhir dapat ditemukan di File Data Titik Akhir ECS. Jika wilayah yang ingin Anda akses tidak termasuk dalam file data tersebut, titik akhir wilayah tersebut dihasilkan dalam format ${Kode Layanan Alibaba Cloud}.${ID Wilayah}.aliyuncs.com.
use Darabonba\OpenApi\Models\Config;
$config = new Config([]);
// Hilangkan konfigurasi kredensial.
$config->regionId = "<region-id>";3. Konfigurasikan Titik Akhir untuk Mengunggah File
Anda dapat mengonfigurasi dua titik akhir untuk mengunggah file di Darabonba SDK.
- Titik akhir platform terbuka digunakan untuk otentikasi. Anda dapat mengonfigurasi titik akhir virtual private cloud (VPC) untuk meminta informasi otentikasi melalui VPC. Informasi otentikasi digunakan untuk mengunggah file.
use Darabonba\OpenApi\Models\Config;
use GuzzleHttp\Psr7\Stream;
use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
use AlibabaCloud\SDK\Facebody\V20191230\Facebody;
use AlibabaCloud\SDK\Facebody\V20191230\Facebody\Models\DetectBodyCountAdvanceRequest;
$config = new Config([]);
// Hilangkan konfigurasi kredensial.
$config->regionId = "<region-id>";
$config->openPlatformEndpoint = "openplatform-vpc.cn-shanghai.aliyuncs.com";
$request = new DetectBodyCountAdvanceRequest();
$request->imageURLObject = new Stream(fopen("filepath"));
$runtime = new RuntimeOptions();
$client = new Facebody($config);
try {
$response = $client->detectBodyCountAdvance($request, $runtime);
var_dump($response);
} catch (TeaUnableRetryError $e) {
var_dump($e->getMessage());
var_dump($e->getErrorInfo());
var_dump($e->getLastException());
var_dump($e->getLastRequest());
}- Titik akhir yang digunakan untuk mengunggah file. Anda dapat mengonfigurasi titik akhir internal untuk mengunggah file melalui jaringan internal atau VPC.
Memeriksa titik akhir
Anda dapat memeriksa titik akhir di OpenAPI Explorer.
Pilih layanan Alibaba Cloud di halaman utama OpenAPI Explorer. Sebagai contoh, Anda dapat memilih ECS.
2. Klik tab Regions.
3. Temukan wilayah yang ingin Anda tentukan dan salin titik akhir wilayah tersebut.
Anda juga dapat menggunakan metode berikut untuk memeriksa titik akhir:
Di tab API Debugging OpenAPI Explorer, temukan operasi API yang ingin Anda panggil dan konfigurasikan parameter RegionId. OpenAPI Explorer secara otomatis menghasilkan kode contoh SDK dari mana Anda dapat memperoleh titik akhir.
