全部產品
Search

搜尋本產品

    Resource Orchestration Service：GetStackResource

    文件中心

    Resource Orchestration Service：GetStackResource

    更新時間：Jun 17, 2026

    查詢某個資源棧的資源。

    介面說明

    本文將提供一個示例，為您查詢杭州地域資源棧 ID 為4a6c9851-3b0f-4f5f-b4ca-a14bf691****的資源棧中名為WebServer的資源詳情。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    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

    建立時間。按照 ISO8601 標準表示，使用 UTC+0 時間，但缺少 Z 結尾，格式：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

    更新時間。按照 ISO8601 標準表示，使用 UTC+0 時間，但缺少 Z 結尾，格式：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

    包含資源的一個或多個模組的邏輯 ID 的串聯列表。模組從最外層開始列出，並以 / 分隔。

    在以下示例中，資源是從巢狀在父模組 moduleA 中的模組 moduleB 建立的。

    moduleA/moduleB。

    moduleA/moduleB

    TypeHierarchy

    string

    包含資源的一個或多個模組類型的串聯列表。模組類型從最外層開始列出，並以 / 分隔。

    在以下示例中，資源是從MODULE::ROS::Child::Example類型的模組建立的，該模組巢狀在MODULE::ROS::Parent::Example類型的父模組中。

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

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

    樣本

    正常返回樣本

    JSON格式

    {
  "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"
  }
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。