ceph/src/test/cli/radosgw-admin/help.t

   1   $ radosgw-admin --help
   2   usage: radosgw-admin <cmd> [options...]
   3   commands:
   4     user create                create a new user
   5     user modify                modify user
   6     user info                  get user info
   7     user rm                    remove user
   8     user suspend               suspend a user
   9     user enable                re-enable user after suspension
  10     user check                 check user info
  11     user stats                 show user stats as accounted by quota subsystem
  12     user list                  list users
  13     caps add                   add user capabilities
  14     caps rm                    remove user capabilities
  15     subuser create             create a new subuser
  16     subuser modify             modify subuser
  17     subuser rm                 remove subuser
  18     key create                 create access key
  19     key rm                     remove access key
  20     bucket list                list buckets (specify --allow-unordered for
  21                                faster, unsorted listing)
  22     bucket limit check         show bucket sharding stats
  23     bucket link                link bucket to specified user
  24     bucket unlink              unlink bucket from specified user
  25     bucket stats               returns bucket statistics
  26     bucket rm                  remove bucket
  27     bucket check               check bucket index
  28     bucket reshard             reshard bucket
  29     bucket rewrite             rewrite all objects in the specified bucket
  30     bucket sync disable        disable bucket sync
  31     bucket sync enable         enable bucket sync
  32     bi get                     retrieve bucket index object entries
  33     bi put                     store bucket index object entries
  34     bi list                    list raw bucket index entries
  35     bi purge                   purge bucket index entries
  36     object rm                  remove object
  37     object put                 put object
  38     object stat                stat an object for its metadata
  39     object unlink              unlink object from bucket index
  40     object rewrite             rewrite the specified object
  41     objects expire             run expired objects cleanup
  42     objects expire-stale list  list stale expired objects (caused by reshard)
  43     objects expire-stale rm    remove stale expired objects
  44     period rm                  remove a period
  45     period get                 get period info
  46     period get-current         get current period info
  47     period pull                pull a period
  48     period push                push a period
  49     period list                list all periods
  50     period update              update the staging period
  51     period commit              commit the staging period
  52     quota set                  set quota params
  53     quota enable               enable quota
  54     quota disable              disable quota
  55     global quota get           view global quota params
  56     global quota set           set global quota params
  57     global quota enable        enable a global quota
  58     global quota disable       disable a global quota
  59     realm create               create a new realm
  60     realm rm                   remove a realm
  61     realm get                  show realm info
  62     realm get-default          get default realm name
  63     realm list                 list realms
  64     realm list-periods         list all realm periods
  65     realm rename               rename a realm
  66     realm set                  set realm info (requires infile)
  67     realm default              set realm as default
  68     realm pull                 pull a realm and its current period
  69     zonegroup add              add a zone to a zonegroup
  70     zonegroup create           create a new zone group info
  71     zonegroup default          set default zone group
  72     zonegroup rm               remove a zone group info
  73     zonegroup get              show zone group info
  74     zonegroup modify           modify an existing zonegroup
  75     zonegroup set              set zone group info (requires infile)
  76     zonegroup rm               remove a zone from a zonegroup
  77     zonegroup rename           rename a zone group
  78     zonegroup list             list all zone groups set on this cluster
  79     zonegroup placement list   list zonegroup's placement targets
  80     zonegroup placement get    get a placement target of a specific zonegroup
  81     zonegroup placement add    add a placement target id to a zonegroup
  82     zonegroup placement modify modify a placement target of a specific zonegroup
  83     zonegroup placement rm     remove a placement target from a zonegroup
  84     zonegroup placement default  set a zonegroup's default placement target
  85     zone create                create a new zone
  86     zone rm                    remove a zone
  87     zone get                   show zone cluster params
  88     zone modify                modify an existing zone
  89     zone set                   set zone cluster params (requires infile)
  90     zone list                  list all zones set on this cluster
  91     zone rename                rename a zone
  92     zone placement list        list zone's placement targets
  93     zone placement get         get a zone placement target
  94     zone placement add         add a zone placement target
  95     zone placement modify      modify a zone placement target
  96     zone placement rm          remove a zone placement target
  97     metadata sync status       get metadata sync status
  98     metadata sync init         init metadata sync
  99     metadata sync run          run metadata sync
 100     data sync status           get data sync status of the specified source zone
 101     data sync init             init data sync for the specified source zone
 102     data sync run              run data sync for the specified source zone
 103     pool add                   add an existing pool for data placement
 104     pool rm                    remove an existing pool from data placement set
 105     pools list                 list placement active set
 106     policy                     read bucket/object policy
 107     log list                   list log objects
 108     log show                   dump a log from specific object or (bucket + date
 109                                + bucket-id)
 110                                (NOTE: required to specify formatting of date
 111                                to "YYYY-MM-DD-hh")
 112     log rm                     remove log object
 113     usage show                 show usage (by user, by bucket, date range)
 114     usage trim                 trim usage (by user, by bucket, date range)
 115     usage clear                reset all the usage stats for the cluster
 116     gc list                    dump expired garbage collection objects (specify
 117                                --include-all to list all entries, including unexpired)
 118     gc process                 manually process garbage (specify
 119                                --include-all to process all entries, including unexpired)
 120     lc list                    list all bucket lifecycle progress
 121     lc get                     get a lifecycle bucket configuration
 122     lc process                 manually process lifecycle
 123     lc reshard fix             fix LC for a resharded bucket
 124     metadata get               get metadata info
 125     metadata put               put metadata info
 126     metadata rm                remove metadata info
 127     metadata list              list metadata info
 128     mdlog list                 list metadata log
 129     mdlog trim                 trim metadata log (use start-date, end-date or
 130                                start-marker, end-marker)
 131     mdlog status               read metadata log status
 132     bilog list                 list bucket index log
 133     bilog trim                 trim bucket index log (use start-marker, end-marker)
 134     datalog list               list data log
 135     datalog trim               trim data log
 136     datalog status             read data log status
 137     orphans find               init and run search for leaked rados objects (use job-id, pool)
 138     orphans finish             clean up search for leaked rados objects
 139     orphans list-jobs          list the current job-ids for orphans search
 140     role create                create a AWS role for use with STS
 141     role rm                    remove a role
 142     role get                   get a role
 143     role list                  list roles with specified path prefix
 144     role modify                modify the assume role policy of an existing role
 145     role-policy put            add/update permission policy to role
 146     role-policy list           list policies attached to a role
 147     role-policy get            get the specified inline policy document embedded with the given role
 148     role-policy rm             remove policy attached to a role
 149     reshard add                schedule a resharding of a bucket
 150     reshard list               list all bucket resharding or scheduled to be resharded
 151     reshard status             read bucket resharding status
 152     reshard process            process of scheduled reshard jobs
 153     reshard cancel             cancel resharding a bucket
 154     reshard stale-instances list list stale-instances from bucket resharding
 155     reshard stale-instances rm   cleanup stale-instances from bucket resharding
 156     sync error list            list sync error
 157     sync error trim            trim sync error
 158     mfa create                 create a new MFA TOTP token
 159     mfa list                   list MFA TOTP tokens
 160     mfa get                    show MFA TOTP token
 161     mfa remove                 delete MFA TOTP token
 162     mfa check                  check MFA TOTP token
 163     mfa resync                 re-sync MFA TOTP token
 164   options:
 165      --tenant=<tenant>         tenant name
 166      --uid=<id>                user id
 167      --subuser=<name>          subuser name
 168      --access-key=<key>        S3 access key
 169      --email=<email>           user's email address
 170      --secret/--secret-key=<key>
 171                                specify secret key
 172      --gen-access-key          generate random access key (for S3)
 173      --gen-secret              generate random secret key
 174      --key-type=<type>         key type, options are: swift, s3
 175      --temp-url-key[-2]=<key>  temp url key
 176      --access=<access>         Set access permissions for sub-user, should be one
 177                                of read, write, readwrite, full
 178      --display-name=<name>     user's display name
 179      --max-buckets             max number of buckets for a user
 180      --admin                   set the admin flag on the user
 181      --system                  set the system flag on the user
 182      --op-mask                 set the op mask on the user
 183      --bucket=<bucket>         Specify the bucket name. Also used by the quota command.
 184      --pool=<pool>             Specify the pool name. Also used to scan for leaked rados objects.
 185      --object=<object>         object name
 186      --date=<date>             date in the format yyyy-mm-dd
 187      --start-date=<date>       start date in the format yyyy-mm-dd
 188      --end-date=<date>         end date in the format yyyy-mm-dd
 189      --bucket-id=<bucket-id>   bucket id
 190      --shard-id=<shard-id>     optional for:
 191                                  mdlog list
 192                                  data sync status
 193                                required for:
 194                                  mdlog trim
 195      --max-entries=<entries>   max entries for listing operations
 196      --metadata-key=<key>      key to retrieve metadata from with metadata get
 197      --remote=<remote>         zone or zonegroup id of remote gateway
 198      --period=<id>             period id
 199      --url=<url>               url for pushing/pulling period/realm
 200      --epoch=<number>          period epoch
 201      --commit                  commit the period during 'period update'
 202      --staging                 get staging period info
 203      --master                  set as master
 204      --master-zone=<id>        master zone id
 205      --rgw-realm=<name>        realm name
 206      --realm-id=<id>           realm id
 207      --realm-new-name=<name>   realm new name
 208      --rgw-zonegroup=<name>    zonegroup name
 209      --zonegroup-id=<id>       zonegroup id
 210      --zonegroup-new-name=<name>
 211                                zonegroup new name
 212      --rgw-zone=<name>         name of zone in which radosgw is running
 213      --zone-id=<id>            zone id
 214      --zone-new-name=<name>    zone new name
 215      --source-zone             specify the source zone (for data sync)
 216      --default                 set entity (realm, zonegroup, zone) as default
 217      --read-only               set zone as read-only (when adding to zonegroup)
 218      --redirect-zone           specify zone id to redirect when response is 404 (not found)
 219      --placement-id            placement id for zonegroup placement commands
 220      --storage-class           storage class for zonegroup placement commands
 221      --tags=<list>             list of tags for zonegroup placement add and modify commands
 222      --tags-add=<list>         list of tags to add for zonegroup placement modify command
 223      --tags-rm=<list>          list of tags to remove for zonegroup placement modify command
 224      --endpoints=<list>        zone endpoints
 225      --index-pool=<pool>       placement target index pool
 226      --data-pool=<pool>        placement target data pool
 227      --data-extra-pool=<pool>  placement target data extra (non-ec) pool
 228      --placement-index-type=<type>
 229                                placement target index type (normal, indexless, or #id)
 230      --compression=<type>      placement target compression type (plugin name or empty/none)
 231      --tier-type=<type>        zone tier type
 232      --tier-config=<k>=<v>[,...]
 233                                set zone tier config keys, values
 234      --tier-config-rm=<k>[,...]
 235                                unset zone tier config keys
 236      --sync-from-all[=false]   set/reset whether zone syncs from all zonegroup peers
 237      --sync-from=[zone-name][,...]
 238                                set list of zones to sync from
 239      --sync-from-rm=[zone-name][,...]
 240                                remove zones from list of zones to sync from
 241      --fix                     besides checking bucket index, will also fix it
 242      --check-objects           bucket check: rebuilds bucket index according to
 243                                actual objects state
 244      --format=<format>         specify output format for certain operations: xml,
 245                                json
 246      --purge-data              when specified, user removal will also purge all the
 247                                user data
 248      --purge-keys              when specified, subuser removal will also purge all the
 249                                subuser keys
 250      --purge-objects           remove a bucket's objects before deleting it
 251                                (NOTE: required to delete a non-empty bucket)
 252      --sync-stats              option to 'user stats', update user stats with current
 253                                stats reported by user's buckets indexes
 254      --reset-stats             option to 'user stats', reset stats in accordance with user buckets
 255      --show-log-entries=<flag> enable/disable dump of log entries on log show
 256      --show-log-sum=<flag>     enable/disable dump of log summation on log show
 257      --skip-zero-entries       log show only dumps entries that don't have zero value
 258                                in one of the numeric field
 259      --infile=<file>           specify a file to read in when setting data
 260      --categories=<list>       comma separated list of categories, used in usage show
 261      --caps=<caps>             list of caps (e.g., "usage=read, write; user=read")
 262      --yes-i-really-mean-it    required for certain operations
 263      --warnings-only           when specified with bucket limit check, list
 264                                only buckets nearing or over the current max
 265                                objects per shard value
 266      --bypass-gc               when specified with bucket deletion, triggers
 267                                object deletions by not involving GC
 268      --inconsistent-index      when specified with bucket deletion and bypass-gc set to true,
 269                                ignores bucket index consistency
 270      --min-rewrite-size        min object size for bucket rewrite (default 4M)
 271      --max-rewrite-size        max object size for bucket rewrite (default ULLONG_MAX)
 272      --min-rewrite-stripe-size min stripe size for object rewrite (default 0)
 273      --trim-delay-ms           time interval in msec to limit the frequency of sync error log entries trimming operations,
 274                                the trimming process will sleep the specified msec for every 1000 entries trimmed
 275
 276   <date> := "YYYY-MM-DD[ hh:mm:ss]"
 277
 278   Quota options:
 279      --max-objects             specify max objects (negative value to disable)
 280      --max-size                specify max size (in B/K/M/G/T, negative value to disable)
 281      --quota-scope             scope of quota (bucket, user)
 282
 283   Orphans search options:
 284      --num-shards              num of shards to use for keeping the temporary scan info
 285      --orphan-stale-secs       num of seconds to wait before declaring an object to be an orphan (default: 86400)
 286      --job-id                  set the job id (for orphans find)
 287      --max-concurrent-ios      maximum concurrent ios for orphans find (default: 32)
 288      --detail                  detailed mode, log and stat head objects as well
 289
 290   Orphans list-jobs options:
 291      --extra-info              provide extra info in job list
 292
 293   Role options:
 294      --role-name               name of the role to create
 295      --path                    path to the role
 296      --assume-role-policy-doc  the trust relationship policy document that grants an entity permission to assume the role
 297      --policy-name             name of the policy document
 298      --policy-doc              permission policy document
 299      --path-prefix             path prefix for filtering roles
 300
 301   MFA options:
 302      --totp-serial             a string that represents the ID of a TOTP token
 303      --totp-seed               the secret seed that is used to calculate the TOTP
 304      --totp-seconds            the time resolution that is being used for TOTP generation
 305      --totp-window             the number of TOTP tokens that are checked before and after the current token when validating token
 306      --totp-pin                the valid value of a TOTP token at a certain time
 307
 308     --conf/-c FILE    read configuration from the given configuration file
 309     --id ID           set ID portion of my name
 310     --name/-n TYPE.ID set name
 311     --cluster NAME    set cluster name (default: ceph)
 312     --setuser USER    set uid to user or uid (and gid to user's gid)
 313     --setgroup GROUP  set gid to group or gid
 314     --version         show version and quit
 315
 316
 317