Data Transmission Service (DTS) は、ビジュアルコンソールと、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 データです。これは、2020-01-01 以降に API が変更されていないことを意味するものではありません。
|
バージョン |
説明 |
|
推奨 |
|
|
非推奨。これらの API バージョンがサポートする操作は限定的であり、完全ではありません。 |
|
オンラインデバッグ
DTS は OpenAPI Explorer で API デバッグ機能を提供します。API を呼び出す前に、サポートされているバージョン、エンドポイント、統合方法を確認してください。
ソースインスタンスまたはデスティネーションインスタンスが自己管理データベースの場合、DTS サーバーの IP アドレスをデータベースのセキュリティ設定に追加する必要があります。これらの IP アドレスを取得するには、DescribeDTSIP API を呼び出してください。OpenAPI Explorer の左側メニューで [DescribeDTSIP] を選択します。パラメータ設定セクションで、[China (Hangzhou)] などの [Service Address] を選択し、リクエストパラメータを入力します：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 を使用してセルフ診断を実行できます。