URL ベースの HTTP または HTTPS リクエストを送信することで、Image Search の API オペレーションを呼び出すことができます。各 URL にはリクエストパラメータを含める必要があります。このトピックでは、HTTP または HTTPS リクエストの構文について説明し、Image Search のエンドポイントを示します。
エンドポイント
リージョン | リージョン ID | パブリックエンドポイント | 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 |
シンガポール | 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 |
日本 (東京) | ap-northeast-1 | imagesearch.ap-northeast-1.aliyuncs.com | imagesearch-vpc.ap-northeast-1.aliyuncs.com |
ドイツ (フランクフルト) | eu-central-1 | imagesearch.eu-central-1.aliyuncs.com | imagesearch-vpc.eu-central-1.aliyuncs.com |
中国サイト (aliyun.com) で Image Search を使用する場合は、[中国 (上海)]、[中国 (杭州)]、[中国 (深圳)]、[中国 (北京)] リージョンのみを選択できます。
VPC エンドポイントを使用して、同じ VPC 内の Elastic Compute Service (ECS) インスタンスまたはリソースから Image Search の API オペレーションを呼び出すことができます。たとえば、Image Search インスタンスが中国 (杭州) リージョンにある場合、VPC 経由で Image Search にアクセスする ECS インスタンスまたはリソースも中国 (杭州) リージョンにある必要があります。そうでない場合、オペレーションの呼び出しは失敗します。
VPC エンドポイントを使用して Image Search の API オペレーションを呼び出す場合、ECS インスタンスでインターネットトラフィックは発生しません。詳細については、このトピックのVPC エンドポイントを使用して Image Search の API オペレーションを呼び出すセクションをご参照ください。
通信プロトコル
HTTP または HTTPS 経由でリクエストを送信できます。セキュリティを強化するために HTTPS を使用することをお勧めします。
リクエストメソッド
HTTP POST リクエストを送信できます。
リクエストパラメータ
すべてのリクエストに共通のリクエストパラメータとオペレーション固有のリクエストパラメータが含まれていることを確認してください。
文字エンコーディング
すべてのリクエストとレスポンスは UTF-8 でエンコードされます。
VPC エンドポイントを使用して Image Search の API オペレーションを呼び出す
次のコードは、SDK V3 に基づいて VPC エンドポイントを使用して API オペレーションを呼び出す方法の例を示しています。
# VPC エンドポイントを使用します。
authConfig.endpoint = "imagesearch-vpc.cn-shanghai.aliyuncs.com";
# 設定項目を追加します。
authConfig.endpointType = "internal";Java 用 SDK を使用して API オペレーションを呼び出す方法の詳細については、Java 用 SDK トピックの追加セクションをご参照ください。
VPC エンドポイントを使用して、同じ VPC 内の ECS インスタンスまたはリソースから Image Search の API オペレーションを呼び出すことができます。たとえば、Image Search インスタンスが中国 (杭州) リージョンにある場合、VPC 経由で Image Search にアクセスする ECS インスタンスまたはリソースも中国 (杭州) リージョンにある必要があります。そうでない場合、オペレーションの呼び出しは失敗します。
次のコードは、V3 より前の SDK に基づいて VPC エンドポイントを使用して API オペレーションを呼び出す方法の例を示しています。
// Alibaba Cloud アカウントの AccessKey ペアには、すべての API オペレーションに対する権限があります。API オペレーションの呼び出しまたはルーチンの O&M は、Resource Access Management (RAM) ユーザーとして実行することをお勧めします。
// プロジェクトコードに AccessKey ID または AccessKey シークレットをハードコードしないことをお勧めします。そうしないと、AccessKey ペアが漏洩し、アカウント内のすべてのリソースのセキュリティが侵害される可能性があります。
// この例では、AccessKey ID と AccessKey シークレットは環境変数として保存されています。ビジネス要件に基づいて、AccessKey ID と AccessKey シークレットを構成ファイルに保存することもできます。
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);