Alibaba Cloud のリージョンで、スタックグループの詳細を名前で照会します。
操作説明
このトピックでは、中国 (杭州) リージョンにあり、セルフマネージド権限モードを使用するスタックグループ MyStackGroup をクエリする例を示します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
ros:GetStackGroup |
get |
*StackGroup
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| RegionId |
string |
必須 |
スタックグループが属するリージョンの ID。 最新のリージョンリストを照会するには、DescribeRegions API を呼び出します。 |
cn-hangzhou |
| StackGroupName |
string |
任意 |
スタックグループの名前。名前はリージョン内で一意である必要があります。名前は最大 255 文字で、先頭は数字または英字にする必要があります。使用できる文字は、数字、英字、ハイフン (-)、アンダースコア (_) です。 説明
StackGroupName パラメーターと StackGroupId パラメーターのいずれか一方のみを指定する必要があります。 |
MyStackGroup |
| StackGroupId |
string |
任意 |
スタックグループの ID。 説明
StackGroupName パラメーターと StackGroupId パラメーターのいずれか一方のみを指定する必要があります。 |
fd0ddef9-9540-4b42-a464-94f77835**** |
共通リクエストパラメータについては、「共通パラメータ」をご参照ください。
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| RequestId |
string |
リクエスト ID です。 |
14A07460-EBE7-47CA-9757-12CC4761D47A |
| StackGroup |
object |
スタックグループの詳細です。 |
|
| StackGroupId |
string |
スタックグループの ID です。 |
fd0ddef9-9540-4b42-a464-94f77835**** |
| Status |
string |
スタックグループのステータスです。 有効な値：
|
ACTIVE |
| AdministrationRoleName |
string |
ROS が引き受ける RAM 管理者ロールの名前です。 このパラメーターは、自己管理権限モードでスタックグループを作成するときに指定します。 このパラメーターを指定しない場合、デフォルト値の AliyunROSStackGroupAdministrationRole が返されます。 |
AliyunROSStackGroupAdministrationRole |
| Parameters |
array<object> |
スタックグループのパラメーターのリストです。 |
|
|
object |
|||
| ParameterKey |
string |
パラメーターの名前です。 |
Amount |
| ParameterValue |
string |
パラメーターの値です。 |
12 |
| Description |
string |
スタックグループの説明です。 |
StackGroup Description |
| StackGroupName |
string |
スタックグループの名前です。 |
MyStackGroup |
| ExecutionRoleName |
string |
管理者ロール AliyunROSStackGroupAdministrationRole が引き受ける RAM 実行ロールの名前です。 このパラメーターは、自己管理権限モードでスタックグループを作成するときに指定します。 このパラメーターを指定しない場合、デフォルト値の AliyunROSStackGroupExecutionRole が返されます。 |
AliyunROSStackGroupExecutionRole |
| TemplateBody |
string |
テンプレートボディの構造です。 説明
このパラメーターの使用は推奨しません。代わりに TemplateContent を使用してください。 |
{"ROSTemplateFormatVersion": "2015-09-01"} |
| StackGroupDriftDetectionDetail |
object |
スタックグループで最後に成功したドリフト検出操作の詳細です。 |
|
| DriftDetectionTime |
string |
スタックグループでドリフト検出操作が実行された時刻です。 |
2020-02-27T07:47:47 |
| TotalStackInstancesCount |
integer |
スタックインスタンスの数です。 |
2 |
| FailedStackInstancesCount |
integer |
ドリフト検出操作が失敗したスタックインスタンスの数です。 |
0 |
| DriftDetectionStatus |
string |
スタックグループのドリフト検出ステータスです。 有効な値：
|
COMPLETED |
| StackGroupDriftStatus |
string |
スタックグループのドリフトステータスです。 有効な値：
|
DRIFTED |
| InProgressStackInstancesCount |
integer |
ドリフト検出操作が進行中のスタックインスタンスの数です。 |
0 |
| InSyncStackInstancesCount |
integer |
IN_SYNC 状態のスタックインスタンスの数です。 |
1 |
| CancelledStackInstancesCount |
integer |
ドリフト検出操作がキャンセルされたスタックインスタンスの数です。 |
0 |
| DriftedStackInstancesCount |
integer |
DRIFTED 状態のスタックインスタンスの数です。 |
1 |
| ResourceGroupId |
string |
リソースグループの ID です。 この値は、スタックグループの作成時に指定したリソースグループ ID によって決まります。 |
rg-acfmxazb4ph6aiy**** |
| PermissionModel |
string |
権限モデルです。 有効な値：
説明
スタックグループの権限モデルの詳細については、「概要」をご参照ください。 |
SELF_MANAGED |
| AutoDeployment |
object |
自動デプロイメントの設定情報です。 説明
このパラメーターは、PermissionModel が SERVICE_MANAGED に設定されている場合にのみ返されます。 |
|
| Enabled |
boolean |
自動デプロイメントが有効か無効かを示します。 有効な値：
|
true |
| RetainStacksOnAccountRemoval |
boolean |
メンバーアカウントがフォルダーから削除されたときに、そのメンバーアカウントのスタックを保持するかどうかを示します。 有効な値：
説明
このパラメーターは、Enabled が true に設定されている場合にのみ返されます。 |
true |
| RdFolderIds |
array |
リソースディレクトリ内のフォルダーの ID リストです。スタックインスタンスは、これらのフォルダー内のすべてのアカウントにデプロイされます。 説明
このパラメーターは、PermissionModel が SERVICE_MANAGED に設定されている場合にのみ返されます。 |
|
|
string |
リソースディレクトリ内のフォルダーの ID です。スタックインスタンスは、フォルダー内のすべてのアカウントにデプロイされます。 説明
このパラメーターは、PermissionModel が SERVICE_MANAGED に設定されている場合にのみ返されます。 |
["fd-4PvlVLOL8v"] |
|
| TemplateContent |
string |
テンプレートコンテンツの構造です。構造は JSON 形式です。詳細については、「テンプレート構文」をご参照ください。 |
{ "ROSTemplateFormatVersion": "2015-09-01" } |
| CreateTime |
string |
スタックグループが作成された時刻です。 |
2024-06-14T02:13:50 |
| UpdateTime |
string |
スタックグループが更新された時刻です。 |
2024-06-15T02:01:00 |
実行するアクション：値を GetStackGroup に設定します。
例
成功レスポンス
JSONJSON
{
"RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
"StackGroup": {
"StackGroupId": "fd0ddef9-9540-4b42-a464-94f77835****",
"Status": "ACTIVE",
"AdministrationRoleName": "AliyunROSStackGroupAdministrationRole",
"Parameters": [
{
"ParameterKey": "Amount",
"ParameterValue": "12"
}
],
"Description": "StackGroup Description",
"StackGroupName": "MyStackGroup",
"ExecutionRoleName": "AliyunROSStackGroupExecutionRole",
"TemplateBody": "{\"ROSTemplateFormatVersion\": \"2015-09-01\"}",
"StackGroupDriftDetectionDetail": {
"DriftDetectionTime": "2020-02-27T07:47:47",
"TotalStackInstancesCount": 2,
"FailedStackInstancesCount": 0,
"DriftDetectionStatus": "COMPLETED",
"StackGroupDriftStatus": "DRIFTED",
"InProgressStackInstancesCount": 0,
"InSyncStackInstancesCount": 1,
"CancelledStackInstancesCount": 0,
"DriftedStackInstancesCount": 1
},
"ResourceGroupId": "rg-acfmxazb4ph6aiy****",
"PermissionModel": "SELF_MANAGED",
"AutoDeployment": {
"Enabled": true,
"RetainStacksOnAccountRemoval": true
},
"RdFolderIds": [
"[\"fd-4PvlVLOL8v\"]"
],
"TemplateContent": "{\n \"ROSTemplateFormatVersion\": \"2015-09-01\"\n}",
"CreateTime": "2024-06-14T02:13:50",
"UpdateTime": "2024-06-15T02:01:00"
}
}エラーコード
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。