すべてのプロダクト
Search

このプロダクト

    :GetStackResource

    ドキュメントセンター

    :GetStackResource

    最終更新日:Jun 17, 2026

    特定のスタック内のリソースを照会します。

    操作説明

    この Topic では、中国（杭州）リージョンで ID が 4a6c9851-3b0f-4f5f-b4ca-a14bf691**** のスタック内にある WebServer という名前のリソースの詳細をクエリする例を示します。

    今すぐお試しください

    この 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:GetStackResource

    get

    *stack

    acs:ros:{#regionId}:{#accountId}:stack/{#stackId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    StackId

    string

    必須

    スタック ID。

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****
    ClientToken

    string

    任意

    リクエストのべき等性を確保するために使用されるクライアントトークン。値はクライアントによって生成され、グローバルに一意である必要があります。 値は最大 64 文字で、フォーマットには英字、数字、ハイフン（-）、アンダースコア（_）を含めることができます。 詳細については、「べき等性を確保する方法」をご参照ください。

    123e4567-e89b-12d3-a456-42665544****
    RegionId

    string

    必須

    スタックのリージョン ID。 DescribeRegions 操作を呼び出して、最新のリージョンリストをクエリできます。

    cn-hangzhou
    ShowResourceAttributes

    boolean

    任意

    リソース属性をクエリするかどうかを指定します。有効な値:

    • true: リソース属性をクエリします。

    • false: リソース属性をクエリしません。

    true
    LogicalResourceId

    string

    必須

    リソースの論理 ID。テンプレートで定義されたリソース名です。

    WebServer
    ResourceAttributes

    array

    任意

    クエリするリソース出力属性のリスト。

    説明

    N の最大値は 20 です。

    string

    任意

    クエリするリソース出力属性の名前。

    説明

    N の最大値は 20 です。

    InstanceId

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

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Status

    string

    リソースのステータス。有効な値:

    • CREATE_COMPLETE

    • CREATE_FAILED

    • CREATE_IN_PROGRESS

    • UPDATE_IN_PROGRESS

    • UPDATE_FAILED

    • UPDATE_COMPLETE

    • DELETE_IN_PROGRESS

    • DELETE_FAILED

    • CHECK_IN_PROGRESS

    • CHECK_FAILED

    • CHECK_COMPLETE

    • IMPORT_IN_PROGRESS

    • IMPORT_FAILED

    • IMPORT_COMPLETE。

    CREATE_COMPLETE
    Description

    string

    リソースの説明。

    no description
    RequestId

    string

    リクエスト ID。

    B288A0BE-D927-4888-B0F7-B35EF84B6E6
    StatusReason

    string

    リソースが現在の状態にある理由。

    state changed
    PhysicalResourceId

    string

    リソースの物理 ID。実際のリソース ID です。

    d04af923-e6b7-4272-aeaa-47ec9777****
    CreateTime

    string

    リソースが作成された時間。時間は UTC+0 で、Z サフィックスなしの ISO 8601 標準フォーマットで表示されます。フォーマット: YYYY-MM-DDThh:mm:ss。

    2019-08-01T06:01:23
    Metadata

    object

    メタデータ。

    {"key": "value"}
    ResourceType

    string

    リソースタイプ。

    ALIYUN::ROS::WaitConditionHandle
    ResourceAttributes

    array<object>

    リソース属性リスト。

    object

    リソース属性リスト。

    [{"ResourceAttributeKey": "CurlCli","ResourceAttributeValue": "curl -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'x-acs-region-id: cn-beijing' http://192.168.XX.XX/waitcondition?stackname=test-describe-resource\\&stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2****\\&resource=WaitConditionHandle\\&expire=156468****\\&signature=991d910a901a89db6580d74233119960c004****"}]
    LogicalResourceId

    string

    リソースの論理 ID。テンプレートで定義されたリソース名です。

    WebServer
    ResourceDriftStatus

    string

    スタックの最新の成功したドリフト検出におけるリソースのドリフトステータス。有効な値:

    • DELETED: リソースが削除されたため、期待されるテンプレート構成と異なります。

    • MODIFIED: リソースが期待されるテンプレート構成と異なります。

    • NOT_CHECKED: ROS はリソースが期待されるテンプレート構成と異なるかどうかを確認していません。

    • IN_SYNC: リソースの現在の構成が期待されるテンプレート構成と一致しています。

    IN_SYNC
    UpdateTime

    string

    リソースが最後に更新された時間。時間は UTC+0 で、Z サフィックスなしの ISO 8601 標準フォーマットで表示されます。フォーマット: YYYY-MM-DDThh:mm:ss。

    2019-08-01T06:01:29
    DriftDetectionTime

    string

    スタックのドリフト検出でリソースが最後に正常にチェックされた時間。

    2020-02-27T07:47:47
    StackName

    string

    スタック名。 名前は最大 255 文字で、数字または英字で始まる必要があります。数字、英字、ハイフン（-）、アンダースコア（_）を含めることができます。

    test-describe-resource
    StackId

    string

    スタック ID。

    efdf5c10-96a5-4fd7-ab89-68e7baa2****
    ModuleInfo

    object

    リソースの作成元モジュールの情報。このパラメーターは、リソースがモジュールから作成された場合にのみ返されます。フォーマットについてはモジュール仕様をご参照ください。

    LogicalIdHierarchy

    string

    リソースを含む 1 つ以上のモジュールの論理 ID を連結したリスト。モジュールは最も外側のモジュールから順に / で区切って表示されます。

    次の例では、リソースは親モジュール moduleA にネストされた moduleB から作成されました。

    moduleA/moduleB。

    moduleA/moduleB

    TypeHierarchy

    string

    リソースを含む 1 つ以上のモジュールのタイプを連結したリスト。モジュールタイプは最も外側のモジュールから順に / で区切って表示されます。

    次の例では、リソースは MODULE::ROS::Parent::Example タイプの親モジュールにネストされた MODULE::ROS::Child::Example タイプのモジュールから作成されました。

    MODULE::ROS::Parent::Example/MODULE::ROS::Child::Example。

    MODULE::ROS::Parent::Example/MODULE::ROS::Child::Example

    例

    成功レスポンス

    JSONJSON

    {
  "Status": "CREATE_COMPLETE",
  "Description": "no description",
  "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6",
  "StatusReason": "state changed",
  "PhysicalResourceId": "d04af923-e6b7-4272-aeaa-47ec9777****",
  "CreateTime": "2019-08-01T06:01:23",
  "Metadata": {
    "key": "value"
  },
  "ResourceType": "ALIYUN::ROS::WaitConditionHandle",
  "ResourceAttributes": [
    [
      {
        "ResourceAttributeKey": "CurlCli",
        "ResourceAttributeValue": "curl -i -X POST -H 'Content-Type: application/json' -H 'Accept: application/json' -H 'x-acs-region-id: cn-beijing' http://192.168.XX.XX/waitcondition?stackname=test-describe-resource\\&stackid=efdf5c10-96a5-4fd7-ab89-68e7baa2****\\&resource=WaitConditionHandle\\&expire=156468****\\&signature=991d910a901a89db6580d74233119960c004****"
      }
    ]
  ],
  "LogicalResourceId": "WebServer",
  "ResourceDriftStatus": "IN_SYNC",
  "UpdateTime": "2019-08-01T06:01:29",
  "DriftDetectionTime": "2020-02-27T07:47:47",
  "StackName": "test-describe-resource",
  "StackId": "efdf5c10-96a5-4fd7-ab89-68e7baa2****",
  "ModuleInfo": {
    "LogicalIdHierarchy": "moduleA/moduleB\n",
    "TypeHierarchy": "MODULE::ROS::Parent::Example/MODULE::ROS::Child::Example"
  }
}

    エラーコード

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

    変更履歴

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