調用ListFoldersForParent查詢指定資源夾的子資源夾列表。

說明 只能查看指定資源夾下一級的子資源夾列表,無法查看更深層級的資源夾列表。

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String ListFoldersForParent

要執行的操作。取值:ListFoldersForParent

ParentFolderId String r-b1****

父資源夾ID。

當該參數置空時,查詢的是Root資源夾下的下一級子資源夾。

QueryKeyword String rdFolder

查詢關鍵字,例如:資源夾名稱。

支持模糊查詢。

PageNumber Integer 1

頁碼。

起始值:1。默認值:1。

PageSize Integer 10

分頁時每頁顯示的數據行數。

取值范圍:1~100。默認值:10。

返回數據

名稱 類型 示例值 描述
TotalCount Integer 2

數據總條數。

RequestId String 7B8A4E7D-6CFF-471D-84DF-195A7A241ECB

請求ID。

PageSize Integer 5

分頁時每頁顯示的數據行數。

PageNumber Integer 1

頁碼。

Folders Array of Folder

資源夾列表。

Folder
FolderId String rd-evic31****

資源夾ID。

CreateTime String 2015-01-23T12:33:18Z

資源夾創建時間。

FolderName String project-1

資源夾名稱。

示例

請求示例

https://resourcemanager.aliyuncs.com/?Action=ListFoldersForParent
&ParentFolderId=r-b1****
&<公共請求參數>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<ListFoldersForParentResponse>
        <RequestId>7B8A4E7D-6CFF-471D-84DF-195A7A241ECB</RequestId>
        <PageNumber>1</PageNumber>
        <PageSize>5</PageSize>
        <TotalCount>2</TotalCount>
        <Folders>
            <Folder>
                <FolderId>rd-evic31****</FolderId>
                <FolderName>project-1</FolderName>
                <CreateTime>2015-01-23T12:33:18Z</CreateTime>
            </Folder>
            <Folder>
                <FolderId>fd-evic31****</FolderId>
                <FolderName>project-2</FolderName>
                <CreateTime>2015-01-23T12:33:18Z</CreateTime>
            </Folder>
        </Folders>
</ListFoldersForParentResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "7B8A4E7D-6CFF-471D-84DF-195A7A241ECB",
  "PageNumber" : 1,
  "PageSize" : 5,
  "TotalCount" : 2,
  "Folders" : {
    "Folder" : [ {
      "FolderId" : "rd-evic31****",
      "Name" : "project-1",
      "CreateDate" : "2015-01-23T12:33:18Z"
    }, {
      "FolderId" : "fd-evic31****",
      "Name" : "project-2",
      "CreateDate" : "2015-01-23T12:33:18Z"
    } ]
  }
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 InvalidParameter.ParentFolderId The ParentFolderId is invalid. 父資源夾ID無效,資源夾ID應以“r-”開頭+6位數字或英文字母或以“fd-”開頭+10位數字或英文字母。
404 EntityNotExists.ResourceDirectory The resource directory for the account is not enabled. We recommend that you first enable the resource directory for the account. 當前賬號未啟用資源目錄,請先啟用資源目錄。
404 EntityNotExists.Folder The resource directory folder does not exist. 資源夾不存在,請先創建資源夾。

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