判断对象是否存在

最近更新时间:2024-08-14 14:20:21

我的收藏

简介

本文档提供关于检查对象是否存在的 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()); } }

API 操作

判断对象是否存在涉及的 API 接口说明,请参见 HEAD Object 文档。