对象访问 URL

最后更新时间:2021-08-16 10:38:10

    简介

    本文档提供获取对象访问 URL 的代码示例。

    获取对象访问 URL

    功能说明

    查询对象访问的 URL,该接口不会判断对象是否真实存在。

    使用示例

    var url = cos.getObjectUrl({
       Bucket: 'examplebucket-1250000000',
       Region: 'COS_REGION',     /* 存储桶所在地域,必须字段 */
       Key: 'exampleobject',
       Sign: false,    /* 获取不带签名的对象URL */
    });
    

    参数说明

    参数名 参数描述 类型 是否必填
    Bucket 存储桶的名称,命名规则为 BucketName-APPID,此处填写的存储桶名称必须为此格式 String
    Region 存储桶所在地域,枚举值请参见 地域和访问域名 String
    Key 对象键(Object 的名称),对象在存储桶中的唯一标识,详情请参见 对象概述 String
    Sign 是否返回带有签名的 Url,默认为 true Boolean
    Protocol 可选填为http:https:,默认为http:(带冒号) String
    Domain 存储桶访问域名,默认为 {BucketName-APPID}.cos.{Region}.myqcloud.com String
    Method 操作方法,例如 GET,POST,DELETE,HEAD 等 HTTP 方法,默认为 GET String
    Query 参与签名计算的 query 参数对象,{key: 'val'} 的格式 Object
    Headers 参与签名计算的 header 参数对象 Object
    Expires 签名几秒后失效,默认为900秒 Number

    回调函数说明

    function(err, data) { ... }
    
    参数名 参数描述 类型
    err 请求发生错误时返回的对象,包括网络错误和业务错误。如果请求成功则为空,详情请参见 错误码 文档 Object
    data 请求成功时返回的对象,如果请求发生错误,则为空 Object
    - Url 计算得到的 Url String