Skip to content

bundle-get.md

Latest commit

 

History

History
218 lines (153 loc) · 7.78 KB

bundle-get.md

File metadata and controls

218 lines (153 loc) · 7.78 KB
author spgraph-docs-team
title Get bundle
description Get a bundle of driveItems.
ms.localizationpriority medium
ms.subservice sharepoint
doc_type apiPageType
ms.date 04/04/2024

Get bundle

Namespace: microsoft.graph

Retrieve the metadata for a bundle based on the unique ID of the bundle.

[!INCLUDE national-cloud-support]

Permissions

Choose the permission or permissions marked as least privileged for this API. Use a higher privileged permission or permissions only if your app requires it. For details about delegated and application permissions, see Permission types. To learn more about these permissions, see the permissions reference.

[!INCLUDE permissions-table]

HTTP request

GET /drive/bundles/{bundle-id}
GET /drive/items/{bundle-id}

Because bundles are items, you can use the items collection to return metadata about a bundle. You can also use the bundles collection as a convenience to ensure you get a bundle in the response.

Optional query parameters

This method supports the OData query parameters to help customize the response.

Request headers

Name Description
Authorization Bearer {token}. Required. Learn more about authentication and authorization.
if-none-match eTag. Optional. If this request header is included and the eTag (or cTag) provided matches the current tag on the file, a 304 Not Modified response is returned.

Request body

Don't supply a request body for this method.

Response

If successful, this method returns a 200 OK response code and a driveItem object that contains the bundle in the response body.

For information about error responses, see Microsoft Graph error responses and resource types.

Examples

Example 1: Get a bundle

Request

The following example shows a request.

HTTP

GET https://graph.microsoft.com/v1.0/drive/bundles/{bundle-id}

C#

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Go

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Java

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PHP

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PowerShell

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Python

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

The following example shows the response.

Note: The response object shown here might be shortened for readability.

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

{
  "id": "0123456789abc",
  "name": "My Photo Album Bundle",
  "eTag": "etag",
  "cTag": "etag",
  "createdBy": { "user": { "id": "1234", "displayName": "Ryan Gregg" } },
  "createdDateTime": "datetime",
  "lastModifiedBy": { "user": { "id": "1234", "displayName": "Ryan Gregg" } },
  "lastModifiedDateTime": "datetime",
  "size": 1234,
  "webUrl": "http://onedrive.com/...",
  "bundle": {
    "childCount": 4,
     "album": { }
  }
}

Example 2: Get a bundle and its children in a single call

Use the expand query string parameter to include the children of a bundle in the same request that retrieves the metadata of a bundle.

Request

The following example shows a request.

HTTP

GET https://graph.microsoft.com/v1.0/drive/items/{bundle-id}?expand=children

C#

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Go

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Java

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

JavaScript

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PHP

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

PowerShell

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Python

[!INCLUDE sample-code] [!INCLUDE sdk-documentation]

Response

The following example shows the response. This call will return the bundle metadata and a list of children of the bundle. If the bundle has no children, it will return an empty collection.

If the number of children in the bundle is greater than the default page size, the children@odata.nextLink property will be returned with a URL that can be used to request the next page of children in the bundle.

Note: The response object shown here might be shortened for readability.

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

{
  "id": "101230100alkc",
  "name": "My Cool Day at the Beach",
  "children": [
    { "id": "120100abab", "name": "image1.jpg", "file": {} },
    { "id": "120100abo1", "name": "image2.jpg", "file": {} }
  ],
  "children@odata.nextLink": "https://api.onedrive.com/v1.0/..."
}