summaryrefslogtreecommitdiffstats
path: root/src/test/cli/radosgw-admin/help.t
blob: 828bebf0776f6cf3082ed600b6a98c567fb47550 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
  $ radosgw-admin --help
  usage: radosgw-admin <cmd> [options...]
  commands:
    user create                create a new user
    user modify                modify user
    user info                  get user info
    user rename                rename user
    user rm                    remove user
    user suspend               suspend a user
    user enable                re-enable user after suspension
    user check                 check user info
    user stats                 show user stats as accounted by quota subsystem
    user list                  list users
    caps add                   add user capabilities
    caps rm                    remove user capabilities
    subuser create             create a new subuser
    subuser modify             modify subuser
    subuser rm                 remove subuser
    key create                 create access key
    key rm                     remove access key
    bucket list                list buckets (specify --allow-unordered for
                               faster, unsorted listing)
    bucket limit check         show bucket sharding stats
    bucket link                link bucket to specified user
    bucket unlink              unlink bucket from specified user
    bucket stats               returns bucket statistics
    bucket rm                  remove bucket
    bucket check               check bucket index by verifying size and object count stats
    bucket check olh           check for olh index entries and objects that are pending removal
    bucket check unlinked      check for object versions that are not visible in a bucket listing 
    bucket chown               link bucket to specified user and update its object ACLs
    bucket reshard             reshard bucket
    bucket rewrite             rewrite all objects in the specified bucket
    bucket sync checkpoint     poll a bucket's sync status until it catches up to its remote
    bucket sync disable        disable bucket sync
    bucket sync enable         enable bucket sync
    bucket radoslist           list rados objects backing bucket's objects
    bi get                     retrieve bucket index object entries
    bi put                     store bucket index object entries
    bi list                    list raw bucket index entries
    bi purge                   purge bucket index entries
    object rm                  remove object
    object put                 put object
    object stat                stat an object for its metadata
    object unlink              unlink object from bucket index
    object rewrite             rewrite the specified object
    object reindex             reindex the object(s) indicated by --bucket and either --object or --objects-file
    objects expire             run expired objects cleanup
    objects expire-stale list  list stale expired objects (caused by reshard)
    objects expire-stale rm    remove stale expired objects
    period rm                  remove a period
    period get                 get period info
    period get-current         get current period info
    period pull                pull a period
    period push                push a period
    period list                list all periods
    period update              update the staging period
    period commit              commit the staging period
    quota set                  set quota params
    quota enable               enable quota
    quota disable              disable quota
    ratelimit get              get ratelimit params
    ratelimit set              set ratelimit params
    ratelimit enable           enable ratelimit
    ratelimit disable          disable ratelimit
    global quota get           view global quota params
    global quota set           set global quota params
    global quota enable        enable a global quota
    global quota disable       disable a global quota
    global ratelimit get       view global ratelimit params
    global ratelimit set       set global ratelimit params
    global ratelimit enable    enable a ratelimit quota
    global ratelimit disable   disable a ratelimit quota
    realm create               create a new realm
    realm rm                   remove a realm
    realm get                  show realm info
    realm get-default          get default realm name
    realm list                 list realms
    realm list-periods         list all realm periods
    realm rename               rename a realm
    realm set                  set realm info (requires infile)
    realm default              set realm as default
    realm pull                 pull a realm and its current period
    zonegroup add              add a zone to a zonegroup
    zonegroup create           create a new zone group info
    zonegroup default          set default zone group
    zonegroup delete           delete a zone group info
    zonegroup get              show zone group info
    zonegroup modify           modify an existing zonegroup
    zonegroup set              set zone group info (requires infile)
    zonegroup rm               remove a zone from a zonegroup
    zonegroup rename           rename a zone group
    zonegroup list             list all zone groups set on this cluster
    zonegroup placement list   list zonegroup's placement targets
    zonegroup placement get    get a placement target of a specific zonegroup
    zonegroup placement add    add a placement target id to a zonegroup
    zonegroup placement modify modify a placement target of a specific zonegroup
    zonegroup placement rm     remove a placement target from a zonegroup
    zonegroup placement default  set a zonegroup's default placement target
    zone create                create a new zone
    zone rm                    remove a zone
    zone get                   show zone cluster params
    zone modify                modify an existing zone
    zone set                   set zone cluster params (requires infile)
    zone list                  list all zones set on this cluster
    zone rename                rename a zone
    zone placement list        list zone's placement targets
    zone placement get         get a zone placement target
    zone placement add         add a zone placement target
    zone placement modify      modify a zone placement target
    zone placement rm          remove a zone placement target
    metadata sync status       get metadata sync status
    metadata sync init         init metadata sync
    metadata sync run          run metadata sync
    data sync status           get data sync status of the specified source zone
    data sync init             init data sync for the specified source zone
    data sync run              run data sync for the specified source zone
    pool add                   add an existing pool for data placement
    pool rm                    remove an existing pool from data placement set
    pools list                 list placement active set
    policy                     read bucket/object policy
    log list                   list log objects
    log show                   dump a log from specific object or (bucket + date
                               + bucket-id)
                               (NOTE: required to specify formatting of date
                               to "YYYY-MM-DD-hh")
    log rm                     remove log object
    usage show                 show usage (by user, by bucket, date range)
    usage trim                 trim usage (by user, by bucket, date range)
    usage clear                reset all the usage stats for the cluster
    gc list                    dump expired garbage collection objects (specify
                               --include-all to list all entries, including unexpired)
    gc process                 manually process garbage (specify
                               --include-all to process all entries, including unexpired)
    lc list                    list all bucket lifecycle progress
    lc get                     get a lifecycle bucket configuration
    lc process                 manually process lifecycle
    lc reshard fix             fix LC for a resharded bucket
    metadata get               get metadata info
    metadata put               put metadata info
    metadata rm                remove metadata info
    metadata list              list metadata info
    mdlog list                 list metadata log
    mdlog autotrim             auto trim metadata log
    mdlog trim                 trim metadata log (use marker)
    mdlog status               read metadata log status
    bilog list                 list bucket index log
    bilog trim                 trim bucket index log (use start-marker, end-marker)
    bilog status               read bucket index log status
    bilog autotrim             auto trim bucket index log
    datalog list               list data log
    datalog trim               trim data log
    datalog status             read data log status
    datalog type               change datalog type to --log_type={fifo,omap}
    orphans find               deprecated -- init and run search for leaked rados objects (use job-id, pool)
    orphans finish             deprecated -- clean up search for leaked rados objects
    orphans list-jobs          deprecated -- list the current job-ids for orphans search
                             * the three 'orphans' sub-commands are now deprecated; consider using the `rgw-orphan-list` tool
    role create                create a AWS role for use with STS
    role delete                remove a role
    role get                   get a role
    role list                  list roles with specified path prefix
    role-trust-policy modify   modify the assume role policy of an existing role
    role-policy put            add/update permission policy to role
    role-policy list           list policies attached to a role
    role-policy get            get the specified inline policy document embedded with the given role
    role-policy delete         remove policy attached to a role
    role update                update max_session_duration of a role
    reshard add                schedule a resharding of a bucket
    reshard list               list all bucket resharding or scheduled to be resharded
    reshard status             read bucket resharding status
    reshard process            process of scheduled reshard jobs
    reshard cancel             cancel resharding a bucket
    reshard stale-instances list list stale-instances from bucket resharding
    reshard stale-instances delete   cleanup stale-instances from bucket resharding
    sync error list            list sync error
    sync error trim            trim sync error
    mfa create                 create a new MFA TOTP token
    mfa list                   list MFA TOTP tokens
    mfa get                    show MFA TOTP token
    mfa remove                 delete MFA TOTP token
    mfa check                  check MFA TOTP token
    mfa resync                 re-sync MFA TOTP token
    topic list                 list bucket notifications topics
    topic get                  get a bucket notifications topic
    topic rm                   remove a bucket notifications topic
    script put                 upload a lua script to a context
    script get                 get the lua script of a context
    script rm                  remove the lua scripts of a context
    script-package add         add a lua package to the scripts allowlist
    script-package rm          remove a lua package from the scripts allowlist
    script-package list        get the lua packages allowlist
    notification list          list bucket notifications configuration
    notification get           get a bucket notifications configuration
    notification rm            remove a bucket notifications configuration
  options:
     --tenant=<tenant>         tenant name
     --user_ns=<namespace>     namespace of user (oidc in case of users authenticated with oidc provider)
     --uid=<id>                user id
     --new-uid=<id>            new user id
     --subuser=<name>          subuser name
     --access-key=<key>        S3 access key
     --email=<email>           user's email address
     --secret/--secret-key=<key>
                               specify secret key
     --gen-access-key          generate random access key (for S3)
     --gen-secret              generate random secret key
     --key-type=<type>         key type, options are: swift, s3
     --temp-url-key[-2]=<key>  temp url key
     --access=<access>         Set access permissions for sub-user, should be one
                               of read, write, readwrite, full
     --display-name=<name>     user's display name
     --max-buckets             max number of buckets for a user
     --admin                   set the admin flag on the user
     --system                  set the system flag on the user
     --op-mask                 set the op mask on the user
     --bucket=<bucket>         Specify the bucket name. Also used by the quota command.
     --pool=<pool>             Specify the pool name. Also used to scan for leaked rados objects.
     --object=<object>         object name
     --objects-file=<file>     file containing a list of object names to process
     --object-version=<version>         object version
     --date=<date>             date in the format yyyy-mm-dd
     --start-date=<date>       start date in the format yyyy-mm-dd
     --end-date=<date>         end date in the format yyyy-mm-dd
     --bucket-id=<bucket-id>   bucket id
     --bucket-new-name=<bucket>
                               for bucket link: optional new name
     --shard-id=<shard-id>     optional for: 
                                 mdlog list
                                 data sync status
                               required for: 
                                 mdlog trim
     --gen=<gen-id>            optional for: 
                                 bilog list
                                 bilog trim
                                 bilog status
     --max-entries=<entries>   max entries for listing operations
     --metadata-key=<key>      key to retrieve metadata from with metadata get
     --remote=<remote>         zone or zonegroup id of remote gateway
     --period=<id>             period id
     --url=<url>               url for pushing/pulling period/realm
     --epoch=<number>          period epoch
     --commit                  commit the period during 'period update'
     --staging                 get staging period info
     --master                  set as master
     --master-zone=<id>        master zone id
     --rgw-realm=<name>        realm name
     --realm-id=<id>           realm id
     --realm-new-name=<name>   realm new name
     --rgw-zonegroup=<name>    zonegroup name
     --zonegroup-id=<id>       zonegroup id
     --zonegroup-new-name=<name>
                               zonegroup new name
     --rgw-zone=<name>         name of zone in which radosgw is running
     --zone-id=<id>            zone id
     --zone-new-name=<name>    zone new name
     --source-zone             specify the source zone (for data sync)
     --default                 set entity (realm, zonegroup, zone) as default
     --read-only               set zone as read-only (when adding to zonegroup)
     --redirect-zone           specify zone id to redirect when response is 404 (not found)
     --placement-id            placement id for zonegroup placement commands
     --storage-class           storage class for zonegroup placement commands
     --tags=<list>             list of tags for zonegroup placement add and modify commands
     --tags-add=<list>         list of tags to add for zonegroup placement modify command
     --tags-rm=<list>          list of tags to remove for zonegroup placement modify command
     --endpoints=<list>        zone endpoints
     --index-pool=<pool>       placement target index pool
     --data-pool=<pool>        placement target data pool
     --data-extra-pool=<pool>  placement target data extra (non-ec) pool
     --placement-index-type=<type>
                               placement target index type (normal, indexless, or #id)
     --placement-inline-data=<true>
                               set whether the placement target is configured to store a data
                               chunk inline in head objects
     --compression=<type>      placement target compression type (plugin name or empty/none)
     --tier-type=<type>        zone tier type
     --tier-config=<k>=<v>[,...]
                               set zone tier config keys, values
     --tier-config-rm=<k>[,...]
                               unset zone tier config keys
     --sync-from-all[=false]   set/reset whether zone syncs from all zonegroup peers
     --sync-from=[zone-name][,...]
                               set list of zones to sync from
     --sync-from-rm=[zone-name][,...]
                               remove zones from list of zones to sync from
     --bucket-index-max-shards override a zone/zonegroup's default bucket index shard count
     --fix                     besides checking bucket index, will also fix it
     --check-objects           bucket check: rebuilds bucket index according to
                               actual objects state
     --format=<format>         specify output format for certain operations: xml,
                               json
     --purge-data              when specified, user removal will also purge all the
                               user data
     --purge-keys              when specified, subuser removal will also purge all the
                               subuser keys
     --purge-objects           remove a bucket's objects before deleting it
                               (NOTE: required to delete a non-empty bucket)
     --sync-stats              option to 'user stats', update user stats with current
                               stats reported by user's buckets indexes
     --reset-stats             option to 'user stats', reset stats in accordance with user buckets
     --show-config             show configuration
     --show-log-entries=<flag> enable/disable dump of log entries on log show
     --show-log-sum=<flag>     enable/disable dump of log summation on log show
     --skip-zero-entries       log show only dumps entries that don't have zero value
                               in one of the numeric field
     --infile=<file>           file to read in when setting data
     --categories=<list>       comma separated list of categories, used in usage show
     --caps=<caps>             list of caps (e.g., "usage=read, write; user=read")
     --op-mask=<op-mask>       permission of user's operations (e.g., "read, write, delete, *")
     --yes-i-really-mean-it    required for certain operations
     --warnings-only           when specified with bucket limit check, list
                               only buckets nearing or over the current max
                               objects per shard value
     --bypass-gc               when specified with bucket deletion, triggers
                               object deletions by not involving GC
     --inconsistent-index      when specified with bucket deletion and bypass-gc set to true,
                               ignores bucket index consistency
     --min-rewrite-size        min object size for bucket rewrite (default 4M)
     --max-rewrite-size        max object size for bucket rewrite (default ULLONG_MAX)
     --min-rewrite-stripe-size min stripe size for object rewrite (default 0)
     --trim-delay-ms           time interval in msec to limit the frequency of sync error log entries trimming operations,
                               the trimming process will sleep the specified msec for every 1000 entries trimmed
     --max-concurrent-ios      maximum concurrent ios for bucket operations (default: 32)
     --enable-feature          enable a zone/zonegroup feature
     --disable-feature         disable a zone/zonegroup feature
  
  <date> := "YYYY-MM-DD[ hh:mm:ss]"
  
  Quota options:
     --max-objects             specify max objects (negative value to disable)
     --max-size                specify max size (in B/K/M/G/T, negative value to disable)
     --quota-scope             scope of quota (bucket, user)
  
  Rate limiting options:
     --max-read-ops            specify max requests per minute for READ ops per RGW (GET and HEAD request methods), 0 means unlimited
     --max-read-bytes          specify max bytes per minute for READ ops per RGW (GET and HEAD request methods), 0 means unlimited
     --max-write-ops           specify max requests per minute for WRITE ops per RGW (Not GET or HEAD request methods), 0 means unlimited
     --max-write-bytes         specify max bytes per minute for WRITE ops per RGW (Not GET or HEAD request methods), 0 means unlimited
     --ratelimit-scope         scope of rate limiting: bucket, user, anonymous
                               anonymous can be configured only with global rate limit
  
  Orphans search options:
     --num-shards              num of shards to use for keeping the temporary scan info
     --orphan-stale-secs       num of seconds to wait before declaring an object to be an orphan (default: 86400)
     --job-id                  set the job id (for orphans find)
     --detail                  detailed mode, log and stat head objects as well
  
  Orphans list-jobs options:
     --extra-info              provide extra info in job list
  
  Role options:
     --role-name               name of the role to create
     --path                    path to the role
     --assume-role-policy-doc  the trust relationship policy document that grants an entity permission to assume the role
     --policy-name             name of the policy document
     --policy-doc              permission policy document
     --path-prefix             path prefix for filtering roles
  
  MFA options:
     --totp-serial             a string that represents the ID of a TOTP token
     --totp-seed               the secret seed that is used to calculate the TOTP
     --totp-seconds            the time resolution that is being used for TOTP generation
     --totp-window             the number of TOTP tokens that are checked before and after the current token when validating token
     --totp-pin                the valid value of a TOTP token at a certain time
  
  Bucket notifications options:
     --topic                   bucket notifications topic name
     --notification-id         bucket notifications id
  
  Script options:
     --context                 context in which the script runs. one of: prerequest, postrequest, background, getdata, putdata
     --package                 name of the lua package that should be added/removed to/from the allowlist
     --allow-compilation       package is allowed to compile C code as part of its installation
  
  Bucket check olh/unlinked options:
     --min-age-hours           minimum age of unlinked objects to consider for bucket check unlinked (default: 1)
     --dump-keys               when specified, all keys identified as problematic are printed to stdout
     --hide-progress           when specified, per-shard progress details are not printed to stderr
  
  radoslist options:
     --rgw-obj-fs              the field separator that will separate the rados
                               object name from the rgw object name;
                               additionally rados objects for incomplete
                               multipart uploads will not be output
  
    --conf/-c FILE    read configuration from the given configuration file
    --id ID           set ID portion of my name
    --name/-n TYPE.ID set name
    --cluster NAME    set cluster name (default: ceph)
    --setuser USER    set uid to user or uid (and gid to user's gid)
    --setgroup GROUP  set gid to group or gid
    --version         show version and quit