Image Search API は、URL にパラメーターが含まれる URL ベースの HTTP/HTTPS リクエストを使用します。このページでは、サポートされている各リージョンのエンドポイント、VPC ネットワークアドレス、リクエスト構造を一覧表示します。
エンドポイント
|
リージョン |
リージョン |
エンドポイント |
VPC ネットワークアドレス |
|
中国 (杭州) |
cn-hangzhou |
imagesearch.cn-hangzhou.aliyuncs.com |
imagesearch-vpc.cn-hangzhou.aliyuncs.com |
|
中国 (上海) |
cn-shanghai |
imagesearch.cn-shanghai.aliyuncs.com |
imagesearch-vpc.cn-shanghai.aliyuncs.com |
|
中国 (北京) |
cn-beijing |
imagesearch.cn-beijing.aliyuncs.com |
imagesearch-vpc.cn-beijing.aliyuncs.com |
|
中国 (深圳) |
cn-shenzhen |
imagesearch.cn-shenzhen.aliyuncs.com |
imagesearch-vpc.cn-shenzhen.aliyuncs.com |
|
アジアパシフィック SE 1 (シンガポール) |
ap-southeast-1 |
imagesearch.ap-southeast-1.aliyuncs.com |
imagesearch-vpc.ap-southeast-1.aliyuncs.com |
|
中国 (香港) |
cn-hongkong |
imagesearch.cn-hongkong.aliyuncs.com |
imagesearch-vpc.cn-hongkong.aliyuncs.com |
|
アジアパシフィック NE 1 (東京) |
ap-northeast-1 |
imagesearch.ap-northeast-1.aliyuncs.com |
imagesearch-vpc.ap-northeast-1.aliyuncs.com |
|
ヨーロッパ中央 1 (フランクフルト) |
eu-central-1 |
imagesearch.eu-central-1.aliyuncs.com |
imagesearch-vpc.eu-central-1.aliyuncs.com |
-
Alibaba Cloud 中国サイトのアカウントでは、コンソールで次のリージョンのみを選択できます：[中国 (上海)]、[中国 (杭州)]、[中国 (深圳)]、[中国 (北京)]。
-
VPC ネットワークアクセス：Image Search は、同じリージョン内の ECS インスタンスまたはその他のリソースからのみアクセスできます。たとえば、中国 (杭州) の Image Search インスタンスでは、ECS インスタンスまたはその他のリソースも中国 (杭州) にある必要があります。クロスリージョン VPC コールは失敗します。
-
VPC エンドポイント：VPC エンドポイント経由のトラフィックは、ECS インスタンスのインターネットトラフィックを消費しないため、パブリック帯域幅のコストを削減できます。VPC の使用例
ドメインホワイトリスト
サービスリージョンに基づいて、次のドメイン名を O&M ホワイトリストに追加してください。
|
リージョン |
リージョン |
ドメイン名 |
|
中国 (杭州) |
cn-hangzhou |
openplatform.aliyuncs.com hangzhou-imagesearch-transfer-station.oss-cn-hangzhou.aliyuncs.com imagesearch.cn-hangzhou.aliyuncs.com |
|
中国 (上海) |
cn-shanghai |
openplatform.aliyuncs.com sh-imagesearch-transfer-station.oss-cn-shanghai.aliyuncs.com imagesearch.cn-shanghai.aliyuncs.com |
|
中国 (北京) |
cn-beijing |
openplatform.aliyuncs.com bj-imagesearch-transfer-station.oss-cn-beijing.aliyuncs.com imagesearch.cn-beijing.aliyuncs.com |
|
中国 (深圳) |
cn-shenzhen |
openplatform.aliyuncs.com sz-imagesearch-transfer-station.oss-cn-shenzhen.aliyuncs.com imagesearch.cn-shenzhen.aliyuncs.com |
|
アジアパシフィック SE 1 (シンガポール) |
ap-southeast-1 |
openplatform.aliyuncs.com sg-imagesearch-transfer-station-new.oss-ap-southeast-1.aliyuncs.com imagesearch.ap-southeast-1.aliyuncs.com |
|
中国 (香港) |
cn-hongkong |
openplatform.aliyuncs.com hk-imagesearch-transfer-station.oss-cn-hongkong.aliyuncs.com imagesearch.cn-hongkong.aliyuncs.com |
|
アジアパシフィック NE 1 (東京) |
ap-northeast-1 |
openplatform.aliyuncs.com jp-imagesearch-transfer-station.oss-ap-northeast-1.aliyuncs.com imagesearch.ap-northeast-1.aliyuncs.com |
|
ヨーロッパ中央 1 (フランクフルト) |
eu-central-1 |
openplatform.aliyuncs.com de-imagesearch-transfer-station.oss-eu-central-1.aliyuncs.com imagesearch.eu-central-1.aliyuncs.com |
通信プロトコル
HTTP と HTTPS がサポートされています。セキュリティのため、HTTPS を推奨します。
リクエストメソッド
すべてのリクエストは HTTP POST メソッドを使用します。
リクエストパラメーター
各リクエストには、共通ヘッダーパラメーターとオペレーション固有のパラメーターが含まれます。
文字エンコーディング
すべてのリクエストとレスポンスはUTF-8 エンコーディングを使用します。
VPC の使用例
SDK v3：
# VPC ドメイン名を使用
authConfig.endpoint = "imagesearch-vpc.cn-shanghai.aliyuncs.com";
# 新しい設定を追加
authConfig.endpointType = "internal";-
Java SDK の例については、Add オペレーションをご参照ください。
-
VPC ネットワークアクセス：Image Search は、同じリージョン内の ECS インスタンスまたはその他のリソースからのみアクセスできます。たとえば、中国 (杭州) の Image Search インスタンスでは、ECS インスタンスも中国 (杭州) にある必要があります。クロスリージョン VPC コールは失敗します。
v3 より前の SDK：
// Alibaba Cloud アカウントの AccessKey は、すべての API に対する完全な権限を持っています。セキュリティを強化するため、RAM ユーザーを使用して API コールと日常の O&M を実行することを推奨します。
// AccessKey ID と AccessKey Secret をプロジェクトコードにハードコードしないでください。そうしないと、AccessKey ペアが漏洩し、アカウント内のすべてのリソースのセキュリティが損なわれる可能性があります。
// この例では、AccessKey ID と AccessKey Secret を環境変数に保存する方法を示します。必要に応じて、設定ファイルに保存することもできます。
IClientProfile profile = DefaultProfile.getProfile("cn-shanghai", System.getenv("CC_AK_ENV"), System.getenv("CC_SK_ENV"));
// VPC ドメイン名を使用
DefaultProfile.addEndpoint("cn-shanghai", "ImageSearch", "imagesearch-vpc.cn-shanghai.aliyuncs.com");
this.client = new DefaultAcsClient(profile);