Connect to specified monitor (instead of looking through ceph.conf).
+.. option:: --tenant=<tenant>
+
+ Name of the tenant.
+
.. option:: --uid=uid
The radosgw user ID.
Name of the subuser.
-.. option:: --email=email
+.. option:: --access-key=<key>
- The e-mail address of the user.
+ S3 access key.
-.. option:: --display-name=name
+.. option:: --email=email
- Configure the display name of the user.
+ The e-mail address of the user.
-.. option:: --access-key=<key>
+.. option:: --secret/--secret-key=<key>
- S3 access key.
+ The secret key.
.. option:: --gen-access-key
Generate random access key (for S3).
-.. option:: --secret=secret
-
- The secret associated with a given key.
-
.. option:: --gen-secret
Generate random secret key.
Temporary url key.
+.. option:: --access=<access>
+
+ Set the access permissions for the sub-user.
+ Available access permissions are read, write, readwrite and full.
+
+.. option:: --display-name=<name>
+
+ The display name of the user.
+
+.. option:: --max-buckets
+
+ Maximum number of buckets for a user.
+
+.. option:: --admin
+
+ Set the admin flag on the user.
+
.. option:: --system
- Set the system flag on the user.
+ Set the system flag on the user.
.. option:: --bucket=bucket
Specify the bucket name.
+.. option:: --pool=<pool>
+
+ Specify the pool name.
+ Also used with `orphans find` as data pool to scan for leaked rados objects.
+
.. option:: --object=object
Specify the object name.
.. option:: --date=yyyy-mm-dd
- The date needed for some commands.
+ The date in the format yyyy-mm-dd.
.. option:: --start-date=yyyy-mm-dd
- The start date needed for some commands.
+ The start date in the format yyyy-mm-dd.
.. option:: --end-date=yyyy-mm-dd
- The end date needed for some commands.
+ The end date in the format yyyy-mm-dd.
+
+.. option:: --bucket-id=<bucket-id>
+
+ Specify the bucket id.
.. option:: --shard-id=<shard-id>
.. option:: --purge-data
- Remove user data before user removal.
+ When specified, user removal will also purge all the user data.
.. option:: --purge-keys
.. option:: --purge-objects
- Remove all objects before bucket removal.
+ When specified, the bucket removal will also purge all objects in it.
.. option:: --metadata-key=<key>
Key to retrieve metadata from with ``metadata get``.
-.. option:: --rgw-region=<region>
+.. option:: --remote=<remote>
+
+ Zone or zonegroup id of remote gateway.
+
+.. option:: --period=<id>
+
+ Period id.
+
+.. option:: --epoch=<number>
+
+ Period epoch.
+
+.. option:: --commit
- Region in which radosgw is running.
+ Commit the period during 'period update'.
+
+.. option:: --staging
+
+ Get the staging period info.
+
+.. option:: --master
+
+ Set as master.
+
+.. option:: --master-zone=<id>
+
+ Master zone id.
+
+.. option:: --rgw-realm=<name>
+
+ The realm name.
+
+.. option:: --realm-id=<id>
+
+ The realm id.
+
+.. option:: --realm-new-name=<name>
+
+ New name of realm.
+
+.. option:: --rgw-zonegroup=<name>
+
+ The zonegroup name.
+
+.. option:: --zonegroup-id=<id>
+
+ The zonegroup id.
+
+.. option:: --zonegroup-new-name=<name>
+
+ The new name of the zonegroup.
.. option:: --rgw-zone=<zone>
Zone in which radosgw is running.
-.. option:: --source-zone=<zone>
+.. option:: --zone-id=<id>
+
+ The zone id.
+
+.. option:: --zone-new-name=<name>
+
+ The new name of the zone.
+
+.. option:: --source-zone
+
+ The source zone for data sync.
+
+.. option:: --default
+
+ Set the entity (realm, zonegroup, zone) as default.
+
+.. option:: --read-only
+
+ Set the zone as read-only when adding to the zonegroup.
- Specify the source zone for data sync.
+.. option:: --placement-id
+
+ Placement id for the zonegroup placement commands.
+
+.. option:: --tags=<list>
+
+ The list of tags for zonegroup placement add and modify commands.
+
+.. option:: --tags-add=<list>
+
+ The list of tags to add for zonegroup placement modify command.
+
+.. option:: --tags-rm=<list>
+
+ The list of tags to remove for zonegroup placement modify command.
+
+.. option:: --endpoints=<list>
+
+ The zone endpoints.
+
+.. option:: --index-pool=<pool>
+
+ The placement target index pool.
+
+.. option:: --data-pool=<pool>
+
+ The placement target data pool.
+
+.. option:: --data-extra-pool=<pool>
+
+ The placement target data extra (non-ec) pool.
+
+.. option:: --placement-index-type=<type>
+
+ The placement target index type (normal, indexless, or #id).
+
+.. option:: --tier-type=<type>
+
+ The zone tier type.
+
+.. option:: --tier-config=<k>=<v>[,...]
+
+ Set zone tier config keys, values.
+
+.. option:: --tier-config-rm=<k>[,...]
+
+ Unset zone tier config keys.
+
+.. option:: --sync-from-all[=false]
+
+ Set/reset whether zone syncs from all zonegroup peers.
+
+.. option:: --sync-from=[zone-name][,...]
+
+ Set the list of zones to sync from.
+
+.. option:: --sync-from-rm=[zone-name][,...]
+
+ Remove the zones from list of zones to sync from.
.. option:: --fix
.. option:: --format=<format>
- Specify output format for certain operations: xml, json.
+ Specify output format for certain operations. Supported formats: xml, json.
.. option:: --sync-stats
- Option to 'user stats', update user stats with current stats reported by
- user's buckets indexes.
+ Option for 'user stats' command. When specified, it will update user stats with
+ the current stats reported by user's buckets indexes.
.. option:: --show-log-entries=<flag>
Specify a file to read in when setting data.
-.. option:: --state=<state string>
+.. option:: --state=<state>
Specify a state for the opstate set command.
-.. option:: --replica-log-type
+.. option:: --replica-log-type <logtypestr>
Replica log type (metadata, data, bucket), required for replica log
operations.
is set to 0, then the specified object will always be
rewritten for restriping.
+.. option:: --warnings-only
+
+ When specified with bucket limit check,
+ list only buckets nearing or over the current max objects per shard value.
+
+.. option:: --bypass-gc
+
+ When specified with bucket deletion,
+ triggers object deletions by not involving GC.
+
+.. option:: --inconsistent-index
+
+ When specified with bucket deletion and bypass-gc set to true,
+ ignores bucket index consistency.
+
Quota Options
=============
.. option:: --max-size
- Specify max size (in bytes, negative value to disable).
+ Specify max size (in B/K/M/G/T, negative value to disable).
.. option:: --quota-scope
- Scope of quota (bucket, user).
+ The scope of quota (bucket, user).
Orphans Search Options
======================
-.. option:: --pool
-
- Data pool to scan for leaked rados objects
-
.. option:: --num-shards
Number of shards to use for keeping the temporary scan info
Default is 32.
+Orphans list-jobs options
+=========================
+
+.. option:: --extra-info
+
+ Provide extra info in the job list.
+
+
+Role Options
+============
+
+.. option:: --role-name
+
+ The name of the role to create.
+
+.. option:: --path
+
+ The path to the role.
+
+.. option:: --assume-role-policy-doc
+
+ The trust relationship policy document that grants an entity permission to
+ assume the role.
+
+.. option:: --policy-name
+
+ The name of the policy document.
+
+.. option:: --policy-doc
+
+ The permission policy document.
+
+.. option:: --path-prefix
+
+ The path prefix for filtering the roles.
+
Examples
========