创建文件分享。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试授权信息
下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：
- 操作：是指具体的权限点。
- 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
- 资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用
全部资源表示。
- 条件关键字：是指云产品自身定义的条件关键字。
- 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
| 操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
|---|---|---|---|---|
*全部资源 * |
| 无 |
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| CdsId | string | 是 | 企业网盘 ID。 | cn-shanghai+cds-135515**** |
| SharePwd | string | 否 | 提取码长度范围：0~64 字节。不设置或者设置为空，表示无提取码，在获取分享令牌的时候也不用设置提取码参数。 要求使用 ASCII 可见字符。 | 12345678 |
| Expiration | string | 否 | 失效时间点。 RFC3339 格式。 当取值为空时，表示永久有效。 | 2020-06-28T11:33:00.000+08:00 |
| Description | string | 否 | 分享描述。 长度范围为 0~1024 个字符。 | SharedFile |
| ShareName | string | 否 | 分享名。 如果未设置，默认使用 | view.txt |
| DisablePreview | boolean | 否 | 是否禁止预览分享中的文件。 枚举值：
| false |
| DisableSave | boolean | 否 | 是否禁止转存分享中的文件。 枚举值：
| false |
| DisableDownload | boolean | 否 | 是否禁止下载分享中的文件。 枚举值：
| false |
| PreviewLimit | long | 否 | 分享预览次数限制。取值范围为整数，取值为 0 时表示不限制。 | 100 |
| SaveLimit | long | 否 | 分享转存次数限制。取值范围为整数，取值为 0 时表示不限制。 | 100 |
| DownloadLimit | long | 否 | 分享下载次数限制。取值范围为整数，取值为 0 时表示不限制。 | 100 |
| EndUserId | string | 是 | 使用网盘的用户 ID。 | alice |
| FileIds | array | 是 | 文件 ID 列表。 | |
| string | 是 | 文件的 ID。您可以调用 ListCdsFiles 接口查询对应文件的 ID。 | [ "4221bf6e6ab43c255edc4463bf3a6f5f5d31****" ] | |
| GroupId | string | 否 | 团队空间 ID。 | cg-i1ruuudp92qpj**** |
返回参数
示例
正常返回示例
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": "2021-09-04T04:30:36Z",
"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": "51592A88-0F2C-55E6-AD2C-2AD9C10D****",
"Success": true
}错误码
访问错误中心查看更多错误码。
变更历史
| 变更时间 | 变更内容概要 | 操作 |
|---|---|---|
| 查看变更详情 |