調用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. | 資源夾不存在,請先創建資源夾。 |
訪問錯誤中心查看更多錯誤碼。