---
name: "swift-get-nodes"
section: "1"
platform: "linux"
package: "swift"
version: "2.35.1-0+deb13u3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/swift-get-nodes"
---

# swift-get-nodes(1)

OpenStack Swift get-nodes tool

## NAME

**swift-get-nodes** - OpenStack Swift get-nodes tool

## SYNOPSIS

**swift-get-nodes**  \[options\] \<ring.gz\> \<account\> \[\<container\> \[\<object\>\]\]

Or

**swift-get-nodes** \[options\] \<ring.gz\> -p \<partition\>

Or

**swift-get-nodes**  \[options\] -P policy\_name \<account\> \<container\> \<object\>

## DESCRIPTION

The swift-get-nodes tool can be used to find out the location where a particular account, container or object item is located within the swift cluster nodes. For example, if you have the account hash and a container name that belongs to that account, you can use swift-get-nodes to lookup where the container resides by using the container ring.

## OPTIONS

- **-h --help**

  Shows the help message and exit

- **-a, --all**

  Show all handoff nodes

- **-p PARTITION, --partition=PARTITION**

  Show nodes for a given partition

- **-P POLICY\_NAME, --policy-name=POLICY\_NAME**

  Specify storage policy name

- **-d SWIFT\_DIR, --swift-dir=SWIFT\_DIR**

  Pass location of swift configuration file if different from the default location /etc/swift

  - *Example:*

    - $ swift-get-nodes /etc/swift/account.ring.gz MyAccount-12ac01446be2

    - Account MyAccount-12ac01446be2

    - Container None

    - Object None

    - Partition 221082

    - Hash d7e6ba68cfdce0f0e4ca7890e46cacce

    - Server:Port Device 172.24.24.29:6202 sdd

    - Server:Port Device 172.24.24.27:6202 sdr

    - Server:Port Device 172.24.24.32:6202 sde

    - Server:Port Device 172.24.24.26:6202 sdv \[Handoff\]

    - curl -I -XHEAD http://172.24.24.29:6202/sdd/221082/MyAccount-12ac01446be2

    - curl -I -XHEAD http://172.24.24.27:6202/sdr/221082/MyAccount-12ac01446be2

    - curl -I -XHEAD http://172.24.24.32:6202/sde/221082/MyAccount-12ac01446be2

    - curl -I -XHEAD http://172.24.24.26:6202/sdv/221082/MyAccount-12ac01446be2 # \[Handoff\]

    - ssh 172.24.24.29 ls -lah /srv/node/sdd/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/

    - ssh 172.24.24.27 ls -lah /srv/node/sdr/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/

    - ssh 172.24.24.32 ls -lah /srv/node/sde/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/

    - ssh 172.24.24.26 ls -lah /srv/node/sdv/accounts/221082/cce/d7e6ba68cfdce0f0e4ca7890e46cacce/ # \[Handoff\]

    ## DOCUMENTATION

More documentation about OpenStack Swift can be found at **https://docs.openstack.org/swift/latest/**

## SEE ALSO

**[swift-account-info(1)](/swift-account-info/1.md),** **[swift-container-info(1)](/swift-container-info/1.md),** **[swift-object-info(1)](/swift-object-info/1.md),** **[swift-ring-builder(1)](/swift-ring-builder/1.md)**