すべてのプロダクト
Search

このプロダクト

    :GetStackGroupOperation

    ドキュメントセンター

    :GetStackGroupOperation

    最終更新日:Jun 04, 2026

    Alibaba Cloud のリージョン内でのスタックグループのオペレーションに関する情報をクエリします。

    操作説明

    この例では、ID が 6da106ca-1784-4a6f-a7e1-e723863d**** のスタックグループオペレーションに関する情報を照会します。MyStackGroup という名前のスタックグループには自己管理権限が付与され、 China (Hangzhou) リージョンにデプロイされています。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ros:GetStackGroupOperation

    get

    *StackGroupOperation

    acs:ros:{#regionId}:{#accountId}:stackgroupoperation/{#OperationId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    スタックグループのリージョン ID です。DescribeRegions オペレーションを呼び出して、最新のリージョンリストを取得できます。

    cn-hangzhou
    OperationId

    string

    必須

    オペレーション ID です。ListStackGroupOperations オペレーションを呼び出して、オペレーション ID を取得できます。

    6da106ca-1784-4a6f-a7e1-e723863d****

    共通リクエストパラメーターの詳細については、「共通パラメータ」をご参照ください。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID です。

    14A07460-EBE7-47CA-9757-12CC4761D47A
    StackGroupOperation

    object

    スタックグループオペレーションに関する情報です。

    Status

    string

    オペレーションの状態です。

    有効な値：

    • RUNNING

    • SUCCEEDED

    • FAILED

    • STOPPING

    • STOPPED

    SUCCEEDED
    StackGroupId

    string

    スタックグループの ID です。

    fd0ddef9-9540-4b42-a464-94f77835****
    Action

    string

    オペレーションの種類です。

    有効な値：

    • CREATE

    • UPDATE

    • DELETE

    • DETECT_DRIFT

    DELETE
    CreateTime

    string

    オペレーションが開始された時刻です。

    2020-01-20T09:22:3
    RetainStacks

    boolean

    関連付けられたスタックインスタンスが削除されたときにスタックを保持するかどうかを示します。スタックインスタンスを削除する際に、関連付けられたスタックを削除するか保持するかを選択できます。

    有効な値：

    • true： 関連付けられたスタックインスタンスが削除されたときにスタックが保持されます。

    • false： 関連付けられたスタックインスタンスが削除されたときにスタックが削除されます。慎重に操作してください。

    説明

    このパラメータは、スタックインスタンスを削除する場合にのみ返されます。

    true
    StackGroupName

    string

    スタックグループの名前です。

    MyStackGroup
    OperationId

    string

    オペレーション ID です。

    6da106ca-1784-4a6f-a7e1-e723863d****
    OperationDescription

    string

    オペレーションの説明です。

    説明

    このパラメータは、CreateStackInstances API を呼び出してスタックインスタンスを作成する際に OperationDescription を指定した場合にのみ返されます。

    Create stack instance in hangzhou
    StackGroupDriftDetectionDetail

    object

    ドリフト検出に関する情報です。

    説明

    このパラメータは、ドリフト検出が実行された場合にのみ返されます。

    DriftDetectionTime

    string

    ドリフト検出が実行された時刻です。

    2020-02-27T07:47:47
    TotalStackInstancesCount

    integer

    スタックインスタンスの総数です。

    2
    FailedStackInstancesCount

    integer

    ドリフト検出に失敗したスタックインスタンスの数です。

    0
    DriftDetectionStatus

    string

    ドリフト検出の状態です。

    有効な値：

    • COMPLETED： スタックグループでドリフト検出が実行され、すべてのスタックインスタンスがドリフト検出に合格しました。

    • FAILED： スタックグループでドリフト検出が実行されましたが、ドリフト検出に失敗したスタックインスタンスの数が指定のしきい値を超えています。

    • PARTIAL_SUCCESS： スタックグループでドリフト検出が実行され、ドリフト検出に失敗したスタックインスタンスの数は指定のしきい値を超えていません。

    • IN_PROGRESS： スタックグループでドリフト検出が実行中です。

    • STOPPED： スタックグループのドリフト検出が停止されました。

    COMPLETED
    StackGroupDriftStatus

    string

    スタックグループのドリフト状態です。

    有効な値：

    • DRIFTED： スタックグループ内の少なくとも 1 つのスタックインスタンスがドリフトしています。

    • NOT_CHECKED： スタックグループでドリフト検出が正常に実行されていません。

    • IN_SYNC： スタックグループ内のすべてのスタックインスタンスが同期処理中です。

    DRIFTED
    InProgressStackInstancesCount

    integer

    ドリフト検出が実行中のスタックインスタンスの数です。

    0
    InSyncStackInstancesCount

    integer

    同期処理中であったスタックインスタンスの数です。

    1
    CancelledStackInstancesCount

    integer

    ドリフト検出がキャンセルされたスタックインスタンスの数です。

    0
    DriftedStackInstancesCount

    integer

    ドリフトしたスタックインスタンスの数です。

    1
    OperationPreferences

    object

    オペレーション設定です。

    MaxConcurrentCount

    integer

    各リージョンで、スタックを同時にデプロイするアカウントの最大数。

    有効な値： 1 ～ 20。

    説明

    MaxConcurrentCount と MaxConcurrentPercentage のいずれか一方のみが返されます。

    1
    FailureToleranceCount

    integer

    各リージョンでスタックオペレーションの失敗が許容されるアカウントの数。あるリージョンでこの値を超えると、Resource Orchestration Service (ROS) はそのリージョンでのオペレーションを停止します。1 つのリージョンでオペレーションが停止されると、他のリージョンではそれ以上オペレーションは実行されません。

    有効な値： 0 ～ 20。

    説明

    FailureToleranceCount と FailureTolerancePercentage のいずれか一方のみが返されます。

    1
    MaxConcurrentPercentage

    integer

    各リージョンの総アカウント数に対し、同時にスタックをデプロイするアカウントの最大数の割合。

    有効な値： 1 ～ 100。

    説明

    MaxConcurrentCount と MaxConcurrentPercentage のいずれか一方のみが返されます。

    10
    RegionIdsOrder

    array

    オペレーションを実行するリージョンの順序です。

    string

    オペレーションが実行される順序でのリージョン ID です。

    ["cn-hangzhou","cn-beijing"]
    FailureTolerancePercentage

    integer

    各リージョンの総アカウント数に対し、スタックオペレーションの失敗が許容されるアカウント数の割合。あるリージョンでこの割合を超えると、ROS はそのリージョンでのオペレーションを停止します。

    有効な値： 0 ～ 100。

    説明

    FailureToleranceCount と FailureTolerancePercentage のいずれか一方のみが返されます。

    10
    EndTime

    string

    オペレーションが終了した時刻です。

    2020-01-20T09:22:4
    ExecutionRoleName

    string

    セルフマネージド型スタックグループを作成する際に実行アカウントに指定する RAM ロールの名前。管理者ロール AliyunROSStackGroupAdministrationRole が実行ロールを引き受けてオペレーションを実行します。このパラメータが指定されていない場合、デフォルト値 AliyunROSStackGroupExecutionRole が返されます。

    AliyunROSStackGroupExecutionRole
    AdministrationRoleName

    string

    セルフマネージド型スタックグループを作成する際に管理者アカウントに指定する RAM ロールの名前。ROS は管理者ロールを引き受けてオペレーションを実行します。このパラメータが指定されていない場合、デフォルト値 AliyunROSStackGroupAdministrationRole が返されます。

    AliyunROSStackGroupAdministrationRole
    DeploymentTargets

    object

    サービスマネージド型権限の場合の、スタックインスタンスのデプロイターゲットです。

    RdFolderIds

    array

    リソースディレクトリ内のフォルダーの ID リストです。

    string

    リソースディレクトリ内のフォルダーの ID です。

    ["fd-4PvlVLOL8v"]
    AccountIds

    array

    リソースディレクトリ内のメンバーの ID リストです。

    説明

    このパラメータは、UpdateStackInstances API を呼び出してスタックインスタンスを更新する際に AccountIds を指定した場合にのみ返されます。

    string

    リソースディレクトリ内のメンバーの ID です。

    説明

    このパラメータは、UpdateStackInstances API を呼び出してスタックインスタンスを更新する際に AccountIds を指定した場合にのみ返されます。

    ["151266687691****","141261387191****"]

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
  "StackGroupOperation": {
    "Status": "SUCCEEDED",
    "StackGroupId": "fd0ddef9-9540-4b42-a464-94f77835****",
    "Action": "DELETE",
    "CreateTime": "2020-01-20T09:22:3",
    "RetainStacks": true,
    "StackGroupName": "MyStackGroup",
    "OperationId": "6da106ca-1784-4a6f-a7e1-e723863d****",
    "OperationDescription": "Create stack instance in hangzhou",
    "StackGroupDriftDetectionDetail": {
      "DriftDetectionTime": "2020-02-27T07:47:47",
      "TotalStackInstancesCount": 2,
      "FailedStackInstancesCount": 0,
      "DriftDetectionStatus": "COMPLETED",
      "StackGroupDriftStatus": "DRIFTED",
      "InProgressStackInstancesCount": 0,
      "InSyncStackInstancesCount": 1,
      "CancelledStackInstancesCount": 0,
      "DriftedStackInstancesCount": 1
    },
    "OperationPreferences": {
      "MaxConcurrentCount": 1,
      "FailureToleranceCount": 1,
      "MaxConcurrentPercentage": 10,
      "RegionIdsOrder": [
        "[\"cn-hangzhou\",\"cn-beijing\"]"
      ],
      "FailureTolerancePercentage": 10
    },
    "EndTime": "2020-01-20T09:22:4",
    "ExecutionRoleName": "AliyunROSStackGroupExecutionRole",
    "AdministrationRoleName": "AliyunROSStackGroupAdministrationRole",
    "DeploymentTargets": {
      "RdFolderIds": [
        "[\"fd-4PvlVLOL8v\"]"
      ],
      "AccountIds": [
        "[\"151266687691****\",\"141261387191****\"]"
      ]
    }
  }
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。