API | Operation | Description |
Creating a bucket | Creates a bucket under a specified account |
func (s *BucketService) Put(ctx context.Context, opt *BucketPutOptions) (*Response, error)
package mainimport ("context""github.com/tencentyun/cos-go-sdk-v5""net/http""net/url""os")func main(){// Bucket name in the format of `BucketName-APPID` (`APPID` is required), which can be viewed in the COS console at https://console.tencentcloud.com/cos5/bucket.// Replace it with your region, which can be viewed in the COS console at https://console.tencentcloud.com/. For more information about regions, visit https://www.tencentcloud.com/document/product/436/6224.u, _ := url.Parse("https://examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com")b := &cos.BaseURL{BucketURL: u}client := cos.NewClient(b, &http.Client{Transport: &cos.AuthorizationTransport{// Get the key from environment variables// Environment variable `SECRETID` refers to the user's `SecretId`, which can be viewed in the CAM console at https://console.tencentcloud.com/cam/capi.SecretID: os.Getenv("SECRETID"), // User `SecretId`. We recommend you use a sub-account key and follow the principle of least privilege to reduce risks. For information about how to obtain a sub-account key, visit https://www.tencentcloud.com/document/product/598/37140?from_cn_redirect=1.// Environment variable `SECRETKEY` refers to the user's `SecretKey`, which can be viewed in the CAM console at https://console.tencentcloud.com/cam/capi.SecretKey: os.Getenv("SECRETKEY"), // User `SecretKey`. We recommend you use a sub-account key and follow the principle of least privilege to reduce risks. For information about how to obtain a sub-account key, visit https://www.tencentcloud.com/document/product/598/37140?from_cn_redirect=1.},})// Sample 1: Creating a bucketopt := &cos.BucketGetOptions{XCosACL: "private",}_, err := client.Bucket.Put(context.Background(), opt)if err != nil{panic(err)}// Sample 2: Creating an MAZ bucketopt.CreateBucketConfiguration = &cos.CreateBucketConfiguration{BucketAZConfig: "MAZ",}_, err = client.Bucket.Put(context.Background(), opt)if err != nil{panic(err)}}
type BucketPutOptions struct {XCosACL stringXCosGrantRead stringXCosGrantWrite stringXCosGrantFullControl stringCreateBucketConfiguration *CreateBucketConfiguration}type CreateBucketConfiguration struct {BucketAZConfig string}
Parameter | Description | Type | Required |
XCosACL | Sets the bucket ACL, such as private, public-read, and public-read-write | String | No |
XCosGrantFullControl | Grants a specified account read and write access to a bucket. Format: id=" ",id=" " . To authorize a sub-account, use id="qcs::cam::uin/{OwnerUin}:uin/{SubUin}" . To authorize a root account, use id="qcs::cam::uin/{OwnerUin}:uin/{OwnerUin}" . Example: id="qcs::cam::uin/100000000001:uin/100000000011",id="qcs::cam::uin/100000000001:uin/100000000001" | String | No |
XCosGrantRead | Grants a specified account read access to a bucket. Format: id=" ",id=" " . To authorize a sub-account, use id="qcs::cam::uin/{OwnerUin}:uin/{SubUin}" . To authorize a root account, use id="qcs::cam::uin/{OwnerUin}:uin/{OwnerUin}" . Example: id="qcs::cam::uin/100000000001:uin/100000000011",id="qcs::cam::uin/100000000001:uin/100000000001" | String | No |
XCosGrantWrite | Grants a specified account write access to a bucket. Format: id=" ",id=" " . To authorize a sub-account, use id="qcs::cam::uin/{OwnerUin}:uin/{SubUin}" . To authorize a root account, use id="qcs::cam::uin/{OwnerUin}:uin/{OwnerUin}" . Example: id="qcs::cam::uin/100000000001:uin/100000000011",id="qcs::cam::uin/100000000001:uin/100000000001" | String | No |
BucketAZConfig | Bucket AZ configuration. Set it to MAZ to create an MAZ bucket. For the applicable regions of MAZ storage classes, see MAZ Feature Overview. | Struct | No |
Apakah halaman ini membantu?