Поделиться через


Создание списка дочерних элементов ресурса driveItem

Пространство имен: microsoft.graph

Возвращает коллекцию DriveItems в дочерние элементы ресурса DriveItem.

Ресурсы DriveItem с аспектом папки или пакета, отличным от NULL, могут содержать один или несколько дочерних элементов DriveItem.

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированные (рабочая или учебная учетная запись) Files.Read Files.ReadWrite, Files.Read.All, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All
Делегированные (личная учетная запись Майкрософт) Files.Read Files.ReadWrite, Files.Read.All, Files.ReadWrite.All
Приложение Files.Read.All Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All

HTTP-запрос

GET /drives/{drive-id}/items/{item-id}/children
GET /groups/{group-id}/drive/items/{item-id}/children
GET /me/drive/items/{item-id}/children
GET /sites/{site-id}/drive/items/{item-id}/children
GET /users/{user-id}/drive/items/{item-id}/children

Необязательные параметры запросов

Этот метод поддерживает $expandпараметры запроса ,$select, $skipTokenи $orderby$top OData для настройки ответа.

Заголовки запросов

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.
if-none-match etag. Если указан этот заголовок запроса, а предоставленный тег eTag (или cTag) совпадает с текущим тегом в файле, то будет возвращен отклик HTTP 304 Not Modified.

Примеры

Создание списка дочерних элементов в корневой папке диска текущего пользователя

Чтобы получить файлы, расположенные в корневой папке диска, используйте связь root для диска, а затем получите доступ к связи дочернего элемента.

GET /me/drive/root/children

Создание списка дочерних элементов ресурса driveItem с использованием известного идентификатора

Чтобы получить файлы, расположенные в корневой папке диска, используйте связь root для диска, а затем получите доступ к связи дочернего элемента.

GET /drives/{drive-id}/items/{item-id}/children

Создание списка дочерних элементов ресурса driveItem с использованием известного пути

GET https://graph.microsoft.com/v1.0/drives/{drive-id}/root:/{path-relative-to-root}:/children

Ответ

При успешном выполнении этот метод возвращает список элементов в коллекции дочерних элементов для целевого элемента. Коллекция дочерних элементов будет состоять из ресурсов driveItem.

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

{
  "value": [
    {"name": "myfile.jpg", "size": 2048, "file": {} },
    {"name": "Documents", "folder": { "childCount": 4} },
    {"name": "Photos", "folder": { "childCount": 203} },
    {"name": "my sheet(1).xlsx", "size": 197 }
  ],
  "@odata.nextLink": "https://..."
}

Примечание. Если коллекция превышает размер страницы по умолчанию (200 элементов), свойство @odata.nextLink возвращается в отклике, чтобы указать доступность дополнительных элементов и предоставить запрашиваемый URL-адрес для следующей страницы элементов.

Вы можете управлять размером страницы с помощью необязательных параметров строки запроса

Ответы с ошибками

Дополнительные сведения о возвращении ошибок см. в статье Ответы с ошибками.