Todos os produtos
Search
Central de documentação

Resource Management:ListFoldersForParent

Última atualização: Jul 04, 2026

Consulta as informações de todas as subpastas de uma pasta.

Descrição da operação

Você pode chamar esta operação de API para visualizar as informações apenas das subpastas de primeiro nível de uma pasta.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

ParentFolderId

string

Não

O ID da pasta pai.

Se você deixar este parâmetro vazio, as informações das subpastas de primeiro nível da pasta raiz serão consultadas.

r-b1****

QueryKeyword

string

Não

A palavra-chave usada para a consulta, como o nome de uma pasta.

Há suporte para correspondência aproximada.

rdFolder

PageNumber

integer

Não

O número da página a ser retornada.

As páginas começam na página 1. Valor padrão: 1.

1

PageSize

integer

Não

O número de entradas a serem retornadas em cada página.

Valores válidos: 1 a 100. Valor padrão: 10.

10

Tag

array<object>

Não

As tags. Este parâmetro especifica uma condição de filtro.

object

Não

Uma tag.

Key

string

Não

A chave da tag.

k1

Value

string

Não

O valor da tag.

v1

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O resultado retornado.

Folders

object

Folder

array<object>

As pastas.

array<object>

As informações sobre uma pasta.

CreateTime

string

The time when the folder was created.

2015-01-23T12:33:18Z

FolderId

string

The ID of the folder.

rd-evic31****

FolderName

string

The name of the folder.

project-1

Tags

object

Tag

array<object>

The tags added to the folder.

object

The tag added to the folder.

Key

string

The key of the tag.

k1

Value

string

The value of the tag.

v1

PageNumber

integer

O número da página retornada.

1

PageSize

integer

O número de entradas retornadas por página.

5

RequestId

string

O ID da solicitação.

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

TotalCount

integer

O número total de entradas retornadas.

2

Exemplos

Resposta de sucesso

JSON formato

{
  "Folders": {
    "Folder": [
      {
        "CreateTime": "2015-01-23T12:33:18Z",
        "FolderId": "rd-evic31****",
        "FolderName": "project-1",
        "Tags": {
          "Tag": [
            {
              "Key": "k1",
              "Value": "v1"
            }
          ]
        }
      }
    ]
  },
  "PageNumber": 1,
  "PageSize": 5,
  "RequestId": "7B8A4E7D-6CFF-471D-84DF-195A7A241ECB",
  "TotalCount": 2
}

Códigos de erro

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

400 InvalidParameter.ParentFolderId The ParentFolderId is invalid.
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.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.