Aliases: placements, placement
Placements are gated behind a feature flag. The placements command is hidden and unavailable unless the feature is enabled for your organization.
Subcommands
list
List placements, optionally filtered by organization, project, or reservation.
nscale placements list [flags]
Flags
| Flag | Description |
|---|
—org string | Organization ID |
—project string | Project ID |
—reservation string | Reservation ID |
—json | Emit the full JSON payload (mutually exclusive with -q) |
-q, —query stringArray | jq filter for value extraction (see Query output with -q) |
Example
nscale placements list --org <org-id> --reservation <reservation-id>
get
Get details for a specific placement.
nscale placements get --id <placement-id> --org <org-id>
Flags
| Flag | Description |
|---|
—id string | Placement ID |
—org string | Organization ID |
—json | Emit the full JSON payload (mutually exclusive with -q) |
-q, —query stringArray | jq filter for value extraction (see Query output with -q) |
create
Create a new placement. Accepts input from a JSON file or stdin, with an optional cloud-init configuration for the placed servers.
nscale placements create [flags]
Flags
| Flag | Description |
|---|
-f, —file string | Path to a JSON file |
—stdin | Read JSON from standard input |
—cloud-init-path string | Path to a cloud-init YAML file |
—dry-run | Preview the request payload without persisting |
-y, —yes | Automatically confirm creation |
—json | Emit the full JSON payload (mutually exclusive with -q) |
-q, —query stringArray | jq filter for value extraction (see Query output with -q) |
Examples
nscale placements create --file placement.json
nscale placements create --stdin < placement.json
cat placement.json | nscale placements create --stdin
nscale placements create --file placement.json --cloud-init-path cloud-init.yaml
delete
Delete an existing placement.
nscale placements delete --id <placement-id> --org <org-id> [flags]
Flags
| Flag | Description |
|---|
--id string | Placement ID |
--org string | Organization ID |
--dry-run | Preview the request payload without persisting |
-y, --yes | Automatically confirm deletion |
Example
nscale placements delete --id <placement-id> --org <org-id> --yes
servers
List the servers in a placement.
nscale placements servers --id <placement-id> --org <org-id>
Flags
| Flag | Description |
|---|
—id string | Placement ID |
—org string | Organization ID |
—json | Emit the full JSON payload (mutually exclusive with -q) |
-q, —query stringArray | jq filter for value extraction (see Query output with -q) |
server-reboot
Reboot an existing server in a placement. Use --hard for a hard reboot.
nscale placements server-reboot --id <placement-id> --server <server-id> --org <org-id> [flags]
Flags
| Flag | Description |
|---|
--id string | Placement ID |
--server string | Server ID |
--org string | Organization ID |
--hard | Use hard reboot |
--dry-run | Preview the request payload without persisting |
-y, --yes | Automatically confirm reboot |
Example
nscale placements server-reboot --id <placement-id> --server <server-id> --org <org-id> --yes
server-stop
Stop an existing server in a placement.
nscale placements server-stop --id <placement-id> --server <server-id> --org <org-id> [flags]
Flags
| Flag | Description |
|---|
--id string | Placement ID |
--server string | Server ID |
--org string | Organization ID |
--dry-run | Preview the request payload without persisting |
-y, --yes | Automatically confirm stop |
Example
nscale placements server-stop --id <placement-id> --server <server-id> --org <org-id> --yes
Reservations
Reserve GPU capacity and check available reservation units.
