Create
NAME:
singularity deal schedule create - Create a schedule to send out deals to a storage provider
USAGE:
singularity deal schedule create [command options]
DESCRIPTION:
CRON pattern '--schedule-cron': The CRON pattern can either be a descriptor or a standard CRON pattern with optional second field
Standard CRON:
┌───────────── minute (0 - 59)
│ ┌───────────── hour (0 - 23)
│ │ ┌───────────── day of the month (1 - 31)
│ │ │ ┌───────────── month (1 - 12)
│ │ │ │ ┌───────────── day of the week (0 - 6) (Sunday to Saturday)
│ │ │ │ │
│ │ │ │ │
│ │ │ │ │
* * * * *
Optional Second field:
┌───────────── second (0 - 59)
│ ┌───────────── minute (0 - 59)
│ │ ┌───────────── hour (0 - 23)
│ │ │ ┌───────────── day of the month (1 - 31)
│ │ │ │ ┌───────────── month (1 - 12)
│ │ │ │ │ ┌───────────── day of the week (0 - 6) (Sunday to Saturday)
│ │ │ │ │ │
│ │ │ │ │ │
* * * * * *
Descriptor:
@yearly, @annually - Equivalent to 0 0 1 1 *
@monthly - Equivalent to 0 0 1 * *
@weekly - Equivalent to 0 0 * * 0
@daily, @midnight - Equivalent to 0 0 * * *
@hourly - Equivalent to 0 * * * *
OPTIONS:
--help, -h show help
--preparation value Preparation ID or name
--provider value Storage Provider ID to send deals to
Boost Only
--http-header value, -H value [ --http-header value, -H value ] HTTP headers to be passed with the request (i.e. key=value)
--ipni Whether to announce the deal to IPNI (default: true)
--url-template value, -u value URL template with PIECE_CID placeholder for boost to fetch the CAR file, i.e. http://127.0.0.1/piece/{PIECE_CID}.car
Deal Proposal
--duration value, -d value Duration in epoch or in duration format, i.e. 1500000, 2400h (default: 12840h[535 days])
--keep-unsealed Whether to keep unsealed copy (default: true)
--price-per-deal value Price in FIL per deal (default: 0)
--price-per-gb value Price in FIL per GiB (default: 0)
--price-per-gb-epoch value Price in FIL per GiB per epoch (default: 0)
--start-delay value, -s value Deal start delay in epoch or in duration format, i.e. 1000, 72h (default: 72h[3 days])
--verified Whether to propose deals as verified (default: true)
Restrictions
--allowed-piece-cid value, --piece-cid value [ --allowed-piece-cid value, --piece-cid value ] List of allowed piece CIDs in this schedule (default: Any)
--allowed-piece-cid-file value, --piece-cid-file value [ --allowed-piece-cid-file value, --piece-cid-file value ] List of files that contains a list of piece CIDs to allow
--force Force to send out deals regardless of replication restriction (default: false)
--max-pending-deal-number value, --pending-number value Max pending deal number overall for this request, i.e. 100TiB (default: Unlimited)
--max-pending-deal-size value, --pending-size value Max pending deal sizes overall for this request, i.e. 1000 (default: Unlimited)
--total-deal-number value, --total-number value Max total deal number for this request, i.e. 1000 (default: Unlimited)
--total-deal-size value, --total-size value Max total deal sizes for this request, i.e. 100TiB (default: Unlimited)
Scheduling
--schedule-cron value, --cron value Cron schedule to send out batch deals (default: disabled)
--schedule-deal-number value, --number value Max deal number per triggered schedule, i.e. 30 (default: Unlimited)
--schedule-deal-size value, --size value Max deal sizes per triggered schedule, i.e. 500GiB (default: Unlimited)
Tracking
--notes value, -n value Any notes or tag to store along with the request, for tracking purpose
Last updated