$ ipfs-cluster-ctl pin add --help
ipfs-cluster-ctl pin add - Pin an item in the cluster
ipfs-cluster-ctl pin add [command options] <CID|Path>
This command tells IPFS Cluster to start managing a CID. Depending on
the pinning strategy, this will trigger IPFS pin requests. The CID will
become part of the Cluster's state and will tracked from this point.
When the request has succeeded, the command returns the status of the CID
in the cluster and should be part of the list offered by "pin ls".
An optional replication factor can be provided: -1 means "pin everywhere"
and 0 means use cluster's default setting (i.e., replication factor set in
config). Positive values indicate how many peers should pin this content.
An optional allocations argument can be provided, allocations should be a
comma-separated list of peer IDs on which we want to pin. Peers in allocations
are prioritized over automatically-determined ones, but replication factors
would still be respected.
--replication value, -r value Sets a custom replication factor (overrides -rmax and -rmin) (default: 0)
--replication-min value, --rmin value Sets the minimum replication factor for this pin (default: 0)
--replication-max value, --rmax value Sets the maximum replication factor for this pin (default: 0)
--allocations value, --allocs value Optional comma-separated list of peer IDs
--name value, -n value Sets a name for this pin
--mode value Select a way to pin: recursive or direct (default: "recursive")
--expire-in value Duration after which pin should be unpinned automatically
--metadata value Pin metadata: key=value. Can be added multiple times
--no-status, --ns Prevents fetching pin status after pinning (faster, quieter)
--wait, -w Wait for all nodes to report a status of pinned before returning
--wait-timeout value, --wt value How long to --wait (in seconds), default is indefinitely (default: 0s)