編輯

共用方式為


Get bundle

Namespace: microsoft.graph

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

This API is available in the following national cloud deployments.

Global service US Government L4 US Government L5 (DOD) China operated by 21Vianet

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.

Permission type Least privileged permissions Higher privileged permissions
Delegated (work or school account) Not supported. Not supported.
Delegated (personal Microsoft account) Files.Read Files.Read.All, Files.ReadWrite, Files.ReadWrite.All
Application Not supported. Not supported.

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.

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

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.

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

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/..."
}