Task_sources

Lists all task sources.

get

API Key Scope: task_sources / index

Authorizations
Path parameters
task_idstringRequired

ID or name of task. Task names are not unique, it's recommended to use ID.

Query parameters
limitintegerOptional

The number of items to display for pagination.

offsetintegerOptional

The number of items to skip for pagination.

Responses
200

List of task sources.

application/json
get
/tasks/{task_id}/task_sources
GET /api/v2/tasks/{task_id}/task_sources HTTP/1.1
Host: localhost
Authorization: Basic username:password
Accept: */*
200

List of task sources.

{
  "count": 1,
  "task_sources": [
    {
      "id": "text",
      "type": "container",
      "node_paths": [
        "text"
      ],
      "range": [
        150000,
        290000
      ],
      "pool_id": 1,
      "parent_storage_id": 1,
      "storage_id": 1,
      "storage_name": "text",
      "pool": {
        "id": 6,
        "name": "offline-tapes",
        "comment": "",
        "type": "offline_archive",
        "content": "tape",
        "storage_id": 2,
        "tape_write_protect_when_full": true
      },
      "container": {
        "id": 100,
        "name": "my-container",
        "comment": "Read only container for random stuff",
        "push_pool_id": 1,
        "cleaning_pool_id": 1,
        "quota_total_size": 1,
        "quota_on_cache": 1,
        "stat_total_files": 99301,
        "only_on_cache_file_count": 19123,
        "stat_total_size": 6145076462,
        "stat_size_on_cache": 6899417088,
        "only_on_cache_file_size_sum": 3294517012,
        "guest_right": "read",
        "last_update": "2019-08-05T14:24:15.000Z"
      }
    }
  ]
}

Creates a new task source.

post

API Key Scope: task_sources / create

Authorizations
Path parameters
task_idstringRequired

ID or name of task. Task names are not unique, it's recommended to use ID.

Body
idstring · int64Read-onlyOptional
typestring · enumOptionalPossible values:
node_pathsstring[]Optional
rangeinteger[] · min: 2 · max: 2OptionalExample: [150000,290000]
pool_idintegerOptional
parent_storage_idinteger · int64Optional
storage_idinteger · int64Optional
storage_namestringOptional
poolall ofRead-onlyOptional
containerall ofRead-onlyOptional
Responses
201

A specific task source.

application/json
post
/tasks/{task_id}/task_sources
POST /api/v2/tasks/{task_id}/task_sources HTTP/1.1
Host: localhost
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 137

{
  "type": "container",
  "node_paths": [
    "text"
  ],
  "range": [
    150000,
    290000
  ],
  "pool_id": 1,
  "parent_storage_id": 1,
  "storage_id": 1,
  "storage_name": "text"
}
{
  "id": "text",
  "type": "container",
  "node_paths": [
    "text"
  ],
  "range": [
    150000,
    290000
  ],
  "pool_id": 1,
  "parent_storage_id": 1,
  "storage_id": 1,
  "storage_name": "text",
  "pool": {
    "id": 6,
    "name": "offline-tapes",
    "comment": "",
    "type": "offline_archive",
    "content": "tape",
    "storage_id": 2,
    "tape_write_protect_when_full": true
  },
  "container": {
    "id": 100,
    "name": "my-container",
    "comment": "Read only container for random stuff",
    "push_pool_id": 1,
    "cleaning_pool_id": 1,
    "quota_total_size": 1,
    "quota_on_cache": 1,
    "stat_total_files": 99301,
    "only_on_cache_file_count": 19123,
    "stat_total_size": 6145076462,
    "stat_size_on_cache": 6899417088,
    "only_on_cache_file_size_sum": 3294517012,
    "guest_right": "read",
    "last_update": "2019-08-05T14:24:15.000Z"
  }
}

Displays a specific task source.

get

API Key Scope: task_sources / show

Authorizations
Path parameters
task_idstringRequired

ID or name of task. Task names are not unique, it's recommended to use ID.

task_source_idstringRequired

ID of task source.

Responses
200

A specific task source.

application/json
get
/tasks/{task_id}/task_sources/{task_source_id}
GET /api/v2/tasks/{task_id}/task_sources/{task_source_id} HTTP/1.1
Host: localhost
Authorization: Basic username:password
Accept: */*
{
  "id": "text",
  "type": "container",
  "node_paths": [
    "text"
  ],
  "range": [
    150000,
    290000
  ],
  "pool_id": 1,
  "parent_storage_id": 1,
  "storage_id": 1,
  "storage_name": "text",
  "pool": {
    "id": 6,
    "name": "offline-tapes",
    "comment": "",
    "type": "offline_archive",
    "content": "tape",
    "storage_id": 2,
    "tape_write_protect_when_full": true
  },
  "container": {
    "id": 100,
    "name": "my-container",
    "comment": "Read only container for random stuff",
    "push_pool_id": 1,
    "cleaning_pool_id": 1,
    "quota_total_size": 1,
    "quota_on_cache": 1,
    "stat_total_files": 99301,
    "only_on_cache_file_count": 19123,
    "stat_total_size": 6145076462,
    "stat_size_on_cache": 6899417088,
    "only_on_cache_file_size_sum": 3294517012,
    "guest_right": "read",
    "last_update": "2019-08-05T14:24:15.000Z"
  }
}

