调用CreateCdsFileShareLink创建文件分享链接-无影云电脑企业版-阿里云-无影云电脑企业版-阿里云帮助中心

创建文件分享。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

ecd:CreateCdsFileShareLink

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
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	否	分享名。如果未设置，默认使用`file_id_list`中的第一个 ID 对应的文件名。长度范围为 0~128 个字符。	view.txt
DisablePreview	boolean	否	是否禁止预览分享中的文件。枚举值： true : 禁止预览 false : 允许预览	false
DisableSave	boolean	否	是否禁止转存分享中的文件。枚举值： true : 禁止转存 false : 允许转存	false
DisableDownload	boolean	否	是否禁止下载分享中的文件。枚举值： true : 禁止下载 false : 允许下载	false
PreviewLimit	integer	否	分享预览次数限制。取值范围为整数，取值为 0 时表示不限制。	100
SaveLimit	integer	否	分享转存次数限制。取值范围为整数，取值为 0 时表示不限制。	100
DownloadLimit	integer	否	分享下载次数限制。取值范围为整数，取值为 0 时表示不限制。	100
EndUserId	string	否	使用网盘的用户 ID。	alice
FileIds	array	否	文件 ID 列表。
	string	否	文件的 ID。您可以调用 ListCdsFiles 接口查询对应文件的 ID。	[ "4221bf6e6ab43c255edc4463bf3a6f5f5d31****" ]
GroupId	string	否	团队空间 ID。	cg-i1ruuudp92qpj****

返回参数

名称	类型	描述	示例值
	object
Code	string	执行结果。返回`success`表示成功，否则将返回错误信息。	success
Message	string	错误信息。当 Code 为`success`时，不返回该参数。	success
Data	CdsFileShareLinkModel	数据信息。
RequestId	string	请求 ID。	51592A88-0F2C-55E6-AD2C-2AD9C10D****
Success	boolean	操作是否成功。枚举值： true : 成功 false : 失败	true

示例

正常返回示例

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
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。