Browse a directory

Browse files in the directory with the specified ID.

Path Parameters

backup_id string required
Performs the operation on a directory within the specified backup.
filesystem_id string required
Performs the operation on a directory within the specified filesystem.
directory_id string required
Performs the operation on the directory with the specified ID.

Query Parameters

limit int64
Limits the size of the response on each page to the specified number of items.
start string
Sets the page token used to browse the collection. Leave this parameter empty to get the first page. Other pages can be traversed using HATEOAS links.

Responses

200
default

Success

application/api.clumio.backup-filesystem-directories=v1+json

Schema
Example (from schema)

Schema

_embedded object
Embedded responses related to the resource.
items object[]
A collection of requested items.
_links object
URLs to pages related to the resource.
_first object
The HATEOAS link to the first page of results.
href string
The URI for the referenced operation.
templated boolean
Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.
type string
The HTTP method to be used with the "href" link for the referenced operation.
_next object
The HATEOAS link to the next page of results.
href string
The URI for the referenced operation.
templated boolean
Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.
type string
The HTTP method to be used with the "href" link for the referenced operation.
_self object
The HATEOAS link to this resource.
href string
The URI for the referenced operation.
templated boolean
Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.
type string
The HTTP method to be used with the "href" link for the referenced operation.
directory_id string
The directory ID of the file. If the file is not a directory, then this field has a value of null.
is_directory boolean
Determines whether or not this file is a directory. If true, then this file is a directory.
modified_timestamp string
The timestamp of when this file was last modified.
name string
Name of this file.
size uint64
Size of this file, in bytes.
_links object
URLs to pages related to the resource.
_first object
The HATEOAS link to the first page of results.
href string
The URI for the referenced operation.
templated boolean
Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.
type string
The HTTP method to be used with the "href" link for the referenced operation.
_next object
The HATEOAS link to the next page of results.
href string
The URI for the referenced operation.
templated boolean
Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.
type string
The HTTP method to be used with the "href" link for the referenced operation.
_self object
The HATEOAS link to this resource.
href string
The URI for the referenced operation.
templated boolean
Determines whether the "href" link is a URI template. If set to true, the "href" link is a URI template.
type string
The HTTP method to be used with the "href" link for the referenced operation.
current_count int64
The number of items listed on the current page.
limit int64
The maximum number of items displayed per page in the response.
start string
The page token used to get this response.

{
  "_embedded": {
    "items": [
      {
        "_links": {
          "_first": {
            "href": "string",
            "templated": true,
            "type": "string"
          },
          "_next": {
            "href": "string",
            "templated": true,
            "type": "string"
          },
          "_self": {
            "href": "string",
            "templated": true,
            "type": "string"
          }
        },
        "directory_id": "string",
        "is_directory": true,
        "modified_timestamp": "string",
        "name": "string",
        "size": 0
      }
    ]
  },
  "_links": {
    "_first": {
      "href": "string",
      "templated": true,
      "type": "string"
    },
    "_next": {
      "href": "string",
      "templated": true,
      "type": "string"
    },
    "_self": {
      "href": "string",
      "templated": true,
      "type": "string"
    }
  },
  "current_count": 0,
  "limit": 0,
  "start": "string"
}

Error

application/json

Schema
Example (from schema)

Schema

errors object[]
A list of errors encountered during runtime.
error_code uint32
error_message string
The reason for the error.

{
  "errors": [
    {
      "error_code": 0,
      "error_message": "string"
    }
  ]
}

GET /backups/:backup_id/filesystems/:filesystem_id/directories/:directory_id/browse

Authorization

Request

Click Edit to configure Base URL

https://us-west-2.api.clumio.com

Bearer Token

backup_id — path required

filesystem_id — path required

directory_id — path required

limit — query

start — query

curl -L -X GET 'https://us-west-2.api.clumio.com/backups/:backup_id/filesystems/:filesystem_id/directories/:directory_id/browse' \
-H 'Accept: application/api.clumio.backup-filesystem-directories=v1+json' \
-H 'Authorization: Bearer <TOKEN>'

curl -L -X GET 'https://us-west-2.api.clumio.com/backups/:backup_id/filesystems/:filesystem_id/directories/:directory_id/browse' \
-H 'Accept: application/api.clumio.backup-filesystem-directories=v1+json' \
-H 'Authorization: Bearer <TOKEN>'

curl -L -X GET 'https://us-west-2.api.clumio.com/backups/:backup_id/filesystems/:filesystem_id/directories/:directory_id/browse' \
-H 'Accept: application/api.clumio.backup-filesystem-directories=v1+json' \
-H 'Authorization: Bearer <TOKEN>'

curl -L -X GET 'https://us-west-2.api.clumio.com/backups/:backup_id/filesystems/:filesystem_id/directories/:directory_id/browse' \
-H 'Accept: application/api.clumio.backup-filesystem-directories=v1+json' \
-H 'Authorization: Bearer <TOKEN>'

curl -L -X GET 'https://us-west-2.api.clumio.com/backups/:backup_id/filesystems/:filesystem_id/directories/:directory_id/browse' \
-H 'Accept: application/api.clumio.backup-filesystem-directories=v1+json' \
-H 'Authorization: Bearer <TOKEN>'

curl -L -X GET 'https://us-west-2.api.clumio.com/backups/:backup_id/filesystems/:filesystem_id/directories/:directory_id/browse' \
-H 'Accept: application/api.clumio.backup-filesystem-directories=v1+json' \
-H 'Authorization: Bearer <TOKEN>'

curl -L -X GET 'https://us-west-2.api.clumio.com/backups/:backup_id/filesystems/:filesystem_id/directories/:directory_id/browse' \
-H 'Accept: application/api.clumio.backup-filesystem-directories=v1+json' \
-H 'Authorization: Bearer <TOKEN>'

Browse a directory​

Authorization

Request

Browse a directory