次の表に、ROS (Resource Orchestration Service) で使用できるAPI操作を示します。
スタック操作
スタック内のリソースとその依存関係のテンプレートを定義し、そのテンプレートを使用してスタックを作成できます。 スタックの作成後、スタックを照会、更新、または削除できます。
| API | 説明 |
| PreviewStack | 指定したテンプレートを使用して作成するスタックをプレビューします。 |
| CreateStack | スタックを作成します。 |
| ContinueCreateStack | 失敗した前のスタックのテンプレートに基づいて別のスタックを作成します。 |
| SetDeletionProtection | スタックの削除保護を設定します。 |
| UpdateStack | スタックを更新します。 |
| CancelUpdateStack | スタックの更新をキャンセルします。 |
| GetStack | スタックの情報を照会します。 |
| リストスタック | スタックのリストを照会します。 |
| ListStackEvents | スタックとそのリソースイベントを照会します。 |
| ListStackOperationRisks | スタック削除操作によって発生するリスクが高いリソースを検出し、リスクごとに理由を照会します。 |
| DeleteStack | スタックとそのすべてのリソースを削除します。 |
リソース操作
ROSを使用すると、さまざまなリソースを管理できます。 リソーステンプレートをリソースタイプ別に照会するか、指定したスタック内のリソースタイプまたはリソースの詳細を照会して、ROS内のリソースの情報を取得できます。
ROSでサポートされているリソースタイプの詳細については、「サービス別のリソースタイプのリスト」をご参照ください。
| API | 説明 |
| GetResourceTypeTemplate | リソースのテンプレートをリソースタイプごとに照会します。 |
| ListStackResources | 指定したスタックのリソースリストを照会します。 |
| GetStackResource | 指定されたスタック内のリソースに関する情報を照会します。 |
| GetResourceType | リソースタイプの詳細を照会します。 |
| ListResourceTypes | サポートされているリソースタイプのリストを照会します。 |
| MoveResourceGroup | リソースを特定のリソースグループに移動します。 |
シナリオ操作
ROSは、リソース管理を容易にするシナリオ機能を提供します。 コンソールでシナリオにリソースを追加し、リソースのレプリケーションや集中管理などの操作を実行できます。
| API | 説明 |
| CreateTemplateScratch | シナリオを作成します。 |
| UpdateTemplateScratch | シナリオを更新します。 |
| ListTemplateScratches | シナリオのリストを照会します。 |
| GetTemplateScratch | シナリオの情報を照会します。 |
| DeleteTemplateScratch | シナリオを削除します。 |
| GenerateTemplateByScratch | シナリオテンプレートを生成します。 |
テンプレート操作
テンプレートは、スタック内のリソースとその依存関係を定義するJSONまたはYAMLテキストファイルで、スタックの作成に使用できます。 たとえば、CreateTemplate操作を呼び出してALIYUN::ECS::VPCリソースを含むテンプレートを作成し、CreateStack操作を呼び出してスタックを作成します。 これにより、仮想プライベートクラウド (VPC) を作成できます。
さらに、テンプレートID、テンプレートコンテンツ、またはテンプレートで定義されているリソース価格を照会できます。 テンプレートを他のユーザーと共有することもできます。 これにより、複数のAlibaba Cloudアカウントで1つのテンプレートを使用して、スタックを効率的に作成できます。
| API | 説明 |
| GenerateTemplatePolicy | テンプレートのポリシー情報を生成します。 |
| CreateTemplate | テンプレートを作成します。 |
| ValidateTemplate | スタックの作成に使用するテンプレートを検証します。 |
| UpdateTemplate | テンプレートを更新します。 |
| GetTemplate | テンプレートに関連付けられているスタックや変更セットなど、テンプレートの詳細情報を照会します。 |
| GetTemplateEstimateCost | テンプレートに基づいて作成されるリソースの推定価格を照会します。 |
| GetTemplateSummary | 新規または既存のテンプレートの情報を照会します。 |
| GetTemplateParameterConstraints | テンプレートパラメーターの値を照会します。 |
| ListTemplates | テンプレートのリストを照会します。 |
| ListTemplateVersions | テンプレートの1つ以上のバージョンを照会します。 |
| SetTemplatePermission | テンプレートを共有または共有解除します。 |
| DeleteTemplate | テンプレートを削除します。 |
スタックポリシー操作
スタックポリシーは、指定されたスタックの更新操作を定義して、スタックの更新中にスタック内のリソースが誤って更新または削除されないようにするために使用されるJSONまたはYAMLテキストファイルです。 スタックポリシーを設定または照会できます。
| API | 説明 |
| SetStackPolicy | スタックポリシーを設定します。 |
| GetStackPolicy | スタックポリシーの情報を照会します。 |
セット操作の変更
変更セットを作成および実行して、実行中のスタックを更新できます。
| API | 説明 |
| CreateChangeSet | 変更セットを作成します。 |
| ExecuteChangeSet | 変更セットを実行します。 |
| GetChangeSet | 変更セットの情報を照会します。 |
| ListChangeSets | 変更セットのリストを照会します。 |
| DeleteChangeSet | 変更セットを削除します。 |
スタックグループ操作
スタックグループをユニットとして使用して、ROSでスタックを管理できます。 テンプレートを使用してスタックグループを作成できます。 これにより、リージョン間で複数のAlibaba Cloudアカウント内にスタックを作成できます。 スタックグループとスタックグループ操作の情報を照会することもできます。
CreateStackGroup操作を呼び出してスタックグループを作成した後、CreateStackInstances操作を呼び出して、指定したリージョンの指定したアカウント内にスタックインスタンスを作成できます。
| API | 説明 |
| CreateStackGroup | スタックグループを作成します。 |
| UpdateStackGroup | スタックグループを更新します。 |
| GetStackGroup | スタックグループの情報を照会します。 |
| ListStackGroups | スタックグループのリストを照会します。 |
| GetStackGroupOperation | スタックグループ操作の情報を照会します。 |
| ListStackGroupOperations | スタックグループ操作のリストを照会します。 |
| ListStackGroupOperationResults | スタックグループに対する操作の結果を照会します。 |
| StopStackGroupOperation | スタックグループ操作を停止します。 |
| CreateStackInstances | 指定したリージョンの指定したアカウント内にスタックインスタンスを作成します。 |
| UpdateStackInstances | 指定したリージョンの指定したアカウント内のスタックインスタンスを更新します。 |
| GetStackInstance | スタックグループに関連付けられているスタックインスタンスの詳細情報を照会します。 |
| ListStackInstances | スタックグループに関連付けられているスタックインスタンスを照会します。 |
| DeleteStackInstances | 指定したリージョンの指定したアカウント内のスタックインスタンスを削除します。 |
| DeleteStackGroup | スタックグループを削除します。 |
ドリフト検出操作
ROSの制御が及ばないサービスを使用してリソース構成を変更すると、関連するスタックまたはスタックグループがドリフトする可能性があります。 ドリフト検出を実行してドリフトを修正できます。 たとえば、DetectStackDrift操作を呼び出して、スタックのドリフト検出を実行できます。 スタックがドリフトしている場合は、UpdateStackTemplateByResourcesを呼び出してスタックテンプレートを変更し、スタックドリフトを解消できます。
| API | 説明 |
| DetectStackResourceDrift | スタック内の個々のリソースのドリフトを検出します。 |
| DetectStackDrift | スタック上のドリフトを検出します。 |
| DetectStackGroupDrift | スタックグループのドリフトを検出します。 |
| GetStackDriftDetectionStatus | スタックのドリフト検出ステータスを照会します。 |
| ListStackResourceDrifts | 指定したスタック内のリソースのドリフト情報を照会します。 |
| UpdateStackTemplateByResources | テンプレートを修正してスタックドリフトを除去します。 |
タグ操作
分類と管理の目的で、スタック、スタックグループ、またはテンプレートにタグを追加できます。
| API | 説明 |
| TagResources | 指定したROSリソースリストにタグを作成して追加します。 |
| ListTagResources | 1つ以上のROSリソースに追加されたタグを照会します。 |
| ListTagKeys | タグキーのリストを照会します。 |
| ListTagValues | 指定されたタグキーの1つ以上の値を照会します。 |
| UntagResources | 指定したROSリソースリストからタグを削除および削除します。 |
その他の操作
スタック、スタックグループ、またはスタックインスタンスを作成するときは、RegionIdパラメーターを指定する必要があります。 この場合、DescribeRegions操作を呼び出して、最新のリージョンリストを照会できます。
スタックを作成または更新するときに、SignalResource操作を呼び出してシグナルを送信できます。 障害信号により、スタックの作成または更新が失敗する可能性があります。
さらに、GetServiceProvisionsを呼び出して複数のクラウドサービスのアクティベーションステータスとRAMロール情報を同時に照会し、GetFeatureDetailsを呼び出してROSでサポートされている特定の機能の詳細を照会できます。
| API | 説明 |
| DescribeRegions | 利用可能なリージョンを照会します。 |
| SignalResource | 信号を送信します。 |
| GetServiceProvisions | Alibaba CloudサービスのアクティベーションステータスとRAMロールを照会します。 |
| GetFeatureDetails | ROSでサポートされている機能の詳細を照会します。 |