Anda dapat memanggil operasi API Image Search dengan mengirimkan permintaan HTTP atau HTTPS berbasis URL. Setiap URL harus mencakup parameter permintaan. Bagian ini menjelaskan sintaksis permintaan HTTP atau HTTPS serta menyediakan titik akhir untuk layanan Image Search.
Titik Akhir
Wilayah | ID Wilayah | Titik Akhir Publik | Titik Akhir VPC |
Cina (Hangzhou) | cn-hangzhou | imagesearch.cn-hangzhou.aliyuncs.com | imagesearch-vpc.cn-hangzhou.aliyuncs.com |
Cina (Shanghai) | cn-shanghai | imagesearch.cn-shanghai.aliyuncs.com | imagesearch-vpc.cn-shanghai.aliyuncs.com |
Cina (Beijing) | cn-beijing | imagesearch.cn-beijing.aliyuncs.com | imagesearch-vpc.cn-beijing.aliyuncs.com |
Cina (Shenzhen) | cn-shenzhen | imagesearch.cn-shenzhen.aliyuncs.com | imagesearch-vpc.cn-shenzhen.aliyuncs.com |
Singapura | ap-southeast-1 | imagesearch.ap-southeast-1.aliyuncs.com | imagesearch-vpc.ap-southeast-1.aliyuncs.com |
Cina (Hong Kong) | cn-hongkong | imagesearch.cn-hongkong.aliyuncs.com | imagesearch-vpc.cn-hongkong.aliyuncs.com |
Jepang (Tokyo) | ap-northeast-1 | imagesearch.ap-northeast-1.aliyuncs.com | imagesearch-vpc.ap-northeast-1.aliyuncs.com |
Jerman (Frankfurt) | eu-central-1 | imagesearch.eu-central-1.aliyuncs.com | imagesearch-vpc.eu-central-1.aliyuncs.com |
Jika Anda menggunakan Image Search di situs Cina (aliyun.com), wilayah yang tersedia adalah China (Shanghai), China (Hangzhou), China (Shenzhen), dan China (Beijing).
Anda dapat menggunakan titik akhir virtual private cloud (VPC) untuk memanggil operasi API Image Search dari instance Elastic Compute Service (ECS) atau sumber daya dalam VPC yang sama. Sebagai contoh, jika instance Image Search Anda berada di wilayah China (Hangzhou), instance ECS atau sumber daya untuk mengakses Image Search melalui VPC juga harus berada di wilayah yang sama. Jika tidak, pemanggilan operasi akan gagal.
Jika Anda memanggil operasi API Image Search menggunakan titik akhir VPC, tidak ada lalu lintas Internet yang dihasilkan pada instance ECS. Untuk informasi lebih lanjut, lihat bagian Gunakan Titik Akhir VPC untuk Memanggil Operasi API Image Search dari topik ini.
Protokol komunikasi
Permintaan dapat dikirim melalui HTTP atau HTTPS. Kami merekomendasikan penggunaan HTTPS untuk meningkatkan keamanan.
Metode permintaan
Permintaan dapat dikirim menggunakan metode HTTP POST.
Parameter permintaan
Pastikan semua permintaan mencakup parameter umum dan parameter spesifik operasi.
Pengkodean karakter
Semua permintaan dan respons dikodekan dalam UTF-8.
Gunakan Titik Akhir VPC untuk Memanggil Operasi API Image Search
Kode berikut menunjukkan cara memanggil operasi API menggunakan titik akhir VPC berdasarkan SDK versi V3:
# Gunakan titik akhir VPC.
authConfig.endpoint = "imagesearch-vpc.cn-shanghai.aliyuncs.com";
# Tambahkan item konfigurasi.
authConfig.endpointType = "internal";Untuk informasi lebih lanjut tentang cara memanggil operasi API menggunakan SDK for Java, lihat bagian Add dari topik SDK for Java.
Anda dapat menggunakan titik akhir virtual private cloud (VPC) untuk memanggil operasi API Image Search dari instance Elastic Compute Service (ECS) atau sumber daya dalam VPC yang sama. Sebagai contoh, jika instance Image Search Anda berada di wilayah China (Hangzhou), instance ECS atau sumber daya untuk mengakses Image Search melalui VPC juga harus berada di wilayah yang sama. Jika tidak, pemanggilan operasi akan gagal.
Kode berikut menunjukkan cara memanggil operasi API menggunakan titik akhir VPC berdasarkan SDK sebelum versi V3:
// Pasangan AccessKey dari akun Alibaba Cloud memiliki izin untuk semua operasi API. Kami merekomendasikan Anda memanggil operasi API atau melakukan pemeliharaan rutin sebagai Pengguna Resource Access Management (RAM).
// Kami merekomendasikan Anda tidak menulis kode keras ID AccessKey atau Rahasia AccessKey Anda di kode proyek Anda. Jika tidak, pasangan AccessKey mungkin bocor dan keamanan semua sumber daya dalam akun Anda terancam.
// Dalam contoh ini, ID AccessKey dan Rahasia AccessKey disimpan sebagai variabel lingkungan. Anda juga dapat menyimpan ID AccessKey dan Rahasia AccessKey ke file konfigurasi sesuai dengan kebutuhan bisnis Anda.
IClientProfile profile = DefaultProfile.getProfile("cn-shanghai", System.getenv("CC_AK_ENV"), System.getenv("CC_SK_ENV"));
# Gunakan titik akhir VPC.
DefaultProfile.addEndpoint("cn-shanghai", "ImageSearch", "imagesearch-vpc.cn-shanghai.aliyuncs.com");
this.client = new DefaultAcsClient(profile);