Help Center/ Object Storage Service/ Tools Guide/ obsutil/ Bucket Commands/ Obtaining a Bucket Policy
Updated on 2025-10-29 GMT+08:00
View PDF
Share

Obtaining a Bucket Policy

Function

You can use this command to obtain a bucket policy.

Command Line Structure

  • In Windows 
    obsutil bucketpolicy obs://bucket -method=get [-localfile=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  • In Linux or macOS 
    ./obsutil bucketpolicy obs://bucket -method=get [-localfile=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

Examples

  • Take the Windows OS as an example. Run the obsutil bucketpolicy obs://bucket -method=get -localfile=d:\temp\policy.json command to export the bucket policy to local file policy.json. 
    obsutil bucketpolicy obs://bucket -method=get -localfile=d:\temp\policy.json

Start at 2024-09-30 08:08:59.9412332 +0000 UTC

Export bucketPolicy to [d:\temp\policy.json] succeed, requestId is [04050000016836C5DA6FB21F14A2A0C0]

Parameter Description

Parameter

Optional or Mandatory

Description

bucket

Mandatory

The bucket name

method

Mandatory

The method. Set this parameter to get when obtaining a bucket policy.

localfile

Optional (additional parameter)

The local file to which the policy is exported. If this parameter is not specified, the configuration defaults to standard output.

config

Optional (additional parameter)

The user-defined configuration file for executing the current command. For details about the supported configuration parameters, see Configuration Parameters.

e

Optional (additional parameter)

The endpoint

i

Optional (additional parameter)

The user's AK

k

Optional (additional parameter)

The user's SK

t

Optional (additional parameter)

The user's security token
Parent topic: Bucket Commands