Skip to main content

vserver object-store-server bucket policy statement show

Contributors
Suggest changes

Show the bucket policy

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver object-store-server bucket policy statement show command displays information about object store server bucket policy.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

[-vserver <Vserver Name>] - Vserver Name

If you specify this parameter, the command displays information on the object store server bucket policy statements for the specified Vserver.

[-bucket <TextNoCase>] - Object Store Server Bucket Name

If you specify this parameter, the command displays information on the object store server bucket policy statements for the specified bucket.

[-index <integer>] - Statement Index

If you specify this parameter, the command displays information on the object store server bucket policy statements that match the specified index.

[-effect {deny|allow}] - Allow or Deny Access

If you specify this parameter, the command displays information on the object store server bucket policy statements that match the specified effect.

[-action <Action>,…​] - Bucket Policy Action Allowed or Denied

If you specify this parameter, the command displays information on the object store server bucket policy statements that match the specified action.

[-principal <Objectstore Principal>,…​] - List of Users to Be Allowed or Denied Access

If you specify this parameter, the command displays information on the object store server bucket policy statements that match the specified bucket principal.

[-resource <text>,…​] - Bucket or Objects to Be Allowed or Denied Access

If you specify this parameter, the command displays information on the object store server bucket policy statements that match the specified resource.

[-sid <SID>] - Statement Identifier

If you specify this parameter, the command displays information on the object store server bucket policy statements that match the specified sid.

Examples

The following example displays information on object store server bucket policy statements for vserver vs1 and bucket bucket1:

cluster1::> vserver object-store-server bucket policy show -vserver vs1 -bucket bucket1
Vserver     Bucket     Index Effect Action       Principal       Resource
----------- ---------- ----- ------ ------------ --------------- --------------
vs1
            bucket1        1 allow  GetObject,   user1           bucket1/
                                    PutObject,                   readme/*
                                    DeleteObject
                                    , ListBucket
            bucket1        2 allow  GetObject    user2           bucket1/*
2 entries were displayed.

The following example displays detailed information of the object store server bucket policy statement associated with Vserver vs1 and bucket bucket1:

cluster1::> vserver object-store-server bucket policy show -vserver vs1 -bucket bucket1 -index 1
Vserver           :vs1
            Bucket            :bucket1
            Index             :1
            Effect            :allow
            Action            :GetObject
            Principal         :user-2
            Resource          :bucket1/readme/*
            Sid               :AllowAccessToUseruser1ForGetObject