Swift Proxy

Learn about actions >

• 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