获取Bucket信息-DescribeBucket

获取Bucket的描述信息

Request Parameters

Parameter nameTypeDescriptionRequired
BucketNamestring待获取Bucket的名称,若不提供,则获取所有BucketNo
Offsetint获取所有Bucket列表的偏移数目,默认为0No
Limitint获取所有Bucket列表的限制数目,默认为20No
ProjectIdstring项目ID,若不填写为默认项目。子账户必须填写项目IDNo
注意:如果提供了参数BucketName,则参数Offset和Limit失效。

Response Elements

Parameter nameTypeDescriptionRequired
RetCodeint操作返回码Yes
Actionstring操作名称Yes
DataSetarrayBucket的描述信息 参数见 UFileBucketSetNo

UFileBucketSet

Parameter nameTypeDescriptionRequired
BucketNamestringBucket名称No
BucketIdstringBucket的IDNo
DomainarrayBucket的域名集合 参数见 UFileDomainSetNo
CdnDomainIdarray与Bucket关联的CND加速域名的ID列表No
TypestringBucket访问类型No
CreateTimeintBucket的创建时间No
ModifyTimeintBucket的修改时间No
BizstringBucket所属业务, general或vod或udb general: 普通业务; vod: 视频云业务; udb: 云数据库业务No
RegionstringBucket所属地域No
Tagstring所属业务组No
HasUserDomainint是否存在自定义域名。0不存在,1存在,2错误No

UFileDomainSet

Parameter nameTypeDescriptionRequired
Srcarray源站域名No
CdnarrayUCDN加速域名No
CustomSrcarray用户自定义源站域名No
CustomCdnarray用户自定义CDN加速域名No

Request Example

http(s)://api.ucloud.cn/?Action=DescribeBucket
&BucketName=blue

Response Example

{
    "Retcode": 0,
    "Aciton": "DescribeBucketResponse",
    "DataSet": [
        {
            "Domain": {
                "Src": [
                    "blue.ufile.ucloud.cn"
                ],
                "Cdn": [
                    "blue.ufile.ucloud.com.cn"
                ],
                "CustomCdn": [],
                "CustomSrc": []
            },
            "BucketId": "ufile-qs20fr",
            "Region": "cn-bj2",
            "CreateTime": 1409736300,
            "Biz": "general",
            "BucketName": "blue",
            "ModifyTime": 1409736300,
            "Type": "public",
            "Tag": "dddd",
            "HasUserDomain": 1,
            "CdnDomainId": [
                "ucdn-rohdzp"
            ]
        }
    ]
}