Data Transmission Service (DTS) は、GUI ベースのコンソールのほか、OpenAPI を使用したオンラインデバッグ、Alibaba Cloud SDK、 など、サービスを呼び出すためのさまざまな方法を提供します。DTS を利用した開発効率を向上させるために、ニーズに最適な操作方法とインテグレーション方法を選択することを推奨します。
OpenAPI Explorer
Alibaba Cloud は、クラウドサービスの API を効率的に学習して使用するための OpenAPI Explorer を提供しています。OpenAPI Explorer は、インテリジェントな API 検索、ドキュメント、オンラインデバッグ、SDK 生成、コードサンプル、エラー診断、および呼び出し統計を含む包括的なツールです。OpenAPI Explorer を使用して、さまざまな Alibaba Cloud サービスの API を呼び出し、リクエストとレスポンスを表示できます。さらに、OpenAPI Explorer は、すぐに始められるよう SDK サンプルコードを自動的に生成します。詳細については、「OpenAPI とは」をご参照ください。
バージョン
Alibaba Cloud OpenAPI では、バージョン番号を使用して、クラウド製品の API のメジャーバージョンを管理します。たとえば、DTS は現在、2020-01-01 API バージョンをサポートしています。文字列 2020-01-01 は、日付ではなく API のバージョン番号を表します。表示されるデータは、公開されている最新の API データです。これは、API が 2020-01-01 以降変更されていないことを意味するものではありません。
|
バージョン |
説明 |
|
推奨 |
|
|
非推奨です。これらの API バージョンは、サポートされている操作の数が限られており、完全ではありません。 |
|
オンラインデバッグ
DTS は、OpenAPI Explorer で API デバッグ機能を提供します。API を呼び出す前に、サポートされているバージョン、エンドポイント、およびインテグレーション方法にご注意ください。
ソースインスタンスまたは宛先インスタンスがセルフマネージドデータベースである場合は、DTS サーバーの IP アドレスをデータベースのセキュリティ設定に追加する必要があります。これらの IP アドレスを取得するには、DescribeDTSIP API を呼び出します。OpenAPI Explorer の左側のメニューで [DescribeDTSIP] を選択します。パラメーター設定セクションで、[Service Address] (たとえば [China (Hangzhou)]) を選択し、リクエストパラメーターとして RegionId (たとえば cn-hangzhou)、SourceEndpointRegion (必須、ソースインスタンスのリージョン)、および DestinationEndpointRegion (宛先インスタンスのリージョン) を入力します。次に、[Initiate Call] をクリックします。
デバッグ URL
次の URL で API 操作をデバッグできます。https://next.api.alibabacloud.com/api/Dts/2020-01-01/
エンドポイント
レイテンシーを最小限に抑えるには、リソースが配置されているリージョンのエンドポイントに接続してください。たとえば、中国 (張家口) リージョンのリソースの場合、パブリックエンドポイントと VPC エンドポイントはそれぞれ dts.cn-zhangjiakou.aliyuncs.com と dts-vpc.cn-zhangjiakou.aliyuncs.com です。
-
パブリックエンドポイントは、世界中のどこからでもアクセスできます。
-
VPC エンドポイントは、対応する Alibaba Cloud リージョンの VPC からのみアクセスできます。VPC エンドポイントには、次の利点があります。
-
高いセキュリティ：VPC エンドポイントは VPC 内からのみアクセスできるため、セキュリティとプライバシーが向上します。
-
高速な応答：VPC の内部ネットワーク上で動作することにより、VPC エンドポイントは通常、パブリックエンドポイントよりも高速な応答時間を提供し、パブリックネットワークのレイテンシーと帯域幅の制限を回避します。
-
低コスト：VPC エンドポイントは内部ネットワーク通信を使用するため、データ転送コストを削減できます。
-
詳細については、「エンドポイント」をご参照ください。
ユーザーアイデンティティ
OpenAPI Explorer にログインすると、デフォルトで現在のアカウントを使用して API をデバッグすることになります。Alibaba Cloud アカウントはすべての API へのフルアクセス権を持っているため、デバッグに使用するとセキュリティ上のリスクがあります。API アクセスと日常の O&M には、RAM ユーザーを作成して使用することを強く推奨します。API 呼び出しを行う前に、ビジネスニーズに基づいて RAM ユーザーに権限を付与してください。RAM ユーザーは、DTS を操作するために必要な権限を持っている必要があります。詳細については、「RAM 認可」をご参照ください。
|
ユーザーアイデンティティ |
サポートステータス |
|
サポート済み |
|
|
RAM ユーザー (推奨) |
サポート済み |
|
RAM ロール (推奨) |
サポート済み |
関連情報
インテグレーション方法
DTS は、SDK など、複数のインテグレーション方法を提供します。ビジネス要件に基づいてインテグレーション方法を選択できます。
|
インテグレーション方法 |
サポートステータス |
|
Alibaba Cloud SDK (推奨) |
サポート済み |
|
Alibaba Cloud CLI |
サポート済み |
|
Terraform |
サポート対象外 |
|
Resource Orchestration Service (ROS) |
サポート済み |
|
カスタムカプセル化 |
サポート済み |
Alibaba Cloud SDK
-
Alibaba Cloud は、Java、C#、Go、Python、TypeScript、PHP、C++ など、さまざまなプログラミング言語用の SDK を提供しています。SDK をアプリケーションに統合して、API を直接呼び出すことができます。SDK は、署名ロジック、タイムアウト、再試行などの一般的なタスクを処理し、構造化されたレスポンスオブジェクトを返すため、開発が簡素化されます。Alibaba Cloud SDK の詳細については、「Alibaba Cloud SDK」をご参照ください。
-
DTS SDK でサポートされているプログラミング言語と依存関係については、「DTS SDK」をご参照ください。
API のカスタムカプセル化
上記の方法のいずれもビジネス要件を満たさない場合は、ご自身で API リクエストをカプセル化することも可能です。この方法は推奨されません。詳細については、「V3 リクエストの構造と署名」をご参照ください。
注意事項
API 呼び出しが失敗した場合は、返されたエラーコードを使用して、リクエストパラメーターと値が有効であることを確認してください。詳細については、エラーコードセンターをご参照ください。
または、返されたリクエスト ID または SDK エラーメッセージを控えておき、Alibaba Cloud OpenAPI Diagnostic Platform を使用して自己診断を行うこともできます。