✨
Singularity
English
English
  • Overview
    • What is Singularity
    • V1 or V2
  • Installation
    • Download binaries
    • Install via docker
    • Built from source
    • Deploy to production
    • Version upgrade
  • Data Preparation
    • Get Started
    • Performance Tuning
  • Content Distribution
    • Distribute CAR files
  • Deal Making
    • Create a deal schedule
  • Topics
    • Inline Preparation
    • Benchmark
  • 💻CLI Reference
    • Menu
    • Ez Prep
    • Version
    • Admin
      • Init
      • Reset
      • Migrate Dataset
      • Migrate Schedule
    • Download
    • Extract Car
    • Deal
      • Schedule
        • Create
        • List
        • Update
        • Pause
        • Resume
        • Remove
      • Send Manual
      • List
    • Run
      • Api
      • Dataset Worker
      • Content Provider
      • Deal Tracker
      • Deal Pusher
      • Download Server
    • Wallet
      • Import
      • List
      • Remove
    • Storage
      • Create
        • Acd
        • Azureblob
        • B2
        • Box
        • Drive
        • Dropbox
        • Fichier
        • Filefabric
        • Ftp
        • Google Cloud Storage
        • Gphotos
        • Hdfs
        • Hidrive
        • Http
        • Internetarchive
        • Jottacloud
        • Koofr / Digi Storage
          • Digistorage
          • Koofr / Digi Storage
          • Other
        • Local
        • Mailru
        • Mega
        • Netstorage
        • Onedrive
        • Oos
          • Env_auth
          • Instance_principal_auth
          • No_auth
          • Resource_principal_auth
          • User_principal_auth
        • Opendrive
        • Pcloud
        • Premiumizeme
        • Putio
        • Qingstor
        • AWS S3 and compliant
          • Aws
          • Alibaba
          • Arvancloud
          • Ceph
          • Chinamobile
          • Cloudflare
          • Digitalocean
          • Dreamhost
          • Huaweiobs
          • Ibmcos
          • Idrive
          • Ionos
          • Liara
          • Lyvecloud
          • Minio
          • Netease
          • Other
          • Qiniu
          • Rackcorp
          • Scaleway
          • Seaweedfs
          • Stackpath
          • Storj
          • Tencentcos
          • Wasabi
        • Seafile
        • Sftp
        • Sharefile
        • Sia
        • Smb
        • Storj
          • Existing
          • New
        • Sugarsync
        • Swift
        • Union
        • Uptobox
        • Webdav
        • Yandex
        • Zoho
      • Explore
      • List
      • Remove
      • Update
        • Acd
        • Azureblob
        • B2
        • Box
        • Drive
        • Dropbox
        • Fichier
        • Filefabric
        • Ftp
        • Google Cloud Storage
        • Gphotos
        • Hdfs
        • Hidrive
        • Http
        • Internetarchive
        • Jottacloud
        • Koofr / Digi Storage
          • Digistorage
          • Koofr / Digi Storage
          • Other
        • Local
        • Mailru
        • Mega
        • Netstorage
        • Onedrive
        • Oos
          • Env_auth
          • Instance_principal_auth
          • No_auth
          • Resource_principal_auth
          • User_principal_auth
        • Opendrive
        • Pcloud
        • Premiumizeme
        • Putio
        • Qingstor
        • AWS S3 and compliant
          • Aws
          • Alibaba
          • Arvancloud
          • Ceph
          • Chinamobile
          • Cloudflare
          • Digitalocean
          • Dreamhost
          • Huaweiobs
          • Ibmcos
          • Idrive
          • Ionos
          • Liara
          • Lyvecloud
          • Minio
          • Netease
          • Other
          • Qiniu
          • Rackcorp
          • Scaleway
          • Seaweedfs
          • Stackpath
          • Storj
          • Tencentcos
          • Wasabi
        • Seafile
        • Sftp
        • Sharefile
        • Sia
        • Smb
        • Storj
          • Existing
          • New
        • Sugarsync
        • Swift
        • Union
        • Uptobox
        • Webdav
        • Yandex
        • Zoho
      • Rename
    • Prep
      • Create
      • List
      • Status
      • Rename
      • Attach Source
      • Attach Output
      • Detach Output
      • Start Scan
      • Pause Scan
      • Start Pack
      • Pause Pack
      • Start Daggen
      • Pause Daggen
      • List Pieces
      • Add Piece
      • Explore
      • Attach Wallet
      • List Wallets
      • Detach Wallet
      • Remove
  • 🌐Web API Reference
    • Admin
    • Deal Schedule
    • Deal
    • File
    • Job
    • Piece
    • Preparation
    • Storage
    • Wallet Association
    • Wallet
    • Specification
  • ❓FAQ
    • Database is locked
Powered by GitBook
On this page

Was this helpful?

Edit on GitHub
  1. Web API Reference