Updates a specific task source.

put

API Key Scope: task_sources / update

Authorizations
Path parameters
task_idstringRequired

ID or name of task. Task names are not unique, it's recommended to use ID.

task_source_idstringRequired

ID of task source.

Body
idstring · int64Read-onlyOptional
typestring · enumOptionalPossible values:
node_pathsstring[]Optional
rangeinteger[] · min: 2 · max: 2OptionalExample: [150000,290000]
pool_idintegerOptional
parent_storage_idinteger · int64Optional
storage_idinteger · int64Optional
storage_namestringOptional
poolall ofRead-onlyOptional
containerall ofRead-onlyOptional
Responses
200

A specific task source.

application/json
put
/tasks/{task_id}/task_sources/{task_source_id}
PUT /api/v2/tasks/{task_id}/task_sources/{task_source_id} HTTP/1.1
Host: localhost
Authorization: Basic username:password
Content-Type: application/json
Accept: */*
Content-Length: 137

{
  "type": "container",
  "node_paths": [
    "text"
  ],
  "range": [
    150000,
    290000
  ],
  "pool_id": 1,
  "parent_storage_id": 1,
  "storage_id": 1,
  "storage_name": "text"
}
{
  "id": "text",
  "type": "container",
  "node_paths": [
    "text"
  ],
  "range": [
    150000,
    290000
  ],
  "pool_id": 1,
  "parent_storage_id": 1,
  "storage_id": 1,
  "storage_name": "text",
  "pool": {
    "id": 6,
    "name": "offline-tapes",
    "comment": "",
    "type": "offline_archive",
    "content": "tape",
    "storage_id": 2,
    "tape_write_protect_when_full": true
  },
  "container": {
    "id": 100,
    "name": "my-container",
    "comment": "Read only container for random stuff",
    "push_pool_id": 1,
    "cleaning_pool_id": 1,
    "quota_total_size": 1,
    "quota_on_cache": 1,
    "stat_total_files": 99301,
    "only_on_cache_file_count": 19123,
    "stat_total_size": 6145076462,
    "stat_size_on_cache": 6899417088,
    "only_on_cache_file_size_sum": 3294517012,
    "guest_right": "read",
    "last_update": "2019-08-05T14:24:15.000Z"
  }
}

Destroys a specific task source.

delete

API Key Scope: task_sources / destroy

Authorizations
Path parameters
task_idstringRequired

ID or name of task. Task names are not unique, it's recommended to use ID.

task_source_idstringRequired

ID of task source.

Responses
204

Task source destroyed.

No content

delete
/tasks/{task_id}/task_sources/{task_source_id}
DELETE /api/v2/tasks/{task_id}/task_sources/{task_source_id} HTTP/1.1
Host: localhost
Authorization: Basic username:password
Accept: */*
204

Task source destroyed.

No content

Last updated

Was this helpful?