本文档提供关于检索存储桶的 API 概览以及 SDK 示例代码。
API | 操作名 | 操作描述 |
---|---|---|
HEAD Bucket | 检索存储桶及其权限 | 检索存储桶是否存在且是否有权限访问 |
SDK 所有接口的具体参数与方法说明,请参考 SDK API。
HEAD Bucket 请求可以确认该存储桶是否存在,是否有权限访问。有以下几种情况:
using COSXML.Model.Bucket;
using COSXML.Auth;
using System;
using COSXML;
namespace COSSnippet
{
public class HeadBucketModel {
private CosXml cosXml;
HeadBucketModel() {
CosXmlConfig config = new CosXmlConfig.Builder()
.SetRegion("COS_REGION") // 设置默认的地域, COS 地域的简称请参照 https://intl.cloud.tencent.com/document/product/436/6224?from_cn_redirect=1
.Build();
string secretId = "SECRET_ID"; // 云 API 密钥 SecretId, 获取 API 密钥请参照 https://console.intl.cloud.tencent.com/cam/capi
string secretKey = "SECRET_KEY"; // 云 API 密钥 SecretKey, 获取 API 密钥请参照 https://console.intl.cloud.tencent.com/cam/capi
long durationSecond = 600; //每次请求签名有效时长,单位为秒
QCloudCredentialProvider qCloudCredentialProvider = new DefaultQCloudCredentialProvider(secretId,
secretKey, durationSecond);
this.cosXml = new CosXmlServer(config, qCloudCredentialProvider);
}
/// 获取存储桶信息
public void HeadBucket()
{
//.cssg-snippet-body-start:[head-bucket]
try
{
// 存储桶名称,此处填入格式必须为 BucketName-APPID, 其中 APPID 获取参考 https://console.intl.cloud.tencent.com/developer
string bucket = "examplebucket-1250000000";
HeadBucketRequest request = new HeadBucketRequest(bucket);
//执行请求
HeadBucketResult result = cosXml.HeadBucket(request);
//请求成功
Console.WriteLine(result.GetResultInfo());
}
catch (COSXML.CosException.CosClientException clientEx)
{
//请求失败
Console.WriteLine("CosClientException: " + clientEx);
}
catch (COSXML.CosException.CosServerException serverEx)
{
//请求失败
Console.WriteLine("CosServerException: " + serverEx.GetInfo());
}
//.cssg-snippet-body-end
}
// .cssg-methods-pragma
static void Main(string[] args)
{
HeadBucketModel m = new HeadBucketModel();
/// 获取存储桶信息
m.HeadBucket();
// .cssg-methods-pragma
}
}
}
说明:更多完整示例,请前往 GitHub 查看。
本页内容是否解决了您的问题?