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