CloudOps Orchestration Service は、ビジュアルコンソールを提供し、OpenAPI、Alibaba Cloud SDK、CLI、および Resource Orchestration Service (ROS) といった複数の統合方法をサポートしています。CloudOps Orchestration Service と統合する際は、ニーズに合った方法を選択してください。
OpenAPI
OpenAPI ポータルは、インテリジェントな検索、ドキュメント、オンラインデバッグ、SDK のダウンロード、コードサンプル、エラー診断、および呼び出し統計を提供しています。任意の Alibaba Cloud 製品の OpenAPI を呼び出し、リクエストとレスポンスを表示し、SDK 呼び出しサンプルを自動生成できます。詳細については、「OpenAPI とは」をご参照ください。
バージョンガイド
OpenAPI は、バージョン番号を使用して API リストを管理します。たとえば、CloudOps Orchestration Service は API バージョン 2019-06-01 をサポートしています。 2019-06-01 は日付ではなくバージョン識別子です。これは、最新の公開 API セットを表しており、時間とともに更新される可能性があります。
|
バージョン番号 |
説明 |
|
推奨 |
オンラインデバッグ
CloudOps Orchestration Service は、OpenAPI ポータルで API デバッグ機能を提供しています。API を呼び出す前に、CloudOps Orchestration Service がサポートするバージョン、エンドポイント、および統合方法を理解しておく必要があります。
デバッグポータル
API デバッグポータル：CloudOps Orchestration Service API デバッグリスト
エンドポイント
リソースが存在するリージョンに対応するエンドポイントを選択してください。たとえば、中国 (張家口) リージョンの CloudOps Orchestration Service のパブリックエンドポイントは oos.cn-zhangjiakou.aliyuncs.com で、VPC エンドポイントは oos-vpc.cn-zhangjiakou.aliyuncs.com です。
-
パブリックエンドポイントはグローバルにアクセスできます。
-
VPC エンドポイントは、対応する Alibaba Cloud リージョンおよび VPC 内からのみアクセスでき、以下の利点があります。
-
VPC 内からのアクセスに限定することで、セキュリティとプライバシーが向上します。
-
パブリックネットワークのオーバーヘッドを回避することで、レイテンシーが低減されます。
-
内部ネットワーク通信により、データ転送コストが削減されます。
-
詳細については、「エンドポイント」をご参照ください。
ユーザーアイデンティティ
OpenAPI ポータルは、デフォルトで Alibaba Cloud アカウントを使用して API デバッグを行います。このアカウントはすべての API へのアクセス権を持つため、最小権限を持つ Resource Access Management (RAM) ユーザーを使用することを推奨します。RAM ユーザーは、CloudOps Orchestration Service リソースを管理するための権限が必要です。詳細については、「RAM を使用したアクセス制御」をご参照ください。
|
ユーザーアイデンティティ |
サポート |
|
サポート |
|
|
RAM ユーザー (推奨) |
サポート |
|
RAM ロール (推奨) |
サポート |
詳細情報
統合方法
OpenAPI の呼び出しには、SDK の使用を推奨します。
統合方法の概要
|
方法 |
サポート |
|
サポート |
|
|
サポート |
|
|
サポート |
|
|
サポート |
-
Alibaba Cloud SDK
-
Alibaba Cloud は、Java、C#、Go、Python、Node.js/TypeScript、PHP、および C++ 用の SDK を提供しています。SDK は、署名ロジック、タイムアウト、および再試行を処理し、構造化されたレスポンスオブジェクトを返します。詳細については、「Alibaba Cloud SDK」をご参照ください。
-
Alibaba Cloud SDK を使用して CloudOps Orchestration Service を呼び出すことができます。サポートされている言語とインストール方法については、「CloudOps Orchestration Service SDK」をご参照ください。
-
-
Alibaba Cloud CLI
-
Alibaba Cloud CLI は、Alibaba Cloud 製品を管理するために OpenAPI をベースに構築されたコマンドラインツールです。詳細については、「Alibaba Cloud CLI とは」をご参照ください。
-
Alibaba Cloud CLI を使用して CloudOps Orchestration Service を呼び出すことができます。詳細については、「CLI 統合の例」をご参照ください。
-
-
Resource Orchestration Service (ROS)
-
Resource Orchestration Service (ROS) は、テンプレートを通じてクラウドリソースプロビジョニングを自動化します。ECS インスタンスや ApsaraDB RDS インスタンスなどのリソースとその依存関係を定義すると、ROS エンジンがそれらを自動的に作成および設定します。詳細については、「Resource Orchestration Service とは」をご参照ください。
-
ROS を使用して CloudOps Orchestration Service を呼び出すことができます。詳細については、「ROS 統合の例」をご参照ください。
-
-
カスタム API 呼び出しのカプセル化
ネイティブ HTTP 呼び出しの場合、署名アルゴリズムを実装し、リクエストを構築してください。詳細については、「CloudOps Orchestration Service API の概要」および「V3 リクエストボディと署名メカニズム」をご参照ください。
注意事項
CloudOps Orchestration Service の API 呼び出しでエラーが返された場合は、エラーコードとリクエストパラメータを確認してください。
また、レスポンスまたは SDK のエラーメッセージで返された RequestID を記録し、Alibaba Cloud OpenAPI 診断プラットフォームを使用して自己診断を実行することもできます。
よくある質問
-
CloudOps Orchestration Service は Alibaba Cloud の自動化された O&M サービスです。テンプレートでタスク、実行順序、入力、出力を定義し、それらを実行して運用を自動化します。詳細については、「CloudOps Orchestration Service とは」をご参照ください。
-
CloudOps Orchestration Service でサポートされている SDK 言語については、「CloudOps Orchestration Service SDK リファレンス」をご参照ください。