データ管理 (DMS) は、視覚化された操作コンソールを提供し、Alibaba Cloud SDKまたはAlibaba Cloud CLIを使用してオンラインAPIデバッグを実行し、DMS API操作を呼び出すことができます。 DMSでの開発効率を向上させるために、ビジネス要件に基づいて適切な運用および統合方法を選択することを推奨します。
DMS APIの概要
Alibaba Cloudは、API操作の学習と使用に役立つOpenAPI Explorerを提供しています。 OpenAPI Explorerは、インテリジェント検索、ドキュメント、オンラインデバッグ、SDKダウンロード、サンプルコード、エラー診断、呼び出し統計など、API操作に関連する複数の機能を統合しています。 OpenAPI Explorerでは、Alibaba CloudサービスのAPI操作を呼び出し、APIのリクエストとレスポンスを表示できます。 OpenAPI Explorerは、Alibaba Cloudサービスの使用を容易にするために、対応するSDKサンプルコードも自動的に生成します。 詳細については、「APIとは何ですか? 」をご参照ください。
サポートされているバージョン
Alibaba Cloud APIは、バージョン番号を使用してクラウドサービスAPIのバージョンを管理します。
たとえば、DMSは2018-11-01バージョンのAPIをサポートしています。 2018-11-01は、日付ではなくAPIバージョン番号です。 ユーザーには、APIに関する最新の公開情報が提供されます。 2018-11-01 DMS APIの最新バージョンです。
機能 | APIバージョン | 説明 |
DMS | (推奨) |
オンラインデバッグ
DMSは、OpenAPI ExplorerのAPIデバッグなどの機能を提供します。 API操作を呼び出す前に、DMSが提供する次の情報 (APIのバージョン、エンドポイント、APIスタイル、およびリクエストメソッド) を理解する必要があります。
ページのデバッグ
機能 | APIバージョン | ページ |
DMS |
エンドポイント
DMS
リソースが存在するリージョンに基づいてエンドポイントを選択し、レイテンシを削減します。
たとえば、インスタンスが中国 (張家口) リージョンにあり、仮想プライベートクラウド (VPC) にデプロイされている場合、エンドポイントとしてdms-enterprise-vpc.cn-zhangjiakou.aliyuncs.comを指定します。 詳細については、「エンドポイント」をご参照ください。
サポートされるID
デフォルトでは、Alibaba Cloudアカウントを使用してOpenAPI Explorerにログインすると、Alibaba Cloudアカウントを使用してオンラインデバッグが実行されます。 Alibaba Cloudアカウントには、すべてのAPI操作に対する権限があります。 Alibaba Cloudアカウントを使用してAPI操作をオンラインでデバッグすることは、リスクの高い操作です。 RAMユーザーとしてAPI操作を呼び出すか、ルーチンのO&Mを実行することを推奨します。 RAMユーザーとしてAPI操作を呼び出す前に、ビジネス要件に基づいて必要な権限をRAMユーザーに付与します。 RAMユーザーには、DMSを使用するために必要な権限が必要です。 詳細については、「RAMを使用したアクセス制御の実装」をご参照ください。
ユーザーID | 対応 |
はい | |
RAMユーザー (推奨) | はい |
RAMロール (推奨) | はい |
統合方法
統合の概要
ビジネス要件に基づいてSDKなどのさまざまな統合方法を使用して、DMSをビジネスシステムと統合できます。
Alibaba Cloud SDKは、アプリケーションに簡単に統合できます。 Alibaba Cloud SDKを使用してAPI操作を呼び出すことを推奨します。
DMS
メソッド | 対応 |
Alibaba Cloud SDK (推奨) | はい |
はい | |
はい (一部サポート) | |
いいえ | |
カスタムAPIカプセル化 (非推奨) | はい |
Alibaba Cloud SDK
Alibaba Cloudは、Java、C# 、Go、Python、TypeScript、Node.js、PHP、C ++ などの複数のプログラミング言語用のSDKを提供しています。 SDKをビジネスシステムと統合して、API操作を直接呼び出すことができます。 SDKは、署名ロジック、タイムアウトメカニズム、再試行メカニズムなどの情報をカプセル化し、仕様に基づいて構造化応答オブジェクトを返します。 詳細は、「Alibaba Cloud SDK」をご参照ください。
DMS SDKでサポートされているプログラミング言語と依存関係については、「DMS SDK」をご参照ください。
Alibaba Cloud CLI
Alibaba Cloud CLIでは、
aliyunコマンドを使用して他のAlibaba Cloudサービスと対話し、Alibaba Cloudリソースを管理できます。 Alibaba Cloud CLIの詳細については、Alibaba Cloud CLIとはAlibaba Cloud CLIを使用して、DMSのAPI操作を呼び出すことができます。 詳細については、「コマンド構文」をご参照ください。
ROS
ROSは、クラウドコンピューティングリソースを簡単な方法で管理できるAlibaba Cloudサービスです。 スタックテンプレートをコンパイルして、ECS (Elastic Compute Service) やApsaraDB RDSインスタンスなどのクラウドコンピューティングリソース、およびテンプレート内のリソース間の依存関係を記述できます。 ROSエンジンは、テンプレートに基づいてスタック内のすべてのリソースを自動的に作成および構成して、自動デプロイとO&Mを実装します。詳細については、「」をご参照ください。ROSとは何ですか?
ROSを使用してDMSのAPI操作を呼び出すことができます。 ROSでは、次のDMS固有のリソースタイプがサポートされています。
ALIYUN::DMS::Instance: DMSにインスタンスを登録します。
ALIYUN::DMS::User: DMSユーザーを追加します。
ROSを使用してDMSリソースを効率的に調整する方法の詳細については、「ROSの使用」をご参照ください。
カスタムAPIカプセル化
ネイティブHTTP呼び出しを行うには、カスタムリクエストを作成し、リクエストに署名する必要があります。 署名メソッドの詳細については、「関数別の操作の一覧」および「リクエスト構文と署名メソッドV3」をご参照ください。
使用上の注意
DMS
API操作呼び出しでエラーが返された場合は、エラーコードに基づいてリクエスト内のパラメーターと値を確認します。 エラーコードの詳細については、「エラーコード」をご参照ください。
Alibaba Cloud OpenAPI Diagnosticsを使用して、返されたリクエストIDまたはSDKエラー情報に基づいてセルフサービス診断を実行することもできます。