--- title: "Get PersistentCacheTasks" method: GET path: "/api/v1/persistent-cache-tasks" tags: ["PersistentCacheTask"] --- # Get PersistentCacheTasks `GET /api/v1/persistent-cache-tasks` Get PersistentCacheTasks ## Query parameters - `scheduler_cluster_id` integer, required - `page` integer, required - `per_page` integer, required ## Response `200` OK - D7yIoDragonflyV2ManagerTypesPersistentCacheTask[] - `application` string — Application of persistent cache task. - `content_length` integer — ContentLength is persistent cache task total content length. - `created_at` string — CreatedAt is persistent cache task create time. - `id` string — ID is task id. - `peers` D7yIoDragonflyV2ManagerTypesPersistentCachePeer[] — PersistentCachePeers is the list of persistent cache peers. - `block_parents` string[] — BlockParents is bad parents ids. - `cost` -9223372036854776000 | 9223372036854776000 | 1 | 1000 | 1000000 | 1000000000 | 60000000000 | 3600000000000 - `created_at` string — CreatedAt is persistent cache peer create time. - `finished_pieces` BitsetBitSet - `host` D7yIoDragonflyV2ManagerTypesPersistentCacheHost - `announce_interval` -9223372036854776000 | 9223372036854776000 | 1 | 1000 | 1000000 | 1000000000 | 60000000000 | 3600000000000 - `build` object — Build contains build information. - `git_commit` string — GitCommit is git commit. - `git_version` string — GitVersion is git version. - `go_version` string — GoVersion is go version. - `platform` string — Platform is build platform. - `cpu` object — CPU contains cpu information. - `logical_count` integer — LogicalCount is cpu logical count. - `percent` number — Percent is cpu usage percent. - `physical_count` integer — PhysicalCount is cpu physical count. - `process_percent` number — ProcessPercent is process cpu usage percent. - `times` object — Times contains cpu times information. - `guest` number — Guest is guest cpu time. - `guest_nice` number — GuestNice is guest nice cpu time. - `idle` number — Idle is idle cpu time. - `iowait` number — Iowait is iowait cpu time. - `irq` number — Irq is irq cpu time. - `nice` number — Nice is nice cpu time. - `softirq` number — Softirq is softirq cpu time. - `steal` number — Steal is steal cpu time. - `system` number — System is system cpu time. - `user` number — User is user cpu time. - `created_at` string — CreatedAt is host create time. - `disable_shared` boolean — DisableShared is whether the host is disabled for shared with other peers. - `disk` object — Disk contains disk information. - `free` integer — Free is free disk space. - `inodes_free` integer — InodesFree is free inodes. - `inodes_total` integer — InodesTotal is total inodes. - `inodes_used` integer — InodesUsed is used inodes. - `inodes_used_percent` number — InodesUsedPercent is inodes usage percent. - `read_bandwidth` integer — ReadBandwidth is read bandwidth. - `total` integer — Total is total disk space. - `used` integer — Used is used disk space. - `used_percent` number — UsedPercent is disk usage percent. - `write_bandwidth` integer — WriteBandwidth is write bandwidth. - `download_port` integer — DownloadPort is piece downloading port. - `hostname` string — Hostname is host name. - `id` string — ID is host id. - `ip` string — IP is host ip. - `kernel_version` string — KernelVersion is host kernel version. - `memory` object — Memory contains memory information. - `available` integer — Available is available memory. - `free` integer — Free is free memory. - `process_used_percent` number — ProcessUsedPercent is process memory usage percent. - `total` integer — Total is total memory. - `used` integer — Used is used memory. - `used_percent` number — UsedPercent is memory usage percent. - `network` object — Network contains network information. - `idc` string — IDC is network idc. - `location` string — Location is network location. - `max_rx_bandwidth` integer — MaxRxBandwidth is download rate limit. - `max_tx_bandwidth` integer — MaxTxBandwidth is upload rate limit. - `rx_bandwidth` integer — RxBandwidth is download rate. - `tcp_connection_count` integer — TCPConnectionCount is tcp connection count. - `tx_bandwidth` integer — TxBandwidth is upload rate. - `upload_tcp_connection_count` integer — UploadTCPConnectionCount is upload tcp connection count. - `os` string — OS is host OS. - `platform` string — Platform is host platform. - `platform_family` string — PlatformFamily is host platform family. - `platform_version` string — PlatformVersion is host platform version. - `port` integer — Port is grpc service port. - `scheduler_cluster_id` integer — SchedulerClusterID is the scheduler cluster id matched by scopes. - `type` string — Type is host type. - `updated_at` string — UpdatedAt is host update time. - `id` string — ID is persistent cache peer id. - `persistent` boolean — Persistent is whether the peer is persistent. - `state` string — State is persistent cache peer state. - `updated_at` string — UpdatedAt is persistent cache peer update time. - `persistent_replica_count` integer — PersistentReplicaCount is replica count of the persistent cache task. - `piece_length` integer — PieceLength is persistent cache task piece length. - `state` string — State is persistent cache task state. - `tag` string — Tag is used to distinguish different persistent cache tasks. - `total_piece_count` integer — TotalPieceCount is total piece count. - `ttl` -9223372036854776000 | 9223372036854776000 | 1 | 1000 | 1000000 | 1000000000 | 60000000000 | 3600000000000 - `updated_at` string — UpdatedAt is persistent cache task update time. ## Other responses - `400` — Bad Request - `404` — Not Found - `500` — Internal Server Error --- [API](https://skmtc.net/dragonflyoss/apis/dragonfly-manager.md) · [All operations](https://skmtc.net/dragonflyoss/apis/dragonfly-manager/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dragonflyoss/dragonfly-manager/revisions/d9b0d442c9f4/schema)