Placements - Nscale

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
get — Get placement details
create — Create a new placement
delete — Delete a placement
servers — List servers in a placement
server-reboot — Reboot a server in a placement
server-stop — Stop a server in a placement

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.

​Subcommands

​list

​Flags

​Example

​get

​Flags

​create

​Flags

​Examples

​delete

​Flags

​Example

​servers

​Flags

​server-reboot

​Flags

​Example

​server-stop

​Flags

​Example

​Related

Reservations

Subcommands

list

Flags

Example

get

Flags

create

Flags

Examples

delete

Flags

Example

servers

Flags

server-reboot

Flags

Example

server-stop

Flags

Example

Related