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

Configuring a Bucket Policy

Function

You can use this command to configure a bucket policy.

Command Line Structure

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

Examples

  • In Windows, run obsutil bucketpolicy obs://bucket -method=put -localfile=d:\temp\policy.json to apply a policy to the bucket bucket using the policy.json file. 
    obsutil bucketpolicy obs://bucket -method=put -localfile=d:\temp\policy.json

Start at 2024-09-30 07:59:28.8675681 +0000 UTC

Put bucketPolicy succeed, requestId is [04050000016836C5DA6FB21F14A2A0C0]

Parameter Description

Parameter

Optional or Mandatory

Description

bucket

Mandatory

The bucket name

method

Mandatory

The method. Set this parameter to put when configuring a bucket policy.

localfile

Mandatory

The path of the local policy file to import

bucket-cname

Optional (additional parameter)

The user-defined domain name bound to the bucket

NOTE:

This parameter is only supported by obsutil 5.7.9 and later.

config

Optional (additional parameter)

The user-defined configuration file for executing the current command. For details about parameters that can be configured, 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