Job

PreviousFileNextPiece

Last updated 1 year ago

Was this helpful?

🌐

Pack a pack job into car files

post
Path parameters
idintegerRequired

Pack job ID

Responses
200
OK
application/json
400
Bad Request
application/json
500
Internal Server Error
application/json
post
POST /api/job/{id}/pack HTTP/1.1
Host: localhost:9090
Accept: */*
{
  "attachmentId": 1,
  "createdAt": "text",
  "fileSize": 1,
  "id": 1,
  "jobId": 1,
  "numOfFiles": 1,
  "pieceCid": "text",
  "pieceSize": 1,
  "preparationId": 1,
  "rootCid": "text",
  "storageId": 1,
  "storagePath": "text"
}

prepare to pack a data source

post
Path parameters
idstringRequired

Preparation ID or name

namestringRequired

Storage ID or name

Responses
204
No Content
400
Bad Request
application/json
500
Internal Server Error
application/json
post
POST /api/preparation/{id}/source/{name}/finalize HTTP/1.1
Host: localhost:9090
Accept: */*

No content

Pause an ongoing DAG generation job

post
Path parameters
idstringRequired

Preparation ID or name

namestringRequired

Storage ID or name

Responses
200
OK
application/json
400
Bad Request
application/json
500
Internal Server Error
application/json
post
POST /api/preparation/{id}/source/{name}/pause-daggen HTTP/1.1
Host: localhost:9090
Accept: */*
{
  "attachmentId": 1,
  "errorMessage": "text",
  "errorStackTrace": "text",
  "id": 1,
  "state": "created",
  "type": "scan",
  "workerId": "text"
}

Pause a specific packing job

post
Path parameters
idstringRequired

Preparation ID or name

namestringRequired

Storage ID or name

job_idintegerRequired

Pack Job ID

Responses
200
OK
application/json
400
Bad Request
application/json
500
Internal Server Error
application/json
post
POST /api/preparation/{id}/source/{name}/pause-pack/{job_id} HTTP/1.1
Host: localhost:9090
Accept: */*
[
  {
    "attachmentId": 1,
    "errorMessage": "text",
    "errorStackTrace": "text",
    "id": 1,
    "state": "created",
    "type": "scan",
    "workerId": "text"
  }
]

Pause an ongoing scanning job

post
Path parameters
idstringRequired

Preparation ID or name

namestringRequired

Storage ID or name

Responses
200
OK
application/json
400
Bad Request
application/json
500
Internal Server Error
application/json
post
POST /api/preparation/{id}/source/{name}/pause-scan HTTP/1.1
Host: localhost:9090
Accept: */*
{
  "attachmentId": 1,
  "errorMessage": "text",
  "errorStackTrace": "text",
  "id": 1,
  "state": "created",
  "type": "scan",
  "workerId": "text"
}

Start a new DAG generation job

post
Path parameters
idstringRequired

Preparation ID or name

namestringRequired

Storage ID or name

Responses
200
OK
application/json
400
Bad Request
application/json
500
Internal Server Error
application/json
post
POST /api/preparation/{id}/source/{name}/start-daggen HTTP/1.1
Host: localhost:9090
Accept: */*
{
  "attachmentId": 1,
  "errorMessage": "text",
  "errorStackTrace": "text",
  "id": 1,
  "state": "created",
  "type": "scan",
  "workerId": "text"
}

Start or restart a specific packing job

post
Path parameters
idstringRequired

Preparation ID or name

namestringRequired

Storage ID or name

job_idintegerRequired

Pack Job ID

Responses
200
OK
application/json
400
Bad Request
application/json
500
Internal Server Error
application/json
post
POST /api/preparation/{id}/source/{name}/start-pack/{job_id} HTTP/1.1
Host: localhost:9090
Accept: */*
[
  {
    "attachmentId": 1,
    "errorMessage": "text",
    "errorStackTrace": "text",
    "id": 1,
    "state": "created",
    "type": "scan",
    "workerId": "text"
  }
]

Start a new scanning job

post
Path parameters
idstringRequired

Preparation ID or name

namestringRequired

Storage ID or name

Responses
200
OK
application/json
400
Bad Request
application/json
500
Internal Server Error
application/json
post
POST /api/preparation/{id}/source/{name}/start-scan HTTP/1.1
Host: localhost:9090
Accept: */*
{
  "attachmentId": 1,
  "errorMessage": "text",
  "errorStackTrace": "text",
  "id": 1,
  "state": "created",
  "type": "scan",
  "workerId": "text"
}
  • POSTPack a pack job into car files
  • POSTprepare to pack a data source
  • POSTPause an ongoing DAG generation job
  • POSTPause a specific packing job
  • POSTPause an ongoing scanning job
  • POSTStart a new DAG generation job
  • POSTStart or restart a specific packing job
  • POSTStart a new scanning job