RGW-POLICY-TEST(8) Ceph RGW-POLICY-TEST(8)

# [NAME](#NAME)

rgw-policy-test - test evaluation of bucket policy

# [SYNOPSIS](#SYNOPSIS)

```
rgw-policy-test
[-e key*=*value]... [-t tenant] [-R resource] [-I identity] action filename
```

# [DESCRIPTION](#DESCRIPTION)

This utility reads a policy from a file or stdin and evaluates it against the supplied identity, resource, action, and request context (the key/value pairs evaluated by conditions.) The utility will print a trace of evaluating the policy and the effect of its evaluation.

On error it will print a message and return non-zero.

# [OPTIONS](#OPTIONS)

[**-t \*tenant\*, --tenant \*tenant\***](#t)

Specify *tenant* as the tenant. If not provided, the default (empty) tenant is used.

[**-e \*key\*=\*value\*, --environment \*key\*=\*value\***](#e)

Add (*key*, *value*) to the environment for evaluation. May be specified multiple times.

[**-I \*SCHEMA:STRING\*, --identity \*SCHEMA:STRING\***](#I)

Specify *identity* as the identity whose access is to be checked.

[**-R \*ARN\*, --resource \*ARN\***](#R)

Specify *ARN* as the resource for which to check access.

**\*action\***

Use *action* as the action to check.

**\*filename\***

Read the policy from *filename*, or - for standard input.

# [AVAILABILITY](#AVAILABILITY)

**rgw-policy-test** is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to the Ceph documentation at &lt;https://docs.ceph.com/&gt; for more information.

# [SEE ALSO](#SEE_ALSO)

radosgw &lt;&gt;(8)

# [Copyright](#Copyright)

2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)

November 2, 2026 dev

---

Document: rgw-policy-test(8) from ceph-20 20.2.5-r0 (Chainguard OS)
Source: https://github.com/ceph/ceph.git
