---
title: Charmhub | Deploy Swift Proxy using Charmhub - The Open Operator Collection
description: Deploy the latest version of Swift Proxy on any cloud.
url: https://charmhub.io/swift-proxy/actions
---

# Swift Proxy

[OpenStack Charmers](https://charmhub.io/publisher/openstack-charmers "View all packages from OpenStack Charmers")

* [OpenStack Charmers](https://charmhub.io/publisher/openstack-charmers "View all packages from OpenStack Charmers")
* [Cloud](https://charmhub.io/?filter=cloud)
* [Networking](https://charmhub.io/?filter=networking)

Platform:

24.04

23.10

23.04

22.10

22.04

20.04

18.04

14.04

12.04

yoga/stable 180

```
juju deploy swift-proxy --channel yoga/stable
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

* [add-user](https://charmhub.io/swift-proxy/actions#add-user)
* [diskusage](https://charmhub.io/swift-proxy/actions#diskusage)
* [dispersion-populate](https://charmhub.io/swift-proxy/actions#dispersion-populate)
* [dispersion-report](https://charmhub.io/swift-proxy/actions#dispersion-report)
* [openstack-upgrade](https://charmhub.io/swift-proxy/actions#openstack-upgrade)
* [pause](https://charmhub.io/swift-proxy/actions#pause)
* [remove-devices](https://charmhub.io/swift-proxy/actions#remove-devices)
* [resume](https://charmhub.io/swift-proxy/actions#resume)
* [set-weight](https://charmhub.io/swift-proxy/actions#set-weight)

[Learn about actions >](https://juju.is/docs/juju/action)

* add-user

  Add a user to swauth.
  This adds a given user / pass to swauth. Auth-type must be set to swauth.
  Note that swauth is not supported for OpenStack Train and later.

  Params

  + account
    string

    account to add this user to
  + password
    string

    password for the newly created user
  + username
    string

    username for the newly created user

  Required

  account,
  username,
  password
* diskusage

  Run swift-recon -d on the specified unit. Returns values in GB.
* dispersion-populate

  Run swift-dispersion-populate command on the specified unit.
* dispersion-report

  Run swift-dispersion-report command on the specified unit.
* openstack-upgrade

  Perform openstack upgrades. Config option action-managed-upgrade must be
  set to True.
* pause

  Pause swift-proxy services.
  If the swift-proxy deployment is clustered using the hacluster charm, the
  corresponding hacluster unit on the node must first be paused as well.
  Not doing so may lead to an interruption of service.
* remove-devices

  Removes the device(s) from the ring. This should normally just be used for
  a device that has failed. For a device you wish to decommission, it's best
  to set its weight to 0, wait for it to drain all its data, then use this
  remove-from-ring action.

  Params

  + ring
    string

    Swift ring to remove the device(s) from. Valid options are 'account',
    'container', 'object' or 'all'.
  + search-value
    string

    The search-value can be of the form:
    .
    d<device\_id>r<region>z<zone>-<ip>:<port>R<r\_ip>:<r\_port>/
    <device\_name>\_<meta>
    .
    Where <r\_ip> and <r\_port> are replication ip and port. Any part is
    optional, but you must include at least one part.

  Required

  ring,
  search-value
* resume

  Resume swift-proxy services.
  If the swift-proxy deployment is clustered using the hacluster charm, the
  corresponding hacluster unit on the node must be resumed as well.
* set-weight

  Sets the device's weight.

  Params

  + ring
    string

    Swift ring to set the weight for. Valid options are 'account',
    'container', 'object' or 'all'.
  + search-value
    string

    The search-value can be of the form:
    .
    d<device\_id>r<region>z<zone>-<ip>:<port>R<r\_ip>:<r\_port>/
    <device\_name>\_<meta>
    .
    Where <r\_ip> and <r\_port> are replication ip and port. Any part is
    optional, but you must include at least one part.
  + weight
    number

    The device's weight

  Required

  ring,
  search-value,
  weight