修改文件分享链接。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试授权信息
当前API暂无授权信息透出。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| CdsId | string | 是 | 无影云盘ID。 | cn-shanghai+cds-135515**** |
| ShareId | string | 是 | 分享ID。 | 7JQX1Fs**** |
| SharePwd | string | 否 | 提取码长度范围：[6, 8]字节。不设置或者设置为空，表示无提取码，在获取分享令牌的时候也不用设置提取码参数。 要求使用ASCII可见字符。 | 12345678 |
| Status | string | 否 | 分享状态。 枚举值：
| enabled |
| Expiration | string | 否 | 失效时间点。 RFC3339格式，比如："2020-06-28T11:33:00.000+08:00"。 当expiration取值""时，表示永久有效。 | 2022-07-20T06:30:22.365Z |
| Description | string | 否 | 分享描述。 长度范围[0, 1024]字符。 | testDescription |
| ShareName | string | 否 | 分享名。 如果未设置，默认使用file_id_list中的第一个ID对应的文件名。 注意 长度范围[0, 128]字符。 | 文件分享 |
| DisablePreview | boolean | 否 | 是否禁止预览分享中的文件。 枚举值：
| false |
| DisableSave | boolean | 否 | 是否禁止转存分享中的文件。 枚举值：
| false |
| DisableDownload | boolean | 否 | 是否禁止下载分享中的文件。 枚举值：
| false |
| PreviewLimit | long | 否 | 分享预览次数限制。 次数要求≥0。 次数0表示不限制。 | 100 |
| SaveLimit | long | 否 | 分享转存次数限制。 次数要求≥0。 次数0表示不限制。 | 100 |
| DownloadLimit | long | 否 | 分享下载次数限制。 次数要求≥0。 次数0表示不限制。 | 0 |
| PreviewCount | long | 否 | 预览次数。 次数要求≥0。 | 0 |
| SaveCount | long | 否 | 转存次数。次数要求≥0。 | 0 |
| DownloadCount | long | 否 | 下载次数。 次数要求≥0。 | 0 |
| ReportCount | long | 否 | 举报次数。 次数要求≥0。 | 0 |
| VideoPreviewCount | long | 否 | 视频预览次数。次数要求≥0。 | 0 |
返回参数
示例
正常返回示例
JSON格式
{
"Code": "success",
"Message": "success",
"Data": {
"Description": "文件分享链接。",
"SaveLimit": 100,
"DownloadCount": 100,
"Creator": "user01",
"SaveCount": 100,
"DisableSave": false,
"SharePwd": "12345678",
"DisablePreview": false,
"AccessCount": 10000,
"ShareId": "7JQX1Fs****",
"DownloadLimit": 100,
"Status": "disabled",
"DriveId": "dri-g0877jp3hu1ox****",
"ModifiyTime": "",
"DisableDownload": false,
"Expiration": "2020-06-28T11:33:00.000+08:00",
"Expired": true,
"PreviewCount": 0,
"PreviewLimit": 100,
"VideoPreviewCount": 0,
"ReportCount": 0,
"FileIds": "[\\\"63886f1fe2014d9a5a3348768dcc27dfc57ee103\\\"]",
"ShareName": "view.txt",
"CreateTime": "2021-09-04T03:30:36Z",
"ShareLink": "https://stg109960.apps.aliyunpds.com/disk/s/7uLJanz****"
},
"RequestId": "F7E4322D-D679-5ACB-A909-490D2F0E****",
"Success": true
}错误码
访问错误中心查看更多错误码。