简介
本文档提供关于检查对象是否存在的 API 概览以及 SDK 示例代码。
注意事项
此接口接受存储桶名称、对象名两个参数作为入参，返回对象是否存在的布尔类型。接口实际上为 HeadObject（查询对象元数据）接口的封装，需要获取对象详细元数据，请使用 查询对象元数据。
若您要判断某个对象是否存在，需要具有目标对象的读取权限：在您进行 授权策略 时，action 需要设置为
cos:HeadObject，更多授权请参见 支持CAM的业务接口。相关示例
功能名称 | 描述 | 示例代码 |
判断对象是否存在 | 提供了判断对象是否存在的功能。 |
前期准备：初始化 COS 服务实例
public class ObjectModel { private CosXml cosXml; //将服务用户设置成数据成员 // 初始化COS服务实例 private void InitCosXml() { string region = Environment.GetEnvironmentVariable("COS_REGION"); CosXmlConfig config = new CosXmlConfig.Builder() .SetRegion(region) // 设置默认的地域, COS 地域的简称请参照 https://cloud.tencent.com/document/product/436/6224 .Build(); string secretId = Environment.GetEnvironmentVariable("SECRET_ID"); // 云 API 密钥 SecretId, 获取 API 密钥请参照 https://console.cloud.tencent.com/cam/capi string secretKey = Environment.GetEnvironmentVariable("SECRET_KEY"); // 云 API 密钥 SecretKey, 获取 API 密钥请参照 https://console.cloud.tencent.com/cam/capi long durationSecond = 600; //每次请求签名有效时长，单位为秒 QCloudCredentialProvider qCloudCredentialProvider = new DefaultQCloudCredentialProvider(secretId, secretKey, durationSecond); this.cosXml = new CosXmlServer(config, qCloudCredentialProvider); } }
使用案例
判断对象是否存在
public void DoesObjectExist() { try { // 存储桶名称，此处填入格式必须为 bucketname-APPID, 其中 APPID 获取参考 https://console.cloud.tencent.com/developer string bucket = "examplebucket-1250000000"; string key = "exampleObject"; //对象键 DoesObjectExistRequest request = new DoesObjectExistRequest(bucket, key); //执行请求 bool exist = cosXml.DoesObjectExist(request); //请求成功 Console.WriteLine("object exist state is: " + exist); } catch (COSXML.CosException.CosClientException clientEx) { Console.WriteLine("CosClientException: " + clientEx); } catch (COSXML.CosException.CosServerException serverEx) { Console.WriteLine("CosServerException: " + serverEx.GetInfo()); } }
