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   options:
 144      --tenant=<tenant>         tenant name
 145      --uid=<id>                user id
 146      --subuser=<name>          subuser name
 147      --access-key=<key>        S3 access key
 148      --email=<email>
 149      --secret/--secret-key=<key>
 150                                specify secret key
 151      --gen-access-key          generate random access key (for S3)
 152      --gen-secret              generate random secret key
 153      --key-type=<type>         key type, options are: swift, s3
 154      --temp-url-key[-2]=<key>  temp url key
 155      --access=<access>         Set access permissions for sub-user, should be one
 156                                of read, write, readwrite, full
 157      --display-name=<name>
 158      --max-buckets             max number of buckets for a user
 159      --admin                   set the admin flag on the user
 160      --system                  set the system flag on the user
 161      --bucket=<bucket>
 162      --pool=<pool>
 163      --object=<object>
 164      --date=<date>
 165      --start-date=<date>
 166      --end-date=<date>
 167      --bucket-id=<bucket-id>
 168      --shard-id=<shard-id>     optional for mdlog list
 169                                required for:
 170                                  mdlog trim
 171                                  replica mdlog get/delete
 172                                  replica datalog get/delete
 173      --metadata-key=<key>      key to retrieve metadata from with metadata get
 174      --remote=<remote>         zone or zonegroup id of remote gateway
 175      --period=<id>             period id
 176      --epoch=<number>          period epoch
 177      --commit                  commit the period during 'period update'
 178      --staging                 get staging period info
 179      --master                  set as master
 180      --master-url              master url
 181      --master-zonegroup=<id>   master zonegroup id
 182      --master-zone=<id>        master zone id
 183      --rgw-realm=<name>        realm name
 184      --realm-id=<id>           realm id
 185      --realm-new-name=<name>   realm new name
 186      --rgw-zonegroup=<name>    zonegroup name
 187      --zonegroup-id=<id>       zonegroup id
 188      --zonegroup-new-name=<name>
 189                                zonegroup new name
 190      --rgw-zone=<name>         name of zone in which radosgw is running
 191      --zone-id=<id>            zone id
 192      --zone-new-name=<name>    zone new name
 193      --source-zone             specify the source zone (for data sync)
 194      --default                 set entity (realm, zonegroup, zone) as default
 195      --read-only               set zone as read-only (when adding to zonegroup)
 196      --placement-id            placement id for zonegroup placement commands
 197      --tags=<list>             list of tags for zonegroup placement add and modify commands
 198      --tags-add=<list>         list of tags to add for zonegroup placement modify command
 199      --tags-rm=<list>          list of tags to remove for zonegroup placement modify command
 200      --endpoints=<list>        zone endpoints
 201      --index-pool=<pool>       placement target index pool
 202      --data-pool=<pool>        placement target data pool
 203      --data-extra-pool=<pool>  placement target data extra (non-ec) pool
 204      --placement-index-type=<type>
 205                                placement target index type (normal, indexless, or #id)
 206      --compression=<type>      placement target compression type (plugin name or empty/none)
 207      --tier-type=<type>        zone tier type
 208      --tier-config=<k>=<v>[,...]
 209                                set zone tier config keys, values
 210      --tier-config-rm=<k>[,...]
 211                                unset zone tier config keys
 212      --sync-from-all[=false]   set/reset whether zone syncs from all zonegroup peers
 213      --sync-from=[zone-name][,...]
 214                                set list of zones to sync from
 215      --sync-from-rm=[zone-name][,...]
 216                                remove zones from list of zones to sync from
 217      --fix                     besides checking bucket index, will also fix it
 218      --check-objects           bucket check: rebuilds bucket index according to
 219                                actual objects state
 220      --format=<format>         specify output format for certain operations: xml,
 221                                json
 222      --purge-data              when specified, user removal will also purge all the
 223                                user data
 224      --purge-keys              when specified, subuser removal will also purge all the
 225                                subuser keys
 226      --purge-objects           remove a bucket's objects before deleting it
 227                                (NOTE: required to delete a non-empty bucket)
 228      --sync-stats              option to 'user stats', update user stats with current
 229                                stats reported by user's buckets indexes
 230      --show-log-entries=<flag> enable/disable dump of log entries on log show
 231      --show-log-sum=<flag>     enable/disable dump of log summation on log show
 232      --skip-zero-entries       log show only dumps entries that don't have zero value
 233                                in one of the numeric field
 234      --infile=<file>           specify a file to read in when setting data
 235      --state=<state string>    specify a state for the opstate set command
 236      --replica-log-type        replica log type (metadata, data, bucket), required for
 237                                replica log operations
 238      --categories=<list>       comma separated list of categories, used in usage show
 239      --caps=<caps>             list of caps (e.g., "usage=read, write; user=read")
 240      --yes-i-really-mean-it    required for certain operations
 241      --warnings-only           when specified with bucket limit check, list
 242                                only buckets nearing or over the current max
 243                                objects per shard value
 244      --bypass-gc               when specified with bucket deletion, triggers
 245                                object deletions by not involving GC
 246      --inconsistent-index      when specified with bucket deletion and bypass-gc set to true,
 247                                ignores bucket index consistency
 248
 249   <date> := "YYYY-MM-DD[ hh:mm:ss]"
 250
 251   Quota options:
 252      --bucket                  specified bucket for quota command
 253      --max-objects             specify max objects (negative value to disable)
 254      --max-size                specify max size (in B/K/M/G/T, negative value to disable)
 255      --quota-scope             scope of quota (bucket, user)
 256
 257   Orphans search options:
 258      --pool                    data pool to scan for leaked rados objects in
 259      --num-shards              num of shards to use for keeping the temporary scan info
 260      --orphan-stale-secs       num of seconds to wait before declaring an object to be an orphan (default: 86400)
 261      --job-id                  set the job id (for orphans find)
 262      --max-concurrent-ios      maximum concurrent ios for orphans find (default: 32)
 263
 264   Orphans list-jobs options:
 265      --extra-info              provide extra info in job list
 266
 267   Role options:
 268      --role-name               name of the role to create
 269      --path                    path to the role
 270      --assume-role-policy-doc  the trust relationship policy document that grants an entity permission to assume the role
 271      --policy-name             name of the policy document
 272      --policy-doc              permission policy document
 273      --path-prefix             path prefix for filtering roles
 274
 275     --conf/-c FILE    read configuration from the given configuration file
 276     --id/-i ID        set ID portion of my name
 277     --name/-n TYPE.ID set name
 278     --cluster NAME    set cluster name (default: ceph)
 279     --setuser USER    set uid to user or uid (and gid to user's gid)
 280     --setgroup GROUP  set gid to group or gid
 281     --version         show version and quit
 282
 283   [1]
 284
 285