对象访问 URL

最近更新时间:2024-10-22 19:53:11

我的收藏

简介

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

获取对象访问 URL

功能说明

查询对象访问 URL。
说明
如何使生成的对象 URL 在浏览器中打开是预览,而不是下载:在获取的 URL 后拼接参数 response-content-disposition=inline。2024年1月1日后创建的桶 不支持使用默认域名在浏览器预览文件,建议您配置自定义域名,详情请参见 存储桶切换自定义域名
如何使生成的对象 URL 在浏览器中打开是下载,而不是预览:在获取的 URL 后拼接参数 response-content-disposition=attachment

使用示例

示例一

//获取带有签名的对象下载链接
<?php

require dirname(__FILE__) . '/../vendor/autoload.php';

$secretId = "SECRETID"; //替换为用户的 secretId,请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capi
$secretKey = "SECRETKEY"; //替换为用户的 secretKey,请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capi
$region = "ap-beijing"; //替换为用户的 region,已创建桶归属的region可以在控制台查看,https://console.cloud.tencent.com/cos5/bucket
$cosClient = new Qcloud\\Cos\\Client(
array(
'region' => $region,
'scheme' => 'https', //协议头部,默认为http
'credentials'=> array(
'secretId' => $secretId ,
'secretKey' => $secretKey)));

try {
$bucket = "examplebucket-1250000000"; //存储桶,格式:BucketName-APPID
$key = "exampleobject"; //此处的 key 为对象键,对象键是对象在存储桶中的唯一标识
$signedUrl = $cosClient->getObjectUrl($bucket, $key, '+10 minutes');
// 请求成功
echo $signedUrl;
} catch (\\Exception $e) {
// 请求失败
print_r($e);
}

示例二

//获取不带有签名的对象下载链接,用于匿名下载或分发
<?php

require dirname(__FILE__) . '/../vendor/autoload.php';

$secretId = "SECRETID"; //替换为用户的 secretId,请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capi
$secretKey = "SECRETKEY"; //替换为用户的 secretKey,请登录访问管理控制台进行查看和管理,https://console.cloud.tencent.com/cam/capi
$region = "ap-beijing"; //替换为用户的 region,已创建桶归属的region可以在控制台查看,https://console.cloud.tencent.com/cos5/bucket
$cosClient = new Qcloud\\Cos\\Client(
array(
'region' => $region,
'scheme' => 'https', //协议头部,默认为http
'credentials'=> array(
'secretId' => $secretId ,
'secretKey' => $secretKey)));

try {
$bucket = 'examplebucket-125000000'; //存储桶,格式:BucketName-APPID
$key = "exampleobject"; //此处的 key 为对象键,对象键是对象在存储桶中的唯一标识
$Url = $cosClient -> getObjectUrlWithoutSign($bucket, $key);
// 请求成功
echo $Url;
} catch (\\Exception $e) {
// 请求失败
print_r($e);
}
说明
更多示例请查看 预签名 URL

参数说明

参数名
参数描述
类型
是否必填
Bucket
存储桶的名称,命名规则为 BucketName-APPID,此处填写的存储桶名称必须为此格式
String
Key
对象键(Object 的名称),对象在存储桶中的唯一标识,详情请参见 对象概述
String
Expires
签名几秒后失效,默认为1800秒
String

返回结果说明

方法返回值为对象访问的 URL。