diff options
Diffstat (limited to 'data/zh_cn/pds/2022-03-01')
| -rw-r--r-- | data/zh_cn/pds/2022-03-01/api-docs.php | 20860 |
1 files changed, 5239 insertions, 15621 deletions
diff --git a/data/zh_cn/pds/2022-03-01/api-docs.php b/data/zh_cn/pds/2022-03-01/api-docs.php index 83250c5..2f461aa 100644 --- a/data/zh_cn/pds/2022-03-01/api-docs.php +++ b/data/zh_cn/pds/2022-03-01/api-docs.php @@ -1,919 +1,187 @@ <?php return [ 'version' => '1.0', - 'info' => [ - 'style' => 'PDS', - 'product' => 'pds', - 'version' => '2022-03-01', - ], + 'info' => ['style' => 'ROA', 'product' => 'pds', 'version' => '2022-03-01'], 'directories' => [ [ - 'id' => 181654, - 'title' => 'Domain管理', + 'children' => ['UpdateDomain', 'ListDomains', 'GetDomain', 'DeleteDomain', 'CreateDomain', 'SearchDomains'], 'type' => 'directory', - 'children' => [ - 'CreateDomain', - 'GetDomain', - 'UpdateDomain', - 'ListDomains', - 'SearchDomains', - 'DeleteDomain', - ], + 'title' => 'Domain管理', + 'id' => 97668, ], [ - 'id' => 165270, - 'title' => '认证与授权', + 'children' => ['Authorize', 'Token'], 'type' => 'directory', - 'children' => [ - 'Authorize', - 'Token', - ], + 'title' => '认证与授权', + 'id' => 97647, ], [ - 'id' => 163808, - 'title' => '账号管理', + 'children' => ['GetLinkInfoByUserId', 'LinkAccount', 'GetLinkInfo', 'UnLinkAccount'], 'type' => 'directory', - 'children' => [ - 'GetLinkInfoByUserId', - 'LinkAccount', - 'GetLinkInfo', - 'UnLinkAccount', - ], + 'title' => '账号管理', + 'id' => 97556, ], [ - 'id' => 165207, - 'title' => '群组管理', + 'children' => ['UpdateGroup', 'GetGroup', 'DeleteGroup', 'CreateGroup', 'GroupUpdateName', 'ListGroup', 'AddGroupMember', 'RemoveGroupMember', 'ListGroupMember'], 'type' => 'directory', - 'children' => [ - 'CreateGroup', - 'UpdateGroup', - 'GetGroup', - 'ListGroup', - 'DeleteGroup', - 'AddGroupMember', - 'RemoveGroupMember', - 'ListGroupMember', - ], + 'title' => '群组管理', + 'id' => 97638, ], [ - 'id' => 163812, - 'title' => '用户管理', + 'children' => ['GetUser', 'CreateUser', 'ImportUser', 'UpdateUser', 'DeleteUser', 'ListUser', 'SearchUser'], 'type' => 'directory', - 'children' => [ - 'CreateUser', - 'ImportUser', - 'UpdateUser', - 'GetUser', - 'ListUser', - 'SearchUser', - 'DeleteUser', - ], + 'title' => '用户管理', + 'id' => 97579, ], [ - 'id' => 163815, - 'title' => '空间管理', + 'children' => ['DeleteDrive', 'CreateDrive', 'UpdateDrive', 'GetDrive', 'ListDrive', 'GetDefaultDrive', 'ListMyDrives', 'SearchDrive'], 'type' => 'directory', - 'children' => [ - 'CreateDrive', - 'UpdateDrive', - 'GetDrive', - 'ListDrive', - 'GetDefaultDrive', - 'ListMyDrives', - 'SearchDrive', - 'DeleteDrive', - ], + 'title' => '空间管理', + 'id' => 97587, ], [ - 'id' => 163817, - 'title' => '文件管理', + 'children' => ['ListFile', 'CreateFile', 'DeleteFile', 'UpdateFile', 'SearchFile', 'GetFile', 'DownloadFile', 'GetUploadUrl', 'ListUploadedParts', 'CompleteFile', 'MoveFile', 'CopyFile', 'GetDownloadUrl', 'FilePutUserTags', 'FileDeleteUserTags', 'VideoDRMLicense'], 'type' => 'directory', - 'children' => [ - 'CreateFile', - 'DeleteFile', - 'UpdateFile', - 'SearchFile', - 'ListFile', - 'GetFile', - 'DownloadFile', - 'GetUploadUrl', - 'ListUploadedParts', - 'CompleteFile', - 'MoveFile', - 'CopyFile', - 'GetDownloadUrl', - 'FilePutUserTags', - 'FileDeleteUserTags', - 'VideoDRMLicense', - ], + 'title' => '文件管理', + 'id' => 97596, ], [ - 'id' => 168925, - 'title' => '文件多版本管理', + 'children' => ['DeleteRevision', 'UpdateRevision', 'RestoreRevision', 'ListRevision', 'GetRevision'], 'type' => 'directory', - 'children' => [ - 'DeleteRevision', - 'UpdateRevision', - 'RestoreRevision', - 'ListRevision', - 'GetRevision', - ], + 'title' => '文件多版本管理', + 'id' => 97657, ], [ - 'id' => 165276, - 'title' => '增量处理', + 'children' => ['ScanFile', 'ListDelta', 'DeltaGetLastCursor'], 'type' => 'directory', - 'children' => [ - 'ScanFile', - 'ListDelta', - 'DeltaGetLastCursor', - ], + 'title' => '增量处理', + 'id' => 97650, ], [ - 'id' => 164951, - 'title' => '权限管理', + 'children' => ['ListReceivedFile', 'ListMyGroupDrive', 'FileRemovePermission', 'FileAddPermission', 'FileListPermission', 'ListAssignment', 'AssignRole', 'CancelAssignRole'], 'type' => 'directory', - 'children' => [ - 'ListReceivedFile', - 'ListMyGroupDrive', - 'FileRemovePermission', - 'FileAddPermission', - 'FileListPermission', - 'ListAssignment', - 'AssignRole', - 'CancelAssignRole', - ], + 'title' => '权限管理', + 'id' => 97613, ], [ - 'id' => 164958, - 'title' => '分享管理', + 'children' => ['CreateShareLink', 'UpdateShareLink', 'SearchShareLink', 'CancelShareLink', 'ListShareLink', 'GetShareLink', 'GetShareLinkByAnonymous', 'GetShareLinkToken'], 'type' => 'directory', - 'children' => [ - 'CreateShareLink', - 'UpdateShareLink', - 'SearchShareLink', - 'CancelShareLink', - 'ListShareLink', - 'GetShareLink', - 'GetShareLinkByAnonymous', - 'GetShareLinkToken', - ], + 'title' => '分享管理', + 'id' => 97622, ], [ - 'id' => 164964, - 'title' => '回收站管理', + 'children' => ['TrashFile', 'ClearRecyclebin', 'ListRecyclebin', 'RestoreFile'], 'type' => 'directory', - 'children' => [ - 'TrashFile', - 'ClearRecyclebin', - 'ListRecyclebin', - 'RestoreFile', - ], + 'title' => '回收站管理', + 'id' => 97631, ], [ - 'id' => 163810, - 'title' => '图像AI管理', + 'children' => ['UpdateFacegroup', 'ListTags', 'ListAddressGroups', 'ListFacegroups', 'SearchAddressGroups', 'RemoveFaceGroupFile', 'CreateStory', 'CreateCustomizedStory', 'SearchStories', 'GetStory', 'UpdateStory', 'DeleteStory', 'AddStoryFiles', 'RemoveStoryFiles', 'CreateSimilarImageClusterTask', 'GetTaskStatus', 'SearchSimilarImageClusters'], 'type' => 'directory', - 'children' => [ - 'UpdateFacegroup', - 'ListTags', - 'ListAddressGroups', - 'ListFacegroups', - 'SearchAddressGroups', - 'RemoveFaceGroupFile', - 'CreateStory', - 'CreateCustomizedStory', - 'SearchStories', - 'GetStory', - 'UpdateStory', - 'DeleteStory', - 'AddStoryFiles', - 'RemoveStoryFiles', - 'CreateSimilarImageClusterTask', - 'GetTaskStatus', - 'SearchSimilarImageClusters', - ], + 'title' => '图像AI管理', + 'id' => 97561, ], [ - 'id' => 165162, - 'title' => '任务管理', + 'children' => ['GetVideoPreviewPlayMeta', 'GetVideoPreviewPlayInfo'], 'type' => 'directory', - 'children' => [ - 'GetAsyncTask', - ], - ], - [ - 'id' => 166916, 'title' => '在线视频预览', - 'type' => 'directory', - 'children' => [ - 'GetVideoPreviewPlayMeta', - 'GetVideoPreviewPlayInfo', - ], - ], - [ - 'id' => 182149, - 'title' => '权益管理', - 'type' => 'directory', - 'children' => [ - 'CreateIdentityToBenefitPkgMapping', - 'UpdateIdentityToBenefitPkgMapping', - 'GetIdentityToBenefitPkgMapping', - 'ListIdentityToBenefitPkgMapping', - ], + 'id' => 97654, ], [ - 'id' => 182158, - 'title' => '内容安全管理', + 'children' => ['CreateIdentityToBenefitPkgMapping', 'UpdateIdentityToBenefitPkgMapping', 'GetIdentityToBenefitPkgMapping', 'ListIdentityToBenefitPkgMapping'], 'type' => 'directory', - 'children' => [ - 'InvestigateFile', - 'CsiGetFileInfo', - ], + 'title' => '权益管理', + 'id' => 97675, ], [ - 'id' => 172104, - 'title' => '其他', + 'children' => ['PunishFile', 'InvestigateFile', 'CsiGetFileInfo'], 'type' => 'directory', - 'children' => [ - 'Batch', - 'AuditLogExport', - 'GetDomainQuota', - 'GroupUpdateName', - ], + 'title' => '内容安全管理', + 'id' => 97680, ], [ - 'id' => 0, - 'title' => '其它', + 'children' => ['Batch', 'AuditLogExport', 'GetDomainQuota', 'ArchiveFiles', 'GetAsyncTask'], 'type' => 'directory', - 'children' => [ - 'PunishFile', - ], + 'title' => '其他', + 'id' => 97663, ], ], 'components' => [ 'schemas' => [ - 'AccountAccessTokenResponse' => [ - 'title' => '账号 access token 的相应', - 'description' => '账号 access token 的相应结构', - 'type' => 'object', - 'properties' => [ - 'access_token' => [ - 'title' => '访问凭证', - 'type' => 'string', - ], - 'refresh_token' => [ - 'title' => '刷新凭证', - 'type' => 'string', - ], - 'expires_in' => [ - 'title' => '凭证有效期', - 'type' => 'integer', - 'format' => 'int64', - ], - 'token_type' => [ - 'title' => '凭证类型', - 'type' => 'string', - ], - 'user_id' => [ - 'title' => '用户ID', - 'type' => 'string', - ], - 'user_name' => [ - 'title' => '用户名', - 'type' => 'string', - ], - 'avatar' => [ - 'title' => '用户头像', - 'type' => 'string', - ], - 'nick_name' => [ - 'title' => '用户昵称', - 'type' => 'string', - ], - 'default_drive_id' => [ - 'title' => '用户默认空间ID', - 'type' => 'string', - ], - 'role' => [ - 'title' => '用户角色', - 'type' => 'string', - ], - 'status' => [ - 'title' => '用户状态', - 'type' => 'string', - ], - 'expire_time' => [ - 'title' => '凭证过期时间', - 'type' => 'string', - ], - 'is_first_login' => [ - 'title' => '是否首次登录', - 'type' => 'boolean', - ], - 'device_id' => [ - 'title' => '登录设备ID', - 'type' => 'string', - ], - 'device_name' => [ - 'title' => '登录设备名称', - 'type' => 'string', - ], - 'domain_id' => [ - 'title' => '域ID', - 'type' => 'string', - ], - 'default_sbox_drive_id' => [ - 'title' => '默认保险箱空间 ID', - 'type' => 'string', - ], - 'state' => [ - 'title' => '临时权限，用于登录成功后设置密码', - 'type' => 'string', - ], - 'exist_link' => [ - 'title' => '当前用户已存在的登录方式', - 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/LinkInfo', - ], - ], - 'need_link' => [ - 'title' => '是否需要引用', - 'type' => 'boolean', - ], - 'user_data' => [ - 'title' => '用户自定义数据，格式为json，可用于配置项、少量临时数据等存储，不超过1K', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - ], - ], - 'pin_setup' => [ - 'title' => '用户的数据密码是否设置过', - 'type' => 'boolean', - ], - 'need_rp_verify' => [ - 'title' => '用户是否需要进行的实人认证', - 'type' => 'boolean', - ], - 'path_status' => [ - 'title' => '用户 path 开启状', - 'type' => 'string', - ], - ], - ], 'AccountLinkInfo' => [ 'title' => 'A short description of struct', 'description' => '用户绑定的账号信息', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'title' => '域ID', - 'description' => '域ID', - 'type' => 'string', - 'example' => 'bj1', - ], - 'authentication_type' => [ - 'title' => '账号类型', - 'description' => '账号类型'."\n" - ."\n" - .'- mobile：手机号'."\n" - ."\n" - .'- email：邮箱'."\n" - ."\n" - .'- ding：钉钉'."\n" - ."\n" - .'- ram：阿里云RAM子账号'."\n" - ."\n" - .'- wechat：企业微信'."\n" - ."\n" - .'- ldap：LDAP账号'."\n" - ."\n" - .'- custom：自定义账号', - 'type' => 'string', - 'example' => 'mobile', - ], - 'identity' => [ - 'title' => '账号唯一标识', - 'description' => '账号唯一标识', - 'type' => 'string', - 'example' => '136***000', - ], - 'extra' => [ - 'title' => '账号附加信息', - 'description' => '账号附加信息，当账号类型为手机号时，此字段表示国家编码，比如中国大陆为86，当前只有手机号才返回此字段', - 'type' => 'string', - 'example' => '86', - ], - 'user_id' => [ - 'title' => '账号对应的用户ID', - 'description' => '账号对应的用户ID', - 'type' => 'string', - 'example' => '00016a587b62b50003deea299a4f5b50', - ], - 'created_at' => [ - 'title' => '账号创建时间', - 'description' => '账号创建时间，从1970年1月1日0点到现在的毫秒时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1639762579768', - ], - 'display_name' => [ - 'title' => '账号显示名', - 'description' => '账号显示名，用于界面上展示的名称，比如LDAP账号唯一标识为uid，但是展示给用户看的可以选择工号或其他信息', - 'type' => 'string', - 'example' => '001', - ], - 'status' => [ - 'title' => '账号状态', - 'description' => '账号状态', - 'type' => 'string', - 'example' => 'normal', - ], - 'last_login_time' => [ - 'title' => '账号最后一次登录的时间', - 'description' => '账号最后一次登录的时间，从1970年1月1日0点到现在的毫秒时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1639762579769', - ], - ], - ], - 'Activity' => [ - 'title' => 'A short description of struct', - 'description' => '最近活动', - 'type' => 'object', - 'properties' => [ - 'drive_id' => [ - 'title' => '空间 id', - 'type' => 'string', - ], - 'activity_id' => [ - 'title' => '活动 id', - 'type' => 'string', - ], - 'user_id' => [ - 'title' => '用户 id', - 'type' => 'string', - ], - 'device' => [ - 'title' => '设备名', - 'type' => 'string', - ], - 'event_type' => [ - 'title' => '事件类型', - 'type' => 'integer', - 'format' => 'int32', - ], - 'latest_event_time' => [ - 'title' => '最近事件时间', - 'type' => 'string', - ], - 'resource_category' => [ - 'title' => '资源类型', - 'type' => 'integer', - 'format' => 'int32', - ], - 'resource_list' => [ - 'title' => '资源列表', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - ], - ], - 'total_resource_count' => [ - 'title' => '资源总数', - 'type' => 'integer', - 'format' => 'int64', - ], - ], - ], - 'AddStoryFile' => [ - 'title' => '向故事中添加文件的相关返回信息', - 'description' => '返回添加到故事中的文件及其成功与否', - 'type' => 'object', - 'properties' => [ - 'file_id' => [ - 'title' => '文件id', - 'description' => '文件id', - 'type' => 'string', - 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf', - ], - 'revision_id' => [ - 'title' => '文件版本号', - 'description' => '文件版本号', - 'type' => 'string', - 'example' => '642a88dd06e49d9c0a14411ebae606f70edd9a59', - ], - 'error_code' => [ - 'title' => '添加单文件时的错误码', - 'description' => '添加单文件时的错误码', - 'type' => 'string', - ], - 'error_message' => [ - 'title' => '添加单文件时的错误信息', - 'description' => '添加单文件时的错误信息', - 'type' => 'string', - ], + 'domain_id' => ['title' => '域ID', 'description' => '域ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'bj1', 'backendName' => 'domain_id'], + 'authentication_type' => ['title' => '账号类型', 'description' => '账号类型'."\n" + ."\n" + .'- mobile：手机号'."\n" + ."\n" + .'- email：邮箱'."\n" + ."\n" + .'- ding：钉钉'."\n" + ."\n" + .'- ram：阿里云RAM子账号'."\n" + ."\n" + .'- wechat：企业微信'."\n" + ."\n" + .'- ldap：LDAP账号'."\n" + ."\n" + .'- custom：自定义账号', 'visibility' => 'Public', 'type' => 'string', 'example' => 'mobile', 'backendName' => 'authentication_type'], + 'identity' => ['title' => '账号唯一标识', 'description' => '账号唯一标识', 'visibility' => 'Public', 'type' => 'string', 'example' => '136***000', 'backendName' => 'identity'], + 'extra' => ['title' => '账号附加信息', 'description' => '账号附加信息，当账号类型为手机号时，此字段表示国家编码，比如中国大陆为86，当前只有手机号才返回此字段', 'visibility' => 'Public', 'type' => 'string', 'example' => '86', 'backendName' => 'extra'], + 'user_id' => ['title' => '账号对应的用户ID', 'description' => '账号对应的用户ID', 'visibility' => 'Public', 'type' => 'string', 'example' => '00016a587b62b50003deea299a4f5b50', 'backendName' => 'user_id'], + 'created_at' => ['title' => '账号创建时间', 'description' => '账号创建时间，从1970年1月1日0点到现在的毫秒时间戳', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1639762579768', 'backendName' => 'created_at'], + 'display_name' => ['title' => '账号显示名', 'description' => '账号显示名，用于界面上展示的名称，比如LDAP账号唯一标识为uid，但是展示给用户看的可以选择工号或其他信息', 'visibility' => 'Public', 'type' => 'string', 'example' => '001', 'backendName' => 'display_name'], + 'status' => ['title' => '账号状态', 'description' => '账号状态', 'visibility' => 'Public', 'type' => 'string', 'example' => 'normal'], + 'last_login_time' => ['title' => '账号最后一次登录的时间', 'description' => '账号最后一次登录的时间，从1970年1月1日0点到现在的毫秒时间戳', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1639762579769'], ], ], 'Address' => [ 'title' => '地点', 'description' => '地点', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'country' => [ - 'title' => '国家或地区', - 'description' => '国家或地区', - 'type' => 'string', - 'example' => '中国', - ], - 'province' => [ - 'title' => '省', - 'description' => '省', - 'type' => 'string', - 'example' => '浙江省', - ], - 'city' => [ - 'title' => '城市', - 'description' => '城市', - 'type' => 'string', - 'example' => '杭州市', - ], - 'district' => [ - 'title' => '区', - 'description' => '区', - 'type' => 'string', - 'example' => '余杭区', - ], - 'township' => [ - 'title' => '街道', - 'description' => '街道', - 'type' => 'string', - 'example' => '文一西路', - ], + 'country' => ['title' => '国家或地区', 'description' => '国家或地区', 'visibility' => 'Public', 'type' => 'string', 'example' => '中国'], + 'province' => ['title' => '省', 'description' => '省', 'visibility' => 'Public', 'type' => 'string', 'example' => '浙江省'], + 'city' => ['title' => '城市', 'description' => '城市', 'visibility' => 'Public', 'type' => 'string', 'example' => '杭州市'], + 'district' => ['title' => '区', 'description' => '区', 'visibility' => 'Public', 'type' => 'string', 'example' => '余杭区'], + 'township' => ['title' => '街道', 'description' => '街道', 'visibility' => 'Public', 'type' => 'string', 'example' => '文一西路'], ], + 'nullable' => true, ], 'AddressGroup' => [ 'title' => '地点分组', 'description' => '地点分组', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'name' => [ - 'title' => '地点名称', - 'description' => '地点名称', - 'type' => 'string', - ], - 'location' => [ - 'title' => '经纬度', - 'description' => '经纬度', - 'type' => 'string', - 'example' => '30.12231,120.1212', - ], - 'count' => [ - 'title' => '地点数量', - 'description' => '地点分组内文件数量', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', - ], - 'cover_url' => [ - 'title' => '地点封面图片地址', - 'description' => '地点封面图片地址', - 'type' => 'string', - ], - 'cover_file_id' => [ - 'title' => '地点封面图片文件ID', - 'description' => '地点封面图片文件ID', - 'type' => 'string', - ], - 'address_detail' => [ - 'title' => '地点详细信息', - 'description' => '地点详细信息', - '$ref' => '#/components/schemas/Address', - ], + 'name' => ['title' => '地点名称', 'description' => '地点名称', 'visibility' => 'Public', 'type' => 'string'], + 'location' => ['title' => '经纬度', 'description' => '经纬度', 'visibility' => 'Public', 'type' => 'string', 'example' => '30.12231,120.1212'], + 'count' => ['title' => '地点数量', 'description' => '地点分组内文件数量', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '10'], + 'cover_url' => ['title' => '地点封面图片地址', 'description' => '地点封面图片地址', 'visibility' => 'Public', 'type' => 'string'], + 'cover_file_id' => ['title' => '地点封面图片文件ID', 'description' => '地点封面图片文件ID', 'visibility' => 'Public', 'type' => 'string'], + 'address_detail' => ['title' => '地点详细信息', 'description' => '地点详细信息', 'visibility' => 'Public', '$ref' => '#/components/schemas/Address'], ], ], - 'Aggregation' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'field' => [ - 'title' => '字段', - 'type' => 'string', - 'format' => 'byte', - ], - 'operation' => [ - 'title' => '操作', - 'type' => 'string', - 'format' => 'byte', - ], - 'value' => [ - 'title' => '值', - 'type' => 'number', - 'format' => 'double', - ], - 'groups' => [ - 'title' => '组', - 'type' => 'array', - 'items' => [ - 'required' => false, - '$ref' => '#/components/schemas/AggregationsGroup', - ], - ], - ], - ], - 'AggregationsGroup' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'count' => [ - 'title' => '计数', - 'type' => 'integer', - 'format' => 'int64', - ], - 'value' => [ - 'title' => '值', - 'type' => 'string', - 'format' => 'byte', - ], - ], - ], - 'Album' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'album_id' => [ - 'title' => 'album_id', - 'type' => 'string', - ], - 'owner' => [ - 'title' => 'owner', - 'type' => 'string', - ], - 'name' => [ - 'title' => 'name', - 'type' => 'string', - ], - 'description' => [ - 'title' => 'description', - 'type' => 'string', - ], - 'created_at' => [ - 'title' => 'created_at', - 'type' => 'string', - ], - 'updated_at' => [ - 'title' => 'updated_at', - 'type' => 'string', - ], - 'user_tags' => [ - 'title' => 'user_tags', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - ], - ], - 'file_count' => [ - 'title' => 'file_count', - 'type' => 'integer', - 'format' => 'int64', - ], - 'cover_file' => [ - 'title' => 'cover_file', - '$ref' => '#/components/schemas/File', - ], - 'base_face_file' => [ - 'title' => 'base_face_file', - '$ref' => '#/components/schemas/File', - ], - 'base_face_group_id' => [ - 'title' => 'base_face_group_id', - 'type' => 'string', - ], - ], - ], - 'AlbumFile' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'album_id' => [ - 'title' => '相册 ID', - 'type' => 'string', - ], - 'joined_at' => [ - 'title' => '加入相册的时间戳', - 'type' => 'integer', - 'format' => 'int64', - ], - 'domain_id' => [ - 'title' => '域 ID', - 'type' => 'string', - ], - 'drive_id' => [ - 'title' => '空间 ID', - 'type' => 'string', - ], - 'file_id' => [ - 'title' => '文件 ID', - 'type' => 'string', - ], - 'name' => [ - 'title' => '文件名', - 'type' => 'string', - ], - 'type' => [ - 'title' => '文件类型', - 'type' => 'string', - ], - 'content_type' => [ - 'title' => '内容类型', - 'type' => 'string', - ], - 'created_at' => [ - 'title' => '创建时间', - 'type' => 'string', - ], - 'updated_at' => [ - 'title' => '更新时间', - 'type' => 'string', - ], - 'description' => [ - 'title' => '描述', - 'type' => 'string', - ], - 'transhed_at' => [ - 'title' => '放入回收站时间', - 'type' => 'string', - ], - 'file_extension' => [ - 'title' => '文件后缀', - 'type' => 'string', - ], - 'mime_type' => [ - 'title' => 'MIME 类型', - 'type' => 'string', - ], - 'hidden' => [ - 'title' => '是否隐藏', - 'type' => 'boolean', - ], - 'size' => [ - 'title' => '大小', - 'type' => 'integer', - 'format' => 'int64', - ], - 'starred' => [ - 'title' => '是否收藏', - 'type' => 'boolean', - ], - 'status' => [ - 'title' => '状态', - 'type' => 'string', - ], - 'user_meta' => [ - 'title' => '自定义元数据', - 'type' => 'string', - ], - 'labels' => [ - 'title' => '标签', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], - ], - 'upload_id' => [ - 'title' => '上传 ID', - 'type' => 'string', - ], - 'parent_file_id' => [ - 'title' => '父文件 ID', - 'type' => 'string', - ], - 'crc64_hash' => [ - 'title' => 'crc64', - 'type' => 'string', - ], - 'content_hash' => [ - 'title' => '内容哈希', - 'type' => 'string', - ], - 'content_hash_name' => [ - 'title' => '内容哈希算法', - 'type' => 'string', - ], - 'download_url' => [ - 'title' => '下载地址', - 'type' => 'string', - ], - 'thumbnail' => [ - 'title' => '缩略图地址', - 'type' => 'string', - ], - 'category' => [ - 'title' => '文件分类', - 'type' => 'string', - ], - 'local_created_at' => [ - 'title' => '本地创建时间', - 'type' => 'string', - ], - 'local_modified_at' => [ - 'title' => '本地修改时间', - 'type' => 'string', - ], - 'revision_id' => [ - 'title' => '版本 ID', - 'type' => 'string', - ], - 'investigation_info' => [ - 'title' => '审核信息', - '$ref' => '#/components/schemas/InvestigationInfo', - ], - 'thumbnail_urls' => [ - 'title' => '多尺度缩略图地址', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - ], - ], - 'image_media_metadata' => [ - 'title' => '图片信息。仅开启增值服务图片处理功能有效。', - '$ref' => '#/components/schemas/ImageMediaMetadata', - ], - 'ex_fields_info' => [ - 'title' => '自定义扩展信息', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'any', - ], - ], - 'object_uri' => [ - 'title' => '内容对象的uri', - 'type' => 'string', - ], - ], - ], - 'App' => [ - 'title' => 'app', + 'AddStoryFile' => [ + 'title' => '向故事中添加文件的相关返回信息', + 'description' => '返回添加到故事中的文件及其成功与否', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'app_id' => [ - 'title' => 'app_id', - 'type' => 'string', - ], - 'app_name' => [ - 'title' => 'app_name', - 'type' => 'string', - ], - 'description' => [ - 'title' => 'description', - 'type' => 'string', - ], - 'redirect_uri' => [ - 'title' => 'redirect_uri', - 'type' => 'string', - ], - 'scope' => [ - 'title' => 'scope', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], - ], - 'app_secret' => [ - 'title' => 'app_secret', - 'type' => 'string', - ], - 'created_at' => [ - 'title' => 'created_at', - 'type' => 'string', - ], - 'updated_at' => [ - 'title' => 'updated_at', - 'type' => 'string', - ], - 'logo' => [ - 'title' => 'logo', - 'type' => 'string', - ], - 'type' => [ - 'title' => 'type', - 'type' => 'string', - ], - 'provider' => [ - 'title' => 'provider', - 'type' => 'string', - ], - 'stage' => [ - 'title' => 'stage', - 'type' => 'string', - ], + 'file_id' => ['title' => '文件id', 'description' => '文件id', 'visibility' => 'Public', 'type' => 'string', 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf'], + 'revision_id' => ['title' => '文件版本号', 'description' => '文件版本号', 'visibility' => 'Public', 'type' => 'string', 'example' => '642a88dd06e49d9c0a14411ebae606f70edd9a59'], + 'error_code' => ['title' => '添加单文件时的错误码', 'description' => '添加单文件时的错误码', 'visibility' => 'Public', 'type' => 'string'], + 'error_message' => ['title' => '添加单文件时的错误信息', 'description' => '添加单文件时的错误信息', 'visibility' => 'Public', 'type' => 'string'], ], ], 'AppAccessStrategy' => [ 'title' => 'App访问策略', 'description' => 'App访问策略', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'effect' => [ @@ -925,11 +193,9 @@ .'建议配置：'."\n" .'1. 全局访问策略 effect 设置为 deny'."\n" .'2. 允许部分 app ID 来访问，设置 except_app_id_list 为 ["appid1", "appid2"]', + 'visibility' => 'Public', 'type' => 'string', - 'enumValueTitles' => [ - 'allow' => '允许', - 'deny' => '拒绝', - ], + 'enumValueTitles' => ['allow' => '允许', 'deny' => '拒绝'], 'example' => 'deny', ], 'except_app_id_list' => [ @@ -938,1338 +204,70 @@ ."\n" .' * 当全局策略 effect 为 allow 时，表示全局允许所有的 app 来访问 domain，但是处于 except_app_id_list 列表的 app 则禁止访问 domain。'."\n" .' * 当全局策略 effect 为 deny 时，表示全局禁止所有的 app 来访问 domain，但是处于 except_app_id_list 列表的 app 则允许访问 domain。', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - 'description' => 'appID', - 'type' => 'string', - 'example' => '8ovxCTRUDdbpVWBP', - ], - ], - ], - ], - 'ArchiveFilesConfigResponse' => [ - 'title' => 'ArchiveFilesConfigResponse', - 'type' => 'object', - 'properties' => [ - 'enabled' => [ - 'title' => 'enabled', - 'type' => 'boolean', - ], - 'version' => [ - 'title' => 'version', - 'type' => 'string', - ], - ], - ], - 'AuditLog' => [ - 'title' => '审计日志', - 'description' => '审计日志', - 'type' => 'object', - 'properties' => [ - 'log_id' => [ - 'title' => '日志id', - 'type' => 'string', - ], - 'acted_at' => [ - 'title' => '操作时间', - 'type' => 'string', - ], - 'actor_id' => [ - 'title' => '操作者id', - 'type' => 'string', - ], - 'actor_type' => [ - 'title' => '操作者类型', - 'type' => 'string', - ], - 'actor_name' => [ - 'title' => '操作者名称', - 'type' => 'string', - ], - 'action_category' => [ - 'title' => '操作分类', - 'type' => 'string', - ], - 'action_type' => [ - 'title' => '操作类型', - 'type' => 'string', - ], - 'object_id' => [ - 'title' => '对象id', - 'type' => 'string', - ], - 'object_name' => [ - 'title' => '对象名', - 'type' => 'string', - ], - 'file_path_type' => [ - 'title' => '文件空间类型', - 'type' => 'string', - ], - 'detail' => [ - 'title' => '日志详情', - '$ref' => '#/components/schemas/AuditLogDetail', - ], - 'client_ip' => [ - 'title' => '客户端IP', - 'type' => 'string', - ], - 'client_type' => [ - 'title' => '客户端类型', - 'type' => 'string', - ], - 'client_version' => [ - 'title' => '客户端版本', - 'type' => 'string', - ], - 'client_device' => [ - 'title' => '客户端设备', - 'type' => 'string', - ], - ], - ], - 'AuditLogDetail' => [ - 'title' => '审计日志详情', - 'description' => '审计日志详情', - 'type' => 'object', - 'properties' => [ - 'file_log_detail' => [ - '$ref' => '#/components/schemas/FileLogDetail', - ], - 'user_log_detail' => [ - '$ref' => '#/components/schemas/UserLogDetail', - ], - 'drive_log_detail' => [ - '$ref' => '#/components/schemas/DriveLogDetail', - ], - ], - ], - 'BaseAlbumFileOperationResult' => [ - 'title' => 'A short description of struct', - 'description' => '相册文件操作结果', - 'type' => 'object', - 'properties' => [ - 'file' => [ - 'title' => '文件源信息', - '$ref' => '#/components/schemas/CommonFileItem', - ], - 'is_succeed' => [ - 'title' => '操作是否成功', - 'type' => 'boolean', - ], - 'error_code' => [ - 'title' => '操作失败的错误码', - 'type' => 'string', - ], - 'error_message' => [ - 'title' => '操作失败的错误原因', - 'type' => 'string', - ], - ], - ], - 'BaseAssignmentResponse' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'domain_id' => [ - 'title' => 'domain_id', - 'type' => 'string', - ], - 'identity' => [ - '$ref' => '#/components/schemas/Identity', - ], - 'role_id' => [ - 'title' => 'role_id', - 'type' => 'string', - ], - 'manage_resource_type' => [ - 'title' => 'manage_resource_type', - 'type' => 'string', - ], - 'manage_resource_id' => [ - 'title' => 'manage_resource_id', - 'type' => 'string', - ], - 'associated_role_tag_id' => [ - 'title' => 'associated_role_tag_id', - 'type' => 'string', - ], - 'creator' => [ - 'title' => 'creator', - 'type' => 'string', - ], - 'created_at' => [ - 'title' => 'created_at', - 'type' => 'string', - ], - 'updated_at' => [ - 'title' => 'updated_at', - 'type' => 'string', - ], - 'disinherit_sub_group' => [ - 'title' => 'disinherit_sub_group', - 'type' => 'boolean', - ], - ], - ], - 'BaseDomainResponse' => [ - 'title' => 'base domain 信息', - 'description' => 'Domain 基础信息', - 'type' => 'object', - 'properties' => [ - 'parent_domain_id' => [ - 'title' => 'parent_domain_id string 父 domain id，如果存在，表示该 domain为子 domain domain_id string domain id', - 'type' => 'string', - ], - 'domain_id' => [ - 'title' => 'domain id', - 'type' => 'string', - ], - 'domain_name' => [ - 'title' => '域名称', - 'type' => 'string', - ], - 'description' => [ - 'title' => '描述', - 'type' => 'string', - ], - 'init_drive_enable' => [ - 'title' => '否开通默认网盘。为true则所有用户在第一次登录后都默认分配一个网盘。默认false', - 'type' => 'boolean', - ], - 'init_drive_size' => [ - 'title' => 'init_drive_enable==true时必选。 默认网盘的大小, 单位：Bytes。为0则表示不限大小。默认为0', - 'type' => 'integer', - 'format' => 'int64', - ], - 'updated_at' => [ - 'title' => '最后修改时间，ISO格式，如: 2019-04-08T07:05:18.825Z', - 'type' => 'string', - ], - 'created_at' => [ - 'title' => '创建时间，ISO格式， 如：2019-03-28T13:03:29.298Z', - 'type' => 'string', - ], - 'size_quota' => [ - 'title' => '容量配额', - 'type' => 'integer', - 'format' => 'int64', - ], - 'size_quota_used' => [ - 'title' => '容量配额使用空间', - 'type' => 'integer', - 'format' => 'int64', - ], - 'status' => [ - 'title' => 'domain状态：创建中，正常，已过期', - 'type' => 'integer', - 'format' => 'int64', - ], - 'used_size' => [ - 'title' => '逻辑空间使用量，单位为字节', - 'type' => 'integer', - 'format' => 'int64', - ], - 'published_app_access_strategy' => [ - 'title' => 'App 访问策略', - '$ref' => '#/components/schemas/AppAccessStrategy', - ], - 'share_link_enabled' => [ - 'title' => '是否允许创建分享链接，默认为 false', - 'type' => 'boolean', - ], - ], - ], - 'BaseDriveResponse' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'domain_id' => [ - 'title' => 'Domain ID', - 'type' => 'string', - 'example' => 'hz999', - ], - 'drive_id' => [ - 'title' => 'Drive ID', - 'type' => 'string', - 'example' => '123', - ], - 'drive_name' => [ - 'title' => 'Drive 名称', - 'type' => 'string', - 'example' => 'ccpdrive', - ], - 'description' => [ - 'title' => 'Drive 备注信息', - 'type' => 'string', - 'example' => 'ccp team drive', - ], - 'creator' => [ - 'title' => 'Drive 创建者', - 'type' => 'string', - 'example' => 'ccp', - ], - 'owner' => [ - 'title' => 'Drive 所有者', - 'type' => 'string', - 'example' => 'ccp', - ], - 'owner_type' => [ - 'title' => 'Drive 所有者类型', - 'type' => 'string', - 'example' => 'user', - ], - 'drive_type' => [ - 'title' => 'Drive 类型', - 'type' => 'string', - 'example' => 'normal', - ], - 'status' => [ - 'title' => 'Drive 状态', - 'type' => 'string', - 'example' => 'enabled', - ], - 'used_size' => [ - 'title' => 'Drive 空间已使用量', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1024', - ], - 'total_size' => [ - 'title' => 'Drive 空间总量', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '102400', - ], - 'store_id' => [ - 'title' => '存储 ID, domain的PathType为OSSPath时返回', - 'type' => 'string', - 'example' => '123', - ], - 'relative_path' => [ - 'title' => 'relative_path', - 'type' => 'string', - ], - 'encrypt_mode' => [ - 'title' => 'encrypt_mode', - 'type' => 'string', - ], - 'encrypt_data_access' => [ - 'title' => 'encrypt_data_access', - 'type' => 'boolean', - ], - 'action_list' => [ - 'title' => 'action_list', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], - ], - 'created_at' => [ - 'title' => 'created_at', - 'type' => 'string', - ], - 'updated_at' => [ - 'title' => 'updated_at', - 'type' => 'string', - ], - 'permission' => [ - 'title' => 'permission', - 'type' => 'object', - 'additionalProperties' => [ - '$ref' => '#/components/schemas/IDPermission', - ], - ], - 'is_handover' => [ - 'title' => '是否为交接的drive', - 'type' => 'boolean', - ], - 'category' => [ - 'title' => 'category', - 'type' => 'string', - ], - 'path_status' => [ - 'title' => 'path_status', - 'type' => 'string', - ], - 'delta_enabled' => [ - 'title' => '是否开启了delta', - 'type' => 'boolean', - ], - ], - ], - 'BaseFileListInheritPermissionResponse' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'member' => [ - 'title' => 'member', - '$ref' => '#/components/schemas/FilePermissionMember', - ], - 'file_id' => [ - 'title' => 'file_id', - 'type' => 'string', - ], - ], - ], - 'BaseFileUserPermissionResponse' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'domain_id' => [ - 'title' => 'domain_id', - 'type' => 'string', - 'example' => 'bj23', - ], - 'identity' => [ - 'title' => 'identity', - '$ref' => '#/components/schemas/Identity', - ], - 'role_id' => [ - 'title' => 'role_id', - 'type' => 'string', - ], - 'drive_id' => [ - 'title' => 'drive_id', - 'type' => 'string', - ], - 'file_id' => [ - 'title' => 'file_id', - 'type' => 'string', - ], - 'file_full_path' => [ - 'title' => 'file_full_path', - 'type' => 'string', - ], - 'creator' => [ - 'title' => 'creator', - 'type' => 'string', - ], - 'created_at' => [ - 'title' => 'created_at', - 'type' => 'integer', - 'format' => 'int64', - ], - 'expire_time' => [ - 'title' => 'expire_time', - 'type' => 'integer', - 'format' => 'int64', - ], - 'disinherit_sub_group' => [ - 'title' => 'disinherit_sub_group', - 'type' => 'boolean', - ], - 'can_access' => [ - 'title' => 'can_access', - 'type' => 'boolean', - ], - ], - ], - 'BaseGroupResponse' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'domain_id' => [ - 'title' => 'domain id', - 'type' => 'string', - 'example' => 'bj123', - ], - 'group_id' => [ - 'title' => 'group id', - 'type' => 'string', - 'example' => 'b38b5681bd964950ad8bc0f8ea504793', - ], - 'group_name' => [ - 'title' => 'group name', - 'type' => 'string', - 'example' => 'name-111', - ], - 'description' => [ - 'title' => 'description', - 'type' => 'string', - 'example' => 'desc-111', - ], - 'created_at' => [ - 'title' => 'created_at', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '111111', - ], - 'updated_at' => [ - 'title' => 'updated_at', - 'type' => 'string', - 'example' => '111111', - ], - 'creator' => [ - 'title' => 'creator', - 'type' => 'string', - 'example' => 'system', - ], - 'permission' => [ - 'title' => 'permission', - 'type' => 'object', - 'additionalProperties' => [ - '$ref' => '#/components/schemas/IDPermission', - ], - ], - 'is_sync' => [ - 'title' => 'is_sync', - 'type' => 'boolean', - ], - ], - ], - 'BaseRoleMemberResponse' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'domain_id' => [ - 'title' => 'domain_id', - 'type' => 'string', - ], - 'identity' => [ - '$ref' => '#/components/schemas/Identity', - ], - 'identity_name' => [ - 'title' => 'identity_name', - 'type' => 'string', - ], - 'creator' => [ - 'title' => 'creator', - 'type' => 'string', - ], - 'created_at' => [ - 'title' => 'created_at', - 'type' => 'string', - ], - 'is_admin' => [ - 'title' => 'is_admin', - 'type' => 'boolean', - ], - 'assignment_list' => [ - 'title' => 'assignment_list', - 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/BaseAssignmentResponse', - ], - ], - 'subdomain_id' => [ - 'title' => 'subdomain_id', - 'type' => 'string', + 'items' => ['description' => 'appID', 'visibility' => 'Public', 'type' => 'string', 'example' => '8ovxCTRUDdbpVWBP', 'extendType' => 'true'], ], ], + 'parseType' => 'struct', ], 'BaseUserResponse' => [ 'title' => 'A short description of struct', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'title' => 'Domain ID', - 'type' => 'string', - 'example' => 'hz999', - ], - 'user_id' => [ - 'title' => '用户 ID', - 'type' => 'string', - 'example' => 'ccpuserid', - ], - 'avatar' => [ - 'title' => '头像', - 'type' => 'string', - 'example' => 'http://a.b.c/ccp.jpg', - ], - 'created_at' => [ - 'title' => '用户创建时间', - 'type' => 'string', - 'example' => '1567407718386', - ], - 'updated_at' => [ - 'title' => '用户修改时间', - 'type' => 'string', - 'example' => '1567407718386', - ], - 'email' => [ - 'title' => '邮箱', - 'type' => 'string', - 'example' => '123@ccp.com', - ], - 'nick_name' => [ - 'title' => '昵称', - 'type' => 'string', - 'example' => 'abc', - ], - 'phone' => [ - 'title' => '电话', - 'type' => 'string', - 'example' => '13700000000', - ], - 'phone_region' => [ - 'title' => '国家编码', - 'type' => 'string', - ], - 'role' => [ - 'title' => '角色', - 'type' => 'string', - 'example' => 'user', - ], - 'status' => [ - 'title' => '用户状态', - 'type' => 'string', - 'example' => 'enabled', - ], - 'user_name' => [ - 'title' => '用户名称', - 'type' => 'string', - 'example' => 'name', - ], - 'description' => [ - 'title' => '用户备注信息', - 'type' => 'string', - 'example' => 'ccp team user', - ], - 'default_drive_id' => [ - 'title' => '默认 Drive ID', - 'type' => 'string', - 'example' => '123', - ], + 'domain_id' => ['title' => 'Domain ID', 'type' => 'string', 'example' => 'hz999'], + 'user_id' => ['title' => '用户 ID', 'type' => 'string', 'example' => 'ccpuserid'], + 'avatar' => ['title' => '头像', 'type' => 'string', 'example' => 'http://a.b.c/ccp.jpg'], + 'created_at' => ['title' => '用户创建时间', 'type' => 'string', 'example' => '1567407718386'], + 'updated_at' => ['title' => '用户修改时间', 'type' => 'string', 'example' => '1567407718386'], + 'email' => ['title' => '邮箱', 'type' => 'string', 'example' => '123@ccp.com'], + 'nick_name' => ['title' => '昵称', 'type' => 'string', 'example' => 'abc'], + 'phone' => ['title' => '电话', 'type' => 'string', 'example' => '13700000000'], + 'phone_region' => ['title' => '国家编码', 'type' => 'string'], + 'role' => ['title' => '角色', 'type' => 'string', 'example' => 'user'], + 'status' => ['title' => '用户状态', 'type' => 'string', 'example' => 'enabled'], + 'user_name' => ['title' => '用户名称', 'type' => 'string', 'example' => 'name'], + 'description' => ['title' => '用户备注信息', 'type' => 'string', 'example' => 'ccp team user'], + 'default_drive_id' => ['title' => '默认 Drive ID', 'type' => 'string', 'example' => '123'], + 'deny_change_password_by_self' => ['title' => '禁止用户自行修改密码', 'type' => 'boolean'], + 'need_change_password_next_login' => ['title' => '下次登录强制修改密码', 'type' => 'boolean'], + 'creator' => ['title' => 'creator', 'type' => 'string', 'example' => 'system'], + 'expired_at' => ['title' => '用户过期时间', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'is_sync' => ['title' => 'is_sync', 'type' => 'boolean'], + 'default_location' => ['title' => 'default_location', 'type' => 'string'], + 'last_login_time' => ['title' => 'last_login_time', 'type' => 'integer', 'format' => 'int64'], + 'path_status' => ['title' => 'path 开启状态', 'type' => 'string'], + 'last_refresh_token_time' => ['type' => 'integer', 'format' => 'int64'], 'user_data' => [ 'title' => '用户自定义数据，格式为json，可用于配置项、少量临时数据等存储，不超过1K', 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'any', - ], - ], - 'deny_change_password_by_self' => [ - 'title' => '禁止用户自行修改密码', - 'type' => 'boolean', - ], - 'need_change_password_next_login' => [ - 'title' => '下次登录强制修改密码', - 'type' => 'boolean', - ], - 'creator' => [ - 'title' => 'creator', - 'type' => 'string', - 'example' => 'system', - ], - 'expired_at' => [ - 'title' => '用户过期时间', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', + 'additionalProperties' => ['type' => 'any'], ], 'permission' => [ 'title' => 'permission', 'type' => 'object', - 'additionalProperties' => [ - '$ref' => '#/components/schemas/IDPermission', - ], - ], - 'is_sync' => [ - 'title' => 'is_sync', - 'type' => 'boolean', - ], - 'default_location' => [ - 'title' => 'default_location', - 'type' => 'string', - ], - 'last_login_time' => [ - 'title' => 'last_login_time', - 'type' => 'integer', - 'format' => 'int64', - ], - 'path_status' => [ - 'title' => 'path 开启状态', - 'type' => 'string', + 'additionalProperties' => ['$ref' => '#/components/schemas/IDPermission'], ], ], ], 'BenefitPkgDeliveryInfo' => [ + 'cloudType' => 'public', + 'branchId' => 2776869, + 'branchName' => 'master', + 'paramExtraInfo' => ['$.components.schemas.BenefitPkgDeliveryInfo.properties.amount.description' => '权益包下发的数量', '$.components.schemas.BenefitPkgDeliveryInfo.properties.created_at.description' => '权益包下发的创建时间', '$.components.schemas.BenefitPkgDeliveryInfo.description' => '权益包下发信息', '$.components.schemas.BenefitPkgDeliveryInfo.properties.is_permanent.description' => '是否永久有效', '$.components.schemas.BenefitPkgDeliveryInfo.properties.expire_time.example' => '2019-08-20T06:51:27.292Z', '$.components.schemas.BenefitPkgDeliveryInfo.properties.amount.example' => '1', '$.components.schemas.BenefitPkgDeliveryInfo.properties.is_permanent.example' => 'false', '$.components.schemas.BenefitPkgDeliveryInfo.properties.expire_time.description' => '权益包下发的超期时间'."\n" + ."\n" + .'is_permanent为false时，返回有效值', '$.components.schemas.BenefitPkgDeliveryInfo.properties.created_at.example' => '2019-08-20T06:51:27.292Z'], 'title' => 'A short description of struct', 'description' => '权益包下发信息', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'amount' => [ - 'title' => '权益包下发的数量', - 'description' => '权益包下发的数量', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'is_permanent' => [ - 'title' => '是否永久有效', - 'description' => '是否永久有效', - 'type' => 'boolean', - 'example' => 'false', - ], - 'expire_time' => [ - 'title' => '权益包下发的超期时间', - 'description' => '权益包下发的超期时间'."\n" - ."\n" - .'is_permanent为false时，返回有效值', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'created_at' => [ - 'title' => '权益包下发的创建时间', - 'description' => '权益包下发的创建时间', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - ], - ], - 'CNameStatus' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'bingding_state' => [ - 'title' => 'binding_state', - 'type' => 'string', - 'example' => 'BINDING/BOUND', - ], - 'legal_state' => [ - 'title' => 'legal_state', - 'type' => 'string', - 'example' => 'NORMAL/ABNORMAL', - ], - 'remark' => [ - 'title' => 'remark', - 'type' => 'string', - 'example' => 'beian', - ], - ], - ], - 'CdnFileDownloadCallbackInfo' => [ - 'title' => 'CDN下载回调', - 'description' => 'CDN文件下载回调', - 'type' => 'object', - 'properties' => [ - 'bucket' => [ - 'title' => 'bucket名称', - 'type' => 'string', - 'required' => true, - 'example' => 'ccp-bj1-bj-1234', - ], - 'object' => [ - 'title' => 'oss key', - 'type' => 'string', - 'required' => true, - ], - 'httpHeader.range' => [ - 'title' => '下载范围', - 'type' => 'string', - 'example' => 'bytes=0-1024', - ], - 'domain_id' => [ - 'title' => 'domain id', - 'type' => 'string', - 'required' => true, - ], - 'user_id' => [ - 'title' => '用户id', - 'type' => 'string', - 'required' => true, - ], - 'drive_id' => [ - 'title' => 'drive id', - 'type' => 'string', - 'required' => true, - ], - 'file_id' => [ - 'title' => '文件id', - 'type' => 'string', - 'required' => true, - ], - 'token' => [ - 'title' => '访问token', - 'type' => 'string', - 'required' => true, - 'example' => 'md5.Sum([]byte(fmt.Sprintf("%v%v%v%v%v%v...%v", req.Object, req.Range, req.DomainID, req.DriveID, req.UserID, req.FileID, req.Expire)))', - ], - 'expire' => [ - 'title' => 'unix超时时间', - 'type' => 'integer', - 'format' => 'int64', - 'required' => true, - ], - ], - 'required' => true, - ], - 'CertInfo' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'cert_name' => [ - 'title' => 'cert_name', - 'type' => 'string', - 'example' => 'xxx', - ], - 'cert_body' => [ - 'title' => 'cert_body', - 'type' => 'string', - 'example' => 'xxx', - ], - 'cert_privatekey' => [ - 'title' => 'cert_privatekey', - 'type' => 'string', - 'example' => 'xxx', - ], - ], - ], - 'ClearRecycleBinItem' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'domain_id' => [ - 'title' => 'domain_id', - 'type' => 'string', - ], - 'drive_id' => [ - 'title' => 'drive_id', - 'type' => 'string', - ], - 'task_id' => [ - 'title' => 'task_id', - 'type' => 'string', - ], - 'async_task_id' => [ - 'title' => 'async_task_id', - 'type' => 'string', - ], - ], - ], - 'CommonFileItem' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'drive_id' => [ - 'title' => 'drive_id', - 'type' => 'string', - ], - 'file_id' => [ - 'title' => 'file_id', - 'type' => 'string', - ], - 'revision_id' => [ - 'title' => 'revision_id', - 'type' => 'string', - ], - ], - ], - 'CopyUserTagsDirective' => [ - 'title' => 'CopyUserTagsDirective', - 'type' => 'object', - 'properties' => [ - 'directive' => [ - 'title' => 'copy 时的 user tags 设置选项', - 'type' => 'string', - 'example' => 'all, include, none, exclude', - ], - 'keys' => [ - 'title' => 'include/exlcude 选择的 keys', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], - ], - ], - ], - 'CssCreateOrderParam' => [ - 'title' => '创建订单/询价参数', - 'description' => '创建订单/询价参', - 'type' => 'object', - 'properties' => [ - 'buyerId' => [ - 'title' => '购买用户ID（aliuid', - 'type' => 'integer', - 'format' => 'int64', - ], - 'childId' => [ - 'title' => '子用户ID（childid', - 'type' => 'integer', - 'format' => 'int64', - ], - 'userId' => [ - 'title' => '使用者ID（aliuid', - 'type' => 'integer', - 'format' => 'int64', - ], - 'payerId' => [ - 'title' => '支付者ID（aliuid）', - 'type' => 'integer', - 'format' => 'int64', - ], - 'bid' => [ - 'title' => 'bid', - 'type' => 'string', - ], - 'requestId' => [ - 'title' => '选填。用于全程跟踪请求用途', - 'type' => 'string', - ], - 'token' => [ - 'title' => '选填。用于幂等性校验，客户端设置', - 'type' => 'string', - ], - 'fromApp' => [ - 'title' => '必须。调用方应用名', - 'type' => 'string', - ], - 'skipChannel' => [ - 'title' => '必须。渠道是否跳过调用', - 'type' => 'boolean', - ], - 'createrNick' => [ - 'title' => '选填。 如果是后台小二创建的订单，则设置此参数', - 'type' => 'string', - ], - 'memo' => [ - 'title' => '选填。订单备注', - 'type' => 'string', - ], - 'agentId' => [ - 'title' => '选填。订购来源(如阿里妈妈alimama_cps)', - 'type' => 'string', - ], - 'commodities' => [ - 'title' => '必填。 购买的商品对象列表', - 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/CssInstanceCommodity', - ], - ], - 'promotionCode' => [ - 'title' => '选填， 推荐码', - 'type' => 'string', - ], - 'planGroupId' => [ - 'title' => '套餐组id', - 'type' => 'integer', - 'format' => 'int64', - ], - 'planId' => [ - 'title' => '套餐id', - 'type' => 'integer', - 'format' => 'int64', - ], - 'planInstanceId' => [ - 'title' => '套餐实例id, 由套餐driver为套餐购买生成的实例id', - 'type' => 'string', - ], - 'cssAuthRequestParam' => [ - 'title' => '选填，鉴权参数', - 'type' => 'any', - ], - 'language' => [ - 'title' => '选填，语言', - 'type' => 'string', - ], - 'promotionInputParam' => [ - 'title' => '调用者传入的优惠可选项', - 'type' => 'any', - ], - 'orderOrigin' => [ - 'title' => '订单来源（可选，可为null)', - 'type' => 'string', - ], - 'marketType' => [ - 'title' => '相关判断 用这个Long型的', - 'type' => 'integer', - 'format' => 'int64', - ], - 'umidToken' => [ - 'title' => 'umidToken 选填', - 'type' => 'string', - ], - 'cilentIp' => [ - 'title' => '客户 IP，选填', - 'type' => 'string', - ], - 'orderParams' => [ - 'title' => '选填。公共的订购参数', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - ], - ], - 'autoPay' => [ - 'title' => '订单是否自动支付，默认不自动支付', - 'type' => 'boolean', - ], - 'autoUseCoupon' => [ - 'title' => '自动支付的时候，是否自动使用代金券', - 'type' => 'boolean', - ], - 'transientAccess' => [ - 'title' => '临时 AK', - 'type' => 'any', - ], - 'certificate' => [ - 'title' => 'receipt', - 'type' => 'string', - ], - ], - ], - 'CssInstanceCommodity' => [ - 'title' => '购买的商品对象', - 'description' => '购买的商品对象', - 'type' => 'object', - 'properties' => [ - 'planItemId' => [ - 'title' => '选填。如果是套餐订单，套餐项id必填', - 'type' => 'integer', - 'format' => 'int64', - ], - 'commodityCode' => [ - 'title' => '必填。商品code', - 'type' => 'string', - 'required' => false, - ], - 'specCode' => [ - 'title' => '必填。规格code 阿里云官网商品,commodityCode与specCode相同。 云市场及镜像市场的商品,commodityCode与specCode不同。', - 'type' => 'string', - 'required' => false, - ], - 'duration' => [ - 'title' => '必填。订购的周期数量', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - ], - 'pricingCycle' => [ - 'title' => '必填。订购的周期单位,年：Year，月：Month，日：Day，时：Hour', - 'type' => 'string', - 'required' => false, - ], - 'quantity' => [ - 'title' => '必填，订购实例数量', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - ], - 'orderType' => [ - 'title' => '新购 :BUY,续费:RENEW,升级:UPGRADE,试用:TRIAL', - 'type' => 'string', - ], - 'chargeType' => [ - 'title' => '必填。付费类型：预付费:PREPAY-，后付费:POSTPAY', - 'type' => 'string', - ], - 'refundSpecCode' => [ - 'title' => '选填。需要退款的商品CODE，目前用于增量带宽和转换订单的退订;', - 'type' => 'string', - ], - 'components' => [ - 'title' => '必填。订购模块集合', - 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/CssInstanceComponent', - ], - ], - 'orderParams' => [ - 'title' => '选填。订购参数(需要订单系统透传的参数)', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - ], - ], - 'instanceId' => [ - 'title' => '必填。实例ID，新购，续费，升级类型订单必填,格式为：JSON.toJSONString(List instanceIds)', - 'type' => 'string', - ], - 'activityId' => [ - 'title' => '选填。 购买对象参与的活动id', - 'type' => 'integer', - 'format' => 'int64', - ], - 'isFree' => [ - 'title' => '选填。是否免费，默认不免费 (如试用和补偿续费订单)', - 'type' => 'boolean', - ], - 'isSyncToSubscription' => [ - 'title' => '选填。是否同步转订购，默认异步', - 'type' => 'boolean', - ], - 'isPrePayPostCharge' => [ - 'title' => '选填。是否预付费后付款订单，默认不是', - 'type' => 'boolean', - ], - 'isRenewChange' => [ - 'title' => '选填。是否续费变配订单，默认不是。', - 'type' => 'boolean', - ], - 'specifyStartDate' => [ - 'title' => '选填。指定开始时间,单位：ms。', - 'type' => 'integer', - 'format' => 'int64', - ], - 'specUpgradeOriginSpecCodes' => [ - 'title' => '跨规格升级 原规格Code列表（一个新购，一个续费变配，，这个时候来跨规格升级就需要是一个list', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], - ], - 'upgradeInquireFinancialValue' => [ - 'title' => '升级是否询剩余财务价值（true：调用汇金取剩余财务价值，false：询差价）默认询财务价值', - 'type' => 'boolean', - ], - 'aliyunProduceCode' => [ - 'title' => '阿里云生产标识', - 'type' => 'string', - ], - 'redeemOrderType' => [ - 'title' => '提货券订单类型，提货券订单传入，默认为', - 'type' => 'string', - ], - 'redeemNoList' => [ - 'title' => '提货券券号列表，用于在新购和兑换的时候传入对应的提货券', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], - ], - ], - ], - 'CssInstanceComponent' => [ - 'title' => '订购模块', - 'description' => '订购模块', - 'type' => 'object', - 'properties' => [ - 'componentCode' => [ - 'title' => '配件 code', - 'type' => 'string', - ], - 'componentName' => [ - 'title' => '配件名称', - 'type' => 'string', - ], - 'globalKey' => [ - 'title' => '多语言key 根据统一的规则生成', - 'type' => 'string', - ], - 'tag' => [ - 'title' => '标记，必填。磁盘ID，新购，续费，升级类型订单必填,格式为：JSON.toJSONString(List tags) 并严格按照instanceId的顺序填写。', - 'type' => 'string', - ], - 'instanceProperty' => [ - 'title' => '模块属性信息', - 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/CssInstanceProperty', - ], - ], - 'moduleAttrStatus' => [ - 'title' => '表达此次配件的状态， 1:新增，2:变更，3:无变化; 请严格参照此状态进行赋值', - 'type' => 'integer', - 'format' => 'int64', - ], - ], - ], - 'CssInstanceProperty' => [ - 'title' => '模块属性', - 'description' => '模块属性', - 'type' => 'object', - 'properties' => [ - 'name' => [ - 'title' => '属性名称', - 'type' => 'string', - ], - 'code' => [ - 'title' => '属性代码', - 'type' => 'string', - ], - 'value' => [ - 'title' => '属性值', - 'type' => 'string', - ], - 'unit' => [ - 'title' => '单位', - 'type' => 'string', - ], - 'globalKey' => [ - 'title' => '多语言翻译的key', - 'type' => 'string', - ], - ], - ], - 'CssProduce' => [ - 'title' => '下单回调', - 'description' => 'common buy 下单回调', - 'type' => 'object', - 'properties' => [ - 'buyerId' => [ - 'title' => '购买用户ID（aliuid', - 'type' => 'integer', - 'format' => 'int64', - ], - 'childId' => [ - 'title' => '子用户ID（childid）', - 'type' => 'integer', - 'format' => 'int64', - ], - 'userId' => [ - 'title' => '使用者ID（aliuid', - 'type' => 'integer', - 'format' => 'int64', - ], - 'payerId' => [ - 'title' => '支付者ID（aliuid）', - 'type' => 'integer', - 'format' => 'int64', - ], - 'bid' => [ - 'title' => 'bid', - 'type' => 'string', - ], - 'requestId' => [ - 'title' => '选填。用于全程跟踪请求用途', - 'type' => 'string', - ], - 'token' => [ - 'title' => '选填。用于幂等性校验，客户端设置', - 'type' => 'string', - ], - 'fromApp' => [ - 'title' => '必须。调用方应用名', - 'type' => 'string', - ], - 'skipChannel' => [ - 'title' => '必须。渠道是否跳过调用', - 'type' => 'boolean', - ], - 'orderId' => [ - 'title' => '订单号', - 'type' => 'integer', - 'format' => 'int64', - ], - 'purchases' => [ - 'title' => '商品列表', - 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/CssPurchase', - ], - ], - ], - ], - 'CssPurchase' => [ - 'title' => '商品', - 'description' => '商品', - 'type' => 'object', - 'properties' => [ - 'commodityCode' => [ - 'title' => '商品code', - 'type' => 'string', - ], - 'chargeType' => [ - 'title' => '付费类型：预付费:PREPAY-，后付费:POSTPAY', - 'type' => 'string', - ], - 'startDate' => [ - 'title' => '开始时间', - 'type' => 'integer', - 'format' => 'int64', - ], - 'endDate' => [ - 'title' => '过期时间', - 'type' => 'integer', - 'format' => 'int64', - ], - 'gmtCreate' => [ - 'title' => 'xxx', - 'type' => 'integer', - 'format' => 'int64', - ], - 'instanceComponents' => [ - 'title' => '订购模块集合', - 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/CssInstanceComponent', - ], - ], - 'purchaseParams' => [ - 'title' => '参数', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - ], - ], - 'instanceId' => [ - 'title' => '必填。实例ID，新购，续费，升级类型订单必填,格式为：JSON.toJSONString(List instanceIds);', - 'type' => 'string', - ], - 'orderType' => [ - 'title' => '新购 :BUY,续费:RENEW,升级:UPGRADE,试用:TRIAL', - 'type' => 'string', - ], - ], - ], - 'CustomSideLinkConfig' => [ - 'title' => 'CustomSideLinkConfig', - 'type' => 'object', - 'properties' => [ - 'icon' => [ - 'title' => 'icon', - 'type' => 'string', - ], - 'text' => [ - 'title' => 'text', - 'type' => 'string', - ], - 'link' => [ - 'title' => 'link', - 'type' => 'string', - ], - ], - ], - 'DataBoxPrivileges' => [ - 'title' => 'A short description of struct', - 'description' => 'DataBoxPrivileges', - 'type' => 'object', - 'properties' => [ - 'feature_id' => [ - 'title' => '特性id', - 'type' => 'string', - ], - 'feature_attr_id' => [ - 'title' => '特性属性id', - 'type' => 'string', - ], - 'quota' => [ - 'title' => '配额', - 'type' => 'integer', - 'format' => 'int64', - ], - ], - ], - 'DataCName' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'location' => [ - 'title' => 'location', - 'type' => 'string', - ], - 'store_id' => [ - 'title' => '存储id', - 'type' => 'string', - ], - 'cname' => [ - 'title' => 'cname', - 'type' => 'string', - ], - 'cert_name' => [ - 'title' => 'cert_name', - 'type' => 'string', - ], - 'cert_expire_time' => [ - 'title' => 'cert_expire_time', - 'type' => 'integer', - 'format' => 'int64', - ], - 'cname_type' => [ - 'title' => 'cname_type', - 'type' => 'string', - ], + 'amount' => ['title' => '权益包下发的数量', 'description' => '权益包下发的数量', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'is_permanent' => ['title' => '是否永久有效', 'description' => '是否永久有效', 'visibility' => 'Public', 'type' => 'boolean', 'example' => 'false'], + 'expire_time' => ['title' => '权益包下发的超期时间', 'description' => '权益包下发的超期时间'."\n" + ."\n" + .'is_permanent为false时，返回有效值', 'visibility' => 'Public', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'created_at' => ['title' => '权益包下发的创建时间', 'description' => '权益包下发的创建时间', 'visibility' => 'Public', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], ], ], 'Domain' => [ @@ -2277,228 +275,28 @@ 'description' => '基础 domain 信息', 'type' => 'object', 'properties' => [ - 'parent_domain_id' => [ - 'title' => 'parent_domain_id string 父 domain id，如果存在，表示该 domain为子 domain domain_id string domain id', - 'description' => '父 domain ID，如果存在，表示子 domain，否则表示普通 domain', - 'type' => 'string', - 'example' => 'bj1', - ], - 'domain_id' => [ - 'title' => 'domain id', - 'description' => 'domain ID', - 'type' => 'string', - 'example' => 'bj2', - ], - 'domain_name' => [ - 'title' => '域名称', - 'description' => 'domain 名称', - 'type' => 'string', - 'example' => 'pdsdomain', - ], - 'description' => [ - 'title' => '描述', - 'description' => 'domain 描述', - 'type' => 'string', - 'example' => 'my domain', - ], - 'init_drive_enable' => [ - 'title' => '否开通默认网盘。为true则所有用户在第一次登录后都默认分配一个网盘。默认false', - 'description' => '否开通默认网盘。为true则所有用户在第一次登录后都默认分配一个网盘。默认false', - 'type' => 'boolean', - 'example' => 'true', - ], - 'init_drive_size' => [ - 'title' => 'init_drive_enable==true时必选。 默认网盘的大小, 单位：Bytes。为0则表示不限大小。默认为0', - 'description' => 'init\\_drive\\_enable 为true时必选。 创建用户时，默认网盘的大小，单位：Bytes。'."\n" - .'默认为 0，此时创建的 drive 大小为0，不可以上传文件，如果需要初始化 drive， 请设置该值。'."\n" - .'-1则表示不限大小。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1073741824', - ], - 'updated_at' => [ - 'title' => '最后修改时间，ISO格式，如: 2019-04-08T07:05:18.825Z', - 'description' => '最后修改时间，ISO格式，如: 2019-04-08T07:05:18.825Z', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'created_at' => [ - 'title' => '创建时间，ISO格式， 如：2019-03-28T13:03:29.298Z', - 'description' => '创建时间，ISO格式， 如：2019-03-28T13:03:29.298Z', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'size_quota' => [ - 'title' => '容量配额', - 'description' => '容量配额，表示 domain 下所有 drive 的总quota 大小，0 表示不限制', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1099511627776', - ], - 'size_quota_used' => [ - 'title' => '容量配额使用空间', - 'description' => '所有 drive 的 quota 容量配额使用空间', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1099511627776', - ], - 'user_count_quota' => [ - 'title' => '用户数配额', - 'description' => '用户数配额', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '50', - ], - 'status' => [ - 'title' => 'domain状态：创建中，正常，已过期', - 'description' => 'domain状态：'."\n" - .'1：正常'."\n" - .'2：创建中'."\n" - .'6：已过期', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'used_size' => [ - 'title' => '逻辑空间使用量，单位为字节', - 'description' => '逻辑空间使用量，单位为字节', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1099511627776', - ], - 'published_app_access_strategy' => [ - 'title' => 'App 访问策略', - 'description' => 'App 访问策略', - '$ref' => '#/components/schemas/AppAccessStrategy', - ], - 'sharable' => [ - 'title' => '是否开启共享', - 'description' => '是否开启共享', - 'type' => 'boolean', - ], - 'data_hash_name' => [ - 'title' => 'domain hash type', - 'description' => '表示计算数据哈希值的方法名称。', - 'type' => 'string', - 'example' => 'sha1', - ], - 'store_redundancy_type' => [ - 'title' => '存储冗余类型。本地冗余：LRS；同城冗余：ZRS', - 'description' => '存储冗余类型。本地冗余：LRS；同城冗余：ZRS', - 'type' => 'string', - 'example' => 'LRS', - ], - 'system_drive_config' => [ - '$ref' => '#/components/schemas/SystemDriveConfig', - ], - ], - ], - 'DomainAppConfig' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'same_name_file_upload_mode' => [ - 'title' => 'same_name_file_upload_mode', - 'type' => 'string', - ], - 'web_client_download_mode' => [ - 'title' => 'web_client_download_mode', - 'type' => 'string', - ], - 'single_file_upload_size_limit' => [ - 'title' => 'single_file_upload_size_limit', - 'type' => 'integer', - 'format' => 'int64', - ], - 'allow_upload_file_category_list' => [ - 'title' => 'allow_upload_file_category_list', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], - ], - 'allow_upload_custom_file_ext_list' => [ - 'title' => 'allow_upload_custom_file_ext_list', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], - ], - ], - ], - 'DomainBuildClientConfig' => [ - 'title' => 'DomainBuildClient', - 'type' => 'object', - 'properties' => [ - 'name' => [ - 'title' => 'name', - 'type' => 'string', - ], - 'copyright' => [ - 'title' => 'copyright', - 'type' => 'string', - ], - ], - ], - 'DomainEndpoints' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [], - ], - 'DomainSeniorConfig' => [ - 'title' => 'DomainSeniorConfig', - 'type' => 'object', - 'properties' => [ - 'home_page_bg_image_url' => [ - 'title' => 'home_page_bg_image_url', - 'type' => 'string', - ], - 'home_page_slogan' => [ - 'title' => 'home_page_slogan', - 'type' => 'string', - ], - 'home_page_footer' => [ - 'title' => 'home_page_footer', - 'type' => 'string', - ], - 'home_page_footer2' => [ - 'title' => 'home_page_footer2', - 'type' => 'string', - ], - 'csp_frame_ancestors' => [ - 'title' => 'csp_frame_ancestors', - 'type' => 'string', - ], - 'referer_enable' => [ - 'title' => 'referer_enable', - 'type' => 'boolean', - ], - 'wx_txt_list' => [ - '$ref' => '#/components/schemas/WxTrustedDomainConfig', - ], - 'custom_login_appid' => [ - 'title' => 'custom_login_appid', - 'type' => 'string', - ], - 'custom_login_url' => [ - 'title' => 'custom_login_url', - 'type' => 'string', - ], - 'custom_logout_url' => [ - 'title' => 'custom_logout_url', - 'type' => 'string', - ], - 'custom_side_link_list' => [ - 'title' => 'custom_side_link_list', - 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/CustomSideLinkConfig', - ], - ], - 'client_download_enable' => [ - 'title' => 'client_download_enable', - 'type' => 'boolean', - ], + 'parent_domain_id' => ['title' => 'parent_domain_id string 父 domain id，如果存在，表示该 domain为子 domain domain_id string domain id', 'description' => '父 domain ID，如果存在，表示子 domain，否则表示普通 domain', 'type' => 'string', 'example' => 'bj1'], + 'domain_id' => ['title' => 'domain id', 'description' => 'domain ID', 'type' => 'string', 'example' => 'bj2'], + 'domain_name' => ['title' => '域名称', 'description' => 'domain 名称', 'type' => 'string', 'example' => 'pdsdomain'], + 'description' => ['title' => '描述', 'description' => 'domain 描述', 'type' => 'string', 'example' => 'my domain'], + 'init_drive_enable' => ['title' => '否开通默认网盘。为true则所有用户在第一次登录后都默认分配一个网盘。默认false', 'description' => '否开通默认网盘。为true则所有用户在第一次登录后都默认分配一个网盘。默认false', 'type' => 'boolean', 'example' => 'true'], + 'init_drive_size' => ['title' => 'init_drive_enable==true时必选。 默认网盘的大小, 单位：Bytes。为0则表示不限大小。默认为0', 'description' => 'init\\_drive\\_enable 为true时必选。 创建用户时，默认网盘的大小，单位：Bytes。'."\n" + .'默认为 0，此时创建的 drive 大小为0，不可以上传文件，如果需要初始化 drive， 请设置该值。'."\n" + .'-1则表示不限大小。', 'type' => 'integer', 'format' => 'int64', 'example' => '1073741824'], + 'updated_at' => ['title' => '最后修改时间，ISO格式，如: 2019-04-08T07:05:18.825Z', 'description' => '最后修改时间，ISO格式，如: 2019-04-08T07:05:18.825Z', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'created_at' => ['title' => '创建时间，ISO格式， 如：2019-03-28T13:03:29.298Z', 'description' => '创建时间，ISO格式， 如：2019-03-28T13:03:29.298Z', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'size_quota' => ['title' => '容量配额', 'description' => '容量配额，表示 domain 下所有 drive 的总quota 大小，0 表示不限制', 'type' => 'integer', 'format' => 'int64', 'example' => '1099511627776'], + 'size_quota_used' => ['title' => '容量配额使用空间', 'description' => '所有 drive 的 quota 容量配额使用空间', 'type' => 'integer', 'format' => 'int64', 'example' => '1099511627776'], + 'user_count_quota' => ['title' => '用户数配额', 'description' => '用户数配额', 'type' => 'integer', 'format' => 'int64', 'example' => '50'], + 'status' => ['title' => 'domain状态：创建中，正常，已过期', 'description' => 'domain状态：'."\n" + .'1：正常'."\n" + .'2：创建中'."\n" + .'6：已过期', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'used_size' => ['title' => '逻辑空间使用量，单位为字节', 'description' => '逻辑空间使用量，单位为字节', 'type' => 'integer', 'format' => 'int64', 'example' => '1099511627776'], + 'published_app_access_strategy' => ['title' => 'App 访问策略', 'description' => 'App 访问策略', '$ref' => '#/components/schemas/AppAccessStrategy'], + 'sharable' => ['title' => '是否开启共享', 'description' => '是否开启共享', 'type' => 'boolean'], + 'data_hash_name' => ['title' => 'domain hash type', 'description' => '表示计算数据哈希值的方法名称。', 'type' => 'string', 'example' => 'sha1'], + 'store_redundancy_type' => ['title' => '存储冗余类型。本地冗余：LRS；同城冗余：ZRS', 'description' => '存储冗余类型', 'type' => 'string', 'example' => 'LRS'], ], ], 'Drive' => [ @@ -2506,302 +304,75 @@ 'description' => '空间', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'title' => '域id', - 'description' => '域id', - 'type' => 'string', - 'example' => 'bj1', - ], - 'drive_id' => [ - 'title' => '空间id', - 'description' => '空间id', - 'type' => 'string', - 'example' => '1', - ], - 'drive_name' => [ - 'title' => '空间名称', - 'description' => '空间名称', - 'type' => 'string', - 'example' => 'drv1', - ], - 'description' => [ - 'title' => '描述', - 'description' => '描述', - 'type' => 'string', - 'example' => 'vipdrive', - ], - 'owner' => [ - 'title' => '归属者', - 'description' => '归属者', - 'type' => 'string', - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - ], - 'owner_type' => [ - 'title' => '归属者类型', - 'description' => '归属者类型', - 'type' => 'string', - 'example' => 'user', - ], - 'drive_type' => [ - 'title' => '空间类型', - 'description' => '空间类型', - 'type' => 'string', - 'example' => 'normal', - ], - 'status' => [ - 'title' => '状态', - 'description' => '状态'."\n" - ."\n" - .'1. enabled 表示该空间可使用'."\n" - .'2. disabled 表示该空间不可用', - 'type' => 'string', - 'example' => 'enabled', - ], - 'used_size' => [ - 'title' => '使用空间大小', - 'description' => '使用空间大小，单位为字节', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '20480', - ], - 'total_size' => [ - 'title' => '总空间大小', - 'description' => '总空间大小，单位为字节', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '204800', - ], - 'created_at' => [ - 'title' => '创建时间', - 'description' => '创建时间', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'creator' => [ - 'title' => '创建者', - 'description' => '创建者', - 'type' => 'string', - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - ], - ], - ], - 'DriveLogDetail' => [ - 'title' => 'drive日志详情', - 'description' => 'drive日志详情', - 'type' => 'object', - 'properties' => [ - 'name' => [ - 'title' => '名称', - 'type' => 'string', - ], - 'total_size' => [ - 'title' => '总大小', - 'type' => 'integer', - 'format' => 'int64', - ], - 'owner_id' => [ - 'title' => '归属人id', - 'type' => 'string', - ], - 'owner_name' => [ - 'title' => '归属人的名称', - 'type' => 'string', - ], - 'owner_type' => [ - 'title' => '归属人的类别', - 'type' => 'string', - ], - 'update_to' => [ - 'title' => '更新后的设置', - 'type' => 'object', - 'properties' => [ - 'name' => [ - 'title' => '名称', - 'type' => 'string', - ], - 'total_size' => [ - 'title' => '总大小', - 'type' => 'integer', - 'format' => 'int64', - ], - 'owner_id' => [ - 'title' => '归属人id', - 'type' => 'string', - ], - 'owner_name' => [ - 'title' => '归属人的名称', - 'type' => 'string', - ], - 'owner_type' => [ - 'title' => '归属人的类别', - 'type' => 'string', - ], - ], - ], - 'force_delete' => [ - 'title' => '是否强制删除', - 'type' => 'boolean', - ], - 'handover_owner_name' => [ - 'title' => '交接人的名称', - 'type' => 'string', - ], - ], - ], - 'ExternalMultiFileRevisionConfig' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'revision_merge_enabled' => [ - 'title' => 'revision_merge_enabled', - 'type' => 'boolean', - ], - 'revision_count' => [ - 'title' => 'revision_count', - 'type' => 'integer', - 'format' => 'int64', - ], - 'revision_recycle_period' => [ - 'title' => 'revision_recycle_period', - 'type' => 'integer', - 'format' => 'int64', - ], + 'domain_id' => ['title' => '域id', 'description' => '域id', 'type' => 'string', 'example' => 'bj1'], + 'drive_id' => ['title' => '空间id', 'description' => '空间id', 'type' => 'string', 'example' => '1'], + 'drive_name' => ['title' => '空间名称', 'description' => '空间名称', 'type' => 'string', 'example' => 'drv1'], + 'description' => ['title' => '描述', 'description' => '描述', 'type' => 'string', 'example' => 'vipdrive'], + 'owner' => ['title' => '归属者', 'description' => '归属者', 'type' => 'string', 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4'], + 'owner_type' => ['title' => '归属者类型', 'description' => '归属者类型', 'type' => 'string', 'example' => 'user'], + 'drive_type' => ['title' => '空间类型', 'description' => '空间类型', 'type' => 'string', 'example' => 'normal'], + 'status' => ['title' => '状态', 'description' => '状态'."\n" + ."\n" + .'1. enabled 表示该空间可使用'."\n" + .'2. disabled 表示该空间不可用', 'type' => 'string', 'example' => 'enabled'], + 'used_size' => ['title' => '使用空间大小', 'description' => '使用空间大小，单位为字节', 'type' => 'integer', 'format' => 'int64', 'example' => '20480'], + 'total_size' => ['title' => '总空间大小', 'description' => '总空间大小，单位为字节', 'type' => 'integer', 'format' => 'int64', 'example' => '204800'], + 'created_at' => ['title' => '创建时间', 'description' => '创建时间', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'creator' => ['title' => '创建者', 'description' => '创建者', 'type' => 'string', 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4'], ], ], 'FaceGroup' => [ 'title' => '人脸分组', 'description' => '人脸分组', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'group_id' => [ - 'title' => '人脸分组ID', - 'description' => '人脸分组ID', - 'type' => 'string', - 'example' => 'Cluster-ae6e3472-999e-410b-b54e-cd5dba****', - ], - 'group_name' => [ - 'title' => '人脸分组名称', - 'description' => '人脸分组名称', - 'type' => 'string', - 'example' => 'name', - ], - 'image_count' => [ - 'title' => '照片数量', - 'description' => '人脸分组内照片数量', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', - ], - 'created_at' => [ - 'title' => '人脸分组生成时间。格式 RFC3339', - 'description' => '人脸分组生成时间', - 'type' => 'string', - 'example' => '2022-01-14T10:10:52.83948013+08:00', - ], - 'updated_at' => [ - 'title' => '人脸分组修改时间。格式 RFC3339', - 'description' => '人脸分组修改时间', - 'type' => 'string', - 'example' => '2022-01-14T10:10:52.83948013+08:00', - ], - 'group_cover_url' => [ - 'title' => '人脸分组封面头像地址', - 'description' => '人脸分组封面头像地址', - 'type' => 'string', - 'example' => 'https://xxx', - ], - 'group_cover_file_id' => [ - 'title' => '人脸分组封面文件ID', - 'description' => '人脸分组封面文件ID', - 'type' => 'string', - 'example' => '6549c959640fbd517c9b4d93b3b36aecc45xxxxx', - ], - 'group_cover_width' => [ - 'title' => '人脸分组封面图片宽', - 'description' => '人脸分组封面图片宽', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1920', - ], - 'group_cover_height' => [ - 'title' => '人脸分组封面图片高', - 'description' => '人脸分组封面图片高', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1080', - ], + 'group_id' => ['title' => '人脸分组ID', 'description' => '人脸分组ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Cluster-ae6e3472-999e-410b-b54e-cd5dba****'], + 'group_name' => ['title' => '人脸分组名称', 'description' => '人脸分组名称', 'visibility' => 'Public', 'type' => 'string', 'example' => 'name'], + 'image_count' => ['title' => '照片数量', 'description' => '人脸分组内照片数量', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '10'], + 'created_at' => ['title' => '人脸分组生成时间。格式 RFC3339', 'description' => '人脸分组生成时间', 'visibility' => 'Public', 'type' => 'string', 'example' => '2022-01-14T10:10:52.83948013+08:00'], + 'updated_at' => ['title' => '人脸分组修改时间。格式 RFC3339', 'description' => '人脸分组修改时间', 'visibility' => 'Public', 'type' => 'string', 'example' => '2022-01-14T10:10:52.83948013+08:00'], + 'group_cover_url' => ['title' => '人脸分组封面头像地址', 'description' => '人脸分组封面头像地址', 'visibility' => 'Public', 'type' => 'string', 'example' => 'https://xxx'], + 'group_cover_file_id' => ['title' => '人脸分组封面文件ID', 'description' => '人脸分组封面文件ID', 'visibility' => 'Public', 'type' => 'string', 'example' => '6549c959640fbd517c9b4d93b3b36aecc45xxxxx'], + 'group_cover_width' => ['title' => '人脸分组封面图片宽', 'description' => '人脸分组封面图片宽', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1920'], + 'group_cover_height' => ['title' => '人脸分组封面图片高', 'description' => '人脸分组封面图片高', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1080'], 'group_cover_face_boundary' => [ 'title' => '人脸分组封面图片边框', 'description' => '人脸分组封面图片边框', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'Width' => [ - 'title' => '宽，单位像素', - 'description' => '宽，单位像素', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'Height' => [ - 'title' => '高， 单位像素', - 'description' => '高， 单位像素', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '300', - ], - 'Top' => [ - 'title' => '距离照片顶部的距离，单位像素', - 'description' => '距离照片顶部的距离，单位像素', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '30', - ], - 'Left' => [ - 'title' => '距离照片左边框的距离，单位像素', - 'description' => '距离照片左边框的距离，单位像素', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '10', - ], + 'Width' => ['title' => '宽，单位像素', 'description' => '宽，单位像素', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'Height' => ['title' => '高， 单位像素', 'description' => '高， 单位像素', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '300'], + 'Top' => ['title' => '距离照片顶部的距离，单位像素', 'description' => '距离照片顶部的距离，单位像素', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '30'], + 'Left' => ['title' => '距离照片左边框的距离，单位像素', 'description' => '距离照片左边框的距离，单位像素', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '10'], ], ], - 'remarks' => [ - 'title' => '备注', - 'description' => '备注', - 'type' => 'string', + 'remarks' => ['title' => '备注', 'description' => '备注', 'visibility' => 'Public', 'type' => 'string'], + 'remarks_array' => [ + 'title' => '备注列表', + 'description' => '备注列表', + 'visibility' => 'Private', + 'type' => 'array', + 'items' => ['visibility' => 'Public', 'type' => 'string', 'extendType' => 'true'], ], ], ], 'FaceThumbnail' => [ 'title' => '人脸缩略图信息。仅开启增值服务图片处理功能有效。', 'description' => '人脸缩略图信息。仅开启增值服务图片处理功能有效。', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'face_id' => [ - 'title' => '人脸 id。', - 'description' => '人脸 id。', - 'type' => 'string', - 'example' => 'a9a66a86-73dd-4c95-8b79-1d8a49db5226', - ], - 'face_group_id' => [ - 'title' => '人脸所属分组 id。', - 'description' => '人脸所属分组 id。'."\n" - ."\n" - .'包含如下特定 id：'."\n" - ."\n" - .'- figure-cluster-id-independent：该人脸暂无合适的分组，后续在数据集中新增图片后进行人脸聚类操作时，该人脸可能被分入组中。'."\n" - ."\n" - .'- figure-cluster-id-unavailable：该人脸暂未进行过聚类操作，即在数据集中新增图片后，未进行人脸聚类。', - 'type' => 'string', - 'example' => 'Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0', - ], - 'face_thumbnail' => [ - 'title' => '人脸缩略图。', - 'description' => '人脸缩略图。', - 'type' => 'string', - 'deprecated' => true, - 'example' => 'https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2', - ], + 'face_id' => ['title' => '人脸 id。', 'description' => '人脸 id。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'a9a66a86-73dd-4c95-8b79-1d8a49db5226'], + 'face_group_id' => ['title' => '人脸所属分组 id。', 'description' => '人脸所属分组 id。'."\n" + ."\n" + .'包含如下特定 id：'."\n" + ."\n" + .'- figure-cluster-id-independent：该人脸暂无合适的分组，后续在数据集中新增图片后进行人脸聚类操作时，该人脸可能被分入组中。'."\n" + ."\n" + .'- figure-cluster-id-unavailable：该人脸暂未进行过聚类操作，即在数据集中新增图片后，未进行人脸聚类。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0'], + 'face_thumbnail' => ['title' => '人脸缩略图。', 'description' => '人脸缩略图。', 'visibility' => 'Public', 'type' => 'string', 'deprecated' => true, 'example' => 'https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2', 'sensitive' => true], ], ], 'File' => [ @@ -2809,1001 +380,270 @@ 'description' => '文件', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'title' => '域id', - 'description' => '域id', - 'type' => 'string', - 'example' => 'bj1', - ], - 'drive_id' => [ - 'title' => '空间id', - 'description' => '空间id', - 'type' => 'string', - 'example' => '1', - ], - 'file_id' => [ - 'title' => '文件id', - 'description' => '文件id', - 'type' => 'string', - 'example' => '5d79206586bb5dd69fb34c349282718146c55da7', - ], - 'name' => [ - 'title' => '名称', - 'description' => '名称', - 'type' => 'string', - 'example' => '1.mov', - ], + 'domain_id' => ['title' => '域id', 'description' => '域id', 'type' => 'string', 'example' => 'bj1'], + 'drive_id' => ['title' => '空间id', 'description' => '空间id', 'type' => 'string', 'example' => '1'], + 'file_id' => ['title' => '文件id', 'description' => '文件id', 'type' => 'string', 'example' => '5d79206586bb5dd69fb34c349282718146c55da7'], + 'name' => ['title' => '名称', 'description' => '名称', 'type' => 'string', 'example' => '1.mov'], 'type' => [ 'title' => '类型', 'description' => '类型', 'type' => 'string', - 'enumValueTitles' => [ - 'file' => '文件', - 'folder' => '文件夹', - ], + 'enumValueTitles' => ['file' => '文件', 'folder' => '文件夹'], 'example' => 'file', ], - 'content_type' => [ - 'title' => '内容类型', - 'description' => '内容类型', - 'type' => 'string', - 'example' => 'application/json', - ], - 'created_at' => [ - 'title' => '创建时间', - 'description' => '创建时间', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'updated_at' => [ - 'title' => '修改时间', - 'description' => '修改时间', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'description' => [ - 'title' => '描述', - 'description' => '描述', - 'type' => 'string', - 'example' => 'image file', - ], - 'trashed_at' => [ - 'title' => '放入回收站时间', - 'description' => '放入回收站时间', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'file_extension' => [ - 'title' => '文件扩展', - 'description' => '文件扩展名', - 'type' => 'string', - 'example' => 'txt', - ], - 'hidden' => [ - 'title' => '是否隐藏', - 'description' => '是否隐藏', - 'type' => 'boolean', - 'example' => 'false', - ], - 'size' => [ - 'title' => '大小', - 'description' => '如果是文件，表示文件大小'."\n" - ."\n" - .'如果是文件夹，表示文件夹的大小（递归计算所有子孙文件的大小）'."\n" - .'备注：文件夹大小只有在 list file，get file 时设置 fields 包含 dir_size 时才会返回', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1024', - ], - 'starred' => [ - 'title' => '是否收藏', - 'description' => '是否收藏', - 'type' => 'boolean', - 'example' => 'false', - ], + 'content_type' => ['title' => '内容类型', 'description' => '内容类型', 'type' => 'string', 'example' => 'application/json'], + 'created_at' => ['title' => '创建时间', 'description' => '创建时间', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'updated_at' => ['title' => '修改时间', 'description' => '修改时间', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'description' => ['title' => '描述', 'description' => '描述', 'type' => 'string', 'example' => 'image file'], + 'trashed_at' => ['title' => '放入回收站时间', 'description' => '放入回收站时间', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'file_extension' => ['title' => '文件扩展', 'description' => '文件扩展名', 'type' => 'string', 'example' => 'txt'], + 'hidden' => ['title' => '是否隐藏', 'description' => '是否隐藏', 'type' => 'boolean', 'example' => 'false'], + 'size' => ['title' => '大小', 'description' => '如果是文件，表示文件大小'."\n" + ."\n" + .'如果是文件夹，表示文件夹的大小（递归计算所有子孙文件的大小）'."\n" + .'备注：文件夹大小只有在 list file，get file 时设置 fields 包含 dir_size 时才会返回', 'type' => 'integer', 'format' => 'int64', 'example' => '1024'], + 'starred' => ['title' => '是否收藏', 'description' => '是否收藏', 'type' => 'boolean', 'example' => 'false'], 'status' => [ 'title' => '状态', 'description' => '状态，只有available的文件和目录才是可以被访问的，如果文件处于uploading状态，GetFile会返回文件不存在, ListFile也不会返回uploading状态的文件', 'type' => 'string', - 'enumValueTitles' => [ - 'available' => 'available', - 'uploading' => 'uploading', - ], + 'enumValueTitles' => ['available' => 'available', 'uploading' => 'uploading'], 'example' => 'available', ], 'labels' => [ 'title' => '标签', 'description' => '标签', 'type' => 'array', - 'items' => [ - 'description' => '标签', - 'type' => 'string', - 'example' => '["label1:1", "label2:2"]', - ], + 'items' => ['description' => '标签', 'type' => 'string', 'example' => '["label1:1", "label2:2"]'], 'example' => '["label1:1", "label2:2"]', ], - 'upload_id' => [ - 'title' => '上传id', - 'description' => '上传id', - 'type' => 'string', - 'example' => 'C9DCFE5A82644AC7A02DB74C30C934A6', - ], - 'parent_file_id' => [ - 'title' => '父文件夹id', - 'description' => '父文件夹id', - 'type' => 'string', - 'example' => '3d5b846942cf94fa72324c8a4bda34e81da635a', - ], - 'crc64_hash' => [ - 'title' => 'crc64', - 'description' => 'crc64', - 'type' => 'string', - 'example' => '3574582125365864471', - ], - 'content_hash' => [ - 'title' => '内容hash', - 'description' => '内容hash', - 'type' => 'string', - 'example' => 'EA4942AA8761213890A5C386F88E6464D2C31CA3', - ], + 'upload_id' => ['title' => '上传id', 'description' => '上传id', 'type' => 'string', 'example' => 'C9DCFE5A82644AC7A02DB74C30C934A6'], + 'parent_file_id' => ['title' => '父文件夹id', 'description' => '父文件夹id', 'type' => 'string', 'example' => '3d5b846942cf94fa72324c8a4bda34e81da635a'], + 'crc64_hash' => ['title' => 'crc64', 'description' => 'crc64', 'type' => 'string', 'example' => '3574582125365864471'], + 'content_hash' => ['title' => '内容hash', 'description' => '内容hash', 'type' => 'string', 'example' => 'EA4942AA8761213890A5C386F88E6464D2C31CA3'], 'content_hash_name' => [ 'title' => '内容hash算法名', 'description' => '内容hash算法名，当前hash 算法支持sha1', 'type' => 'string', - 'enumValueTitles' => [ - 'sha1' => 'sha1', - ], + 'enumValueTitles' => ['sha1' => 'sha1'], 'example' => 'sha1', ], - 'download_url' => [ - 'title' => '下载链接', - 'description' => '下载链接， 下载链接默认有效期是 15 分钟，如果URL过期，可以通过 GetFile 进行获取', - 'type' => 'string', - 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx', - ], - 'thumbnail' => [ - 'title' => '缩略图地址', - 'description' => '缩略图地址（已废弃，推荐使用thumbnail\\_urls）', - 'type' => 'string', - 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx', - ], + 'download_url' => ['title' => '下载链接', 'description' => '下载链接， 下载链接默认有效期是 15 分钟，如果URL过期，可以通过 GetFile 进行获取', 'type' => 'string', 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx'], + 'thumbnail' => ['title' => '缩略图地址', 'description' => '缩略图地址（已废弃，推荐使用thumbnail\\_urls）', 'type' => 'string', 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx'], 'category' => [ 'title' => '分类', 'description' => '分类， pds 会根据文件的后缀名和 mime-type 对文件进行分类，主要分类有 doc, image, audio, video', 'type' => 'string', - 'enumValueTitles' => [ - 'image' => 'image', - 'doc' => 'doc', - 'audio' => 'audio', - 'video' => 'video', - ], + 'enumValueTitles' => ['image' => 'image', 'doc' => 'doc', 'audio' => 'audio', 'video' => 'video'], 'example' => 'image', ], - 'local_created_at' => [ - 'title' => '文件本地创建时间', - 'description' => '文件本地创建时间, 本地创建时间是指文件在上传时刻的本地时间，主要帮助客户端识别本地上传时间', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'local_modified_at' => [ - 'title' => '文件本地修改时间', - 'description' => '文件本地修改时间，文件本地更新时间, 本地更新时间是指文件在上传时刻的本地时间，主要帮助客户端识别本地更新时间', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'revision_id' => [ - 'title' => '版本id', - 'description' => '版本id， 当相同file-id 文件覆盖上传时， 会有新的revision_id 产生', - 'type' => 'string', - 'example' => '5d5b846942cf94fa72324c14a4bda34e81da635d', - ], + 'local_created_at' => ['title' => '文件本地创建时间', 'description' => '文件本地创建时间, 本地创建时间是指文件在上传时刻的本地时间，主要帮助客户端识别本地上传时间', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'local_modified_at' => ['title' => '文件本地修改时间', 'description' => '文件本地修改时间，文件本地更新时间, 本地更新时间是指文件在上传时刻的本地时间，主要帮助客户端识别本地更新时间', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'revision_id' => ['title' => '版本id', 'description' => '版本id， 当相同file-id 文件覆盖上传时， 会有新的revision_id 产生', 'type' => 'string', 'example' => '5d5b846942cf94fa72324c14a4bda34e81da635d'], 'thumbnail_urls' => [ 'title' => '返回的缩略图信息', 'description' => '返回的缩略图信息，与入参thumbnail\\_processes中传入的key对应。', 'type' => 'object', - 'additionalProperties' => [ - 'description' => '返回的缩略图信息，与入参thumbnail\\_processes中传入的key对应。', - 'type' => 'string', - 'required' => false, - 'example' => '"128X128": "https://url1", "800X800": "url2"', - ], - ], - 'image_media_metadata' => [ - 'title' => '图片信息。仅开启增值服务图片处理功能有效。', - 'description' => '图片信息。仅开启增值服务图片处理功能有效。', - '$ref' => '#/components/schemas/ImageMediaMetadata', + 'additionalProperties' => ['description' => '返回的缩略图信息，与入参thumbnail\\_processes中传入的key对应。', 'type' => 'string', 'required' => false, 'example' => '"128X128": "https://url1", "800X800": "url2"'], ], + 'image_media_metadata' => ['title' => '图片信息。仅开启增值服务图片处理功能有效。', 'description' => '图片信息。仅开启增值服务图片处理功能有效。', '$ref' => '#/components/schemas/ImageMediaMetadata'], 'user_tags' => [ 'title' => '用户自定义标签', 'description' => '用户自定义标签', 'type' => 'object', - 'additionalProperties' => [ - 'description' => '用户自定义标签', - 'type' => 'string', - 'example' => '"k1":"v1", "k2","v2"', - ], - ], - 'video_media_metadata' => [ - 'title' => '音视频信息', - 'description' => '音视频信息', - '$ref' => '#/components/schemas/VideoMediaMetadata', - ], - 'id_path' => [ - 'title' => '文件id路径', - 'description' => '文件id路径', - 'type' => 'string', - 'required' => false, - 'example' => 'id1/id2', - ], - 'name_path' => [ - 'title' => '文件路径', - 'description' => '文件路径', - 'type' => 'string', - 'example' => 'root/f1/f2', + 'additionalProperties' => ['description' => '用户自定义标签', 'type' => 'string', 'example' => '"k1":"v1", "k2","v2"'], ], + 'video_media_metadata' => ['title' => '音视频信息', 'description' => '音视频信息', '$ref' => '#/components/schemas/VideoMediaMetadata'], + 'id_path' => ['title' => '文件id路径', 'description' => '文件id路径', 'type' => 'string', 'required' => false, 'example' => 'id1/id2'], + 'name_path' => ['title' => '文件路径', 'description' => '文件路径', 'type' => 'string', 'example' => 'root/f1/f2'], 'dir_size_info' => [ 'title' => '目录计量信息', 'description' => 'list file，get file 时，如果 fields 设置了 dir_size，那么该字段会返回，表示文件夹的统计信息', 'type' => 'object', 'properties' => [ - 'dir_count' => [ - 'title' => '文件夹数量', - 'description' => '该文件夹下所有子孙文件夹数量，递归计算。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'file_count' => [ - 'title' => '文件数量', - 'description' => '该文件夹下所有子孙文件数量，递归计算。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', - ], + 'dir_count' => ['title' => '文件夹数量', 'description' => '该文件夹下所有子孙文件夹数量，递归计算。', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'file_count' => ['title' => '文件数量', 'description' => '该文件夹下所有子孙文件数量，递归计算。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'], ], ], 'action_list' => [ 'title' => '权限列表', 'description' => '权限列表', 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], - ], - 'auto_delete_left_sec' => [ - 'title' => '回收站文件自动删除剩余时间', - 'description' => '回收站文件自动删除剩余时间', - 'type' => 'integer', - 'format' => 'int64', - ], - ], - ], - 'FileDownloadCallbackInfo' => [ - 'title' => '文件下载回调', - 'description' => '文件下载回调', - 'type' => 'object', - 'properties' => [ - 'bucket' => [ - 'title' => 'bucket名称', - 'type' => 'string', - 'required' => true, - 'example' => 'ccp-bj1-bj-1234', - ], - 'object' => [ - 'title' => 'oss key', - 'type' => 'string', - 'required' => true, - ], - 'httpHeader.range' => [ - 'title' => '下载范围', - 'type' => 'string', - 'example' => 'bytes=0-1024', - ], - 'domain_id' => [ - 'title' => 'domain id', - 'type' => 'string', - 'required' => true, - ], - 'user_id' => [ - 'title' => '用户id', - 'type' => 'string', - 'required' => true, - ], - 'drive_id' => [ - 'title' => 'drive id', - 'type' => 'string', - 'required' => true, - ], - 'file_id' => [ - 'title' => '文件id', - 'type' => 'string', - 'required' => true, - ], - ], - 'required' => false, - ], - 'FileIDInfo' => [ - 'title' => 'FileIDInfo', - 'type' => 'object', - 'properties' => [ - 'drive_id' => [ - 'title' => 'drive_id', - 'type' => 'string', - ], - 'file_id' => [ - 'title' => 'file_id', - 'type' => 'string', - ], - 'type' => [ - 'title' => 'type', - 'type' => 'string', - ], - ], - ], - 'FileLogDetail' => [ - 'title' => '文件日志详情', - 'description' => '文件日志详情', - 'type' => 'object', - 'properties' => [ - 'type' => [ - 'title' => '类型', - 'type' => 'string', - ], - 'parent_path' => [ - 'title' => '父目录路径', - 'type' => 'string', - ], - 'new_name' => [ - 'title' => '新文件名', - 'type' => 'string', - ], - 'to_parent_path_type' => [ - 'title' => '目标目录类型', - 'type' => 'string', - ], - 'to_parent_path' => [ - 'title' => '目标目录路径', - 'type' => 'string', - ], - 'size' => [ - 'title' => '大小', - 'type' => 'integer', - 'format' => 'int64', - ], - 'decompress_file_list' => [ - 'title' => '解压文件列表', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - 'example' => '解压文件', - ], - ], - 'rev_version' => [ - 'title' => '文件版本', - 'type' => 'integer', - 'format' => 'int64', - ], - 'revision_id' => [ - 'title' => '版本id', - 'type' => 'string', + 'items' => ['type' => 'string', 'description' => ''], ], + 'auto_delete_left_sec' => ['title' => '回收站文件自动删除剩余时间', 'description' => '回收站文件自动删除剩余时间', 'type' => 'integer', 'format' => 'int64'], ], ], 'FilePermissionMember' => [ 'title' => 'A short description of struct', 'description' => 'A short description of struct', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'identity' => [ - 'title' => '授权对象', - 'description' => '被授权对象，可以是用户或群组', - '$ref' => '#/components/schemas/Identity', - ], - 'role_id' => [ - 'title' => '授予的角色ID', - 'description' => '目前支持两种方式设置权限，一种是通过指定角色设置权限，另一种是自定义操作权限，此字段用于指定角色设置权限，与action\\_list互斥，当两个字段同时设置时，以此字段为准'."\n" - ."\n" - .'目前支持：'."\n" - ."\n" - .'SystemFileOwner（文件协同）'."\n" - ."\n" - .'SystemFileDownloader（下载者）'."\n" - ."\n" - .'SystemFileEditor（编辑者）'."\n" - ."\n" - .'SystemFileEditorWithoutDelete（无删除编辑者）'."\n" - ."\n" - .'SystemFileEditorWithoutShareLink（无分享编辑者）'."\n" - ."\n" - .'SystemFileMetaViewer（可见列表）'."\n" - ."\n" - .'SystemFileUploader（上传者）、SystemFileUploaderAndDownloader（上传/下载者）'."\n" - ."\n" - .'SystemFileDownloaderWithShareLink（下载/分享者）'."\n" - ."\n" - .'SystemFileUploaderAndDownloaderWithShareLink（上传/下载/分享者）'."\n" - ."\n" - .'SystemFileUploaderAndViewer（预览/上传者）'."\n" - ."\n" - .'SystemFileUploaderWithShareLink（上传/分享者）'."\n" - ."\n" - .'SystemFileViewer（预览者）', - 'type' => 'string', - 'example' => 'SystemFileDownloader', - ], - 'expire_time' => [ - 'title' => '过期时间', - 'description' => '此授权过期的时间， 从1970年1月1日0点到目标时间的毫秒数， 永久有效可以设置为系统预定义的一个值：4775500800000', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1633598085642', - ], - 'disinherit_sub_group' => [ - 'title' => '是否禁用子用户组继承此权限', - 'description' => '是否禁用子群组下的用户继承此权限，举个例子，比如有/group1/group2， user1在group1下， user2在group2下。给group1授权时，此字段设置为true，则只有user1有权限，user2没有权限', - 'type' => 'boolean', - 'example' => 'false', - ], + 'identity' => ['title' => '授权对象', 'description' => '被授权对象，可以是用户或群组', 'visibility' => 'Public', '$ref' => '#/components/schemas/Identity'], + 'role_id' => ['title' => '授予的角色ID', 'description' => '目前支持两种方式设置权限，一种是通过指定角色设置权限，另一种是自定义操作权限，此字段用于指定角色设置权限，与action\\_list互斥，当两个字段同时设置时，以此字段为准'."\n" + ."\n" + .'目前支持：'."\n" + ."\n" + .'SystemFileOwner（文件协同）'."\n" + ."\n" + .'SystemFileDownloader（下载者）'."\n" + ."\n" + .'SystemFileEditor（编辑者）'."\n" + ."\n" + .'SystemFileEditorWithoutDelete（无删除编辑者）'."\n" + ."\n" + .'SystemFileEditorWithoutShareLink（无分享编辑者）'."\n" + ."\n" + .'SystemFileMetaViewer（可见列表）'."\n" + ."\n" + .'SystemFileUploader（上传者）、SystemFileUploaderAndDownloader（上传/下载者）'."\n" + ."\n" + .'SystemFileDownloaderWithShareLink（下载/分享者）'."\n" + ."\n" + .'SystemFileUploaderAndDownloaderWithShareLink（上传/下载/分享者）'."\n" + ."\n" + .'SystemFileUploaderAndViewer（预览/上传者）'."\n" + ."\n" + .'SystemFileUploaderWithShareLink（上传/分享者）'."\n" + ."\n" + .'SystemFileViewer（预览者）', 'visibility' => 'Public', 'type' => 'string', 'example' => 'SystemFileDownloader'], + 'expire_time' => ['title' => '过期时间', 'description' => '此授权过期的时间， 从1970年1月1日0点到目标时间的毫秒数， 永久有效可以设置为系统预定义的一个值：4775500800000', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1633598085642'], + 'disinherit_sub_group' => ['title' => '是否禁用子用户组继承此权限', 'description' => '是否禁用子群组下的用户继承此权限，举个例子，比如有/group1/group2， user1在group1下， user2在group2下。给group1授权时，此字段设置为true，则只有user1有权限，user2没有权限', 'visibility' => 'Public', 'type' => 'boolean', 'example' => 'false'], 'action_list' => [ 'title' => '授予的操作权限列表', 'description' => '目前支持两种方式设置权限，一种是通过指定角色设置权限，另一种是自定义操作权限，此字段用于自定义操作权限，与role\\_id互斥，当两个字段同时设置时，以role\\_id字段为准，设置action\\_list字段时系统会自动生成一个临时role\\_id，取消授权可以通过临时role\\_id来取消', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - 'description' => "\n" - .'自定义操作权限：'."\n" - .'- FILE.VISIBLE: 可见'."\n" - .'- FILE.PREVIEW: 可预览'."\n" - .'- FILE.MOVE: 可移动'."\n" - .'- FILE.DELETE: 可删除'."\n" - .'- FILE.COPY: 可复制'."\n" - .'- FILE.CREATE: 可创建'."\n" - .'- FILE.DOWNLOAD: 可下载'."\n" - .'- FILE.SHARELINK: 可分享'."\n" - .'- FILE.UPDATE: 可更新'."\n" - .'- FILE.LIST: 可列举', - 'type' => 'string', - 'example' => 'FILE.CREATE', - ], + 'items' => ['description' => "\n" + .'自定义操作权限：'."\n" + .'- FILE.VISIBLE: 可见'."\n" + .'- FILE.PREVIEW: 可预览'."\n" + .'- FILE.MOVE: 可移动'."\n" + .'- FILE.DELETE: 可删除'."\n" + .'- FILE.COPY: 可复制'."\n" + .'- FILE.CREATE: 可创建'."\n" + .'- FILE.DOWNLOAD: 可下载'."\n" + .'- FILE.SHARELINK: 可分享'."\n" + .'- FILE.UPDATE: 可更新'."\n" + .'- FILE.LIST: 可列举', 'visibility' => 'Public', 'type' => 'string', 'example' => 'FILE.CREATE', 'extendType' => 'true'], 'required' => false, ], ], ], - 'FileStreamInfo' => [ - 'title' => 'A short description of struct', - 'description' => '文件流信息', - 'type' => 'object', - 'properties' => [ - 'size' => [ - 'title' => '大小', - 'type' => 'integer', - 'format' => 'int64', - ], - 'content_hash' => [ - 'title' => '内容hash', - 'type' => 'string', - ], - 'content_hash_name' => [ - 'title' => '内容hash名', - 'type' => 'string', - ], - 'proof_code' => [ - 'title' => '挑战码', - 'type' => 'string', - ], - 'proof_version' => [ - 'title' => '挑战算法版本', - 'type' => 'string', - ], - 'pre_hash' => [ - 'title' => '预秒传', - 'type' => 'string', - ], - 'content_md5' => [ - 'title' => '内容md5', - 'type' => 'string', - ], - 'part_info_list' => [ - 'title' => '分段信息', - 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/UploadPartInfo', - ], - ], - ], - ], - 'FileTaskResultResponse' => [ - 'title' => 'FileTaskResultResponse', - 'type' => 'object', - 'properties' => [ - 'src_file' => [ - 'title' => 'src file', - '$ref' => '#/components/schemas/FileIDInfo', - ], - 'rst_file' => [ - 'title' => 'rst_file', - '$ref' => '#/components/schemas/FileIDInfo', - ], - 'err_code' => [ - 'title' => 'err_code', - 'type' => 'string', - ], - 'message' => [ - 'title' => 'message', - 'type' => 'string', - ], - ], - ], - 'GetOfficeEditUrlOption' => [ - 'title' => 'A short description of struct', - 'description' => '文档编辑选项', - 'type' => 'object', - 'properties' => [ - 'copy' => [ - 'title' => '是否允许复制内容，不传递该参数默认允许复制', - 'type' => 'boolean', - ], - 'readonly' => [ - 'title' => '预览模式，不传递该参数默认是预览模式', - 'type' => 'boolean', - ], - 'print' => [ - 'title' => '是否允许打印内容，不传递该参数默认禁止打印', - 'type' => 'boolean', - ], - ], - ], - 'GetOfficeEditUrlWatermark' => [ - 'title' => 'A short description of struct', - 'description' => '在线编辑水印配置', - 'type' => 'object', - 'properties' => [ - 'type' => [ - 'title' => '水印类型。0：无水印，1：文字水印。', - 'type' => 'integer', - 'format' => 'int32', - ], - 'value' => [ - 'title' => '文字水印的文字。当WatermarkType设置为1时，才能设置此参数', - 'type' => 'string', - ], - 'fillstyle' => [ - 'title' => '文字水印的透明度，默认值为rgba(192,192,192,0.6)。', - 'type' => 'string', - ], - 'font' => [ - 'title' => '文字水印的字体，默认值为bold 20px Serif', - 'type' => 'string', - ], - 'rotate' => [ - 'title' => '文字水印的旋转度，单位为弧度。', - 'type' => 'number', - 'format' => 'double', - ], - 'horizontal' => [ - 'title' => '文字水印水平间距，单位为px。', - 'type' => 'integer', - 'format' => 'int64', - ], - 'vertical' => [ - 'title' => '文字水印垂直间距，单位为px。', - 'type' => 'integer', - 'format' => 'int64', - ], - ], - ], - 'GetOfficePreviewUrlOption' => [ - 'title' => 'A short description of struct', - 'description' => '文档预览控制选项', - 'type' => 'object', - 'properties' => [ - 'copy' => [ - 'title' => '是否允许复制内容，不传递该参数默认允许复制', - 'type' => 'boolean', - ], - 'print' => [ - 'title' => '是否允许打印内容，不传递该参数默认禁止打印', - 'type' => 'boolean', - ], - ], - ], 'Group' => [ 'title' => 'A short description of struct', 'description' => 'group', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'title' => '域ID', - 'description' => '域ID', - 'type' => 'string', - 'example' => 'bj1', - ], - 'group_id' => [ - 'title' => '用户组ID', - 'description' => '群组ID', - 'type' => 'string', - 'example' => 'b45c0c0c373c41ec9ebb5c85a025a08f', - ], - 'group_name' => [ - 'title' => '用户组名', - 'description' => '群组名称', - 'type' => 'string', - 'example' => 'test group', - ], - 'description' => [ - 'title' => '描述', - 'description' => '描述', - 'type' => 'string', - 'example' => 'created by system', - ], - 'created_at' => [ - 'title' => '创建时间', - 'description' => '创建时间，从1970年1月1日0点到当前的毫秒时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1670573504600', - ], - 'updated_at' => [ - 'title' => '更新时间', - 'description' => '更新时间，从1970年1月1日0点到当前的毫秒时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1670573504600', - ], - 'creator' => [ - 'title' => '创建者', - 'description' => '创建者ID', - 'type' => 'string', - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - ], - ], - ], - 'HotDriveFile' => [ - 'title' => '空间热门文件', - 'type' => 'object', - 'properties' => [ - 'drive_id' => [ - 'title' => '空间id', - 'type' => 'string', - 'example' => '1', - ], - 'file_id' => [ - 'title' => '文件id', - 'type' => 'string', - 'example' => '666ff36c22278f023ec', - ], - 'revision_id' => [ - 'title' => '文件版本id', - 'type' => 'string', - 'example' => '666ff36c22278f023ec', - ], - 'name' => [ - 'title' => '文件名', - 'type' => 'string', - 'example' => 'a.jpg', - ], - 'category' => [ - 'title' => '文件类型', - 'type' => 'string', - 'example' => 'doc', - ], - 'action_count' => [ - 'title' => '操作次数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2', - ], - 'count_at' => [ - 'title' => '统计毫秒时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1727059860000', - ], - 'action_list' => [ - 'title' => '空间文件权限列表', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - 'example' => 'FILE.GET', - ], - ], - ], - ], - 'HotKnowledgeBaseFile' => [ - 'title' => '知识库热门文件', - 'description' => '热门知识库文件', - 'type' => 'object', - 'properties' => [ - 'drive_id' => [ - 'title' => '空间id', - 'type' => 'string', - 'example' => '1', - ], - 'file_id' => [ - 'title' => '文件id', - 'type' => 'string', - 'example' => '666ff36c22278f023ec', - ], - 'revision_id' => [ - 'title' => '文件版本id', - 'type' => 'string', - 'example' => '666ff36c22278f023ec', - ], - 'knowledge_base_id' => [ - 'title' => '知识库id', - 'type' => 'string', - 'example' => '4jTsp3AgW', - ], - 'name' => [ - 'title' => '文件名', - 'type' => 'string', - 'example' => 'a.jpg', - ], - 'category' => [ - 'title' => '文件类型', - 'type' => 'string', - 'example' => 'image', - ], - 'action_count' => [ - 'title' => '操作次数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'count_at' => [ - 'title' => '统计毫秒时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1727578860000', - ], - 'action_list' => [ - 'title' => '知识库文件的权限列表', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - 'example' => 'KNOWLEDGEBASEFILE.GET', - ], - ], - ], - ], - 'IDPermission' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'permission' => [ - '$ref' => '#/components/schemas/Permission', - ], - 'disinherit_sub_group' => [ - 'title' => 'DisinheritSubGroup', - 'type' => 'boolean', - ], - 'expire_time' => [ - 'title' => 'ExpireTime', - 'type' => 'integer', - 'format' => 'int64', - ], - 'roles' => [ - 'title' => 'Roles', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], - ], + 'domain_id' => ['title' => '域ID', 'description' => '域ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'bj1'], + 'group_id' => ['title' => '用户组ID', 'description' => '群组ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'b45c0c0c373c41ec9ebb5c85a025a08f'], + 'group_name' => ['title' => '用户组名', 'description' => '群组名称', 'visibility' => 'Public', 'type' => 'string', 'example' => 'test group'], + 'description' => ['title' => '描述', 'description' => '描述', 'visibility' => 'Public', 'type' => 'string', 'example' => 'created by system'], + 'created_at' => ['title' => '创建时间', 'description' => '创建时间，从1970年1月1日0点到当前的毫秒时间戳', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1670573504600'], + 'updated_at' => ['title' => '更新时间', 'description' => '更新时间，从1970年1月1日0点到当前的毫秒时间戳', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1670573504600'], + 'creator' => ['title' => '创建者', 'description' => '创建者ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4'], + 'is_sync' => ['title' => '是否为同步团队', 'description' => '是否为同步团队', 'visibility' => 'Private', 'type' => 'boolean'], ], ], 'Identity' => [ 'title' => 'A short description of struct', 'description' => '可授权对象，表示一个用户或者一个群组', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'identity_type' => [ - 'title' => '类型', - 'description' => '对象类型'."\n" - .'- IT_User：表示用户类型'."\n" - .'- IT_Group：表示群组类型', - 'type' => 'string', - 'example' => 'IT_User', - ], - 'identity_id' => [ - 'title' => 'ID', - 'description' => '用户ID或者群组ID', - 'type' => 'string', - 'example' => '16435bdf934248b788b7b3771ee9a3dw', - ], + 'identity_type' => ['title' => '类型', 'description' => '对象类型'."\n" + .'- IT_User：表示用户类型'."\n" + .'- IT_Group：表示群组类型', 'visibility' => 'Public', 'type' => 'string', 'example' => 'IT_User'], + 'identity_id' => ['title' => 'ID', 'description' => '用户ID或者群组ID', 'visibility' => 'Public', 'type' => 'string', 'example' => '16435bdf934248b788b7b3771ee9a3dw'], ], ], 'IdentityToBenefitPkgMapping' => [ 'title' => 'A short description of struct', 'description' => '实体的权益包关联信息', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'identity_type' => [ - 'title' => '实体的类型', - 'description' => '实体的类型', - 'type' => 'string', - 'example' => 'user', - ], - 'identity_id' => [ - 'title' => '实体的唯一标识', - 'description' => '实体的标识ID', - 'type' => 'string', - 'example' => 'user123', - ], - 'benefit_pkg_owner_id' => [ - 'title' => '权益包的所有者ID', - 'description' => '权益包的所有者ID', - 'type' => 'string', - 'example' => 'bj1', - ], - 'benefit_pkg_id' => [ - 'title' => '权益包的唯一标识', - 'description' => '权益包的标识ID', - 'type' => 'string', - 'example' => '40cb7794c9294', - ], - 'benefit_pkg_type' => [ - 'title' => '权益包的类型', - 'description' => '权益包的类型'."\n" - ."\n" - .'有效值：'."\n" - ."\n" - .'user_identity：用户等级权益包'."\n" - ."\n" - .'user_resource：用户资源权益包', - 'type' => 'string', - 'example' => 'user_identity', - ], - 'benefit_pkg_name' => [ - 'title' => '权益包的名称', - 'description' => '权益包的名称', - 'type' => 'string', - 'example' => '高级会员', - ], - 'benefit_pkg_priority' => [ - 'title' => '权益包的优先级', - 'description' => '权益包的优先级'."\n" - ."\n" - .'用户等级权益包返回的优先级，数字越小，优先级越高。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'benefit_pkg_computation_rule' => [ - 'title' => '权益包内权益的计算规则', - 'description' => '权益包内权益的计算规则'."\n" - ."\n" - .'用户等级权益包，返回为空，只根据优先级priority计算生效权益的quota。'."\n" - ."\n" - .'用户资源权益包，可以返回空值或非空值。返回非空时，该权益包用于追加计算其它权益包中已存在权益的配额，限于quota型权益。如：一个用户等级权益包中已经包含10G用户存储容量，可以再定义一个或多个用户资源权益包，用于给某些用户增加额外的存储容量。'."\n" - ."\n" - .'支持的追加计算规则包括：'."\n" - ."\n" - .'sum：多个权益包中有相同权益，进行累加'."\n" - ."\n" - .'max：多个权益包中有相同权益，取max值'."\n" - ."\n" - .'min：多个权益包中有相同权益，取min值', - 'type' => 'string', - 'example' => 'sum', - ], + 'identity_type' => ['title' => '实体的类型', 'description' => '实体的类型', 'visibility' => 'Public', 'type' => 'string', 'example' => 'user'], + 'identity_id' => ['title' => '实体的唯一标识', 'description' => '实体的标识ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'user123'], + 'benefit_pkg_owner_id' => ['title' => '权益包的所有者ID', 'description' => '权益包的所有者ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'bj1'], + 'benefit_pkg_id' => ['title' => '权益包的唯一标识', 'description' => '权益包的标识ID', 'visibility' => 'Public', 'type' => 'string', 'example' => '40cb7794c9294'], + 'benefit_pkg_type' => ['title' => '权益包的类型', 'description' => '权益包的类型'."\n" + ."\n" + .'有效值：'."\n" + ."\n" + .'user_identity：用户等级权益包'."\n" + ."\n" + .'user_resource：用户资源权益包', 'visibility' => 'Public', 'type' => 'string', 'example' => 'user_identity'], + 'benefit_pkg_name' => ['title' => '权益包的名称', 'description' => '权益包的名称', 'visibility' => 'Public', 'type' => 'string', 'example' => '高级会员'], + 'benefit_pkg_priority' => ['title' => '权益包的优先级', 'description' => '权益包的优先级'."\n" + ."\n" + .'用户等级权益包返回的优先级，数字越小，优先级越高。', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'benefit_pkg_computation_rule' => ['title' => '权益包内权益的计算规则', 'description' => '权益包内权益的计算规则'."\n" + ."\n" + .'用户等级权益包，返回为空，只根据优先级priority计算生效权益的quota。'."\n" + ."\n" + .'用户资源权益包，可以返回空值或非空值。返回非空时，该权益包用于追加计算其它权益包中已存在权益的配额，限于quota型权益。如：一个用户等级权益包中已经包含10G用户存储容量，可以再定义一个或多个用户资源权益包，用于给某些用户增加额外的存储容量。'."\n" + ."\n" + .'支持的追加计算规则包括：'."\n" + ."\n" + .'sum：多个权益包中有相同权益，进行累加'."\n" + ."\n" + .'max：多个权益包中有相同权益，取max值'."\n" + ."\n" + .'min：多个权益包中有相同权益，取min值', 'visibility' => 'Public', 'type' => 'string', 'example' => 'sum'], 'delivery_info_list' => [ 'title' => '权益包的下发信息', 'description' => '权益包的下发信息列表', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/BenefitPkgDeliveryInfo', - ], - ], - 'created_at' => [ - 'title' => '实体权益包关联的创建时间', - 'description' => '实体和权益包关联的创建时间', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'updated_at' => [ - 'title' => '实体权益包关联的更新时间', - 'description' => '实体和权益包关联的更新时间', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', + 'items' => ['visibility' => 'Public', 'extendType' => 'true', '$ref' => '#/components/schemas/BenefitPkgDeliveryInfo'], ], + 'created_at' => ['title' => '实体权益包关联的创建时间', 'description' => '实体和权益包关联的创建时间', 'visibility' => 'Public', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'updated_at' => ['title' => '实体权益包关联的更新时间', 'description' => '实体和权益包关联的更新时间', 'visibility' => 'Public', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], ], ], 'ImageMediaMetadata' => [ 'title' => '图片信息。仅开启增值服务图片处理功能有效。', 'description' => '图片元数据。仅当开启增值服务图片处理功能有效。', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'time' => [ - 'title' => '拍摄时间，RFC3339 格式。', - 'description' => '拍摄时间，RFC3339 格式。', - 'type' => 'string', - 'example' => '2006-01-02T15:04:05.000Z07:00', - ], - 'width' => [ - 'title' => '图片宽度，单位为像素（px）。', - 'description' => '宽度，单位为像素。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1024', - ], - 'height' => [ - 'title' => '图片高度，单位为像素（px）。', - 'description' => '高度，单位为像素。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1024', - ], - 'location' => [ - 'title' => 'GPS 经纬度信息。', - 'description' => '地理经纬度信息。', - 'type' => 'string', - 'example' => '30.185453,120.218522', - ], + 'time' => ['title' => '拍摄时间，RFC3339 格式。', 'description' => '拍摄时间，RFC3339 格式。', 'visibility' => 'Public', 'type' => 'string', 'example' => '2006-01-02T15:04:05.000Z07:00'], + 'width' => ['title' => '图片宽度，单位为像素（px）。', 'description' => '宽度，单位为像素。', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1024'], + 'height' => ['title' => '图片高度，单位为像素（px）。', 'description' => '高度，单位为像素。', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1024'], + 'location' => ['title' => 'GPS 经纬度信息。', 'description' => '地理经纬度信息。', 'visibility' => 'Public', 'type' => 'string', 'example' => '30.185453,120.218522'], 'country' => [ 'title' => '国家或地区。', 'description' => '国家或地区。', + 'visibility' => 'Public', 'type' => 'string', 'enumValueTitles' => [], 'example' => 'China', ], - 'province' => [ - 'title' => '省。', - 'description' => '省。', - 'type' => 'string', - 'example' => 'Zhejiang', - ], - 'city' => [ - 'title' => '城市。', - 'description' => '城市。', - 'type' => 'string', - 'example' => 'Hangzhou', - ], - 'district' => [ - 'title' => '区。', - 'description' => '区。', - 'type' => 'string', - 'example' => 'Xihu', - ], - 'township' => [ - 'title' => '街道。', - 'description' => '街道。', - 'type' => 'string', - 'example' => 'Xihu', - ], - 'address_line' => [ - 'title' => '完整地址。', - 'description' => '完整地址。', - 'type' => 'string', - 'example' => 'Zhejiang hangzhou xihu', - ], + 'province' => ['title' => '省。', 'description' => '省。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Zhejiang'], + 'city' => ['title' => '城市。', 'description' => '城市。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Hangzhou'], + 'district' => ['title' => '区。', 'description' => '区。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Xihu'], + 'township' => ['title' => '街道。', 'description' => '街道。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Xihu'], + 'address_line' => ['title' => '完整地址。', 'description' => '完整地址。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Zhejiang hangzhou xihu'], 'image_tags' => [ 'title' => '图片标签详情列表', 'description' => '图片标签详情列表', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - 'description' => '系统标签（该数据结构将于2025年2月20日起停止透出）', - '$ref' => '#/components/schemas/SystemTag', - ], + 'items' => ['description' => '系统标签（该数据结构将于2025年2月20日起停止透出）', 'visibility' => 'Public', 'extendType' => 'true', '$ref' => '#/components/schemas/SystemTag'], ], + 'faces' => ['title' => '图片中包含的人脸列表。', 'description' => '图片中包含的人脸列表。', 'visibility' => 'Private', 'type' => 'string', 'deprecated' => true, 'example' => '[{"FaceId":"a9a66a86-73dd-4c95-8b79-1d8a49db5226","GroupId":"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0","FaceConfidence":0.999,"Age":13,"AgeConfidence":4,"Gender":"female","GenderConfidence":1,"Emotion":"none","EmotionConfidence":0.672,"FaceAttributes":{"Mask":"none","MaskConfidence":0.894,"Beard":"none","BeardConfidence":0.997,"Glasses":"none","GlassesConfidence":0.999,"Mouth":"close","MouthConfidence":0.937,"Hat":"none","HatConfidence":0.998,"HeadPose":{"Pitch":10.684,"Roll":-10.707,"Yaw":-20.094},"FaceBoundary":{"Width":457,"Height":687,"Top":1324,"Left":1356}}}]'], 'faces_thumbnail' => [ 'title' => '人脸缩略图列表。', 'description' => '人脸缩略图列表。', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - 'description' => '人脸缩略图', - '$ref' => '#/components/schemas/FaceThumbnail', - ], - ], - 'exif' => [ - 'title' => '图片EXIF信息。', - 'description' => '图片EXIF信息。', - 'type' => 'string', - 'example' => '{"Compression":{"value":"6"},"DateTime":{"value":"2020:08:19 17:11:11"}}', - ], - 'image_quality' => [ - 'title' => '图片评分信息。', - 'description' => '图片评分信息。', - '$ref' => '#/components/schemas/ImageQuality', + 'items' => ['description' => '人脸缩略图', 'visibility' => 'Public', 'extendType' => 'true', '$ref' => '#/components/schemas/FaceThumbnail'], ], + 'exif' => ['title' => '图片EXIF信息。', 'description' => '图片EXIF信息。', 'visibility' => 'Public', 'type' => 'string', 'example' => '{"Compression":{"value":"6"},"DateTime":{"value":"2020:08:19 17:11:11"}}'], + 'image_quality' => ['title' => '图片评分信息。', 'description' => '图片评分信息。', 'visibility' => 'Public', '$ref' => '#/components/schemas/ImageQuality'], ], ], 'ImageProcess' => [ @@ -3811,24 +651,9 @@ 'description' => '图片处理规则', 'type' => 'object', 'properties' => [ - 'image_thumbnail_process' => [ - 'title' => '图片类型文件的缩略图规则', - 'description' => '图片类型文件的缩略图规则，参考OSS的图片处理规则。默认为：image/resize,m\\_fill,h\\_128,w\\_128,limit\\_0', - 'type' => 'string', - 'example' => 'image/resize,m_fill,h_128,w_128,limit_0', - ], - 'video_thumbnail_process' => [ - 'title' => '视频类型文件的缩略图规则', - 'description' => '视频类型文件的缩略图规则，参考OSS的视频截帧处理规则。默认为：video/snapshot,t\\_1000,f\\_jpg,w\\_0,h\\_0,m\\_fast,ar\\_auto', - 'type' => 'string', - 'example' => 'video/snapshot,t_1000,f_jpg,w_0,h_0,m_fast,ar_auto', - ], - 'office_thumbnail_process' => [ - 'title' => '文档类型文件的缩略图规则', - 'description' => '文档类型文件的缩略图规则，文档类型的文件会选择文档中一页的截图作为原图，此参数是基于该截图来做处理。默认为：image/resize,m\\_fill,h\\_128,w\\_128,limit\\_0', - 'type' => 'string', - 'example' => 'image/resize,m_fill,h_128,w_128,limit_0', - ], + 'image_thumbnail_process' => ['title' => '图片类型文件的缩略图规则', 'description' => '图片类型文件的缩略图规则，参考OSS的图片处理规则。默认为：image/resize,m\\_fill,h\\_128,w\\_128,limit\\_0', 'type' => 'string', 'example' => 'image/resize,m_fill,h_128,w_128,limit_0'], + 'video_thumbnail_process' => ['title' => '视频类型文件的缩略图规则', 'description' => '视频类型文件的缩略图规则，参考OSS的视频截帧处理规则。默认为：video/snapshot,t\\_1000,f\\_jpg,w\\_0,h\\_0,m\\_fast,ar\\_auto', 'type' => 'string', 'example' => 'video/snapshot,t_1000,f_jpg,w_0,h_0,m_fast,ar_auto'], + 'office_thumbnail_process' => ['title' => '文档类型文件的缩略图规则', 'description' => '文档类型文件的缩略图规则，文档类型的文件会选择文档中一页的截图作为原图，此参数是基于该截图来做处理。默认为：image/resize,m\\_fill,h\\_128,w\\_128,limit\\_0', 'type' => 'string', 'example' => 'image/resize,m_fill,h_128,w_128,limit_0'], ], ], 'ImageQuality' => [ @@ -3836,701 +661,132 @@ 'description' => '图片评分详情。仅开启增值服务图片处理功能有效。', 'type' => 'object', 'properties' => [ - 'overall_score' => [ - 'title' => '图片整体质量评分。该评分为 AI 自动评估，主要以主观美学为准，受到构图、亮度、对比度、色彩、清晰度等多方面因素影响。 范围 0-1，越高则质量越好。', - 'description' => '图片整体质量评分。该评分为 AI 自动评估，主要以主观美学为准，受到构图、亮度、对比度、色彩、清晰度等多方面因素影响。 范围 0-1，评分越高则质量越好。', - 'type' => 'number', - 'format' => 'double', - 'example' => '0.736', - ], + 'overall_score' => ['title' => '图片整体质量评分。该评分为 AI 自动评估，主要以主观美学为准，受到构图、亮度、对比度、色彩、清晰度等多方面因素影响。 范围 0-1，越高则质量越好。', 'description' => '图片整体质量评分。该评分为 AI 自动评估，主要以主观美学为准，受到构图、亮度、对比度、色彩、清晰度等多方面因素影响。 范围 0-1，评分越高则质量越好。', 'type' => 'number', 'format' => 'double', 'example' => '0.736'], ], ], 'ImageTag' => [ 'title' => '标签信息', 'description' => '标签信息', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'name' => [ - 'title' => '名称', - 'description' => '名称', - 'type' => 'string', - 'example' => '动物', - ], - 'count' => [ - 'title' => '数量', - 'description' => '分组内文件数量', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'cover_url' => [ - 'title' => '标签封面图片地址', - 'description' => '标签封面图片地址', - 'type' => 'string', - 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx', - ], - 'cover_file_id' => [ - 'title' => '封面文件id', - 'description' => '封面文件id', - 'type' => 'string', - 'example' => '5d79206586bb5dd69fb34c349282718146c55da7', - ], - 'cover_file_category' => [ - 'title' => '封面文件分类', - 'description' => '封面文件分类', - 'type' => 'string', - 'example' => 'image', - ], - 'cover_tag_confidence' => [ - 'title' => '封面标签置信度。取值范围为 0（表示置信度最低）~1（表示置信度最高）。', - 'description' => '封面标签置信度', - 'type' => 'number', - 'format' => 'float', - 'example' => '1', - ], - 'cover_overall_score' => [ - 'title' => '封面评分。该评分为 AI 自动评估，主要以主观美学为准，受到构图、亮度、对比度、色彩、清晰度等多方面因素影响。 范围 0-1，越高则质量越好。', - 'description' => '封面评分', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.736', - ], - ], - ], - 'Int64Range' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'from' => [ - 'title' => '起始', - 'type' => 'integer', - 'format' => 'int64', - ], - 'to' => [ - 'title' => '结束', - 'type' => 'integer', - 'format' => 'int64', - ], + 'name' => ['title' => '名称', 'description' => '名称', 'visibility' => 'Public', 'type' => 'string', 'example' => '动物'], + 'count' => ['title' => '数量', 'description' => '分组内文件数量', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'cover_url' => ['title' => '标签封面图片地址', 'description' => '标签封面图片地址', 'visibility' => 'Public', 'type' => 'string', 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx'], + 'cover_file_id' => ['title' => '封面文件id', 'description' => '封面文件id', 'visibility' => 'Public', 'type' => 'string', 'example' => '5d79206586bb5dd69fb34c349282718146c55da7'], + 'cover_file_category' => ['title' => '封面文件分类', 'description' => '封面文件分类', 'visibility' => 'Public', 'type' => 'string', 'example' => 'image'], + 'cover_tag_confidence' => ['title' => '封面标签置信度。取值范围为 0（表示置信度最低）~1（表示置信度最高）。', 'description' => '封面标签置信度', 'visibility' => 'Public', 'type' => 'number', 'format' => 'float', 'example' => '1'], + 'cover_overall_score' => ['title' => '封面评分。该评分为 AI 自动评估，主要以主观美学为准，受到构图、亮度、对比度、色彩、清晰度等多方面因素影响。 范围 0-1，越高则质量越好。', 'description' => '封面评分', 'visibility' => 'Public', 'type' => 'number', 'format' => 'float', 'example' => '0.736'], ], ], 'InvestigationInfo' => [ 'title' => 'A short description of struct', 'description' => 'A short description of struct', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'status' => [ 'title' => '审核状态', 'description' => '审核状态', + 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', - 'enumValueTitles' => [ - '未审核', - '不支持审核', - '审核失败', - '审核中', - '审核成功', - '被处罚接口调用', - ], + 'enumValueTitles' => ['未审核', '不支持审核', '审核失败', '审核中', '审核成功', '被处罚接口调用'], 'example' => '4', ], 'suggestion' => [ 'title' => '审核建议执行的操作', 'description' => '审核建议执行的操作', + 'visibility' => 'Public', 'type' => 'string', - 'enumValueTitles' => [ - 'pass' => '结果正常', - 'block' => '结果违规，建议进行限制', - ], + 'enumValueTitles' => ['pass' => '结果正常', 'block' => '结果违规，建议进行限制'], 'example' => 'block', ], 'video_detail' => [ 'title' => '视频审核信息', 'description' => '视频审核信息', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'block_frames' => [ 'title' => '违规帧信息', 'description' => '违规帧信息', + 'visibility' => 'Public', 'type' => 'array', 'items' => [ + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'rate' => [ - 'title' => '置信度', - 'description' => '置信度。取值范围0～100。', - 'type' => 'number', - 'format' => 'double', - 'example' => '99.1', - ], - 'offset' => [ - 'title' => '截帧距离片头的时间（秒）', - 'description' => '截帧距离片头的时间（秒）', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '3', - ], - 'label' => [ - 'title' => '检测结果分类', - 'description' => '检测结果分类', - 'type' => 'string', - 'example' => 'porn', - ], + 'rate' => ['title' => '置信度', 'description' => '置信度。取值范围0～100。', 'visibility' => 'Public', 'type' => 'number', 'format' => 'double', 'example' => '99.1'], + 'offset' => ['title' => '截帧距离片头的时间（秒）', 'description' => '截帧距离片头的时间（秒）', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '3'], + 'label' => ['title' => '检测结果分类', 'description' => '检测结果分类', 'visibility' => 'Public', 'type' => 'string', 'example' => 'porn'], ], + 'extendType' => 'true', ], ], ], ], ], ], - 'JWTPayload' => [ - 'type' => 'object', - 'properties' => [ - 'auto_create' => [ - 'title' => '扩展字段，是否自动创建用户', - 'type' => 'boolean', - ], - 'sub_type' => [ - 'title' => '扩展字段，表示账号类型，目前支持填 user、service，此处填user，则sub为userID，签发普通用户accessToken。 此处填service，则sub为domainID，签发domain服务账号accessToken(超级管理员权限)', - 'type' => 'string', - ], - 'iss' => [ - 'title' => '控制台申请的JWT App ID', - 'type' => 'string', - ], - 'sub' => [ - 'title' => '待授权的UserID或者DomainID', - 'type' => 'string', - ], - 'aud' => [ - 'title' => 'DomainID', - 'type' => 'string', - ], - 'jti' => [ - 'title' => '应用生成JWT的唯一标识，长度16-128位，推荐使用uuid即可', - 'type' => 'string', - ], - 'exp' => [ - 'title' => 'JWT过期时间, Unix Time，单位秒，生效时间和过期时间不能超过15分钟。为防止客户端和服务器时间不一致，此时间建议设置为当前时间加5分钟。', - 'type' => 'integer', - 'format' => 'int64', - ], - 'iat' => [ - 'title' => '签发时间，Unix Time，单位秒，在此时间之前无法使用，如：1577682075', - 'type' => 'integer', - 'format' => 'int64', - ], - 'nbf' => [ - 'title' => '生效时间，Unix Time，单位秒，不指定则默认为当前时间。生效时间和过期时间不能超过15分钟。 为防止客户端和服务器时间不一致，此时间建议设置为当前时间减5分钟，或者不设置。', - 'type' => 'integer', - 'format' => 'int64', - ], - ], - ], - 'KnowledgeBase' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'knowledge_base_id' => [ - 'title' => '知识库ID', - 'type' => 'string', - ], - 'owner_type' => [ - 'title' => '1', - 'type' => 'string', - ], - 'owner_id' => [ - 'title' => '1', - 'type' => 'string', - ], - 'owner_name' => [ - 'title' => '1', - 'type' => 'string', - ], - 'name' => [ - 'title' => '1', - 'type' => 'string', - ], - 'cover_uri' => [ - 'title' => '1', - 'type' => 'string', - ], - 'description' => [ - 'title' => '1', - 'type' => 'string', - ], - 'updated_at' => [ - 'title' => '1', - 'type' => 'integer', - 'format' => 'int64', - ], - 'created_at' => [ - 'title' => '1', - 'type' => 'integer', - 'format' => 'int64', - ], - 'file_filter' => [ - 'title' => '1', - 'type' => 'string', - ], - 'link_rule_list' => [ - 'title' => '1', - 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/LinkRule', - ], - 'required' => false, - ], - ], - ], - 'KnowledgeCategory' => [ - 'title' => '知识分类', - 'type' => 'object', - 'properties' => [ - 'knowledge_base_id' => [ - 'title' => '知识库id', - 'type' => 'string', - ], - 'knowledge_base_name' => [ - 'title' => '知识库名称', - 'type' => 'string', - ], - 'parent_knowledge_category_id' => [ - 'title' => '父知识分类id', - 'type' => 'string', - ], - 'knowledge_category_id' => [ - 'title' => '知识分类id', - 'type' => 'string', - ], - 'name' => [ - 'title' => '名称', - 'type' => 'string', - ], - 'description' => [ - 'title' => '描述', - 'type' => 'string', - ], - 'keywords' => [ - 'title' => '关键词列表', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], - ], - 'owner' => [ - 'title' => '所有者', - 'type' => 'string', - ], - 'owner_type' => [ - 'title' => '所有者类型', - 'type' => 'string', - ], - 'status' => [ - 'title' => '状态', - 'type' => 'string', - ], - 'created_at' => [ - 'title' => '创建时间', - 'type' => 'integer', - 'format' => 'int64', - ], - 'updated_at' => [ - 'title' => '更新时间', - 'type' => 'integer', - 'format' => 'int64', - ], - ], - ], 'KnowledgeFile' => [ 'title' => 'A short description of struct', 'type' => 'object', 'properties' => [ - 'knowledge_base_id' => [ - 'title' => '知识库 ID', - 'type' => 'string', - ], - 'knowledge_category_id' => [ - 'title' => '知识分类 ID', - 'type' => 'string', - ], - 'drive_id' => [ - 'title' => '云盘 ID', - 'type' => 'string', - ], - 'file_id' => [ - 'title' => '文件 ID', - 'type' => 'string', - ], - 'revision_id' => [ - 'title' => '文件版本 ID', - 'type' => 'string', - ], - 'joined_at' => [ - 'title' => '文件加入知识库/知识分类的毫秒级时间戳', - 'type' => 'integer', - 'format' => 'int64', - ], - 'creator_id' => [ - 'title' => '文件加入知识库/知识分类的操作者 ID', - 'type' => 'string', - ], - 'file_image_time' => [ - 'title' => '图片文件的拍摄时间', - 'type' => 'integer', - 'format' => 'int64', - ], - 'file_created_at' => [ - 'title' => '文件的毫秒级创建时间戳', - 'type' => 'integer', - 'format' => 'int64', - ], - 'file_updated_at' => [ - 'title' => '文件的毫秒级更新时间戳', - 'type' => 'integer', - 'format' => 'int64', - ], - 'file_creator_id' => [ - 'title' => '文件的创建者 ID', - 'type' => 'string', - ], - 'file_size' => [ - 'title' => '文件大小', - 'type' => 'integer', - 'format' => 'int64', - ], - 'file_category' => [ - 'title' => '文件类别', - 'type' => 'string', - ], - 'file_name' => [ - 'title' => '文件名', - 'type' => 'string', - ], - 'file_name_path' => [ - 'title' => '文件名路径', - 'type' => 'string', - ], - 'file_last_modifier_id' => [ - 'title' => '文件最后的修改者 ID', - 'type' => 'string', - ], - 'file_last_modifier_type' => [ - 'title' => '文件最后的修改者类型', - 'type' => 'string', - ], - 'drive_name' => [ - 'title' => '云盘名称', - 'type' => 'string', - ], - ], - ], - 'KnowledgeFileItem' => [ - 'title' => '知识文件相关接口入参实体', - 'type' => 'object', - 'properties' => [ - 'drive_id' => [ - 'title' => '空间 ID', - 'type' => 'string', - 'required' => true, - ], - 'file_id' => [ - 'title' => '文件 ID', - 'type' => 'string', - 'required' => true, - ], - ], - ], - 'LinkInfo' => [ - 'title' => 'A short description of struct', - 'description' => '用户登录信息', - 'type' => 'object', - 'properties' => [ - 'type' => [ - 'title' => '当前用户已存在的登录方式', - 'type' => 'string', - ], - 'identity' => [ - 'title' => '当前用户已存在的登录标识', - 'type' => 'string', - ], - 'extra' => [ - 'title' => '额外的信息，比如type为mobile时，此字段为国家编号，不填默认86', - 'type' => 'string', - ], - ], - ], - 'LinkRule' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'src_file_id' => [ - 'title' => '1', - 'type' => 'string', - ], - 'src_drive_id' => [ - 'title' => '1', - 'type' => 'string', - ], - 'link_type' => [ - 'title' => '1', - 'type' => 'string', - ], - 'src_file_name' => [ - 'title' => '文件名', - 'type' => 'string', - ], - 'src_drive_name' => [ - 'title' => 'drive名', - 'type' => 'string', - ], - 'src_valid' => [ - 'title' => '1', - 'type' => 'boolean', - ], - ], - ], - 'LocationDateCluster' => [ - 'title' => '时空聚类详情', - 'type' => 'object', - 'properties' => [ - 'drive_id' => [ - 'title' => '空间 id。', - 'type' => 'string', - ], - 'cluster_id' => [ - 'title' => '聚类 id。', - 'type' => 'string', - ], - 'title' => [ - 'title' => '聚类标题。', - 'type' => 'string', - ], - 'level' => [ - 'title' => '聚类的行政级别。', - 'type' => 'string', - 'enum' => [ - 'country', - 'province', - 'city', - 'district', - 'township', - ], - ], - 'address' => [ - 'title' => '地址信息。', - '$ref' => '#/components/schemas/Address', - ], - 'start_time' => [ - 'title' => '聚类开始时间。RFC3339。', - 'type' => 'string', - ], - 'end_time' => [ - 'title' => '聚类结束时间。RFC3339。', - 'type' => 'string', - ], - 'created_at' => [ - 'title' => '聚类创建时间。RFC3339。', - 'type' => 'string', - ], - 'updated_at' => [ - 'title' => '聚类更新时间。RFC3339。', - 'type' => 'string', - ], - 'custom_labels' => [ - 'title' => '自定义标签。', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - ], - ], - ], - ], - 'MediaPlayInfoTemplate' => [ - 'title' => 'A short description of struct', - 'description' => '多媒体播放模版', - 'type' => 'object', - 'properties' => [ - 'template_id' => [ - 'title' => '模板id', - 'type' => 'string', - ], - 'status' => [ - 'title' => '状态', - 'type' => 'string', - ], - 'url' => [ - 'title' => '播放地址', - 'type' => 'string', - ], - ], - ], - 'Membership' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'domain_id' => [ - 'title' => '域id', - 'type' => 'string', - ], - 'group_id' => [ - 'title' => '组id', - 'type' => 'string', - ], - 'sub_group_id' => [ - 'title' => '子组id', - 'type' => 'string', - ], - 'user_id' => [ - 'title' => '用户id', - 'type' => 'string', - ], - 'member_type' => [ - 'title' => '成员类型', - 'type' => 'string', - ], - 'member_role' => [ - 'title' => '成员角色', - 'type' => 'string', - ], - 'description' => [ - 'title' => '描述', - 'type' => 'string', - ], - 'created_at' => [ - 'title' => '创建时间', - 'type' => 'integer', - 'format' => 'int64', - ], - 'updated_at' => [ - 'title' => '更新时间', - 'type' => 'integer', - 'format' => 'int64', - ], - 'creator' => [ - 'title' => '创建者', - 'type' => 'string', - ], - ], - ], - 'NameCheckResult' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'exist_file_id' => [ - 'title' => 'exist file id', - 'type' => 'string', - ], - 'exist_file_type' => [ - 'title' => 'exist file type', - 'type' => 'string', - ], - ], - ], - 'OfficeEditConfig' => [ - 'title' => 'OfficeEditConfig', - 'type' => 'object', - 'properties' => [ - 'enabled' => [ - 'title' => 'enabled', - 'type' => 'boolean', - ], - ], - ], - 'OfficePreviewConfig' => [ - 'title' => 'OfficePreviewConfig', - 'type' => 'object', - 'properties' => [ - 'enabled' => [ - 'title' => 'enabled', - 'type' => 'boolean', - ], + 'knowledge_base_id' => ['title' => '知识库 ID', 'type' => 'string'], + 'knowledge_category_id' => ['title' => '知识分类 ID', 'type' => 'string'], + 'drive_id' => ['title' => '云盘 ID', 'type' => 'string'], + 'file_id' => ['title' => '文件 ID', 'type' => 'string'], + 'revision_id' => ['title' => '文件版本 ID', 'type' => 'string'], + 'joined_at' => ['title' => '文件加入知识库/知识分类的毫秒级时间戳', 'type' => 'integer', 'format' => 'int64'], + 'creator_id' => ['title' => '文件加入知识库/知识分类的操作者 ID', 'type' => 'string'], + 'file_image_time' => ['title' => '图片文件的拍摄时间', 'type' => 'integer', 'format' => 'int64'], + 'file_created_at' => ['title' => '文件的毫秒级创建时间戳', 'type' => 'integer', 'format' => 'int64'], + 'file_updated_at' => ['title' => '文件的毫秒级更新时间戳', 'type' => 'integer', 'format' => 'int64'], + 'file_creator_id' => ['title' => '文件的创建者 ID', 'type' => 'string'], + 'file_size' => ['title' => '文件大小', 'type' => 'integer', 'format' => 'int64'], + 'file_category' => ['title' => '文件类别', 'type' => 'string'], + 'file_name' => ['title' => '文件名', 'type' => 'string'], + 'file_name_path' => ['title' => '文件名路径', 'type' => 'string'], + 'file_last_modifier_id' => ['title' => '文件最后的修改者 ID', 'type' => 'string'], + 'file_last_modifier_type' => ['title' => '文件最后的修改者类型', 'type' => 'string'], + 'drive_name' => ['title' => '云盘名称', 'type' => 'string'], ], ], 'Permission' => [ 'title' => 'A short description of struct', 'description' => '权限', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'collection' => [ - 'title' => '权限集', - 'description' => '权限集，设置全局权限时为 global，其他场景默认为空', - 'type' => 'string', - 'example' => 'global', - ], - 'resource_type' => [ - 'title' => '资源类型', - 'description' => '资源类型，文件类型资源为RT\\_File', - 'type' => 'string', - 'example' => 'RT_File', - ], - 'resource' => [ - 'title' => '资源', - 'description' => '资源ID', - 'type' => 'string', - 'example' => 'fa212***', - ], - 'identity_type' => [ - 'title' => '授予对象类型', - 'description' => '授予对象类型，当前支持IT\\_User、IT\\_Group、IT\\_Role', - 'type' => 'string', - 'example' => 'IT_User', - ], - 'identity_id' => [ - 'title' => '授予对象ID', - 'description' => '授予对象ID', - 'type' => 'string', - 'example' => 'af22***', - ], + 'collection' => ['title' => '权限集', 'description' => '权限集，设置全局权限时为 global，其他场景默认为空', 'visibility' => 'Public', 'type' => 'string', 'example' => 'global'], + 'resource_type' => ['title' => '资源类型', 'description' => '资源类型，文件类型资源为RT\\_File', 'visibility' => 'Public', 'type' => 'string', 'example' => 'RT_File'], + 'resource' => ['title' => '资源', 'description' => '资源ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'fa212***'], + 'identity_type' => ['title' => '授予对象类型', 'description' => '授予对象类型，当前支持IT\\_User、IT\\_Group、IT\\_Role', 'visibility' => 'Public', 'type' => 'string', 'example' => 'IT_User'], + 'identity_id' => ['title' => '授予对象ID', 'description' => '授予对象ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'af22***'], 'action_list' => [ 'title' => '操作列表', 'description' => '操作列表', + 'visibility' => 'Public', 'type' => 'array', 'items' => [ + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'action' => [ - 'title' => '操作', - 'description' => '具体操作，比如FILE.ALL', - 'type' => 'string', - 'example' => 'FILE.ALL', - ], + 'action' => ['title' => '操作', 'description' => '具体操作，比如FILE.ALL', 'visibility' => 'Public', 'type' => 'string', 'example' => 'FILE.ALL'], ], + 'extendType' => 'true', ], ], - 'effect' => [ - 'title' => '作用', - 'description' => '作用，可填allow、deny', - 'type' => 'string', - 'example' => 'deny', - ], - 'created_at' => [ - 'title' => '创建时间', - 'description' => '创建时间，格式为毫秒时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1703648502811', - ], - 'updated_at' => [ - 'title' => '修改时间', - 'description' => '修改时间，格式为毫秒时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1703648502811', - ], - 'condition' => [ - 'title' => '条件', - 'description' => '条件', - '$ref' => '#/components/schemas/PermissionCondition', - ], + 'effect' => ['title' => '作用', 'description' => '作用，可填allow、deny', 'visibility' => 'Public', 'type' => 'string', 'example' => 'deny'], + 'created_at' => ['title' => '创建时间', 'description' => '创建时间，格式为毫秒时间戳', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1703648502811'], + 'updated_at' => ['title' => '修改时间', 'description' => '修改时间，格式为毫秒时间戳', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1703648502811'], + 'condition' => ['title' => '条件', 'description' => '条件', 'visibility' => 'Public', '$ref' => '#/components/schemas/PermissionCondition'], 'user_tags' => [ 'title' => '自定义标签', 'description' => '自定义标签', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - 'description' => '自定义标签字符串', - 'type' => 'string', - 'example' => 'user1', - ], + 'items' => ['description' => '自定义标签字符串', 'visibility' => 'Public', 'type' => 'string', 'example' => 'user1', 'extendType' => 'true'], ], ], ], @@ -4548,11 +804,7 @@ 'title' => 'ip', 'description' => '客户端IP地址', 'type' => 'array', - 'items' => [ - 'description' => '具体的IP地址', - 'type' => 'string', - 'example' => '192.168.1.1', - ], + 'items' => ['description' => '具体的IP地址', 'type' => 'string', 'example' => '192.168.1.1'], ], ], ], @@ -4565,11 +817,7 @@ 'title' => 'ip', 'description' => '客户端IP地址', 'type' => 'array', - 'items' => [ - 'description' => '具体的IP地址', - 'type' => 'string', - 'example' => '192.168.1.1', - ], + 'items' => ['description' => '具体的IP地址', 'type' => 'string', 'example' => '192.168.1.1'], ], ], ], @@ -4582,11 +830,7 @@ 'title' => 'vpc_id', 'description' => '客户端所在的vpcID作为字符串匹配条件', 'type' => 'array', - 'items' => [ - 'description' => '具体VpcID', - 'type' => 'string', - 'example' => 'vpc-xxx', - ], + 'items' => ['description' => '具体VpcID', 'type' => 'string', 'example' => 'vpc-xxx'], ], ], ], @@ -4599,1192 +843,257 @@ 'title' => 'vpi_id', 'description' => '客户端所在的vpcID作为字符串匹配条件', 'type' => 'array', - 'items' => [ - 'description' => '具体VpcID', - 'type' => 'string', - 'example' => 'vpc-xxx', - ], - ], - ], - ], - 'bool_equals' => [ - 'title' => '是否分享场景', - 'description' => '是否分享场景', - 'type' => 'object', - 'properties' => [ - 'is_share_link' => [ - 'title' => '是否分享场景', - 'description' => '是否分享场景', - 'type' => 'boolean', + 'items' => ['description' => '具体VpcID', 'type' => 'string', 'example' => 'vpc-xxx'], ], ], ], - 'bool_not_equals' => [ - 'title' => '是否分享场景', - 'description' => '是否分享场景', - 'type' => 'object', - 'properties' => [ - 'is_share_link' => [ - 'title' => '是否分享场景', - 'description' => '是否分享场景', - 'type' => 'boolean', - ], - ], - ], - ], - ], - 'PersonalRightsInfoResponse' => [ - 'type' => 'object', - 'properties' => [ - 'spu_id' => [ - 'title' => 'spu_id', - 'type' => 'string', - ], - 'name' => [ - 'title' => '名字', - 'type' => 'string', - ], - 'title' => [ - 'title' => '标题', - 'type' => 'string', - ], - 'icon' => [ - 'title' => '图标', - 'type' => 'string', - ], - 'expires_time' => [ - 'title' => '过期时间', - 'type' => 'string', - ], - 'is_expires' => [ - 'title' => '是否过期', - 'type' => 'boolean', - ], - 'privileges' => [ - 'title' => '权益', - 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/DataBoxPrivileges', - ], - 'required' => false, - ], - 'history_latest_rights' => [ - 'title' => '最新权益', - '$ref' => '#/components/schemas/PersonalRightsInfoResponse', - ], - 'other_rights' => [ - 'title' => '其他权益', - '$ref' => '#/components/schemas/PersonalRightsInfoResponse', - ], - ], - ], - 'PersonalSpaceInfo' => [ - 'title' => 'A short description of struct', - 'description' => 'PersonalSpaceInfo', - 'type' => 'object', - 'properties' => [ - 'used_size' => [ - 'title' => '使用大小', - 'type' => 'integer', - 'format' => 'int64', - ], - 'total_size' => [ - 'title' => '总大小', - 'type' => 'integer', - 'format' => 'int64', - ], - ], - ], - 'ReceivedMsg' => [ - 'title' => 'A short description of struct', - 'description' => '收到的通知消息', - 'type' => 'object', - 'properties' => [ - 'msg_id' => [ - 'title' => '消息id', - 'type' => 'string', - 'example' => '50d6f2aaa16525c7d053998e48fac265962f585f', - ], - 'msg_category' => [ - 'title' => '消息分类', - 'type' => 'string', - 'example' => 'system', - ], - 'msg_sub_category' => [ - 'title' => '消息子分类', - 'type' => 'string', - 'example' => 'change_user_setting', - ], - 'msg_content' => [ - 'title' => '消息内容', - 'type' => 'object', - 'properties' => [ - 'msg_data' => [ - 'title' => '消息携带的数据', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'any', - 'example' => '{"actor": "admin", "role": "superadmin", "target": "phone", "to": "137*****123" }', - ], - ], - ], - ], - 'msg_type' => [ - 'title' => '消息类别', - 'type' => 'string', - 'example' => 'edit_user', - ], - 'has_read' => [ - 'title' => '是否已读', - 'type' => 'boolean', - 'example' => 'false', - ], - 'read_at' => [ - 'title' => '已读事件', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1716363191123', - ], - 'publish_at' => [ - 'title' => '发送时间', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1716363191123', - ], - ], - ], - 'RecentActedFile' => [ - 'title' => '最近操作的文件', - 'description' => '最近操作的文件', - 'type' => 'object', - 'properties' => [ - 'drive_id' => [ - 'title' => '空间id', - 'type' => 'string', - 'example' => '50d6f2aaa16525c7d053998e48fac265962f585f', - ], - 'drive_name' => [ - 'title' => '空间名', - 'type' => 'string', - 'example' => 'group drive', - ], - 'drive_owner_id' => [ - 'title' => '空间所有者id', - 'type' => 'string', - 'example' => '50d6f2aaa16525c7d053998e48fac265962f585f', - ], - 'drive_owner_type' => [ - 'title' => '空间所有者类型', - 'type' => 'string', - 'example' => 'group', - ], - 'drive_is_handover' => [ - 'title' => '是否是移交的空间', - 'type' => 'boolean', - 'example' => 'false', - ], - 'file_id' => [ - 'title' => '文件id', - 'type' => 'string', - 'example' => '50d6f2aaa16525c7d053998e48fac265962f585f', - ], - 'file_name' => [ - 'title' => '文件名', - 'type' => 'string', - 'example' => 'a.jpg', - ], - 'size' => [ - 'title' => '文件大小', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'category' => [ - 'title' => '文件类型', - 'type' => 'string', - 'example' => 'doc', - ], - 'thumbnail' => [ - 'title' => '文件缩略图', - 'type' => 'string', - 'example' => 'https://xxx.jpg', - ], - 'trashed' => [ - 'title' => '是否移到回收站', - 'type' => 'boolean', - 'example' => 'true', - ], - 'deleted' => [ - 'title' => '是否删除', - 'type' => 'boolean', - 'example' => 'true', - ], - 'action_list' => [ - 'title' => '文件权限列表', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - 'example' => 'FILE.GET', - ], - ], - ], - ], - 'RecycleBinConfig' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'auto_delete_enabled' => [ - 'title' => 'auto_delete_enabled', - 'type' => 'boolean', - ], - 'auto_delete_keep_second' => [ - 'title' => 'auto_delete_keep_second', - 'type' => 'integer', - 'format' => 'int32', - ], - 'delete_trash_normal_file_disabled' => [ - 'title' => 'delete_trash_normal_file_disabled', - 'type' => 'boolean', - ], - ], - ], - 'RefundNoticeParam' => [ - 'title' => 'A short description of struct', - 'description' => '退款通知参数', - 'type' => 'object', - 'properties' => [ - 'refundType' => [ - 'title' => '退款类型', - 'type' => 'string', - ], - 'orderIds' => [ - 'title' => '订单号列表', - 'type' => 'array', - 'items' => [ - 'type' => 'integer', - 'format' => 'int64', - ], - ], - 'instanceId' => [ - 'title' => '实例 id', - 'type' => 'string', - ], - 'commodityCode' => [ - 'title' => '商品 code', - 'type' => 'string', - ], - 'aliyunProduceCode' => [ - 'title' => '阿里云产品 code', - 'type' => 'string', - ], - 'aliuid' => [ - 'title' => '阿里云用户 id', - 'type' => 'integer', - 'format' => 'int64', - ], - 'newExpireTime' => [ - 'title' => '过期时间', - 'type' => 'any', - ], - 'refundParamMap' => [ - 'title' => '退款参数', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - ], - ], ], ], 'Revision' => [ 'title' => 'A short description of struct', 'description' => '版本', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'title' => '域id', - 'description' => '域id', - 'type' => 'string', - 'example' => 'bj1', - ], - 'drive_id' => [ - 'title' => '空间id', - 'description' => '空间id', - 'type' => 'string', - 'example' => '1', - ], - 'file_id' => [ - 'title' => '文件id', - 'description' => '文件id', - 'type' => 'string', - 'example' => '9520943DC264', - ], - 'revision_id' => [ - 'title' => '版本id', - 'description' => '版本id', - 'type' => 'string', - 'example' => '40CB7794C929', - ], - 'revision_name' => [ - 'title' => '版本名', - 'description' => '版本名', - 'type' => 'string', - 'example' => '1.mov', - ], - 'revision_version' => [ - 'title' => '版本号', - 'description' => '版本号', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'size' => [ - 'title' => '版本大小', - 'description' => '版本大小', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1024', - ], - 'file_extension' => [ - 'title' => '扩展名', - 'description' => '扩展名', - 'type' => 'string', - 'example' => 'mov', - ], - 'created_at' => [ - 'title' => '创建时间', - 'description' => '创建时间', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'updated_at' => [ - 'title' => '修改时间', - 'description' => '修改时间', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'keep_forever' => [ - 'title' => '是否永久保留', - 'description' => '是否永久保留', - 'type' => 'boolean', - 'example' => 'false', - ], - 'revision_description' => [ - 'title' => '版本描述', - 'description' => '版本描述', - 'type' => 'string', - 'example' => 'aaa', - ], - 'is_latest_version' => [ - 'title' => '是否为最新版本', - 'description' => '是否为最新版本', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], - 'crc64_hash' => [ - 'title' => 'crc64', - 'description' => 'crc64', - 'type' => 'string', - 'example' => '3574582125365864471', - ], - 'content_hash' => [ - 'title' => '内容hash', - 'description' => '内容hash', - 'type' => 'string', - 'example' => 'EA4942AA8761213890A5C386F88E6464D2C31CA3', - ], - 'content_hash_name' => [ - 'title' => '内容hash算法名', - 'description' => '内容hash算法名', - 'type' => 'string', - 'example' => 'sha1', - ], - 'thumbnail' => [ - 'title' => '缩略图地址', - 'description' => '缩略图地址', - 'type' => 'string', - 'required' => false, - 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx'."\n", - ], - 'url' => [ - 'title' => '预览地址', - 'description' => '预览地址', - 'type' => 'string', - 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx'."\n", - ], - 'download_url' => [ - 'title' => '下载地址', - 'description' => '下载地址，ListRevision不返回该字段，GetRevision, UpdateRevision, RestoreRevision返回该字段。', - 'type' => 'string', - 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx'."\n", - ], - 'creator_id' => [ - 'title' => '创建者ID', - 'description' => '创建者ID', - 'type' => 'string', - ], - 'creator_name' => [ - 'title' => '创建者名称', - 'description' => '创建者名称', - 'type' => 'string', - ], + 'domain_id' => ['title' => '域id', 'description' => '域id', 'visibility' => 'Public', 'type' => 'string', 'example' => 'bj1'], + 'drive_id' => ['title' => '空间id', 'description' => '空间id', 'visibility' => 'Public', 'type' => 'string', 'example' => '1'], + 'file_id' => ['title' => '文件id', 'description' => '文件id', 'visibility' => 'Public', 'type' => 'string', 'example' => '9520943DC264'], + 'revision_id' => ['title' => '版本id', 'description' => '版本id', 'visibility' => 'Public', 'type' => 'string', 'example' => '40CB7794C929'], + 'revision_name' => ['title' => '版本名', 'description' => '版本名', 'visibility' => 'Public', 'type' => 'string', 'example' => '1.mov'], + 'revision_version' => ['title' => '版本号', 'description' => '版本号', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'size' => ['title' => '版本大小', 'description' => '版本大小', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1024'], + 'file_extension' => ['title' => '扩展名', 'description' => '扩展名', 'visibility' => 'Public', 'type' => 'string', 'example' => 'mov'], + 'created_at' => ['title' => '创建时间', 'description' => '创建时间', 'visibility' => 'Public', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'updated_at' => ['title' => '修改时间', 'description' => '修改时间', 'visibility' => 'Public', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'keep_forever' => ['title' => '是否永久保留', 'description' => '是否永久保留', 'visibility' => 'Public', 'type' => 'boolean', 'example' => 'false'], + 'revision_description' => ['title' => '版本描述', 'description' => '版本描述', 'visibility' => 'Public', 'type' => 'string', 'example' => 'aaa'], + 'is_latest_version' => ['title' => '是否为最新版本', 'description' => '是否为最新版本', 'visibility' => 'Public', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + 'crc64_hash' => ['title' => 'crc64', 'description' => 'crc64', 'visibility' => 'Public', 'type' => 'string', 'example' => '3574582125365864471'], + 'content_hash' => ['title' => '内容hash', 'description' => '内容hash', 'visibility' => 'Public', 'type' => 'string', 'example' => 'EA4942AA8761213890A5C386F88E6464D2C31CA3'], + 'content_hash_name' => ['title' => '内容hash算法名', 'description' => '内容hash算法名', 'visibility' => 'Public', 'type' => 'string', 'example' => 'sha1'], + 'thumbnail' => ['title' => '缩略图地址', 'description' => '缩略图地址', 'visibility' => 'Public', 'type' => 'string', 'required' => false, 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx'."\n"], + 'url' => ['title' => '预览地址', 'description' => '预览地址', 'visibility' => 'Public', 'type' => 'string', 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx'."\n"], + 'download_url' => ['title' => '下载地址', 'description' => '下载地址，ListRevision不返回该字段，GetRevision, UpdateRevision, RestoreRevision返回该字段。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx'."\n"], + 'creator_type' => ['title' => '创建者类型', 'description' => '创建者类型', 'visibility' => 'Private', 'type' => 'string'], + 'creator_id' => ['title' => '创建者ID', 'description' => '创建者ID', 'visibility' => 'cn', 'type' => 'string'], + 'creator_name' => ['title' => '创建者名称', 'description' => '创建者名称', 'visibility' => 'cn', 'type' => 'string'], ], ], 'Role' => [ 'title' => '角色', 'description' => '角色', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'role_id' => [ - 'title' => '角色ID', - 'description' => '角色ID', - 'type' => 'string', - 'example' => 'f2a***', - ], - 'name' => [ - 'title' => '角色名', - 'description' => '角色名', - 'type' => 'string', - 'example' => '文件预览者', - ], - 'description' => [ - 'title' => '角色描述', - 'description' => '角色描述', - 'type' => 'string', - 'example' => '拥有预览文件权限', - ], - 'manage_resource_type' => [ - 'title' => '管理的资源类型', - 'description' => '管理的资源类型，目前支持RT\\_File', - 'type' => 'string', - 'example' => 'RT_File', - ], - 'creator' => [ - 'title' => '创建者', - 'description' => '创建者ID', - 'type' => 'string', - 'example' => 'a23***', - ], - 'created_at' => [ - 'title' => '创建时间', - 'description' => '创建时间，格式毫秒时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1703648502811', - ], - 'updated_at' => [ - 'title' => '上次更新时间', - 'description' => '上次更新时间，格式毫秒时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1703648502811', - ], + 'role_id' => ['title' => '角色ID', 'description' => '角色ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'f2a***'], + 'name' => ['title' => '角色名', 'description' => '角色名', 'visibility' => 'Public', 'type' => 'string', 'example' => '文件预览者'], + 'description' => ['title' => '角色描述', 'description' => '角色描述', 'visibility' => 'Public', 'type' => 'string', 'example' => '拥有预览文件权限'], + 'manage_resource_type' => ['title' => '管理的资源类型', 'description' => '管理的资源类型，目前支持RT\\_File', 'visibility' => 'Public', 'type' => 'string', 'example' => 'RT_File'], + 'creator' => ['title' => '创建者', 'description' => '创建者ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'a23***'], + 'created_at' => ['title' => '创建时间', 'description' => '创建时间，格式毫秒时间戳', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1703648502811'], + 'updated_at' => ['title' => '上次更新时间', 'description' => '上次更新时间，格式毫秒时间戳', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1703648502811'], 'permissions' => [ 'title' => '权限列表', 'description' => '权限列表', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - 'description' => '权限项', - '$ref' => '#/components/schemas/Permission', - ], - ], - 'status' => [ - 'title' => '状态', - 'description' => '状态', - 'type' => 'string', - 'example' => 'enabled', - ], - ], - ], - 'SearchFromThirdPartyItem' => [ - 'title' => 'SearchFromThirdPartyItem', - 'type' => 'object', - 'properties' => [ - 'authentication_type' => [ - 'title' => 'authentication_type', - 'type' => 'string', - ], - 'identity' => [ - 'title' => 'identity', - 'type' => 'string', - ], - 'extra' => [ - 'title' => 'extra', - 'type' => 'string', - ], - 'others' => [ - 'title' => 'others', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'any', - ], + 'items' => ['description' => '权限项', 'visibility' => 'Public', 'extendType' => 'true', '$ref' => '#/components/schemas/Permission'], ], + 'status' => ['title' => '状态', 'description' => '状态', 'visibility' => 'Public', 'type' => 'string', 'example' => 'enabled'], ], + 'parseType' => 'struct', ], 'ShareLink' => [ 'title' => '分享', 'description' => '分享', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'share_id' => [ - 'title' => '分享id', - 'description' => '分享id', - 'type' => 'string', - 'example' => '7JQX1FswpQ8', - ], - 'share_pwd' => [ - 'title' => '分享密码', - 'description' => '提取码，0-64个字符。长度0表示没有提取码。', - 'type' => 'string', - 'example' => 'abcF123x', - ], - 'drive_id' => [ - 'title' => '空间id', - 'description' => '空间id', - 'type' => 'string', - 'example' => '1', - ], + 'share_id' => ['title' => '分享id', 'description' => '分享id', 'visibility' => 'Public', 'type' => 'string', 'example' => '7JQX1FswpQ8'], + 'share_pwd' => ['title' => '分享密码', 'description' => '提取码，0-64个字符。长度0表示没有提取码。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'abcF123x'], + 'drive_id' => ['title' => '空间id', 'description' => '空间id', 'visibility' => 'Public', 'type' => 'string', 'example' => '1'], 'file_id_list' => [ 'title' => '分享父路径文件id列表', 'description' => '分享父路径文件id列表', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - 'type' => 'string', - 'example' => '["xx"]', - ], + 'items' => ['visibility' => 'Public', 'type' => 'string', 'example' => '["xx"]', 'extendType' => 'true'], 'example' => '["520b217f13adf4fc24f2191991b1664ce045b393"]', ], - 'expiration' => [ - 'title' => '到期时间', - 'description' => '失效时间点。'."\n" - .'RFC3339格式，比如："2020-06-28T11:33:00.000+08:00"。'."\n" - .'永久有效：""', - 'type' => 'string', - 'example' => '2020-06-28T11:33:00.000+08:00', - ], - 'expired' => [ - 'title' => '是否过期', - 'description' => '是否过期', - 'type' => 'boolean', - 'example' => 'false', - ], - 'created_at' => [ - 'title' => '创建时间', - 'description' => '创建时间', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'updated_at' => [ - 'title' => '修改时间', - 'description' => '修改时间', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'description' => [ - 'title' => '描述', - 'description' => '描述', - 'type' => 'string', - 'example' => 'videos', - ], - 'share_name' => [ - 'title' => '分享名称', - 'description' => '分享名，默认使用第一个文件名', - 'type' => 'string', - 'example' => 'video-1.MP4', - ], - 'creator' => [ - 'title' => '创建者', - 'description' => '创建者', - 'type' => 'string', - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - ], + 'expiration' => ['title' => '到期时间', 'description' => '失效时间点。'."\n" + .'RFC3339格式，比如："2020-06-28T11:33:00.000+08:00"。'."\n" + .'永久有效：""', 'visibility' => 'Public', 'type' => 'string', 'example' => '2020-06-28T11:33:00.000+08:00'], + 'expired' => ['title' => '是否过期', 'description' => '是否过期', 'visibility' => 'Public', 'type' => 'boolean', 'example' => 'false'], + 'created_at' => ['title' => '创建时间', 'description' => '创建时间', 'visibility' => 'Public', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'updated_at' => ['title' => '修改时间', 'description' => '修改时间', 'visibility' => 'Public', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'description' => ['title' => '描述', 'description' => '描述', 'visibility' => 'Public', 'type' => 'string', 'example' => 'videos'], + 'share_name' => ['title' => '分享名称', 'description' => '分享名，默认使用第一个文件名', 'visibility' => 'Public', 'type' => 'string', 'example' => 'video-1.MP4'], + 'creator' => ['title' => '创建者', 'description' => '创建者', 'visibility' => 'Public', 'type' => 'string', 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4'], 'status' => [ 'title' => '状态', 'description' => '状态。'."\n" .'枚举值如下：'."\n" .'- disabled（已取消）'."\n" .'- enabled（有效）', + 'visibility' => 'Public', 'type' => 'string', - 'enumValueTitles' => [ - 'disabled' => '已取消', - 'enabled' => '有效', - ], + 'enumValueTitles' => ['disabled' => '已取消', 'enabled' => '有效'], 'example' => 'enabled', ], - 'preview_count' => [ - 'title' => '预览次数', - 'description' => '预览次数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', - ], - 'save_count' => [ - 'title' => '转存次数', - 'description' => '转存次数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2', - ], - 'download_count' => [ - 'title' => '下载次数', - 'description' => '下载次数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '5', - ], - 'report_count' => [ - 'title' => '被举报次数', - 'description' => '被举报次数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'video_preview_count' => [ - 'title' => '音视频播放次数', - 'description' => '音视频播放次数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1', - ], - 'access_count' => [ - 'title' => '访问次数', - 'description' => '访问次数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '4', - ], - 'disable_preview' => [ - 'title' => '禁止预览分享中的文件', - 'description' => '禁止预览分享中的文件', - 'type' => 'boolean', - 'example' => 'false', - ], - 'disable_save' => [ - 'title' => '禁止转存分享中的文件', - 'description' => '禁止转存分享中的文件', - 'type' => 'boolean', - 'example' => 'false', - ], - 'disable_download' => [ - 'title' => '禁止下载分享中的文件', - 'description' => '禁止下载分享中的文件', - 'type' => 'boolean', - 'example' => 'false', - ], - 'preview_limit' => [ - 'title' => '分享预览次数限制', - 'description' => '分享预览次数限制', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'save_limit' => [ - 'title' => '分享转存次数限制', - 'description' => '分享转存次数限制', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'download_limit' => [ - 'title' => '分享下载次数限制', - 'description' => '分享下载次数限制', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'share_all_files' => [ - 'title' => '是否分享整个drive中的文件', - 'description' => '是否分享整个drive中的文件', - 'type' => 'boolean', - 'example' => 'true', - ], - 'save_download_limit' => [ - 'title' => '分享转存和下载次数总和限制', - 'description' => '分享转存和下载次数总和限制', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'office_editable' => [ - 'title' => '是否允许在线编辑分享的文档', - 'description' => '是否允许在线编辑分享的文档', - 'type' => 'boolean', - 'example' => 'true', - ], - ], - ], - 'ShareLinkConfig' => [ - 'title' => 'ShareLinkConfig', - 'type' => 'object', - 'properties' => [ - 'enable_share_link_office_edit' => [ - 'title' => 'enable_share_link_office_edit', - 'type' => 'boolean', - ], - ], - ], - 'ShareLinkDetail' => [ - 'title' => 'ShareLinkDetail', - 'type' => 'object', - 'properties' => [ - 'enable_office_editable' => [ - 'title' => 'enable_office_editable', - 'type' => 'boolean', - ], - ], - ], - 'SimpleQuery' => [ - 'title' => 'A short description of struct', - 'type' => 'object', - 'properties' => [ - 'field' => [ - 'title' => '字段', - 'type' => 'string', - 'format' => 'byte', - ], - 'operation' => [ - 'title' => '操作', - 'type' => 'string', - 'format' => 'byte', - ], - 'sub_queries' => [ - 'title' => '查询条件', - 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/SimpleQuery', - ], - ], - 'value' => [ - 'title' => '值', - 'type' => 'string', - 'format' => 'byte', - ], - ], - ], - 'SimpleStreamInfo' => [ - 'title' => 'SimpleStreamInfo', - 'description' => '数据流信息', - 'type' => 'object', - 'properties' => [ - 'crc64_hash' => [ - 'title' => 'crc64_hash', - 'type' => 'string', - ], - 'size' => [ - 'title' => 'size', - 'type' => 'integer', - 'format' => 'int64', - ], - 'content_hash' => [ - 'title' => 'content_hash', - 'type' => 'string', - ], - 'content_hash_name' => [ - 'title' => 'content_hash_name', - 'type' => 'string', - ], - 'download_url' => [ - 'title' => 'download_url', - 'type' => 'string', - ], - 'url' => [ - 'title' => 'url', - 'type' => 'string', - ], - 'thumbnail' => [ - 'title' => 'thumbnail', - 'type' => 'string', - ], + 'preview_count' => ['title' => '预览次数', 'description' => '预览次数', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '10'], + 'save_count' => ['title' => '转存次数', 'description' => '转存次数', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '2'], + 'download_count' => ['title' => '下载次数', 'description' => '下载次数', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '5'], + 'report_count' => ['title' => '被举报次数', 'description' => '被举报次数', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'video_preview_count' => ['title' => '音视频播放次数', 'description' => '音视频播放次数', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1'], + 'access_count' => ['title' => '访问次数', 'description' => '访问次数', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '4'], + 'disable_preview' => ['title' => '禁止预览分享中的文件', 'description' => '禁止预览分享中的文件', 'visibility' => 'Public', 'type' => 'boolean', 'example' => 'false'], + 'disable_save' => ['title' => '禁止转存分享中的文件', 'description' => '禁止转存分享中的文件', 'visibility' => 'Public', 'type' => 'boolean', 'example' => 'false'], + 'disable_download' => ['title' => '禁止下载分享中的文件', 'description' => '禁止下载分享中的文件', 'visibility' => 'Public', 'type' => 'boolean', 'example' => 'false'], + 'preview_limit' => ['title' => '分享预览次数限制', 'description' => '分享预览次数限制', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'save_limit' => ['title' => '分享转存次数限制', 'description' => '分享转存次数限制', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'download_limit' => ['title' => '分享下载次数限制', 'description' => '分享下载次数限制', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'require_login' => ['title' => '登录后才允许使用分享', 'description' => '登录后才允许使用分享', 'visibility' => 'Private', 'type' => 'boolean', 'example' => 'false'], + 'share_all_files' => ['title' => '是否分享整个drive中的文件', 'description' => '是否分享整个drive中的文件', 'visibility' => 'Public', 'type' => 'boolean', 'example' => 'true'], + 'share_msg' => ['title' => '分享口令', 'description' => '分享口令', 'visibility' => 'Private', 'type' => 'string', 'example' => 'pwd: 123'], + 'save_download_limit' => ['title' => '分享转存和下载次数总和限制', 'description' => '分享转存和下载次数总和限制', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'office_editable' => ['title' => '是否允许在线编辑分享的文档', 'description' => '是否允许在线编辑分享的文档', 'visibility' => 'Public', 'type' => 'boolean', 'example' => 'true'], ], ], 'Story' => [ 'title' => 'A short description of struct', 'description' => '故事', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'story_id' => [ - 'title' => '故事 id', - 'description' => '故事 id', - 'type' => 'string', - 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003', - ], - 'story_type' => [ - 'title' => '故事类型', - 'description' => '故事类型。'."\n" - .'由用户创建时指定，见 [CreateStory](~~2367602~~) 和 [CreateCustomizedStory](~~2369338~~)。', - 'type' => 'string', - 'example' => 'PeopleMemory', - ], - 'story_sub_type' => [ - 'title' => '故事子类型', - 'description' => '故事子类型。'."\n" - .'由用户创建时指定，见 [CreateStory](~~2367602~~) 和 [CreateCustomizedStory](~~2369338~~)。', - 'type' => 'string', - 'example' => 'Solo', - ], - 'story_name' => [ - 'title' => '故事名称', - 'description' => '故事名称', - 'type' => 'string', - 'example' => 'test_name', - ], - 'story_start_time' => [ - 'title' => '故事开始时间', - 'description' => '故事开始时间。时间格式为 RFC3339。', - 'type' => 'string', - 'example' => '2021-01-14T10:17:18.102700407+08:00', - ], - 'story_end_time' => [ - 'title' => '故事结束时间', - 'description' => '故事结束时间。时间格式为 RFC3339。', - 'type' => 'string', - 'example' => '2022-01-14T10:17:18.102700407+08:00', - ], - 'created_at' => [ - 'title' => '故事创建时间', - 'description' => '故事创建时间。时间格式为 RFC3339。', - 'type' => 'string', - 'example' => '2022-01-14T10:17:18.102700407+08:00', - ], - 'updated_at' => [ - 'title' => '故事更新时间', - 'description' => '故事更新时间。时间格式为 RFC3339。', - 'type' => 'string', - 'example' => '2022-01-14T10:17:18.102700407+08:00', - ], + 'story_id' => ['title' => '故事 id', 'description' => '故事 id', 'visibility' => 'Public', 'type' => 'string', 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003'], + 'story_type' => ['title' => '故事类型', 'description' => '故事类型。'."\n" + .'由用户创建时指定，见 [CreateStory](~~2367602~~) 和 [CreateCustomizedStory](~~2369338~~)。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'PeopleMemory'], + 'story_sub_type' => ['title' => '故事子类型', 'description' => '故事子类型。'."\n" + .'由用户创建时指定，见 [CreateStory](~~2367602~~) 和 [CreateCustomizedStory](~~2369338~~)。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Solo'], + 'story_name' => ['title' => '故事名称', 'description' => '故事名称', 'visibility' => 'Public', 'type' => 'string', 'example' => 'test_name'], + 'story_start_time' => ['title' => '故事开始时间', 'description' => '故事开始时间。时间格式为 RFC3339。', 'visibility' => 'Public', 'type' => 'string', 'example' => '2021-01-14T10:17:18.102700407+08:00'], + 'story_end_time' => ['title' => '故事结束时间', 'description' => '故事结束时间。时间格式为 RFC3339。', 'visibility' => 'Public', 'type' => 'string', 'example' => '2022-01-14T10:17:18.102700407+08:00'], + 'created_at' => ['title' => '故事创建时间', 'description' => '故事创建时间。时间格式为 RFC3339。', 'visibility' => 'Public', 'type' => 'string', 'example' => '2022-01-14T10:17:18.102700407+08:00'], + 'updated_at' => ['title' => '故事更新时间', 'description' => '故事更新时间。时间格式为 RFC3339。', 'visibility' => 'Public', 'type' => 'string', 'example' => '2022-01-14T10:17:18.102700407+08:00'], 'face_group_ids' => [ 'title' => '人脸分组列表', 'description' => '人脸分组列表。'."\n" .'仅为人物故事类型时有值，其他故事类型或自定义故事无值。', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - 'description' => '人脸分组 id', - 'type' => 'string', - 'example' => 'Cluster-be377f73-3502-433c-8309-a01e659c128c', - ], - ], - 'cover_file_id' => [ - 'title' => '故事封面文件 id', - 'description' => '故事封面文件 id', - 'type' => 'string', - 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf', - ], - 'cover_file_thumbnail_url' => [ - 'title' => '故事封面文件缩略图', - 'description' => '故事封面文件缩略图', - 'type' => 'string', - 'example' => 'https://pds-domain-bucket.oss-cn-hangzhou.aliyuncs.com/Bh1HqdAs%2F1001%2F642a88c26f99cad589904fc8a6b2db6021c6601f%2F642a88c29391c47f221e49e88a21fa9b0a9e5063?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5eGE8nGtYZ59bSnbUODlmsjTttVhpbFpjz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNXD6XXO2qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABVgD3mIAeUoDYKTJrFTPdmAPIrlUUQ1HZstB0ZVHvYByygr3oeitG9FEQ8lcfaZYJOtWRchdgH8tsSwHj2jI1vMeAiLHgbW98SPA3yfN8OR1kLW73uq3LAvekc9Qldz33YTM4JA5MNJzR8x5O6Oe4rY5OMSSVU5F%2Ffr8bJZD%2FXMM%3D&x-oss-access-key-id=STS.NT3XsrXYXBvLoe2rkvBTyiSnD&x-oss-expires=1685966251&x-oss-process=image%2Fresize%2Cw_500&x-oss-signature=XimW6haBxYktKg4cstMfpd%2F2LSoMibj6A%2B7ZqBJcSbQ%3D&x-oss-signature-version=OSS2', + 'items' => ['description' => '人脸分组 id', 'visibility' => 'Public', 'type' => 'string', 'example' => 'Cluster-be377f73-3502-433c-8309-a01e659c128c', 'extendType' => 'true'], ], + 'cover_file_id' => ['title' => '故事封面文件 id', 'description' => '故事封面文件 id', 'visibility' => 'Public', 'type' => 'string', 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf'], + 'cover_file_thumbnail_url' => ['title' => '故事封面文件缩略图', 'description' => '故事封面文件缩略图', 'visibility' => 'Public', 'type' => 'string', 'example' => 'https://pds-domain-bucket.oss-cn-hangzhou.aliyuncs.com/Bh1HqdAs%2F1001%2F642a88c26f99cad589904fc8a6b2db6021c6601f%2F642a88c29391c47f221e49e88a21fa9b0a9e5063?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5eGE8nGtYZ59bSnbUODlmsjTttVhpbFpjz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNXD6XXO2qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABVgD3mIAeUoDYKTJrFTPdmAPIrlUUQ1HZstB0ZVHvYByygr3oeitG9FEQ8lcfaZYJOtWRchdgH8tsSwHj2jI1vMeAiLHgbW98SPA3yfN8OR1kLW73uq3LAvekc9Qldz33YTM4JA5MNJzR8x5O6Oe4rY5OMSSVU5F%2Ffr8bJZD%2FXMM%3D&x-oss-access-key-id=STS.NT3XsrXYXBvLoe2rkvBTyiSnD&x-oss-expires=1685966251&x-oss-process=image%2Fresize%2Cw_500&x-oss-signature=XimW6haBxYktKg4cstMfpd%2F2LSoMibj6A%2B7ZqBJcSbQ%3D&x-oss-signature-version=OSS2'], 'story_file_list' => [ 'title' => '故事文件列表', 'description' => '故事文件列表', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - 'description' => '文件信息', - '$ref' => '#/components/schemas/File', - ], + 'items' => ['description' => '文件信息', 'visibility' => 'Public', 'extendType' => 'true', '$ref' => '#/components/schemas/File'], ], + 'custom_id' => ['title' => '自定义 id', 'description' => '自定义 id。'."\n" + .'由用户根据自身业务标识。', 'visibility' => 'Private', 'type' => 'string', 'example' => 'test'], 'custom_labels' => [ 'title' => '自定义标签', 'description' => '自定义标签。'."\n" .'用户根据自身业务标记相关的键值对，可用于 FindStories 检索。', + 'visibility' => 'Public', 'type' => 'object', - 'additionalProperties' => [ - 'description' => '自定义标签', - 'type' => 'any', - 'example' => 'value', - ], - ], - ], - ], - 'SystemDriveConfig' => [ - 'title' => 'SystemDriveConfig', - 'type' => 'object', - 'properties' => [ - 'enable' => [ - 'title' => 'enable', - 'type' => 'boolean', - ], - 'drive_id' => [ - 'title' => 'drive_id', - 'type' => 'string', - ], - 'resource_parent_file_id_map' => [ - 'title' => 'resource_parent_file_id_map', - 'type' => 'object', + 'additionalProperties' => ['description' => '自定义标签', 'visibility' => 'Public', 'type' => 'any', 'example' => 'value'], ], ], ], 'SystemTag' => [ 'title' => '标签详细信息。仅开启增值服务图片处理功能有效。', 'description' => '系统AI处理标签。仅当开启增值服务图片处理功能有效。（该数据结构将于2025年2月20日起停止透出）', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'confidence' => [ - 'title' => '标签置信度，取值范围为 0（表示置信度最低）~1（表示置信度最高）。', - 'description' => '标签置信度，取值范围为 0（表示置信度最低）~1（表示置信度最高）。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.98', - ], - 'parent_name' => [ - 'title' => '标签父标签。', - 'description' => '标签的父标签名称。', - 'type' => 'string', - 'example' => 'sport', - ], - 'name' => [ - 'title' => '标签名。', - 'description' => '标签名称。', - 'type' => 'string', - 'example' => 'basketball', - ], - 'tag_level' => [ - 'title' => '标签层级，取之范围大于等于 1。', - 'description' => '标签层级，取值范围大于等于 1。', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '3', - ], - 'centric_score' => [ - 'title' => '标签的中心值分数，指该标签在图片中是否为主体，取值范围为 0~1。', - 'description' => '标签的中心值分数，指该标签在图片中是否为主体，取值范围为 0（主体比重最小）~1（主体比重最大）。', - 'type' => 'number', - 'format' => 'float', - 'example' => '0.877', - ], - ], - ], - 'TimeRange' => [ - 'title' => '时间范围', - 'type' => 'object', - 'properties' => [ - 'start' => [ - 'title' => '起始时间。格式 RFC3339。', - 'type' => 'string', - ], - 'end' => [ - 'title' => '结束时间。格式 RFC3339。', - 'type' => 'string', - ], + 'confidence' => ['title' => '标签置信度，取值范围为 0（表示置信度最低）~1（表示置信度最高）。', 'description' => '标签置信度，取值范围为 0（表示置信度最低）~1（表示置信度最高）。', 'visibility' => 'Public', 'type' => 'number', 'format' => 'float', 'example' => '0.98'], + 'parent_name' => ['title' => '标签父标签。', 'description' => '标签的父标签名称。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'sport'], + 'name' => ['title' => '标签名。', 'description' => '标签名称。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'basketball'], + 'tag_level' => ['title' => '标签层级，取之范围大于等于 1。', 'description' => '标签层级，取值范围大于等于 1。', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int32', 'example' => '3'], + 'source' => ['title' => '解析出标签的来源关键词', 'description' => '解析出标签的来源关键词。', 'visibility' => 'Private', 'type' => 'string', 'example' => 'play basketball'], + 'centric_score' => ['title' => '标签的中心值分数，指该标签在图片中是否为主体，取值范围为 0~1。', 'description' => '标签的中心值分数，指该标签在图片中是否为主体，取值范围为 0（主体比重最小）~1（主体比重最大）。', 'visibility' => 'Public', 'type' => 'number', 'format' => 'float', 'example' => '0.877'], ], ], 'Token' => [ 'title' => 'A short description of struct', 'description' => '认证成功后返回的对象，包含access_token和refresh_token还有基础用户信息', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'access_token' => [ - 'title' => '访问凭证', - 'description' => '访问凭证', - 'type' => 'string', - 'example' => 'eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJjOWI3YTVhYTA0ZDE0YWUzODY3ZmRjODg2ZmEwMWRhNCIsImN1c3RvbUpzb24iOiJ7XCJjbGllbnRJZFwiOlwiMjVkelgzdmJZcWt0Vnh5WFwiLFwiZG9tYWluSWRcIjpcImJqMjlcIixcInNjb3BlXCI6W1wiRFJJVkUuQUxMXCIsXCJTSEFSRS5BTExcIixcIkZJTEUuQUxMXCIsXCJVU0VSLkFMTFwiLFwiVklFVy5BTExcIixcIlNUT1JBR0UuQUxMXCIsXCJTVE9SQUdFRklMRS5MSVNUXCIsXCJCQVRDSFwiLFwiT0FVVEguQUxMXCIsXCJJTUFHRS5BTExcIixcIklOVklURS5BTExcIixcIkFDQ09VTlQuQUxMXCJdLFwicm9sZVwiOlwidXNlclwiLFwicmVmXCI6XCJodHRwczovL3d3dy5hbGl5dW5kcml2ZS5jb20vXCIsXCJkZXZpY2VfaWRcIjpcImIyODIwNWU1YzU5NzRjY2JiODI3MDNiNjhkYjhjNDUxXCJ9IiwiZXhwIjoxNjQ4NjE0NDkzLCJpYXQiOjE2NDg2MDcyMzN9.d3HVLvv_LFw2QhPrhvjH_kICWQJX9sKKt7NjQEqI_xE2JO_b7D8rPsFTZz93PLvZ7MhCmudTjGImUpd-ehFnI4Go-1S7BGaKaHFILvP-sWy18Wpikowjxx9mSbzBM_cO6D1LI-kyYhXKWHgVdADfVIPniTDA7-ffhUpi7cAebEs', - ], - 'refresh_token' => [ - 'title' => '刷新凭证', - 'description' => '刷新凭证', - 'type' => 'string', - 'example' => '060e78d36afb4879b51e4264e9541c16', - ], - 'expires_in' => [ - 'title' => '凭证有效期', - 'description' => '凭证有效期', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '3600', - ], + 'access_token' => ['title' => '访问凭证', 'description' => '访问凭证', 'visibility' => 'Public', 'type' => 'string', 'example' => 'eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJjOWI3YTVhYTA0ZDE0YWUzODY3ZmRjODg2ZmEwMWRhNCIsImN1c3RvbUpzb24iOiJ7XCJjbGllbnRJZFwiOlwiMjVkelgzdmJZcWt0Vnh5WFwiLFwiZG9tYWluSWRcIjpcImJqMjlcIixcInNjb3BlXCI6W1wiRFJJVkUuQUxMXCIsXCJTSEFSRS5BTExcIixcIkZJTEUuQUxMXCIsXCJVU0VSLkFMTFwiLFwiVklFVy5BTExcIixcIlNUT1JBR0UuQUxMXCIsXCJTVE9SQUdFRklMRS5MSVNUXCIsXCJCQVRDSFwiLFwiT0FVVEguQUxMXCIsXCJJTUFHRS5BTExcIixcIklOVklURS5BTExcIixcIkFDQ09VTlQuQUxMXCJdLFwicm9sZVwiOlwidXNlclwiLFwicmVmXCI6XCJodHRwczovL3d3dy5hbGl5dW5kcml2ZS5jb20vXCIsXCJkZXZpY2VfaWRcIjpcImIyODIwNWU1YzU5NzRjY2JiODI3MDNiNjhkYjhjNDUxXCJ9IiwiZXhwIjoxNjQ4NjE0NDkzLCJpYXQiOjE2NDg2MDcyMzN9.d3HVLvv_LFw2QhPrhvjH_kICWQJX9sKKt7NjQEqI_xE2JO_b7D8rPsFTZz93PLvZ7MhCmudTjGImUpd-ehFnI4Go-1S7BGaKaHFILvP-sWy18Wpikowjxx9mSbzBM_cO6D1LI-kyYhXKWHgVdADfVIPniTDA7-ffhUpi7cAebEs', 'backendName' => 'access_token'], + 'refresh_token' => ['title' => '刷新凭证', 'description' => '刷新凭证', 'visibility' => 'Public', 'type' => 'string', 'example' => '060e78d36afb4879b51e4264e9541c16', 'backendName' => 'refresh_token'], + 'expires_in' => ['title' => '凭证有效期', 'description' => '凭证有效期', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '3600', 'backendName' => 'expires_in'], 'token_type' => [ 'title' => '凭证类型', 'description' => '凭证类型', + 'visibility' => 'Public', 'type' => 'string', - 'enumValueTitles' => [ - 'Bearer' => 'Bearer', - ], + 'enumValueTitles' => ['Bearer' => 'Bearer'], 'example' => 'Bearer', - ], - 'user_id' => [ - 'title' => '用户ID', - 'description' => '用户ID', - 'type' => 'string', - 'example' => 'DING-xxxxx', - ], - 'user_name' => [ - 'title' => '用户名', - 'description' => '用户名', - 'type' => 'string', - 'example' => 'pdsuser', - ], - 'avatar' => [ - 'title' => '用户头像', - 'description' => '用户头像', - 'type' => 'string', - 'example' => 'aliyunpds.com/a.jpg', - ], - 'nick_name' => [ - 'title' => '用户昵称', - 'description' => '用户昵称', - 'type' => 'string', - 'example' => 'pdsuser', - ], - 'default_drive_id' => [ - 'title' => '用户默认空间ID', - 'description' => '用户默认空间ID', - 'type' => 'string', - 'example' => '1', - ], - 'role' => [ - 'title' => '用户角色', - 'description' => '用户角色', - 'type' => 'string', - 'example' => 'admin', - ], - 'status' => [ - 'title' => '用户状态', - 'description' => '用户状态', - 'type' => 'string', - 'example' => 'enabled', - ], - 'expire_time' => [ - 'title' => '凭证过期时间', - 'description' => '凭证过期时间', - 'type' => 'string', - 'example' => '2019-09-01T06:57:48.813Z', - ], - 'is_first_login' => [ - 'title' => '是否首次登录', - 'description' => '是否首次登录', - 'type' => 'boolean', - 'example' => 'false', - ], - 'device_name' => [ - 'title' => '登录设备名称', - 'description' => '通过oauth device flow绑定的设备名', - 'type' => 'string', - 'example' => '4683C25F', - ], - 'domain_id' => [ - 'title' => '域ID', - 'description' => '域ID', - 'type' => 'string', - 'example' => 'bj1', - ], - 'default_sbox_drive_id' => [ - 'title' => '用户默认保险箱ID', - 'description' => '用户默认保险箱ID', - 'type' => 'string', - 'example' => '1', - ], + 'backendName' => 'token_type', + ], + 'user_id' => ['title' => '用户ID', 'description' => '用户ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'DING-xxxxx', 'backendName' => 'user_id'], + 'user_name' => ['title' => '用户名', 'description' => '用户名', 'visibility' => 'Public', 'type' => 'string', 'example' => 'pdsuser', 'backendName' => 'user_name'], + 'avatar' => ['title' => '用户头像', 'description' => '用户头像', 'visibility' => 'Public', 'type' => 'string', 'example' => 'aliyunpds.com/a.jpg', 'backendName' => 'avatar'], + 'nick_name' => ['title' => '用户昵称', 'description' => '用户昵称', 'visibility' => 'Public', 'type' => 'string', 'example' => 'pdsuser', 'backendName' => 'nick_name'], + 'default_drive_id' => ['title' => '用户默认空间ID', 'description' => '用户默认空间ID', 'visibility' => 'Public', 'type' => 'string', 'example' => '1', 'backendName' => 'default_drive_id'], + 'role' => ['title' => '用户角色', 'description' => '用户角色', 'visibility' => 'Public', 'type' => 'string', 'example' => 'admin', 'backendName' => 'role'], + 'status' => ['title' => '用户状态', 'description' => '用户状态', 'visibility' => 'Public', 'type' => 'string', 'example' => 'enabled', 'backendName' => 'status'], + 'expire_time' => ['title' => '凭证过期时间', 'description' => '凭证过期时间', 'visibility' => 'Public', 'type' => 'string', 'example' => '2019-09-01T06:57:48.813Z', 'backendName' => 'expireTime'], + 'is_first_login' => ['title' => '是否首次登录', 'description' => '是否首次登录', 'visibility' => 'Public', 'type' => 'boolean', 'example' => 'false', 'backendName' => 'isFirstLogin'], + 'device_id' => ['title' => '登录设备ID', 'description' => '通过oauth device flow绑定的设备id', 'visibility' => 'Public', 'type' => 'string', 'example' => '8574ecc3d4904dc095cc49202e74db94', 'backendName' => 'deviceId'], + 'device_name' => ['title' => '登录设备名称', 'description' => '通过oauth device flow绑定的设备名', 'visibility' => 'Public', 'type' => 'string', 'example' => '4683C25F', 'backendName' => 'deviceName'], + 'domain_id' => ['title' => '域ID', 'description' => '域ID', 'visibility' => 'Public', 'type' => 'string', 'example' => 'bj1', 'backendName' => 'domain_id'], + 'default_sbox_drive_id' => ['title' => '用户默认保险箱ID', 'description' => '用户默认保险箱ID', 'visibility' => 'Public', 'type' => 'string', 'example' => '1'], 'user_data' => [ 'title' => '用户自定义数据，格式为json，可用于配置项、少量临时数据等存储，不超过1K', 'description' => '用户自定义数据', + 'visibility' => 'Public', 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - ], - ], - 'pin_setup' => [ - 'title' => '用户是否设置过保险箱密码', - 'description' => '用户是否设置过保险箱密码', - 'type' => 'boolean', - 'example' => 'false', - ], - 'need_rp_verify' => [ - 'title' => '用户是否需要进行实人认证', - 'description' => '用户是否需要进行实人认证', - 'type' => 'boolean', - 'example' => 'false', - ], - 'state' => [ - 'title' => '临时权限，用于登录成功后设置密码', - 'description' => '临时权限，用于登录成功后设置密码', - 'type' => 'string', - 'example' => 'klafhjas-asdasd-asd-as-d-asd-asd-asdasd', + 'additionalProperties' => ['visibility' => 'Public', 'type' => 'string'], ], + 'pin_setup' => ['title' => '用户是否设置过保险箱密码', 'description' => '用户是否设置过保险箱密码', 'visibility' => 'Public', 'type' => 'boolean', 'example' => 'false'], + 'need_rp_verify' => ['title' => '用户是否需要进行实人认证', 'description' => '用户是否需要进行实人认证', 'visibility' => 'Public', 'type' => 'boolean', 'example' => 'false'], + 'state' => ['title' => '临时权限，用于登录成功后设置密码', 'description' => '临时权限，用于登录成功后设置密码', 'visibility' => 'Public', 'type' => 'string', 'example' => 'klafhjas-asdasd-asd-as-d-asd-asd-asdasd'], 'exist_link' => [ 'title' => '当前用户已存在的登录方式', 'description' => '当前用户已存在的登录方式', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/LinkInfo', - ], - ], - 'need_link' => [ - 'title' => '是否需要绑定账号', - 'description' => '是否需要绑定账号', - 'type' => 'boolean', - 'example' => 'false', - ], - ], - ], - 'UncompressConfigResponse' => [ - 'title' => 'UncompressConfigResponse', - 'type' => 'object', - 'properties' => [ - 'enabled' => [ - 'title' => 'enabled', - 'type' => 'boolean', - ], - 'version' => [ - 'title' => 'version', - 'type' => 'string', + 'items' => ['visibility' => 'Public', 'extendType' => 'true', '$ref' => '#/components/schemas/LinkInfo'], ], + 'need_link' => ['title' => '是否需要绑定账号', 'description' => '是否需要绑定账号', 'visibility' => 'Public', 'type' => 'boolean', 'example' => 'false'], ], ], 'UncompressedFileInfo' => [ 'title' => 'A short description of struct', 'description' => '解压文件信息', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'title' => '网盘id', - 'description' => '网盘id', - 'type' => 'string', - 'example' => '5060', - ], - 'file_id' => [ - 'title' => '文件id', - 'description' => '文件id', - 'type' => 'string', - 'example' => '66972349b2b12fa309a143fb9db29647b2ddabfd', - ], + 'drive_id' => ['title' => '网盘id', 'description' => '网盘id', 'visibility' => 'Public', 'type' => 'string', 'example' => '5060'], + 'file_id' => ['title' => '文件id', 'description' => '文件id', 'visibility' => 'Public', 'type' => 'string', 'example' => '66972349b2b12fa309a143fb9db29647b2ddabfd'], 'is_folder' => [ 'title' => '是否为文件夹', 'description' => '是否为文件夹', + 'visibility' => 'Public', 'type' => 'boolean', - 'enumValueTitles' => [ - 'true' => 'true', - 'false' => 'false', - ], + 'enumValueTitles' => ['true' => 'true', 'false' => 'false'], 'example' => 'true', ], - 'name' => [ - 'title' => '文件名', - 'description' => '文件名', - 'type' => 'string', - 'example' => '1.mov', - ], - 'size' => [ - 'title' => '文件大小', - 'description' => '文件大小', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '218052', - ], - 'updated_at' => [ - 'title' => '更新时间', - 'description' => '更新时间', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1721368014000', - ], + 'name' => ['title' => '文件名', 'description' => '文件名', 'visibility' => 'Public', 'type' => 'string', 'example' => '1.mov'], + 'size' => ['title' => '文件大小', 'description' => '文件大小', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '218052'], + 'updated_at' => ['title' => '更新时间', 'description' => '更新时间', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1721368014000'], 'items' => [ 'title' => '子文件', 'description' => '子文件', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - 'description' => '解压文件信息', - '$ref' => '#/components/schemas/UncompressedFileInfo', - ], + 'items' => ['description' => '解压文件信息', 'visibility' => 'Public', 'extendType' => 'true', '$ref' => '#/components/schemas/UncompressedFileInfo'], ], ], ], @@ -5793,44 +1102,11 @@ 'description' => '表单上传信息', 'type' => 'object', 'properties' => [ - 'bucket_name' => [ - 'title' => 'bucket name', - 'type' => 'string', - ], - 'oss_end_point' => [ - 'title' => 'oss 地址', - 'type' => 'string', - ], - 'object_key' => [ - 'title' => 'oss object key', - 'type' => 'string', - ], - 'oss_access_key_id' => [ - 'title' => '上传的 access id', - 'type' => 'string', - ], - 'oss_security_token' => [ - 'title' => '上传的 sts token', - 'type' => 'string', - ], - 'policy' => [ - 'title' => '上传策略', - 'type' => 'string', - ], - 'signature' => [ - 'title' => '上传签名', - 'type' => 'string', - ], - 'endpoint' => [ - 'title' => '数据存储地址', - 'type' => 'string', - ], + 'endpoint' => ['title' => '数据存储地址', 'type' => 'string'], 'form_data' => [ 'title' => '表单上传信息', 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - ], + 'additionalProperties' => ['type' => 'string'], ], ], ], @@ -5839,42 +1115,13 @@ 'description' => '分段信息', 'type' => 'object', 'properties' => [ - 'part_number' => [ - 'title' => '段编号', - 'description' => '段编号', - 'type' => 'integer', - 'format' => 'int32', - 'required' => true, - 'example' => '1', - ], - 'part_size' => [ - 'title' => '分段大小', - 'description' => '此字段已废弃，请勿使用。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1024', - ], - 'upload_url' => [ - 'title' => '上传地址', - 'description' => '上传地址，默认有效时间15分钟，如果链接超时，需要重新调用GetUploadUrl进行获取'."\n" - .'（开启智能数据域名后，根据请求会自适应返回internal_upload_url值在该字段内）', - 'type' => 'string', - 'required' => true, - 'example' => 'https://data.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661', - ], - 'internal_upload_url' => [ - 'title' => '内网上传地址', - 'description' => '内网上传地址，用于VPC网络内部访问'."\n" - .'（开启智能数据域名后将不再使用该字段，根据请求该参数会自适应返回在upload_url字段值内，如需使用该字段请联系PDS技术支持）', - 'type' => 'string', - 'example' => 'https://data-vpc.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661'."\n", - ], - 'etag' => [ - 'title' => 'etag', - 'description' => '此字段已废弃，请勿使用。', - 'type' => 'string', - 'example' => '"0CC175B9C0F1B6A831C399E269772661"', - ], + 'part_number' => ['title' => '段编号', 'description' => '段编号', 'type' => 'integer', 'format' => 'int32', 'required' => true, 'example' => '1'], + 'part_size' => ['title' => '分段大小', 'description' => '此字段已废弃，请勿使用。', 'type' => 'integer', 'format' => 'int64', 'example' => '1024'], + 'upload_url' => ['title' => '上传地址', 'description' => '上传地址，默认有效时间15分钟，如果链接超时，需要重新调用GetUploadUrl进行获取'."\n" + .'（开启智能数据域名后，根据请求会自适应返回internal_upload_url值在该字段内）', 'type' => 'string', 'required' => true, 'example' => 'https://data.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661'], + 'internal_upload_url' => ['title' => '内网上传地址', 'description' => '内网上传地址，用于VPC网络内部访问'."\n" + .'（开启智能数据域名后将不再使用该字段，根据请求该参数会自适应返回在upload_url字段值内，如需使用该字段请联系PDS技术支持）', 'type' => 'string', 'example' => 'https://data-vpc.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661'."\n"], + 'etag' => ['title' => 'etag', 'description' => '此字段已废弃，请勿使用。', 'type' => 'string', 'example' => '"0CC175B9C0F1B6A831C399E269772661"'], 'parallel_sha1_ctx' => [ 'title' => '上一个分段的sha1上下文', 'description' => '上一个分段的sha1上下文，该字段只在多分片并发上传的模式下有效', @@ -5884,20 +1131,12 @@ 'title' => '上一个数据块SHA1的第1-5个32位变量', 'description' => '上一个数据块SHA1的第1-5个32位变量，该字段只在多分片并发上传的模式下有效', 'type' => 'array', - 'items' => [ - 'type' => 'integer', - 'format' => 'int64', - ], - ], - 'part_offset' => [ - 'title' => '到上一个数据块为止的总长度，字节，需要为64的倍数', - 'description' => '到上一个数据块为止的总长度，字节，需要为64的倍数，该字段只在多分片并发上传的模式下有效', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10240', + 'items' => ['type' => 'integer', 'format' => 'int64', 'description' => ''], ], + 'part_offset' => ['title' => '到上一个数据块为止的总长度，字节，需要为64的倍数', 'description' => '到上一个数据块为止的总长度，字节，需要为64的倍数，该字段只在多分片并发上传的模式下有效', 'type' => 'integer', 'format' => 'int64', 'example' => '10240'], ], ], + 'upload_form_info' => ['title' => '表单上传信息', 'description' => '表单上传信息', '$ref' => '#/components/schemas/UploadFormInfo'], 'parallel_sha256_ctx' => [ 'title' => '上一个分段的sha256上下文', 'description' => '上一个分段的sha256上下文', @@ -5907,17 +1146,9 @@ 'title' => '上一个数据块SHA256的第1-8个32位变量', 'description' => '上一个数据块SHA256的第1-8个32位变量', 'type' => 'array', - 'items' => [ - 'type' => 'integer', - 'format' => 'int64', - ], - ], - 'part_offset' => [ - 'title' => '到上一个数据块为止的总长度，字节，需要为64的倍数', - 'description' => '到上一个数据块为止的总长度，字节，需要为64的倍数', - 'type' => 'integer', - 'format' => 'int64', + 'items' => ['type' => 'integer', 'format' => 'int64', 'description' => ''], ], + 'part_offset' => ['title' => '到上一个数据块为止的总长度，字节，需要为64的倍数', 'description' => '到上一个数据块为止的总长度，字节，需要为64的倍数', 'type' => 'integer', 'format' => 'int64'], ], ], ], @@ -5927,56 +1158,14 @@ 'description' => '用户', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'title' => '域id', - 'description' => '域id', - 'type' => 'string', - 'example' => 'bj1', - ], - 'user_id' => [ - 'title' => '用户id', - 'description' => '用户id', - 'type' => 'string', - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - ], - 'avatar' => [ - 'title' => '头像', - 'description' => '头像', - 'type' => 'string', - 'example' => 'http://aa.com/1.jpg', - ], - 'created_at' => [ - 'title' => '创建时间', - 'description' => '创建时间，格林威治时间1970年01月01日00时00分00秒起至现在的毫秒数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1639762579768', - ], - 'updated_at' => [ - 'title' => '修改时间', - 'description' => '修改时间，格林威治时间1970年01月01日00时00分00秒起至现在的毫秒数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1639762579768', - ], - 'email' => [ - 'title' => '邮箱', - 'description' => '邮箱', - 'type' => 'string', - 'example' => 'a@aliyunpds.com', - ], - 'nick_name' => [ - 'title' => '昵称', - 'description' => '昵称', - 'type' => 'string', - 'example' => '001', - ], - 'phone' => [ - 'title' => '手机号', - 'description' => '手机号', - 'type' => 'string', - 'example' => '13900001111', - ], + 'domain_id' => ['title' => '域id', 'description' => '域id', 'type' => 'string', 'example' => 'bj1'], + 'user_id' => ['title' => '用户id', 'description' => '用户id', 'type' => 'string', 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4'], + 'avatar' => ['title' => '头像', 'description' => '头像', 'type' => 'string', 'example' => 'http://aa.com/1.jpg'], + 'created_at' => ['title' => '创建时间', 'description' => '创建时间，格林威治时间1970年01月01日00时00分00秒起至现在的毫秒数', 'type' => 'integer', 'format' => 'int64', 'example' => '1639762579768'], + 'updated_at' => ['title' => '修改时间', 'description' => '修改时间，格林威治时间1970年01月01日00时00分00秒起至现在的毫秒数', 'type' => 'integer', 'format' => 'int64', 'example' => '1639762579768'], + 'email' => ['title' => '邮箱', 'description' => '邮箱', 'type' => 'string', 'example' => 'a@aliyunpds.com'], + 'nick_name' => ['title' => '昵称', 'description' => '昵称', 'type' => 'string', 'example' => '001'], + 'phone' => ['title' => '手机号', 'description' => '手机号', 'type' => 'string', 'example' => '13900001111'], 'role' => [ 'title' => '角色', 'description' => '角色'."\n" @@ -5987,11 +1176,7 @@ ."\n" .'- user（普通用户）', 'type' => 'string', - 'enumValueTitles' => [ - 'superadmin' => '超级管理员', - 'admin' => '管理员', - 'user' => '普通用户', - ], + 'enumValueTitles' => ['superadmin' => '超级管理员', 'admin' => '管理员', 'user' => '普通用户'], 'example' => 'user', ], 'status' => [ @@ -6002,43 +1187,20 @@ ."\n" .'- enabled（使能）', 'type' => 'string', - 'enumValueTitles' => [ - 'disabled' => '禁止', - 'enabled' => '使能', - ], + 'enumValueTitles' => ['disabled' => '禁止', 'enabled' => '使能'], 'example' => 'enabled', ], - 'user_name' => [ - 'title' => '用户名', - 'description' => '用户名', - 'type' => 'string', - 'example' => 'pds', - ], - 'description' => [ - 'title' => '描述', - 'description' => '描述', - 'type' => 'string', - 'example' => 'vipuser', - ], - 'default_drive_id' => [ - 'title' => '缺省空间id', - 'description' => '缺省空间id', - 'type' => 'string', - 'example' => '1', - ], + 'user_name' => ['title' => '用户名', 'description' => '用户名', 'type' => 'string', 'example' => 'pds'], + 'description' => ['title' => '描述', 'description' => '描述', 'type' => 'string', 'example' => 'vipuser'], + 'default_drive_id' => ['title' => '缺省空间id', 'description' => '缺省空间id', 'type' => 'string', 'example' => '1'], + 'creator' => ['title' => '创建者', 'description' => '创建者', 'type' => 'string', 'example' => 'user1'], + 'last_login_time' => ['type' => 'integer', 'format' => 'int64'], + 'last_refresh_token_time' => ['type' => 'integer', 'format' => 'int64'], 'user_data' => [ 'title' => '用户自定义数据', 'description' => '用户自定义数据', 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - ], - ], - 'creator' => [ - 'title' => '创建者', - 'description' => '创建者', - 'type' => 'string', - 'example' => 'user1', + 'additionalProperties' => ['type' => 'string', 'description' => ''], ], ], ], @@ -6046,540 +1208,267 @@ 'title' => 'A short description of struct', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'title' => 'Domain ID', - 'type' => 'string', - 'example' => 'hz999', - ], - 'user_id' => [ - 'title' => '用户 ID', - 'type' => 'string', - 'example' => 'ccpuserid', - ], - 'avatar' => [ - 'title' => '头像', - 'type' => 'string', - 'example' => 'http://a.b.c/ccp.jpg', - ], - 'created_at' => [ - 'title' => '用户创建时间', - 'type' => 'string', - 'example' => '1567407718386', - ], - 'updated_at' => [ - 'title' => '用户修改时间', - 'type' => 'string', - 'example' => '1567407718386', - ], - 'email' => [ - 'title' => '邮箱', - 'type' => 'string', - 'example' => '123@ccp.com', - ], - 'nick_name' => [ - 'title' => '昵称', - 'type' => 'string', - 'example' => 'abc', - ], - 'phone' => [ - 'title' => '电话', - 'type' => 'string', - 'example' => '13700000000', - ], - 'phone_region' => [ - 'title' => '国家编码', - 'type' => 'string', - ], - 'role' => [ - 'title' => '角色', - 'type' => 'string', - 'example' => 'user', - ], - 'status' => [ - 'title' => '用户状态', - 'type' => 'string', - 'example' => 'enabled', - ], - 'user_name' => [ - 'title' => '用户名称', - 'type' => 'string', - 'example' => 'name', - ], - 'description' => [ - 'title' => '用户备注信息', - 'type' => 'string', - 'example' => 'ccp team user', - ], - 'default_drive_id' => [ - 'title' => '默认 Drive ID', - 'type' => 'string', - 'example' => '123', - ], + 'domain_id' => ['title' => 'Domain ID', 'type' => 'string', 'example' => 'hz999'], + 'user_id' => ['title' => '用户 ID', 'type' => 'string', 'example' => 'ccpuserid'], + 'avatar' => ['title' => '头像', 'type' => 'string', 'example' => 'http://a.b.c/ccp.jpg'], + 'created_at' => ['title' => '用户创建时间', 'type' => 'string', 'example' => '1567407718386'], + 'updated_at' => ['title' => '用户修改时间', 'type' => 'string', 'example' => '1567407718386'], + 'email' => ['title' => '邮箱', 'type' => 'string', 'example' => '123@ccp.com'], + 'nick_name' => ['title' => '昵称', 'type' => 'string', 'example' => 'abc'], + 'phone' => ['title' => '电话', 'type' => 'string', 'example' => '13700000000'], + 'phone_region' => ['title' => '国家编码', 'type' => 'string'], + 'role' => ['title' => '角色', 'type' => 'string', 'example' => 'user'], + 'status' => ['title' => '用户状态', 'type' => 'string', 'example' => 'enabled'], + 'user_name' => ['title' => '用户名称', 'type' => 'string', 'example' => 'name'], + 'description' => ['title' => '用户备注信息', 'type' => 'string', 'example' => 'ccp team user'], + 'default_drive_id' => ['title' => '默认 Drive ID', 'type' => 'string', 'example' => '123'], + 'deny_change_password_by_self' => ['title' => '禁止用户自行修改密码', 'type' => 'boolean'], + 'need_change_password_next_login' => ['title' => '下次登录强制修改密码', 'type' => 'boolean'], + 'creator' => ['title' => 'creator', 'type' => 'string', 'example' => 'system'], + 'expired_at' => ['title' => '用户过期时间', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'is_sync' => ['title' => 'is_sync', 'type' => 'boolean'], + 'default_location' => ['title' => 'default_location', 'type' => 'string'], + 'last_login_time' => ['title' => 'last_login_time', 'type' => 'integer', 'format' => 'int64'], + 'path_status' => ['title' => 'path 开启状态', 'type' => 'string'], + 'default_drive' => ['$ref' => '#/components/schemas/BaseDriveResponse'], + 'last_refresh_token_time' => ['type' => 'integer', 'format' => 'int64'], 'user_data' => [ 'title' => '用户自定义数据，格式为json，可用于配置项、少量临时数据等存储，不超过1K', 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'any', - ], - ], - 'deny_change_password_by_self' => [ - 'title' => '禁止用户自行修改密码', - 'type' => 'boolean', - ], - 'need_change_password_next_login' => [ - 'title' => '下次登录强制修改密码', - 'type' => 'boolean', - ], - 'creator' => [ - 'title' => 'creator', - 'type' => 'string', - 'example' => 'system', - ], - 'expired_at' => [ - 'title' => '用户过期时间', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', + 'additionalProperties' => ['type' => 'any'], ], 'permission' => [ 'title' => 'permission', 'type' => 'object', - 'additionalProperties' => [ - '$ref' => '#/components/schemas/IDPermission', - ], - ], - 'is_sync' => [ - 'title' => 'is_sync', - 'type' => 'boolean', - ], - 'default_location' => [ - 'title' => 'default_location', - 'type' => 'string', - ], - 'last_login_time' => [ - 'title' => 'last_login_time', - 'type' => 'integer', - 'format' => 'int64', - ], - 'path_status' => [ - 'title' => 'path 开启状态', - 'type' => 'string', - ], - 'default_drive' => [ - '$ref' => '#/components/schemas/BaseDriveResponse', + 'additionalProperties' => ['$ref' => '#/components/schemas/IDPermission'], ], 'parent_group' => [ 'title' => 'parent_group', 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/BaseDriveResponse', - ], + 'items' => ['$ref' => '#/components/schemas/BaseDriveResponse'], ], 'account' => [ 'title' => 'account', 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/AccountLinkInfo', - ], - ], - ], - ], - 'UserLogDetail' => [ - 'title' => '用户日志详情', - 'description' => '用户日志详情', - 'type' => 'object', - 'properties' => [ - 'phone' => [ - 'title' => '手机号', - 'type' => 'string', - ], - 'email' => [ - 'title' => '邮箱', - 'type' => 'string', - ], - 'name' => [ - 'title' => '用户名', - 'type' => 'string', - ], - 'role_id' => [ - 'title' => '角色类型', - 'type' => 'string', - ], - 'expired_at' => [ - 'title' => '过期时间', - 'type' => 'integer', - 'format' => 'int64', - ], - 'update_to' => [ - 'title' => '更新后的用户详情', - 'type' => 'object', - 'properties' => [ - 'phone' => [ - 'title' => '手机号', - 'type' => 'string', - ], - 'email' => [ - 'title' => '邮箱', - 'type' => 'string', - ], - 'name' => [ - 'title' => '用户名', - 'type' => 'string', - ], - 'role_id' => [ - 'title' => '角色类型', - 'type' => 'string', - ], - 'expired_at' => [ - 'title' => '过期时间', - 'type' => 'integer', - 'format' => 'int64', - ], - ], + 'items' => ['$ref' => '#/components/schemas/AccountLinkInfo'], ], ], ], 'UserTag' => [ 'title' => 'A short description of struct', 'description' => '用户 tag', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'key' => [ - 'title' => 'key', - 'description' => 'key，不能为空，不能包含 #。单个元素中的 key 和 value 总长度不能超过 2000 字节', - 'type' => 'string', - 'required' => true, - 'example' => 'topic', - ], - 'value' => [ - 'title' => 'value', - 'description' => 'value', - 'type' => 'string', - 'required' => true, - ], + 'key' => ['title' => 'key', 'description' => 'key，不能为空，不能包含 #。单个元素中的 key 和 value 总长度不能超过 2000 字节', 'visibility' => 'Public', 'type' => 'string', 'required' => true, 'example' => 'topic'], + 'value' => ['title' => 'value', 'description' => 'value', 'visibility' => 'Public', 'type' => 'string', 'required' => true], ], ], 'VideoMediaAudioStream' => [ + 'cloudType' => 'public', + 'branchId' => 3105503, + 'branchName' => 'master', + 'paramExtraInfo' => ['$.components.schemas.VideoMediaAudioStream.properties.code_name.description' => '音频编码模式。', '$.components.schemas.VideoMediaAudioStream.properties.bit_rate.description' => '音频比特率，单位为比特每秒（bps）。', '$.components.schemas.VideoMediaAudioStream.properties.duration.description' => '音频时长，单位为秒（s）。', '$.components.schemas.VideoMediaAudioStream.properties.code_name.example' => 'aac', '$.components.schemas.VideoMediaAudioStream.description' => '音频流信息。仅开启增值服务图片处理功能或视频转码功能有效。', '$.components.schemas.VideoMediaAudioStream.properties.bit_rate.example' => '129280', '$.components.schemas.VideoMediaAudioStream.properties.duration.example' => '7704.573000'], 'title' => '音频流信息。仅开启增值服务图片处理功能或视频转码功能有效。', 'description' => '音频流信息。仅开启增值服务图片处理功能或视频转码功能有效。', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'duration' => [ - 'title' => '音频时长，单位为秒（s）。', - 'description' => '音频时长，单位为秒（s）。', - 'type' => 'string', - 'example' => '7704.573000', - ], - 'bit_rate' => [ - 'title' => '音频比特率，单位为比特每秒（bps）。', - 'description' => '音频比特率，单位为比特每秒（bps）。', - 'type' => 'string', - 'example' => '129280', - ], - 'code_name' => [ - 'title' => '音频编码模式。', - 'description' => '音频编码模式。', - 'type' => 'string', - 'example' => 'aac', - ], + 'duration' => ['title' => '音频时长，单位为秒（s）。', 'description' => '音频时长，单位为秒（s）。', 'visibility' => 'Public', 'type' => 'string', 'example' => '7704.573000'], + 'bit_rate' => ['title' => '音频比特率，单位为比特每秒（bps）。', 'description' => '音频比特率，单位为比特每秒（bps）。', 'visibility' => 'Public', 'type' => 'string', 'example' => '129280'], + 'code_name' => ['title' => '音频编码模式。', 'description' => '音频编码模式。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'aac'], ], ], 'VideoMediaMetadata' => [ 'title' => '音视频信息。仅开启增值服务图片处理功能或视频转码功能有效。', 'description' => '视频元数据', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'width' => [ - 'title' => '视频画面宽度，单位为像素（px）。', - 'description' => '视频画面宽度，单位为像素（px）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1920', - ], - 'height' => [ - 'title' => '视频画面高度，单位为像素（px）。', - 'description' => '视频画面高度，单位为像素（px）。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1080', - ], + 'time' => ['title' => '拍摄时间，RFC3339 格式。', 'description' => '拍摄时间，RFC3339 格式。', 'visibility' => 'Private', 'type' => 'string', 'example' => '2006-01-02T15:04:05.000Z07:00'], + 'width' => ['title' => '视频画面宽度，单位为像素（px）。', 'description' => '视频画面宽度，单位为像素（px）。', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1920'], + 'height' => ['title' => '视频画面高度，单位为像素（px）。', 'description' => '视频画面高度，单位为像素（px）。', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1080'], + 'location' => ['title' => 'GPS 经纬度信息。', 'description' => 'GPS 经纬度信息。', 'visibility' => 'Private', 'type' => 'string', 'example' => '30.185453,120.218522'], + 'country' => ['title' => '国家或地区。', 'description' => '国家或地区。', 'visibility' => 'Private', 'type' => 'string', 'example' => 'China'], + 'province' => ['title' => '省。', 'description' => '省。', 'visibility' => 'Private', 'type' => 'string', 'example' => 'Zhejiang'], + 'city' => ['title' => '城市。', 'description' => '城市。', 'visibility' => 'Private', 'type' => 'string', 'example' => 'Hangzhou'], + 'district' => ['title' => '区。', 'description' => '区。', 'visibility' => 'Private', 'type' => 'string', 'example' => 'Xihu'], + 'township' => ['title' => '街道。', 'description' => '街道。', 'visibility' => 'Private', 'type' => 'string', 'example' => 'Xihu'], + 'address_line' => ['title' => '完整地址。', 'description' => '完整地址。', 'visibility' => 'Private', 'type' => 'string', 'example' => 'Zhejiang hangzhou xihu'], 'video_media_video_stream' => [ 'title' => '视频流源信息。', 'description' => '视频流源信息。', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/VideoMediaVideoStream', - ], + 'items' => ['visibility' => 'Public', 'extendType' => 'true', '$ref' => '#/components/schemas/VideoMediaVideoStream'], ], 'video_media_audio_stream' => [ 'title' => '音频流源信息。', 'description' => '音频流源信息。', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/VideoMediaAudioStream', - ], + 'items' => ['visibility' => 'Public', 'extendType' => 'true', '$ref' => '#/components/schemas/VideoMediaAudioStream'], ], ], ], 'VideoMediaVideoStream' => [ + 'cloudType' => 'public', + 'branchId' => 2824060, + 'branchName' => 'master', + 'paramExtraInfo' => ['$.components.schemas.VideoMediaVideoStream.properties.duration.example' => '22.88', '$.components.schemas.VideoMediaVideoStream.properties.frame_count.description' => '视频帧数。', '$.components.schemas.VideoMediaVideoStream.properties.bitrate.description' => '视频流比特率，单位为比特率每秒（bps）。', '$.components.schemas.VideoMediaVideoStream.properties.frame_count.example' => '90', '$.components.schemas.VideoMediaVideoStream.properties.duration.description' => '视频流持续时长，单位为秒（s）。', '$.components.schemas.VideoMediaVideoStream.description' => '视频流信息。仅开启增值服务图片处理功能或视频转码功能有效。', '$.components.schemas.VideoMediaVideoStream.properties.code_name.description' => '视频编码模式。', '$.components.schemas.VideoMediaVideoStream.properties.bitrate.example' => '108420', '$.components.schemas.VideoMediaVideoStream.properties.code_name.example' => 'h264'], 'title' => '视频流信息。仅开启增值服务图片处理功能或视频转码功能有效。', 'description' => '视频流信息。仅开启增值服务图片处理功能或视频转码功能有效。', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'duration' => [ - 'title' => '视频流持续时长，单位为秒（s）。', - 'description' => '视频流持续时长，单位为秒（s）。', - 'type' => 'string', - 'example' => '22.88', - ], - 'bitrate' => [ - 'title' => '视频流比特率，单位为比特率每秒（bps）。', - 'description' => '视频流比特率，单位为比特率每秒（bps）。', - 'type' => 'string', - 'example' => '108420', - ], - 'code_name' => [ - 'title' => '视频编码模式。', - 'description' => '视频编码模式。', - 'type' => 'string', - 'example' => 'h264', - ], - 'frame_count' => [ - 'title' => '视频帧数。', - 'description' => '视频帧数。', - 'type' => 'string', - 'example' => '90', - ], + 'duration' => ['title' => '视频流持续时长，单位为秒（s）。', 'description' => '视频流持续时长，单位为秒（s）。', 'visibility' => 'Public', 'type' => 'string', 'example' => '22.88'], + 'bitrate' => ['title' => '视频流比特率，单位为比特率每秒（bps）。', 'description' => '视频流比特率，单位为比特率每秒（bps）。', 'visibility' => 'Public', 'type' => 'string', 'example' => '108420'], + 'code_name' => ['title' => '视频编码模式。', 'description' => '视频编码模式。', 'visibility' => 'Public', 'type' => 'string', 'example' => 'h264'], + 'frame_count' => ['title' => '视频帧数。', 'description' => '视频帧数。', 'visibility' => 'Public', 'type' => 'string', 'example' => '90'], ], ], 'VideoPreviewPlayInfo' => [ 'title' => '播放信息', 'description' => '播放信息', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'category' => [ - 'title' => '所属分类', - 'description' => '所属分类', - 'type' => 'string', - 'example' => 'quick_video', - ], + 'category' => ['title' => '所属分类', 'description' => '所属分类', 'visibility' => 'Public', 'type' => 'string', 'example' => 'quick_video'], 'meta' => [ 'title' => '视频元信息', 'description' => '视频元信息', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'duration' => [ - 'title' => '视频长度', - 'description' => '视频长度', - 'type' => 'number', - 'format' => 'double', - 'example' => '4.2898', - ], - 'width' => [ - 'title' => '视频宽度', - 'description' => '视频宽度', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1920', - ], - 'height' => [ - 'title' => '视频高度', - 'description' => '视频高度', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1080', - ], + 'duration' => ['title' => '视频长度', 'description' => '视频长度', 'visibility' => 'Public', 'type' => 'number', 'format' => 'double', 'example' => '4.2898'], + 'width' => ['title' => '视频宽度', 'description' => '视频宽度', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1920'], + 'height' => ['title' => '视频高度', 'description' => '视频高度', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1080'], ], ], 'live_transcoding_task_list' => [ 'title' => '播放信息', 'description' => '播放信息', + 'visibility' => 'Public', 'type' => 'array', 'items' => [ + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'template_id' => [ - 'title' => '模板id', - 'description' => '模板id', - 'type' => 'string', - 'example' => '264_480p', - ], - 'status' => [ - 'title' => '状态', - 'description' => '状态。'."\n" - .'枚举值如下：'."\n" - .'- finished, 索引完成，可以获取到url'."\n" - .'- running, 正在索引，请稍等片刻重试'."\n" - .'- failed, 转码失败，请检查是否媒体文件，如果有疑问请联系客服', - 'type' => 'string', - 'example' => 'finished', - ], - 'url' => [ - 'title' => '播放地址', - 'description' => '播放地址', - 'type' => 'string', - 'example' => 'https://example.data.aliyunpds.com/lt/xxx/media.m3u8', - ], + 'template_id' => ['title' => '模板id', 'description' => '模板id', 'visibility' => 'Public', 'type' => 'string', 'example' => '264_480p'], + 'status' => ['title' => '状态', 'description' => '状态。'."\n" + .'枚举值如下：'."\n" + .'- finished, 索引完成，可以获取到url'."\n" + .'- running, 正在索引，请稍等片刻重试'."\n" + .'- failed, 转码失败，请检查是否媒体文件，如果有疑问请联系客服', 'visibility' => 'Public', 'type' => 'string', 'example' => 'finished'], + 'url' => ['title' => '播放地址', 'description' => '播放地址', 'visibility' => 'Public', 'type' => 'string', 'example' => 'https://example.data.aliyunpds.com/lt/xxx/media.m3u8'], 'keep_original_resolution' => [ 'title' => '是否保持原分辨率', 'description' => '是否保持原分辨率', + 'visibility' => 'Public', 'type' => 'boolean', - 'enumValueTitles' => [ - 'true' => 'true', - 'false' => 'false', - ], + 'enumValueTitles' => ['true' => 'true', 'false' => 'false'], 'example' => 'true', ], + 'preview_url' => ['title' => '视频片段预览播放地址', 'description' => '视频片段预览播放地址', 'visibility' => 'Private', 'type' => 'string', 'example' => 'https://example.data.aliyunpds.com/lt/xxx/ref_task.m3u8'], ], + 'extendType' => 'true', ], ], 'quick_video_list' => [ 'title' => '播放信息', 'description' => '播放信息', + 'visibility' => 'Public', 'type' => 'array', 'items' => [ + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'template_id' => [ - 'title' => '模板id', - 'description' => '模板id', - 'type' => 'string', - 'example' => '264_480p', - ], - 'status' => [ - 'title' => '状态', - 'description' => '枚举值如下：'."\n" - .'- finished, 索引完成，可以获取到url'."\n" - .'- running, 正在索引，请稍等片刻重试'."\n" - .'- failed, 转码失败，请检查是否媒体文件，如果有疑问请联系客服', - 'type' => 'string', - 'example' => 'finished', - ], - 'url' => [ - 'title' => '播放地址', - 'description' => '播放地址', - 'type' => 'string', - 'example' => 'https://example.data.aliyunpds.com/qv/xxx/media.m3u8', - ], + 'template_id' => ['title' => '模板id', 'description' => '模板id', 'visibility' => 'Public', 'type' => 'string', 'example' => '264_480p'], + 'status' => ['title' => '状态', 'description' => '枚举值如下：'."\n" + .'- finished, 索引完成，可以获取到url'."\n" + .'- running, 正在索引，请稍等片刻重试'."\n" + .'- failed, 转码失败，请检查是否媒体文件，如果有疑问请联系客服', 'visibility' => 'Public', 'type' => 'string', 'example' => 'finished'], + 'url' => ['title' => '播放地址', 'description' => '播放地址', 'visibility' => 'Public', 'type' => 'string', 'example' => 'https://example.data.aliyunpds.com/qv/xxx/media.m3u8'], + 'preview_url' => ['title' => '视频片段预览播放地址', 'description' => '视频片段预览播放地址', 'visibility' => 'Private', 'type' => 'string', 'example' => 'https://example.data.aliyunpds.com/qv/xxx/ref_task.m3u8'], ], + 'extendType' => 'true', ], ], 'offline_video_transcoding_list' => [ 'title' => '离线转码播放信息', 'description' => '离线转码播放信息', + 'visibility' => 'Public', 'type' => 'array', 'items' => [ + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'template_id' => [ - 'title' => '模板 ID', - 'description' => '模板 ID', - 'type' => 'string', - 'example' => '264_1080p', - ], - 'status' => [ - 'title' => '任务状态', - 'description' => '任务状态', - 'type' => 'string', - 'example' => 'finished', - ], + 'template_id' => ['title' => '模板 ID', 'description' => '模板 ID', 'visibility' => 'Public', 'type' => 'string', 'example' => '264_1080p'], + 'status' => ['title' => '任务状态', 'description' => '任务状态', 'visibility' => 'Public', 'type' => 'string', 'example' => 'finished'], 'keep_original_resolution' => [ 'title' => '转码视频是否和源视频同分辨率', 'description' => '转码视频是否和源视频同分辨率', + 'visibility' => 'Public', 'type' => 'boolean', - 'enumValueTitles' => [ - 'true' => 'true', - 'false' => 'false', - ], + 'enumValueTitles' => ['true' => 'true', 'false' => 'false'], 'example' => 'true', ], - 'url' => [ - 'title' => '播放地址', - 'description' => '播放地址', - 'type' => 'string', - 'example' => 'https://example.data.aliyunpds.com/xxx/master.mp4'."\n", - ], + 'url' => ['title' => '播放地址', 'description' => '播放地址', 'visibility' => 'Public', 'type' => 'string', 'example' => 'https://example.data.aliyunpds.com/xxx/master.mp4'."\n"], ], + 'extendType' => 'true', ], ], 'live_transcoding_subtitle_task_list' => [ 'title' => '边转边播字幕信息', 'description' => '边转边播字幕信息', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/VideoPreviewSubtitleInfo', - ], + 'items' => ['visibility' => 'Public', 'extendType' => 'true', '$ref' => '#/components/schemas/VideoPreviewSubtitleInfo'], ], 'quick_video_subtitle_list' => [ 'title' => '快速转码字幕信息', 'description' => '快速转码字幕信息', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/VideoPreviewSubtitleInfo', - ], + 'items' => ['visibility' => 'Public', 'extendType' => 'true', '$ref' => '#/components/schemas/VideoPreviewSubtitleInfo'], ], 'offline_video_transcoding_subtitle_list' => [ 'title' => '离线转码字幕信息', 'description' => '离线转码字幕信息', + 'visibility' => 'Public', 'type' => 'array', - 'items' => [ - '$ref' => '#/components/schemas/VideoPreviewSubtitleInfo', - ], - ], - 'master_url' => [ - 'title' => 'master m3u8 的播放链接', - 'description' => 'master m3u8 的播放链接', - 'type' => 'string', - 'example' => 'https://pds-xxx-valueadd.oss-xxx.aliyuncs.com/qv/xxx/master.m3u8', + 'items' => ['visibility' => 'Public', 'extendType' => 'true', '$ref' => '#/components/schemas/VideoPreviewSubtitleInfo'], ], + 'master_url' => ['title' => 'master m3u8 的播放链接', 'description' => 'master m3u8 的播放链接', 'visibility' => 'Public', 'type' => 'string', 'example' => 'https://pds-xxx-valueadd.oss-xxx.aliyuncs.com/qv/xxx/master.m3u8'], ], ], 'VideoPreviewPlayMeta' => [ 'title' => '播放元信息', 'description' => '播放元信息', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ 'meta' => [ 'title' => '视频元信息', 'description' => '视频元信息', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'duration' => [ - 'title' => '视频长度', - 'description' => '视频长度', - 'type' => 'number', - 'format' => 'double', - 'example' => '10', - ], - 'width' => [ - 'title' => '视频宽度', - 'description' => '视频宽度', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1280', - ], - 'height' => [ - 'title' => '视频高度', - 'description' => '视频高度', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '720', - ], + 'duration' => ['title' => '视频长度', 'description' => '视频长度', 'visibility' => 'Public', 'type' => 'number', 'format' => 'double', 'example' => '10'], + 'width' => ['title' => '视频宽度', 'description' => '视频宽度', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '1280'], + 'height' => ['title' => '视频高度', 'description' => '视频高度', 'visibility' => 'Public', 'type' => 'integer', 'format' => 'int64', 'example' => '720'], ], ], 'live_transcoding_task_list' => [ 'title' => '边转边播任务状态', 'description' => '边转边播任务状态', + 'visibility' => 'Public', 'type' => 'array', 'items' => [ + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'template_id' => [ - 'title' => '模板id', - 'description' => '模板id', - 'type' => 'string', - 'example' => '264_720p', - ], + 'template_id' => ['title' => '模板id', 'description' => '模板id', 'visibility' => 'Public', 'type' => 'string', 'example' => '264_720p'], 'status' => [ 'title' => '状态。 枚举值如下： finished, 索引完成，可以获取到url running, 正在索引，请稍等片刻重试 failed, 转码失败，请检查是否媒体文件，如果有疑问请联系客服', 'description' => '状态。'."\n" @@ -6587,81 +1476,53 @@ .'- finished, 索引完成，可以获取到url'."\n" .'- running, 正在索引，请稍等片刻重试'."\n" .'- failed, 转码失败，请检查是否媒体文件，如果有疑问请联系客服', + 'visibility' => 'Public', 'type' => 'string', - 'enumValueTitles' => [ - 'running' => 'running', - 'finished' => 'finished', - 'failed' => 'failed', - ], + 'enumValueTitles' => ['running' => 'running', 'finished' => 'finished', 'failed' => 'failed'], 'example' => 'finished', ], 'keep_original_resolution' => [ 'title' => '是否保持原分辨率', 'description' => '是否保持原分辨率', + 'visibility' => 'Public', 'type' => 'boolean', - 'enumValueTitles' => [ - 'true' => 'true', - 'false' => 'false', - ], + 'enumValueTitles' => ['true' => 'true', 'false' => 'false'], 'example' => 'true', ], ], + 'extendType' => 'true', ], ], - 'category' => [ - 'title' => '所属分类', - 'description' => '所属分类', - 'type' => 'string', - 'example' => 'live_transcoding', - ], + 'category' => ['title' => '所属分类', 'description' => '所属分类', 'visibility' => 'Public', 'type' => 'string', 'example' => 'live_transcoding'], 'quick_video_list' => [ 'title' => '快速转码任务状态', 'description' => '快速转码任务状态', + 'visibility' => 'Public', 'type' => 'array', 'items' => [ + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'template_id' => [ - 'title' => '模板id', - 'description' => '模板id', - 'type' => 'string', - 'example' => '264_720p', - ], - 'status' => [ - 'title' => '状态。 枚举值如下： finished, 索引完成，可以获取到url running, 正在索引，请稍等片刻重试 failed, 转码失败，请检查是否媒体文件，如果有疑问请联系客服', - 'description' => '状态。 枚举值如下： finished, 索引完成，可以获取到url running, 正在索引，请稍等片刻重试 failed, 转码失败，请检查是否媒体文件，如果有疑问请联系客服', - 'type' => 'string', - 'example' => 'finished', - ], + 'template_id' => ['title' => '模板id', 'description' => '模板id', 'visibility' => 'Public', 'type' => 'string', 'example' => '264_720p'], + 'status' => ['title' => '状态。 枚举值如下： finished, 索引完成，可以获取到url running, 正在索引，请稍等片刻重试 failed, 转码失败，请检查是否媒体文件，如果有疑问请联系客服', 'description' => '状态。 枚举值如下： finished, 索引完成，可以获取到url running, 正在索引，请稍等片刻重试 failed, 转码失败，请检查是否媒体文件，如果有疑问请联系客服', 'visibility' => 'Public', 'type' => 'string', 'example' => 'finished'], ], + 'extendType' => 'true', ], ], 'offline_video_transcoding_list' => [ 'title' => '离线转码任务状态', 'description' => '离线转码任务状态', + 'visibility' => 'Public', 'type' => 'array', 'items' => [ + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'template_id' => [ - 'title' => '模板id', - 'description' => '模板id', - 'type' => 'string', - 'example' => '264_720p', - ], - 'status' => [ - 'title' => '状态。 枚举值如下： finished, 索引完成，可以获取到url running, 正在索引，请稍等片刻重试 failed, 转码失败，请检查是否媒体文件，如果有疑问请联系客服', - 'description' => '状态。 枚举值如下： finished, 索引完成，可以获取到url running, 正在索引，请稍等片刻重试 failed, 转码失败，请检查是否媒体文件，如果有疑问请联系客服', - 'type' => 'string', - 'example' => 'finished', - ], - 'keep_original_resolution' => [ - 'title' => '是否保持原分辨率', - 'description' => '是否保持原分辨率', - 'type' => 'string', - 'example' => 'true', - ], + 'template_id' => ['title' => '模板id', 'description' => '模板id', 'visibility' => 'Public', 'type' => 'string', 'example' => '264_720p'], + 'status' => ['title' => '状态。 枚举值如下： finished, 索引完成，可以获取到url running, 正在索引，请稍等片刻重试 failed, 转码失败，请检查是否媒体文件，如果有疑问请联系客服', 'description' => '状态。 枚举值如下： finished, 索引完成，可以获取到url running, 正在索引，请稍等片刻重试 failed, 转码失败，请检查是否媒体文件，如果有疑问请联系客服', 'visibility' => 'Public', 'type' => 'string', 'example' => 'finished'], + 'keep_original_resolution' => ['title' => '是否保持原分辨率', 'description' => '是否保持原分辨率', 'visibility' => 'Public', 'type' => 'string', 'example' => 'true'], ], + 'extendType' => 'true', ], ], ], @@ -6669,309 +1530,50 @@ 'VideoPreviewSubtitleInfo' => [ 'title' => '字幕任务信息', 'description' => '字幕任务信息', + 'visibility' => 'Public', 'type' => 'object', 'properties' => [ - 'language' => [ - 'title' => '字幕语言', - 'description' => '字幕语言', - 'type' => 'string', - 'example' => 'en', - ], + 'language' => ['title' => '字幕语言', 'description' => '字幕语言', 'visibility' => 'Public', 'type' => 'string', 'example' => 'en'], 'status' => [ 'title' => '字幕任务状态', 'description' => '字幕任务状态', + 'visibility' => 'Public', 'type' => 'string', - 'enumValueTitles' => [ - 'finished' => 'finished', - 'failed' => 'failed', - ], + 'enumValueTitles' => ['finished' => 'finished', 'failed' => 'failed'], 'example' => 'finished', ], - 'url' => [ - 'title' => '字幕 URL', - 'description' => '字幕 URL', - 'type' => 'string', - 'example' => 'https://example.data.aliyunpds.com/lt/A05EF408DAB5D3F57C94F67658C99C406EFCA7DD/subtitle/subtitle_0.vtt', - ], - ], - ], - 'View' => [ - 'title' => 'view 详情', - 'type' => 'object', - 'properties' => [ - 'view_id' => [ - 'title' => 'view id', - 'type' => 'string', - ], - 'category' => [ - 'title' => '类型', - 'type' => 'string', - ], - 'owner' => [ - 'title' => '所有者', - 'type' => 'string', - ], - 'name' => [ - 'title' => '名称', - 'type' => 'string', - ], - 'description' => [ - 'title' => '描述', - 'type' => 'string', - ], - 'created_at' => [ - 'title' => '创建时间', - 'type' => 'string', - ], - 'updated_at' => [ - 'title' => '更新时间', - 'type' => 'string', - ], - 'file_count' => [ - 'title' => '所添加文件数量', - 'type' => 'integer', - 'format' => 'int64', - ], - 'ex_fields_info' => [ - 'title' => '额外属性', - 'type' => 'object', - ], - ], - ], - 'ViewFile' => [ - 'title' => 'view file 详情', - 'type' => 'object', - 'properties' => [ - 'domain_id' => [ - 'title' => '域id', - 'type' => 'string', - ], - 'drive_id' => [ - 'title' => '空间id', - 'type' => 'string', - ], - 'file_id' => [ - 'title' => '文件id', - 'type' => 'string', - ], - 'name' => [ - 'title' => '名称', - 'type' => 'string', - ], - 'type' => [ - 'title' => '类型', - 'type' => 'string', - ], - 'content_type' => [ - 'title' => '内容类型', - 'type' => 'string', - ], - 'created_at' => [ - 'title' => '创建时间', - 'type' => 'string', - ], - 'updated_at' => [ - 'title' => '修改时间', - 'type' => 'string', - ], - 'description' => [ - 'title' => '描述', - 'type' => 'string', - ], - 'trashed_at' => [ - 'title' => '放入回收站时间', - 'type' => 'string', - ], - 'file_extension' => [ - 'title' => '文件扩展', - 'type' => 'string', - ], - 'hidden' => [ - 'title' => '是否隐藏', - 'type' => 'boolean', - ], - 'size' => [ - 'title' => '大小', - 'type' => 'integer', - 'format' => 'int64', - ], - 'starred' => [ - 'title' => '是否收藏', - 'type' => 'boolean', - ], - 'status' => [ - 'title' => '状态', - 'type' => 'string', - ], - 'labels' => [ - 'title' => '标签', - 'type' => 'array', - 'items' => [ - 'type' => 'string', - ], - ], - 'upload_id' => [ - 'title' => '上传id', - 'type' => 'string', - ], - 'parent_file_id' => [ - 'title' => '父文件夹id', - 'type' => 'string', - ], - 'crc64_hash' => [ - 'title' => 'crc64', - 'type' => 'string', - ], - 'content_hash' => [ - 'title' => '内容hash', - 'type' => 'string', - ], - 'content_hash_name' => [ - 'title' => '内容hash算法名', - 'type' => 'string', - ], - 'download_url' => [ - 'title' => '下载链接', - 'type' => 'string', - ], - 'thumbnail' => [ - 'title' => '缩略图地址', - 'type' => 'string', - ], - 'category' => [ - 'title' => '分类', - 'type' => 'string', - ], - 'local_created_at' => [ - 'title' => '文件本地创建时间', - 'type' => 'string', - ], - 'local_modified_at' => [ - 'title' => '文件本地修改时间', - 'type' => 'string', - ], - 'revision_id' => [ - 'title' => '版本id', - 'type' => 'string', - ], - 'investigation_info' => [ - 'title' => '审核信息', - 'type' => 'object', - 'properties' => [ - 'status' => [ - 'title' => '审核状态', - 'type' => 'integer', - 'format' => 'int64', - ], - 'suggestion' => [ - 'title' => '审核建议执行的操作', - 'type' => 'string', - ], - ], - ], - 'thumbnail_urls' => [ - 'title' => '返回的缩略图信息', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'string', - 'required' => false, - ], - ], - 'view_id' => [ - 'title' => 'view id', - 'type' => 'string', - ], - 'joined_at' => [ - 'title' => '加入 view 时间', - 'type' => 'integer', - 'format' => 'int64', - ], - 'file_revision_id' => [ - 'title' => '文件版本号', - 'type' => 'string', - ], - 'fields' => [ - 'title' => 'view 相关属性', - 'type' => 'object', - ], - ], - ], - 'WatermarkEnableConfig' => [ - 'title' => 'WatermarkEnableConfig', - 'type' => 'object', - 'properties' => [ - 'enable_doc_preview' => [ - 'title' => 'enable_doc_preview', - 'type' => 'boolean', - ], - 'display_access_user_name' => [ - 'title' => 'display_access_user_name', - 'type' => 'boolean', - ], - 'display_shareLink_creator_name' => [ - 'title' => 'display_shareLink_creator_name', - 'type' => 'boolean', - ], - 'display_custom_text' => [ - 'title' => 'display_custom_text', - 'type' => 'string', - ], - ], - ], - 'WxTrustedDomainConfig' => [ - 'title' => 'WxTrustedDomainConfig', - 'type' => 'object', - 'properties' => [ - 'name' => [ - 'title' => 'name', - 'type' => 'string', - ], - 'content' => [ - 'title' => 'content', - 'type' => 'string', - ], - 'show' => [ - 'title' => 'show', - 'type' => 'boolean', - ], + 'url' => ['title' => '字幕 URL', 'description' => '字幕 URL', 'visibility' => 'Public', 'type' => 'string', 'example' => 'https://example.data.aliyunpds.com/lt/A05EF408DAB5D3F57C94F67658C99C406EFCA7DD/subtitle/subtitle_0.vtt'], ], ], ], ], 'apis' => [ - 'CreateDomain' => [ - 'summary' => '创建 domain。', - 'path' => '/v2/domain/create', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'tags' => [ - 'admin', - ], + 'AddGroupMember' => [ + 'summary' => '添加成员到群组。', + 'path' => '/v2/group/add_member', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], ], + [ + 'BearerToken' => [], + ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'readAndWrite', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => [], 'parameters' => [ [ + 'name' => 'domain_id', + 'in' => 'host', + 'schema' => ['title' => 'A short description of struct', 'description' => 'A short description of struct', 'type' => 'string', 'required' => true], + ], + [ 'name' => 'body', 'in' => 'body', 'style' => 'json', @@ -6979,142 +1581,85 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'parent_domain_id' => [ - 'description' => '父 domain id'."\n" - .'如果需要创建子 domain，可以设置该值，一般情况下不需要创建。'."\n" - .'如果需要针对 PDS 做二次运营，可以联系 PDS 官网客服进行咨询。', - 'type' => 'string', - 'required' => false, - 'example' => 'bj1', - ], - 'domain_name' => [ - 'description' => 'domain 名称', - 'type' => 'string', - 'required' => true, - 'example' => 'cloud drive', - ], - 'description' => [ - 'description' => 'domain 描述', - 'type' => 'string', - 'required' => false, - 'example' => 'cloud drive dev', - ], - 'init_drive_enable' => [ - 'description' => '是否开通默认网盘。为true则所有用户在第一次登录后都默认分配一个网盘。默认false', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'init_drive_size' => [ - 'description' => 'init\\_drive\\_enable 为true时必选。 创建用户时，默认网盘的大小，单位：Bytes。'."\n" - .'默认为 0，此时创建的 drive 大小为0，不可以上传文件，如果需要初始化 drive， 请设置该值。'."\n" - .'-1则表示不限大小。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1073741824', - ], - 'user_count_quota' => [ - 'description' => '用户数配额，表示该 domain 允许创建的用户数量，为0表示不限制', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '50', - ], - 'size_quota' => [ - 'description' => '容量配额，表示 domain 下所有 drive 的总quota 大小，0 表示不限制', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1099511627776', - ], - 'store_redundancy_type' => [ - 'description' => '指定存储冗余类型。枚举值： '."\n" - .'+ LRS：本地冗余'."\n" - .'+ ZRS：同城冗余', - 'type' => 'string', - 'required' => false, - 'example' => 'LRS', - 'enum' => [], - ], + 'group_id' => ['description' => '目标群组ID，表示将成员添加到目标群组下', 'type' => 'string', 'required' => true, 'example' => '3e5***2c2'], + 'member_type' => ['description' => '成员类型，当前只能添加用户，群组可以在创建时直接选择加入的父群组'."\n" + ."\n" + .'- user（用户）'."\n" + ."\n\n" + .'注意：群组只能作为一个群组的成员，不能同时成为多个群组的成员。 用户可以同时成为多个群组的成员', 'type' => 'string', 'required' => true, 'example' => 'user'], + 'member_id' => ['description' => '成员ID， 当member\\_type为user时，此字段填对应的userID。 ', 'type' => 'string', 'required' => true, 'example' => '2e4***1b1'], ], 'required' => false, ], ], ], 'responses' => [ - 200 => [ + 204 => [ + 'headers' => [], 'schema' => [ - 'description' => '创建的域信息', - '$ref' => '#/components/schemas/Domain', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '添加群组成员', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"parent_domain_id\\": \\"\\",\\n \\"domain_id\\": \\"\\",\\n \\"domain_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"init_drive_enable\\": true,\\n \\"init_drive_size\\": 0,\\n \\"updated_at\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"size_quota\\": 0,\\n \\"size_quota_used\\": 0,\\n \\"user_count_quota\\": 0,\\n \\"status\\": 0,\\n \\"used_size\\": 0,\\n \\"published_app_access_strategy\\": {\\n \\"effect\\": \\"\\",\\n \\"except_app_id_list\\": [\\n \\"\\"\\n ]\\n },\\n \\"watermark_config\\": {\\n \\"enable_doc_preview\\": true,\\n \\"display_access_user_name\\": true,\\n \\"display_shareLink_creator_name\\": true,\\n \\"display_custom_text\\": \\"\\"\\n },\\n \\"auth_config\\": {\\n \\"key\\": {\\n \\"enable\\": true,\\n \\"app_id\\": \\"\\",\\n \\"app_secret\\": \\"\\",\\n \\"endpoint\\": \\"\\",\\n \\"enterprise_id\\": \\"\\",\\n \\"white_list_enable\\": true,\\n \\"ldap_config\\": {\\n \\"version\\": \\"\\",\\n \\"host\\": \\"\\",\\n \\"port\\": 0,\\n \\"uid\\": \\"\\",\\n \\"admin_dn\\": \\"\\",\\n \\"global_uid\\": \\"\\",\\n \\"admin_password\\": \\"\\",\\n \\"base_dn\\": \\"\\",\\n \\"display_name_key\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"sync_config\\": {\\n \\"enabled\\": true,\\n \\"group_object_class\\": \\"\\",\\n \\"group_filter\\": \\"\\",\\n \\"user_object_class\\": \\"\\",\\n \\"user_filter\\": \\"\\",\\n \\"cron\\": \\"\\"\\n }\\n },\\n \\"ding_sync_config\\": {\\n \\"enabled\\": true,\\n \\"cron\\": \\"\\",\\n \\"sync_mobile_enabled\\": true,\\n \\"sync_email_enabled\\": true\\n },\\n \\"we_chat_sync_config\\": {\\n \\"enabled\\": true,\\n \\"tag_id\\": \\"\\",\\n \\"cron\\": \\"\\"\\n },\\n \\"lark_sync_config\\": {\\n \\"enabled\\": true,\\n \\"cron\\": \\"\\",\\n \\"sync_mobile_enabled\\": true,\\n \\"sync_email_enabled\\": true\\n }\\n }\\n },\\n \\"sharable\\": true,\\n \\"ali_owner_id\\": \\"\\",\\n \\"archive_files_config\\": {\\n \\"enabled\\": true,\\n \\"version\\": \\"\\"\\n },\\n \\"uncompress_config\\": {\\n \\"enabled\\": true,\\n \\"version\\": \\"\\"\\n },\\n \\"multi_revision_config\\": {\\n \\"revision_merge_enabled\\": true,\\n \\"revision_count\\": 0,\\n \\"revision_recycle_period\\": 0\\n },\\n \\"app_config\\": {\\n \\"same_name_file_upload_mode\\": \\"\\",\\n \\"web_client_download_mode\\": \\"\\",\\n \\"single_file_upload_size_limit\\": 0,\\n \\"allow_upload_file_category_list\\": [\\n \\"\\"\\n ],\\n \\"allow_upload_custom_file_ext_list\\": [\\n \\"\\"\\n ]\\n },\\n \\"recycle_bin_config\\": {\\n \\"auto_delete_enabled\\": true,\\n \\"auto_delete_keep_second\\": 0,\\n \\"delete_trash_normal_file_disabled\\": true\\n },\\n \\"office_preview_config\\": {\\n \\"enabled\\": true\\n },\\n \\"office_edit_config\\": {\\n \\"enabled\\": true\\n },\\n \\"share_link_detail\\": {\\n \\"enable_office_editable\\": true\\n },\\n \\"endpoints\\": {\\n \\"api_endpoint\\": \\"\\",\\n \\"api_vpc_endpoint\\": \\"\\",\\n \\"app_endpoint\\": \\"\\",\\n \\"auth_endpoint\\": \\"\\",\\n \\"mgmt_endpoint\\": \\"\\",\\n \\"web_office_endpoint_list\\": \\"\\",\\n \\"store_list\\": [\\n {\\n \\"store_id\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"bucket\\": \\"\\",\\n \\"base_path\\": \\"\\",\\n \\"role_arn\\": \\"\\",\\n \\"ownership\\": \\"\\",\\n \\"location\\": \\"\\",\\n \\"public_endpoint\\": \\"\\",\\n \\"vpc_endpoint\\": \\"\\",\\n \\"acc_endpoint\\": \\"\\",\\n \\"acc_oversea_endpoint\\": \\"\\",\\n \\"cdn_endpoint\\": \\"\\",\\n \\"endpoint\\": \\"\\"\\n }\\n ],\\n \\"va_store_list\\": [\\n {\\n \\"store_id\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"bucket\\": \\"\\",\\n \\"base_path\\": \\"\\",\\n \\"role_arn\\": \\"\\",\\n \\"ownership\\": \\"\\",\\n \\"location\\": \\"\\",\\n \\"public_endpoint\\": \\"\\",\\n \\"vpc_endpoint\\": \\"\\",\\n \\"acc_endpoint\\": \\"\\",\\n \\"acc_oversea_endpoint\\": \\"\\",\\n \\"cdn_endpoint\\": \\"\\",\\n \\"endpoint\\": \\"\\"\\n }\\n ]\\n },\\n \\"data_hash_name\\": \\"\\",\\n \\"store_redundancy_type\\": \\"LRS\\",\\n \\"system_drive_config\\": {\\n \\"enable\\": true,\\n \\"drive_id\\": \\"\\",\\n \\"resource_parent_file_id_map\\": {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n }\\n },\\n \\"endpoint_version\\": 0\\n}","type":"json"}]', - 'title' => '创建Domain', - 'description' => '如果您需要基于 PDS 做二次运营，并想针对您的租户做一些细粒度控制，此时可以使用 PDS 的父子 Domain 功能。'."\n" - .'详情：请联系官方钉钉群进行咨询：23146118', + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', ], - 'GetDomain' => [ - 'summary' => '获取Domain信息。', - 'path' => '/v2/domain/get', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'tags' => [ - 'admin', - ], + 'AddStoryFiles' => [ + 'summary' => '给指定故事添加文件。', + 'path' => '/v2/image/add_story_files', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], ], + [ + 'BearerToken' => [], + ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'read', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ + 'name' => 'domain_id', + 'in' => 'host', + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], + ], + [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求参数。', + 'description' => '请求体参数', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'description' => 'domain id', - 'type' => 'string', - 'required' => true, - 'example' => 'bj1', - ], - 'get_quota_used' => [ - 'description' => '是否需要获取domain的已用quota，默认为false。当domain容量配额size_quota大于0时，传true可获取domain已用容量配额。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'fields' => [ - 'description' => '需要获取的 domain 属性字段，英文逗号分隔，为空代表不获取任何枚举字段', - 'type' => 'string', + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'story_id' => ['description' => '故事 id', 'type' => 'string', 'required' => true, 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003'], + 'files' => [ + 'description' => '文件列表', + 'type' => 'array', + 'items' => [ + 'description' => '文件信息', + 'type' => 'object', + 'properties' => [ + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf'], + 'revision_id' => ['description' => '版本 id', 'type' => 'string', 'required' => false, 'example' => '642a88dd06e49d9c0a14411ebae606f70edd9a59'], + ], + 'required' => false, + ], 'required' => false, - 'example' => 'file_category', + 'maxItems' => 100, ], ], 'required' => false, @@ -7124,204 +1669,79 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => 'domain 信息', - '$ref' => '#/components/schemas/Domain', - ], - ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"parent_domain_id\\": \\"\\",\\n \\"domain_id\\": \\"\\",\\n \\"domain_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"init_drive_enable\\": true,\\n \\"init_drive_size\\": 0,\\n \\"updated_at\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"size_quota\\": 0,\\n \\"size_quota_used\\": 0,\\n \\"user_count_quota\\": 0,\\n \\"status\\": 0,\\n \\"used_size\\": 0,\\n \\"published_app_access_strategy\\": {\\n \\"effect\\": \\"\\",\\n \\"except_app_id_list\\": [\\n \\"\\"\\n ]\\n },\\n \\"watermark_config\\": {\\n \\"enable_doc_preview\\": true,\\n \\"display_access_user_name\\": true,\\n \\"display_shareLink_creator_name\\": true,\\n \\"display_custom_text\\": \\"\\"\\n },\\n \\"auth_config\\": {\\n \\"key\\": {\\n \\"enable\\": true,\\n \\"app_id\\": \\"\\",\\n \\"app_secret\\": \\"\\",\\n \\"endpoint\\": \\"\\",\\n \\"enterprise_id\\": \\"\\",\\n \\"white_list_enable\\": true,\\n \\"ldap_config\\": {\\n \\"version\\": \\"\\",\\n \\"host\\": \\"\\",\\n \\"port\\": 0,\\n \\"uid\\": \\"\\",\\n \\"admin_dn\\": \\"\\",\\n \\"global_uid\\": \\"\\",\\n \\"admin_password\\": \\"\\",\\n \\"base_dn\\": \\"\\",\\n \\"display_name_key\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"sync_config\\": {\\n \\"enabled\\": true,\\n \\"group_object_class\\": \\"\\",\\n \\"group_filter\\": \\"\\",\\n \\"user_object_class\\": \\"\\",\\n \\"user_filter\\": \\"\\",\\n \\"cron\\": \\"\\"\\n }\\n },\\n \\"ding_sync_config\\": {\\n \\"enabled\\": true,\\n \\"cron\\": \\"\\",\\n \\"sync_mobile_enabled\\": true,\\n \\"sync_email_enabled\\": true\\n },\\n \\"we_chat_sync_config\\": {\\n \\"enabled\\": true,\\n \\"tag_id\\": \\"\\",\\n \\"cron\\": \\"\\"\\n },\\n \\"lark_sync_config\\": {\\n \\"enabled\\": true,\\n \\"cron\\": \\"\\",\\n \\"sync_mobile_enabled\\": true,\\n \\"sync_email_enabled\\": true\\n }\\n }\\n },\\n \\"sharable\\": true,\\n \\"ali_owner_id\\": \\"\\",\\n \\"archive_files_config\\": {\\n \\"enabled\\": true,\\n \\"version\\": \\"\\"\\n },\\n \\"uncompress_config\\": {\\n \\"enabled\\": true,\\n \\"version\\": \\"\\"\\n },\\n \\"multi_revision_config\\": {\\n \\"revision_merge_enabled\\": true,\\n \\"revision_count\\": 0,\\n \\"revision_recycle_period\\": 0\\n },\\n \\"app_config\\": {\\n \\"same_name_file_upload_mode\\": \\"\\",\\n \\"web_client_download_mode\\": \\"\\",\\n \\"single_file_upload_size_limit\\": 0,\\n \\"allow_upload_file_category_list\\": [\\n \\"\\"\\n ],\\n \\"allow_upload_custom_file_ext_list\\": [\\n \\"\\"\\n ]\\n },\\n \\"recycle_bin_config\\": {\\n \\"auto_delete_enabled\\": true,\\n \\"auto_delete_keep_second\\": 0,\\n \\"delete_trash_normal_file_disabled\\": true\\n },\\n \\"office_preview_config\\": {\\n \\"enabled\\": true\\n },\\n \\"office_edit_config\\": {\\n \\"enabled\\": true\\n },\\n \\"share_link_detail\\": {\\n \\"enable_office_editable\\": true\\n },\\n \\"endpoints\\": {\\n \\"api_endpoint\\": \\"\\",\\n \\"api_vpc_endpoint\\": \\"\\",\\n \\"app_endpoint\\": \\"\\",\\n \\"auth_endpoint\\": \\"\\",\\n \\"mgmt_endpoint\\": \\"\\",\\n \\"web_office_endpoint_list\\": \\"\\",\\n \\"store_list\\": [\\n {\\n \\"store_id\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"bucket\\": \\"\\",\\n \\"base_path\\": \\"\\",\\n \\"role_arn\\": \\"\\",\\n \\"ownership\\": \\"\\",\\n \\"location\\": \\"\\",\\n \\"public_endpoint\\": \\"\\",\\n \\"vpc_endpoint\\": \\"\\",\\n \\"acc_endpoint\\": \\"\\",\\n \\"acc_oversea_endpoint\\": \\"\\",\\n \\"cdn_endpoint\\": \\"\\",\\n \\"endpoint\\": \\"\\"\\n }\\n ],\\n \\"va_store_list\\": [\\n {\\n \\"store_id\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"bucket\\": \\"\\",\\n \\"base_path\\": \\"\\",\\n \\"role_arn\\": \\"\\",\\n \\"ownership\\": \\"\\",\\n \\"location\\": \\"\\",\\n \\"public_endpoint\\": \\"\\",\\n \\"vpc_endpoint\\": \\"\\",\\n \\"acc_endpoint\\": \\"\\",\\n \\"acc_oversea_endpoint\\": \\"\\",\\n \\"cdn_endpoint\\": \\"\\",\\n \\"endpoint\\": \\"\\"\\n }\\n ]\\n },\\n \\"data_hash_name\\": \\"\\",\\n \\"store_redundancy_type\\": \\"LRS\\",\\n \\"system_drive_config\\": {\\n \\"enable\\": true,\\n \\"drive_id\\": \\"\\",\\n \\"resource_parent_file_id_map\\": {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n }\\n },\\n \\"endpoint_version\\": 0\\n}","type":"json"}]', - 'title' => '获取Domain', - ], - 'UpdateDomain' => [ - 'summary' => '更新 domain。', - 'path' => '/v2/domain/update', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'tags' => [ - 'admin', - ], - 'security' => [ - [ - 'AK' => [], - ], - ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'readAndWrite', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - ], - 'parameters' => [ - [ - 'name' => 'body', - 'in' => 'body', - 'style' => 'json', - 'schema' => [ - 'description' => '请求体。', + 'title' => 'Schema of Response', + 'description' => '返回参数', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'description' => 'domain id', - 'type' => 'string', - 'required' => true, - 'example' => 'bj1', - ], - 'domain_name' => [ - 'description' => 'domain 名称', - 'type' => 'string', - 'required' => false, - 'example' => '你好企业网盘', - ], - 'description' => [ - 'description' => 'domain 描述', - 'type' => 'string', - 'required' => false, - 'example' => '你好企业网盘调试环境', - ], - 'init_drive_enable' => [ - 'description' => '是否开通默认网盘。为true则所有用户在第一次登录后都默认分配一个网盘。默认false', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'init_drive_size' => [ - 'description' => 'init\\_drive\\_enable 为true时必选。 创建用户时，默认网盘的大小，单位：Bytes。'."\n" - .'默认为 0，此时创建的 drive 大小为0，不可以上传文件，如果需要初始化 drive， 请设置该值。'."\n" - .'-1则表示不限大小。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1073741824', - ], - 'user_count_quota' => [ - 'description' => 'domain 总用户数限制', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '50', - ], - 'size_quota' => [ - 'description' => '容量配额，表示 domain 下所有 drive 的总quota 大小，0 表示不限制', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1099511627776', - ], - 'published_app_access_strategy' => [ - 'description' => 'App 访问策略', - 'required' => false, - '$ref' => '#/components/schemas/AppAccessStrategy', + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'example' => '1'], + 'story_id' => ['description' => '故事 id', 'type' => 'string', 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003'], + 'files' => [ + 'description' => '文件列表', + 'type' => 'array', + 'items' => ['description' => '添加到故事中的文件信息', '$ref' => '#/components/schemas/AddStoryFile'], ], + 'request_id' => ['type' => 'string', 'description' => ''], ], - 'required' => false, - ], - ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'description' => '更新后的 domain 信息', - '$ref' => '#/components/schemas/Domain', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '故事中添加文件', + 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" + ."\n" + .'使用此功能须开通增值服务图片处理功能。'."\n" + ."\n" + .'用户在创建故事后，可以手动给指定故事添加想要的文件。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"parent_domain_id\\": \\"\\",\\n \\"domain_id\\": \\"\\",\\n \\"domain_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"init_drive_enable\\": true,\\n \\"init_drive_size\\": 0,\\n \\"updated_at\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"size_quota\\": 0,\\n \\"size_quota_used\\": 0,\\n \\"user_count_quota\\": 0,\\n \\"status\\": 0,\\n \\"used_size\\": 0,\\n \\"published_app_access_strategy\\": {\\n \\"effect\\": \\"\\",\\n \\"except_app_id_list\\": [\\n \\"\\"\\n ]\\n },\\n \\"watermark_config\\": {\\n \\"enable_doc_preview\\": true,\\n \\"display_access_user_name\\": true,\\n \\"display_shareLink_creator_name\\": true,\\n \\"display_custom_text\\": \\"\\"\\n },\\n \\"auth_config\\": {\\n \\"key\\": {\\n \\"enable\\": true,\\n \\"app_id\\": \\"\\",\\n \\"app_secret\\": \\"\\",\\n \\"endpoint\\": \\"\\",\\n \\"enterprise_id\\": \\"\\",\\n \\"white_list_enable\\": true,\\n \\"ldap_config\\": {\\n \\"version\\": \\"\\",\\n \\"host\\": \\"\\",\\n \\"port\\": 0,\\n \\"uid\\": \\"\\",\\n \\"admin_dn\\": \\"\\",\\n \\"global_uid\\": \\"\\",\\n \\"admin_password\\": \\"\\",\\n \\"base_dn\\": \\"\\",\\n \\"display_name_key\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"sync_config\\": {\\n \\"enabled\\": true,\\n \\"group_object_class\\": \\"\\",\\n \\"group_filter\\": \\"\\",\\n \\"user_object_class\\": \\"\\",\\n \\"user_filter\\": \\"\\",\\n \\"cron\\": \\"\\"\\n }\\n },\\n \\"ding_sync_config\\": {\\n \\"enabled\\": true,\\n \\"cron\\": \\"\\",\\n \\"sync_mobile_enabled\\": true,\\n \\"sync_email_enabled\\": true\\n },\\n \\"we_chat_sync_config\\": {\\n \\"enabled\\": true,\\n \\"tag_id\\": \\"\\",\\n \\"cron\\": \\"\\"\\n },\\n \\"lark_sync_config\\": {\\n \\"enabled\\": true,\\n \\"cron\\": \\"\\",\\n \\"sync_mobile_enabled\\": true,\\n \\"sync_email_enabled\\": true\\n }\\n }\\n },\\n \\"sharable\\": true,\\n \\"ali_owner_id\\": \\"\\",\\n \\"archive_files_config\\": {\\n \\"enabled\\": true,\\n \\"version\\": \\"\\"\\n },\\n \\"uncompress_config\\": {\\n \\"enabled\\": true,\\n \\"version\\": \\"\\"\\n },\\n \\"multi_revision_config\\": {\\n \\"revision_merge_enabled\\": true,\\n \\"revision_count\\": 0,\\n \\"revision_recycle_period\\": 0\\n },\\n \\"app_config\\": {\\n \\"same_name_file_upload_mode\\": \\"\\",\\n \\"web_client_download_mode\\": \\"\\",\\n \\"single_file_upload_size_limit\\": 0,\\n \\"allow_upload_file_category_list\\": [\\n \\"\\"\\n ],\\n \\"allow_upload_custom_file_ext_list\\": [\\n \\"\\"\\n ]\\n },\\n \\"recycle_bin_config\\": {\\n \\"auto_delete_enabled\\": true,\\n \\"auto_delete_keep_second\\": 0,\\n \\"delete_trash_normal_file_disabled\\": true\\n },\\n \\"office_preview_config\\": {\\n \\"enabled\\": true\\n },\\n \\"office_edit_config\\": {\\n \\"enabled\\": true\\n },\\n \\"share_link_detail\\": {\\n \\"enable_office_editable\\": true\\n },\\n \\"endpoints\\": {\\n \\"api_endpoint\\": \\"\\",\\n \\"api_vpc_endpoint\\": \\"\\",\\n \\"app_endpoint\\": \\"\\",\\n \\"auth_endpoint\\": \\"\\",\\n \\"mgmt_endpoint\\": \\"\\",\\n \\"web_office_endpoint_list\\": \\"\\",\\n \\"store_list\\": [\\n {\\n \\"store_id\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"bucket\\": \\"\\",\\n \\"base_path\\": \\"\\",\\n \\"role_arn\\": \\"\\",\\n \\"ownership\\": \\"\\",\\n \\"location\\": \\"\\",\\n \\"public_endpoint\\": \\"\\",\\n \\"vpc_endpoint\\": \\"\\",\\n \\"acc_endpoint\\": \\"\\",\\n \\"acc_oversea_endpoint\\": \\"\\",\\n \\"cdn_endpoint\\": \\"\\",\\n \\"endpoint\\": \\"\\"\\n }\\n ],\\n \\"va_store_list\\": [\\n {\\n \\"store_id\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"bucket\\": \\"\\",\\n \\"base_path\\": \\"\\",\\n \\"role_arn\\": \\"\\",\\n \\"ownership\\": \\"\\",\\n \\"location\\": \\"\\",\\n \\"public_endpoint\\": \\"\\",\\n \\"vpc_endpoint\\": \\"\\",\\n \\"acc_endpoint\\": \\"\\",\\n \\"acc_oversea_endpoint\\": \\"\\",\\n \\"cdn_endpoint\\": \\"\\",\\n \\"endpoint\\": \\"\\"\\n }\\n ]\\n },\\n \\"data_hash_name\\": \\"\\",\\n \\"store_redundancy_type\\": \\"LRS\\",\\n \\"system_drive_config\\": {\\n \\"enable\\": true,\\n \\"drive_id\\": \\"\\",\\n \\"resource_parent_file_id_map\\": {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n }\\n },\\n \\"endpoint_version\\": 0\\n}","type":"json"}]', - 'title' => '更新Domain', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"drive_id\\": \\"1\\",\\n \\"story_id\\": \\"9132e0d8-fe92-4e56-86c3-f5f112308003\\",\\n \\"files\\": [\\n {\\n \\"file_id\\": \\"63e5e4340f76cb3ead5f40f68163f0f967c1a7bf\\",\\n \\"revision_id\\": \\"642a88dd06e49d9c0a14411ebae606f70edd9a59\\",\\n \\"error_code\\": \\"\\",\\n \\"error_message\\": \\"\\"\\n }\\n ],\\n \\"request_id\\": \\"\\"\\n}","type":"json"}]', ], - 'ListDomains' => [ - 'summary' => '列举Domain列表。', - 'path' => '/v2/domain/list', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'tags' => [ - 'admin', - ], + 'ArchiveFiles' => [ + 'summary' => '文件打包下载。', + 'path' => '/v2/file/archive_files', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], ], + [ + 'BearerToken' => [], + ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'paid'], 'parameters' => [ [ + 'name' => 'domain_id', + 'in' => 'host', + 'schema' => ['title' => '域 id。', 'description' => '域id', 'type' => 'string', 'required' => true, 'example' => 'bj1'], + ], + [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ + 'title' => '请求体参数。', 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'parent_domain_id' => [ - 'description' => '父 domain id', - 'type' => 'string', - 'required' => false, - 'example' => 'bj1', - ], - 'marker' => [ - 'description' => '分页 marker，"" 表示从头开始。该接口会返回 next\\_marker，可将 next\\_marker 设置该值来遍历所有 domain 信息', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'limit' => [ - 'description' => '本次分页获取的数量，默认 50，不可超过 100', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '60', - ], - 'service_code' => [ - 'description' => '服务代码，默认为pds'."\n" - ."\n" - .'- edm（企业版）'."\n" - .'- pds（开发版）', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'pds' => 'pds', - 'edm' => 'edm', - ], - 'example' => 'pds', + 'share_id' => ['title' => '分享 id，当打包分享链接的文件时必填。', 'description' => '分享 id，当打包分享链接的文件时必填。', 'type' => 'string', 'required' => false, 'example' => '7JQX1FswpQ8'], + 'drive_id' => ['title' => '文件所属空间 id ，与分享 id 至少存在一个。', 'description' => '文件所属空间 id ，与分享 id 至少存在一个。', 'type' => 'string', 'required' => false, 'example' => '1'], + 'file_ids' => [ + 'title' => '待打包文件列表', + 'description' => '待打包文件列表', + 'type' => 'array', + 'items' => ['title' => '待打包文件/文件夹 id。', 'description' => '待打包文件/文件夹 id。', 'type' => 'string', 'required' => true, 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf'], + 'required' => true, ], + 'name' => ['title' => '打包生成的文件名称，按照 utf8 编码。', 'description' => '打包生成的文件名称，按照 utf8 编码。', 'type' => 'string', 'required' => true, 'example' => 'test_archive_files.zip'], ], 'required' => false, ], @@ -7330,168 +1750,106 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => '返回的 domain 列表', + 'title' => '', + 'description' => '', 'type' => 'object', 'properties' => [ - 'items' => [ - 'description' => '返回的 domain 列表', - 'type' => 'array', - 'items' => [ - 'description' => '单个 domain 信息', - '$ref' => '#/components/schemas/Domain', - ], - ], - 'next_marker' => [ - 'description' => '用作下次遍历的 marker', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], + 'async_task_id' => ['title' => '异步任务 id。', 'description' => '异步任务 id。', 'type' => 'string', 'required' => true, 'example' => '000e89fb-cf8f-11e9-8ab4-b6e980803a3b'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '文件打包下载', + 'description' => '文件打包下载接口, 返回异步任务 id, 需要使用 GetAsyncTask 方法获取任务执行状态。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"parent_domain_id\\": \\"\\",\\n \\"domain_id\\": \\"\\",\\n \\"domain_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"init_drive_enable\\": true,\\n \\"init_drive_size\\": 0,\\n \\"updated_at\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"size_quota\\": 0,\\n \\"size_quota_used\\": 0,\\n \\"user_count_quota\\": 0,\\n \\"status\\": 0,\\n \\"used_size\\": 0,\\n \\"published_app_access_strategy\\": {\\n \\"effect\\": \\"\\",\\n \\"except_app_id_list\\": [\\n \\"\\"\\n ]\\n },\\n \\"watermark_config\\": {\\n \\"enable_doc_preview\\": true,\\n \\"display_access_user_name\\": true,\\n \\"display_shareLink_creator_name\\": true,\\n \\"display_custom_text\\": \\"\\"\\n },\\n \\"auth_config\\": {\\n \\"key\\": {\\n \\"enable\\": true,\\n \\"app_id\\": \\"\\",\\n \\"app_secret\\": \\"\\",\\n \\"endpoint\\": \\"\\",\\n \\"enterprise_id\\": \\"\\",\\n \\"white_list_enable\\": true,\\n \\"ldap_config\\": {\\n \\"version\\": \\"\\",\\n \\"host\\": \\"\\",\\n \\"port\\": 0,\\n \\"uid\\": \\"\\",\\n \\"admin_dn\\": \\"\\",\\n \\"global_uid\\": \\"\\",\\n \\"admin_password\\": \\"\\",\\n \\"base_dn\\": \\"\\",\\n \\"display_name_key\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"sync_config\\": {\\n \\"enabled\\": true,\\n \\"group_object_class\\": \\"\\",\\n \\"group_filter\\": \\"\\",\\n \\"user_object_class\\": \\"\\",\\n \\"user_filter\\": \\"\\",\\n \\"cron\\": \\"\\"\\n }\\n },\\n \\"ding_sync_config\\": {\\n \\"enabled\\": true,\\n \\"cron\\": \\"\\",\\n \\"sync_mobile_enabled\\": true,\\n \\"sync_email_enabled\\": true\\n },\\n \\"we_chat_sync_config\\": {\\n \\"enabled\\": true,\\n \\"tag_id\\": \\"\\",\\n \\"cron\\": \\"\\"\\n },\\n \\"lark_sync_config\\": {\\n \\"enabled\\": true,\\n \\"cron\\": \\"\\",\\n \\"sync_mobile_enabled\\": true,\\n \\"sync_email_enabled\\": true\\n }\\n }\\n },\\n \\"sharable\\": true,\\n \\"ali_owner_id\\": \\"\\",\\n \\"archive_files_config\\": {\\n \\"enabled\\": true,\\n \\"version\\": \\"\\"\\n },\\n \\"uncompress_config\\": {\\n \\"enabled\\": true,\\n \\"version\\": \\"\\"\\n },\\n \\"multi_revision_config\\": {\\n \\"revision_merge_enabled\\": true,\\n \\"revision_count\\": 0,\\n \\"revision_recycle_period\\": 0\\n },\\n \\"app_config\\": {\\n \\"same_name_file_upload_mode\\": \\"\\",\\n \\"web_client_download_mode\\": \\"\\",\\n \\"single_file_upload_size_limit\\": 0,\\n \\"allow_upload_file_category_list\\": [\\n \\"\\"\\n ],\\n \\"allow_upload_custom_file_ext_list\\": [\\n \\"\\"\\n ]\\n },\\n \\"recycle_bin_config\\": {\\n \\"auto_delete_enabled\\": true,\\n \\"auto_delete_keep_second\\": 0,\\n \\"delete_trash_normal_file_disabled\\": true\\n },\\n \\"office_preview_config\\": {\\n \\"enabled\\": true\\n },\\n \\"office_edit_config\\": {\\n \\"enabled\\": true\\n },\\n \\"share_link_detail\\": {\\n \\"enable_office_editable\\": true\\n },\\n \\"endpoints\\": {\\n \\"api_endpoint\\": \\"\\",\\n \\"api_vpc_endpoint\\": \\"\\",\\n \\"app_endpoint\\": \\"\\",\\n \\"auth_endpoint\\": \\"\\",\\n \\"mgmt_endpoint\\": \\"\\",\\n \\"web_office_endpoint_list\\": \\"\\",\\n \\"store_list\\": [\\n {\\n \\"store_id\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"bucket\\": \\"\\",\\n \\"base_path\\": \\"\\",\\n \\"role_arn\\": \\"\\",\\n \\"ownership\\": \\"\\",\\n \\"location\\": \\"\\",\\n \\"public_endpoint\\": \\"\\",\\n \\"vpc_endpoint\\": \\"\\",\\n \\"acc_endpoint\\": \\"\\",\\n \\"acc_oversea_endpoint\\": \\"\\",\\n \\"cdn_endpoint\\": \\"\\",\\n \\"endpoint\\": \\"\\"\\n }\\n ],\\n \\"va_store_list\\": [\\n {\\n \\"store_id\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"bucket\\": \\"\\",\\n \\"base_path\\": \\"\\",\\n \\"role_arn\\": \\"\\",\\n \\"ownership\\": \\"\\",\\n \\"location\\": \\"\\",\\n \\"public_endpoint\\": \\"\\",\\n \\"vpc_endpoint\\": \\"\\",\\n \\"acc_endpoint\\": \\"\\",\\n \\"acc_oversea_endpoint\\": \\"\\",\\n \\"cdn_endpoint\\": \\"\\",\\n \\"endpoint\\": \\"\\"\\n }\\n ]\\n },\\n \\"data_hash_name\\": \\"\\",\\n \\"store_redundancy_type\\": \\"LRS\\",\\n \\"system_drive_config\\": {\\n \\"enable\\": true,\\n \\"drive_id\\": \\"\\",\\n \\"resource_parent_file_id_map\\": {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n }\\n },\\n \\"endpoint_version\\": 0\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', - 'title' => '列举Domain', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"async_task_id\\": \\"000e89fb-cf8f-11e9-8ab4-b6e980803a3b\\"\\n}","type":"json"}]', ], - 'SearchDomains' => [ - 'summary' => '搜索 domain', - 'path' => '/v2/domain/search', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'tags' => [ - 'admin', - ], + 'AssignRole' => [ + 'summary' => '当前支持将用户设置为团队管理员角色。', + 'path' => '/v2/role/assign', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], ], + [ + 'BearerToken' => [], + ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'read', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'none'], 'parameters' => [ [ + 'name' => 'domain_id', + 'in' => 'host', + 'schema' => ['title' => 'A short description of struct', 'description' => 'A short description of struct', 'type' => 'string', 'required' => false], + ], + [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求body', 'type' => 'object', 'properties' => [ - 'name' => [ - 'description' => '要搜索的 domain 名称，支持模糊搜索', - 'type' => 'string', - 'required' => false, - 'example' => '你好网盘', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'<br>默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'limit' => [ - 'description' => '限定此次返回资源的数量，取值范围\\[0,100\\]，默认100'."\n" - ."\n" - .'返回结果可以小于指定的数量，但不能多于指定的数量。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '50', - ], - 'order_by' => [ - 'description' => '排序规则，当前仅支持：'."\n" - .'created_at，创建时间', - 'type' => 'string', - 'required' => false, - 'example' => 'created_at', - ], + 'identity' => ['description' => '唯一身份标识，当前仅支持设置某个用户作为团队管理员', 'required' => true, '$ref' => '#/components/schemas/Identity'], + 'role_id' => ['description' => '给用户分配的角色ID，当前仅支持填：SystemGroupAdmin（团队管理员）', 'type' => 'string', 'required' => true, 'example' => 'SystemGroupAdmin'], + 'manage_resource_type' => ['description' => '管理的资源类型，当前仅支持：RT_Group（团队）', 'type' => 'string', 'required' => true, 'example' => 'RT_Group'], + 'manage_resource_id' => ['description' => '管理的资源ID，当前仅支持填Group ID。', 'type' => 'string', 'required' => true, 'example' => '105***b82'], ], 'required' => false, + 'description' => '', ], ], ], 'responses' => [ - 200 => [ + 204 => [ 'schema' => [ - 'description' => 'domain 列表以及遍历 marker', 'type' => 'object', - 'properties' => [ - 'items' => [ - 'description' => '搜索命中的 domain 列表', - 'type' => 'array', - 'items' => [ - 'description' => 'domain 信息', - '$ref' => '#/components/schemas/Domain', - ], - ], - 'next_marker' => [ - 'description' => '用作下次遍历的 marker', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - ], + 'properties' => [], + 'description' => '', ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '分配角色', + 'description' => '当前支持将用户设置为团队管理员角色。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"parent_domain_id\\": \\"\\",\\n \\"domain_id\\": \\"\\",\\n \\"domain_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"init_drive_enable\\": true,\\n \\"init_drive_size\\": 0,\\n \\"updated_at\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"size_quota\\": 0,\\n \\"size_quota_used\\": 0,\\n \\"user_count_quota\\": 0,\\n \\"status\\": 0,\\n \\"used_size\\": 0,\\n \\"published_app_access_strategy\\": {\\n \\"effect\\": \\"\\",\\n \\"except_app_id_list\\": [\\n \\"\\"\\n ]\\n },\\n \\"watermark_config\\": {\\n \\"enable_doc_preview\\": true,\\n \\"display_access_user_name\\": true,\\n \\"display_shareLink_creator_name\\": true,\\n \\"display_custom_text\\": \\"\\"\\n },\\n \\"auth_config\\": {\\n \\"key\\": {\\n \\"enable\\": true,\\n \\"app_id\\": \\"\\",\\n \\"app_secret\\": \\"\\",\\n \\"endpoint\\": \\"\\",\\n \\"enterprise_id\\": \\"\\",\\n \\"white_list_enable\\": true,\\n \\"ldap_config\\": {\\n \\"version\\": \\"\\",\\n \\"host\\": \\"\\",\\n \\"port\\": 0,\\n \\"uid\\": \\"\\",\\n \\"admin_dn\\": \\"\\",\\n \\"global_uid\\": \\"\\",\\n \\"admin_password\\": \\"\\",\\n \\"base_dn\\": \\"\\",\\n \\"display_name_key\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"sync_config\\": {\\n \\"enabled\\": true,\\n \\"group_object_class\\": \\"\\",\\n \\"group_filter\\": \\"\\",\\n \\"user_object_class\\": \\"\\",\\n \\"user_filter\\": \\"\\",\\n \\"cron\\": \\"\\"\\n }\\n },\\n \\"ding_sync_config\\": {\\n \\"enabled\\": true,\\n \\"cron\\": \\"\\",\\n \\"sync_mobile_enabled\\": true,\\n \\"sync_email_enabled\\": true\\n },\\n \\"we_chat_sync_config\\": {\\n \\"enabled\\": true,\\n \\"tag_id\\": \\"\\",\\n \\"cron\\": \\"\\"\\n },\\n \\"lark_sync_config\\": {\\n \\"enabled\\": true,\\n \\"cron\\": \\"\\",\\n \\"sync_mobile_enabled\\": true,\\n \\"sync_email_enabled\\": true\\n }\\n }\\n },\\n \\"sharable\\": true,\\n \\"ali_owner_id\\": \\"\\",\\n \\"archive_files_config\\": {\\n \\"enabled\\": true,\\n \\"version\\": \\"\\"\\n },\\n \\"uncompress_config\\": {\\n \\"enabled\\": true,\\n \\"version\\": \\"\\"\\n },\\n \\"multi_revision_config\\": {\\n \\"revision_merge_enabled\\": true,\\n \\"revision_count\\": 0,\\n \\"revision_recycle_period\\": 0\\n },\\n \\"app_config\\": {\\n \\"same_name_file_upload_mode\\": \\"\\",\\n \\"web_client_download_mode\\": \\"\\",\\n \\"single_file_upload_size_limit\\": 0,\\n \\"allow_upload_file_category_list\\": [\\n \\"\\"\\n ],\\n \\"allow_upload_custom_file_ext_list\\": [\\n \\"\\"\\n ]\\n },\\n \\"recycle_bin_config\\": {\\n \\"auto_delete_enabled\\": true,\\n \\"auto_delete_keep_second\\": 0,\\n \\"delete_trash_normal_file_disabled\\": true\\n },\\n \\"office_preview_config\\": {\\n \\"enabled\\": true\\n },\\n \\"office_edit_config\\": {\\n \\"enabled\\": true\\n },\\n \\"share_link_detail\\": {\\n \\"enable_office_editable\\": true\\n },\\n \\"endpoints\\": {\\n \\"api_endpoint\\": \\"\\",\\n \\"api_vpc_endpoint\\": \\"\\",\\n \\"app_endpoint\\": \\"\\",\\n \\"auth_endpoint\\": \\"\\",\\n \\"mgmt_endpoint\\": \\"\\",\\n \\"web_office_endpoint_list\\": \\"\\",\\n \\"store_list\\": [\\n {\\n \\"store_id\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"bucket\\": \\"\\",\\n \\"base_path\\": \\"\\",\\n \\"role_arn\\": \\"\\",\\n \\"ownership\\": \\"\\",\\n \\"location\\": \\"\\",\\n \\"public_endpoint\\": \\"\\",\\n \\"vpc_endpoint\\": \\"\\",\\n \\"acc_endpoint\\": \\"\\",\\n \\"acc_oversea_endpoint\\": \\"\\",\\n \\"cdn_endpoint\\": \\"\\",\\n \\"endpoint\\": \\"\\"\\n }\\n ],\\n \\"va_store_list\\": [\\n {\\n \\"store_id\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"bucket\\": \\"\\",\\n \\"base_path\\": \\"\\",\\n \\"role_arn\\": \\"\\",\\n \\"ownership\\": \\"\\",\\n \\"location\\": \\"\\",\\n \\"public_endpoint\\": \\"\\",\\n \\"vpc_endpoint\\": \\"\\",\\n \\"acc_endpoint\\": \\"\\",\\n \\"acc_oversea_endpoint\\": \\"\\",\\n \\"cdn_endpoint\\": \\"\\",\\n \\"endpoint\\": \\"\\"\\n }\\n ]\\n },\\n \\"data_hash_name\\": \\"\\",\\n \\"store_redundancy_type\\": \\"LRS\\",\\n \\"system_drive_config\\": {\\n \\"enable\\": true,\\n \\"drive_id\\": \\"\\",\\n \\"resource_parent_file_id_map\\": {\\n \\"test\\": \\"test\\",\\n \\"test2\\": 1\\n }\\n },\\n \\"endpoint_version\\": 0\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', - 'title' => '搜索Domain', + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', ], - 'DeleteDomain' => [ - 'summary' => '删除 domain', - 'path' => '/v2/domain/delete', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'tags' => [ - 'admin', - ], + 'AuditLogExport' => [ + 'summary' => '导出审计日志。', + 'path' => '/v2/audit_log/export', + 'methods' => ['post'], + 'schemes' => ['https'], 'security' => [ [ 'AK' => [], ], + [ + 'BearerToken' => [], + ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'delete', - 'riskType' => 'high', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'none'], 'parameters' => [ [ + 'name' => 'domain_id', + 'in' => 'host', + 'schema' => ['title' => 'A short description of struct', 'description' => 'A short description of struct', 'type' => 'string', 'required' => false], + ], + [ 'name' => 'body', 'in' => 'body', 'style' => 'json', @@ -7499,79 +1857,76 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'description' => 'domain id', - 'type' => 'string', - 'required' => false, - 'example' => 'bj1', - ], + 'query' => ['description' => '支持根据以下字段组合查询：'."\n" + .'- drive_id（空间ID，string）'."\n" + .'- actor_id（操作者ID，string）'."\n" + .'- acted_at（操作时间，date，格式"2006-01-02T00:00:00"，只支持零时区）'."\n" + .'- action_type（操作类型，string）', 'type' => 'string', 'required' => false, 'example' => 'acted_at > \'2025-03-10T16:00:00\' and acted_at < \'2025-03-17T15:59:59\''], + 'order_by' => ['description' => '排序字段，支持操作时间（acted_at）排序。默认值：空，按照操作时间逆序排序。支持参数：'."\n" + ."\n" + .'- acted_at DESC（按操作时间逆序）'."\n" + .'- acted_at ASC（按操作时间正序）', 'type' => 'string', 'required' => false, 'example' => 'acted_at DESC'], + 'file_name' => ['description' => '导出的文件名，长度不超过1024。默认为log.csv', 'type' => 'string', 'required' => false, 'example' => '2024-01-log.csv'], + 'language' => ['description' => '导出语言，默认中文。支持参数：'."\n" + ."\n" + .'- zh_CN（中文）'."\n" + .'- en_US（英文）', 'type' => 'string', 'required' => false, 'example' => 'zh_CN'], ], 'required' => false, ], ], ], 'responses' => [ - 204 => [], + 200 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => '返回信息', + 'type' => 'object', + 'properties' => [ + 'async_task_id' => ['title' => 'Id of the request', 'description' => '审计日志导出的异步任务 id', 'type' => 'string', 'example' => '4221bf6e6ab43c255edc4463bf3a6f5f5d31****'], + ], + ], + ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '导出审计日志', + 'description' => '网盘与相册服务开发版，日志审计属于增值功能，请确保在使用该接口前，已充分了解<props="china">[增值服务计费项](https://help.aliyun.com/zh/pds/drive-and-photo-service-dev/product-overview/billable-items-for-value-added-features)</props><props="intl">[增值服务计费项](https://www.alibabacloud.com/help/document_detail/425220.html)</props>。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '删除Domain', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"async_task_id\\": \\"4221bf6e6ab43c255edc4463bf3a6f5f5d31****\\"\\n}","type":"json"}]', ], 'Authorize' => [ 'summary' => 'OAuth2.0请求授权。', 'path' => '/v2/oauth/authorize', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'methods' => ['get'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'Anonymous' => [], ], ], - 'consumes' => [ - 'application/x-www-form-urlencoded', - ], - 'produces' => [ - 'application/octet-stream', - ], + 'consumes' => ['application/x-www-form-urlencoded'], + 'produces' => ['application/octet-stream'], 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'client_id', 'in' => 'query', - 'schema' => [ - 'description' => '创建App时返回的AppID', - 'type' => 'string', - 'required' => true, - 'example' => '47eUHhrzgWBvlLWj', - ], + 'schema' => ['description' => '创建App时返回的AppID', 'type' => 'string', 'required' => true, 'example' => '47eUHhrzgWBvlLWj'], ], [ 'name' => 'redirect_uri', 'in' => 'query', - 'schema' => [ - 'description' => '回调地址（创建App时填写的回调地址）。请使用urlencode对链接进行处理', - 'type' => 'string', - 'required' => true, - 'example' => 'https%3A%2F%2Fwww.aliyunpds.com%2Fsign%2Fcallback', - ], + 'schema' => ['description' => '回调地址（创建App时填写的回调地址）。请使用urlencode对链接进行处理', 'type' => 'string', 'required' => true, 'example' => 'https%3A%2F%2Fwww.aliyunpds.com%2Fsign%2Fcallback'], ], [ 'name' => 'scope', @@ -7580,233 +1935,289 @@ 'schema' => [ 'description' => '申请的权限列表, 默认为所有权限', 'type' => 'array', - 'items' => [ - 'description' => '当前仅支持获取App的所有权限，可以传all或者不传此参数', - 'type' => 'string', - 'required' => false, - 'example' => 'all', - ], + 'items' => ['description' => '当前仅支持获取App的所有权限，可以传all或者不传此参数', 'type' => 'string', 'required' => false, 'example' => 'all'], 'required' => false, ], ], [ 'name' => 'response_type', 'in' => 'query', - 'schema' => [ - 'description' => '返回类型, 只能填写code', - 'type' => 'string', - 'required' => true, - 'example' => 'code', - ], + 'schema' => ['description' => '返回类型, 只能填写code', 'type' => 'string', 'required' => true, 'example' => 'code'], ], [ 'name' => 'state', 'in' => 'query', - 'schema' => [ - 'description' => '用户自定义字段，会在请求授权成功后的callback带回', - 'type' => 'string', - 'required' => false, - 'example' => 'customdata', - ], + 'schema' => ['description' => '用户自定义字段，会在请求授权成功后的callback带回', 'type' => 'string', 'required' => false, 'example' => 'customdata'], ], [ 'name' => 'login_type', 'in' => 'query', - 'schema' => [ - 'description' => '认证方式，目前支持以下取值：'."\n" - ."\n" - .'- default （PDS提供的默认登录页面，集成了所有登录方式）'."\n" - ."\n" - .'- ding （PC钉钉扫码登录）'."\n" - ."\n" - .'- ding\\_sns （手机钉钉账号密码登录）'."\n" - ."\n" - .'- ram （阿里云子账号登录）'."\n" - ."\n" - .'- wechat（企业微信扫码登录）'."\n" - ."\n" - .'- wechat\\_app（企业微信内免登）', - 'type' => 'string', - 'required' => true, - 'example' => 'default', - ], + 'schema' => ['description' => '认证方式，目前支持以下取值：'."\n" + ."\n" + .'- default （PDS提供的默认登录页面，集成了所有登录方式）'."\n" + ."\n" + .'- ding （PC钉钉扫码登录）'."\n" + ."\n" + .'- ding\\_sns （手机钉钉账号密码登录）'."\n" + ."\n" + .'- ram （阿里云子账号登录）'."\n" + ."\n" + .'- wechat（企业微信扫码登录）'."\n" + ."\n" + .'- wechat\\_app（企业微信内免登）', 'type' => 'string', 'required' => true, 'example' => 'default'], ], [ 'name' => 'hide_consent', 'in' => 'query', - 'schema' => [ - 'description' => '是否隐藏同意页面', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], + 'schema' => ['description' => '是否隐藏同意页面', 'type' => 'boolean', 'required' => false, 'example' => 'true'], ], ], 'responses' => [ 302 => [ 'headers' => [ 'location' => [ - 'schema' => [ - 'title' => '重定向的登陆页地址，用户需要在此页面完成认证', - 'type' => 'string', - ], + 'schema' => ['title' => '重定向的登陆页地址，用户需要在此页面完成认证', 'type' => 'string'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', 'title' => 'OAuth请求授权', 'description' => '<props="china">详细使用方法参考用户指南：[用户指南链接](https://help.aliyun.com/document_detail/175894.html)。</props>'."\n" ."\n" .'<props="intl">详细使用方法参考用户指南：[用户指南链接](https://www.alibabacloud.com/help/zh/pds/latest/oauth2-for-web-server-app?spm=a2c63.p38356.0.0.4cce4fccEyosuB)。</props>', - ], - 'Token' => [ - 'summary' => 'OAuth2.0授权流程的获取访问令牌。', - 'path' => '/v2/oauth/token', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', + ], + 'Batch' => [ + 'summary' => '支持批量调用部分API，提升调用效率。', + 'path' => '/v2/batch', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'Anonymous' => [], + 'BearerToken' => [], + ], + [ + 'AK' => [], ], ], - 'consumes' => [ - 'application/x-www-form-urlencoded', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, + 'systemTags' => ['operationType' => 'none'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ - 'name' => 'grant_type', - 'in' => 'formData', - 'schema' => [ - 'description' => '授权类型，有以下取值：'."\n" - ."\n" - .'authorization\\_code （通过认证完成后获取的code来换取token）'."\n" - ."\n" - .'refresh\\_token（通过上次授权获取的refresh_token来获取token）'."\n" - ."\n" - .'urn:ietf:params:oauth:grant-type:jwt-bearer（通过JWT方式获取token）', - 'type' => 'string', - 'required' => true, - 'example' => 'refresh_token', - ], - ], - [ - 'name' => 'code', - 'in' => 'formData', + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', 'schema' => [ - 'description' => '认证完成后回调地址中携带的code，当grant\\_type为authorization\\_code时，此参数必传'."\n" - ."\n", - 'type' => 'string', + 'description' => '请求体参数。', + 'type' => 'object', + 'properties' => [ + 'resource' => [ + 'description' => '请求的资源，支持的资源类型包括：'."\n" + ."\n" + .'- file（文件）'."\n" + .'- drive（个人/团队云盘）'."\n" + .'- user（用户）'."\n" + .'- group（群组）'."\n" + .'- membership（群组成员）'."\n" + .'- share\\_link（分享）'."\n" + .'- async\\_task（异步任务）', + 'type' => 'string', + 'required' => true, + 'enumValueTitles' => ['share_link' => '分享', 'file' => '文件', 'async_task' => '异步任务', 'membership' => '群组成员', 'drive' => '个人/团队云盘', 'user' => '用户', 'group' => '群组'], + 'example' => 'file', + ], + 'requests' => [ + 'description' => '子请求合集'."\n" + ."\n" + .'子请求的数量，有效范围是[1,100]', + 'type' => 'array', + 'items' => [ + 'description' => '一个子请求内容', + 'type' => 'object', + 'properties' => [ + 'id' => ['description' => '子请求 id，用于request 和 response关联， 不允许重复', 'type' => 'string', 'required' => true, 'example' => '93433894994ad2e1'], + 'method' => [ + 'description' => '子请求的方法，支持：'."\n" + ."\n" + .'- POST'."\n" + .'- GET'."\n" + .'- PUT'."\n" + .'- DELETE'."\n" + .'- HEAD'."\n", + 'type' => 'string', + 'required' => true, + 'enumValueTitles' => ['HEAD' => 'HEAD', 'DELETE' => 'DELETE', 'POST' => 'POST', 'GET' => 'GET', 'PUT' => 'PUT'], + 'example' => 'POST', + ], + 'url' => [ + 'description' => 'url 子请求的api path路径， 支持：'."\n" + ."\n" + .'- /file/get（获取文件详情）'."\n" + .'- /file/update（修改文件信息）'."\n" + .'- /file/search（搜索文件）'."\n" + .'- /file/copy（复制文件或文件夹）'."\n" + .'- /file/move（移动文件或文件夹）'."\n" + .'- /file/delete（删除文件或文件夹）'."\n" + .'- /file/get_download_url（获取文件下载地址）'."\n" + .'- /file/get_share_link_download_url（获取分享下载地址）'."\n" + .'- /recyclebin/trash（放入回收站）'."\n" + .'- /recyclebin/restore（恢复文件或文件夹）'."\n" + .'- /file/put_usertags（设置用户标签）'."\n" + .'- /file/delete_usertags（删除用户标签）'."\n" + .'- /drive/get（获取空间信息）'."\n" + .'- /user/get（获取用户信息）'."\n" + .'- /group/get（获取群组信息）'."\n" + .'- /share_link/create（创建分享）'."\n" + .'- /share_link/update（修改分享）'."\n" + .'- /share_link/cancel（取消分享）'."\n" + .'- /share_link/list（列举分享）'."\n" + .'- /share_link/get（获取分享信息）'."\n" + .'- /share_link/get_share_token（获取分享令牌）'."\n" + .'- /async_task/get（获取异步任务信息）', + 'type' => 'string', + 'required' => true, + 'enumValueTitles' => [ + '/file/copy' => '复制文件或文件夹', '/file/get_share_link_download_url' => '获取分享下载地址', '/file/move' => '移动文件或文件夹', '/share_link/create' => '创建分享', '/share_link/update' => '修改分享', '/async_task/get' => '获取异步任务信息', '/drive/get' => '获取空间信息', '/group/get' => '获取群组信息', '/share_link/list' => '列举分享', '/file/delete' => '删除文件或文件夹', + '/share_link/get' => '获取分享信息', '/file/get' => '获取文件详情', '/file/get_download_url' => '获取文件下载地址', '/recyclebin/restore' => '恢复文件或文件夹', '/file/update' => '修改文件信息', '/recyclebin/trash' => '放入回收站', '/file/search' => '搜索文件', '/user/get' => '获取用户信息', '/share_link/get_share_token' => '获取分享令牌', '/share_link/cancel' => '取消分享', + ], + 'example' => '/file/get', + ], + 'body' => [ + 'description' => '子请求的请求参数JSON字符串，可参考相应子请求API文档'."\n" + ."\n" + .'当指定了body必须传headers："Content-Type" 对应的类型，目前子请求入参是"application/json"', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['type' => 'any', 'description' => '子请求的请求body', 'example' => '{"domain_id":"1","drive_id":"1"}'], + ], + 'headers' => [ + 'description' => '子请求的请求头，表示body传入数据的类型', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['type' => 'string', 'description' => '子请求的请求headers', 'example' => '{"Content-Type":"application/json"}'], + ], + ], + 'required' => false, + ], + 'required' => true, + ], + ], 'required' => false, - 'example' => '0045157fa8e24f4f9a0d9e3ff158c1e0', ], ], - [ - 'name' => 'redirect_uri', - 'in' => 'formData', + ], + 'responses' => [ + 200 => [ 'schema' => [ - 'description' => '填写发起authorize时传入的redirect\\_uri，当grant\\_type为authorization\\_code时必填'."\n" - ."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'https://aliyun.com/pds'."\n", + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'responses' => [ + 'description' => '子请求的响应合集', + 'type' => 'array', + 'items' => [ + 'description' => '一个子请求响应内容', + 'type' => 'object', + 'properties' => [ + 'id' => ['description' => '子请求 id，和request进行关联', 'type' => 'string', 'example' => '93433894994ad2e1'], + 'status' => ['description' => '子请求的返回状态码，可参考相应子请求API文档', 'type' => 'integer', 'format' => 'int32', 'example' => '200'], + 'body' => [ + 'description' => '子请求的响应结果，可参考相应子请求API文档', + 'type' => 'object', + 'additionalProperties' => ['type' => 'any', 'description' => '子请求的响应body', 'example' => '{"domain_id":"1","drive_id":"1","file_id":"9520943DC264"}'], + ], + ], + ], + ], + ], ], ], + ], + 'title' => '批量调用API', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"responses\\": [\\n {\\n \\"id\\": \\"93433894994ad2e1\\",\\n \\"status\\": 200,\\n \\"body\\": {\\n \\"key\\": \\"{\\\\\\"domain_id\\\\\\":\\\\\\"1\\\\\\",\\\\\\"drive_id\\\\\\":\\\\\\"1\\\\\\",\\\\\\"file_id\\\\\\":\\\\\\"9520943DC264\\\\\\"}\\"\\n }\\n }\\n ]\\n}","type":"json"}]', + ], + 'CancelAssignRole' => [ + 'summary' => '当前仅支持取消团队管理员角色。', + 'path' => '/v2/role/cancel_assign', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], + 'security' => [ [ - 'name' => 'client_id', - 'in' => 'formData', - 'schema' => [ - 'description' => '在阿里云PDS控制台申请的App对应的ID'."\n" - ."\n", - 'type' => 'string', - 'required' => true, - 'example' => '1Zu***flH', - ], + 'AK' => [], ], [ - 'name' => 'client_secret', - 'in' => 'formData', - 'schema' => [ - 'description' => '在阿里云PDS控制台申请的App对应的Secret，WebServer类型的App必填此参数'."\n" - ."\n", - 'type' => 'string', - 'required' => false, - 'example' => '80D***3i5'."\n", - ], + 'BearerToken' => [], ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'deprecated' => false, + 'systemTags' => ['operationType' => 'none'], + 'parameters' => [ [ - 'name' => 'refresh_token', - 'in' => 'formData', - 'schema' => [ - 'description' => '用于刷新Token的令牌，当grant\\_type为refresh\\_token时此参数必传'."\n" - ."\n", - 'type' => 'string', - 'required' => false, - 'example' => '399623e13353490391266c7d48a13ed1', - ], + 'name' => 'domain_id', + 'in' => 'host', + 'schema' => ['title' => 'A short description of struct', 'description' => 'A short description of struct', 'type' => 'string', 'required' => false], ], [ - 'name' => 'assertion', - 'in' => 'formData', + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', 'schema' => [ - 'description' => '通过JWT私钥签名的字符串，里面包含待授权的用户信息和授权参数，结构参考JWTPayload。当grant_type为urn:ietf:params:oauth:grant-type:jwt-bearer时此参数必填。'."\n" - ."\n", - 'type' => 'string', + 'type' => 'object', + 'properties' => [ + 'identity' => ['description' => '唯一身份标识，当前仅支持取消用户的角色', 'required' => true, '$ref' => '#/components/schemas/Identity'], + 'role_id' => ['description' => '取消用户已分配的角色ID，当前仅支持填：SystemGroupAdmin（团队管理员）', 'type' => 'string', 'required' => true, 'example' => 'SystemGroupAdmin'], + 'manage_resource_type' => ['description' => '被取消角色管理的资源类型，当前仅支持：RT_Group（团队）', 'type' => 'string', 'required' => true, 'example' => 'RT_Group'], + 'manage_resource_id' => ['description' => '被取消角色管理的资源ID，当前仅支持填Group ID', 'type' => 'string', 'required' => true, 'example' => '105***b82'], + ], 'required' => false, - 'example' => 'ey***asd'."\n", + 'description' => '', ], ], ], 'responses' => [ - 200 => [ - 'headers' => [], + 204 => [ 'schema' => [ - 'description' => '访问令牌信息', - '$ref' => '#/components/schemas/Token', + 'type' => 'object', + 'properties' => [], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"access_token\\": \\"\\",\\n \\"refresh_token\\": \\"\\",\\n \\"expires_in\\": 0,\\n \\"token_type\\": \\"\\",\\n \\"user_id\\": \\"\\",\\n \\"user_name\\": \\"\\",\\n \\"avatar\\": \\"\\",\\n \\"nick_name\\": \\"\\",\\n \\"default_drive_id\\": \\"\\",\\n \\"role\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"expire_time\\": \\"\\",\\n \\"is_first_login\\": true,\\n \\"device_id\\": \\"\\",\\n \\"device_name\\": \\"\\",\\n \\"domain_id\\": \\"\\",\\n \\"default_sbox_drive_id\\": \\"\\",\\n \\"user_data\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"pin_setup\\": true,\\n \\"need_rp_verify\\": true,\\n \\"state\\": \\"\\",\\n \\"exist_link\\": [\\n {\\n \\"type\\": \\"\\",\\n \\"identity\\": \\"\\",\\n \\"extra\\": \\"\\"\\n }\\n ],\\n \\"need_link\\": true,\\n \\"device_info\\": \\"\\",\\n \\"device_signature\\": \\"\\"\\n}","type":"json"}]', - 'title' => '获取访问令牌', - 'description' => '<props="china">详细使用方法参考用户指南：[用户指南链接](https://help.aliyun.com/document_detail/175894.html)。</props>'."\n" - ."\n" - .'<props="china">JWT方式登录参考文档：[JWT登录链接](https://help.aliyun.com/document_detail/175893.html)。</props>'."\n" - ."\n" - .'<props="intl">详细使用方法参考用户指南：[用户指南链接](https://www.alibabacloud.com/help/zh/pds/latest/oauth2-for-web-server-app?spm=a2c63.p38356.0.0.267148fbJdRB0P)。</props>'."\n" - ."\n" - .'<props="intl">JWT方式登录参考文档：[JWT登录链接](https://www.alibabacloud.com/help/zh/pds/latest/jwt-application?spm=a2c63.p38356.0.0.45ab5f06NnPJqj)。</props>', - ], - 'GetLinkInfoByUserId' => [ - 'summary' => '根据用户ID获取账号信息。', - 'path' => '/v2/account/get_link_info_by_user_id', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '取消分配的角色', + 'description' => '当前仅支持取消团队管理员角色。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', + ], + 'CancelShareLink' => [ + 'summary' => '删除分享。', + 'path' => '/v2/share_link/cancel', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'BearerToken' => [], @@ -7815,24 +2226,14 @@ 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -7842,80 +2243,53 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'user_id' => [ - 'description' => '待查询的UserID', - 'type' => 'string', - 'required' => true, - 'example' => 'xxx', - ], + 'share_id' => ['description' => '分享id', 'type' => 'string', 'required' => true, 'example' => '7JQX1FswpQ8'], ], 'required' => false, ], ], ], 'responses' => [ - 200 => [ - 'headers' => [], + 204 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回结构体', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'items' => [ - 'title' => 'items', - 'description' => '用户账号信息列表', - 'type' => 'array', - 'items' => [ - 'description' => '用户账号信息', - '$ref' => '#/components/schemas/AccountLinkInfo', - ], - ], + '_' => ['title' => 'Id of the request', 'description' => 'Id of the request', 'type' => 'string'], ], ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'title' => '取消分享', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"authentication_type\\": \\"\\",\\n \\"identity\\": \\"\\",\\n \\"extra\\": \\"\\",\\n \\"user_id\\": \\"\\",\\n \\"created_at\\": 0,\\n \\"display_name\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"last_login_time\\": 0\\n }\\n ]\\n}","type":"json"}]', - 'title' => '根据用户ID获取账号信息', + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', ], - 'LinkAccount' => [ - 'summary' => '绑定账号。', - 'path' => '/v2/account/link', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'ClearRecyclebin' => [ + 'path' => '/v2/recyclebin/clear', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'BearerToken' => [], + 'AK' => [], ], [ - 'AK' => [], + 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, + 'systemTags' => ['operationType' => 'delete'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -7925,44 +2299,7 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'user_id' => [ - 'description' => '待绑定的UserID', - 'type' => 'string', - 'required' => true, - 'example' => 'xxx', - ], - 'type' => [ - 'description' => '账号类型'."\n" - ."\n" - .'- mobile：手机号'."\n" - ."\n" - .'- email：邮箱'."\n" - ."\n" - .'- ding：钉钉'."\n" - ."\n" - .'- ram：阿里云RAM子账号'."\n" - ."\n" - .'- wechat：企业微信'."\n" - ."\n" - .'- ldap：LDAP账号'."\n" - ."\n" - .'- custom：自定义账号', - 'type' => 'string', - 'required' => true, - 'example' => 'ding', - ], - 'identity' => [ - 'description' => '账号的唯一标识，比如手机号', - 'type' => 'string', - 'required' => true, - 'example' => 'eyy***', - ], - 'extra' => [ - 'description' => '账号唯一标识的附加信息，比如当账号为手机号时，此字段填手机的区域编码，比如中国大陆为86，不填写默认为86', - 'type' => 'string', - 'required' => false, - 'example' => '86', - ], + 'drive_id' => ['description' => '空间ID', 'type' => 'string', 'required' => true, 'example' => '1'], ], 'required' => false, ], @@ -7970,55 +2307,55 @@ ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ - 'description' => '返回用户的授权Token信息', - '$ref' => '#/components/schemas/Token', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'domain_id' => ['title' => 'Id of the request', 'description' => '域ID', 'type' => 'string', 'example' => 'bj1'], + 'drive_id' => ['description' => '空间ID', 'type' => 'string', 'example' => '1'], + 'async_task_id' => ['description' => '异步任务ID'."\n" + ."\n" + .'调用GetAsyncTask，传递异步任务ID，获取任务信息', 'type' => 'string', 'example' => '13ebd3a24dba4166b1527add676ef2866051b4d5dele16'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"access_token\\": \\"\\",\\n \\"refresh_token\\": \\"\\",\\n \\"expires_in\\": 0,\\n \\"token_type\\": \\"\\",\\n \\"user_id\\": \\"\\",\\n \\"user_name\\": \\"\\",\\n \\"avatar\\": \\"\\",\\n \\"nick_name\\": \\"\\",\\n \\"default_drive_id\\": \\"\\",\\n \\"role\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"expire_time\\": \\"\\",\\n \\"is_first_login\\": true,\\n \\"device_id\\": \\"\\",\\n \\"device_name\\": \\"\\",\\n \\"domain_id\\": \\"\\",\\n \\"default_sbox_drive_id\\": \\"\\",\\n \\"user_data\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"pin_setup\\": true,\\n \\"need_rp_verify\\": true,\\n \\"state\\": \\"\\",\\n \\"exist_link\\": [\\n {\\n \\"type\\": \\"\\",\\n \\"identity\\": \\"\\",\\n \\"extra\\": \\"\\"\\n }\\n ],\\n \\"need_link\\": true,\\n \\"device_info\\": \\"\\",\\n \\"device_signature\\": \\"\\"\\n}","type":"json"}]', - 'title' => '绑定账号', - ], - 'GetLinkInfo' => [ - 'summary' => '获取账号信息。', - 'path' => '/v2/account/get_link_info', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'tags' => [ - 'api', + 'title' => '清空回收站', + 'summary' => '清空回收站中所有文件和文件夹。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"async_task_id\\": \\"13ebd3a24dba4166b1527add676ef2866051b4d5dele16\\"\\n}","type":"json"}]', + ], + 'CompleteFile' => [ + 'summary' => '完成文件上传。', + 'path' => '/v2/file/complete', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'BearerToken' => [], + 'AK' => [], ], [ - 'AK' => [], + 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'read', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'create'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -8028,38 +2365,10 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'type' => [ - 'description' => '账号类型'."\n" - ."\n" - .'- mobile：手机号'."\n" - ."\n" - .'- email：邮箱'."\n" - ."\n" - .'- ding：钉钉'."\n" - ."\n" - .'- ram：阿里云RAM子账号'."\n" - ."\n" - .'- wechat：企业微信'."\n" - ."\n" - .'- ldap：LDAP账号'."\n" - ."\n" - .'- custom：自定义账号', - 'type' => 'string', - 'required' => true, - 'example' => 'mobile', - ], - 'identity' => [ - 'description' => '账号的唯一标识，比如手机号', - 'type' => 'string', - 'required' => true, - 'example' => '130***', - ], - 'extra' => [ - 'description' => '账号唯一标识的附加信息，比如当账号为手机号时，此字段填手机的区域编码。', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'upload_id' => ['description' => '上传id', 'type' => 'string', 'required' => true, 'example' => 'C9DCFE5A82644AC7A02DB74C30C934A6'], + 'file_id' => ['description' => '文件id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'crc64_hash' => ['type' => 'string', 'required' => false, 'description' => ''], ], 'required' => false, ], @@ -8067,32 +2376,25 @@ ], 'responses' => [ 200 => [ - 'headers' => [], - 'schema' => [ - 'description' => '返回用户账号信息', - '$ref' => '#/components/schemas/AccountLinkInfo', - ], + 'schema' => ['description' => '文件信息', '$ref' => '#/components/schemas/File'], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'title' => '完成文件上传', + 'description' => '使用方法参考最佳实践：[文件上传](~~175888~~)。'."\n" + ."\n" + .'文件上传过程中，已上传的文件分片会产生存储费用。分片将保留10天，直到文件上传完成或10天后分片过期被清理。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"authentication_type\\": \\"\\",\\n \\"identity\\": \\"\\",\\n \\"extra\\": \\"\\",\\n \\"user_id\\": \\"\\",\\n \\"created_at\\": 0,\\n \\"display_name\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"last_login_time\\": 0\\n}","type":"json"}]', - 'title' => '获取账号信息', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"5d79206586bb5dd69fb34c349282718146c55da7\\",\\n \\"name\\": \\"1.mov\\",\\n \\"type\\": \\"file\\",\\n \\"content_type\\": \\"application/json\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"image file\\",\\n \\"trashed_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"file_extension\\": \\"txt\\",\\n \\"hidden\\": false,\\n \\"size\\": 1024,\\n \\"starred\\": false,\\n \\"status\\": \\"available\\",\\n \\"labels\\": [\\n \\"[\\\\\\"label1:1\\\\\\", \\\\\\"label2:2\\\\\\"]\\"\\n ],\\n \\"upload_id\\": \\"C9DCFE5A82644AC7A02DB74C30C934A6\\",\\n \\"parent_file_id\\": \\"3d5b846942cf94fa72324c8a4bda34e81da635a\\",\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"category\\": \\"image\\",\\n \\"local_created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"local_modified_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"revision_id\\": \\"5d5b846942cf94fa72324c14a4bda34e81da635d\\",\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\\\\\"128X128\\\\\\": \\\\\\"https://url1\\\\\\", \\\\\\"800X800\\\\\\": \\\\\\"url2\\\\\\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1024,\\n \\"height\\": 1024,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"sport\\",\\n \\"name\\": \\"basketball\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"play basketball\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\\\\\"k1\\\\\\":\\\\\\"v1\\\\\\", \\\\\\"k2\\\\\\",\\\\\\"v2\\\\\\"\\"\\n },\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"id_path\\": \\"id1/id2\\",\\n \\"name_path\\": \\"root/f1/f2\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 1,\\n \\"file_count\\": 10\\n },\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"auto_delete_left_sec\\": 0\\n}","type":"json"}]', ], - 'UnLinkAccount' => [ - 'summary' => '取消账号绑定。', - 'path' => '/v2/account/unlink', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'CopyFile' => [ + 'summary' => '拷贝文件或目录。', + 'path' => '/v2/file/copy', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -8101,154 +2403,131 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - ], + 'systemTags' => ['operationType' => 'none'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => 'A short description of struct', - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'user_id' => [ - 'description' => '用户标识', - 'type' => 'string', - 'required' => true, - 'example' => 'uid1', - ], - 'type' => [ - 'description' => '账号类型'."\n" - ."\n" - .'mobile：手机号'."\n" - ."\n" - .'email：邮箱'."\n" - ."\n" - .'ding：钉钉'."\n" - ."\n" - .'ram：阿里云RAM子账号'."\n" - ."\n" - .'wechat：企业微信'."\n" - ."\n" - .'ldap：LDAP账号'."\n" - ."\n" - .'custom：自定义账号', - 'type' => 'string', - 'required' => true, - 'example' => 'mobile', - ], - 'identity' => [ - 'description' => '账号的唯一标识，比如手机号', - 'type' => 'string', - 'required' => true, - 'example' => '139****'."\n", - ], - 'extra' => [ - 'description' => '账号唯一标识的附加信息，比如当账号为手机号时，此字段填手机的区域编码，比如中国大陆为86，不填写默认为86', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], + 'share_id' => ['description' => '分享id。'."\n" + .'如果通过分享操作文件，请携带`x-share-token` header鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。'."\n" + .'`share_id`和`drive_id`两者必须有一个字段赋值。', 'type' => 'string', 'required' => false, 'example' => '7JQX1FswpQ8'], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => false, 'example' => '1'], + 'file_id' => ['description' => '文件或文件夹 id', 'type' => 'string', 'required' => true, 'example' => '4221bf6e6ab43c255edc4463bf3a6f5f5d317406'], + 'to_drive_id' => ['description' => '拷贝到的空间id。'."\n" + .'默认值同drive_id。', 'type' => 'string', 'required' => false, 'example' => '1'], + 'to_parent_file_id' => ['description' => '目的父文件夹 id，当复制进根目录时，填 root', 'type' => 'string', 'required' => true, 'example' => '6520943DC261'], + 'auto_rename' => ['description' => '当目标文件夹下存在同名文件时，是否自动重命名，默认为 false', 'type' => 'boolean', 'required' => false, 'example' => 'true'], ], 'required' => false, ], ], ], 'responses' => [ - 204 => [], + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'domain_id' => ['description' => '域id', 'type' => 'string', 'example' => 'bj1'], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'example' => '1'], + 'file_id' => ['description' => '复制后的新文件或文件夹 id', 'type' => 'string', 'example' => '4221bf6e6ab43a255edc4463bffa6f5f5d317401'], + 'async_task_id' => ['description' => '异步任务id。'."\n" + ."\n" + .'当复制的是文件时，不返回该字段；当复制的是文件夹时，为后台异步复制，会返回该字段，调用GetAsyncTask，传递异步任务id，获取任务信息。', 'type' => 'string', 'example' => '000e89fb-cf8f-11e9-8ab4-b6e980803a3b'], + ], + 'description' => '', + ], + ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '复制文件或文件夹', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '取消账号关联', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"4221bf6e6ab43a255edc4463bffa6f5f5d317401\\",\\n \\"async_task_id\\": \\"000e89fb-cf8f-11e9-8ab4-b6e980803a3b\\"\\n}","type":"json"}]', ], - 'CreateGroup' => [ - 'summary' => '创建群组。', - 'path' => '/v2/group/create', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'CreateCustomizedStory' => [ + 'summary' => '创建自定义故事。'."\n" + .'区别于推荐故事，自定义故事下面的文件列表由用户指定。', + 'path' => '/v2/image/create_customized_story', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'BearerToken' => [], + 'AK' => [], ], [ - 'AK' => [], + 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, + 'systemTags' => ['operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求体', 'type' => 'object', 'properties' => [ - 'group_name' => [ - 'description' => '群组名，长度1～128个字符', - 'type' => 'string', + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'story_type' => ['description' => '故事类型。由用户自定义。', 'type' => 'string', 'required' => true, 'example' => 'user_created'], + 'story_sub_type' => ['description' => '故事子类型。由用户自定义。', 'type' => 'string', 'required' => true, 'example' => 'user_created'], + 'story_name' => ['description' => '故事名称。'."\n" + .'长度不能超过 1024 字节。', 'type' => 'string', 'required' => true, 'example' => 'test_name'], + 'story_cover' => [ + 'description' => '故事封面。该封面必须在故事文件列表中。', + 'type' => 'object', + 'properties' => [ + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf'], + 'revision_id' => ['description' => '文件版本 id', 'type' => 'string', 'required' => false, 'example' => '642a88d4aff041ee68fd4fc89beb80e1119da343'], + ], 'required' => true, - 'example' => 'test group', - ], - 'description' => [ - 'description' => '描述信息，长度0～1024个字符', - 'type' => 'string', - 'required' => false, - 'example' => 'test group description', ], - 'is_root' => [ - 'description' => '是否是根群组，根群组不能加入其他任何群组，一般用于组织架构的顶层组织', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', + 'story_files' => [ + 'description' => '故事文件列表', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf'], + 'revision_id' => ['description' => '文件版本 id', 'type' => 'string', 'required' => false, 'example' => '642a88d4aff041ee68fd4fc89beb80e1119da343'], + ], + 'required' => false, + 'description' => '', + ], + 'required' => true, + 'minItems' => 1, ], - 'parent_group_id' => [ - 'description' => '需要加入的父群组ID，传入此字段时，创建完群组后，系统会将此群组自动加入到指定的父群组', - 'type' => 'string', + 'custom_labels' => [ + 'description' => '自定义标签。'."\n" + .'标签数量不能超过 20 个。', + 'type' => 'object', + 'deprecated' => true, 'required' => false, - 'example' => '2e43ec8427dd45f19431b7504649a1b3', + 'additionalProperties' => ['type' => 'string', 'example' => 'label_value', 'description' => '自定义标签'], ], ], 'required' => false, @@ -8258,52 +2537,50 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => '新创建的群组信息', - '$ref' => '#/components/schemas/Group', + 'title' => 'Schema of Response', + 'description' => '返回参数', + 'type' => 'object', + 'properties' => [ + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'example' => '1'], + 'story_id' => ['description' => '故事 id', 'type' => 'string', 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"group_id\\": \\"\\",\\n \\"group_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"created_at\\": 0,\\n \\"updated_at\\": 0,\\n \\"creator\\": \\"\\",\\n \\"is_sync\\": true\\n}","type":"json"}]', - 'title' => '创建群组', - ], - 'UpdateGroup' => [ - 'summary' => '根据群组ID定位到指定的群组，并修改群组信息。', - 'path' => '/v2/group/update', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建自定义故事', + 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" + ."\n" + .'使用此功能须开通增值服务图片处理功能。故事相关接口限时免费。'."\n" + ."\n" + .'用户通过传入指定文件列表创建自定义故事。其中故事类型和故事子类型用户可自定义，不再有约束。'."\n" + ."\n" + .'><notice>通过该接口指定故事封面时，该封面文件必须存在于故事列表中，否则会返回错误。></notice>'."\n" + .'><notice>自定义故事列表中的文件类型只能为图片。></notice>', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"drive_id\\": \\"1\\",\\n \\"story_id\\": \\"9132e0d8-fe92-4e56-86c3-f5f112308003\\"\\n}","type":"json"}]', + ], + 'CreateDomain' => [ + 'summary' => '创建 domain。', + 'path' => '/v2/domain/create', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'tags' => ['admin'], 'security' => [ [ - 'BearerToken' => [], - ], - [ 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'operationType' => 'readAndWrite', 'deprecated' => false, + 'systemTags' => ['operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ - 'name' => 'domain_id', - 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], - ], - [ 'name' => 'body', 'in' => 'body', 'style' => 'json', @@ -8311,23 +2588,25 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'group_id' => [ - 'description' => '待修改的群组ID', - 'type' => 'string', - 'required' => true, - 'example' => '2e43ec8427dd45f19431b7504649a1b4', - ], - 'group_name' => [ - 'description' => '修改后的群组名称', - 'type' => 'string', - 'required' => false, - 'example' => 'test group', - ], - 'description' => [ - 'description' => '修改后的描述', + 'parent_domain_id' => ['description' => '父 domain id'."\n" + .'如果需要创建子 domain，可以设置该值，一般情况下不需要创建。'."\n" + .'如果需要针对 PDS 做二次运营，可以联系 PDS 官网客服进行咨询。', 'type' => 'string', 'required' => false, 'example' => 'bj1'], + 'domain_name' => ['description' => 'domain 名称', 'type' => 'string', 'required' => true, 'example' => 'cloud drive'], + 'description' => ['description' => 'domain 描述', 'type' => 'string', 'required' => false, 'example' => 'cloud drive dev'], + 'init_drive_enable' => ['description' => '是否开通默认网盘。为true则所有用户在第一次登录后都默认分配一个网盘。默认false', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'init_drive_size' => ['description' => 'init\\_drive\\_enable 为true时必选。 创建用户时，默认网盘的大小，单位：Bytes。'."\n" + .'默认为 0，此时创建的 drive 大小为0，不可以上传文件，如果需要初始化 drive， 请设置该值。'."\n" + .'-1则表示不限大小。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1073741824'], + 'user_count_quota' => ['description' => '用户数配额，表示该 domain 允许创建的用户数量，为0表示不限制', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '50'], + 'size_quota' => ['description' => '容量配额，表示 domain 下所有 drive 的总quota 大小，0 表示不限制', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1099511627776'], + 'store_redundancy_type' => [ + 'description' => '指定存储冗余类型。枚举值： '."\n" + .'+ LRS：本地冗余'."\n" + .'+ ZRS：同城冗余', 'type' => 'string', 'required' => false, - 'example' => 'test group description', + 'example' => 'LRS', + 'enum' => [], ], ], 'required' => false, @@ -8336,27 +2615,25 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'description' => '修改后的群组信息', - '$ref' => '#/components/schemas/Group', - ], + 'schema' => ['description' => '创建的域信息', '$ref' => '#/components/schemas/Domain'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"group_id\\": \\"\\",\\n \\"group_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"created_at\\": 0,\\n \\"updated_at\\": 0,\\n \\"creator\\": \\"\\",\\n \\"is_sync\\": true\\n}","type":"json"}]', - 'title' => '修改群组信息', - ], - 'GetGroup' => [ - 'summary' => '获取群组信息。', - 'path' => '/v2/group/get', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建Domain', + 'description' => '如果您需要基于 PDS 做二次运营，并想针对您的租户做一些细粒度控制，此时可以使用 PDS 的父子 Domain 功能。'."\n" + .'详情：请联系官方钉钉群进行咨询：23146118', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"parent_domain_id\\": \\"bj1\\",\\n \\"domain_id\\": \\"bj2\\",\\n \\"domain_name\\": \\"pdsdomain\\",\\n \\"description\\": \\"my domain\\",\\n \\"init_drive_enable\\": true,\\n \\"init_drive_size\\": 1073741824,\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"size_quota\\": 1099511627776,\\n \\"size_quota_used\\": 1099511627776,\\n \\"user_count_quota\\": 50,\\n \\"status\\": 1,\\n \\"used_size\\": 1099511627776,\\n \\"published_app_access_strategy\\": {\\n \\"effect\\": \\"deny\\",\\n \\"except_app_id_list\\": [\\n \\"8ovxCTRUDdbpVWBP\\"\\n ]\\n },\\n \\"sharable\\": true,\\n \\"data_hash_name\\": \\"sha1\\",\\n \\"store_redundancy_type\\": \\"LRS\\"\\n}","type":"json"}]', + ], + 'CreateDrive' => [ + 'summary' => '创建空间。', + 'path' => '/v2/drive/create', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -8365,36 +2642,63 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, + 'systemTags' => ['operationType' => 'create'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求参数。', + 'description' => '请求体。', 'type' => 'object', 'properties' => [ - 'group_id' => [ - 'description' => '待获取的群组ID', + 'drive_name' => ['description' => '空间名称，最长 128 字符', 'type' => 'string', 'required' => true, 'example' => 'My personal space', 'maxLength' => 1024, 'minLength' => 1], + 'owner' => ['description' => '归属者ID', 'type' => 'string', 'required' => true, 'example' => '3b3d7245c159488da17d081ad6c64687'], + 'owner_type' => [ + 'description' => '归属者类型，可选值如下：'."\n" + ."\n" + .'user：用户'."\n" + .'group：团队', 'type' => 'string', 'required' => true, - 'example' => '2e43ec8427dd45f19431b7504649a1b1', + 'enumValueTitles' => ['user' => 'user', 'group' => 'group'], + 'example' => 'user', + 'enum' => ['user', 'group'], + ], + 'description' => ['description' => '描述信息，最长 1024 字符', 'type' => 'string', 'required' => false, 'example' => 'VIP space', 'maxLength' => 1024], + 'drive_type' => [ + 'description' => '空间类型，当前只支持 normal', + 'type' => 'string', + 'required' => false, + 'enumValueTitles' => ['normal' => 'normal'], + 'example' => 'normal', + 'default' => 'normal', + 'enum' => [], + ], + 'status' => [ + 'description' => '状态，可选值如下：'."\n" + ."\n" + .'enabled：可用'."\n" + .'disabled：禁用'."\n" + ."\n" + .'默认为 enabled', + 'type' => 'string', + 'required' => false, + 'enumValueTitles' => ['disabled' => 'disabled', 'enabled' => 'enabled'], + 'example' => 'enabled', + 'default' => 'enabled', + 'enum' => ['enabled', 'disabled'], ], + 'total_size' => ['description' => '总大小，单位为字节，默认不限大小', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1024'], + 'default' => ['description' => '是否是默认空间，默认为 false', 'type' => 'boolean', 'required' => false, 'example' => 'true', 'default' => 'false'], ], 'required' => false, ], @@ -8403,26 +2707,40 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => '群组信息', - '$ref' => '#/components/schemas/Group', + 'title' => 'Schema of Response', + 'description' => '返回信息', + 'type' => 'object', + 'properties' => [ + 'domain_id' => ['title' => 'Id of the request', 'description' => '域id', 'type' => 'string', 'example' => 'bj1'], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'example' => '1'], + 'drive_name' => ['description' => '空间名称', 'type' => 'string', 'example' => 'My personal space'], + 'description' => ['description' => '描述信息', 'type' => 'string', 'example' => 'VIP space'], + 'owner' => ['description' => '归属者ID', 'type' => 'string', 'example' => '3b3d7245c159488da17d081ad6c64687'."\n"], + 'owner_type' => ['description' => '归属者类型', 'type' => 'string', 'example' => 'user'], + 'drive_type' => ['description' => '空间类型', 'type' => 'string', 'example' => 'normal'], + 'used_size' => ['description' => '使用空间大小，单位为字节', 'type' => 'integer', 'format' => 'int64', 'example' => '1024'], + 'total_size' => ['description' => '总空间大小，单位为字节', 'type' => 'integer', 'format' => 'int64', 'example' => '1024'], + 'creator' => ['description' => '创建者ID。', 'type' => 'string', 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4'], + 'created_at' => ['description' => '创建时间', 'type' => 'string', 'example' => '2024-08-14T03:14:28.109Z'], + 'status' => ['description' => '状态', 'type' => 'string', 'example' => 'enabled'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"group_id\\": \\"\\",\\n \\"group_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"created_at\\": 0,\\n \\"updated_at\\": 0,\\n \\"creator\\": \\"\\",\\n \\"is_sync\\": true\\n}","type":"json"}]', - 'title' => '获取群组信息', - ], - 'ListGroup' => [ - 'summary' => '列举群组。', - 'path' => '/v2/group/list', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"drive_name\\": \\"My personal space\\",\\n \\"description\\": \\"VIP space\\",\\n \\"owner\\": \\"3b3d7245c159488da17d081ad6c64687\\\\n\\",\\n \\"owner_type\\": \\"user\\",\\n \\"drive_type\\": \\"normal\\",\\n \\"used_size\\": 1024,\\n \\"total_size\\": 1024,\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"created_at\\": \\"2024-08-14T03:14:28.109Z\\",\\n \\"status\\": \\"enabled\\"\\n}","type":"json"}]', + 'title' => '创建空间', + 'description' => '创建空间前确保操作对应用户/团队未被分配空间。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'CreateFile' => [ + 'summary' => '创建文件或文件夹。', + 'path' => '/v2/file/create', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -8431,43 +2749,112 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, + 'systemTags' => ['operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'limit' => [ - 'description' => '限定此次返回资源的数量。如果不设定，默认返回100，最大不能超过100。', - 'type' => 'integer', - 'format' => 'int32', + 'name' => ['title' => '文件或文件夹名称', 'description' => '文件名称，按照 utf8 编码最长 1024 字节，不能包含 /', 'type' => 'string', 'required' => true, 'example' => 'a.txt', 'maxLength' => 1024, 'minLength' => 1], + 'type' => [ + 'title' => '类型', + 'description' => '文件类型，可选值如下：'."\n" + ."\n" + .'file：文件'."\n" + .'folder：文件夹', + 'type' => 'string', + 'required' => true, + 'example' => 'file', + 'enum' => ['file', 'folder'], + ], + 'parent_file_id' => ['title' => '父文件夹id', 'description' => '父目录id，上传到根目录时填写 root', 'type' => 'string', 'required' => true, 'example' => 'fileid1'], + 'drive_id' => ['title' => '用户空间id', 'description' => '空间 id，除通过分享链接上传之外，必填', 'type' => 'string', 'required' => false, 'example' => '1', 'pattern' => '^[0-9]*$'], + 'share_id' => ['title' => '共享id', 'description' => '分享 id，当通过分享链接上传时必填', 'type' => 'string', 'required' => false, 'example' => '7JQX1FswpQ8'], + 'size' => ['title' => '文件大小', 'description' => '文件大小，单位为 byte。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1024'], + 'content_type' => ['title' => '文件类型', 'description' => '文件内容类型，默认值 application/oct-stream<props="china">，常见的 content_type 可以参考 OSS [《如何设置Content-Type（MIME）？》](https://help.aliyun.com/document_detail/39522.htm?spm=a2c4g.11186623.0.0.5a0b7dbb1TPnWF#concept-5041)。</props>', 'type' => 'string', 'required' => false, 'example' => 'application/json'], + 'part_info_list' => [ + 'description' => '分片信息列表，最多 10000 个分片，当不填时，默认返回 1 个分片', + 'type' => 'array', + 'items' => [ + 'description' => '分片信息', + 'type' => 'object', + 'properties' => [ + 'part_number' => ['description' => '分片序列号，从 1 开始', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], + 'parallel_sha1_ctx' => [ + 'description' => '该分片前所有数据的SHA1上下文，该字段只在多分片并发上传的模式下有效', + 'type' => 'object', + 'properties' => [ + 'h' => [ + 'description' => '该分片前所有数据的SHA1上下文的第1-5个32位变量，该字段只在多分片并发上传的模式下有效', + 'type' => 'array', + 'items' => ['description' => '该分片前所有数据的SHA1上下文的第1-5个32位变量', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1'], + 'required' => false, + ], + 'part_offset' => ['description' => '到上一个数据块为止的总长度，字节，需要为64的倍数，该字段只在多分片并发上传的模式下有效', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '10240'], + ], + 'required' => false, + ], + 'content_md5' => ['description' => '分片的 MD5, 需要在上传分片时校验分片的MD5时填写。', 'type' => 'string', 'deprecated' => false, 'required' => false, 'example' => 'ASKJDJSKDJJSJDJS'], + 'content_type' => ['title' => '指定客户端使用 Put 上传分片时需要设置的 Content-Type 值。 如果客户端上传时指定的 Content-Type 和这里不一致，会出现签名错误。 默认为空，客户端 Put 时可以不指定 Content-Type。', 'type' => 'string', 'deprecated' => false, 'example' => 'application/json'], + ], + 'required' => false, + ], 'required' => false, - 'example' => '100', ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。 默认值：无', + 'user_tags' => [ + 'title' => '用户打标', + 'description' => '用户自定义 tag，最多 1000 个 tag', + 'type' => 'array', + 'items' => ['description' => '用户自定义 tag', 'required' => false, '$ref' => '#/components/schemas/UserTag'], + 'required' => false, + ], + 'hidden' => ['description' => '是否隐藏，默认不隐藏', 'type' => 'boolean', 'required' => false, 'example' => 'false', 'default' => 'false'], + 'description' => ['title' => '描述信息', 'description' => '文件描述信息，最长 1024 字符，默认为空', 'type' => 'string', 'required' => false, 'example' => 'Team file', 'maxLength' => 1024], + 'content_hash' => ['title' => '内容hash', 'description' => '文件内容 hash 值，需要根据 content_hash_name 指定的算法计算', 'type' => 'string', 'required' => false, 'example' => '7C4A8D09CA3762AF61E59520943DC26494F8941B'], + 'content_hash_name' => [ + 'title' => '内容hash算法名', + 'description' => '文件内容hash算法名，当前只支持 sha1', 'type' => 'string', 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', + 'example' => 'sha1', + 'enum' => ['sha1'], ], + 'pre_hash' => ['description' => '使用预秒传功能时填写，为文件前1KB sha1值，当远端没有匹配上时，客户端无需再计算文件完整 sha1 去尝试秒传。', 'type' => 'string', 'required' => false, 'example' => '7C4A8D09CA3762AF61E59520943DC26494F89411'], + 'check_name_mode' => [ + 'title' => '重命名模式', + 'description' => '同名文件处理模式，可选值如下：'."\n" + ."\n" + .'ignore：允许同名文件；'."\n" + ."\n" + .'auto_rename：当发现同名文件是，云端自动重命名，默认为追加当前时间点，如 xxx _20060102_150405；'."\n" + ."\n" + .'refuse：当云端存在同名文件时，拒绝创建新文件，返回客户端已存在同名文件的详细信息。'."\n" + ."\n" + .'默认为 ignore', + 'type' => 'string', + 'required' => false, + 'enumValueTitles' => ['refuse' => 'refuse', 'auto_rename' => 'auto_rename', 'ignore' => 'ignore'], + 'example' => 'ignore', + 'enum' => ['ignore', 'auto_rename', 'refuse'], + ], + 'file_id' => ['title' => '文件id', 'description' => '文件id，覆盖写时必填', 'type' => 'string', 'required' => false, 'example' => '9520943DC264'], + 'local_created_at' => ['title' => '文件本地创建时间', 'description' => '文件本地创建时间，默认为空，格式为：yyyy-MM-ddTHH:mm:ssZ，采用 UTC +0 时区', 'type' => 'string', 'required' => false, 'example' => '2023-10-04T14:30:00Z'], + 'local_modified_at' => ['title' => '本地文件修改时间', 'description' => '文件本地修改时间，默认为空，格式为：yyyy-MM-ddTHH:mm:ssZ，采用 UTC +0 时区', 'type' => 'string', 'required' => false, 'example' => '2023-10-04T14:30:00Z'], + 'parallel_upload' => ['description' => '是否开启并行上传分片功能', 'type' => 'boolean', 'required' => false, 'example' => 'true', 'default' => 'false'], + 'upload_type' => ['title' => '上传类型，支持 multipart，form，默认：multipart', 'type' => 'string', 'example' => 'multipart', 'default' => 'multipart'], ], 'required' => false, ], @@ -8475,44 +2862,47 @@ ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '返回信息', 'type' => 'object', 'properties' => [ - 'items' => [ - 'description' => '群组列表', + 'parent_file_id' => ['title' => '父目录文件id', 'description' => '父目录id', 'type' => 'string', 'example' => 'fileid5'], + 'part_info_list' => [ + 'title' => '分段信息', + 'description' => '分段信息列表', 'type' => 'array', - 'items' => [ - 'description' => '群组信息', - '$ref' => '#/components/schemas/Group', - ], - ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空。', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', + 'items' => ['description' => '分段信息', '$ref' => '#/components/schemas/UploadPartInfo'], ], + 'upload_id' => ['title' => '上传id', 'description' => '上传id', 'type' => 'string', 'example' => 'uploadid1'], + 'rapid_upload' => ['title' => '是否已经秒传', 'description' => '是否已经秒传', 'type' => 'boolean', 'example' => 'true'], + 'type' => ['description' => '文件类型', 'type' => 'string', 'example' => 'file'], + 'file_id' => ['title' => '文件id', 'description' => '文件id', 'type' => 'string', 'example' => 'fileid1'], + 'domain_id' => ['title' => '域id', 'description' => '域id', 'type' => 'string', 'example' => 'bj1'], + 'drive_id' => ['title' => '空间id', 'description' => '空间id', 'type' => 'string', 'example' => '1'], + 'file_name' => ['title' => '文件名', 'description' => '文件名', 'type' => 'string', 'example' => 'a.txt'], + 'status' => ['title' => '文件状态', 'description' => '文件状态', 'type' => 'string', 'example' => 'uploading'], + 'exist' => ['title' => '文件是否存在', 'description' => '文件是否存在', 'type' => 'boolean', 'example' => 'false'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"group_id\\": \\"\\",\\n \\"group_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"created_at\\": 0,\\n \\"updated_at\\": 0,\\n \\"creator\\": \\"\\",\\n \\"is_sync\\": true\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', - 'title' => '列举群组', - ], - 'DeleteGroup' => [ - 'summary' => '删除群组接口， 在删除群组前，需保证群组下没有其他群组或用户，否则会导致删除失败。', - 'path' => '/v2/group/delete', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"parent_file_id\\": \\"fileid5\\",\\n \\"part_info_list\\": [\\n {\\n \\"part_number\\": 1,\\n \\"part_size\\": 1024,\\n \\"upload_url\\": \\"https://data.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661\\",\\n \\"internal_upload_url\\": \\"https://data-vpc.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661\\\\n\\",\\n \\"etag\\": \\"\\\\\\"0CC175B9C0F1B6A831C399E269772661\\\\\\"\\",\\n \\"parallel_sha1_ctx\\": {\\n \\"h\\": [\\n 0\\n ],\\n \\"part_offset\\": 10240\\n },\\n \\"upload_form_info\\": {\\n \\"endpoint\\": \\"\\",\\n \\"form_data\\": {\\n \\"key\\": \\"\\"\\n }\\n },\\n \\"parallel_sha256_ctx\\": {\\n \\"h\\": [\\n 0\\n ],\\n \\"part_offset\\": 0\\n }\\n }\\n ],\\n \\"upload_id\\": \\"uploadid1\\",\\n \\"rapid_upload\\": true,\\n \\"type\\": \\"file\\",\\n \\"file_id\\": \\"fileid1\\",\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_name\\": \\"a.txt\\",\\n \\"status\\": \\"uploading\\",\\n \\"exist\\": false\\n}","type":"json"}]', + 'title' => '创建文件或文件夹', + 'description' => '文件创建使用方法参考最佳实践：[文件上传](~~175888~~)。'."\n" + ."\n" + .'文件上传过程中，已上传的文件分片会产生存储费用。分片将保留10天，直到文件上传完成或10天后分片过期被清理。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'CreateGroup' => [ + 'summary' => '创建群组。', + 'path' => '/v2/group/create', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'BearerToken' => [], @@ -8521,22 +2911,14 @@ 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -8546,42 +2928,33 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'group_id' => [ - 'description' => '待删除的群组ID', - 'type' => 'string', - 'required' => true, - 'example' => 'g123', - ], + 'group_name' => ['description' => '群组名，长度1～128个字符', 'type' => 'string', 'required' => true, 'example' => 'test group'], + 'description' => ['description' => '描述信息，长度0～1024个字符', 'type' => 'string', 'required' => false, 'example' => 'test group description'], + 'is_root' => ['description' => '是否是根群组，根群组不能加入其他任何群组，一般用于组织架构的顶层组织', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + 'parent_group_id' => ['description' => '需要加入的父群组ID，传入此字段时，创建完群组后，系统会将此群组自动加入到指定的父群组', 'type' => 'string', 'required' => false, 'example' => '2e43ec8427dd45f19431b7504649a1b3'], ], 'required' => false, ], ], ], 'responses' => [ - 204 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [], - ], + 200 => [ + 'schema' => ['description' => '新创建的群组信息', '$ref' => '#/components/schemas/Group'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '删除群组', - ], - 'AddGroupMember' => [ - 'summary' => '添加成员到群组。', - 'path' => '/v2/group/add_member', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '创建群组', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"group_id\\": \\"b45c0c0c373c41ec9ebb5c85a025a08f\\",\\n \\"group_name\\": \\"test group\\",\\n \\"description\\": \\"created by system\\",\\n \\"created_at\\": 1670573504600,\\n \\"updated_at\\": 1670573504600,\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"is_sync\\": true\\n}","type":"json"}]', + ], + 'CreateIdentityToBenefitPkgMapping' => [ + 'summary' => '创建实体和权益包关联，可用于给用户绑定权益包。', + 'path' => '/v2/benefit/identity_to_benefit_pkg_mapping/create', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -8590,87 +2963,159 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => 'A short description of struct', - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求体参数', 'type' => 'object', 'properties' => [ - 'group_id' => [ - 'description' => '目标群组ID，表示将成员添加到目标群组下', - 'type' => 'string', - 'required' => true, - 'example' => '3e5***2c2', - ], - 'member_type' => [ - 'description' => '成员类型，当前只能添加用户，群组可以在创建时直接选择加入的父群组'."\n" + 'identity_type' => [ + 'description' => '实体的类型'."\n" ."\n" - .'- user（用户）'."\n" - ."\n\n" - .'注意：群组只能作为一个群组的成员，不能同时成为多个群组的成员。 用户可以同时成为多个群组的成员', + .'管理用户权益时，传user', 'type' => 'string', 'required' => true, 'example' => 'user', + 'enum' => ['user'], ], - 'member_id' => [ - 'description' => '成员ID， 当member\\_type为user时，此字段填对应的userID。 ', - 'type' => 'string', - 'required' => true, - 'example' => '2e4***1b1', - ], + 'identity_id' => ['description' => '实体的唯一标识'."\n" + ."\n" + .'管理用户权益时，传user_id', 'type' => 'string', 'required' => true, 'example' => 'user123'], + 'benefit_pkg_id' => ['description' => '权益包的唯一标识', 'type' => 'string', 'required' => true, 'example' => '40cb7794c9294'], + 'amount' => ['description' => '权益包数量'."\n" + ."\n" + .'对资源类权益包生效，非必填参数，默认为1', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1'], + 'expire_time' => ['description' => '权益包超期时间的时间戳，格林威治时间1970年01月01日00时00分00秒起至现在的毫秒数'."\n" + ."\n" + .'默认永不过期', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1633167071000'], ], 'required' => false, ], ], ], 'responses' => [ - 204 => [ - 'headers' => [], + 200 => [], + ], + 'title' => '创建实体和权益包关联', + 'description' => '如果您需要基于PDS做面向大量用户的二次运营，可以基于权益对用户可使用的功能和配额进行控制。 详情请联系官方钉钉群进行咨询：23146118', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', + ], + 'CreateShareLink' => [ + 'summary' => '创建分享。', + 'path' => '/v2/share_link/create', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], + 'security' => [ + [ + 'BearerToken' => [], + ], + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'deprecated' => false, + 'systemTags' => ['operationType' => 'create'], + 'parameters' => [ + [ + 'name' => 'domain_id', + 'in' => 'host', + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], + ], + [ + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '请求体参数。', 'type' => 'object', - 'properties' => [], + 'properties' => [ + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'share_all_files' => ['description' => '是否分享整个drive中的文件', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'file_id_list' => [ + 'description' => '分享父路径文件id列表。'."\n" + .'父路径文件个数范围[1, 100]。'."\n" + .'如果`share_all_files=true`，那么此字段无效，否则必须要填写', + 'type' => 'array', + 'items' => ['description' => '分享父路径文件id', 'type' => 'string', 'required' => false, 'example' => '9520943DC264'], + 'required' => false, + 'example' => '["520b217f13adf4fc24f2191991b1664ce045b393"]', + ], + 'user_id' => ['description' => '用户id。使用AK方式请求时，必填', 'type' => 'string', 'required' => false, 'example' => 'u123'], + 'share_pwd' => ['description' => '提取码。'."\n" + .'提取码长度范围[0, 64]字节'."\n" + .'不设置或者设置为空表示无提取码，在获取分享令牌的时候也不用设置提取码参数。'."\n" + .'要求使用ASCII可见字符。', 'type' => 'string', 'required' => false, 'example' => 'abcF123x'], + 'expiration' => ['description' => '失效时间点。'."\n" + .'RFC3339格式，比如："2020-06-28T11:33:00.000+08:00"。'."\n" + .'当expiration取值""时，表示永久有效', 'type' => 'string', 'required' => false, 'example' => '2020-06-28T11:33:00.000+08:00'], + 'description' => ['description' => '分享描述。'."\n" + .'长度范围[0, 1024]字符', 'type' => 'string', 'required' => false, 'example' => 'Lecture collection'], + 'share_name' => ['description' => '分享名。'."\n" + .'如果未设置，默认使用file\\_id\\_list中的第一个id对应的文件名。'."\n" + .'长度范围[0, 128]字符', 'type' => 'string', 'required' => false, 'example' => 'LectureRoom-1.MP4'], + 'disable_preview' => ['description' => '禁止预览分享中的文件', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + 'disable_save' => ['description' => '禁止转存分享中的文件', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + 'disable_download' => ['description' => '禁止下载分享中的文件', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + 'preview_limit' => ['description' => '分享预览次数限制。'."\n" + .'次数要求>=0。'."\n" + .'次数0表示不限制', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '100'], + 'save_limit' => ['description' => '分享转存次数限制。'."\n" + .'次数要求>=0。'."\n" + .'次数0表示不限制', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '100'], + 'download_limit' => ['description' => '分享下载次数限制。'."\n" + .'次数要求>=0。'."\n" + .'次数0表示不限制', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '100'], + 'require_login' => ['description' => '登录后才允许访问分享', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'office_editable' => ['description' => '允许在线编辑分享的文档', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'creatable' => ['description' => '允许在分享中的文件夹中创建文件；creatable为true时，需要同时传creatable_file_id_list参数', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'creatable_file_id_list' => [ + 'description' => '允许上传的文件夹file id列表', + 'type' => 'array', + 'items' => ['description' => '文件夹file id', 'type' => 'string', 'required' => false, 'example' => '9520943DC264'], + 'required' => false, + ], + ], + 'required' => false, ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '添加群组成员', - ], - 'RemoveGroupMember' => [ - 'summary' => '从群组移除成员。', - 'path' => '/v2/group/remove_member', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', + 'responses' => [ + 200 => [ + 'schema' => ['description' => '返回信息', '$ref' => '#/components/schemas/ShareLink'], + ], ], - 'tags' => [ - 'api', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"share_id\\": \\"7JQX1FswpQ8\\",\\n \\"share_pwd\\": \\"abcF123x\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id_list\\": [\\n \\"[\\\\\\"xx\\\\\\"]\\"\\n ],\\n \\"expiration\\": \\"2020-06-28T11:33:00.000+08:00\\",\\n \\"expired\\": false,\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"videos\\",\\n \\"share_name\\": \\"video-1.MP4\\",\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"status\\": \\"enabled\\",\\n \\"preview_count\\": 10,\\n \\"save_count\\": 2,\\n \\"download_count\\": 5,\\n \\"report_count\\": 0,\\n \\"video_preview_count\\": 1,\\n \\"access_count\\": 4,\\n \\"disable_preview\\": false,\\n \\"disable_save\\": false,\\n \\"disable_download\\": false,\\n \\"preview_limit\\": 100,\\n \\"save_limit\\": 100,\\n \\"download_limit\\": 100,\\n \\"require_login\\": false,\\n \\"share_all_files\\": true,\\n \\"share_msg\\": \\"pwd: 123\\",\\n \\"save_download_limit\\": 100,\\n \\"office_editable\\": true\\n}","type":"json"}]', + 'title' => '创建分享', + 'description' => '分享又称之为文件分享，是一个文件视图容器，通过其可将用户空间中的一个或多个文件暴露给匿名用户访问，匿名用户在分享权限的约束下访问其中的文件。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'CreateSimilarImageClusterTask' => [ + 'path' => '/v2/image/create_similar_image_cluster_task', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -8679,87 +3124,70 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => 'A short description of struct', - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求体', 'type' => 'object', 'properties' => [ - 'group_id' => [ - 'description' => '目标群组ID，表示从哪个群组下移除成员', - 'type' => 'string', - 'required' => true, - 'example' => '3e5***2c2', - ], - 'member_type' => [ - 'description' => '成员类型，当前只能移除用户，群组移除可以通过删除群组完成'."\n" - ."\n" - .'- user（用户）'."\n" - ."\n" - .'注意：群组只能作为一个群组的成员，不能同时成为多个群组的成员。 用户可以同时成为多个群组的成员', - 'type' => 'string', - 'required' => true, - 'example' => 'user', - ], - 'member_id' => [ - 'description' => '成员ID， 当member\\_type为user时，此字段填对应的userID。'."\n", - 'type' => 'string', - 'required' => true, - 'example' => '2e4***1b1', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '123'], ], 'required' => false, ], ], ], 'responses' => [ - 204 => [ - 'headers' => [], + 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '返回参数', 'type' => 'object', - 'properties' => [], + 'properties' => [ + 'task_id' => ['description' => '任务 id', 'type' => 'string', 'example' => 'i:SimilarImageClustering-b67d53e7-2fe8-460f-9b95-1e93636923eb'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '移除群组成员', - ], - 'ListGroupMember' => [ - 'summary' => '列举团队成员。', - 'path' => '/v2/group/list_member', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '创建相似图片聚类任务', + 'summary' => '用户可以发起创建相似图片聚类任务，该任务会将指定 drive 空间下相似的图片聚类在一起。', + 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" + ."\n" + .'使用此功能须开通增值服务图片处理功能，此功能目前限时免费。'."\n" + ."\n" + .'使用步骤：'."\n" + ."\n" + .'- 创建相似图片聚类任务'."\n" + .'- 通过 GetTaskStatus 接口查询相似图片聚类任务是否执行完成'."\n" + .'- 通过 SearchSimilarImageClusters 接口获取相似图片聚类结果'."\n" + ."\n" + .'同一 drive 同一时刻只能有一个相似图片聚类任务运行，若上一任务未结束，再次调用相似图片聚类任务会返回失败。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"task_id\\": \\"i:SimilarImageClustering-b67d53e7-2fe8-460f-9b95-1e93636923eb\\"\\n}","type":"json"}]', + ], + 'CreateStory' => [ + 'summary' => '创建推荐故事。'."\n" + .'PDS 会根据请求参数中的故事类型和时间范围筛选 drive 空间下的图片和视频，将符合条件的图片、视频加入该故事的文件列表。'."\n" + .'若没有符合条件的图片、视频，则会创建空故事。', + 'path' => '/v2/image/create_story', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -8768,69 +3196,53 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'read', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => 'A short description of struct', - 'type' => 'string', - 'required' => false, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', - 'allowEmptyValue' => true, 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求体', 'type' => 'object', 'properties' => [ - 'group_id' => [ - 'description' => '目标群组ID，表示将列举哪个群组下的成员', + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'story_id' => ['description' => '故事 id。由用户指定。', 'type' => 'string', 'required' => false, 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003'], + 'story_type' => [ + 'description' => '故事类型', 'type' => 'string', 'required' => true, - 'example' => '3e5***2c2', - ], - 'member_type' => [ - 'description' => '列举的成员类型，不传则两种都返回'."\n" - ."\n" - .'- user（用户）'."\n" - ."\n" - .'- group（群组）'."\n" - ."\n" - .'注意：群组只能作为一个群组的成员，不能同时成为多个群组的成员。 用户可以同时成为多个群组的成员', - 'type' => 'string', - 'required' => false, - 'example' => 'user', - ], - 'limit' => [ - 'description' => '限定此次返回资源的数量，取值范围[1,100]。'."\n" - .'返回结果可以小于指定的数量，但不能多于指定的数量。'."\n" - .'<br>默认值：100', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '50', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'<br>默认值：无', - 'type' => 'string', + 'enumValueTitles' => ['PeopleMemory' => '人物故事', 'TagMemory' => '标签故事', 'TimeMemory' => '时光故事', 'TravelMemory' => '旅行故事'], + 'example' => 'TagMemory', + 'enum' => ['TimeMemory', 'PeopleMemory', 'TagMemory', 'TravelMemory'], + ], + 'story_sub_type' => ['description' => '故事子类型。其值取决于故事类型，详情可见请求参数补充说明。', 'type' => 'string', 'required' => false, 'example' => 'Food'], + 'story_name' => ['description' => '故事名称。'."\n" + .'长度不超过 1024 个字节。', 'type' => 'string', 'required' => false, 'example' => 'Food'], + 'story_start_time' => ['description' => '创建故事照片或视频的开始时间。RFC3339。', 'type' => 'string', 'required' => false, 'example' => '2016-12-30T16:00:00Z'], + 'story_end_time' => ['description' => '创建故事照片或视频的结束时间。RFC3339。', 'type' => 'string', 'required' => false, 'example' => '2022-12-30T16:00:00Z'], + 'min_image_count' => ['description' => '创建故事照片或视频文件最小个数。'."\n" + .'须大于 0，小于等于 max\\_image\\_count，空值默认为 1。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'minimum' => '1', 'example' => '1', 'default' => '1'], + 'max_image_count' => ['description' => '创建故事照片或视频文件最大个数。'."\n" + .'须小于等于 100，大于等于 min\\_image\\_count，空值默认 30。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'maximum' => '100', 'example' => '30', 'default' => '30'], + 'custom_labels' => [ + 'description' => '自定义标签。'."\n" + .'标签数量不能超过 20 个。', + 'type' => 'object', + 'deprecated' => true, 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', + 'additionalProperties' => ['type' => 'string', 'example' => 'label_value', 'description' => '自定义标签'], ], + 'address' => ['description' => '地址信息', 'required' => false, '$ref' => '#/components/schemas/Address'], ], 'required' => false, ], @@ -8838,56 +3250,73 @@ ], 'responses' => [ 200 => [ - 'headers' => [], 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回的结构体', + 'description' => '返回参数', 'type' => 'object', 'properties' => [ - 'user_items' => [ - 'description' => '用户列表', - 'type' => 'array', - 'items' => [ - 'description' => '用户信息', - '$ref' => '#/components/schemas/User', - ], - ], - 'group_items' => [ - 'description' => '群组列表', - 'type' => 'array', - 'items' => [ - 'description' => '群组信息', - '$ref' => '#/components/schemas/Group', - ], - ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空。', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhM1', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'example' => '1'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'staticInfo' => ['returnType' => 'synchronous'], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"drive_id\\": \\"1\\"\\n}","type":"json"}]', + 'title' => '创建推荐故事', + 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" + ."\n" + .'使用此功能须开通增值服务图片处理功能。故事相关接口限时免费。'."\n" + ."\n" + .'用户创建故事时可自己指定故事 id：'."\n" + .'- 若指定故事 id：'."\n" + .' - 若故事 id 不存在，则使用该 id 创建新故事；'."\n" + .' - 若故事 id 存在，则会根据新条件生成故事并覆盖更新该故事；'."\n" + .'- 若不指定 id，则会由 PDS 生成故事 id。'."\n" + ."\n\n" + .'> '."\n" + .'> - 该接口为异步接口，用户创建推荐故事后需要等待一定时间生成该故事。用户可以通过 GetStory 接口或者 FindStories 接口去查询创建故事的进度。', + 'requestParamsDescription' => '### 故事类型'."\n" + ."\n" + .'- TimeMemory：时光故事'."\n" + ."\n" + .'- PeopleMemory：人物故事'."\n" + ."\n" + .'- TagMemory：标签故事'."\n" + ."\n" + .'- TravelMemory：旅行故事'."\n" + ."\n" + .'### 故事子类型'."\n" + ."\n" + .'TimeMemory：空'."\n" + ."\n" + .'PeopleMemory：'."\n" + ."\n" + .'- Solo：人物故事，单人故事。搜索数据集里人脸数目最多的人物，根据已做过的人脸聚类的结果生成人物故事，可支持通过时间参数StoryStartTime和StoryEndTime传入时间间隔，即在某段时间间隔内，照片数量最多的人物为候选人物，不会关注是否已有该人物的故事生成'."\n" + ."\n" + .'TagMemory：'."\n" + ."\n" + .'- Food：美食标签故事'."\n" + ."\n" + .'- Pet：宠物标签故事'."\n" + ."\n" + .'- PetDog：宠物狗标签故事'."\n" + ."\n" + .'- PetCat：宠物猫标签故事'."\n" + ."\n" + .'- Scenery：风景标签故事'."\n" + ."\n" + .'TravelMemory：空', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"user_items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"user_id\\": \\"\\",\\n \\"avatar\\": \\"\\",\\n \\"created_at\\": 0,\\n \\"updated_at\\": 0,\\n \\"email\\": \\"\\",\\n \\"nick_name\\": \\"\\",\\n \\"phone\\": \\"\\",\\n \\"role\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"user_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"default_drive_id\\": \\"\\",\\n \\"user_data\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"creator\\": \\"\\",\\n \\"punishments\\": [\\n {\\n \\"punish_flag\\": 0,\\n \\"starts_at\\": \\"\\",\\n \\"ends_at\\": \\"\\",\\n \\"impermanent\\": true\\n }\\n ],\\n \\"is_sync\\": true\\n }\\n ],\\n \\"group_items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"group_id\\": \\"\\",\\n \\"group_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"created_at\\": 0,\\n \\"updated_at\\": 0,\\n \\"creator\\": \\"\\",\\n \\"is_sync\\": true\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhM1\\"\\n}","type":"json"}]', - 'title' => '列举群组成员', ], 'CreateUser' => [ 'summary' => '创建用户。', 'path' => '/v2/user/create', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'tags' => [ - 'api', - ], + 'methods' => ['post'], + 'schemes' => ['https', 'http'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -8896,22 +3325,15 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -8921,24 +3343,8 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'user_id' => [ - 'title' => '用户id', - 'description' => '用户id，最长64字符，不能包含字符#', - 'type' => 'string', - 'required' => true, - 'example' => 'pdsuserid1', - 'maxLength' => 1024, - 'minLength' => 1, - ], - 'nick_name' => [ - 'title' => '用户昵称', - 'description' => '用户昵称，最长128字符', - 'type' => 'string', - 'required' => false, - 'example' => 'pdsuer', - 'maxLength' => 128, - 'minLength' => 0, - ], + 'user_id' => ['title' => '用户id', 'description' => '用户id，最长64字符，不能包含字符#', 'type' => 'string', 'required' => true, 'example' => 'pdsuserid1', 'maxLength' => 1024, 'minLength' => 1], + 'nick_name' => ['title' => '用户昵称', 'description' => '用户昵称，最长128字符', 'type' => 'string', 'required' => false, 'example' => 'pdsuer', 'maxLength' => 128, 'minLength' => 0], 'status' => [ 'title' => '用户状态', 'description' => '用户状态，默认为enabled'."\n" @@ -8950,10 +3356,7 @@ 'required' => false, 'example' => 'enabled', 'default' => 'enabled', - 'enum' => [ - 'enabled', - 'disabled', - ], + 'enum' => ['enabled', 'disabled'], ], 'role' => [ 'title' => '角色', @@ -8968,55 +3371,23 @@ .'如果当前domain支持subdomain。还可以支持 "subdomain\\_super_admin", "subdomain\\_admin”。', 'type' => 'string', 'required' => false, - 'enumValueTitles' => [ - 'subdomain_super_admin' => 'subdomain超级管理员', - 'subdomain_admin' => 'subdomain管理员', - 'superadmin' => '超级管理员', - 'admin' => '管理员', - 'user' => '普通用户', - ], + 'enumValueTitles' => ['subdomain_super_admin' => 'subdomain超级管理员', 'subdomain_admin' => 'subdomain管理员', 'superadmin' => '超级管理员', 'admin' => '管理员', 'user' => '普通用户'], 'example' => 'user', 'default' => 'user', - 'enum' => [ - 'user', - 'admin', - 'superadmin', - 'subdomain_admin', - 'subdomain_super_admin', - ], - ], - 'avatar' => [ - 'title' => '头像地址', - 'description' => '头像地址'."\n" - ."\n" - .'http形式时，以http:// 或https:// 作为前缀，参数长度最长4KB'."\n" - ."\n" - .'data形式时，以data://作为前缀，base64编码，参数长度最长300KB', - 'type' => 'string', - 'required' => false, - 'example' => 'http://a.b.c/pds.jpg', - ], - 'phone' => [ - 'title' => '电话', - 'description' => '电话', - 'type' => 'string', - 'required' => false, - 'example' => '13900001111', - ], - 'email' => [ - 'title' => '邮箱地址', - 'description' => '邮箱地址', - 'type' => 'string', - 'required' => false, - 'example' => '123@pds.com', - ], + 'enum' => ['user', 'admin', 'superadmin', 'subdomain_admin', 'subdomain_super_admin'], + ], + 'avatar' => ['title' => '头像地址', 'description' => '头像地址'."\n" + ."\n" + .'http形式时，以http:// 或https:// 作为前缀，参数长度最长4KB'."\n" + ."\n" + .'data形式时，以data://作为前缀，base64编码，参数长度最长300KB', 'type' => 'string', 'required' => false, 'example' => 'http://a.b.c/pds.jpg'], + 'phone' => ['title' => '电话', 'description' => '电话', 'type' => 'string', 'required' => false, 'example' => '13900001111'], + 'email' => ['title' => '邮箱地址', 'description' => '邮箱地址', 'type' => 'string', 'required' => false, 'example' => '123@pds.com'], 'user_data' => [ 'description' => '用户自定义数据，最长1024字符', 'type' => 'object', 'required' => false, - 'additionalProperties' => [ - 'type' => 'any', - ], + 'additionalProperties' => ['type' => 'any', 'description' => ''], 'example' => 'md', ], 'group_info_list' => [ @@ -9025,35 +3396,15 @@ 'items' => [ 'type' => 'object', 'properties' => [ - 'group_id' => [ - 'description' => '群组id', - 'type' => 'string', - 'required' => false, - 'example' => 'g123', - ], + 'group_id' => ['description' => '群组id', 'type' => 'string', 'required' => false, 'example' => 'g123'], ], 'required' => false, + 'description' => '', ], 'required' => false, ], - 'user_name' => [ - 'title' => '用户名', - 'description' => '用户名，最长128字符', - 'type' => 'string', - 'required' => false, - 'example' => 'pdsusername', - 'maxLength' => 128, - 'minLength' => 0, - ], - 'description' => [ - 'title' => '用户描述', - 'description' => '用户描述，最长1024字符', - 'type' => 'string', - 'required' => false, - 'example' => 'VIP用户', - 'maxLength' => 1024, - 'minLength' => 0, - ], + 'user_name' => ['title' => '用户名', 'description' => '用户名，最长128字符', 'type' => 'string', 'required' => false, 'example' => 'pdsusername', 'maxLength' => 128, 'minLength' => 0], + 'description' => ['title' => '用户描述', 'description' => '用户描述，最长1024字符', 'type' => 'string', 'required' => false, 'example' => 'VIP user', 'maxLength' => 1024, 'minLength' => 0], ], 'required' => false, ], @@ -9066,60 +3417,15 @@ 'description' => '返回信息', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'title' => '域id', - 'description' => '域id', - 'type' => 'string', - 'example' => 'bj1', - ], - 'user_id' => [ - 'title' => '用户id', - 'description' => '用户id', - 'type' => 'string', - 'example' => 'dingding_abc001', - ], - 'avatar' => [ - 'title' => '头像地址', - 'description' => '头像地址', - 'type' => 'string', - 'example' => 'http://aa.com/1.jpg', - ], - 'created_at' => [ - 'description' => '创建时间，格林威治时间1970年01月01日00时00分00秒起至现在的毫秒数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1639762579768', - ], - 'updated_at' => [ - 'description' => '修改时间，格林威治时间1970年01月01日00时00分00秒起至现在的毫秒数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1639762579768', - ], - 'nick_name' => [ - 'title' => '昵称', - 'description' => '昵称', - 'type' => 'string', - 'example' => '001', - ], - 'user_name' => [ - 'title' => '用户名', - 'description' => '用户名', - 'type' => 'string', - 'example' => 'pds', - ], - 'phone' => [ - 'title' => '电话', - 'description' => '电话', - 'type' => 'string', - 'example' => '13900001111', - ], - 'email' => [ - 'title' => '邮箱地址', - 'description' => '邮箱地址', - 'type' => 'string', - 'example' => 'a@a.com', - ], + 'domain_id' => ['title' => '域id', 'description' => '域id', 'type' => 'string', 'example' => 'bj1'], + 'user_id' => ['title' => '用户id', 'description' => '用户id', 'type' => 'string', 'example' => 'dingding_abc001'], + 'avatar' => ['title' => '头像地址', 'description' => '头像地址', 'type' => 'string', 'example' => 'http://aa.com/1.jpg'], + 'created_at' => ['description' => '创建时间，格林威治时间1970年01月01日00时00分00秒起至现在的毫秒数', 'type' => 'integer', 'format' => 'int64', 'example' => '1639762579768'], + 'updated_at' => ['description' => '修改时间，格林威治时间1970年01月01日00时00分00秒起至现在的毫秒数', 'type' => 'integer', 'format' => 'int64', 'example' => '1639762579768'], + 'nick_name' => ['title' => '昵称', 'description' => '昵称', 'type' => 'string', 'example' => '001'], + 'user_name' => ['title' => '用户名', 'description' => '用户名', 'type' => 'string', 'example' => 'pds'], + 'phone' => ['title' => '电话', 'description' => '电话', 'type' => 'string', 'example' => '13900001111'], + 'email' => ['title' => '邮箱地址', 'description' => '邮箱地址', 'type' => 'string', 'example' => 'a@a.com'], 'role' => [ 'title' => '角色', 'description' => '角色'."\n" @@ -9130,11 +3436,7 @@ ."\n" .'- user（普通用户）', 'type' => 'string', - 'enumValueTitles' => [ - 'superadmin' => '超级管理员', - 'admin' => '管理员', - 'user' => '普通用户', - ], + 'enumValueTitles' => ['superadmin' => '超级管理员', 'admin' => '管理员', 'user' => '普通用户'], 'example' => 'admin', ], 'status' => [ @@ -9145,83 +3447,47 @@ ."\n" .'- enabled（使能）', 'type' => 'string', - 'enumValueTitles' => [ - 'disabled' => '禁止', - 'enabled' => '使能', - ], + 'enumValueTitles' => ['disabled' => '禁止', 'enabled' => '使能'], 'example' => 'enabled', ], - 'description' => [ - 'title' => '描述', - 'description' => '描述', - 'type' => 'string', - 'example' => 'vipuser', - ], - 'default_drive_id' => [ - 'title' => '缺省空间id', - 'description' => '缺省空间id', - 'type' => 'string', - 'example' => '1', - ], + 'description' => ['title' => '描述', 'description' => '描述', 'type' => 'string', 'example' => 'vipuser'], + 'default_drive_id' => ['title' => '缺省空间id', 'description' => '缺省空间id', 'type' => 'string', 'example' => '1'], 'user_data' => [ 'description' => '用户自定义数据', 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'any', - 'example' => 'dog', - 'description' => '自定义项', - ], - ], - 'creator' => [ - 'title' => '创建者', - 'description' => '创建者', - 'type' => 'string', - 'example' => 'user1', + 'additionalProperties' => ['type' => 'any', 'example' => 'dog', 'description' => '自定义项'], ], + 'creator' => ['title' => '创建者', 'description' => '创建者', 'type' => 'string', 'example' => 'user1'], ], ], ], ], 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"user_id\\": \\"dingding_abc001\\",\\n \\"avatar\\": \\"http://aa.com/1.jpg\\",\\n \\"created_at\\": 1639762579768,\\n \\"updated_at\\": 1639762579768,\\n \\"nick_name\\": \\"001\\",\\n \\"user_name\\": \\"pds\\",\\n \\"phone\\": \\"13900001111\\",\\n \\"email\\": \\"a@a.com\\",\\n \\"role\\": \\"admin\\",\\n \\"status\\": \\"enabled\\",\\n \\"description\\": \\"vipuser\\",\\n \\"default_drive_id\\": \\"1\\",\\n \\"user_data\\": {\\n \\"key\\": \\"dog\\"\\n },\\n \\"creator\\": \\"user1\\"\\n}","type":"json"}]', 'title' => '创建用户', - ], - 'ImportUser' => [ - 'summary' => '导入用户。', - 'path' => '/v2/user/import', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'CsiGetFileInfo' => [ + 'path' => '/v2/csi/get_file_info', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], ], - [ - 'BearerToken' => [], - ], - ], - 'consumes' => [ - 'application/json', ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -9231,71 +3497,10 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'authentication_type' => [ - 'description' => '认证类型'."\n" - ."\n" - .'- mobile：手机号'."\n" - ."\n" - .'- email：邮箱'."\n" - ."\n" - .'- ding：钉钉'."\n" - ."\n" - .'- ram：阿里云RAM子账号'."\n" - ."\n" - .'- wechat：企业微信'."\n" - ."\n" - .'- ldap：LDAP账号'."\n" - ."\n" - .'- custom：自定义账号', - 'type' => 'string', - 'required' => true, - 'example' => 'mobile', - ], - 'identity' => [ - 'description' => '唯一身份标识', - 'type' => 'string', - 'required' => true, - 'example' => '130****', - ], - 'authentication_display_name' => [ - 'description' => '认证方式的显示名称', - 'type' => 'string', - 'required' => false, - 'example' => '10000', - ], - 'extra' => [ - 'description' => '额外信息'."\n" - ."\n" - .'authentication\\_type为mobile时，此字段为国家编号，不填默认86。', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - 'nick_name' => [ - 'description' => '昵称', - 'type' => 'string', - 'required' => true, - 'example' => 'pdsuer', - ], - 'auto_create_drive' => [ - 'description' => '自动创建空间', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], - 'drive_total_size' => [ - 'description' => '空间大小，不能小于-1，-1表示无限制', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '10240', - ], - 'parent_group_id' => [ - 'description' => '加入到的分组id', - 'type' => 'string', - 'required' => false, - 'example' => 'g12', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'url_expire_sec' => ['description' => '可选填下载链接过期时间，单位为秒，取值范围为：[10,14400] 秒。'."\n" + .'填写此字段时提供下载链接，默认不提供下载链接。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '14400', 'minimum' => '10', 'example' => '100'], ], 'required' => false, ], @@ -9304,54 +3509,41 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => '用户信息', - '$ref' => '#/components/schemas/User', + 'type' => 'object', + 'properties' => [ + 'investigation_info' => ['description' => '审核信息', '$ref' => '#/components/schemas/InvestigationInfo'], + 'url' => ['description' => '文件下载链接', 'type' => 'string', 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx'], + ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"user_id\\": \\"\\",\\n \\"avatar\\": \\"\\",\\n \\"created_at\\": 0,\\n \\"updated_at\\": 0,\\n \\"email\\": \\"\\",\\n \\"nick_name\\": \\"\\",\\n \\"phone\\": \\"\\",\\n \\"role\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"user_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"default_drive_id\\": \\"\\",\\n \\"user_data\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"creator\\": \\"\\",\\n \\"punishments\\": [\\n {\\n \\"punish_flag\\": 0,\\n \\"starts_at\\": \\"\\",\\n \\"ends_at\\": \\"\\",\\n \\"impermanent\\": true\\n }\\n ],\\n \\"is_sync\\": true\\n}","type":"json"}]', - 'title' => '导入用户', - ], - 'UpdateUser' => [ - 'summary' => '修改用户信息。', - 'path' => '/v2/user/update', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '获取文件内容安全详情', + 'summary' => '获取文件的内容安全详情。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"investigation_info\\": {\\n \\"status\\": 4,\\n \\"suggestion\\": \\"block\\",\\n \\"video_detail\\": {\\n \\"block_frames\\": [\\n {\\n \\"rate\\": 99.1,\\n \\"offset\\": 3,\\n \\"label\\": \\"porn\\"\\n }\\n ]\\n }\\n },\\n \\"url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\"\\n}","type":"json"}]', + ], + 'DeleteDomain' => [ + 'summary' => ' 删除 domain ', + 'path' => '/v2/domain/delete', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], + 'tags' => ['admin'], 'security' => [ [ 'AK' => [], ], - [ - 'BearerToken' => [], - ], - ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - ], + 'systemTags' => ['operationType' => 'delete', 'riskType' => 'high', 'chargeType' => 'free'], 'parameters' => [ [ - 'name' => 'domain_id', - 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], - ], - [ 'name' => 'body', 'in' => 'body', 'style' => 'json', @@ -9359,150 +3551,29 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'user_id' => [ - 'description' => '用户id，最长64字符，不能包含字符#', - 'type' => 'string', - 'required' => true, - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - 'maxLength' => 1024, - 'minLength' => 1, - ], - 'nick_name' => [ - 'description' => '用户昵称，最长128字符', - 'type' => 'string', - 'required' => false, - 'example' => 'pdsuer', - 'maxLength' => 128, - 'minLength' => 0, - ], - 'status' => [ - 'description' => '用户状态'."\n" - ."\n" - .'- disabled（禁止）'."\n" - ."\n" - .'- enabled（使能）', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'disabled' => '禁止', - 'enabled' => '使能', - ], - 'example' => 'enabled', - 'enum' => [ - 'enabled', - 'disabled', - ], - ], - 'role' => [ - 'description' => '角色'."\n" - ."\n" - .'- superadmin（超级管理员）'."\n" - ."\n" - .'- admin（管理员）'."\n" - ."\n" - .'- user（普通用户）', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'superadmin' => '超级管理员', - 'admin' => '管理员', - 'user' => '普通用户', - ], - 'example' => 'user', - 'enum' => [ - 'user', - 'admin', - 'superadmin', - 'subdomain_admin', - 'subdomain_super_admin', - ], - ], - 'avatar' => [ - 'description' => '头像地址'."\n" - ."\n" - .'http形式时，以http:// 或https:// 作为前缀，参数长度最长4KB'."\n" - ."\n" - .'data形式时，以data://作为前缀，base64编码，参数长度最长300KB', - 'type' => 'string', - 'required' => false, - 'example' => 'http://a.b.c/pds.jpg', - ], - 'description' => [ - 'description' => '描述信息，最长1024字符', - 'type' => 'string', - 'required' => false, - 'example' => 'vip用户', - 'maxLength' => 1024, - 'minLength' => 0, - ], - 'phone' => [ - 'description' => '手机号', - 'type' => 'string', - 'required' => false, - 'example' => '13900001111', - ], - 'email' => [ - 'description' => '邮箱', - 'type' => 'string', - 'required' => false, - 'example' => 'a@aliyunpds.com', - ], - 'user_data' => [ - 'description' => '用户自定义数据，最长1024字符', - 'type' => 'object', - 'required' => false, - 'additionalProperties' => [ - 'type' => 'string', - 'example' => 'test', - 'description' => '用户自定义数据', - ], - ], - 'group_info_list' => [ - 'description' => '群组信息列表', - 'type' => 'array', - 'items' => [ - 'description' => '群组信息', - 'type' => 'object', - 'properties' => [ - 'group_id' => [ - 'description' => '群组id', - 'type' => 'string', - 'required' => false, - 'example' => 'g123', - ], - ], - 'required' => false, - ], - 'required' => false, - ], + 'domain_id' => ['description' => 'domain id', 'type' => 'string', 'required' => false, 'example' => 'bj1'], ], 'required' => false, ], ], ], 'responses' => [ - 200 => [ - 'schema' => [ - 'description' => '用户信息', - '$ref' => '#/components/schemas/User', - ], - ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"user_id\\": \\"\\",\\n \\"avatar\\": \\"\\",\\n \\"created_at\\": 0,\\n \\"updated_at\\": 0,\\n \\"email\\": \\"\\",\\n \\"nick_name\\": \\"\\",\\n \\"phone\\": \\"\\",\\n \\"role\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"user_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"default_drive_id\\": \\"\\",\\n \\"user_data\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"creator\\": \\"\\",\\n \\"punishments\\": [\\n {\\n \\"punish_flag\\": 0,\\n \\"starts_at\\": \\"\\",\\n \\"ends_at\\": \\"\\",\\n \\"impermanent\\": true\\n }\\n ],\\n \\"is_sync\\": true\\n}","type":"json"}]', - 'title' => '修改用户信息', - ], - 'GetUser' => [ - 'summary' => '获取用户信息。', - 'path' => '/v2/user/get', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', + 204 => [], ], - 'tags' => [ - 'api', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '删除Domain', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', + ], + 'DeleteDrive' => [ + 'summary' => '删除空间。', + 'path' => '/v2/drive/delete', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -9511,21 +3582,15 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, + 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -9535,41 +3600,35 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'user_id' => [ - 'description' => '用户id。'."\n" - .'使用AK方式访问时，该项必传；使用AccessToken方式访问时，该项不填写，取自己的用户信息。', - 'type' => 'string', - 'required' => false, - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - ], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1'], ], 'required' => false, ], ], ], 'responses' => [ - 200 => [ + 204 => [ 'schema' => [ - 'description' => '用户信息', - '$ref' => '#/components/schemas/User', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"user_id\\": \\"\\",\\n \\"avatar\\": \\"\\",\\n \\"created_at\\": 0,\\n \\"updated_at\\": 0,\\n \\"email\\": \\"\\",\\n \\"nick_name\\": \\"\\",\\n \\"phone\\": \\"\\",\\n \\"role\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"user_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"default_drive_id\\": \\"\\",\\n \\"user_data\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"creator\\": \\"\\",\\n \\"punishments\\": [\\n {\\n \\"punish_flag\\": 0,\\n \\"starts_at\\": \\"\\",\\n \\"ends_at\\": \\"\\",\\n \\"impermanent\\": true\\n }\\n ],\\n \\"is_sync\\": true\\n}","type":"json"}]', - 'title' => '获取用户信息', - ], - 'ListUser' => [ - 'summary' => '列举用户。', - 'path' => '/v2/user/list', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '删除空间', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', + ], + 'DeleteFile' => [ + 'summary' => '删除文件或文件夹。', + 'path' => '/v2/file/delete', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -9578,21 +3637,16 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, + 'systemTags' => ['operationType' => 'delete', 'riskType' => 'high', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -9602,20 +3656,8 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'limit' => [ - 'description' => '查询数量，取值范围：1~100。默认值100', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '100', - ], + 'drive_id' => ['title' => 'drive id 如果要删除drive下的文件时，drive_id时必需的参数', 'description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1', 'pattern' => '^[0-9]*$'], + 'file_id' => ['title' => 'file_id是文件的唯一标识，删除文件或者目录时必须指定file_id', 'description' => '文件或文件夹id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], ], 'required' => false, ], @@ -9624,43 +3666,30 @@ 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'next_marker' => [ - 'title' => 'Id of the request', - 'description' => '下一页起始资源标识符, 最后一页该值为空', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'items' => [ - 'description' => '用户信息列表', - 'type' => 'array', - 'items' => [ - 'description' => '用户信息', - '$ref' => '#/components/schemas/User', - ], - ], + 'domain_id' => ['description' => '域id', 'type' => 'string', 'example' => 'bj1'], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'example' => '1'], + 'file_id' => ['description' => '文件id', 'type' => 'string', 'example' => '9520943DC264'], + 'async_task_id' => ['description' => '异步任务id，只有异步处理的场景才会返回。后续可以调用 [GetAsyncTask](~~440456~~)，传递异步任务 id，获取任务信息。', 'type' => 'string', 'example' => '000e89fb-cf8f-11e9-8ab4-b6e980803a3b'], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\",\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"user_id\\": \\"\\",\\n \\"avatar\\": \\"\\",\\n \\"created_at\\": 0,\\n \\"updated_at\\": 0,\\n \\"email\\": \\"\\",\\n \\"nick_name\\": \\"\\",\\n \\"phone\\": \\"\\",\\n \\"role\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"user_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"default_drive_id\\": \\"\\",\\n \\"user_data\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"creator\\": \\"\\",\\n \\"punishments\\": [\\n {\\n \\"punish_flag\\": 0,\\n \\"starts_at\\": \\"\\",\\n \\"ends_at\\": \\"\\",\\n \\"impermanent\\": true\\n }\\n ],\\n \\"is_sync\\": true\\n }\\n ]\\n}","type":"json"}]', - 'title' => '列举用户', - ], - 'SearchUser' => [ - 'summary' => '搜索用户。', - 'path' => '/v2/user/search', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '删除文件或文件夹', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"9520943DC264\\",\\n \\"async_task_id\\": \\"000e89fb-cf8f-11e9-8ab4-b6e980803a3b\\"\\n}","type":"json"}]', + ], + 'DeleteGroup' => [ + 'summary' => '删除群组接口， 在删除群组前，需保证群组下没有其他群组或用户，否则会导致删除失败。', + 'path' => '/v2/group/delete', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'BearerToken' => [], @@ -9669,162 +3698,53 @@ 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'read', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求body', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'nick_name' => [ - 'description' => '用户昵称，最长128字符', - 'type' => 'string', - 'required' => false, - 'example' => 'pdsuer', - 'maxLength' => 128, - 'minLength' => 0, - ], - 'nick_name_for_fuzzy' => [ - 'description' => '昵称-模糊搜索，最长128字符', - 'type' => 'string', - 'required' => false, - 'example' => 'la', - 'maxLength' => 128, - 'minLength' => 0, - ], - 'user_name' => [ - 'description' => '用户名称，最长128字符', - 'type' => 'string', - 'required' => false, - 'example' => 'pds', - 'maxLength' => 128, - 'minLength' => 0, - ], - 'phone' => [ - 'description' => '手机号', - 'type' => 'string', - 'required' => false, - 'example' => '13900001111', - ], - 'email' => [ - 'description' => '邮箱地址', - 'type' => 'string', - 'required' => false, - 'example' => '123@pds.com', - ], - 'status' => [ - 'description' => '用户状态'."\n" - ."\n" - .'- disabled（禁止）'."\n" - ."\n" - .'- enabled（使能）', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'disabled' => '禁止', - 'enabled' => '使能', - ], - 'example' => 'enabled', - ], - 'role' => [ - 'description' => '角色'."\n" - ."\n" - .'- superadmin（超级管理员）'."\n" - ."\n" - .'- admin（管理员）'."\n" - ."\n" - .'- user（用户）', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'superadmin' => '超级管理员', - 'admin' => '管理员', - 'user' => '用户', - ], - 'example' => 'user', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'<br>默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'limit' => [ - 'description' => '限定此次返回资源的数量，取值范围为[1,100]，默认返回100', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '100', - ], + 'group_id' => ['description' => '待删除的群组ID', 'type' => 'string', 'required' => true, 'example' => 'g123'], ], 'required' => false, ], ], ], 'responses' => [ - 200 => [ + 204 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', - 'properties' => [ - 'next_marker' => [ - 'title' => 'Id of the request', - 'description' => '下一页起始资源标识符, 最后一页该值为空', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'items' => [ - 'description' => '用户信息列表', - 'type' => 'array', - 'items' => [ - 'description' => '用户信息', - '$ref' => '#/components/schemas/User', - ], - ], - ], + 'properties' => [], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\",\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"user_id\\": \\"\\",\\n \\"avatar\\": \\"\\",\\n \\"created_at\\": 0,\\n \\"updated_at\\": 0,\\n \\"email\\": \\"\\",\\n \\"nick_name\\": \\"\\",\\n \\"phone\\": \\"\\",\\n \\"role\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"user_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"default_drive_id\\": \\"\\",\\n \\"user_data\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"creator\\": \\"\\",\\n \\"punishments\\": [\\n {\\n \\"punish_flag\\": 0,\\n \\"starts_at\\": \\"\\",\\n \\"ends_at\\": \\"\\",\\n \\"impermanent\\": true\\n }\\n ],\\n \\"is_sync\\": true\\n }\\n ]\\n}","type":"json"}]', - 'title' => '搜索用户', - ], - 'DeleteUser' => [ - 'summary' => '删除用户。', - 'path' => '/v2/user/delete', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '删除群组', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', + ], + 'DeleteRevision' => [ + 'summary' => '删除历史版本，不支持删除最新版本。', + 'path' => '/v2/file/revision/delete', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -9833,21 +3753,14 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['title' => 'A short description of struct', 'description' => 'A short description of struct', 'type' => 'string', 'required' => true], ], [ 'name' => 'body', @@ -9857,20 +3770,16 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'user_id' => [ - 'description' => '用户id', - 'type' => 'string', - 'required' => true, - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'revision_id' => ['description' => '版本 id', 'type' => 'string', 'required' => true, 'example' => '40CB7794C929'], ], - 'required' => true, + 'required' => false, ], ], ], 'responses' => [ 204 => [ - 'headers' => [], 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', @@ -9879,22 +3788,19 @@ ], ], ], + 'title' => '删除历史版本', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '删除用户', ], - 'CreateDrive' => [ - 'summary' => '创建空间。', - 'path' => '/v2/drive/create', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'tags' => [ - 'api', - ], + 'DeleteStory' => [ + 'summary' => '删除指定故事。', + 'path' => '/v2/image/delete_story', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -9903,116 +3809,27 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - ], + 'systemTags' => ['operationType' => 'delete', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体。', + 'description' => '请求数据', 'type' => 'object', 'properties' => [ - 'drive_name' => [ - 'description' => '空间名称，最长 128 字符', - 'type' => 'string', - 'required' => true, - 'example' => '我的个人空间', - 'maxLength' => 1024, - 'minLength' => 1, - ], - 'owner' => [ - 'description' => '归属者ID', - 'type' => 'string', - 'required' => true, - 'example' => '3b3d7245c159488da17d081ad6c64687', - ], - 'owner_type' => [ - 'description' => '归属者类型，可选值如下：'."\n" - ."\n" - .'user：用户'."\n" - .'group：团队', - 'type' => 'string', - 'required' => true, - 'enumValueTitles' => [ - 'user' => 'user', - 'group' => 'group', - ], - 'example' => 'user', - 'enum' => [ - 'user', - 'group', - ], - ], - 'description' => [ - 'description' => '描述信息，最长 1024 字符', - 'type' => 'string', - 'required' => false, - 'example' => 'vip空间', - 'maxLength' => 1024, - ], - 'drive_type' => [ - 'description' => '空间类型，当前只支持 normal', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'normal' => 'normal', - ], - 'example' => 'normal', - 'default' => 'normal', - 'enum' => [], - ], - 'status' => [ - 'description' => '状态，可选值如下：'."\n" - ."\n" - .'enabled：可用'."\n" - .'disabled：禁用'."\n" - ."\n" - .'默认为 enabled', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'disabled' => 'disabled', - 'enabled' => 'enabled', - ], - 'example' => 'enabled', - 'default' => 'enabled', - 'enum' => [ - 'enabled', - 'disabled', - ], - ], - 'total_size' => [ - 'description' => '总大小，单位为字节，默认不限大小', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1024', - ], - 'default' => [ - 'description' => '是否是默认空间，默认为 false', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - 'default' => 'false', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'story_id' => ['description' => '故事 id', 'type' => 'string', 'required' => true, 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003'], ], 'required' => false, ], @@ -10022,204 +3839,30 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回信息', - 'type' => 'object', - 'properties' => [ - 'domain_id' => [ - 'title' => 'Id of the request', - 'description' => '域id', - 'type' => 'string', - 'example' => 'bj1', - ], - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'example' => '1', - ], - 'drive_name' => [ - 'description' => '空间名称', - 'type' => 'string', - 'example' => '我的个人空间'."\n", - ], - 'description' => [ - 'description' => '描述信息', - 'type' => 'string', - 'example' => 'vip空间'."\n", - ], - 'owner' => [ - 'description' => '归属者ID', - 'type' => 'string', - 'example' => '3b3d7245c159488da17d081ad6c64687'."\n", - ], - 'owner_type' => [ - 'description' => '归属者类型', - 'type' => 'string', - 'example' => 'user', - ], - 'drive_type' => [ - 'description' => '空间类型', - 'type' => 'string', - 'example' => 'normal', - ], - 'used_size' => [ - 'description' => '使用空间大小，单位为字节', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1024', - ], - 'total_size' => [ - 'description' => '总空间大小，单位为字节', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1024', - ], - 'creator' => [ - 'description' => '创建者ID。', - 'type' => 'string', - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - ], - 'created_at' => [ - 'description' => '创建时间', - 'type' => 'string', - 'example' => '2024-08-14T03:14:28.109Z', - ], - 'status' => [ - 'description' => '状态', - 'type' => 'string', - 'example' => 'enabled', - ], - ], - ], - ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"drive_name\\": \\"我的个人空间\\\\n\\",\\n \\"description\\": \\"vip空间\\\\n\\",\\n \\"owner\\": \\"3b3d7245c159488da17d081ad6c64687\\\\n\\",\\n \\"owner_type\\": \\"user\\",\\n \\"drive_type\\": \\"normal\\",\\n \\"used_size\\": 1024,\\n \\"total_size\\": 1024,\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"created_at\\": \\"2024-08-14T03:14:28.109Z\\",\\n \\"status\\": \\"enabled\\"\\n}","type":"json"}]', - 'title' => '创建空间', - 'description' => '创建空间前确保操作对应用户/团队未被分配空间。', - ], - 'UpdateDrive' => [ - 'summary' => '修改空间信息。', - 'path' => '/v2/drive/update', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], - 'security' => [ - [ - 'AK' => [], - ], - [ - 'BearerToken' => [], - ], - ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'deprecated' => false, - 'systemTags' => [], - 'parameters' => [ - [ - 'name' => 'domain_id', - 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], - ], - [ - 'name' => 'body', - 'in' => 'body', - 'style' => 'json', - 'schema' => [ - 'description' => '请求体', + 'description' => '返回参数', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'drive_name' => [ - 'description' => '空间名称，最长 128 字符', - 'type' => 'string', - 'required' => false, - 'example' => '我的个人空间', - 'maxLength' => 128, - ], - 'description' => [ - 'description' => '描述，最长 1024 字符', - 'type' => 'string', - 'required' => false, - 'example' => 'vip空间', - 'maxLength' => 1024, - ], - 'status' => [ - 'description' => '空间状态，可选值如下：'."\n" - ."\n" - .'enabled：可用'."\n" - .'disabled：禁用', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'disabled' => '禁止', - 'enabled' => '使能', - ], - 'example' => 'enabled', - 'enum' => [ - 'enabled', - 'disabled', - ], - ], - 'total_size' => [ - 'description' => '总大小，单位为字节，不限制大小时填 -1', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '10240', - ], - 'owner' => [ - 'description' => '归属者'."\n" - .'注意，当前只允许通过 ak 来修改个人 drive 的所有者。', - 'type' => 'string', - 'required' => false, - 'example' => 'user1', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'example' => '1'], ], - 'required' => false, ], ], ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'description' => 'Schema of Response', - '$ref' => '#/components/schemas/Drive', - ], - ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '删除故事', + 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" + ."\n" + .'使用此功能须开通增值服务图片处理功能。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"drive_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"owner\\": \\"\\",\\n \\"owner_type\\": \\"\\",\\n \\"drive_type\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"used_size\\": 0,\\n \\"total_size\\": 0,\\n \\"created_at\\": \\"\\",\\n \\"creator\\": \\"\\"\\n}","type":"json"}]', - 'title' => '修改空间信息', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"drive_id\\": \\"1\\"\\n}","type":"json"}]', ], - 'GetDrive' => [ - 'summary' => '获取空间信息。', - 'path' => '/v2/drive/get', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'DeleteUser' => [ + 'path' => '/v2/user/delete', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -10228,21 +3871,14 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -10252,63 +3888,49 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], + 'user_id' => ['description' => '用户id', 'type' => 'string', 'required' => true, 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4'], ], - 'required' => false, + 'required' => true, ], ], ], 'responses' => [ - 200 => [ + 204 => [ + 'headers' => [], 'schema' => [ + 'title' => 'Schema of Response', 'description' => 'Schema of Response', - '$ref' => '#/components/schemas/Drive', + 'type' => 'object', + 'properties' => [], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"drive_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"owner\\": \\"\\",\\n \\"owner_type\\": \\"\\",\\n \\"drive_type\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"used_size\\": 0,\\n \\"total_size\\": 0,\\n \\"created_at\\": \\"\\",\\n \\"creator\\": \\"\\"\\n}","type":"json"}]', - 'title' => '获取空间信息', - ], - 'ListDrive' => [ - 'summary' => '列举空间。', - 'path' => '/v2/drive/list', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '删除用户', + 'summary' => '删除用户。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', + ], + 'DeltaGetLastCursor' => [ + 'path' => '/v2/file/get_last_cursor', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], - ], - [ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -10318,45 +3940,8 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'limit' => [ - 'description' => '限定此次返回资源的数量，范围为 [1,100]，默认返回100', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '0', - 'exclusiveMinimum' => true, - 'example' => '100', - 'default' => '100', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'owner' => [ - 'description' => '归属者，不设置时返回所有 drive', - 'type' => 'string', - 'required' => false, - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - ], - 'owner_type' => [ - 'description' => '归属者类型，可选值如下：'."\n" - ."\n" - .'user：用户'."\n" - .'group：团队'."\n" - ."\n" - .'默认返回所有归属者类型的 drive', - 'type' => 'string', - 'required' => false, - 'example' => 'user', - 'enum' => [ - 'user', - 'group', - ], - ], + 'drive_id' => ['title' => '云端 drive id', 'description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'sync_root_id' => ['title' => '同步目录的对应的云端跟目录', 'description' => '同步文件夹根节点文件id', 'type' => 'string', 'required' => false, 'example' => '622fb09598ae66777c7040109a16f49381f6abe1'], ], 'required' => false, ], @@ -10369,38 +3954,24 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'items' => [ - 'description' => '空间信息列表', - 'type' => 'array', - 'items' => [ - 'description' => '空间信息', - '$ref' => '#/components/schemas/Drive', - ], - ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空。', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], + 'cursor' => ['title' => '当前增量变化的最新游标', 'description' => '指定drive或者指定同步目录下增量信息的最新游标', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"drive_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"owner\\": \\"\\",\\n \\"owner_type\\": \\"\\",\\n \\"drive_type\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"used_size\\": 0,\\n \\"total_size\\": 0,\\n \\"created_at\\": \\"\\",\\n \\"creator\\": \\"\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', - 'title' => '列举空间', - ], - 'GetDefaultDrive' => [ - 'summary' => '获取指定用户的缺省空间。', - 'path' => '/v2/drive/get_default_drive', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '获取增量操作游标', + 'summary' => '获取增量操作游标。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"cursor\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', + ], + 'DownloadFile' => [ + 'path' => '/v2/file/download', + 'methods' => ['get'], + 'schemes' => ['http', 'https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -10409,179 +3980,88 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/x-www-form-urlencoded'], + 'produces' => ['application/octet-stream'], 'deprecated' => false, + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ - 'name' => 'body', - 'in' => 'body', - 'style' => 'json', - 'schema' => [ - 'description' => '请求体参数。', - 'type' => 'object', - 'properties' => [ - 'user_id' => [ - 'description' => '用户 id，AK 访问时必填，AccessToken 访问时可选（默认取 AccessToken 关联的用户 id）', - 'type' => 'string', - 'required' => false, - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - ], - ], - 'required' => false, - ], + 'name' => 'share_id', + 'in' => 'query', + 'schema' => ['description' => '分享id。 如果通过分享操作文件，请携带`x-share-token header`鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。 `share_id`和`drive_id`两者必须有一个字段赋值。', 'type' => 'string', 'required' => false, 'example' => '7JQX1FswpQ8'], ], - ], - 'responses' => [ - 200 => [ - 'schema' => [ - 'description' => 'Schema of Response', - '$ref' => '#/components/schemas/Drive', - ], + [ + 'name' => 'drive_id', + 'in' => 'query', + 'schema' => ['description' => '空间id', 'type' => 'string', 'required' => false, 'example' => '1'], ], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"drive_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"owner\\": \\"\\",\\n \\"owner_type\\": \\"\\",\\n \\"drive_type\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"used_size\\": 0,\\n \\"total_size\\": 0,\\n \\"created_at\\": \\"\\",\\n \\"creator\\": \\"\\"\\n}","type":"json"}]', - 'title' => '获取缺省空间', - ], - 'ListMyDrives' => [ - 'summary' => '列举登录用户自己的空间列表。', - 'path' => '/v2/drive/list_my_drives', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'security' => [ [ - 'AK' => [], + 'name' => 'file_id', + 'in' => 'query', + 'schema' => ['description' => '文件id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], ], [ - 'BearerToken' => [], + 'name' => 'image_thumbnail_process', + 'in' => 'query', + 'schema' => ['description' => '图片处理样式，设置后会跳转至处理后的缩略图地址', 'type' => 'string', 'required' => false, 'example' => 'image/resize,m_fill,h_128,w_128,limit_0'], ], - ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'deprecated' => false, - 'parameters' => [ [ - 'name' => 'domain_id', - 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'name' => 'video_thumbnail_process', + 'in' => 'query', + 'schema' => ['description' => '视频处理样式，设置后会跳转至处理后的缩略图地址', 'type' => 'string', 'required' => false, 'example' => 'video/snapshot,t_7000,f_jpg,w_800,h_600,m_fast'], ], [ - 'name' => 'body', - 'in' => 'body', - 'style' => 'json', - 'schema' => [ - 'description' => '请求体参数。', - 'type' => 'object', - 'properties' => [ - 'limit' => [ - 'description' => '限制返回的数量。默认为100，取值范围：1~100。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '0', - 'exclusiveMinimum' => true, - 'example' => '100', - 'default' => '100', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'."\n", - ], - ], - 'required' => false, - ], + 'name' => 'office_thumbnail_process', + 'in' => 'query', + 'schema' => ['description' => '文档处理样式，设置后会跳转至处理后的缩略图地址', 'type' => 'string', 'required' => false, 'example' => 'image/resize,m_lfit,w_256,limit_0/format,jpg|image/format,webp'], ], ], 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'items' => [ - 'description' => '空间信息列表', - 'type' => 'array', - 'items' => [ - 'description' => '空间信息', - '$ref' => '#/components/schemas/Drive', - ], - ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空。', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], + 302 => [ + 'headers' => [ + 'location' => [ + 'schema' => ['title' => '下载地址', 'type' => 'string'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"drive_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"owner\\": \\"\\",\\n \\"owner_type\\": \\"\\",\\n \\"drive_type\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"used_size\\": 0,\\n \\"total_size\\": 0,\\n \\"created_at\\": \\"\\",\\n \\"creator\\": \\"\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', - 'title' => '列举我的空间', - ], - 'SearchDrive' => [ - 'summary' => '搜索空间。', - 'path' => '/v2/drive/search', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '下载文件', + 'summary' => '下载文件。', + 'description' => '<props="china">最佳实践可参考：[文件下载](~~175889~~)。</props>', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', + ], + 'FileAddPermission' => [ + 'summary' => '文件夹授权。单Drive下最多可支持1000条授权记录，超出后授权不生效。', + 'path' => '/v2/file/add_permission', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], + 'BearerToken' => [], ], [ - 'BearerToken' => [], + 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -10591,48 +4071,13 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_name' => [ - 'description' => '空间名称', - 'type' => 'string', - 'required' => false, - 'example' => '我的个人空间', - ], - 'limit' => [ - 'description' => '异步调用的返回个数。默认返回100个，取值范围\\[1,100]。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '0', - 'exclusiveMinimum' => true, - 'example' => '100', - 'default' => '100', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'<br>默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'owner' => [ - 'description' => '归属者', - 'type' => 'string', - 'required' => false, - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - ], - 'owner_type' => [ - 'description' => '归属者类型，可选值如下：'."\n" - ."\n" - .'user：用户'."\n" - .'group：团队', - 'type' => 'string', - 'required' => false, - 'example' => 'user', - 'enum' => [ - 'user', - 'group', - ], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件夹id， 当授权整个团队空间时，此字段填root。 个人空间共享不支持填root', 'type' => 'string', 'required' => true, 'example' => '4221bf6e6ab43c255edc4463bf3a6f5f5d317406'], + 'member_list' => [ + 'description' => '被授权的成员列表', + 'type' => 'array', + 'items' => ['description' => '授权信息', 'required' => false, '$ref' => '#/components/schemas/FilePermissionMember'], + 'required' => true, ], ], 'required' => false, @@ -10640,68 +4085,40 @@ ], ], 'responses' => [ - 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'items' => [ - 'description' => '空间信息列表', - 'type' => 'array', - 'items' => [ - 'description' => '空间信息', - '$ref' => '#/components/schemas/Drive', - ], - ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空。', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - ], - ], + 204 => [ + 'headers' => [], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"drive_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"owner\\": \\"\\",\\n \\"owner_type\\": \\"\\",\\n \\"drive_type\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"used_size\\": 0,\\n \\"total_size\\": 0,\\n \\"created_at\\": \\"\\",\\n \\"creator\\": \\"\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', - 'title' => '搜索空间', - ], - 'DeleteDrive' => [ - 'summary' => '删除空间。', - 'path' => '/v2/drive/delete', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '文件共享授权给用户或组', + 'description' => '单Drive下最多可支持1000条授权记录，超出后授权不生效。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', + ], + 'FileDeleteUserTags' => [ + 'path' => '/v2/file/delete_usertags', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], + 'BearerToken' => [], ], [ - 'BearerToken' => [], + 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -10711,11 +4128,17 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'key_list' => [ + 'description' => '待删除的标签列表。'."\n" + .'数组不能为空，且数量上限为 1000。', + 'type' => 'array', + 'items' => ['description' => '标签名。'."\n" + .'不能带有 # 字符。', 'type' => 'string', 'required' => true, 'example' => 'tag', 'pattern' => '^[^#]+$'], 'required' => true, - 'example' => '1', + 'maxItems' => 1000, + 'minItems' => 1, ], ], 'required' => false, @@ -10723,56 +4146,39 @@ ], ], 'responses' => [ - 204 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [], - ], - ], + 204 => [], + ], + 'title' => '删除文件自定义标签', + 'summary' => '删除文件自定义标签。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '删除空间', ], - 'CreateFile' => [ - 'summary' => '创建文件或文件夹。', - 'path' => '/v2/file/create', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'FileListPermission' => [ + 'summary' => '列举文件的共享或授权记录。', + 'path' => '/v2/file/list_permission', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], + 'BearerToken' => [], ], [ - 'BearerToken' => [], + 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - ], + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -10782,238 +4188,8 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'name' => [ - 'title' => '文件或文件夹名称', - 'description' => '文件名称，按照 utf8 编码最长 1024 字节，不能包含 /', - 'type' => 'string', - 'required' => true, - 'example' => 'a.txt', - 'maxLength' => 1024, - 'minLength' => 1, - ], - 'type' => [ - 'title' => '类型', - 'description' => '文件类型，可选值如下：'."\n" - ."\n" - .'file：文件'."\n" - .'folder：文件夹', - 'type' => 'string', - 'required' => true, - 'example' => 'file', - 'enum' => [ - 'file', - 'folder', - ], - ], - 'parent_file_id' => [ - 'title' => '父文件夹id', - 'description' => '父目录id，上传到根目录时填写 root', - 'type' => 'string', - 'required' => true, - 'example' => 'fileid1', - ], - 'drive_id' => [ - 'title' => '用户空间id', - 'description' => '空间 id，除通过分享链接上传之外，必填', - 'type' => 'string', - 'required' => false, - 'example' => '1', - 'pattern' => '^[0-9]*$', - ], - 'share_id' => [ - 'title' => '共享id', - 'description' => '分享 id，当通过分享链接上传时必填', - 'type' => 'string', - 'required' => false, - 'example' => '7JQX1FswpQ8', - ], - 'size' => [ - 'title' => '文件大小', - 'description' => '文件大小，单位为 byte。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1024', - ], - 'content_type' => [ - 'title' => '文件类型', - 'description' => '文件内容类型，默认值 application/oct-stream<props="china">，常见的 content_type 可以参考 OSS [《如何设置Content-Type（MIME）？》](https://help.aliyun.com/document_detail/39522.htm?spm=a2c4g.11186623.0.0.5a0b7dbb1TPnWF#concept-5041)。</props>', - 'type' => 'string', - 'required' => false, - 'example' => 'application/json', - ], - 'part_info_list' => [ - 'description' => '分片信息列表，最多 10000 个分片，当不填时，默认返回 1 个分片', - 'type' => 'array', - 'items' => [ - 'description' => '分片信息', - 'type' => 'object', - 'properties' => [ - 'part_number' => [ - 'description' => '分片序列号，从 1 开始', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], - 'parallel_sha1_ctx' => [ - 'description' => '该分片前所有数据的SHA1上下文，该字段只在多分片并发上传的模式下有效', - 'type' => 'object', - 'properties' => [ - 'h' => [ - 'description' => '该分片前所有数据的SHA1上下文的第1-5个32位变量，该字段只在多分片并发上传的模式下有效', - 'type' => 'array', - 'items' => [ - 'description' => '该分片前所有数据的SHA1上下文的第1-5个32位变量', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - ], - 'required' => false, - ], - 'part_offset' => [ - 'description' => '到上一个数据块为止的总长度，字节，需要为64的倍数，该字段只在多分片并发上传的模式下有效', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '10240', - ], - ], - 'required' => false, - ], - 'content_md5' => [ - 'description' => '分片的 MD5, 需要在上传分片时校验分片的MD5时填写。', - 'type' => 'string', - 'deprecated' => false, - 'required' => false, - 'example' => 'ASKJDJSKDJJSJDJS', - ], - ], - 'required' => false, - ], - 'required' => false, - ], - 'user_tags' => [ - 'title' => '用户打标', - 'description' => '用户自定义 tag，最多 1000 个 tag', - 'type' => 'array', - 'items' => [ - 'description' => '用户自定义 tag', - 'required' => false, - '$ref' => '#/components/schemas/UserTag', - ], - 'required' => false, - ], - 'hidden' => [ - 'description' => '是否隐藏，默认不隐藏', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - 'default' => 'false', - ], - 'description' => [ - 'title' => '描述信息', - 'description' => '文件描述信息，最长 1024 字符，默认为空', - 'type' => 'string', - 'required' => false, - 'example' => '团队文件', - 'maxLength' => 1024, - ], - 'content_hash' => [ - 'title' => '内容hash', - 'description' => '文件内容 hash 值，需要根据 content_hash_name 指定的算法计算', - 'type' => 'string', - 'required' => false, - 'example' => '7C4A8D09CA3762AF61E59520943DC26494F8941B', - ], - 'content_hash_name' => [ - 'title' => '内容hash算法名', - 'description' => '文件内容hash算法名，当前只支持 sha1', - 'type' => 'string', - 'required' => false, - 'example' => 'sha1', - 'enum' => [ - 'sha1', - ], - ], - 'pre_hash' => [ - 'description' => '使用预秒传功能时填写，为文件前1KB sha1值，当远端没有匹配上时，客户端无需再计算文件完整 sha1 去尝试秒传。', - 'type' => 'string', - 'required' => false, - 'example' => '7C4A8D09CA3762AF61E59520943DC26494F89411', - ], - 'check_name_mode' => [ - 'title' => '重命名模式', - 'description' => '同名文件处理模式，可选值如下：'."\n" - ."\n" - .'ignore：允许同名文件；'."\n" - ."\n" - .'auto_rename：当发现同名文件是，云端自动重命名，默认为追加当前时间点，如 xxx _20060102_150405；'."\n" - ."\n" - .'refuse：当云端存在同名文件时，拒绝创建新文件，返回客户端已存在同名文件的详细信息。'."\n" - ."\n" - .'默认为 ignore', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'refuse' => 'refuse', - 'auto_rename' => 'auto_rename', - 'ignore' => 'ignore', - ], - 'example' => 'ignore', - 'enum' => [ - 'ignore', - 'auto_rename', - 'refuse', - ], - ], - 'file_id' => [ - 'title' => '文件id', - 'description' => '文件id，覆盖写时必填', - 'type' => 'string', - 'required' => false, - 'example' => '9520943DC264', - ], - 'local_created_at' => [ - 'title' => '文件本地创建时间', - 'description' => '文件本地创建时间，默认为空，格式为：yyyy-MM-ddTHH:mm:ssZ，采用 UTC +0 时区', - 'type' => 'string', - 'required' => false, - 'example' => '2023-10-04T14:30:00Z', - ], - 'local_modified_at' => [ - 'title' => '本地文件修改时间', - 'description' => '文件本地修改时间，默认为空，格式为：yyyy-MM-ddTHH:mm:ssZ，采用 UTC +0 时区', - 'type' => 'string', - 'required' => false, - 'example' => '2023-10-04T14:30:00Z', - ], - 'image_media_metadata' => [ - 'description' => '客户端指定的图片信息', - 'required' => false, - '$ref' => '#/components/schemas/ImageMediaMetadata', - ], - 'video_media_metadata' => [ - 'description' => '客户端指定的视频信息', - 'required' => false, - '$ref' => '#/components/schemas/VideoMediaMetadata', - ], - 'parallel_upload' => [ - 'description' => '是否开启并行上传分片功能', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - 'default' => 'false', - ], - 'custom_updated_at' => [ - 'type' => 'string', - 'required' => false, - ], - 'custom_created_at' => [ - 'type' => 'string', - 'required' => false, - ], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件id', 'type' => 'string', 'required' => true, 'example' => '4221bf6e6ab43a255edc4463bffa6f5f5d317401'], ], 'required' => false, ], @@ -11022,129 +4198,44 @@ 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回信息', - 'type' => 'object', - 'properties' => [ - 'parent_file_id' => [ - 'title' => '父目录文件id', - 'description' => '父目录id', - 'type' => 'string', - 'example' => 'fileid5', - ], - 'part_info_list' => [ - 'title' => '分段信息', - 'description' => '分段信息列表', - 'type' => 'array', - 'items' => [ - 'description' => '分段信息', - '$ref' => '#/components/schemas/UploadPartInfo', - ], - ], - 'upload_id' => [ - 'title' => '上传id', - 'description' => '上传id', - 'type' => 'string', - 'example' => 'uploadid1', - ], - 'rapid_upload' => [ - 'title' => '是否已经秒传', - 'description' => '是否已经秒传', - 'type' => 'boolean', - 'example' => 'true', - ], - 'type' => [ - 'description' => '文件类型', - 'type' => 'string', - 'example' => 'file', - ], - 'file_id' => [ - 'title' => '文件id', - 'description' => '文件id', - 'type' => 'string', - 'example' => 'fileid1', - ], - 'domain_id' => [ - 'title' => '域id', - 'description' => '域id', - 'type' => 'string', - 'example' => 'bj1', - ], - 'drive_id' => [ - 'title' => '空间id', - 'description' => '空间id', - 'type' => 'string', - 'example' => '1', - ], - 'file_name' => [ - 'title' => '文件名', - 'description' => '文件名', - 'type' => 'string', - 'example' => 'a.txt', - ], - 'status' => [ - 'title' => '文件状态', - 'description' => '文件状态', - 'type' => 'string', - 'example' => 'uploading', - ], - 'exist' => [ - 'title' => '文件是否存在', - 'description' => '文件是否存在', - 'type' => 'boolean', - 'example' => 'false', - ], - ], + 'description' => '文件权限信息列表', + 'type' => 'array', + 'items' => ['description' => '文件权限信息', '$ref' => '#/components/schemas/FilePermissionMember'], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"parent_file_id\\": \\"fileid5\\",\\n \\"part_info_list\\": [\\n {\\n \\"part_number\\": 1,\\n \\"part_size\\": 1024,\\n \\"upload_url\\": \\"\\",\\n \\"internal_upload_url\\": \\"\\",\\n \\"etag\\": \\"0CC175B9C0F1B6A831C399E269772661\\",\\n \\"parallel_sha1_ctx\\": {\\n \\"h\\": [\\n 0\\n ],\\n \\"part_offset\\": 0\\n },\\n \\"upload_form_info\\": {\\n \\"bucket_name\\": \\"\\",\\n \\"oss_end_point\\": \\"\\",\\n \\"object_key\\": \\"\\",\\n \\"oss_access_key_id\\": \\"\\",\\n \\"oss_security_token\\": \\"\\",\\n \\"policy\\": \\"\\",\\n \\"signature\\": \\"\\",\\n \\"endpoint\\": \\"\\",\\n \\"form_data\\": {\\n \\"key\\": \\"\\"\\n }\\n },\\n \\"internal_upload_form_info\\": {\\n \\"bucket_name\\": \\"\\",\\n \\"oss_end_point\\": \\"\\",\\n \\"object_key\\": \\"\\",\\n \\"oss_access_key_id\\": \\"\\",\\n \\"oss_security_token\\": \\"\\",\\n \\"policy\\": \\"\\",\\n \\"signature\\": \\"\\",\\n \\"endpoint\\": \\"\\",\\n \\"form_data\\": {\\n \\"key\\": \\"\\"\\n }\\n },\\n \\"signature_info\\": {\\n \\"auth_type\\": \\"\\",\\n \\"signature\\": \\"\\",\\n \\"sts_token\\": \\"\\"\\n },\\n \\"parallel_sha256_ctx\\": {\\n \\"h\\": [\\n 0\\n ],\\n \\"part_offset\\": 0\\n }\\n }\\n ],\\n \\"upload_id\\": \\"uploadid1\\",\\n \\"rapid_upload\\": true,\\n \\"type\\": \\"file\\",\\n \\"file_id\\": \\"fileid1\\",\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_name\\": \\"a.txt\\",\\n \\"status\\": \\"uploading\\",\\n \\"exist\\": false\\n}","type":"json"}]', - 'title' => '创建文件或文件夹', - 'description' => '文件创建使用方法参考最佳实践：[文件上传](~~175888~~)。'."\n" - ."\n" - .'文件上传过程中，已上传的文件分片会产生存储费用。分片将保留10天，直到文件上传完成或10天后分片过期被清理。', - ], - 'DeleteFile' => [ - 'summary' => '删除文件或文件夹。', - 'path' => '/v2/file/delete', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'tags' => [ - 'api', + 'title' => '列举文件的共享或授权记录', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"[\\n {\\n \\"identity\\": {\\n \\"identity_type\\": \\"IT_User\\",\\n \\"identity_id\\": \\"16435bdf934248b788b7b3771ee9a3dw\\"\\n },\\n \\"role_id\\": \\"SystemFileDownloader\\",\\n \\"expire_time\\": 1633598085642,\\n \\"disinherit_sub_group\\": false,\\n \\"action_list\\": [\\n \\"FILE.CREATE\\"\\n ]\\n }\\n]","type":"json"}]', + ], + 'FilePutUserTags' => [ + 'path' => '/v2/file/put_usertags', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], + 'BearerToken' => [], ], [ - 'BearerToken' => [], + 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'delete', - 'riskType' => 'high', - 'chargeType' => 'free', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -11154,20 +4245,27 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'title' => 'drive id 如果要删除drive下的文件时，drive_id时必需的参数', - 'description' => '空间id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - 'pattern' => '^[0-9]*$', - ], - 'file_id' => [ - 'title' => 'file_id是文件的唯一标识，删除文件或者目录时必须指定file_id', - 'description' => '文件或文件夹id', - 'type' => 'string', + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'user_tags' => [ + 'description' => '待添加的标签列表。'."\n" + .'数组不能为空，且数量上限为 1000。'."\n" + .'数组中不能存在同名标签。', + 'type' => 'array', + 'items' => [ + 'description' => '标签名和标签值的长度之和不能超过 2000 字节。', + 'type' => 'object', + 'properties' => [ + 'key' => ['description' => '标签名。'."\n" + .'不能为空，且不能含有 # 字符。', 'type' => 'string', 'required' => true, 'example' => 'tag', 'pattern' => '^[^#]+$'], + 'value' => ['description' => '标签值。'."\n" + .'不能含有 # 字符。', 'type' => 'string', 'required' => false, 'example' => 'value', 'pattern' => '^[^#]+$'], + ], + 'required' => true, + ], 'required' => true, - 'example' => '9520943DC264', + 'maxItems' => 1000, + 'minItems' => 1, ], ], 'required' => false, @@ -11177,76 +4275,52 @@ 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'description' => '域id', - 'type' => 'string', - 'example' => 'bj1', - ], - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件id', - 'type' => 'string', - 'example' => '9520943DC264', - ], - 'async_task_id' => [ - 'description' => '异步任务id，只有异步处理的场景才会返回。后续可以调用 [GetAsyncTask](~~440456~~)，传递异步任务 id，获取任务信息。', - 'type' => 'string', - 'example' => '000e89fb-cf8f-11e9-8ab4-b6e980803a3b', - ], + 'file_id' => ['title' => 'Id of the request', 'description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"9520943DC264\\",\\n \\"async_task_id\\": \\"000e89fb-cf8f-11e9-8ab4-b6e980803a3b\\"\\n}","type":"json"}]', - 'title' => '删除文件或文件夹', - ], - 'UpdateFile' => [ - 'summary' => '修改文件信息，非数据。', - 'path' => '/v2/file/update', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '添加文件自定义标签', + 'summary' => '对文件添加自定义标签。', + 'description' => '此接口为增量更新操作：'."\n" + ."\n" + .'- 若此次请求中存在同名标签则会覆盖之前的值'."\n" + ."\n" + .'- 若标签不存在则新增'."\n" + ."\n" + .'- 历史非同名标签不受影响。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"file_id\\": \\"9520943DC264\\"\\n}","type":"json"}]', + ], + 'FileRemovePermission' => [ + 'summary' => '取消文件共享授权。', + 'path' => '/v2/file/remove_permission', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], + 'BearerToken' => [], ], [ - 'BearerToken' => [], + 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -11256,115 +4330,71 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - 'name' => [ - 'description' => '文件名称，按照 utf8 编码规则最长 1024 字节', - 'type' => 'string', - 'required' => false, - 'example' => 'a.jpg', - 'maxLength' => 102, - 'minLength' => 1, - ], - 'description' => [ - 'description' => '文件描述信息，最长 1024 字符', - 'type' => 'string', - 'required' => false, - 'example' => 'VIP用户', - 'maxLength' => 1024, - ], - 'labels' => [ - 'description' => '标签列表，最多 100 个标签', + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件id', 'type' => 'string', 'required' => true, 'example' => '4221bf6e6ab43c255edc4463bf3a6f5f5d317406'], + 'member_list' => [ + 'description' => '共享的用户对象集合', 'type' => 'array', 'items' => [ - 'description' => '标签，最长 128 字符', - 'type' => 'string', - 'required' => false, - 'example' => '动物', - ], - 'required' => false, - 'maxItems' => 100, - ], - 'check_name_mode' => [ - 'description' => '同名文件处理模式，可选值如下：'."\n" - ."\n" - .'ignore：允许同名文件；'."\n" - ."\n" - .'auto_rename：当发现同名文件时，云端自动重命名，默认为追加当前时间点，如 xxx\\_20060102\\_150405；'."\n" - ."\n" - .'refuse：当云端存在同名文件时，拒绝创建新文件，返回客户端已存在同名文件的详细信息。'."\n" - ."\n" - .'默认为 ignore', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'refuse' => 'refuse', - 'auto_rename' => 'auto_rename', - 'ignore' => 'ignore', - ], - 'example' => 'ignore', - 'enum' => [ - 'ignore', - 'auto_rename', - 'refuse', + 'type' => 'object', + 'properties' => [ + 'identity' => ['description' => '可授权对象，表示一个用户或者一个群组', 'required' => true, '$ref' => '#/components/schemas/Identity'], + 'role_id' => ['description' => '目前支持两种方式设置权限，一种是通过指定角色设置权限，另一种是自定义操作权限，此字段用于指定角色设置权限，与action\\_list互斥，当两个字段同时设置时，以此字段为准'."\n" + ."\n" + .'目前支持：'."\n" + ."\n" + .'SystemFileOwner（文件协同）'."\n" + ."\n" + .'SystemFileDownloader（下载者）'."\n" + ."\n" + .'SystemFileEditor（编辑者）'."\n" + ."\n" + .'SystemFileEditorWithoutDelete（无删除编辑者）'."\n" + ."\n" + .'SystemFileEditorWithoutShareLink（无分享编辑者）'."\n" + ."\n" + .'SystemFileMetaViewer（可见列表）'."\n" + ."\n" + .'SystemFileUploader（上传者）、SystemFileUploaderAndDownloader（上传/下载者）'."\n" + ."\n" + .'SystemFileDownloaderWithShareLink（下载/分享者）'."\n" + ."\n" + .'SystemFileUploaderAndDownloaderWithShareLink（上传/下载/分享者）'."\n" + ."\n" + .'SystemFileUploaderAndViewer（预览/上传者）'."\n" + ."\n" + .'SystemFileUploaderWithShareLink（上传/分享者）'."\n" + ."\n" + .'SystemFileViewer（预览者）', 'type' => 'string', 'required' => true, 'example' => 'SystemFileDownloader'], + ], + 'required' => true, + 'description' => '', ], - ], - 'local_modified_at' => [ - 'description' => '文件本地修改时间，格式为：yyyy-MM-ddTHH:mm:ssZ，采用 UTC +0 时区', - 'type' => 'string', - 'required' => false, - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'hidden' => [ - 'description' => '是否隐藏', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'starred' => [ - 'description' => '是否收藏', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', + 'required' => true, ], ], - 'required' => false, + 'required' => true, ], ], ], 'responses' => [ - 200 => [ - 'schema' => [ - 'description' => '文件信息', - '$ref' => '#/components/schemas/File', - ], + 204 => [ + 'headers' => [], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"name\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"content_type\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"trashed_at\\": \\"\\",\\n \\"file_extension\\": \\"\\",\\n \\"mime_type\\": \\"\\",\\n \\"mime_extension\\": \\"\\",\\n \\"hidden\\": true,\\n \\"size\\": 0,\\n \\"starred\\": true,\\n \\"status\\": \\"\\",\\n \\"user_meta\\": \\"\\",\\n \\"labels\\": [\\n \\"\\"\\n ],\\n \\"upload_id\\": \\"\\",\\n \\"parent_file_id\\": \\"\\",\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"category\\": \\"\\",\\n \\"local_created_at\\": \\"\\",\\n \\"local_modified_at\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"investigation_info\\": {\\n \\"status\\": 0,\\n \\"suggestion\\": \\"\\"\\n },\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"运动\\",\\n \\"name\\": \\"篮球\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"一起打篮球\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"ex_fields_info\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"content_uri\\": \\"\\",\\n \\"streams_info\\": {\\n \\"key\\": {\\n \\"crc64_hash\\": \\"\\",\\n \\"size\\": 0,\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"thumbnail\\": \\"\\"\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"revision_version\\": 0,\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"punish_flag\\": 0,\\n \\"id_path\\": \\"\\",\\n \\"name_path\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\",\\n \\"last_modifier_type\\": \\"\\",\\n \\"last_modifier_id\\": \\"\\",\\n \\"last_modifier_name\\": \\"\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 0,\\n \\"file_count\\": 0\\n },\\n \\"trashed\\": true,\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"location\\": \\"\\",\\n \\"semantic_result\\": {\\n \\"semantic_similarity\\": 0.879,\\n \\"document_contents\\": [\\n {\\n \\"element_contents\\": [\\n {\\n \\"type\\": \\"text\\",\\n \\"content\\": \\"文本片段\\",\\n \\"url\\": \\"http://aliyun.com\\",\\n \\"time_range\\": [\\n 0\\n ]\\n }\\n ]\\n }\\n ],\\n \\"scene_contents\\": [\\n {\\n \\"time_range\\": [\\n 0\\n ],\\n \\"key_frames\\": [\\n {\\n \\"frame_time\\": 1000,\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ],\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ]\\n },\\n \\"sync_flag\\": true,\\n \\"sync_device_flag\\": true,\\n \\"origin_parent_file_id\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"custom_field_1\\": \\"\\",\\n \\"custom_field_2\\": \\"\\",\\n \\"auto_delete_left_sec\\": 0,\\n \\"ai_processed\\": \\"\\",\\n \\"modified_at\\": \\"\\"\\n}","type":"json"}]', - 'title' => '修改文件信息', - ], - 'SearchFile' => [ - 'summary' => '搜索文件。', - 'path' => '/v2/file/search', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '取消文件共享授权', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', + ], + 'GetAsyncTask' => [ + 'summary' => '获取异步任务信息。', + 'path' => '/v2/async_task/get', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -11373,130 +4403,26 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - ], + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求体。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - 'query' => [ - 'description' => '搜索条件，可以根据文件名或目录名模糊查询，最长 4096 字符', - 'type' => 'string', - 'required' => true, - 'example' => 'name="123"', - 'maxLength' => 4096, - ], - 'order_by' => [ - 'description' => '排序字段，默认根据 created_at 排序，可选值如下：'."\n" - .'- created\\_at：根据创建时间排序'."\n" - .'- updated\\_at：根据更新时间排序'."\n" - .'- size：根据文件大小排序'."\n" - .'- name：根据文件名排序'."\n" - ."\n\n" - .'排序方向，可选值如下：'."\n" - .'- ASC代表正序'."\n" - .'- DESC代表逆序'."\n" - ."\n\n" - .'order\\_by语法为：字段名+空格+ASC/DESC，如果多个字段排序则需要用逗号隔开，前面的规则优先级高。如：'."\n" - .'- 按名称正序：name ASC'."\n" - .'- 按创建时间逆序： created_at DESC'."\n" - .'- 先按创建时间逆序，如果创建时间相同，则按名称正序：created_at DESC,name ASC', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [], - 'example' => 'name ASC', - 'enum' => [ - 'name', - 'type', - 'created_at', - 'updated_at', - 'size', - 'image_time', - 'last_access_at', - 'custom_type', - 'custom_field_1', - 'custom_field_2', - 'image_overall_score', - ], - ], - 'limit' => [ - 'description' => '限定此次返回资源的数量，取值范围\\[1,100\\]。'."\n" - ."\n" - .'返回结果可以小于指定的数量，但不能多于指定的数量。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '1', - 'example' => '50', - 'default' => '50', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'<br>默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'return_total_count' => [ - 'description' => '是否返回检索到的文件总数。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'recursive' => [ - 'description' => '当 query 中设置了 parent_file_id= xxx 时，设置该字段可以对文件夹进行递归搜索', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'thumbnail_processes' => [ - 'description' => '缩略图配置，可一次性返回最多5个缩略图，map的key可以自定义，返回时按key返回对应的缩略图链接', - 'type' => 'object', - 'required' => false, - 'additionalProperties' => [ - '$ref' => '#/components/schemas/ImageProcess', - 'description' => '定义图片、视频、文档的缩略图处理规则', - ], - ], - 'fields' => [ - 'description' => '设置 fields 时，可以返回文件的额外信息时，支持的字段为：'."\n" - .'* dir_size 响应中返回每个子文件夹的统计信息'."\n" - .'* id_path 响应中返回每个子对象的 id_path'."\n" - .'* name_path 响应中返回每个子对象的 name_path'."\n" - ."\n" - .'当需要多个信息时，不同字段以逗号分割，如 "id_path,name_path,dir_size"', - 'type' => 'string', - 'required' => false, - 'example' => 'id_path,name_path', - ], + 'async_task_id' => ['description' => '异步任务id', 'type' => 'string', 'required' => true, 'example' => '000e89fb-cf8f-11e9-8ab4-b6e980803a3b'], ], 'required' => false, ], @@ -11509,45 +4435,69 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'items' => [ - 'description' => '文件信息列表。', - 'type' => 'array', - 'items' => [ - 'description' => '文件信息', - '$ref' => '#/components/schemas/File', - ], - ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空。', + 'async_task_id' => ['title' => 'Id of the request', 'description' => '异步任务id', 'type' => 'string', 'example' => '000e89fb-cf8f-11e9-8ab4-b6e980803a3b'], + 'status' => [ + 'description' => '<warning>已废弃（推荐使用state字段替代）</warning>'."\n" + ."\n" + .'任务状态'."\n" + ."\n" + .'- Failed（失败）'."\n" + ."\n" + .'- Running（运行中）'."\n" + ."\n" + .'- PartialSucceed（部分成功）'."\n" + ."\n" + .'- Succeed（成功）', 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', + 'enumValueTitles' => ['Failed' => '失败', 'Running' => '运行中', 'PartialSucceed' => '部分成功', 'Succeed' => '成功'], + 'example' => 'Succeed', ], - 'total_count' => [ - 'description' => '命中的文件总数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1022', + 'state' => ['description' => '任务状态'."\n" + ."\n" + .'- Failed（失败）'."\n" + ."\n" + .'- Running（运行中）'."\n" + ."\n" + .'- PartialSucceed（部分成功）'."\n" + ."\n" + .'- Succeed（成功）', 'type' => 'string', 'example' => 'Succeed'], + 'message' => ['description' => '<warning>已废弃（推荐使用error_message字段替代）</warning>'."\n" + .'异步任务错误信息', 'type' => 'string', 'example' => 'The request has been failed due to some unknown error. Please try again later.'], + 'err_code' => ['description' => '<warning>已废弃（推荐使用error_code字段替代）</warning>'."\n" + .'异步任务错误码', 'type' => 'integer', 'format' => 'int64', 'example' => '404'], + 'total_process' => ['description' => '异步任务需处理总量，如服务端打包下载需打包的文件量', 'type' => 'integer', 'format' => 'int64', 'example' => '1000'], + 'consumed_process' => ['description' => '异步任务已处理总量，如服务端打包下载已打包的文件量', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'url' => ['description' => '异步任务生成数据的下载地址，如服务端打包下载任务生成下载地址', 'type' => 'string', 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx'], + 'error_code' => ['description' => '任务错误码', 'type' => 'string', 'example' => 'InternalError'], + 'error_message' => ['description' => '任务错误信息', 'type' => 'string', 'example' => 'The request has been failed due to some unknown error. Please try again later.'], + 'uncompress_file_list' => [ + 'description' => '解压文件信息列表', + 'type' => 'array', + 'items' => ['description' => '解压文件信息', '$ref' => '#/components/schemas/UncompressedFileInfo'], ], + 'category' => ['description' => '任务自定义类别', 'type' => 'string', 'example' => 'album'], + 'created_at' => ['description' => '任务创建时间，ISO格式， 如：2019-03-28T13:03:29.298Z', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'started_at' => ['description' => '任务开始时间，ISO格式， 如：2019-03-28T13:03:29.298Z', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'finished_at' => ['description' => '任务完成时间，ISO格式， 如：2019-03-28T13:03:29.298Z', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'skipped_process' => ['description' => '异步任务已跳过处理的数量', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'failed_process' => ['description' => '异步任务已处理失败的数量', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'task_type' => ['type' => 'string'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"name\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"content_type\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"trashed_at\\": \\"\\",\\n \\"file_extension\\": \\"\\",\\n \\"mime_type\\": \\"\\",\\n \\"mime_extension\\": \\"\\",\\n \\"hidden\\": true,\\n \\"size\\": 0,\\n \\"starred\\": true,\\n \\"status\\": \\"\\",\\n \\"user_meta\\": \\"\\",\\n \\"labels\\": [\\n \\"\\"\\n ],\\n \\"upload_id\\": \\"\\",\\n \\"parent_file_id\\": \\"\\",\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"category\\": \\"\\",\\n \\"local_created_at\\": \\"\\",\\n \\"local_modified_at\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"investigation_info\\": {\\n \\"status\\": 0,\\n \\"suggestion\\": \\"\\"\\n },\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"运动\\",\\n \\"name\\": \\"篮球\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"一起打篮球\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"ex_fields_info\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"content_uri\\": \\"\\",\\n \\"streams_info\\": {\\n \\"key\\": {\\n \\"crc64_hash\\": \\"\\",\\n \\"size\\": 0,\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"thumbnail\\": \\"\\"\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"revision_version\\": 0,\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"punish_flag\\": 0,\\n \\"id_path\\": \\"\\",\\n \\"name_path\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\",\\n \\"last_modifier_type\\": \\"\\",\\n \\"last_modifier_id\\": \\"\\",\\n \\"last_modifier_name\\": \\"\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 0,\\n \\"file_count\\": 0\\n },\\n \\"trashed\\": true,\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"location\\": \\"\\",\\n \\"semantic_result\\": {\\n \\"semantic_similarity\\": 0.879,\\n \\"document_contents\\": [\\n {\\n \\"element_contents\\": [\\n {\\n \\"type\\": \\"text\\",\\n \\"content\\": \\"文本片段\\",\\n \\"url\\": \\"http://aliyun.com\\",\\n \\"time_range\\": [\\n 0\\n ]\\n }\\n ]\\n }\\n ],\\n \\"scene_contents\\": [\\n {\\n \\"time_range\\": [\\n 0\\n ],\\n \\"key_frames\\": [\\n {\\n \\"frame_time\\": 1000,\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ],\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ]\\n },\\n \\"sync_flag\\": true,\\n \\"sync_device_flag\\": true,\\n \\"origin_parent_file_id\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"custom_field_1\\": \\"\\",\\n \\"custom_field_2\\": \\"\\",\\n \\"auto_delete_left_sec\\": 0,\\n \\"ai_processed\\": \\"\\",\\n \\"modified_at\\": \\"\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\",\\n \\"total_count\\": 1022\\n}","type":"json"}]', - 'title' => '搜索文件', - 'description' => '<props="china">最佳实践可参考：[搜索文件](https://help.aliyun.com/document_detail/175890.html)。</props>', - ], - 'ListFile' => [ - 'summary' => '直接文件夹下列举文件和文件夹。', - 'path' => '/v2/file/list', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"async_task_id\\": \\"000e89fb-cf8f-11e9-8ab4-b6e980803a3b\\",\\n \\"status\\": \\"Succeed\\",\\n \\"state\\": \\"Succeed\\",\\n \\"message\\": \\"The request has been failed due to some unknown error. Please try again later.\\",\\n \\"err_code\\": 404,\\n \\"total_process\\": 1000,\\n \\"consumed_process\\": 100,\\n \\"url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"error_code\\": \\"InternalError\\",\\n \\"error_message\\": \\"The request has been failed due to some unknown error. Please try again later.\\",\\n \\"uncompress_file_list\\": [\\n {\\n \\"drive_id\\": \\"5060\\",\\n \\"file_id\\": \\"66972349b2b12fa309a143fb9db29647b2ddabfd\\",\\n \\"is_folder\\": true,\\n \\"name\\": \\"1.mov\\",\\n \\"size\\": 218052,\\n \\"updated_at\\": 1721368014000,\\n \\"items\\": [\\n {\\n \\"drive_id\\": \\"5060\\",\\n \\"file_id\\": \\"66972349b2b12fa309a143fb9db29647b2ddabfd\\",\\n \\"is_folder\\": true,\\n \\"name\\": \\"1.mov\\",\\n \\"size\\": 218052,\\n \\"updated_at\\": 1721368014000,\\n \\"items\\": [\\n {\\n \\"drive_id\\": \\"5060\\",\\n \\"file_id\\": \\"66972349b2b12fa309a143fb9db29647b2ddabfd\\",\\n \\"is_folder\\": true,\\n \\"name\\": \\"1.mov\\",\\n \\"size\\": 218052,\\n \\"updated_at\\": 1721368014000,\\n \\"items\\": []\\n }\\n ]\\n }\\n ]\\n }\\n ],\\n \\"category\\": \\"album\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"started_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"finished_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"skipped_process\\": 0,\\n \\"failed_process\\": 0,\\n \\"task_type\\": \\"\\"\\n}","type":"json"}]', + 'title' => '获取异步任务信息', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'GetDefaultDrive' => [ + 'path' => '/v2/drive/get_default_drive', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -11556,24 +4506,14 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -11583,178 +4523,7 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'share_id' => [ - 'description' => '分享id。'."\n" - .'如果通过分享操作文件，请携带`x-share-token` header鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。'."\n" - .'`share_id`和`drive_id`两者必须有一个字段赋值。', - 'type' => 'string', - 'required' => false, - 'example' => '7JQX1FswpQ8', - ], - 'drive_id' => [ - 'description' => '空间 id。', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - 'parent_file_id' => [ - 'description' => '父文件夹 id，当父文件为根目录时，填写 root', - 'type' => 'string', - 'required' => true, - 'example' => 'root', - ], - 'limit' => [ - 'description' => '限定此次返回资源的数量，取值范围\\[1,100\\]。'."\n" - ."\n" - .'返回结果可以小于指定的数量，但不能多于指定的数量。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '50', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'<br>默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'status' => [ - 'description' => '文件状态，可选字段如下：'."\n" - ."\n" - .'available：只返回正常文件'."\n" - .'uploading：只返回上传中文件'."\n" - ."\n" - .'默认只返回 available 状态文件', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'available' => '正常', - 'uploading' => '上传中', - ], - 'example' => 'available', - 'enum' => [ - 'uploading', - 'available', - ], - ], - 'order_by' => [ - 'description' => '排序字段，可选值如下：'."\n" - ."\n" - .'created\\_at：根据创建时间排序'."\n" - .'updated\\_at：根据更新时间排序'."\n" - .'size：根据文件大小排序'."\n" - .'name：根据文件名排序'."\n" - ."\n" - .'默认根据 created_at 排序', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'updated_at' => '修改时间', - 'size' => '大小', - 'name' => '名称', - 'created_at' => '创建时间', - ], - 'example' => 'updated_at', - ], - 'order_direction' => [ - 'description' => '排序方向，可选字段为：'."\n" - ."\n" - .'ASC：正序'."\n" - .'DESC：倒序'."\n" - ."\n" - .'默认值为ASC', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'ASC' => '正序', - 'DESC' => '倒序', - ], - 'example' => 'ASC', - 'enum' => [ - 'ASC', - 'DESC', - ], - ], - 'category' => [ - 'description' => '文件分类，可选字段如下：'."\n" - ."\n" - .'app：安装包'."\n" - .'zip：压缩包'."\n" - .'image：图片'."\n" - .'doc：文档'."\n" - .'video：视频'."\n" - .'audio：音频'."\n" - .'others：其他'."\n" - ."\n" - .'默认返回所有分类文件', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'app' => 'app', - 'zip' => 'zip', - 'image' => 'image', - 'doc' => 'doc', - 'video' => 'video', - 'audio' => 'audio', - 'others' => 'others', - ], - 'example' => 'image', - 'enum' => [ - 'image', - 'video', - 'audio', - 'doc', - 'app', - 'zip', - 'others', - ], - ], - 'type' => [ - 'description' => '文件类型，可选字段如下：'."\n" - ."\n" - .'file：只返回文件'."\n" - .'folder：只返回文件夹'."\n" - ."\n" - .'默认返回所有类型文件', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'file' => '文件', - 'folder' => '文件夹', - ], - 'example' => 'file', - 'enum' => [ - 'file', - 'folder', - ], - ], - 'fields' => [ - 'description' => '设置 fields 时，可以返回子对象的额外信息时，支持的字段为：'."\n" - .'- url 响应中返回文件缩略图地址，下载地址'."\n" - .'- exif 响应中返回文件的 exif 信息'."\n" - .'- cropping\\_suggestion 响应中返回文件的裁剪建议信息'."\n" - .'- characteristic\\_hash 响应中返回文件的特征 hash 值'."\n" - .'- video\\_metadata 响应中返回视频文件的 meta 信息，比如视频时长，比特率，高度，宽度等'."\n" - .'- video\\_preview_metadata 响应中返回视频文件的转码信息，比如每个清晰度的转码信息'."\n" - .'- investigation_info 响应中返回 investigation_info字段'."\n" - .'- dir_size 响应中返回每个子文件夹的统计信息'."\n" - .'- user_tags 响应中返回每个子对象的 user_tags'."\n" - ."\n" - .'当需要多个信息时，不同字段以逗号分割，如 "url,dir_size,user_tags"', - 'type' => 'string', - 'required' => false, - 'example' => 'url,dir_size,user_tags', - ], - 'thumbnail_processes' => [ - 'description' => '缩略图配置，可一次性返回最多5个缩略图，map的key可以自定义，返回时按key返回对应的缩略图链接', - 'type' => 'object', - 'required' => false, - 'additionalProperties' => [ - '$ref' => '#/components/schemas/ImageProcess', - 'description' => '定义图片、视频、文档的缩略图处理规则', - ], - ], + 'user_id' => ['description' => '用户 id，AK 访问时必填，AccessToken 访问时可选（默认取 AccessToken 关联的用户 id）', 'type' => 'string', 'required' => false, 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4'], ], 'required' => false, ], @@ -11762,128 +4531,44 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'items' => [ - 'description' => '文件列表。', - 'type' => 'array', - 'items' => [ - 'description' => '文件信息', - '$ref' => '#/components/schemas/File', - ], - ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空。', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - ], - ], + 'schema' => ['description' => 'Schema of Response', '$ref' => '#/components/schemas/Drive'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"name\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"content_type\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"trashed_at\\": \\"\\",\\n \\"file_extension\\": \\"\\",\\n \\"mime_type\\": \\"\\",\\n \\"mime_extension\\": \\"\\",\\n \\"hidden\\": true,\\n \\"size\\": 0,\\n \\"starred\\": true,\\n \\"status\\": \\"\\",\\n \\"user_meta\\": \\"\\",\\n \\"labels\\": [\\n \\"\\"\\n ],\\n \\"upload_id\\": \\"\\",\\n \\"parent_file_id\\": \\"\\",\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"category\\": \\"\\",\\n \\"local_created_at\\": \\"\\",\\n \\"local_modified_at\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"investigation_info\\": {\\n \\"status\\": 0,\\n \\"suggestion\\": \\"\\"\\n },\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"运动\\",\\n \\"name\\": \\"篮球\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"一起打篮球\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"ex_fields_info\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"content_uri\\": \\"\\",\\n \\"streams_info\\": {\\n \\"key\\": {\\n \\"crc64_hash\\": \\"\\",\\n \\"size\\": 0,\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"thumbnail\\": \\"\\"\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"revision_version\\": 0,\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"punish_flag\\": 0,\\n \\"id_path\\": \\"\\",\\n \\"name_path\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\",\\n \\"last_modifier_type\\": \\"\\",\\n \\"last_modifier_id\\": \\"\\",\\n \\"last_modifier_name\\": \\"\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 0,\\n \\"file_count\\": 0\\n },\\n \\"trashed\\": true,\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"location\\": \\"\\",\\n \\"semantic_result\\": {\\n \\"semantic_similarity\\": 0.879,\\n \\"document_contents\\": [\\n {\\n \\"element_contents\\": [\\n {\\n \\"type\\": \\"text\\",\\n \\"content\\": \\"文本片段\\",\\n \\"url\\": \\"http://aliyun.com\\",\\n \\"time_range\\": [\\n 0\\n ]\\n }\\n ]\\n }\\n ],\\n \\"scene_contents\\": [\\n {\\n \\"time_range\\": [\\n 0\\n ],\\n \\"key_frames\\": [\\n {\\n \\"frame_time\\": 1000,\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ],\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ]\\n },\\n \\"sync_flag\\": true,\\n \\"sync_device_flag\\": true,\\n \\"origin_parent_file_id\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"custom_field_1\\": \\"\\",\\n \\"custom_field_2\\": \\"\\",\\n \\"auto_delete_left_sec\\": 0,\\n \\"ai_processed\\": \\"\\",\\n \\"modified_at\\": \\"\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', - 'title' => '列举文件', - ], - 'GetFile' => [ - 'summary' => '获取文件详情。', - 'path' => '/v2/file/get', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '获取缺省空间', + 'summary' => '获取指定用户的缺省空间。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"drive_name\\": \\"drv1\\",\\n \\"description\\": \\"vipdrive\\",\\n \\"owner\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"owner_type\\": \\"user\\",\\n \\"drive_type\\": \\"normal\\",\\n \\"status\\": \\"enabled\\",\\n \\"used_size\\": 20480,\\n \\"total_size\\": 204800,\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\"\\n}","type":"json"}]', + ], + 'GetDomain' => [ + 'path' => '/v2/domain/get', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'tags' => ['admin'], 'security' => [ [ 'AK' => [], ], - [ - 'BearerToken' => [], - ], - ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ - 'name' => 'domain_id', - 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], - ], - [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - 'url_expire_sec' => [ - 'description' => '过期时间，单位为秒，取值范围为：[10,14400] 秒', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '14400', - 'minimum' => '10', - 'example' => '100', - ], - 'fields' => [ - 'description' => '筛选返回字段：'."\n" - ."\n" - .'1. 当填 * 时，返回文件所有字段（必须在请求中填写的除外）；'."\n" - .'2. 当只需要特定字段时，可填写为：url、thumbnail、exif、cropping\\_suggestion、characteristic\\_hash、video\\_metadata、video\\_preview_metadata，当需要多个字段时，以逗号 , 分割，如 url,thumbnail；'."\n" - .'3. 必须填写investigation_info字符串，才会在响应中返回investigation_info字段。'."\n" - ."\n" - .'默认返回所有字段（必须进行填写的除外）', - 'type' => 'string', - 'required' => false, - 'example' => '*', - ], - 'thumbnail_processes' => [ - 'description' => '缩略图配置，可一次性返回最多5个缩略图，map的key可以自定义，返回时按key返回对应的缩略图链接', - 'type' => 'object', - 'required' => false, - 'additionalProperties' => [ - '$ref' => '#/components/schemas/ImageProcess', - 'description' => '定义图片、视频、文档的缩略图处理规则', - ], - ], - 'share_id' => [ - 'description' => '分享id。'."\n" - .'如果通过分享操作文件，请携带`x-share-token` header鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。'."\n" - .'`share_id`和`drive_id`两者必须有一个字段赋值。', - 'type' => 'string', - 'required' => false, - 'example' => '7JQX1FswpQ8', - ], + 'domain_id' => ['description' => 'domain id', 'type' => 'string', 'required' => true, 'example' => 'bj1'], + 'get_quota_used' => ['description' => '是否需要获取domain的已用quota，默认为false。当domain容量配额size_quota大于0时，传true可获取domain已用容量配额。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'fields' => ['description' => '需要获取的 domain 属性字段，英文逗号分隔，为空代表不获取任何枚举字段', 'type' => 'string', 'required' => false, 'example' => 'file_category'], ], 'required' => false, ], @@ -11891,144 +4576,62 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'description' => 'Schema of Response', - '$ref' => '#/components/schemas/File', - ], + 'schema' => ['description' => 'domain 信息', '$ref' => '#/components/schemas/Domain'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"name\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"content_type\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"trashed_at\\": \\"\\",\\n \\"file_extension\\": \\"\\",\\n \\"mime_type\\": \\"\\",\\n \\"mime_extension\\": \\"\\",\\n \\"hidden\\": true,\\n \\"size\\": 0,\\n \\"starred\\": true,\\n \\"status\\": \\"\\",\\n \\"user_meta\\": \\"\\",\\n \\"labels\\": [\\n \\"\\"\\n ],\\n \\"upload_id\\": \\"\\",\\n \\"parent_file_id\\": \\"\\",\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"category\\": \\"\\",\\n \\"local_created_at\\": \\"\\",\\n \\"local_modified_at\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"investigation_info\\": {\\n \\"status\\": 0,\\n \\"suggestion\\": \\"\\"\\n },\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"运动\\",\\n \\"name\\": \\"篮球\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"一起打篮球\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"ex_fields_info\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"content_uri\\": \\"\\",\\n \\"streams_info\\": {\\n \\"key\\": {\\n \\"crc64_hash\\": \\"\\",\\n \\"size\\": 0,\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"thumbnail\\": \\"\\"\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"revision_version\\": 0,\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"punish_flag\\": 0,\\n \\"id_path\\": \\"\\",\\n \\"name_path\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\",\\n \\"last_modifier_type\\": \\"\\",\\n \\"last_modifier_id\\": \\"\\",\\n \\"last_modifier_name\\": \\"\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 0,\\n \\"file_count\\": 0\\n },\\n \\"trashed\\": true,\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"location\\": \\"\\",\\n \\"semantic_result\\": {\\n \\"semantic_similarity\\": 0.879,\\n \\"document_contents\\": [\\n {\\n \\"element_contents\\": [\\n {\\n \\"type\\": \\"text\\",\\n \\"content\\": \\"文本片段\\",\\n \\"url\\": \\"http://aliyun.com\\",\\n \\"time_range\\": [\\n 0\\n ]\\n }\\n ]\\n }\\n ],\\n \\"scene_contents\\": [\\n {\\n \\"time_range\\": [\\n 0\\n ],\\n \\"key_frames\\": [\\n {\\n \\"frame_time\\": 1000,\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ],\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ]\\n },\\n \\"sync_flag\\": true,\\n \\"sync_device_flag\\": true,\\n \\"origin_parent_file_id\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"custom_field_1\\": \\"\\",\\n \\"custom_field_2\\": \\"\\",\\n \\"auto_delete_left_sec\\": 0,\\n \\"ai_processed\\": \\"\\",\\n \\"modified_at\\": \\"\\"\\n}","type":"json"}]', - 'title' => '获取文件详情', - ], - 'DownloadFile' => [ - 'summary' => '下载文件。', - 'path' => '/v2/file/download', - 'methods' => [ - 'get', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'tags' => [ - 'api', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取Domain', + 'summary' => '获取Domain信息。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"parent_domain_id\\": \\"bj1\\",\\n \\"domain_id\\": \\"bj2\\",\\n \\"domain_name\\": \\"pdsdomain\\",\\n \\"description\\": \\"my domain\\",\\n \\"init_drive_enable\\": true,\\n \\"init_drive_size\\": 1073741824,\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"size_quota\\": 1099511627776,\\n \\"size_quota_used\\": 1099511627776,\\n \\"user_count_quota\\": 50,\\n \\"status\\": 1,\\n \\"used_size\\": 1099511627776,\\n \\"published_app_access_strategy\\": {\\n \\"effect\\": \\"deny\\",\\n \\"except_app_id_list\\": [\\n \\"8ovxCTRUDdbpVWBP\\"\\n ]\\n },\\n \\"sharable\\": true,\\n \\"data_hash_name\\": \\"sha1\\",\\n \\"store_redundancy_type\\": \\"LRS\\"\\n}","type":"json"}]', + ], + 'GetDomainQuota' => [ + 'path' => '/v2/domain/get_quota', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'tags' => ['admin'], 'security' => [ [ 'AK' => [], ], - [ - 'BearerToken' => [], - ], - ], - 'consumes' => [ - 'application/x-www-form-urlencoded', - ], - 'produces' => [ - 'application/octet-stream', ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], - 'parameters' => [ - [ - 'name' => 'domain_id', - 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], - ], - [ - 'name' => 'share_id', - 'in' => 'query', - 'schema' => [ - 'description' => '分享id。 如果通过分享操作文件，请携带`x-share-token header`鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。 `share_id`和`drive_id`两者必须有一个字段赋值。', - 'type' => 'string', - 'required' => false, - 'example' => '7JQX1FswpQ8', - ], - ], - [ - 'name' => 'drive_id', - 'in' => 'query', - 'schema' => [ - 'description' => '空间id', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - ], - [ - 'name' => 'file_id', - 'in' => 'query', - 'schema' => [ - 'description' => '文件id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - ], - [ - 'name' => 'image_thumbnail_process', - 'in' => 'query', - 'schema' => [ - 'description' => '图片处理样式，设置后会跳转至处理后的缩略图地址', - 'type' => 'string', - 'required' => false, - 'example' => 'image/resize,m_fill,h_128,w_128,limit_0', - ], - ], - [ - 'name' => 'video_thumbnail_process', - 'in' => 'query', - 'schema' => [ - 'description' => '视频处理样式，设置后会跳转至处理后的缩略图地址', - 'type' => 'string', - 'required' => false, - 'example' => 'video/snapshot,t_7000,f_jpg,w_800,h_600,m_fast', - ], - ], - [ - 'name' => 'office_thumbnail_process', - 'in' => 'query', - 'schema' => [ - 'description' => '文档处理样式，设置后会跳转至处理后的缩略图地址', - 'type' => 'string', - 'required' => false, - 'example' => 'image/resize,m_lfit,w_256,limit_0/format,jpg|image/format,webp', - ], - ], - ], + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [], 'responses' => [ - 302 => [ - 'headers' => [ - 'location' => [ - 'schema' => [ - 'title' => '下载地址', - 'type' => 'string', - ], + 200 => [ + 'schema' => [ + 'type' => 'object', + 'properties' => [ + 'size_quota' => ['type' => 'integer', 'format' => 'int64', 'description' => ''], + 'size_used' => ['type' => 'integer', 'format' => 'int64', 'description' => ''], + 'user_count_quota' => ['type' => 'integer', 'format' => 'int64', 'description' => ''], + 'user_count_used' => ['type' => 'integer', 'format' => 'int64', 'description' => ''], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '下载文件', - 'description' => '<props="china">最佳实践可参考：[文件下载](~~175889~~)。</props>', - ], - 'GetUploadUrl' => [ - 'summary' => '获取上传地址。', - 'path' => '/v2/file/get_upload_url', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'staticInfo' => ['returnType' => 'synchronous'], + 'summary' => ' 获取domain限额 ', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"size_quota\\": 0,\\n \\"size_used\\": 0,\\n \\"user_count_quota\\": 0,\\n \\"user_count_used\\": 0\\n}","type":"json"}]', + ], + 'GetDownloadUrl' => [ + 'summary' => '获取文件下载地址。', + 'path' => '/v2/file/get_download_url', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -12037,24 +4640,16 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - ], + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -12064,103 +4659,14 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'share_id' => [ - 'description' => '分享id', - 'type' => 'string', - 'required' => false, - 'example' => '7JQX1FswpQ8', - ], - 'file_id' => [ - 'description' => '文件id', - 'type' => 'string', - 'required' => true, - 'example' => '5d5b846942cf94fa72324c14a4bda34e81da635d', - ], - 'upload_id' => [ - 'description' => '上传 id', - 'type' => 'string', - 'required' => true, - 'example' => '10166D06127B413BA1EC8ABB1144D111', - ], - 'part_info_list' => [ - 'description' => '分片信息列表', - 'type' => 'array', - 'items' => [ - 'description' => '分片信息', - 'type' => 'object', - 'properties' => [ - 'part_number' => [ - 'description' => '段编号', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '1', - ], - 'parallel_sha1_ctx' => [ - 'description' => '该分片前所有数据的SHA1上下文，该字段只在多分片并发上传的模式下有效', - 'type' => 'object', - 'properties' => [ - 'h' => [ - 'description' => '该分片前所有数据的SHA1上下文的第1-5个32位变量，该字段只在多分片并发上传的模式下有效', - 'type' => 'array', - 'items' => [ - 'description' => '该分片前所有数据的SHA1上下文的第1-5个32位变量', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - ], - 'required' => false, - ], - 'part_offset' => [ - 'description' => '到上一个数据块为止的总长度，单位为字节，需要为64的倍数，该字段只在多分片并发上传的模式下有效', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '10240', - ], - ], - 'required' => false, - ], - 'content_md5' => [ - 'type' => 'string', - 'required' => false, - ], - 'content_type' => [ - 'type' => 'string', - 'required' => false, - ], - 'parallel_sha256_ctx' => [ - 'type' => 'object', - 'properties' => [ - 'h' => [ - 'type' => 'array', - 'items' => [ - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - ], - 'required' => false, - ], - 'part_offset' => [ - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - ], - ], - 'required' => false, - ], - ], - 'required' => false, - ], - 'required' => true, - ], + 'share_id' => ['description' => '分享id。'."\n" + .'如果通过分享操作文件，请携带`x-share-token` header鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。'."\n" + .'`share_id`和`drive_id`两者必须有一个字段赋值。', 'type' => 'string', 'required' => false, 'example' => '7JQX1FswpQ8'], + 'drive_id' => ['description' => '空间 id。', 'type' => 'string', 'required' => false, 'example' => '1'], + 'file_id' => ['description' => '文件 id。', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'file_name' => ['description' => '文件名，最长 1024 字符。', 'type' => 'string', 'required' => false, 'example' => '1.txt', 'maxLength' => 1024, 'minLength' => 1], + 'expire_sec' => ['description' => '下载地址过期时间，单位为秒，最长115200秒，默认为900秒。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '115200', 'minimum' => '1', 'example' => '100', 'default' => '900'], + 'response_content_type' => ['type' => 'string', 'required' => false, 'example' => 'video/mp4', 'description' => ''], ], 'required' => false, ], @@ -12170,85 +4676,53 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => 'Schema of Response。', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'title' => 'Id of the request', - 'description' => '域id', - 'type' => 'string', - 'example' => 'bj1', - ], - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件id', - 'type' => 'string', - 'example' => '5d5b846942cf94fa72324c14a4bda34e81da635d', - ], - 'upload_id' => [ - 'description' => '上传id', - 'type' => 'string', - 'example' => '10166D06127B413BA1EC8ABB1144D111', - ], - 'create_at' => [ - 'description' => '创建时间', - 'type' => 'string', - 'example' => '2019-09-11T16:34:36.977Z', - ], - 'part_info_list' => [ - 'description' => '分段信息列表', - 'type' => 'array', - 'items' => [ - 'description' => '分段信息', - '$ref' => '#/components/schemas/UploadPartInfo', - ], - ], + 'url' => ['title' => 'Id of the request', 'description' => '公网下载地址'."\n" + .'（开启智能数据域名后，根据客户网络情况选取最优线路，返回对应域名下载地址）。', 'type' => 'string', 'example' => 'https://data.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt'], + 'internal_url' => ['description' => 'vpc内下载地址'."\n" + .'（开启智能数据域名后将不使用该字段，根据请求该参数会自适应返回在URL字段值内，如需使用该字段请联系PDS技术支持）。', 'type' => 'string', 'example' => 'https://data-vpc.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt'], + 'cdn_url' => ['description' => 'cdn下载地址'."\n" + .'（开启智能数据域名后不使用该字段，根据请求该参数会自适应返回在URL字段值内，如需使用该字段请联系PDS技术支持）。', 'type' => 'string', 'example' => 'https://data-cdn.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt'], + 'expiration' => ['description' => '下载链接的过期时间。', 'type' => 'string', 'example' => '2022-01-02T15:04:05.999Z07:00'], + 'size' => ['description' => '文件大小，单位：byte。', 'type' => 'integer', 'format' => 'int64', 'example' => '10'], + 'crc64_hash' => ['description' => 'crc64值。', 'type' => 'string', 'example' => '5498595269368962671'], + 'content_hash' => ['description' => '文件内容hash。', 'type' => 'string', 'example' => 'EA4942AA8761213890A5C386F88E6464D2C31CA1'], + 'content_hash_name' => ['description' => '文件内容hash算法名。', 'type' => 'string', 'example' => 'sha1'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"5d5b846942cf94fa72324c14a4bda34e81da635d\\",\\n \\"upload_id\\": \\"10166D06127B413BA1EC8ABB1144D111\\",\\n \\"create_at\\": \\"2019-09-11T16:34:36.977Z\\",\\n \\"part_info_list\\": [\\n {\\n \\"part_number\\": 1,\\n \\"part_size\\": 1024,\\n \\"upload_url\\": \\"\\",\\n \\"internal_upload_url\\": \\"\\",\\n \\"etag\\": \\"0CC175B9C0F1B6A831C399E269772661\\",\\n \\"parallel_sha1_ctx\\": {\\n \\"h\\": [\\n 0\\n ],\\n \\"part_offset\\": 0\\n },\\n \\"upload_form_info\\": {\\n \\"bucket_name\\": \\"\\",\\n \\"oss_end_point\\": \\"\\",\\n \\"object_key\\": \\"\\",\\n \\"oss_access_key_id\\": \\"\\",\\n \\"oss_security_token\\": \\"\\",\\n \\"policy\\": \\"\\",\\n \\"signature\\": \\"\\",\\n \\"endpoint\\": \\"\\",\\n \\"form_data\\": {\\n \\"key\\": \\"\\"\\n }\\n },\\n \\"internal_upload_form_info\\": {\\n \\"bucket_name\\": \\"\\",\\n \\"oss_end_point\\": \\"\\",\\n \\"object_key\\": \\"\\",\\n \\"oss_access_key_id\\": \\"\\",\\n \\"oss_security_token\\": \\"\\",\\n \\"policy\\": \\"\\",\\n \\"signature\\": \\"\\",\\n \\"endpoint\\": \\"\\",\\n \\"form_data\\": {\\n \\"key\\": \\"\\"\\n }\\n },\\n \\"signature_info\\": {\\n \\"auth_type\\": \\"\\",\\n \\"signature\\": \\"\\",\\n \\"sts_token\\": \\"\\"\\n },\\n \\"parallel_sha256_ctx\\": {\\n \\"h\\": [\\n 0\\n ],\\n \\"part_offset\\": 0\\n }\\n }\\n ]\\n}","type":"json"}]', - 'title' => '获取上传地址', - ], - 'ListUploadedParts' => [ - 'summary' => '列举已上传成功的多段。', - 'path' => '/v2/file/list_uploaded_parts', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"url\\": \\"https://data.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt\\",\\n \\"internal_url\\": \\"https://data-vpc.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt\\",\\n \\"cdn_url\\": \\"https://data-cdn.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt\\",\\n \\"expiration\\": \\"2022-01-02T15:04:05.999Z07:00\\",\\n \\"size\\": 10,\\n \\"crc64_hash\\": \\"5498595269368962671\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA1\\",\\n \\"content_hash_name\\": \\"sha1\\"\\n}","type":"json"}]', + 'title' => '获取文件下载地址', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'GetDrive' => [ + 'summary' => '获取空间信息。', + 'path' => '/v2/drive/get', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'BearerToken' => [], + 'AK' => [], ], [ - 'AK' => [], + 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -12258,45 +4732,7 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'part_number_marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。 默认值：无'."\n" - ."\n", - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'limit' => [ - 'description' => '限定此次返回资源的数量。如果不设定，默认返回100，最大不能超过100。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '100', - ], - 'upload_id' => [ - 'description' => '上传id', - 'type' => 'string', - 'required' => true, - 'example' => '00166D06127B413BA1EC8ABB1144D101', - ], - 'file_id' => [ - 'description' => '文件id', - 'type' => 'string', - 'required' => true, - 'example' => '322fb07b975f4b0ae1b543fe8475eee4c19eb2b2', - ], - 'drive_id' => [ - 'description' => '空间 id，除根据分享链接上传之外的其他场景，必填', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - 'share_id' => [ - 'description' => '分享 id，当根据分享链接上传时必填', - 'type' => 'string', - 'required' => false, - 'example' => '7JQX1FswpQ8', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], ], 'required' => false, ], @@ -12304,59 +4740,21 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'file_id' => [ - 'title' => 'Id of the request', - 'description' => '文件id', - 'type' => 'string', - 'example' => '322fb07b975f4b0ae1b543fe8475eee4c19eb2b2', - ], - 'upload_id' => [ - 'description' => '上传id', - 'type' => 'string', - 'example' => '00166D06127B413BA1EC8ABB1144D101', - ], - 'uploaded_parts' => [ - 'description' => '分段信息列表', - 'type' => 'array', - 'items' => [ - 'description' => '分段信息', - '$ref' => '#/components/schemas/UploadPartInfo', - ], - ], - 'next_part_number_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空。', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'parallel_upload' => [ - 'description' => '是否并行上传', - 'type' => 'boolean', - 'example' => 'false', - ], - ], - ], + 'schema' => ['description' => 'Schema of Response', '$ref' => '#/components/schemas/Drive'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"file_id\\": \\"322fb07b975f4b0ae1b543fe8475eee4c19eb2b2\\",\\n \\"upload_id\\": \\"00166D06127B413BA1EC8ABB1144D101\\",\\n \\"uploaded_parts\\": [\\n {\\n \\"part_number\\": 1,\\n \\"part_size\\": 1024,\\n \\"upload_url\\": \\"\\",\\n \\"internal_upload_url\\": \\"\\",\\n \\"etag\\": \\"0CC175B9C0F1B6A831C399E269772661\\",\\n \\"parallel_sha1_ctx\\": {\\n \\"h\\": [\\n 0\\n ],\\n \\"part_offset\\": 0\\n },\\n \\"upload_form_info\\": {\\n \\"bucket_name\\": \\"\\",\\n \\"oss_end_point\\": \\"\\",\\n \\"object_key\\": \\"\\",\\n \\"oss_access_key_id\\": \\"\\",\\n \\"oss_security_token\\": \\"\\",\\n \\"policy\\": \\"\\",\\n \\"signature\\": \\"\\",\\n \\"endpoint\\": \\"\\",\\n \\"form_data\\": {\\n \\"key\\": \\"\\"\\n }\\n },\\n \\"internal_upload_form_info\\": {\\n \\"bucket_name\\": \\"\\",\\n \\"oss_end_point\\": \\"\\",\\n \\"object_key\\": \\"\\",\\n \\"oss_access_key_id\\": \\"\\",\\n \\"oss_security_token\\": \\"\\",\\n \\"policy\\": \\"\\",\\n \\"signature\\": \\"\\",\\n \\"endpoint\\": \\"\\",\\n \\"form_data\\": {\\n \\"key\\": \\"\\"\\n }\\n },\\n \\"signature_info\\": {\\n \\"auth_type\\": \\"\\",\\n \\"signature\\": \\"\\",\\n \\"sts_token\\": \\"\\"\\n },\\n \\"parallel_sha256_ctx\\": {\\n \\"h\\": [\\n 0\\n ],\\n \\"part_offset\\": 0\\n }\\n }\\n ],\\n \\"next_part_number_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\",\\n \\"parallel_upload\\": false\\n}","type":"json"}]', - 'title' => '列举已上传分片', - ], - 'CompleteFile' => [ - 'summary' => '完成文件上传。', - 'path' => '/v2/file/complete', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '获取空间信息', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"drive_name\\": \\"drv1\\",\\n \\"description\\": \\"vipdrive\\",\\n \\"owner\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"owner_type\\": \\"user\\",\\n \\"drive_type\\": \\"normal\\",\\n \\"status\\": \\"enabled\\",\\n \\"used_size\\": 20480,\\n \\"total_size\\": 204800,\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\"\\n}","type":"json"}]', + ], + 'GetFile' => [ + 'path' => '/v2/file/get', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -12365,24 +4763,15 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -12392,28 +4781,25 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'upload_id' => [ - 'description' => '上传id', - 'type' => 'string', - 'required' => true, - 'example' => 'C9DCFE5A82644AC7A02DB74C30C934A6', - ], - 'file_id' => [ - 'description' => '文件id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - 'crc64_hash' => [ - 'type' => 'string', + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => false, 'example' => '1'], + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'url_expire_sec' => ['description' => '过期时间，单位为秒，取值范围为：[10,14400] 秒', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '14400', 'minimum' => '10', 'example' => '100'], + 'fields' => ['description' => '筛选返回字段：'."\n" + ."\n" + .'1. 当填 * 时，返回文件所有字段（必须在请求中填写的除外）；'."\n" + .'2. 当只需要特定字段时，可填写为：url、thumbnail、exif、cropping\\_suggestion、characteristic\\_hash、video\\_metadata、video\\_preview_metadata，当需要多个字段时，以逗号 , 分割，如 url,thumbnail；'."\n" + .'3. 必须填写investigation_info字符串，才会在响应中返回investigation_info字段。'."\n" + ."\n" + .'默认返回所有字段（必须进行填写的除外）', 'type' => 'string', 'required' => false, 'example' => '*'], + 'thumbnail_processes' => [ + 'description' => '缩略图配置，可一次性返回最多5个缩略图，map的key可以自定义，返回时按key返回对应的缩略图链接', + 'type' => 'object', 'required' => false, + 'additionalProperties' => ['$ref' => '#/components/schemas/ImageProcess', 'description' => '定义图片、视频、文档的缩略图处理规则'], ], + 'share_id' => ['description' => '分享id。'."\n" + .'如果通过分享操作文件，请携带`x-share-token` header鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。'."\n" + .'`share_id`和`drive_id`两者必须有一个字段赋值。', 'type' => 'string', 'required' => false, 'example' => '7JQX1FswpQ8'], ], 'required' => false, ], @@ -12421,30 +4807,23 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'description' => '文件信息', - '$ref' => '#/components/schemas/File', - ], + 'schema' => ['description' => 'Schema of Response', '$ref' => '#/components/schemas/File'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"name\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"content_type\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"trashed_at\\": \\"\\",\\n \\"file_extension\\": \\"\\",\\n \\"mime_type\\": \\"\\",\\n \\"mime_extension\\": \\"\\",\\n \\"hidden\\": true,\\n \\"size\\": 0,\\n \\"starred\\": true,\\n \\"status\\": \\"\\",\\n \\"user_meta\\": \\"\\",\\n \\"labels\\": [\\n \\"\\"\\n ],\\n \\"upload_id\\": \\"\\",\\n \\"parent_file_id\\": \\"\\",\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"category\\": \\"\\",\\n \\"local_created_at\\": \\"\\",\\n \\"local_modified_at\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"investigation_info\\": {\\n \\"status\\": 0,\\n \\"suggestion\\": \\"\\"\\n },\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"运动\\",\\n \\"name\\": \\"篮球\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"一起打篮球\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"ex_fields_info\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"content_uri\\": \\"\\",\\n \\"streams_info\\": {\\n \\"key\\": {\\n \\"crc64_hash\\": \\"\\",\\n \\"size\\": 0,\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"thumbnail\\": \\"\\"\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"revision_version\\": 0,\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"punish_flag\\": 0,\\n \\"id_path\\": \\"\\",\\n \\"name_path\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\",\\n \\"last_modifier_type\\": \\"\\",\\n \\"last_modifier_id\\": \\"\\",\\n \\"last_modifier_name\\": \\"\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 0,\\n \\"file_count\\": 0\\n },\\n \\"trashed\\": true,\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"location\\": \\"\\",\\n \\"semantic_result\\": {\\n \\"semantic_similarity\\": 0.879,\\n \\"document_contents\\": [\\n {\\n \\"element_contents\\": [\\n {\\n \\"type\\": \\"text\\",\\n \\"content\\": \\"文本片段\\",\\n \\"url\\": \\"http://aliyun.com\\",\\n \\"time_range\\": [\\n 0\\n ]\\n }\\n ]\\n }\\n ],\\n \\"scene_contents\\": [\\n {\\n \\"time_range\\": [\\n 0\\n ],\\n \\"key_frames\\": [\\n {\\n \\"frame_time\\": 1000,\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ],\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ]\\n },\\n \\"sync_flag\\": true,\\n \\"sync_device_flag\\": true,\\n \\"origin_parent_file_id\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"custom_field_1\\": \\"\\",\\n \\"custom_field_2\\": \\"\\",\\n \\"auto_delete_left_sec\\": 0,\\n \\"ai_processed\\": \\"\\",\\n \\"modified_at\\": \\"\\"\\n}","type":"json"}]', - 'title' => '完成文件上传', - 'description' => '使用方法参考最佳实践：[文件上传](~~175888~~)。'."\n" - ."\n" - .'文件上传过程中，已上传的文件分片会产生存储费用。分片将保留10天，直到文件上传完成或10天后分片过期被清理。', - ], - 'MoveFile' => [ - 'summary' => '移动文件或文件夹。', - 'path' => '/v2/file/move', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '获取文件详情', + 'summary' => '获取文件详情。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"5d79206586bb5dd69fb34c349282718146c55da7\\",\\n \\"name\\": \\"1.mov\\",\\n \\"type\\": \\"file\\",\\n \\"content_type\\": \\"application/json\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"image file\\",\\n \\"trashed_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"file_extension\\": \\"txt\\",\\n \\"hidden\\": false,\\n \\"size\\": 1024,\\n \\"starred\\": false,\\n \\"status\\": \\"available\\",\\n \\"labels\\": [\\n \\"[\\\\\\"label1:1\\\\\\", \\\\\\"label2:2\\\\\\"]\\"\\n ],\\n \\"upload_id\\": \\"C9DCFE5A82644AC7A02DB74C30C934A6\\",\\n \\"parent_file_id\\": \\"3d5b846942cf94fa72324c8a4bda34e81da635a\\",\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"category\\": \\"image\\",\\n \\"local_created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"local_modified_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"revision_id\\": \\"5d5b846942cf94fa72324c14a4bda34e81da635d\\",\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\\\\\"128X128\\\\\\": \\\\\\"https://url1\\\\\\", \\\\\\"800X800\\\\\\": \\\\\\"url2\\\\\\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1024,\\n \\"height\\": 1024,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"sport\\",\\n \\"name\\": \\"basketball\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"play basketball\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\\\\\"k1\\\\\\":\\\\\\"v1\\\\\\", \\\\\\"k2\\\\\\",\\\\\\"v2\\\\\\"\\"\\n },\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"id_path\\": \\"id1/id2\\",\\n \\"name_path\\": \\"root/f1/f2\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 1,\\n \\"file_count\\": 10\\n },\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"auto_delete_left_sec\\": 0\\n}","type":"json"}]', + ], + 'GetGroup' => [ + 'summary' => '获取群组信息。', + 'path' => '/v2/group/get', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -12453,73 +4832,24 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - 'to_parent_file_id' => [ - 'description' => '目的父文件夹 id，当移入根目录时，填 root', - 'type' => 'string', - 'required' => true, - 'example' => '6520943DC261', - ], - 'check_name_mode' => [ - 'description' => '同名文件处理模式，可选值如下：'."\n" - ."\n" - .'ignore：允许同名文件；'."\n" - ."\n" - .'auto\\_rename：当发现同名文件时，云端自动重命名，默认为追加当前时间点，如 xxx\\_20060102\\_150405；'."\n" - ."\n" - .'refuse：当云端存在同名文件时，拒绝创建新文件，返回客户端已存在同名文件的详细信息。'."\n" - ."\n" - .'默认为 ignore', - 'type' => 'string', - 'required' => false, - 'example' => 'ignore', - 'enum' => [ - 'ignore', - 'auto_rename', - 'refuse', - ], - ], + 'group_id' => ['description' => '待获取的群组ID', 'type' => 'string', 'required' => true, 'example' => '2e43ec8427dd45f19431b7504649a1b1'], ], 'required' => false, ], @@ -12527,69 +4857,22 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'domain_id' => [ - 'title' => 'Id of the request', - 'description' => '域id', - 'type' => 'string', - 'example' => 'bj1', - ], - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件id', - 'type' => 'string', - 'example' => 'fileid1', - ], - 'async_task_id' => [ - 'description' => '异步任务id。'."\n" - ."\n" - .'如果返回为空字符串，表示直接移动成功。'."\n" - ."\n" - .'如果返回非空字符串，表示需要经过异步处理。调用GetAsyncTask，传递异步任务id，获取任务信息。', - 'type' => 'string', - 'example' => '23ebd1a24dba4166b1527add476ef2866051b4d5del106', - ], - 'exist' => [ - 'description' => '文件是否已存在', - 'type' => 'boolean', - 'example' => 'false', - ], - 'revision_id' => [ - 'type' => 'string', - ], - 'file_name' => [ - 'type' => 'string', - ], - 'updated_at' => [ - 'type' => 'string', - ], - ], - ], + 'schema' => ['description' => '群组信息', '$ref' => '#/components/schemas/Group'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"fileid1\\",\\n \\"async_task_id\\": \\"23ebd1a24dba4166b1527add476ef2866051b4d5del106\\",\\n \\"exist\\": false,\\n \\"revision_id\\": \\"\\",\\n \\"file_name\\": \\"\\",\\n \\"updated_at\\": \\"\\"\\n}","type":"json"}]', - 'title' => '移动文件或文件夹', - ], - 'CopyFile' => [ - 'summary' => '拷贝文件或目录。', - 'path' => '/v2/file/copy', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '获取群组信息', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"group_id\\": \\"b45c0c0c373c41ec9ebb5c85a025a08f\\",\\n \\"group_name\\": \\"test group\\",\\n \\"description\\": \\"created by system\\",\\n \\"created_at\\": 1670573504600,\\n \\"updated_at\\": 1670573504600,\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"is_sync\\": true\\n}","type":"json"}]', + ], + 'GetIdentityToBenefitPkgMapping' => [ + 'summary' => '获取实体和权益包关联，可用于获取用户绑定的权益包。', + 'path' => '/v2/benefit/identity_to_benefit_pkg_mapping/get', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -12598,72 +4881,36 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - ], + 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求体参数', 'type' => 'object', 'properties' => [ - 'share_id' => [ - 'description' => '分享id。'."\n" - .'如果通过分享操作文件，请携带`x-share-token` header鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。'."\n" - .'`share_id`和`drive_id`两者必须有一个字段赋值。', - 'type' => 'string', - 'required' => false, - 'example' => '7JQX1FswpQ8', - ], - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件或文件夹 id', - 'type' => 'string', - 'required' => true, - 'example' => '4221bf6e6ab43c255edc4463bf3a6f5f5d317406', - ], - 'to_drive_id' => [ - 'description' => '拷贝到的空间id。'."\n" - .'默认值同drive_id。', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - 'to_parent_file_id' => [ - 'description' => '目的父文件夹 id，当复制进根目录时，填 root', + 'identity_type' => [ + 'description' => '实体的类型'."\n" + .'管理用户权益，传user', 'type' => 'string', 'required' => true, - 'example' => '6520943DC261', - ], - 'auto_rename' => [ - 'description' => '当目标文件夹下存在同名文件时，是否自动重命名，默认为 false', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', + 'example' => 'user', + 'enum' => ['user'], ], + 'identity_id' => ['description' => '实体的唯一标识'."\n" + ."\n" + .'管理用户权益时，传user_id', 'type' => 'string', 'required' => true, 'example' => 'user123'], + 'benefit_pkg_id' => ['description' => '权益包的唯一标识', 'type' => 'string', 'required' => true, 'example' => '40cb7794c9294'], ], 'required' => false, ], @@ -12671,76 +4918,40 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'domain_id' => [ - 'description' => '域id', - 'type' => 'string', - 'example' => 'bj1', - ], - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'example' => '1', - ], - 'file_id' => [ - 'description' => '复制后的新文件或文件夹 id', - 'type' => 'string', - 'example' => '4221bf6e6ab43a255edc4463bffa6f5f5d317401', - ], - 'async_task_id' => [ - 'description' => '异步任务id。'."\n" - ."\n" - .'当复制的是文件时，不返回该字段；当复制的是文件夹时，为后台异步复制，会返回该字段，调用GetAsyncTask，传递异步任务id，获取任务信息。', - 'type' => 'string', - 'example' => '000e89fb-cf8f-11e9-8ab4-b6e980803a3b', - ], - ], - ], + 'schema' => ['description' => '实体绑定的权益包信息', '$ref' => '#/components/schemas/IdentityToBenefitPkgMapping'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"4221bf6e6ab43a255edc4463bffa6f5f5d317401\\",\\n \\"async_task_id\\": \\"000e89fb-cf8f-11e9-8ab4-b6e980803a3b\\"\\n}","type":"json"}]', - 'title' => '复制文件或文件夹', - ], - 'GetDownloadUrl' => [ - 'summary' => '获取文件下载地址。', - 'path' => '/v2/file/get_download_url', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '获取实体和权益包关联', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"identity_type\\": \\"user\\",\\n \\"identity_id\\": \\"user123\\",\\n \\"benefit_pkg_owner_id\\": \\"bj1\\",\\n \\"benefit_pkg_id\\": \\"40cb7794c9294\\",\\n \\"benefit_pkg_type\\": \\"user_identity\\",\\n \\"benefit_pkg_name\\": \\"高级会员\\",\\n \\"benefit_pkg_priority\\": 1,\\n \\"benefit_pkg_computation_rule\\": \\"sum\\",\\n \\"delivery_info_list\\": [\\n {\\n \\"amount\\": 1,\\n \\"is_permanent\\": false,\\n \\"expire_time\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\"\\n }\\n ],\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\"\\n}","type":"json"}]', + ], + 'GetLinkInfo' => [ + 'summary' => '获取账号信息。', + 'path' => '/v2/account/get_link_info', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], + 'BearerToken' => [], ], [ - 'BearerToken' => [], + 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -12750,49 +4961,23 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'share_id' => [ - 'description' => '分享id。'."\n" - .'如果通过分享操作文件，请携带`x-share-token` header鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。'."\n" - .'`share_id`和`drive_id`两者必须有一个字段赋值。', - 'type' => 'string', - 'required' => false, - 'example' => '7JQX1FswpQ8', - ], - 'drive_id' => [ - 'description' => '空间 id。', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件 id。', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - 'file_name' => [ - 'description' => '文件名，最长 1024 字符。', - 'type' => 'string', - 'required' => false, - 'example' => '1.txt', - 'maxLength' => 1024, - 'minLength' => 1, - ], - 'expire_sec' => [ - 'description' => '下载地址过期时间，单位为秒，最长115200秒，默认为900秒。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '115200', - 'minimum' => '1', - 'example' => '100', - 'default' => '900', - ], - 'response_content_type' => [ - 'type' => 'string', - 'required' => false, - 'example' => 'video/mp4', - ], + 'type' => ['description' => '账号类型'."\n" + ."\n" + .'- mobile：手机号'."\n" + ."\n" + .'- email：邮箱'."\n" + ."\n" + .'- ding：钉钉'."\n" + ."\n" + .'- ram：阿里云RAM子账号'."\n" + ."\n" + .'- wechat：企业微信'."\n" + ."\n" + .'- ldap：LDAP账号'."\n" + ."\n" + .'- custom：自定义账号', 'type' => 'string', 'required' => true, 'example' => 'mobile'], + 'identity' => ['description' => '账号的唯一标识，比如手机号', 'type' => 'string', 'required' => true, 'example' => '130***'], + 'extra' => ['description' => '账号唯一标识的附加信息，比如当账号为手机号时，此字段填手机的区域编码。', 'type' => 'string', 'required' => false, 'example' => '1'], ], 'required' => false, ], @@ -12800,75 +4985,26 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response。', - 'type' => 'object', - 'properties' => [ - 'url' => [ - 'title' => 'Id of the request', - 'description' => '公网下载地址'."\n" - .'（开启智能数据域名后，根据客户网络情况选取最优线路，返回对应域名下载地址）。', - 'type' => 'string', - 'example' => 'https://data.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt', - ], - 'internal_url' => [ - 'description' => 'vpc内下载地址'."\n" - .'（开启智能数据域名后将不使用该字段，根据请求该参数会自适应返回在URL字段值内，如需使用该字段请联系PDS技术支持）。', - 'type' => 'string', - 'example' => 'https://data-vpc.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt', - ], - 'cdn_url' => [ - 'description' => 'cdn下载地址'."\n" - .'（开启智能数据域名后不使用该字段，根据请求该参数会自适应返回在URL字段值内，如需使用该字段请联系PDS技术支持）。', - 'type' => 'string', - 'example' => 'https://data-cdn.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt', - ], - 'expiration' => [ - 'description' => '下载链接的过期时间。', - 'type' => 'string', - 'example' => '2022-01-02T15:04:05.999Z07:00', - ], - 'size' => [ - 'description' => '文件大小，单位：byte。', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '10', - ], - 'crc64_hash' => [ - 'description' => 'crc64值。', - 'type' => 'string', - 'example' => '5498595269368962671', - ], - 'content_hash' => [ - 'description' => '文件内容hash。', - 'type' => 'string', - 'example' => 'EA4942AA8761213890A5C386F88E6464D2C31CA1', - ], - 'content_hash_name' => [ - 'description' => '文件内容hash算法名。', - 'type' => 'string', - 'example' => 'sha1', - ], - ], - ], + 'headers' => [], + 'schema' => ['description' => '返回用户账号信息', '$ref' => '#/components/schemas/AccountLinkInfo'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"url\\": \\"https://data.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt\\",\\n \\"internal_url\\": \\"https://data-vpc.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt\\",\\n \\"cdn_url\\": \\"https://data-cdn.aliyunpds.com/hz22%2F5d79219b0aa9a7c995a94a96993ba3205cd91c5a%2F5d79219bf3261a5d38744da0834ed489b677a27a?Expires=xxxOSSAccessKeyId=xxx&Signature=xxx&response-content-disposition=attachment%3Bfilename%3DtBiZAoJPC2c8b13450eda4292b7f5f8010618e078.txt\\",\\n \\"expiration\\": \\"2022-01-02T15:04:05.999Z07:00\\",\\n \\"size\\": 10,\\n \\"crc64_hash\\": \\"5498595269368962671\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA1\\",\\n \\"content_hash_name\\": \\"sha1\\"\\n}","type":"json"}]', - 'title' => '获取文件下载地址', - ], - 'FilePutUserTags' => [ - 'summary' => '对文件添加自定义标签。', - 'path' => '/v2/file/put_usertags', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'tags' => [ - 'api', + 'title' => '获取账号信息', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"authentication_type\\": \\"mobile\\",\\n \\"identity\\": \\"136***000\\",\\n \\"extra\\": \\"86\\",\\n \\"user_id\\": \\"00016a587b62b50003deea299a4f5b50\\",\\n \\"created_at\\": 1639762579768,\\n \\"display_name\\": \\"001\\",\\n \\"status\\": \\"normal\\",\\n \\"last_login_time\\": 1639762579769\\n}","type":"json"}]', + ], + 'GetLinkInfoByUserId' => [ + 'path' => '/v2/account/get_link_info_by_user_id', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'BearerToken' => [], @@ -12877,21 +5013,15 @@ 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -12901,50 +5031,7 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - 'user_tags' => [ - 'description' => '待添加的标签列表。'."\n" - .'数组不能为空，且数量上限为 1000。'."\n" - .'数组中不能存在同名标签。', - 'type' => 'array', - 'items' => [ - 'description' => '标签名和标签值的长度之和不能超过 2000 字节。', - 'type' => 'object', - 'properties' => [ - 'key' => [ - 'description' => '标签名。'."\n" - .'不能为空，且不能含有 # 字符。', - 'type' => 'string', - 'required' => true, - 'example' => 'tag', - 'pattern' => '^[^#]+$', - ], - 'value' => [ - 'description' => '标签值。'."\n" - .'不能含有 # 字符。', - 'type' => 'string', - 'required' => false, - 'example' => 'value', - 'pattern' => '^[^#]+$', - ], - ], - 'required' => true, - ], - 'required' => true, - 'maxItems' => 1000, - 'minItems' => 1, - ], + 'user_id' => ['description' => '待查询的UserID', 'type' => 'string', 'required' => true, 'example' => 'xxx'], ], 'required' => false, ], @@ -12952,44 +5039,39 @@ ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '返回结构体', 'type' => 'object', 'properties' => [ - 'file_id' => [ - 'title' => 'Id of the request', - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', + 'items' => [ + 'title' => 'items', + 'description' => '用户账号信息列表', + 'type' => 'array', + 'items' => ['description' => '用户账号信息', '$ref' => '#/components/schemas/AccountLinkInfo'], ], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"file_id\\": \\"9520943DC264\\"\\n}","type":"json"}]', - 'title' => '添加文件自定义标签', - 'description' => '此接口为增量更新操作：'."\n" - ."\n" - .'- 若此次请求中存在同名标签则会覆盖之前的值'."\n" - ."\n" - .'- 若标签不存在则新增'."\n" - ."\n" - .'- 历史非同名标签不受影响。', - ], - 'FileDeleteUserTags' => [ - 'summary' => '删除文件自定义标签。', - 'path' => '/v2/file/delete_usertags', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'tags' => [ - 'api', + 'title' => '根据用户ID获取账号信息', + 'summary' => '根据用户ID获取账号信息。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"authentication_type\\": \\"mobile\\",\\n \\"identity\\": \\"136***000\\",\\n \\"extra\\": \\"86\\",\\n \\"user_id\\": \\"00016a587b62b50003deea299a4f5b50\\",\\n \\"created_at\\": 1639762579768,\\n \\"display_name\\": \\"001\\",\\n \\"status\\": \\"normal\\",\\n \\"last_login_time\\": 1639762579769\\n }\\n ]\\n}","type":"json"}]', + ], + 'GetRevision' => [ + 'path' => '/v2/file/revision/get', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'BearerToken' => [], @@ -12998,22 +5080,14 @@ 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['title' => 'A short description of struct', 'description' => 'A short description of struct', 'type' => 'string', 'required' => true], ], [ 'name' => 'body', @@ -13023,58 +5097,38 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - 'key_list' => [ - 'description' => '待删除的标签列表。'."\n" - .'数组不能为空，且数量上限为 1000。', - 'type' => 'array', - 'items' => [ - 'description' => '标签名。'."\n" - .'不能带有 # 字符。', - 'type' => 'string', - 'required' => true, - 'example' => 'tag', - 'pattern' => '^[^#]+$', - ], - 'required' => true, - 'maxItems' => 1000, - 'minItems' => 1, - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'revision_id' => ['description' => '版本 id', 'type' => 'string', 'required' => true, 'example' => '40CB7794C929'], + 'url_expire_sec' => ['description' => '过期时间，单位为秒，最短 10 秒，最长 86400 秒'."\n" + ."\n" + .'默认15分钟。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '900'], + 'fields' => ['description' => '筛选返回字段'."\n" + ."\n" + .'默认为空。当填 * 时，返回所有字段，会比为空时多返回创建者名称', 'type' => 'string', 'required' => false, 'example' => '*'], ], 'required' => false, ], ], ], 'responses' => [ - 204 => [], - ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '删除文件自定义标签', - ], - 'VideoDRMLicense' => [ - 'summary' => '获取视频的DRM License。', - 'path' => '/v2/file/video_drm_license', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', + 200 => [ + 'schema' => ['description' => '版本信息', '$ref' => '#/components/schemas/Revision'], + ], ], - 'tags' => [ - 'api', + 'title' => '获取版本信息', + 'summary' => '获取版本详情。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"9520943DC264\\",\\n \\"revision_id\\": \\"40CB7794C929\\",\\n \\"revision_name\\": \\"1.mov\\",\\n \\"revision_version\\": 1,\\n \\"size\\": 1024,\\n \\"file_extension\\": \\"mov\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"keep_forever\\": false,\\n \\"revision_description\\": \\"aaa\\",\\n \\"is_latest_version\\": false,\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\\\n\\",\\n \\"url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\\\n\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\\\n\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\"\\n}","type":"json"}]', + ], + 'GetShareLink' => [ + 'path' => '/v2/share_link/get', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -13083,24 +5137,14 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -13110,22 +5154,7 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drmType' => [ - 'description' => 'DRM 加密类型。', - 'type' => 'string', - 'required' => true, - 'enumValueTitles' => [ - 'fairplay' => 'fairplay', - 'widevine' => 'widevine', - ], - 'example' => 'widevine', - ], - 'licenseRequest' => [ - 'description' => '获取 license 请求体。', - 'type' => 'string', - 'required' => false, - 'example' => 'CAES6B8SQgpACioSENGxDhqCLIVwwCBOyPayyWoSENGxDhqCLIVwwCBOyPayyWpI88aJmwYQARoQdRV32', - ], + 'share_id' => ['description' => '分享id', 'type' => 'string', 'required' => true, 'example' => '7JQX1FswpQ8'], ], 'required' => false, ], @@ -13133,70 +5162,37 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回结构体', - 'type' => 'object', - 'properties' => [ - 'data' => [ - 'description' => '返回的DRM License。', - 'type' => 'string', - 'example' => 'cb9swCy8P50H9KePsxET3jZ1tm41bDs9HTsxbWnsjf3bsf6QGdiS4kZPhDaskimbNyAfNjmhQRmWFt3AhwNF3', - ], - 'states' => [ - 'description' => 'DRM Server 返回的请求状态。', - 'type' => 'string', - 'example' => '0', - ], - 'device_info' => [ - 'description' => '发起 DRM 请求的设备信息。', - 'type' => 'string', - 'example' => '""', - ], - ], - ], + 'schema' => ['description' => '返回信息', '$ref' => '#/components/schemas/ShareLink'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"data\\": \\"cb9swCy8P50H9KePsxET3jZ1tm41bDs9HTsxbWnsjf3bsf6QGdiS4kZPhDaskimbNyAfNjmhQRmWFt3AhwNF3\\",\\n \\"states\\": \\"0\\",\\n \\"device_info\\": \\"\\\\\\"\\\\\\"\\"\\n}","type":"json"}]', - 'title' => '获取视频DRMLicense', - ], - 'DeleteRevision' => [ - 'summary' => '删除历史版本，不支持删除最新版本。', - 'path' => '/v2/file/revision/delete', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '获取分享信息', + 'summary' => '获取分享信息。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"share_id\\": \\"7JQX1FswpQ8\\",\\n \\"share_pwd\\": \\"abcF123x\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id_list\\": [\\n \\"[\\\\\\"xx\\\\\\"]\\"\\n ],\\n \\"expiration\\": \\"2020-06-28T11:33:00.000+08:00\\",\\n \\"expired\\": false,\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"videos\\",\\n \\"share_name\\": \\"video-1.MP4\\",\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"status\\": \\"enabled\\",\\n \\"preview_count\\": 10,\\n \\"save_count\\": 2,\\n \\"download_count\\": 5,\\n \\"report_count\\": 0,\\n \\"video_preview_count\\": 1,\\n \\"access_count\\": 4,\\n \\"disable_preview\\": false,\\n \\"disable_save\\": false,\\n \\"disable_download\\": false,\\n \\"preview_limit\\": 100,\\n \\"save_limit\\": 100,\\n \\"download_limit\\": 100,\\n \\"require_login\\": false,\\n \\"share_all_files\\": true,\\n \\"share_msg\\": \\"pwd: 123\\",\\n \\"save_download_limit\\": 100,\\n \\"office_editable\\": true\\n}","type":"json"}]', + ], + 'GetShareLinkByAnonymous' => [ + 'summary' => '匿名查看分享信息。', + 'path' => '/v2/share_link/get_by_anonymous', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], - ], - [ - 'BearerToken' => [], + 'Anonymous' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => 'A short description of struct', - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -13206,79 +5202,68 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - 'revision_id' => [ - 'description' => '版本 id', - 'type' => 'string', - 'required' => true, - 'example' => '40CB7794C929', - ], + 'share_id' => ['description' => '分享id', 'type' => 'string', 'required' => true, 'example' => '7JQX1FswpQ8'], ], 'required' => false, ], ], ], 'responses' => [ - 204 => [ + 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '返回信息', 'type' => 'object', - 'properties' => [], - ], - ], + 'properties' => [ + 'creator_id' => ['description' => '创建者id', 'type' => 'string', 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4'], + 'creator_name' => ['description' => '创建者名字（已脱敏）', 'type' => 'string', 'example' => 'AB***CD'], + 'creator_phone' => ['description' => '创建者手机号（已脱敏）', 'type' => 'string', 'example' => '136****00'], + 'expiration' => ['description' => '过期时间', 'type' => 'string', 'example' => '2020-08-20T06:51:27.292Z'], + 'updated_at' => ['description' => '修改时间', 'type' => 'string', 'example' => '2019-08-20T06:51:27.292Z'], + 'avatar' => ['description' => '创建者头像', 'type' => 'string', 'example' => 'https://aliyunpds.com/a.jpg'], + 'share_name' => ['description' => '分享名称', 'type' => 'string', 'example' => 'LectureRoom-1.MP4'], + 'preview_count' => ['description' => '预览次数', 'type' => 'integer', 'format' => 'int64', 'example' => '80'], + 'save_count' => ['description' => '转存次数', 'type' => 'integer', 'format' => 'int64', 'example' => '2'], + 'download_count' => ['description' => '下载次数', 'type' => 'integer', 'format' => 'int64', 'example' => '50'], + 'report_count' => ['description' => '被举报次数', 'type' => 'integer', 'format' => 'int64', 'example' => '0'], + 'video_preview_count' => ['description' => '视频预览次数', 'type' => 'integer', 'format' => 'int64', 'example' => '5'], + 'access_count' => ['description' => '访问次数', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + 'disable_preview' => ['description' => '禁止预览', 'type' => 'boolean', 'example' => 'false'], + 'disable_save' => ['description' => '禁止转存', 'type' => 'boolean', 'example' => 'false'], + 'disable_download' => ['description' => '禁止下载', 'type' => 'boolean', 'example' => 'false'], + 'preview_limit' => ['description' => '预览次数限制', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'save_limit' => ['description' => '转存次数限制', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'download_limit' => ['description' => '下载次数限制', 'type' => 'integer', 'format' => 'int64', 'example' => '100'], + 'save_download_limit' => ['description' => '转存和下载总次数限制', 'type' => 'integer', 'format' => 'int64', 'example' => '200'], + 'has_pwd' => ['description' => '分享是否设置了提取码', 'type' => 'boolean', 'example' => 'true'], + ], + ], + ], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"creator_id\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"creator_name\\": \\"AB***CD\\",\\n \\"creator_phone\\": \\"136****00\\",\\n \\"expiration\\": \\"2020-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"avatar\\": \\"https://aliyunpds.com/a.jpg\\",\\n \\"share_name\\": \\"LectureRoom-1.MP4\\",\\n \\"preview_count\\": 80,\\n \\"save_count\\": 2,\\n \\"download_count\\": 50,\\n \\"report_count\\": 0,\\n \\"video_preview_count\\": 5,\\n \\"access_count\\": 30,\\n \\"disable_preview\\": false,\\n \\"disable_save\\": false,\\n \\"disable_download\\": false,\\n \\"preview_limit\\": 100,\\n \\"save_limit\\": 100,\\n \\"download_limit\\": 100,\\n \\"save_download_limit\\": 200,\\n \\"has_pwd\\": true\\n}","type":"json"}]', + 'title' => '匿名查看分享信息', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '删除历史版本', ], - 'UpdateRevision' => [ - 'summary' => '更新版本信息，设置版本为永久保留，或者添加版本描述信息。支持将一个文件的最多50个版本设置为永久保留。', - 'path' => '/v2/file/revision/update', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'GetShareLinkToken' => [ + 'path' => '/v2/share_link/get_share_token', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], - ], - [ - 'BearerToken' => [], + 'Anonymous' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => 'A short description of struct', - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -13288,40 +5273,9 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - 'revision_id' => [ - 'description' => '版本 id', - 'type' => 'string', - 'required' => true, - 'example' => '40CB7794C929', - ], - 'keep_forever' => [ - 'description' => '是否永久保留'."\n" - ."\n" - .'默认不传递该参数，表示不修改版本的永久保留属性。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'revision_description' => [ - 'description' => '版本描述信息，最长1024字符'."\n" - ."\n" - .'默认不传递该参数，表示不修改版本的版本描述信息。', - 'type' => 'string', - 'required' => false, - 'example' => 'aaa', - ], + 'share_id' => ['description' => '分享id', 'type' => 'string', 'required' => true, 'example' => '7JQX1FswpQ8'], + 'share_pwd' => ['description' => '提取码', 'type' => 'string', 'required' => false, 'example' => 'abcF123x'], + 'expire_sec' => ['description' => '令牌有效时长。参数合法范围是(0, 7200]；参数为0或缺省时默认7200秒。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '7200'], ], 'required' => false, ], @@ -13330,26 +5284,31 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => '版本信息', - '$ref' => '#/components/schemas/Revision', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'share_token' => ['title' => 'Id of the request', 'description' => 'jwt格式的令牌', 'type' => 'string', 'example' => 'eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJjOWI3YTVhYTA0ZDE0YWUzODY3ZmRjODg2ZmEwMWRhNCIsImN1c3RvbUpzb24iOiJ7XCJjbGllbnRJZFwiOlwiMjVkelgzdmJZcWt0Vnh5WFwiLFwiZG9tYWluSWRcIjpcImJqMjlcIixcInNjb3BlXCI6W1wiRFJJVkUuQUxMXCIsXCJTSEFSRS5BTExcIixcIkZJTEUuQUxMXCIsXCJVU0VSLkFMTFwiLFwiVklFVy5BTExcIixcIlNUT1JBR0UuQUxMXCIsXCJTVE9SQUdFRklMRS5MSVNUXCIsXCJCQVRDSFwiLFwiT0FVVEguQUxMXCIsXCJJTUFHRS5BTExcIixcIklOVklURS5BTExcIixcIkFDQ09VTlQuQUxMXCJdLFwicm9sZVwiOlwidXNlclwiLFwicmVmXCI6XCJodHRwczovL3d3dy5hbGl5dW5kcml2ZS5jb20vXCIsXCJkZXZpY2VfaWRcIjpcImIyODIwNWU1YzU5NzRjY2JiODI3MDNiNjhkYjhjNDUxXCJ9IiwiZXhwIjoxNjQ4NjE0NDkzLCJpYXQiOjE2NDg2MDcyMzN9.d3HVLvv_LFw2QhPrhvjH_kICWQJX9sKKt7NjQEqI_xE2JO_b7D8rPsFTZz93PLvZ7MhCmudTjGImUpd-ehFnI4Go-1S7BGaKaHFILvP-sWy18Wpikowjxx9mSbzBM_cO6D1LI-kyYhXKWHgVdADfVIPniTDA7-ffhUpi7cAebEs'], + 'expires_in' => ['description' => '多长时间失效，比如7200秒（2个小时）', 'type' => 'integer', 'format' => 'int64', 'example' => '7200'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"revision_name\\": \\"\\",\\n \\"revision_version\\": 0,\\n \\"size\\": 0,\\n \\"file_extension\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"keep_forever\\": true,\\n \\"revision_description\\": \\"\\",\\n \\"is_latest_version\\": true,\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\"\\n}","type":"json"}]', - 'title' => '更新版本信息', - ], - 'RestoreRevision' => [ - 'summary' => '将文件的某个历史版本，还原为文件的最新版本，还原时生成一个新版本，被还原的版本不变。不支持还原最新版本。', - 'path' => '/v2/file/revision/restore', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '获取分享令牌', + 'summary' => '匿名获取分享令牌。', + 'description' => '文件分享中文件访问流程要求必须先获取share token，即使此分享的share_pwd=""(非私密分享)。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"share_token\\": \\"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJjOWI3YTVhYTA0ZDE0YWUzODY3ZmRjODg2ZmEwMWRhNCIsImN1c3RvbUpzb24iOiJ7XCJjbGllbnRJZFwiOlwiMjVkelgzdmJZcWt0Vnh5WFwiLFwiZG9tYWluSWRcIjpcImJqMjlcIixcInNjb3BlXCI6W1wiRFJJVkUuQUxMXCIsXCJTSEFSRS5BTExcIixcIkZJTEUuQUxMXCIsXCJVU0VSLkFMTFwiLFwiVklFVy5BTExcIixcIlNUT1JBR0UuQUxMXCIsXCJTVE9SQUdFRklMRS5MSVNUXCIsXCJCQVRDSFwiLFwiT0FVVEguQUxMXCIsXCJJTUFHRS5BTExcIixcIklOVklURS5BTExcIixcIkFDQ09VTlQuQUxMXCJdLFwicm9sZVwiOlwidXNlclwiLFwicmVmXCI6XCJodHRwczovL3d3dy5hbGl5dW5kcml2ZS5jb20vXCIsXCJkZXZpY2VfaWRcIjpcImIyODIwNWU1YzU5NzRjY2JiODI3MDNiNjhkYjhjNDUxXCJ9IiwiZXhwIjoxNjQ4NjE0NDkzLCJpYXQiOjE2NDg2MDcyMzN9.d3HVLvv_LFw2QhPrhvjH_kICWQJX9sKKt7NjQEqI_xE2JO_b7D8rPsFTZz93PLvZ7MhCmudTjGImUpd-ehFnI4Go-1S7BGaKaHFILvP-sWy18Wpikowjxx9mSbzBM_cO6D1LI-kyYhXKWHgVdADfVIPniTDA7-ffhUpi7cAebEs\\",\\n \\"expires_in\\": 7200\\n}","type":"json"}]', + ], + 'GetStory' => [ + 'summary' => '获取指定故事详情，包含封面、文件列表等。', + 'path' => '/v2/image/get_story', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -13358,50 +5317,35 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => 'A short description of struct', - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求体参数', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - 'revision_id' => [ - 'description' => '版本 id', - 'type' => 'string', - 'required' => true, - 'example' => '40CB7794C929', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'story_id' => ['description' => '故事 id', 'type' => 'string', 'required' => true, 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003'], + 'cover_image_thumbnail_process' => ['description' => '图片封面缩略图控制参数', 'type' => 'string', 'deprecated' => true, 'required' => false, 'example' => 'image/resize,m_fill,h_128,w_128,limit_0/format,jpg'], + 'cover_video_thumbnail_process' => ['description' => '视频封面缩略图控制参数', 'type' => 'string', 'deprecated' => true, 'required' => false, 'example' => 'video/snapshot,t_1000,f_jpg,w_0,h_0,m_fast,ar_auto'], + 'image_url_process' => ['description' => '故事文件图片URL控制参数', 'type' => 'string', 'deprecated' => true, 'required' => false, 'example' => 'image/resize,m_fill,h_128,w_128,limit_0/format,jpg'], + 'image_thumbnail_process' => ['description' => '故事文件图片缩略图控制参数', 'type' => 'string', 'deprecated' => true, 'required' => false, 'example' => 'image/resize,m_fill,h_128,w_128,limit_0/format,jpg'], + 'video_thumbnail_process' => ['description' => '故事文件视频缩略图控制参数', 'type' => 'string', 'deprecated' => true, 'required' => false, 'example' => 'video/snapshot,t_1000,f_jpg,w_0,h_0,m_fast,ar_auto'], + 'url_expire_sec' => ['description' => '缩略图过期时间。单位为秒，最短 10 秒，最长 86400 秒'."\n" + ."\n" + .'默认15分钟。', 'type' => 'integer', 'format' => 'int64', 'deprecated' => true, 'required' => false, 'maximum' => '86400', 'minimum' => '10', 'example' => '900', 'default' => '900'], ], 'required' => false, ], @@ -13409,27 +5353,27 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'description' => '版本信息', - '$ref' => '#/components/schemas/Revision', - ], + 'schema' => ['description' => '故事详情', '$ref' => '#/components/schemas/Story'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"revision_name\\": \\"\\",\\n \\"revision_version\\": 0,\\n \\"size\\": 0,\\n \\"file_extension\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"keep_forever\\": true,\\n \\"revision_description\\": \\"\\",\\n \\"is_latest_version\\": true,\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\"\\n}","type":"json"}]', - 'title' => '还原历史版本', - ], - 'ListRevision' => [ - 'summary' => '列举版本信息。', - 'path' => '/v2/file/revision/list', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '获取故事详情', + 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" + ."\n" + .'使用此功能须开通增值服务图片处理功能。'."\n" + ."\n" + .'用户传入指定故事的 id，以获取该故事的详情。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"story_id\\": \\"9132e0d8-fe92-4e56-86c3-f5f112308003\\",\\n \\"story_type\\": \\"PeopleMemory\\",\\n \\"story_sub_type\\": \\"Solo\\",\\n \\"story_name\\": \\"test_name\\",\\n \\"story_start_time\\": \\"2021-01-14T10:17:18.102700407+08:00\\",\\n \\"story_end_time\\": \\"2022-01-14T10:17:18.102700407+08:00\\",\\n \\"created_at\\": \\"2022-01-14T10:17:18.102700407+08:00\\",\\n \\"updated_at\\": \\"2022-01-14T10:17:18.102700407+08:00\\",\\n \\"face_group_ids\\": [\\n \\"Cluster-be377f73-3502-433c-8309-a01e659c128c\\"\\n ],\\n \\"cover_file_id\\": \\"63e5e4340f76cb3ead5f40f68163f0f967c1a7bf\\",\\n \\"cover_file_thumbnail_url\\": \\"https://pds-domain-bucket.oss-cn-hangzhou.aliyuncs.com/Bh1HqdAs%2F1001%2F642a88c26f99cad589904fc8a6b2db6021c6601f%2F642a88c29391c47f221e49e88a21fa9b0a9e5063?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5eGE8nGtYZ59bSnbUODlmsjTttVhpbFpjz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNXD6XXO2qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABVgD3mIAeUoDYKTJrFTPdmAPIrlUUQ1HZstB0ZVHvYByygr3oeitG9FEQ8lcfaZYJOtWRchdgH8tsSwHj2jI1vMeAiLHgbW98SPA3yfN8OR1kLW73uq3LAvekc9Qldz33YTM4JA5MNJzR8x5O6Oe4rY5OMSSVU5F%2Ffr8bJZD%2FXMM%3D&x-oss-access-key-id=STS.NT3XsrXYXBvLoe2rkvBTyiSnD&x-oss-expires=1685966251&x-oss-process=image%2Fresize%2Cw_500&x-oss-signature=XimW6haBxYktKg4cstMfpd%2F2LSoMibj6A%2B7ZqBJcSbQ%3D&x-oss-signature-version=OSS2\\",\\n \\"story_file_list\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"5d79206586bb5dd69fb34c349282718146c55da7\\",\\n \\"name\\": \\"1.mov\\",\\n \\"type\\": \\"file\\",\\n \\"content_type\\": \\"application/json\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"image file\\",\\n \\"trashed_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"file_extension\\": \\"txt\\",\\n \\"hidden\\": false,\\n \\"size\\": 1024,\\n \\"starred\\": false,\\n \\"status\\": \\"available\\",\\n \\"labels\\": [\\n \\"[\\\\\\"label1:1\\\\\\", \\\\\\"label2:2\\\\\\"]\\"\\n ],\\n \\"upload_id\\": \\"C9DCFE5A82644AC7A02DB74C30C934A6\\",\\n \\"parent_file_id\\": \\"3d5b846942cf94fa72324c8a4bda34e81da635a\\",\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"category\\": \\"image\\",\\n \\"local_created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"local_modified_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"revision_id\\": \\"5d5b846942cf94fa72324c14a4bda34e81da635d\\",\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\\\\\"128X128\\\\\\": \\\\\\"https://url1\\\\\\", \\\\\\"800X800\\\\\\": \\\\\\"url2\\\\\\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1024,\\n \\"height\\": 1024,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"sport\\",\\n \\"name\\": \\"basketball\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"play basketball\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\\\\\"k1\\\\\\":\\\\\\"v1\\\\\\", \\\\\\"k2\\\\\\",\\\\\\"v2\\\\\\"\\"\\n },\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"id_path\\": \\"id1/id2\\",\\n \\"name_path\\": \\"root/f1/f2\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 1,\\n \\"file_count\\": 10\\n },\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"auto_delete_left_sec\\": 0\\n }\\n ],\\n \\"custom_id\\": \\"test\\",\\n \\"custom_labels\\": {\\n \\"key\\": \\"value\\"\\n }\\n}","type":"json"}]', + ], + 'GetTaskStatus' => [ + 'path' => '/v2/image/get_task_status', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -13438,73 +5382,27 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, + 'systemTags' => ['operationType' => 'get', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => 'A short description of struct', - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求体参数', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - ."\n" - .'默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => '40CB7794C929', - ], - 'limit' => [ - 'description' => '限定此次返回资源的数量，取值范围\\[1,100\\]。'."\n" - ."\n" - .'默认值为50'."\n" - ."\n" - .'返回结果可以小于指定的数量，但不能多于指定的数量。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'maximum' => '200', - 'minimum' => '1', - 'example' => '100', - ], - 'fields' => [ - 'description' => '筛选返回字段'."\n" - ."\n" - .'默认为空。当填 * 时，返回所有字段，会比为空时多返回创建者名称。', - 'type' => 'string', - 'required' => false, - 'example' => '*', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'task_id' => ['description' => '任务 id', 'type' => 'string', 'required' => true, 'example' => 'i:SimilarImageClustering-b67d53e7-2fe8-460f-9b95-1e93636923eb'], ], 'required' => false, ], @@ -13514,66 +5412,59 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '返回参数', 'type' => 'object', 'properties' => [ - 'items' => [ - 'description' => '版本信息数组', - 'type' => 'array', - 'items' => [ - 'description' => '版本信息', - '$ref' => '#/components/schemas/Revision', - ], - ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空', + 'status' => [ + 'description' => '任务状态', 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', + 'required' => false, + 'enumValueTitles' => ['running' => '运行中', 'failed' => '失败', 'succeeded' => '成功'], + 'example' => 'running', + 'enum' => ['running', 'succeeded', 'failed'], ], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"revision_name\\": \\"\\",\\n \\"revision_version\\": 0,\\n \\"size\\": 0,\\n \\"file_extension\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"keep_forever\\": true,\\n \\"revision_description\\": \\"\\",\\n \\"is_latest_version\\": true,\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', - 'title' => '列举版本', - ], - 'GetRevision' => [ - 'summary' => '获取版本详情。', - 'path' => '/v2/file/revision/get', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '查询任务状态', + 'summary' => '查询增值服务异步任务执行状态。'."\n" + .'目前支持的接口有：CreateSimilarImageClusterTask。', + 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" + ."\n" + .'使用此功能须开通增值服务图片处理功能。'."\n" + ."\n" + .'该接口旨在查询增值服务异步任务状态，调用该接口前需先创建增值服务异步任务，如 CreateSimilarImageClusterTask，拿到 task id，再查询任务运行状态，判断该任务是否运行成功。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": \\"running\\"\\n}","type":"json"}]', + ], + 'GetUploadUrl' => [ + 'summary' => '获取上传地址。', + 'path' => '/v2/file/get_upload_url', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'BearerToken' => [], + 'AK' => [], ], [ - 'AK' => [], + 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, + 'systemTags' => ['operationType' => 'none'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => 'A short description of struct', - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -13583,40 +5474,52 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - 'revision_id' => [ - 'description' => '版本 id', - 'type' => 'string', + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'share_id' => ['description' => '分享id', 'type' => 'string', 'required' => false, 'example' => '7JQX1FswpQ8'], + 'file_id' => ['description' => '文件id', 'type' => 'string', 'required' => true, 'example' => '5d5b846942cf94fa72324c14a4bda34e81da635d'], + 'upload_id' => ['description' => '上传 id', 'type' => 'string', 'required' => true, 'example' => '10166D06127B413BA1EC8ABB1144D111'], + 'part_info_list' => [ + 'description' => '分片信息列表', + 'type' => 'array', + 'items' => [ + 'description' => '分片信息', + 'type' => 'object', + 'properties' => [ + 'part_number' => ['description' => '段编号', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '1'], + 'parallel_sha1_ctx' => [ + 'description' => '该分片前所有数据的SHA1上下文，该字段只在多分片并发上传的模式下有效', + 'type' => 'object', + 'properties' => [ + 'h' => [ + 'description' => '该分片前所有数据的SHA1上下文的第1-5个32位变量，该字段只在多分片并发上传的模式下有效', + 'type' => 'array', + 'items' => ['description' => '该分片前所有数据的SHA1上下文的第1-5个32位变量', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1'], + 'required' => false, + ], + 'part_offset' => ['description' => '到上一个数据块为止的总长度，单位为字节，需要为64的倍数，该字段只在多分片并发上传的模式下有效', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '10240'], + ], + 'required' => false, + ], + 'content_md5' => ['type' => 'string', 'required' => false, 'description' => ''], + 'content_type' => ['type' => 'string', 'required' => false, 'description' => ''], + 'parallel_sha256_ctx' => [ + 'type' => 'object', + 'properties' => [ + 'h' => [ + 'type' => 'array', + 'items' => ['type' => 'integer', 'format' => 'int64', 'required' => false, 'description' => ''], + 'required' => false, + 'description' => '', + ], + 'part_offset' => ['type' => 'integer', 'format' => 'int64', 'required' => false, 'description' => ''], + ], + 'required' => false, + 'description' => '', + ], + ], + 'required' => false, + ], 'required' => true, - 'example' => '40CB7794C929', - ], - 'url_expire_sec' => [ - 'description' => '过期时间，单位为秒，最短 10 秒，最长 86400 秒'."\n" - ."\n" - .'默认15分钟。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '900', - ], - 'fields' => [ - 'description' => '筛选返回字段'."\n" - ."\n" - .'默认为空。当填 * 时，返回所有字段，会比为空时多返回创建者名称', - 'type' => 'string', - 'required' => false, - 'example' => '*', ], ], 'required' => false, @@ -13626,111 +5529,63 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => '版本信息', - '$ref' => '#/components/schemas/Revision', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'domain_id' => ['title' => 'Id of the request', 'description' => '域id', 'type' => 'string', 'example' => 'bj1'], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'example' => '1'], + 'file_id' => ['description' => '文件id', 'type' => 'string', 'example' => '5d5b846942cf94fa72324c14a4bda34e81da635d'], + 'upload_id' => ['description' => '上传id', 'type' => 'string', 'example' => '10166D06127B413BA1EC8ABB1144D111'], + 'create_at' => ['description' => '创建时间', 'type' => 'string', 'example' => '2019-09-11T16:34:36.977Z'], + 'part_info_list' => [ + 'description' => '分段信息列表', + 'type' => 'array', + 'items' => ['description' => '分段信息', '$ref' => '#/components/schemas/UploadPartInfo'], + ], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"revision_name\\": \\"\\",\\n \\"revision_version\\": 0,\\n \\"size\\": 0,\\n \\"file_extension\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"keep_forever\\": true,\\n \\"revision_description\\": \\"\\",\\n \\"is_latest_version\\": true,\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\"\\n}","type":"json"}]', - 'title' => '获取版本信息', - ], - 'ScanFile' => [ - 'summary' => '扫描文件。', - 'path' => '/v2/file/scan', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '获取上传地址', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"5d5b846942cf94fa72324c14a4bda34e81da635d\\",\\n \\"upload_id\\": \\"10166D06127B413BA1EC8ABB1144D111\\",\\n \\"create_at\\": \\"2019-09-11T16:34:36.977Z\\",\\n \\"part_info_list\\": [\\n {\\n \\"part_number\\": 1,\\n \\"part_size\\": 1024,\\n \\"upload_url\\": \\"https://data.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661\\",\\n \\"internal_upload_url\\": \\"https://data-vpc.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661\\\\n\\",\\n \\"etag\\": \\"\\\\\\"0CC175B9C0F1B6A831C399E269772661\\\\\\"\\",\\n \\"parallel_sha1_ctx\\": {\\n \\"h\\": [\\n 0\\n ],\\n \\"part_offset\\": 10240\\n },\\n \\"upload_form_info\\": {\\n \\"endpoint\\": \\"\\",\\n \\"form_data\\": {\\n \\"key\\": \\"\\"\\n }\\n },\\n \\"parallel_sha256_ctx\\": {\\n \\"h\\": [\\n 0\\n ],\\n \\"part_offset\\": 0\\n }\\n }\\n ]\\n}","type":"json"}]', + ], + 'GetUser' => [ + 'path' => '/v2/user/get', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ + 'AK' => [], + ], + [ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'limit' => [ - 'description' => '限定此次返回资源的数量，取值范围\\[1,100\\]。'."\n" - ."\n" - .'返回结果可以小于指定的数量，但不能多于指定的数量。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '100', - 'minimum' => '1', - 'example' => '50', - 'default' => '50', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'<br>默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'fields' => [ - 'title' => 'scan file 想要获取的文件属性，'."\n" - .'1. 如果想要获取所有属性使用‘*’，'."\n" - .' 2.不传默认返回以下属性：'."\n" - .' file_id, drive_id, parent_file_id, type,'."\n" - .' created_at, updated_at, file_extention, size, starred, status,deleting, category, permissions'."\n" - .' 3 用户也可以指定属性进行返回，多个属性之间用，隔开'."\n" - .' '."\n", - 'description' => 'scan file 想要获取的文件属性。'."\n" - .'- 如果想要获取所有属性使用‘*’。'."\n" - .'- 不传默认返回以下属性：'."\n" - .' - file_id, '."\n" - .' - drive_id, '."\n" - .' - parent_file_id, '."\n" - .' - type, '."\n" - .' - created_at, '."\n" - .' - updated_at, '."\n" - .' - file_extention, '."\n" - .' - size, '."\n" - .' - starred, '."\n" - .' - status,'."\n" - .' - category, '."\n" - .' - permissions。'."\n" - .'- 用户也可以指定属性进行返回，多个属性之间用\',\'隔开。', - 'type' => 'string', - 'required' => false, - 'example' => '*', - ], + 'user_id' => ['description' => '用户id。'."\n" + .'使用AK方式访问时，该项必传；使用AccessToken方式访问时，该项不填写，取自己的用户信息。', 'type' => 'string', 'required' => false, 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4'], ], 'required' => false, ], @@ -13738,106 +5593,74 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'items' => [ - 'description' => '文件列表', - 'type' => 'array', - 'items' => [ - 'description' => '文件信息', - '$ref' => '#/components/schemas/File', - ], - ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空。', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - ], - ], + 'schema' => ['description' => '用户信息', '$ref' => '#/components/schemas/User'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"name\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"content_type\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"trashed_at\\": \\"\\",\\n \\"file_extension\\": \\"\\",\\n \\"mime_type\\": \\"\\",\\n \\"mime_extension\\": \\"\\",\\n \\"hidden\\": true,\\n \\"size\\": 0,\\n \\"starred\\": true,\\n \\"status\\": \\"\\",\\n \\"user_meta\\": \\"\\",\\n \\"labels\\": [\\n \\"\\"\\n ],\\n \\"upload_id\\": \\"\\",\\n \\"parent_file_id\\": \\"\\",\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"category\\": \\"\\",\\n \\"local_created_at\\": \\"\\",\\n \\"local_modified_at\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"investigation_info\\": {\\n \\"status\\": 0,\\n \\"suggestion\\": \\"\\"\\n },\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"运动\\",\\n \\"name\\": \\"篮球\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"一起打篮球\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"ex_fields_info\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"content_uri\\": \\"\\",\\n \\"streams_info\\": {\\n \\"key\\": {\\n \\"crc64_hash\\": \\"\\",\\n \\"size\\": 0,\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"thumbnail\\": \\"\\"\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"revision_version\\": 0,\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"punish_flag\\": 0,\\n \\"id_path\\": \\"\\",\\n \\"name_path\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\",\\n \\"last_modifier_type\\": \\"\\",\\n \\"last_modifier_id\\": \\"\\",\\n \\"last_modifier_name\\": \\"\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 0,\\n \\"file_count\\": 0\\n },\\n \\"trashed\\": true,\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"location\\": \\"\\",\\n \\"semantic_result\\": {\\n \\"semantic_similarity\\": 0.879,\\n \\"document_contents\\": [\\n {\\n \\"element_contents\\": [\\n {\\n \\"type\\": \\"text\\",\\n \\"content\\": \\"文本片段\\",\\n \\"url\\": \\"http://aliyun.com\\",\\n \\"time_range\\": [\\n 0\\n ]\\n }\\n ]\\n }\\n ],\\n \\"scene_contents\\": [\\n {\\n \\"time_range\\": [\\n 0\\n ],\\n \\"key_frames\\": [\\n {\\n \\"frame_time\\": 1000,\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ],\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ]\\n },\\n \\"sync_flag\\": true,\\n \\"sync_device_flag\\": true,\\n \\"origin_parent_file_id\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"custom_field_1\\": \\"\\",\\n \\"custom_field_2\\": \\"\\",\\n \\"auto_delete_left_sec\\": 0,\\n \\"ai_processed\\": \\"\\",\\n \\"modified_at\\": \\"\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', - 'title' => '扫描文件', - ], - 'ListDelta' => [ - 'summary' => '列举增量信息。', - 'path' => '/v2/file/list_delta', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '获取用户信息', + 'summary' => '获取用户信息。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"user_id\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"avatar\\": \\"http://aa.com/1.jpg\\",\\n \\"created_at\\": 1639762579768,\\n \\"updated_at\\": 1639762579768,\\n \\"email\\": \\"a@aliyunpds.com\\",\\n \\"nick_name\\": \\"001\\",\\n \\"phone\\": \\"13900001111\\",\\n \\"role\\": \\"user\\",\\n \\"status\\": \\"enabled\\",\\n \\"user_name\\": \\"pds\\",\\n \\"description\\": \\"vipuser\\",\\n \\"default_drive_id\\": \\"1\\",\\n \\"user_data\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"creator\\": \\"user1\\"\\n}","type":"json"}]', + ], + 'GetVideoPreviewPlayInfo' => [ + 'path' => '/v2/file/get_video_preview_play_info', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'BearerToken' => [], ], + [ + 'AK' => [], + ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => false, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求body', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'title' => '云端Drive id'."\n", - 'description' => '空间id', + 'share_id' => ['description' => '分享id。'."\n" + .'如果通过分享操作文件，请携带`x-share-token` header鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。'."\n" + .'`share_id`和`drive_id`两者必须有一个字段赋值。', 'type' => 'string', 'required' => false, 'example' => '7JQX1FswpQ8'], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => false, 'example' => '1'], + 'file_id' => ['description' => '文件id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'category' => [ + 'description' => '所属分类。'."\n" + .'需要开通对应的转码功能，枚举如下：'."\n" + .'- live_transcoding（live边转边播）'."\n" + .'- quick_video（quick边转边播）'."\n" + .'- offline_audio（离线音频转码）'."\n" + .'- offline_video（离线视频转码）', 'type' => 'string', 'required' => true, - 'example' => '1', - ], - 'sync_root_id' => [ - 'title' => '如果是同步目录的增量信息，必须设置同步目录对应的云端根目录', - 'description' => '同步文件夹根节点文件id', - 'type' => 'string', - 'required' => false, - 'example' => '622fb09598ae66777c7040109a16f49381f6abe1', - ], - 'cursor' => [ - 'title' => '增量信息的起始游标', - 'description' => '游标', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'limit' => [ - 'title' => '获取增量信息的条数限制', - 'description' => '限定此次返回资源的数量，取值范围\\[0,100\\]，默认值为 100。'."\n" - ."\n" - .'返回结果可以小于指定的数量，但不能多于指定的数量。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '50', + 'enumValueTitles' => [], + 'example' => 'quick_video', ], + 'template_id' => ['description' => '清晰度模板id。'."\n" + .'填空表示取所有可用清晰度模板', 'type' => 'string', 'required' => false, 'example' => '264_480p'], + 'get_without_url' => ['description' => '是否不获取播放url。'."\n" + .'如果填true，只会获取转码元信息，并不会触发ts转码，返回的信息中没有播放url。否则会返回播放url，如果此template_id的视频还未转码，后台将触发器转码。'."\n" + .'转码会产生对应的增值服务费用', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'url_expire_sec' => ['description' => 'url超时时间，单位：秒。'."\n" + .'默认15分钟，最大4小时。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '3600'], + 're_transcode' => ['description' => '是否发起重转。设置为 true 时会对文件发起重转，固定响应 202 等待重试。使用该参数前请先联系我们配置开启支持。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'get_master_url' => ['description' => '是否获取 master m3u8 的 url，仅在 category = quick_video 时有效', 'type' => 'boolean', 'required' => false, 'example' => 'false'], ], 'required' => false, ], @@ -13850,89 +5673,64 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'items' => [ - 'description' => '增量信息列表', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'file_id' => [ - 'title' => '文件唯一id', - 'description' => '文件id', - 'type' => 'string', - 'example' => '122fb09598ae66777c7040109a16f49381f6abe2', - ], - 'op' => [ - 'title' => '文件操作，主要包括', - 'description' => '执行的操作。具体包括以下操作：'."\n" - .'- create'."\n" - .'- overwrite'."\n" - .'- delete'."\n" - .'- update'."\n" - .'- move'."\n" - .'- trash'."\n" - .'- restore'."\n" - .'- rename', - 'type' => 'string', - 'enumValueTitles' => [], - 'example' => 'create', - ], - 'file' => [ - 'description' => '涉及的文件信息', - '$ref' => '#/components/schemas/File', - ], - ], - ], - ], - 'has_more' => [ - 'description' => '是否还有更多信息。', - 'type' => 'boolean', - 'example' => 'true', - ], - 'cursor' => [ - 'description' => '游标', - 'type' => 'string', - 'example' => '1WQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], + 'domain_id' => ['description' => '域id', 'type' => 'string', 'example' => 'bj1'], + 'share_id' => ['title' => 'Id of the request', 'description' => '分享id', 'type' => 'string', 'example' => '7JQX1FswpQ8'], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'example' => '1'], + 'file_id' => ['description' => '文件id', 'type' => 'string', 'example' => 'fileid1'], + 'video_preview_play_info' => ['description' => '播放信息', '$ref' => '#/components/schemas/VideoPreviewPlayInfo'], ], ], ], ], - 'responseDemo' => '[{"type":"json","example":"{\\n \\"items\\": [\\n {\\n \\"file_id\\": \\"122fb09598ae66777c7040109a16f49381f6abe2\\",\\n \\"op\\": \\"create\\",\\n \\"file\\": {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"name\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"content_type\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"trashed_at\\": \\"\\",\\n \\"file_extension\\": \\"\\",\\n \\"mime_type\\": \\"\\",\\n \\"mime_extension\\": \\"\\",\\n \\"hidden\\": true,\\n \\"size\\": 0,\\n \\"starred\\": true,\\n \\"status\\": \\"\\",\\n \\"user_meta\\": \\"\\",\\n \\"labels\\": [\\n \\"\\"\\n ],\\n \\"upload_id\\": \\"\\",\\n \\"parent_file_id\\": \\"\\",\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"category\\": \\"\\",\\n \\"local_created_at\\": \\"\\",\\n \\"local_modified_at\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"investigation_info\\": {\\n \\"status\\": 0,\\n \\"suggestion\\": \\"\\"\\n },\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"运动\\",\\n \\"name\\": \\"篮球\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"一起打篮球\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"ex_fields_info\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"content_uri\\": \\"\\",\\n \\"streams_info\\": {\\n \\"key\\": {\\n \\"crc64_hash\\": \\"\\",\\n \\"size\\": 0,\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"thumbnail\\": \\"\\"\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"revision_version\\": 0,\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"punish_flag\\": 0,\\n \\"id_path\\": \\"\\",\\n \\"name_path\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\",\\n \\"last_modifier_type\\": \\"\\",\\n \\"last_modifier_id\\": \\"\\",\\n \\"last_modifier_name\\": \\"\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 0,\\n \\"file_count\\": 0\\n },\\n \\"trashed\\": true,\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"location\\": \\"\\",\\n \\"semantic_result\\": {\\n \\"semantic_similarity\\": 0.879,\\n \\"document_contents\\": [\\n {\\n \\"element_contents\\": [\\n {\\n \\"type\\": \\"text\\",\\n \\"content\\": \\"文本片段\\",\\n \\"url\\": \\"http://aliyun.com\\",\\n \\"time_range\\": [\\n 0\\n ]\\n }\\n ]\\n }\\n ],\\n \\"scene_contents\\": [\\n {\\n \\"time_range\\": [\\n 0\\n ],\\n \\"key_frames\\": [\\n {\\n \\"frame_time\\": 1000,\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ],\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ]\\n },\\n \\"sync_flag\\": true,\\n \\"sync_device_flag\\": true,\\n \\"origin_parent_file_id\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"custom_field_1\\": \\"\\",\\n \\"custom_field_2\\": \\"\\",\\n \\"auto_delete_left_sec\\": 0,\\n \\"ai_processed\\": \\"\\",\\n \\"modified_at\\": \\"\\"\\n }\\n }\\n ],\\n \\"has_more\\": true,\\n \\"cursor\\": \\"1WQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","errorExample":""},{"type":"xml","example":"<ListDeltaResponse>\\n <items>\\n <file_id>122fb09598ae66777c7040109a16f49381f6abe2</file_id>\\n <op>create</op>\\n <file/>\\n </items>\\n <has_more>true</has_more>\\n <cursor>1WQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg</cursor>\\n</ListDeltaResponse>","errorExample":""}]', - 'title' => '列举增量信息', - ], - 'DeltaGetLastCursor' => [ - 'summary' => '获取增量操作游标。', - 'path' => '/v2/file/get_last_cursor', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'tags' => [ - 'api', + 'title' => '获取视频播放信息', + 'summary' => '获取视频播放信息。', + 'description' => '- **请确保在使用该接口前，已充分了解网盘与相册服务产品的收费方式和[价格](~~425220~~)。**'."\n" + ."\n" + .'- 调用该接口前，请确保当前 domain 已开通对应 category 的转码功能。转码功能开通和转码模板配置请联系我们的技术支持，详情参考[联系我们](~~175917~~)。'."\n" + ."\n" + .'- 该接口为同步接口。如果请求时对应文件在对应转码方式上尚未转码，则接口会响应 **202 VideoPreviewWaitAndRetry** 提示等待重试。如果请求时对应文件在对应转码方式上无法转码，则接口会响应 **404 NotFound.VideoPreviewInfo**。'."\n" + ."\n" + .'- 该接口会产生转码数据并保存到租户 domain 的增值数据空间，以供最终用户进行音视频在线播放。对于特定的转码方式，该接口提供了 domain 级去重转码能力。'."\n" + ."\n" + .'- 该接口返回的播放链接在转码类型为 quick_video 时，将包含未进行 URL 编码的 `{ `和` }`字符。IOS 平台开发时请注意先对返回链接进行 URL 解码和编码以避免系统 NSURL 库解码失败。'."\n" + ."\n" + .'- 该接口返回的播放链接在转码类型为 quick_video 时，根据链接对应 m3u8 内容获取分片内容时将不支持 Range Get。'."\n" + ."\n" + .'<props="china">更多详细内容请参考最佳实践文档：[在线预览视频](~~427477~~)。</props>', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"share_id\\": \\"7JQX1FswpQ8\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"fileid1\\",\\n \\"video_preview_play_info\\": {\\n \\"category\\": \\"quick_video\\",\\n \\"meta\\": {\\n \\"duration\\": 4.2898,\\n \\"width\\": 1920,\\n \\"height\\": 1080\\n },\\n \\"live_transcoding_task_list\\": [\\n {\\n \\"template_id\\": \\"264_480p\\",\\n \\"status\\": \\"finished\\",\\n \\"url\\": \\"https://example.data.aliyunpds.com/lt/xxx/media.m3u8\\",\\n \\"keep_original_resolution\\": true,\\n \\"preview_url\\": \\"https://example.data.aliyunpds.com/lt/xxx/ref_task.m3u8\\"\\n }\\n ],\\n \\"quick_video_list\\": [\\n {\\n \\"template_id\\": \\"264_480p\\",\\n \\"status\\": \\"finished\\",\\n \\"url\\": \\"https://example.data.aliyunpds.com/qv/xxx/media.m3u8\\",\\n \\"preview_url\\": \\"https://example.data.aliyunpds.com/qv/xxx/ref_task.m3u8\\"\\n }\\n ],\\n \\"offline_video_transcoding_list\\": [\\n {\\n \\"template_id\\": \\"264_1080p\\",\\n \\"status\\": \\"finished\\",\\n \\"keep_original_resolution\\": true,\\n \\"url\\": \\"https://example.data.aliyunpds.com/xxx/master.mp4\\\\n\\"\\n }\\n ],\\n \\"live_transcoding_subtitle_task_list\\": [\\n {\\n \\"language\\": \\"en\\",\\n \\"status\\": \\"finished\\",\\n \\"url\\": \\"https://example.data.aliyunpds.com/lt/A05EF408DAB5D3F57C94F67658C99C406EFCA7DD/subtitle/subtitle_0.vtt\\"\\n }\\n ],\\n \\"quick_video_subtitle_list\\": [\\n {\\n \\"language\\": \\"en\\",\\n \\"status\\": \\"finished\\",\\n \\"url\\": \\"https://example.data.aliyunpds.com/lt/A05EF408DAB5D3F57C94F67658C99C406EFCA7DD/subtitle/subtitle_0.vtt\\"\\n }\\n ],\\n \\"offline_video_transcoding_subtitle_list\\": [\\n {\\n \\"language\\": \\"en\\",\\n \\"status\\": \\"finished\\",\\n \\"url\\": \\"https://example.data.aliyunpds.com/lt/A05EF408DAB5D3F57C94F67658C99C406EFCA7DD/subtitle/subtitle_0.vtt\\"\\n }\\n ],\\n \\"master_url\\": \\"https://pds-xxx-valueadd.oss-xxx.aliyuncs.com/qv/xxx/master.m3u8\\"\\n }\\n}","type":"json"}]', + ], + 'GetVideoPreviewPlayMeta' => [ + 'summary' => '获取视频播放元信息。', + 'path' => '/v2/file/get_video_preview_play_meta', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ + 'AK' => [], + ], + [ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'readAndWrite', 'deprecated' => false, + 'systemTags' => ['operationType' => 'none'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => false, 'description' => ''], ], [ 'name' => 'body', @@ -13942,20 +5740,17 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'title' => '云端 drive id', - 'description' => '空间id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'sync_root_id' => [ - 'title' => '同步目录的对应的云端跟目录', - 'description' => '同步文件夹根节点文件id', - 'type' => 'string', - 'required' => false, - 'example' => '622fb09598ae66777c7040109a16f49381f6abe1', - ], + 'share_id' => ['description' => '分享id。'."\n" + .'如果通过分享操作文件，请携带`x-share-token` header鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。'."\n" + .'`share_id`和`drive_id`两者必须有一个字段赋值。', 'type' => 'string', 'required' => false, 'example' => '7JQX1FswpQ8'], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => false, 'example' => '1'], + 'file_id' => ['description' => '文件id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'category' => ['description' => '所属分类。'."\n" + .'需要开通对应的转码功能，枚举如下：'."\n" + .'- live_transcoding（live边转边播）'."\n" + .'- quick_video（quick边转边播）'."\n" + .'- offline_audio（离线音频转码）'."\n" + .'- offline_video（离线视频转码）', 'type' => 'string', 'required' => true, 'example' => 'live_transcoding'], ], 'required' => false, ], @@ -13968,176 +5763,129 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'cursor' => [ - 'title' => '当前增量变化的最新游标', - 'description' => '指定drive或者指定同步目录下增量信息的最新游标', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], + 'domain_id' => ['title' => 'Id of the request', 'description' => '域id', 'type' => 'string', 'example' => 'bj1'], + 'share_id' => ['description' => '分享id', 'type' => 'string', 'example' => '7JQX1FswpQ8'], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'example' => '1'], + 'file_id' => ['description' => '文件id', 'type' => 'string', 'example' => 'fileid1'], + 'video_preview_play_meta' => ['description' => '播放元信息', '$ref' => '#/components/schemas/VideoPreviewPlayMeta'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"cursor\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', - 'title' => '获取增量操作游标', - ], - 'ListReceivedFile' => [ - 'summary' => '收到的共享， 可通过此接口获取到从个人空间授权给此用户的文件列表。', - 'path' => '/v2/file/list_received_file', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '获取视频播放元信息', + 'description' => '<props="china">详细请参考最佳实践文档：[在线预览视频](~~427477~~)。</props>', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"share_id\\": \\"7JQX1FswpQ8\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"fileid1\\",\\n \\"video_preview_play_meta\\": {\\n \\"meta\\": {\\n \\"duration\\": 10,\\n \\"width\\": 1280,\\n \\"height\\": 720\\n },\\n \\"live_transcoding_task_list\\": [\\n {\\n \\"template_id\\": \\"264_720p\\",\\n \\"status\\": \\"finished\\",\\n \\"keep_original_resolution\\": true\\n }\\n ],\\n \\"category\\": \\"live_transcoding\\",\\n \\"quick_video_list\\": [\\n {\\n \\"template_id\\": \\"264_720p\\",\\n \\"status\\": \\"finished\\"\\n }\\n ],\\n \\"offline_video_transcoding_list\\": [\\n {\\n \\"template_id\\": \\"264_720p\\",\\n \\"status\\": \\"finished\\",\\n \\"keep_original_resolution\\": \\"true\\"\\n }\\n ]\\n }\\n}","type":"json"}]', + ], + 'GroupUpdateName' => [ + 'path' => '/v2/group/update_name', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'BearerToken' => [], ], + [ + 'AK' => [], + ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'read', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, + 'systemTags' => ['operationType' => 'update'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'limit' => [ - 'description' => '限定此次返回资源的数量。如果不设定，默认返回100，最大不能超过100。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '100', - ], - 'marker' => [ - 'description' => '设置此字段后，数据会从上次返回的位置开始继续返回。如果不设定，则从头开始返回数据。 默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'eym***', - ], + 'group_id' => ['type' => 'string', 'required' => true, 'description' => ''], + 'name' => ['type' => 'string', 'description' => ''], ], - 'required' => false, + 'description' => '', ], ], ], 'responses' => [ - 200 => [ - 'headers' => [], - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回结构体。', - 'type' => 'object', - 'properties' => [ - 'items' => [ - 'description' => '返回的文件列表', - 'type' => 'array', - 'items' => [ - 'description' => '返回的文件信息', - 'example' => ' ', - '$ref' => '#/components/schemas/File', - ], - ], - 'next_marker' => [ - 'description' => '本次返回记录的断点，可用于下次继续查询', - 'type' => 'string', - 'example' => 'eym***', - ], - ], - ], + 204 => [ + 'schema' => ['$ref' => '#/components/schemas/BaseGroupResponse', 'description' => ''], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'summary' => '更新用户组名字 ', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"name\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"content_type\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"trashed_at\\": \\"\\",\\n \\"file_extension\\": \\"\\",\\n \\"mime_type\\": \\"\\",\\n \\"mime_extension\\": \\"\\",\\n \\"hidden\\": true,\\n \\"size\\": 0,\\n \\"starred\\": true,\\n \\"status\\": \\"\\",\\n \\"user_meta\\": \\"\\",\\n \\"labels\\": [\\n \\"\\"\\n ],\\n \\"upload_id\\": \\"\\",\\n \\"parent_file_id\\": \\"\\",\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"category\\": \\"\\",\\n \\"local_created_at\\": \\"\\",\\n \\"local_modified_at\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"investigation_info\\": {\\n \\"status\\": 0,\\n \\"suggestion\\": \\"\\"\\n },\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"运动\\",\\n \\"name\\": \\"篮球\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"一起打篮球\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"ex_fields_info\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"content_uri\\": \\"\\",\\n \\"streams_info\\": {\\n \\"key\\": {\\n \\"crc64_hash\\": \\"\\",\\n \\"size\\": 0,\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"thumbnail\\": \\"\\"\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"revision_version\\": 0,\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"punish_flag\\": 0,\\n \\"id_path\\": \\"\\",\\n \\"name_path\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\",\\n \\"last_modifier_type\\": \\"\\",\\n \\"last_modifier_id\\": \\"\\",\\n \\"last_modifier_name\\": \\"\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 0,\\n \\"file_count\\": 0\\n },\\n \\"trashed\\": true,\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"location\\": \\"\\",\\n \\"semantic_result\\": {\\n \\"semantic_similarity\\": 0.879,\\n \\"document_contents\\": [\\n {\\n \\"element_contents\\": [\\n {\\n \\"type\\": \\"text\\",\\n \\"content\\": \\"文本片段\\",\\n \\"url\\": \\"http://aliyun.com\\",\\n \\"time_range\\": [\\n 0\\n ]\\n }\\n ]\\n }\\n ],\\n \\"scene_contents\\": [\\n {\\n \\"time_range\\": [\\n 0\\n ],\\n \\"key_frames\\": [\\n {\\n \\"frame_time\\": 1000,\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ],\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ]\\n },\\n \\"sync_flag\\": true,\\n \\"sync_device_flag\\": true,\\n \\"origin_parent_file_id\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"custom_field_1\\": \\"\\",\\n \\"custom_field_2\\": \\"\\",\\n \\"auto_delete_left_sec\\": 0,\\n \\"ai_processed\\": \\"\\",\\n \\"modified_at\\": \\"\\"\\n }\\n ],\\n \\"next_marker\\": \\"eym***\\"\\n}","type":"json"}]', - 'title' => '收到的共享文件夹列表', + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', ], - 'ListMyGroupDrive' => [ - 'summary' => '列举被授权的团队空间列表。', - 'path' => '/v2/drive/list_my_group_drive', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'ImportUser' => [ + 'path' => '/v2/user/import', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ + 'AK' => [], + ], + [ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'read', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - ], + 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => 'A short description of struct', - 'type' => 'string', - 'required' => false, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', - 'allowEmptyValue' => true, 'style' => 'json', 'schema' => [ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'limit' => [ - 'description' => '限定此次返回资源的数量。如果不设定，默认返回100，最大不能超过100。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '100', - ], - 'marker' => [ - 'description' => '设置此字段后，数据会从上次返回的位置开始继续返回。如果不设定，则从头开始返回数据。 默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'drive_name' => [ - 'type' => 'string', - 'required' => false, - ], + 'authentication_type' => ['description' => '认证类型'."\n" + ."\n" + .'- mobile：手机号'."\n" + ."\n" + .'- email：邮箱'."\n" + ."\n" + .'- ding：钉钉'."\n" + ."\n" + .'- ram：阿里云RAM子账号'."\n" + ."\n" + .'- wechat：企业微信'."\n" + ."\n" + .'- ldap：LDAP账号'."\n" + ."\n" + .'- custom：自定义账号', 'type' => 'string', 'required' => true, 'example' => 'mobile'], + 'identity' => ['description' => '唯一身份标识', 'type' => 'string', 'required' => true, 'example' => '130****'], + 'authentication_display_name' => ['description' => '认证方式的显示名称', 'type' => 'string', 'required' => false, 'example' => '10000'], + 'extra' => ['description' => '额外信息'."\n" + ."\n" + .'authentication\\_type为mobile时，此字段为国家编号，不填默认86。', 'type' => 'string', 'required' => false, 'example' => '1'], + 'nick_name' => ['description' => '昵称', 'type' => 'string', 'required' => true, 'example' => 'pdsuer'], + 'auto_create_drive' => ['description' => '自动创建空间', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + 'drive_total_size' => ['description' => '空间大小，不能小于-1，-1表示无限制', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '10240'], + 'parent_group_id' => ['description' => '加入到的分组id', 'type' => 'string', 'required' => false, 'example' => 'g12'], ], 'required' => false, ], @@ -14145,167 +5893,89 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回结构体。', - 'type' => 'object', - 'properties' => [ - 'items' => [ - 'description' => '返回的空间信息列表', - 'type' => 'array', - 'items' => [ - 'description' => '返回的空间信息', - '$ref' => '#/components/schemas/Drive', - ], - ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空。', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'root_group_drive' => [ - 'description' => '企业空间信息。', - '$ref' => '#/components/schemas/Drive', - ], - ], - ], + 'schema' => ['description' => '用户信息', '$ref' => '#/components/schemas/User'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '导入用户', + 'summary' => '导入用户。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"drive_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"owner\\": \\"\\",\\n \\"owner_type\\": \\"\\",\\n \\"drive_type\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"used_size\\": 0,\\n \\"total_size\\": 0,\\n \\"created_at\\": \\"\\",\\n \\"creator\\": \\"\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\",\\n \\"root_group_drive\\": {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"drive_name\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"owner\\": \\"\\",\\n \\"owner_type\\": \\"\\",\\n \\"drive_type\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"used_size\\": 0,\\n \\"total_size\\": 0,\\n \\"created_at\\": \\"\\",\\n \\"creator\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '收到的授权团队空间列表', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"user_id\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"avatar\\": \\"http://aa.com/1.jpg\\",\\n \\"created_at\\": 1639762579768,\\n \\"updated_at\\": 1639762579768,\\n \\"email\\": \\"a@aliyunpds.com\\",\\n \\"nick_name\\": \\"001\\",\\n \\"phone\\": \\"13900001111\\",\\n \\"role\\": \\"user\\",\\n \\"status\\": \\"enabled\\",\\n \\"user_name\\": \\"pds\\",\\n \\"description\\": \\"vipuser\\",\\n \\"default_drive_id\\": \\"1\\",\\n \\"user_data\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"creator\\": \\"user1\\"\\n}","type":"json"}]', ], - 'FileRemovePermission' => [ - 'summary' => '取消文件共享授权。', - 'path' => '/v2/file/remove_permission', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'InvestigateFile' => [ + 'summary' => '将未经审核的文件送审。', + 'path' => '/v2/csi/investigate_file', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'tags' => ['api'], 'security' => [ [ - 'BearerToken' => [], - ], - [ 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'readAndWrite', 'deprecated' => false, + 'systemTags' => ['operationType' => 'create', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求体。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件id', - 'type' => 'string', - 'required' => true, - 'example' => '4221bf6e6ab43c255edc4463bf3a6f5f5d317406', - ], - 'member_list' => [ - 'description' => '共享的用户对象集合', + 'drive_file_ids' => [ + 'description' => '空间和文件ID的组合，至多5个。', 'type' => 'array', 'items' => [ 'type' => 'object', 'properties' => [ - 'identity' => [ - 'description' => '可授权对象，表示一个用户或者一个群组', - 'required' => true, - '$ref' => '#/components/schemas/Identity', - ], - 'role_id' => [ - 'description' => '目前支持两种方式设置权限，一种是通过指定角色设置权限，另一种是自定义操作权限，此字段用于指定角色设置权限，与action\\_list互斥，当两个字段同时设置时，以此字段为准'."\n" - ."\n" - .'目前支持：'."\n" - ."\n" - .'SystemFileOwner（文件协同）'."\n" - ."\n" - .'SystemFileDownloader（下载者）'."\n" - ."\n" - .'SystemFileEditor（编辑者）'."\n" - ."\n" - .'SystemFileEditorWithoutDelete（无删除编辑者）'."\n" - ."\n" - .'SystemFileEditorWithoutShareLink（无分享编辑者）'."\n" - ."\n" - .'SystemFileMetaViewer（可见列表）'."\n" - ."\n" - .'SystemFileUploader（上传者）、SystemFileUploaderAndDownloader（上传/下载者）'."\n" - ."\n" - .'SystemFileDownloaderWithShareLink（下载/分享者）'."\n" - ."\n" - .'SystemFileUploaderAndDownloaderWithShareLink（上传/下载/分享者）'."\n" - ."\n" - .'SystemFileUploaderAndViewer（预览/上传者）'."\n" - ."\n" - .'SystemFileUploaderWithShareLink（上传/分享者）'."\n" - ."\n" - .'SystemFileViewer（预览者）', - 'type' => 'string', - 'required' => true, - 'example' => 'SystemFileDownloader', - ], + 'drive_id' => ['description' => '空间ID', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件ID', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], ], - 'required' => true, + 'required' => false, + 'description' => '', ], 'required' => true, ], ], - 'required' => true, + 'required' => false, ], ], ], 'responses' => [ - 204 => [ - 'headers' => [], + 202 => [ + 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [], + ], ], ], + 'title' => '审核文件', + 'description' => '可对图片和视频（不含音频）进行审核。动图、长图的截帧/切割频率为1，最多100张；视频的截帧频率为3秒，最多1500帧。审核结果可以通过列举文件、获取文件详情和获取文件内容安全详情接口查询以及使用事件通知功能推送。请勿使用此接口集中的批量送审文件，以免受资源限制导致审核失败。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '取消文件共享授权', ], - 'FileAddPermission' => [ - 'summary' => '文件夹授权。单Drive下最多可支持1000条授权记录，超出后授权不生效。', - 'path' => '/v2/file/add_permission', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'LinkAccount' => [ + 'path' => '/v2/account/link', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'BearerToken' => [], @@ -14314,22 +5984,14 @@ 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -14339,80 +6001,63 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件夹id， 当授权整个团队空间时，此字段填root。 个人空间共享不支持填root', - 'type' => 'string', - 'required' => true, - 'example' => '4221bf6e6ab43c255edc4463bf3a6f5f5d317406', - ], - 'member_list' => [ - 'description' => '被授权的成员列表', - 'type' => 'array', - 'items' => [ - 'description' => '授权信息', - 'required' => false, - '$ref' => '#/components/schemas/FilePermissionMember', - ], - 'required' => true, - ], + 'user_id' => ['description' => '待绑定的UserID', 'type' => 'string', 'required' => true, 'example' => 'xxx'], + 'type' => ['description' => '账号类型'."\n" + ."\n" + .'- mobile：手机号'."\n" + ."\n" + .'- email：邮箱'."\n" + ."\n" + .'- ding：钉钉'."\n" + ."\n" + .'- ram：阿里云RAM子账号'."\n" + ."\n" + .'- wechat：企业微信'."\n" + ."\n" + .'- ldap：LDAP账号'."\n" + ."\n" + .'- custom：自定义账号', 'type' => 'string', 'required' => true, 'example' => 'ding'], + 'identity' => ['description' => '账号的唯一标识，比如手机号', 'type' => 'string', 'required' => true, 'example' => 'eyy***'], + 'extra' => ['description' => '账号唯一标识的附加信息，比如当账号为手机号时，此字段填手机的区域编码，比如中国大陆为86，不填写默认为86', 'type' => 'string', 'required' => false, 'example' => '86'], ], 'required' => false, ], ], ], 'responses' => [ - 204 => [ + 200 => [ 'headers' => [], + 'schema' => ['description' => '返回用户的授权Token信息', '$ref' => '#/components/schemas/Token'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '文件共享授权给用户或组', - 'description' => '单Drive下最多可支持1000条授权记录，超出后授权不生效。', - ], - 'FileListPermission' => [ - 'summary' => '列举文件的共享或授权记录。', - 'path' => '/v2/file/list_permission', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '绑定账号', + 'summary' => '绑定账号。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'ListAddressGroups' => [ + 'path' => '/v2/image/list_address_groups', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'BearerToken' => [], + 'AK' => [], ], [ - 'AK' => [], + 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -14422,18 +6067,12 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件id', - 'type' => 'string', - 'required' => true, - 'example' => '4221bf6e6ab43a255edc4463bffa6f5f5d317401', - ], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'limit' => ['description' => '限定此次返回资源的数量。如果不设定，默认返回100，最大不能超过100。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '100'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'image_thumbnail_process' => ['description' => '图片缩略图处理样式', 'type' => 'string', 'required' => false, 'example' => 'image/resize,w_200'], + 'video_thumbnail_process' => ['description' => '视频缩略图处理样式', 'type' => 'string', 'required' => false, 'example' => 'video_thumbnail_process'], ], 'required' => false, ], @@ -14442,34 +6081,33 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => '文件权限信息列表', - 'type' => 'array', - 'items' => [ - 'description' => '文件权限信息', - '$ref' => '#/components/schemas/FilePermissionMember', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'items' => [ + 'description' => '地点聚类列表', + 'type' => 'array', + 'items' => ['description' => '地点聚类', '$ref' => '#/components/schemas/AddressGroup'], + ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空。', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], ], ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'title' => '列举地点聚类', + 'summary' => '列举地点聚类。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"[\\n {\\n \\"identity\\": {\\n \\"identity_type\\": \\"IT_User\\",\\n \\"identity_id\\": \\"\\"\\n },\\n \\"role_id\\": \\"\\",\\n \\"expire_time\\": 0,\\n \\"disinherit_sub_group\\": true,\\n \\"action_list\\": [\\n \\"\\"\\n ]\\n }\\n]","type":"json"}]', - 'title' => '列举文件的共享或授权记录', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"name\\": \\"\\",\\n \\"location\\": \\"30.12231,120.1212\\",\\n \\"count\\": 10,\\n \\"cover_url\\": \\"\\",\\n \\"cover_file_id\\": \\"\\",\\n \\"address_detail\\": {\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"余杭区\\",\\n \\"township\\": \\"文一西路\\"\\n }\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', ], 'ListAssignment' => [ - 'summary' => '列举已分配的角色列表。', 'path' => '/v2/role/list_assignment', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -14478,29 +6116,16 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => 'A short description of struct', - 'type' => 'string', - 'required' => false, - ], + 'schema' => ['title' => 'A short description of struct', 'description' => 'A short description of struct', 'type' => 'string', 'required' => false], ], [ 'name' => 'body', @@ -14511,40 +6136,19 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'manage_resource_type' => [ - 'description' => '管理的资源类型，目前支持：'."\n" - ."\n" - .'- RT\\_Group（群组）'."\n" - ."\n" - .'- RT\\_KnowledgeBase（知识库）'."\n" - ."\n" - .'- RT\\_KnowledgeCategory（知识分类）', - 'type' => 'string', - 'required' => true, - 'example' => 'RT_Group', - ], - 'manage_resource_id' => [ - 'description' => '管理的资源ID，比如群组的ID', - 'type' => 'string', - 'required' => true, - 'example' => '105***b82', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'limit' => [ - 'description' => '限定此次返回资源的数量，取值范围\\[1,100\\]。'."\n" - ."\n" - .'返回结果可以小于指定的数量，但不能多于指定的数量。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '50', - ], + 'manage_resource_type' => ['description' => '管理的资源类型，目前支持：'."\n" + ."\n" + .'- RT\\_Group（群组）'."\n" + ."\n" + .'- RT\\_KnowledgeBase（知识库）'."\n" + ."\n" + .'- RT\\_KnowledgeCategory（知识分类）', 'type' => 'string', 'required' => true, 'example' => 'RT_Group'], + 'manage_resource_id' => ['description' => '管理的资源ID，比如群组的ID', 'type' => 'string', 'required' => true, 'example' => '105***b82'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'limit' => ['description' => '限定此次返回资源的数量，取值范围\\[1,100\\]。'."\n" + ."\n" + .'返回结果可以小于指定的数量，但不能多于指定的数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '50'], ], 'required' => false, ], @@ -14563,224 +6167,159 @@ 'items' => [ 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'description' => '域id', - 'type' => 'string', - 'example' => 'hz1', - ], - 'identity' => [ - 'description' => '被授权的对象，表示一个用户或者一个群组', - '$ref' => '#/components/schemas/Identity', - ], - 'role_id' => [ - 'description' => '被授权的角色ID', - 'type' => 'string', - 'example' => 'SystemGroupAdmin', - ], - 'manage_resource_type' => [ - 'description' => '管理的资源类型，比如： RT_Group，表示群组类型', - 'type' => 'string', - 'example' => 'RT_Group', - ], - 'manage_resource_id' => [ - 'description' => '管理的资源ID，比如群组的ID', - 'type' => 'string', - 'example' => '105***b82', - ], - 'creator' => [ - 'description' => '创建者ID', - 'type' => 'string', - 'example' => '216***c83', - ], - 'created_at' => [ - 'description' => '创建时间，从1970年1月1日0点到当前的毫秒时间戳', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1622682267564', - ], + 'domain_id' => ['description' => '域id', 'type' => 'string', 'example' => 'hz1'], + 'identity' => ['description' => '被授权的对象，表示一个用户或者一个群组', '$ref' => '#/components/schemas/Identity'], + 'role_id' => ['description' => '被授权的角色ID', 'type' => 'string', 'example' => 'SystemGroupAdmin'], + 'manage_resource_type' => ['description' => '管理的资源类型，比如： RT_Group，表示群组类型', 'type' => 'string', 'example' => 'RT_Group'], + 'manage_resource_id' => ['description' => '管理的资源ID，比如群组的ID', 'type' => 'string', 'example' => '105***b82'], + 'creator' => ['description' => '创建者ID', 'type' => 'string', 'example' => '216***c83'], + 'created_at' => ['description' => '创建时间，从1970年1月1日0点到当前的毫秒时间戳', 'type' => 'integer', 'format' => 'int64', 'example' => '1622682267564'], ], + 'description' => '', ], ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空。', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空。', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], + 'staticInfo' => ['returnType' => 'synchronous'], 'eventInfo' => [ 'enable' => false, 'eventNames' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"assignment_list\\": [\\n {\\n \\"domain_id\\": \\"hz1\\",\\n \\"identity\\": {\\n \\"identity_type\\": \\"IT_User\\",\\n \\"identity_id\\": \\"\\"\\n },\\n \\"role_id\\": \\"SystemGroupAdmin\\",\\n \\"manage_resource_type\\": \\"RT_Group\\",\\n \\"manage_resource_id\\": \\"105***b82\\",\\n \\"creator\\": \\"216***c83\\",\\n \\"created_at\\": 1622682267564\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', 'title' => '列举已分配的角色列表', - ], - 'AssignRole' => [ - 'summary' => '当前支持将用户设置为团队管理员角色。', - 'path' => '/v2/role/assign', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'summary' => '列举已分配的角色列表。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"assignment_list\\": [\\n {\\n \\"domain_id\\": \\"hz1\\",\\n \\"identity\\": {\\n \\"identity_type\\": \\"IT_User\\",\\n \\"identity_id\\": \\"16435bdf934248b788b7b3771ee9a3dw\\"\\n },\\n \\"role_id\\": \\"SystemGroupAdmin\\",\\n \\"manage_resource_type\\": \\"RT_Group\\",\\n \\"manage_resource_id\\": \\"105***b82\\",\\n \\"creator\\": \\"216***c83\\",\\n \\"created_at\\": 1622682267564\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', + ], + 'ListDelta' => [ + 'path' => '/v2/file/list_delta', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], - ], - [ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - ], + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => 'A short description of struct', - 'type' => 'string', - 'required' => false, - ], + 'schema' => ['type' => 'string', 'required' => false, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ + 'description' => '请求body', 'type' => 'object', 'properties' => [ - 'identity' => [ - 'description' => '唯一身份标识，当前仅支持设置某个用户作为团队管理员', - 'required' => true, - '$ref' => '#/components/schemas/Identity', - ], - 'role_id' => [ - 'description' => '给用户分配的角色ID，当前仅支持填：SystemGroupAdmin（团队管理员）', - 'type' => 'string', - 'required' => true, - 'example' => 'SystemGroupAdmin', - ], - 'manage_resource_type' => [ - 'description' => '管理的资源类型，当前仅支持：RT_Group（团队）', - 'type' => 'string', - 'required' => true, - 'example' => 'RT_Group', - ], - 'manage_resource_id' => [ - 'description' => '管理的资源ID，当前仅支持填Group ID。', - 'type' => 'string', - 'required' => true, - 'example' => '105***b82', - ], + 'drive_id' => ['title' => '云端Drive id'."\n", 'description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'sync_root_id' => ['title' => '如果是同步目录的增量信息，必须设置同步目录对应的云端根目录', 'description' => '同步文件夹根节点文件id', 'type' => 'string', 'required' => false, 'example' => '622fb09598ae66777c7040109a16f49381f6abe1'], + 'cursor' => ['title' => '增量信息的起始游标', 'description' => '游标', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'limit' => ['title' => '获取增量信息的条数限制', 'description' => '限定此次返回资源的数量，取值范围\\[0,100\\]，默认值为 100。'."\n" + ."\n" + .'返回结果可以小于指定的数量，但不能多于指定的数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '50'], ], 'required' => false, ], ], ], 'responses' => [ - 204 => [ + 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', - 'properties' => [], + 'properties' => [ + 'items' => [ + 'description' => '增量信息列表', + 'type' => 'array', + 'items' => [ + 'type' => 'object', + 'properties' => [ + 'file_id' => ['title' => '文件唯一id', 'description' => '文件id', 'type' => 'string', 'example' => '122fb09598ae66777c7040109a16f49381f6abe2'], + 'op' => [ + 'title' => '文件操作，主要包括', + 'description' => '执行的操作。具体包括以下操作：'."\n" + .'- create'."\n" + .'- overwrite'."\n" + .'- delete'."\n" + .'- update'."\n" + .'- move'."\n" + .'- trash'."\n" + .'- restore'."\n" + .'- rename', + 'type' => 'string', + 'enumValueTitles' => [], + 'example' => 'create', + ], + 'file' => ['description' => '涉及的文件信息', '$ref' => '#/components/schemas/File'], + ], + 'description' => '', + ], + ], + 'has_more' => ['description' => '是否还有更多信息。', 'type' => 'boolean', 'example' => 'true'], + 'cursor' => ['description' => '游标', 'type' => 'string', 'example' => '1WQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '列举增量信息', + 'summary' => '列举增量信息。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '分配角色', - 'description' => '当前支持将用户设置为团队管理员角色。', + 'responseDemo' => '[{"type":"json","example":"{\\n \\"items\\": [\\n {\\n \\"file_id\\": \\"122fb09598ae66777c7040109a16f49381f6abe2\\",\\n \\"op\\": \\"create\\",\\n \\"file\\": {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"5d79206586bb5dd69fb34c349282718146c55da7\\",\\n \\"name\\": \\"1.mov\\",\\n \\"type\\": \\"file\\",\\n \\"content_type\\": \\"application/json\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"image file\\",\\n \\"trashed_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"file_extension\\": \\"txt\\",\\n \\"hidden\\": false,\\n \\"size\\": 1024,\\n \\"starred\\": false,\\n \\"status\\": \\"available\\",\\n \\"labels\\": [\\n \\"[\\\\\\"label1:1\\\\\\", \\\\\\"label2:2\\\\\\"]\\"\\n ],\\n \\"upload_id\\": \\"C9DCFE5A82644AC7A02DB74C30C934A6\\",\\n \\"parent_file_id\\": \\"3d5b846942cf94fa72324c8a4bda34e81da635a\\",\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"category\\": \\"image\\",\\n \\"local_created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"local_modified_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"revision_id\\": \\"5d5b846942cf94fa72324c14a4bda34e81da635d\\",\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\\\\\"128X128\\\\\\": \\\\\\"https://url1\\\\\\", \\\\\\"800X800\\\\\\": \\\\\\"url2\\\\\\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1024,\\n \\"height\\": 1024,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"sport\\",\\n \\"name\\": \\"basketball\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"play basketball\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\\\\\"k1\\\\\\":\\\\\\"v1\\\\\\", \\\\\\"k2\\\\\\",\\\\\\"v2\\\\\\"\\"\\n },\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"id_path\\": \\"id1/id2\\",\\n \\"name_path\\": \\"root/f1/f2\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 1,\\n \\"file_count\\": 10\\n },\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"auto_delete_left_sec\\": 0\\n }\\n }\\n ],\\n \\"has_more\\": true,\\n \\"cursor\\": \\"1WQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","errorExample":""},{"type":"xml","example":"<ListDeltaResponse>\\n <items>\\n <file_id>122fb09598ae66777c7040109a16f49381f6abe2</file_id>\\n <op>create</op>\\n <file/>\\n </items>\\n <has_more>true</has_more>\\n <cursor>1WQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg</cursor>\\n</ListDeltaResponse>","errorExample":""}]', ], - 'CancelAssignRole' => [ - 'summary' => '当前仅支持取消团队管理员角色。', - 'path' => '/v2/role/cancel_assign', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'ListDomains' => [ + 'summary' => '列举Domain列表。', + 'path' => '/v2/domain/list', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'tags' => ['admin'], 'security' => [ [ 'AK' => [], ], - [ - 'BearerToken' => [], - ], - ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - ], + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ - 'name' => 'domain_id', - 'in' => 'host', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => 'A short description of struct', - 'type' => 'string', - 'required' => false, - ], - ], - [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'identity' => [ - 'description' => '唯一身份标识，当前仅支持取消用户的角色', - 'required' => true, - '$ref' => '#/components/schemas/Identity', - ], - 'role_id' => [ - 'description' => '取消用户已分配的角色ID，当前仅支持填：SystemGroupAdmin（团队管理员）', - 'type' => 'string', - 'required' => true, - 'example' => 'SystemGroupAdmin', - ], - 'manage_resource_type' => [ - 'description' => '被取消角色管理的资源类型，当前仅支持：RT_Group（团队）', - 'type' => 'string', - 'required' => true, - 'example' => 'RT_Group', - ], - 'manage_resource_id' => [ - 'description' => '被取消角色管理的资源ID，当前仅支持填Group ID', + 'parent_domain_id' => ['description' => '父 domain id', 'type' => 'string', 'required' => false, 'example' => 'bj1'], + 'marker' => ['description' => '分页 marker，"" 表示从头开始。该接口会返回 next\\_marker，可将 next\\_marker 设置该值来遍历所有 domain 信息', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'limit' => ['description' => '本次分页获取的数量，默认 50，不可超过 100', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '60'], + 'service_code' => [ + 'description' => '服务代码，默认为pds'."\n" + ."\n" + .'- edm（企业版）'."\n" + .'- pds（开发版）', 'type' => 'string', - 'required' => true, - 'example' => '105***b82', + 'required' => false, + 'enumValueTitles' => ['pds' => 'pds', 'edm' => 'edm'], + 'example' => 'pds', ], ], 'required' => false, @@ -14788,58 +6327,50 @@ ], ], 'responses' => [ - 204 => [ + 200 => [ 'schema' => [ + 'description' => '返回的 domain 列表', 'type' => 'object', - 'properties' => [], + 'properties' => [ + 'items' => [ + 'description' => '返回的 domain 列表', + 'type' => 'array', + 'items' => ['description' => '单个 domain 信息', '$ref' => '#/components/schemas/Domain'], + ], + 'next_marker' => ['description' => '用作下次遍历的 marker', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '列举Domain', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '取消分配的角色', - 'description' => '当前仅支持取消团队管理员角色。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"parent_domain_id\\": \\"bj1\\",\\n \\"domain_id\\": \\"bj2\\",\\n \\"domain_name\\": \\"pdsdomain\\",\\n \\"description\\": \\"my domain\\",\\n \\"init_drive_enable\\": true,\\n \\"init_drive_size\\": 1073741824,\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"size_quota\\": 1099511627776,\\n \\"size_quota_used\\": 1099511627776,\\n \\"user_count_quota\\": 50,\\n \\"status\\": 1,\\n \\"used_size\\": 1099511627776,\\n \\"published_app_access_strategy\\": {\\n \\"effect\\": \\"deny\\",\\n \\"except_app_id_list\\": [\\n \\"8ovxCTRUDdbpVWBP\\"\\n ]\\n },\\n \\"sharable\\": true,\\n \\"data_hash_name\\": \\"sha1\\",\\n \\"store_redundancy_type\\": \\"LRS\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', ], - 'CreateShareLink' => [ - 'summary' => '创建分享。', - 'path' => '/v2/share_link/create', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'ListDrive' => [ + 'path' => '/v2/drive/list', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'BearerToken' => [], + 'AK' => [], ], [ - 'AK' => [], + 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -14849,143 +6380,21 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'share_all_files' => [ - 'description' => '是否分享整个drive中的文件', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'file_id_list' => [ - 'description' => '分享父路径文件id列表。'."\n" - .'父路径文件个数范围[1, 100]。'."\n" - .'如果`share_all_files=true`，那么此字段无效，否则必须要填写', - 'type' => 'array', - 'items' => [ - 'description' => '分享父路径文件id', - 'type' => 'string', - 'required' => false, - 'example' => '9520943DC264', - ], - 'required' => false, - 'example' => '["520b217f13adf4fc24f2191991b1664ce045b393"]', - ], - 'user_id' => [ - 'description' => '用户id。使用AK方式请求时，必填', - 'type' => 'string', - 'required' => false, - 'example' => 'u123', - ], - 'share_pwd' => [ - 'description' => '提取码。'."\n" - .'提取码长度范围[0, 64]字节'."\n" - .'不设置或者设置为空表示无提取码，在获取分享令牌的时候也不用设置提取码参数。'."\n" - .'要求使用ASCII可见字符。', - 'type' => 'string', - 'required' => false, - 'example' => 'abcF123x', - ], - 'expiration' => [ - 'description' => '失效时间点。'."\n" - .'RFC3339格式，比如："2020-06-28T11:33:00.000+08:00"。'."\n" - .'当expiration取值""时，表示永久有效', - 'type' => 'string', - 'required' => false, - 'example' => '2020-06-28T11:33:00.000+08:00', - ], - 'description' => [ - 'description' => '分享描述。'."\n" - .'长度范围[0, 1024]字符', - 'type' => 'string', - 'required' => false, - 'example' => '百家讲坛合集', - ], - 'share_name' => [ - 'description' => '分享名。'."\n" - .'如果未设置，默认使用file\\_id\\_list中的第一个id对应的文件名。'."\n" - .'长度范围[0, 128]字符', + 'limit' => ['description' => '限定此次返回资源的数量，范围为 [1,100]，默认返回100', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '0', 'exclusiveMinimum' => true, 'example' => '100', 'default' => '100'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'owner' => ['description' => '归属者，不设置时返回所有 drive', 'type' => 'string', 'required' => false, 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4'], + 'owner_type' => [ + 'description' => '归属者类型，可选值如下：'."\n" + ."\n" + .'user：用户'."\n" + .'group：团队'."\n" + ."\n" + .'默认返回所有归属者类型的 drive', 'type' => 'string', 'required' => false, - 'example' => '百家讲坛-1.MP4', - ], - 'disable_preview' => [ - 'description' => '禁止预览分享中的文件', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], - 'disable_save' => [ - 'description' => '禁止转存分享中的文件', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], - 'disable_download' => [ - 'description' => '禁止下载分享中的文件', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], - 'preview_limit' => [ - 'description' => '分享预览次数限制。'."\n" - .'次数要求>=0。'."\n" - .'次数0表示不限制', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '100', - ], - 'save_limit' => [ - 'description' => '分享转存次数限制。'."\n" - .'次数要求>=0。'."\n" - .'次数0表示不限制', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '100', - ], - 'download_limit' => [ - 'description' => '分享下载次数限制。'."\n" - .'次数要求>=0。'."\n" - .'次数0表示不限制', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '100', - ], - 'require_login' => [ - 'description' => '登录后才允许访问分享', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'office_editable' => [ - 'description' => '允许在线编辑分享的文档', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'creatable' => [ - 'description' => '允许在分享中的文件夹中创建文件；creatable为true时，需要同时传creatable_file_id_list参数', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'creatable_file_id_list' => [ - 'description' => '允许上传的文件夹file id列表', - 'type' => 'array', - 'items' => [ - 'description' => '文件夹file id', - 'type' => 'string', - 'required' => false, - 'example' => '9520943DC264', - ], - 'required' => false, + 'example' => 'user', + 'enum' => ['user', 'group'], ], ], 'required' => false, @@ -14995,203 +6404,66 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => '返回信息', - '$ref' => '#/components/schemas/ShareLink', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'items' => [ + 'description' => '空间信息列表', + 'type' => 'array', + 'items' => ['description' => '空间信息', '$ref' => '#/components/schemas/Drive'], + ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空。', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"share_id\\": \\"\\",\\n \\"share_pwd\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id_list\\": [\\n \\"\\"\\n ],\\n \\"expiration\\": \\"\\",\\n \\"expired\\": true,\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"share_name\\": \\"\\",\\n \\"creator\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"preview_count\\": 0,\\n \\"save_count\\": 0,\\n \\"download_count\\": 0,\\n \\"report_count\\": 0,\\n \\"video_preview_count\\": 0,\\n \\"access_count\\": 0,\\n \\"disable_preview\\": true,\\n \\"disable_save\\": true,\\n \\"disable_download\\": true,\\n \\"preview_limit\\": 0,\\n \\"save_limit\\": 0,\\n \\"download_limit\\": 0,\\n \\"require_login\\": true,\\n \\"share_all_files\\": true,\\n \\"share_msg\\": \\"\\",\\n \\"save_download_limit\\": 0,\\n \\"office_editable\\": true,\\n \\"comments\\": \\"\\"\\n}","type":"json"}]', - 'title' => '创建分享', - 'description' => '分享又称之为文件分享，是一个文件视图容器，通过其可将用户空间中的一个或多个文件暴露给匿名用户访问，匿名用户在分享权限的约束下访问其中的文件。', - ], - 'UpdateShareLink' => [ - 'summary' => '修改分享。', - 'path' => '/v2/share_link/update', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '列举空间', + 'summary' => '列举空间。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"drive_name\\": \\"drv1\\",\\n \\"description\\": \\"vipdrive\\",\\n \\"owner\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"owner_type\\": \\"user\\",\\n \\"drive_type\\": \\"normal\\",\\n \\"status\\": \\"enabled\\",\\n \\"used_size\\": 20480,\\n \\"total_size\\": 204800,\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', + ], + 'ListFacegroups' => [ + 'summary' => '列举人脸分组。', + 'path' => '/v2/image/list_facegroups', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'BearerToken' => [], + 'AK' => [], ], [ - 'AK' => [], + 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - ], + 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体。', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'share_id' => [ - 'description' => '分享id', - 'type' => 'string', - 'required' => true, - 'example' => '7JQX1FswpQ8', - ], - 'share_pwd' => [ - 'description' => '提取码。'."\n" - .'提取码长度范围[0, 64]。'."\n" - .'长度0表示提取码是""'."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'abcF123x', - ], - 'expiration' => [ - 'description' => '失效时间点。'."\n" - .'RFC3339格式，比如："2020-06-28T11:33:00.000+08:00"。'."\n" - .'""表示永久有效'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '2020-06-28T11:33:00.000+08:00', - ], - 'description' => [ - 'description' => '描述。'."\n" - .'长度范围[0, 1024]'."\n", - 'type' => 'string', - 'required' => false, - 'example' => '百家讲坛全集', - ], - 'share_name' => [ - 'description' => '分享名。'."\n" - .'默认使用第一个文件名。'."\n" - .'长度范围[0, 128]', - 'type' => 'string', - 'required' => false, - 'example' => '百家讲坛-1.mp4', - ], - 'status' => [ - 'description' => '分享状态。'."\n" - .'枚举值如下：'."\n" - .'- disabled（已取消）'."\n" - .'- enabled（有效）', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'disabled' => '已取消', - 'enabled' => '有效', - ], - 'example' => 'enabled', - ], - 'preview_count' => [ - 'description' => '预览次数。'."\n" - .'次数要求>=0', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '3', - ], - 'save_count' => [ - 'description' => '转存次数。'."\n" - .'次数要求>=0'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '5', - ], - 'download_count' => [ - 'description' => '下载次数。'."\n" - .'次数要求>=0'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '30', - ], - 'report_count' => [ - 'description' => '举报次数。'."\n" - .'次数要求>=0'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - ], - 'video_preview_count' => [ - 'description' => '视频预览次数。'."\n" - .'次数要求>=0'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '100', - ], - 'disable_preview' => [ - 'description' => '禁止预览', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], - 'disable_save' => [ - 'description' => '禁止转存', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], - 'disable_download' => [ - 'description' => '禁止下载', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], - 'preview_limit' => [ - 'description' => '分享预览次数限制。'."\n" - .'次数要求>=0。'."\n" - .'次数0表示不限制'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '100', - ], - 'save_limit' => [ - 'description' => '分享转存次数限制。'."\n" - .'次数要求>=0。'."\n" - .'次数0表示不限制'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '100', - ], - 'download_limit' => [ - 'description' => '分享下载次数限制。'."\n" - .'次数要求>=0。'."\n" - .'次数0表示不限制'."\n", - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '100', - ], - 'office_editable' => [ - 'description' => '允许在线编辑分享的文档', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'remarks' => ['description' => '查询过滤使用， 长度最大128字符，采用的是精确匹配过滤', 'type' => 'string', 'required' => false, 'example' => 'John Doe', 'maxLength' => 128, 'minLength' => 1], + 'limit' => ['description' => 'limit值，n的取值范围：1~100, 默认100。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '100'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'return_total_count' => ['description' => '是否返回搜到的文件总数', 'type' => 'boolean', 'required' => false, 'example' => 'false'], ], 'required' => false, ], @@ -15200,52 +6472,51 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => '返回信息', - '$ref' => '#/components/schemas/ShareLink', + 'type' => 'object', + 'properties' => [ + 'items' => [ + 'description' => '人脸分组列表', + 'type' => 'array', + 'items' => ['description' => '人脸分组', '$ref' => '#/components/schemas/FaceGroup'], + ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空。', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'total_count' => ['description' => '命中的文件总数', 'type' => 'integer', 'format' => 'int64', 'example' => '30'], + ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"share_id\\": \\"\\",\\n \\"share_pwd\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id_list\\": [\\n \\"\\"\\n ],\\n \\"expiration\\": \\"\\",\\n \\"expired\\": true,\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"share_name\\": \\"\\",\\n \\"creator\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"preview_count\\": 0,\\n \\"save_count\\": 0,\\n \\"download_count\\": 0,\\n \\"report_count\\": 0,\\n \\"video_preview_count\\": 0,\\n \\"access_count\\": 0,\\n \\"disable_preview\\": true,\\n \\"disable_save\\": true,\\n \\"disable_download\\": true,\\n \\"preview_limit\\": 0,\\n \\"save_limit\\": 0,\\n \\"download_limit\\": 0,\\n \\"require_login\\": true,\\n \\"share_all_files\\": true,\\n \\"share_msg\\": \\"\\",\\n \\"save_download_limit\\": 0,\\n \\"office_editable\\": true,\\n \\"comments\\": \\"\\"\\n}","type":"json"}]', - 'title' => '修改分享', - ], - 'SearchShareLink' => [ - 'summary' => '搜索分享。', - 'path' => '/v2/share_link/search', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"group_id\\": \\"Cluster-ae6e3472-999e-410b-b54e-cd5dba****\\",\\n \\"group_name\\": \\"name\\",\\n \\"image_count\\": 10,\\n \\"created_at\\": \\"2022-01-14T10:10:52.83948013+08:00\\",\\n \\"updated_at\\": \\"2022-01-14T10:10:52.83948013+08:00\\",\\n \\"group_cover_url\\": \\"https://xxx\\",\\n \\"group_cover_file_id\\": \\"6549c959640fbd517c9b4d93b3b36aecc45xxxxx\\",\\n \\"group_cover_width\\": 1920,\\n \\"group_cover_height\\": 1080,\\n \\"group_cover_face_boundary\\": {\\n \\"Width\\": 200,\\n \\"Height\\": 300,\\n \\"Top\\": 30,\\n \\"Left\\": 10\\n },\\n \\"remarks\\": \\"\\",\\n \\"remarks_array\\": [\\n \\"\\"\\n ]\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\",\\n \\"total_count\\": 30\\n}","type":"json"}]', + 'title' => '列举人脸分组', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'ListFile' => [ + 'summary' => '直接文件夹下列举文件和文件夹。', + 'path' => '/v2/file/list', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'BearerToken' => [], + 'AK' => [], ], [ - 'AK' => [], + 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -15255,91 +6526,104 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'limit' => [ - 'description' => '限定此次返回资源的数量，取值范围\\[1,100\\]。如果没有填写，默认取值100。'."\n" + 'share_id' => ['description' => '分享id。'."\n" + .'如果通过分享操作文件，请携带`x-share-token` header鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。'."\n" + .'`share_id`和`drive_id`两者必须有一个字段赋值。', 'type' => 'string', 'required' => false, 'example' => '7JQX1FswpQ8'], + 'drive_id' => ['description' => '空间 id。', 'type' => 'string', 'required' => false, 'example' => '1'], + 'parent_file_id' => ['description' => '父文件夹 id，当父文件为根目录时，填写 root', 'type' => 'string', 'required' => true, 'example' => 'root'], + 'limit' => ['description' => '限定此次返回资源的数量，取值范围\\[1,100\\]。'."\n" + ."\n" + .'返回结果可以小于指定的数量，但不能多于指定的数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '50'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'<br>默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'status' => [ + 'description' => '文件状态，可选字段如下：'."\n" ."\n" - .'返回结果可以小于指定的数量，但不能多于指定的数量。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '50', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'<br>默认值：无', + .'available：只返回正常文件'."\n" + .'uploading：只返回上传中文件'."\n" + ."\n" + .'默认只返回 available 状态文件', 'type' => 'string', 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'return_total_count' => [ - 'description' => '是否返回搜到到的总记录数', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', + 'enumValueTitles' => ['available' => '正常', 'uploading' => '上传中'], + 'example' => 'available', + 'enum' => ['uploading', 'available'], ], 'order_by' => [ - 'description' => '排序字段。'."\n" - .'默认按照创建时间倒序排列。'."\n" - .'枚举值如下：'."\n" - .'- share_name（分享名称）'."\n" - .'- updated_at（修改时间）'."\n" - .'- description（描述）'."\n" - .'- created_at（创建时间）'."\n", + 'description' => '排序字段，可选值如下：'."\n" + ."\n" + .'created\\_at：根据创建时间排序'."\n" + .'updated\\_at：根据更新时间排序'."\n" + .'size：根据文件大小排序'."\n" + .'name：根据文件名排序'."\n" + ."\n" + .'默认根据 created_at 排序', 'type' => 'string', 'required' => false, - 'enumValueTitles' => [ - 'share_name' => '分享名称', - 'updated_at' => '修改时间', - 'description' => '描述', - 'created_at' => '创建时间', - ], - 'example' => 'created_at', + 'enumValueTitles' => ['updated_at' => '修改时间', 'size' => '大小', 'name' => '名称', 'created_at' => '创建时间'], + 'example' => 'updated_at', ], 'order_direction' => [ - 'description' => '排序方式。'."\n" - .'如果是排序字段是created\\_at或者updated\\_at，则默认是倒序，其他排序字段默认是升序。'."\n" - .'枚举值如下：'."\n" - .'- ASC（升序）'."\n" - .'- DESC（降序）', + 'description' => '排序方向，可选字段为：'."\n" + ."\n" + .'ASC：正序'."\n" + .'DESC：倒序'."\n" + ."\n" + .'默认值为ASC', 'type' => 'string', 'required' => false, - 'enumValueTitles' => [ - 'ASC' => '升序', - 'DESC' => '降序', - ], + 'enumValueTitles' => ['ASC' => '正序', 'DESC' => '倒序'], 'example' => 'ASC', + 'enum' => ['ASC', 'DESC'], ], - 'creators' => [ - 'description' => '分享创建者（user_id）'."\n" - .'1）如果不指定, 那么会根据用户本身的权限进行查询'."\n" - .'1.1 网盘管理员/超管：所有成员'."\n" - .'1.2 团队管理员：团队成员'."\n" - .'1.3 普通用户：自身'."\n" + 'category' => [ + 'description' => '文件分类，可选字段如下：'."\n" ."\n" - .'2）如果指定, 那么只能指定那些有权限的成员, 参考1）', - 'type' => 'array', - 'items' => [ - 'description' => '分享创建者', - 'type' => 'string', - 'required' => false, - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - ], + .'app：安装包'."\n" + .'zip：压缩包'."\n" + .'image：图片'."\n" + .'doc：文档'."\n" + .'video：视频'."\n" + .'audio：音频'."\n" + .'others：其他'."\n" + ."\n" + .'默认返回所有分类文件', + 'type' => 'string', 'required' => false, + 'enumValueTitles' => ['app' => 'app', 'zip' => 'zip', 'image' => 'image', 'doc' => 'doc', 'video' => 'video', 'audio' => 'audio', 'others' => 'others'], + 'example' => 'image', + 'enum' => ['image', 'video', 'audio', 'doc', 'app', 'zip', 'others'], ], - 'query' => [ - 'description' => '查询条件'."\n" - .'1）支持字段：'."\n" - .'1.1 created\\_at 创建时间'."\n" - .'1.2 updated\\_at 更新时间'."\n" - .'1.3 share\\_name\\_for\\_fuzzy 分享名, 支持模糊匹配（match）'."\n" - .'1.4 status 分享状态, '."\n" - .'枚举值 enabled（分享中）/disabled（已取消）'."\n" - .'1.5 expired\\_time 超时时间'."\n" - .'永不过期：expired\\_time=\'1970-01-01T00:00:00\', 返回的expiration=""'."\n" - .'expired_time<\'1970-01-02T00:00:00\'系统保留使用,不表示具体时间', + 'type' => [ + 'description' => '文件类型，可选字段如下：'."\n" + ."\n" + .'file：只返回文件'."\n" + .'folder：只返回文件夹'."\n" + ."\n" + .'默认返回所有类型文件', 'type' => 'string', 'required' => false, - 'example' => 'created_at>=\'2022-01-18T02:50:00\' and created_at<\'2022-01-19T09:45:28\' and share_name_for_fuzzy match \'HD.mp4\' and status in [\'enabled\', \'disabled\'] and expired_time=\'1970-01-01T00:00:00\'', + 'enumValueTitles' => ['file' => '文件', 'folder' => '文件夹'], + 'example' => 'file', + 'enum' => ['file', 'folder'], + ], + 'fields' => ['description' => '设置 fields 时，可以返回子对象的额外信息时，支持的字段为：'."\n" + .'- url 响应中返回文件缩略图地址，下载地址'."\n" + .'- exif 响应中返回文件的 exif 信息'."\n" + .'- cropping\\_suggestion 响应中返回文件的裁剪建议信息'."\n" + .'- characteristic\\_hash 响应中返回文件的特征 hash 值'."\n" + .'- video\\_metadata 响应中返回视频文件的 meta 信息，比如视频时长，比特率，高度，宽度等'."\n" + .'- video\\_preview_metadata 响应中返回视频文件的转码信息，比如每个清晰度的转码信息'."\n" + .'- investigation_info 响应中返回 investigation_info字段'."\n" + .'- dir_size 响应中返回每个子文件夹的统计信息'."\n" + .'- user_tags 响应中返回每个子对象的 user_tags'."\n" + ."\n" + .'当需要多个信息时，不同字段以逗号分割，如 "url,dir_size,user_tags"', 'type' => 'string', 'required' => false, 'example' => 'url,dir_size,user_tags'], + 'thumbnail_processes' => [ + 'description' => '缩略图配置，可一次性返回最多5个缩略图，map的key可以自定义，返回时按key返回对应的缩略图链接', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['$ref' => '#/components/schemas/ImageProcess', 'description' => '定义图片、视频、文档的缩略图处理规则'], ], ], 'required' => false, @@ -15354,210 +6638,131 @@ 'type' => 'object', 'properties' => [ 'items' => [ - 'description' => '分享列表', + 'description' => '文件列表。', 'type' => 'array', - 'items' => [ - 'description' => '分享', - '$ref' => '#/components/schemas/ShareLink', - ], - ], - 'next_marker' => [ - 'description' => '下次起始点', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'total_count' => [ - 'description' => '总数量', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '101', + 'items' => ['description' => '文件信息', '$ref' => '#/components/schemas/File'], ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空。', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"share_id\\": \\"\\",\\n \\"share_pwd\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id_list\\": [\\n \\"\\"\\n ],\\n \\"expiration\\": \\"\\",\\n \\"expired\\": true,\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"share_name\\": \\"\\",\\n \\"creator\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"preview_count\\": 0,\\n \\"save_count\\": 0,\\n \\"download_count\\": 0,\\n \\"report_count\\": 0,\\n \\"video_preview_count\\": 0,\\n \\"access_count\\": 0,\\n \\"disable_preview\\": true,\\n \\"disable_save\\": true,\\n \\"disable_download\\": true,\\n \\"preview_limit\\": 0,\\n \\"save_limit\\": 0,\\n \\"download_limit\\": 0,\\n \\"require_login\\": true,\\n \\"share_all_files\\": true,\\n \\"share_msg\\": \\"\\",\\n \\"save_download_limit\\": 0,\\n \\"office_editable\\": true,\\n \\"comments\\": \\"\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\",\\n \\"total_count\\": 101\\n}","type":"json"}]', - 'title' => '搜索分享', - ], - 'CancelShareLink' => [ - 'summary' => '删除分享。', - 'path' => '/v2/share_link/cancel', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"5d79206586bb5dd69fb34c349282718146c55da7\\",\\n \\"name\\": \\"1.mov\\",\\n \\"type\\": \\"file\\",\\n \\"content_type\\": \\"application/json\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"image file\\",\\n \\"trashed_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"file_extension\\": \\"txt\\",\\n \\"hidden\\": false,\\n \\"size\\": 1024,\\n \\"starred\\": false,\\n \\"status\\": \\"available\\",\\n \\"labels\\": [\\n \\"[\\\\\\"label1:1\\\\\\", \\\\\\"label2:2\\\\\\"]\\"\\n ],\\n \\"upload_id\\": \\"C9DCFE5A82644AC7A02DB74C30C934A6\\",\\n \\"parent_file_id\\": \\"3d5b846942cf94fa72324c8a4bda34e81da635a\\",\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"category\\": \\"image\\",\\n \\"local_created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"local_modified_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"revision_id\\": \\"5d5b846942cf94fa72324c14a4bda34e81da635d\\",\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\\\\\"128X128\\\\\\": \\\\\\"https://url1\\\\\\", \\\\\\"800X800\\\\\\": \\\\\\"url2\\\\\\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1024,\\n \\"height\\": 1024,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"sport\\",\\n \\"name\\": \\"basketball\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"play basketball\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\\\\\"k1\\\\\\":\\\\\\"v1\\\\\\", \\\\\\"k2\\\\\\",\\\\\\"v2\\\\\\"\\"\\n },\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"id_path\\": \\"id1/id2\\",\\n \\"name_path\\": \\"root/f1/f2\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 1,\\n \\"file_count\\": 10\\n },\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"auto_delete_left_sec\\": 0\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', + 'title' => '列举文件', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'ListGroup' => [ + 'path' => '/v2/group/list', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'BearerToken' => [], + 'AK' => [], ], [ - 'AK' => [], + 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求体参数', 'type' => 'object', 'properties' => [ - 'share_id' => [ - 'description' => '分享id', - 'type' => 'string', - 'required' => true, - 'example' => '7JQX1FswpQ8', - ], + 'limit' => ['description' => '限定此次返回资源的数量。如果不设定，默认返回100，最大不能超过100。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '100'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。 默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], ], 'required' => false, ], ], ], 'responses' => [ - 204 => [ + 200 => [ + 'headers' => [], 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - '_' => [ - 'title' => 'Id of the request', - 'description' => 'Id of the request', - 'type' => 'string', + 'items' => [ + 'description' => '群组列表', + 'type' => 'array', + 'items' => ['description' => '群组信息', '$ref' => '#/components/schemas/Group'], ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空。', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '取消分享', - ], - 'ListShareLink' => [ - 'summary' => '列举分享。', - 'path' => '/v2/share_link/list', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '列举群组', + 'summary' => '列举群组。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"group_id\\": \\"b45c0c0c373c41ec9ebb5c85a025a08f\\",\\n \\"group_name\\": \\"test group\\",\\n \\"description\\": \\"created by system\\",\\n \\"created_at\\": 1670573504600,\\n \\"updated_at\\": 1670573504600,\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"is_sync\\": true\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', + ], + 'ListGroupMember' => [ + 'path' => '/v2/group/list_member', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'BearerToken' => [], + 'AK' => [], ], [ - 'AK' => [], + 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['title' => 'A short description of struct', 'description' => 'A short description of struct', 'type' => 'string', 'required' => false], ], [ 'name' => 'body', 'in' => 'body', + 'allowEmptyValue' => true, 'style' => 'json', 'schema' => [ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'creator' => [ - 'description' => '创建者', - 'type' => 'string', - 'required' => false, - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - ], - 'limit' => [ - 'description' => '限定此次返回资源的数量，取值范围\\[0,100\\]。'."\n" - ."\n" - .'返回结果可以小于指定的数量，但不能多于指定的数量。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '50', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'<br>默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'order_by' => [ - 'description' => '排序字段。'."\n" - .'默认按照创建时间倒序排列。'."\n" - .'枚举值如下：'."\n" - .'- share_name（分享名称）'."\n" - .'- updated_at（分享修改时间）'."\n" - .'- description（分享描述）'."\n" - .'- created_at（分享创建时间）', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'share_name' => '分享名称', - 'updated_at' => '分享修改时间', - 'description' => '分享描述', - 'created_at' => '分享创建时间', - ], - 'example' => 'share_name', - ], - 'order_direction' => [ - 'description' => '排序方式。'."\n" - .'如果是排序字段是created_at或者updated_at，则默认是倒序，其他排序字段默认是升序。'."\n" - .'枚举值如下：'."\n" - .'- ASC（升序）'."\n" - .'- DESC（降序）', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'ASC' => '升序', - 'DESC' => '降序', - ], - 'example' => 'ASC', - ], - 'include_cancelled' => [ - 'description' => '是否包含已取消的分享', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], + 'group_id' => ['description' => '目标群组ID，表示将列举哪个群组下的成员', 'type' => 'string', 'required' => true, 'example' => '3e5***2c2'], + 'member_type' => ['description' => '列举的成员类型，不传则两种都返回'."\n" + ."\n" + .'- user（用户）'."\n" + ."\n" + .'- group（群组）'."\n" + ."\n" + .'注意：群组只能作为一个群组的成员，不能同时成为多个群组的成员。 用户可以同时成为多个群组的成员', 'type' => 'string', 'required' => false, 'example' => 'user'], + 'limit' => ['description' => '限定此次返回资源的数量，取值范围[1,100]。'."\n" + .'返回结果可以小于指定的数量，但不能多于指定的数量。'."\n" + .'<br>默认值：100', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '50'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'<br>默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], ], 'required' => false, ], @@ -15565,44 +6770,42 @@ ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '返回的结构体', 'type' => 'object', 'properties' => [ - 'items' => [ - 'description' => '结果对象。', + 'user_items' => [ + 'description' => '用户列表', 'type' => 'array', - 'items' => [ - 'description' => '分享信息', - '$ref' => '#/components/schemas/ShareLink', - ], + 'items' => ['description' => '用户信息', '$ref' => '#/components/schemas/User'], ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空。', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', + 'group_items' => [ + 'description' => '群组列表', + 'type' => 'array', + 'items' => ['description' => '群组信息', '$ref' => '#/components/schemas/Group'], ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空。', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhM1'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"share_id\\": \\"\\",\\n \\"share_pwd\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id_list\\": [\\n \\"\\"\\n ],\\n \\"expiration\\": \\"\\",\\n \\"expired\\": true,\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"share_name\\": \\"\\",\\n \\"creator\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"preview_count\\": 0,\\n \\"save_count\\": 0,\\n \\"download_count\\": 0,\\n \\"report_count\\": 0,\\n \\"video_preview_count\\": 0,\\n \\"access_count\\": 0,\\n \\"disable_preview\\": true,\\n \\"disable_save\\": true,\\n \\"disable_download\\": true,\\n \\"preview_limit\\": 0,\\n \\"save_limit\\": 0,\\n \\"download_limit\\": 0,\\n \\"require_login\\": true,\\n \\"share_all_files\\": true,\\n \\"share_msg\\": \\"\\",\\n \\"save_download_limit\\": 0,\\n \\"office_editable\\": true,\\n \\"comments\\": \\"\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', - 'title' => '列举分享', - 'description' => 'Deprecated, 请使用分享SearchShareLink代替此接口。', - ], - 'GetShareLink' => [ - 'summary' => '获取分享信息。', - 'path' => '/v2/share_link/get', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '列举群组成员', + 'summary' => '列举团队成员。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"user_items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"user_id\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"avatar\\": \\"http://aa.com/1.jpg\\",\\n \\"created_at\\": 1639762579768,\\n \\"updated_at\\": 1639762579768,\\n \\"email\\": \\"a@aliyunpds.com\\",\\n \\"nick_name\\": \\"001\\",\\n \\"phone\\": \\"13900001111\\",\\n \\"role\\": \\"user\\",\\n \\"status\\": \\"enabled\\",\\n \\"user_name\\": \\"pds\\",\\n \\"description\\": \\"vipuser\\",\\n \\"default_drive_id\\": \\"1\\",\\n \\"user_data\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"creator\\": \\"user1\\"\\n }\\n ],\\n \\"group_items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"group_id\\": \\"b45c0c0c373c41ec9ebb5c85a025a08f\\",\\n \\"group_name\\": \\"test group\\",\\n \\"description\\": \\"created by system\\",\\n \\"created_at\\": 1670573504600,\\n \\"updated_at\\": 1670573504600,\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"is_sync\\": true\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhM1\\"\\n}","type":"json"}]', + ], + 'ListIdentityToBenefitPkgMapping' => [ + 'summary' => '列举实体和权益包关联，可用于获取用户绑定的权益包列表。', + 'path' => '/v2/benefit/identity_to_benefit_pkg_mapping/list', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -15611,36 +6814,36 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, + 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求体参数', 'type' => 'object', 'properties' => [ - 'share_id' => [ - 'description' => '分享id', + 'identity_type' => [ + 'description' => '实体的类型'."\n" + .'管理用户权益，传user', 'type' => 'string', 'required' => true, - 'example' => '7JQX1FswpQ8', + 'example' => 'user', + 'enum' => ['user'], ], + 'identity_id' => ['description' => '实体的唯一标识'."\n" + ."\n" + .'管理用户权益时，传user_id', 'type' => 'string', 'required' => true, 'example' => 'user123'], + 'include_expired' => ['description' => '是否返回已经超期的权益包，默认为false', 'type' => 'boolean', 'required' => false, 'example' => 'false'], ], 'required' => false, ], @@ -15649,49 +6852,49 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => '返回信息', - '$ref' => '#/components/schemas/ShareLink', + 'type' => 'object', + 'properties' => [ + 'items' => [ + 'description' => '实体绑定的权益包信息列表', + 'type' => 'array', + 'items' => ['description' => '实体绑定的权益包信息', '$ref' => '#/components/schemas/IdentityToBenefitPkgMapping'], + ], + ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"share_id\\": \\"\\",\\n \\"share_pwd\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id_list\\": [\\n \\"\\"\\n ],\\n \\"expiration\\": \\"\\",\\n \\"expired\\": true,\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"share_name\\": \\"\\",\\n \\"creator\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"preview_count\\": 0,\\n \\"save_count\\": 0,\\n \\"download_count\\": 0,\\n \\"report_count\\": 0,\\n \\"video_preview_count\\": 0,\\n \\"access_count\\": 0,\\n \\"disable_preview\\": true,\\n \\"disable_save\\": true,\\n \\"disable_download\\": true,\\n \\"preview_limit\\": 0,\\n \\"save_limit\\": 0,\\n \\"download_limit\\": 0,\\n \\"require_login\\": true,\\n \\"share_all_files\\": true,\\n \\"share_msg\\": \\"\\",\\n \\"save_download_limit\\": 0,\\n \\"office_editable\\": true,\\n \\"comments\\": \\"\\"\\n}","type":"json"}]', - 'title' => '获取分享信息', - ], - 'GetShareLinkByAnonymous' => [ - 'summary' => '匿名查看分享信息。', - 'path' => '/v2/share_link/get_by_anonymous', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '列举实体和权益包关联', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"identity_type\\": \\"user\\",\\n \\"identity_id\\": \\"user123\\",\\n \\"benefit_pkg_owner_id\\": \\"bj1\\",\\n \\"benefit_pkg_id\\": \\"40cb7794c9294\\",\\n \\"benefit_pkg_type\\": \\"user_identity\\",\\n \\"benefit_pkg_name\\": \\"高级会员\\",\\n \\"benefit_pkg_priority\\": 1,\\n \\"benefit_pkg_computation_rule\\": \\"sum\\",\\n \\"delivery_info_list\\": [\\n {\\n \\"amount\\": 1,\\n \\"is_permanent\\": false,\\n \\"expire_time\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\"\\n }\\n ],\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\"\\n }\\n ]\\n}","type":"json"}]', + ], + 'ListMyDrives' => [ + 'summary' => '列举登录用户自己的空间列表。', + 'path' => '/v2/drive/list_my_drives', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'Anonymous' => [], + 'AK' => [], + ], + [ + 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -15701,12 +6904,9 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'share_id' => [ - 'description' => '分享id', - 'type' => 'string', - 'required' => true, - 'example' => '7JQX1FswpQ8', - ], + 'limit' => ['description' => '限制返回的数量。默认为100，取值范围：1~100。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '0', 'exclusiveMinimum' => true, 'example' => '100', 'default' => '100'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'."\n"], ], 'required' => false, ], @@ -15715,191 +6915,62 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => '返回信息', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'creator_id' => [ - 'description' => '创建者id', - 'type' => 'string', - 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', - ], - 'creator_name' => [ - 'description' => '创建者名字（已脱敏）', - 'type' => 'string', - 'example' => 'AB***CD', - ], - 'creator_phone' => [ - 'description' => '创建者手机号（已脱敏）', - 'type' => 'string', - 'example' => '136****00', - ], - 'expiration' => [ - 'description' => '过期时间', - 'type' => 'string', - 'example' => '2020-08-20T06:51:27.292Z', - ], - 'updated_at' => [ - 'description' => '修改时间', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'avatar' => [ - 'description' => '创建者头像', - 'type' => 'string', - 'example' => 'https://aliyunpds.com/a.jpg', - ], - 'share_name' => [ - 'description' => '分享名称', - 'type' => 'string', - 'example' => '百家讲坛-1.MP4', - ], - 'preview_count' => [ - 'description' => '预览次数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '80', - ], - 'save_count' => [ - 'description' => '转存次数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '2', - ], - 'download_count' => [ - 'description' => '下载次数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '50', - ], - 'report_count' => [ - 'description' => '被举报次数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'video_preview_count' => [ - 'description' => '视频预览次数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '5', - ], - 'access_count' => [ - 'description' => '访问次数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], - 'disable_preview' => [ - 'description' => '禁止预览', - 'type' => 'boolean', - 'example' => 'false', - ], - 'disable_save' => [ - 'description' => '禁止转存', - 'type' => 'boolean', - 'example' => 'false', - ], - 'disable_download' => [ - 'description' => '禁止下载', - 'type' => 'boolean', - 'example' => 'false', - ], - 'preview_limit' => [ - 'description' => '预览次数限制', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'save_limit' => [ - 'description' => '转存次数限制', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'download_limit' => [ - 'description' => '下载次数限制', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'save_download_limit' => [ - 'description' => '转存和下载总次数限制', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '200', - ], - 'has_pwd' => [ - 'description' => '分享是否设置了提取码', - 'type' => 'boolean', - 'example' => 'true', + 'items' => [ + 'description' => '空间信息列表', + 'type' => 'array', + 'items' => ['description' => '空间信息', '$ref' => '#/components/schemas/Drive'], ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空。', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"creator_id\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"creator_name\\": \\"AB***CD\\",\\n \\"creator_phone\\": \\"136****00\\",\\n \\"expiration\\": \\"2020-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"avatar\\": \\"https://aliyunpds.com/a.jpg\\",\\n \\"share_name\\": \\"百家讲坛-1.MP4\\",\\n \\"preview_count\\": 80,\\n \\"save_count\\": 2,\\n \\"download_count\\": 50,\\n \\"report_count\\": 0,\\n \\"video_preview_count\\": 5,\\n \\"access_count\\": 30,\\n \\"disable_preview\\": false,\\n \\"disable_save\\": false,\\n \\"disable_download\\": false,\\n \\"preview_limit\\": 100,\\n \\"save_limit\\": 100,\\n \\"download_limit\\": 100,\\n \\"save_download_limit\\": 200,\\n \\"has_pwd\\": true\\n}","type":"json"}]', - 'title' => '匿名查看分享信息', - ], - 'GetShareLinkToken' => [ - 'summary' => '匿名获取分享令牌。', - 'path' => '/v2/share_link/get_share_token', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'staticInfo' => ['returnType' => 'synchronous'], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"drive_name\\": \\"drv1\\",\\n \\"description\\": \\"vipdrive\\",\\n \\"owner\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"owner_type\\": \\"user\\",\\n \\"drive_type\\": \\"normal\\",\\n \\"status\\": \\"enabled\\",\\n \\"used_size\\": 20480,\\n \\"total_size\\": 204800,\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', + 'title' => '列举我的空间', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'ListMyGroupDrive' => [ + 'summary' => '列举被授权的团队空间列表。', + 'path' => '/v2/drive/list_my_group_drive', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'Anonymous' => [], + 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['title' => 'A short description of struct', 'description' => 'A short description of struct', 'type' => 'string', 'required' => false], ], [ 'name' => 'body', 'in' => 'body', + 'allowEmptyValue' => true, 'style' => 'json', 'schema' => [ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'share_id' => [ - 'description' => '分享id', - 'type' => 'string', - 'required' => true, - 'example' => '7JQX1FswpQ8', - ], - 'share_pwd' => [ - 'description' => '提取码', - 'type' => 'string', - 'required' => false, - 'example' => 'abcF123x', - ], - 'expire_sec' => [ - 'description' => '令牌有效时长。参数合法范围是(0, 7200]；参数为0或缺省时默认7200秒。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '7200', - ], + 'limit' => ['description' => '限定此次返回资源的数量。如果不设定，默认返回100，最大不能超过100。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '100'], + 'marker' => ['description' => '设置此字段后，数据会从上次返回的位置开始继续返回。如果不设定，则从头开始返回数据。 默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'drive_name' => ['type' => 'string', 'required' => false, 'description' => ''], ], 'required' => false, ], @@ -15909,70 +6980,47 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '返回结构体。', 'type' => 'object', 'properties' => [ - 'share_token' => [ - 'title' => 'Id of the request', - 'description' => 'jwt格式的令牌', - 'type' => 'string', - 'example' => 'eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJjOWI3YTVhYTA0ZDE0YWUzODY3ZmRjODg2ZmEwMWRhNCIsImN1c3RvbUpzb24iOiJ7XCJjbGllbnRJZFwiOlwiMjVkelgzdmJZcWt0Vnh5WFwiLFwiZG9tYWluSWRcIjpcImJqMjlcIixcInNjb3BlXCI6W1wiRFJJVkUuQUxMXCIsXCJTSEFSRS5BTExcIixcIkZJTEUuQUxMXCIsXCJVU0VSLkFMTFwiLFwiVklFVy5BTExcIixcIlNUT1JBR0UuQUxMXCIsXCJTVE9SQUdFRklMRS5MSVNUXCIsXCJCQVRDSFwiLFwiT0FVVEguQUxMXCIsXCJJTUFHRS5BTExcIixcIklOVklURS5BTExcIixcIkFDQ09VTlQuQUxMXCJdLFwicm9sZVwiOlwidXNlclwiLFwicmVmXCI6XCJodHRwczovL3d3dy5hbGl5dW5kcml2ZS5jb20vXCIsXCJkZXZpY2VfaWRcIjpcImIyODIwNWU1YzU5NzRjY2JiODI3MDNiNjhkYjhjNDUxXCJ9IiwiZXhwIjoxNjQ4NjE0NDkzLCJpYXQiOjE2NDg2MDcyMzN9.d3HVLvv_LFw2QhPrhvjH_kICWQJX9sKKt7NjQEqI_xE2JO_b7D8rPsFTZz93PLvZ7MhCmudTjGImUpd-ehFnI4Go-1S7BGaKaHFILvP-sWy18Wpikowjxx9mSbzBM_cO6D1LI-kyYhXKWHgVdADfVIPniTDA7-ffhUpi7cAebEs', - ], - 'expires_in' => [ - 'description' => '多长时间失效，比如7200秒（2个小时）', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '7200', + 'items' => [ + 'description' => '返回的空间信息列表', + 'type' => 'array', + 'items' => ['description' => '返回的空间信息', '$ref' => '#/components/schemas/Drive'], ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空。', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'root_group_drive' => ['description' => '企业空间信息。', '$ref' => '#/components/schemas/Drive'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"share_token\\": \\"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VySWQiOiJjOWI3YTVhYTA0ZDE0YWUzODY3ZmRjODg2ZmEwMWRhNCIsImN1c3RvbUpzb24iOiJ7XCJjbGllbnRJZFwiOlwiMjVkelgzdmJZcWt0Vnh5WFwiLFwiZG9tYWluSWRcIjpcImJqMjlcIixcInNjb3BlXCI6W1wiRFJJVkUuQUxMXCIsXCJTSEFSRS5BTExcIixcIkZJTEUuQUxMXCIsXCJVU0VSLkFMTFwiLFwiVklFVy5BTExcIixcIlNUT1JBR0UuQUxMXCIsXCJTVE9SQUdFRklMRS5MSVNUXCIsXCJCQVRDSFwiLFwiT0FVVEguQUxMXCIsXCJJTUFHRS5BTExcIixcIklOVklURS5BTExcIixcIkFDQ09VTlQuQUxMXCJdLFwicm9sZVwiOlwidXNlclwiLFwicmVmXCI6XCJodHRwczovL3d3dy5hbGl5dW5kcml2ZS5jb20vXCIsXCJkZXZpY2VfaWRcIjpcImIyODIwNWU1YzU5NzRjY2JiODI3MDNiNjhkYjhjNDUxXCJ9IiwiZXhwIjoxNjQ4NjE0NDkzLCJpYXQiOjE2NDg2MDcyMzN9.d3HVLvv_LFw2QhPrhvjH_kICWQJX9sKKt7NjQEqI_xE2JO_b7D8rPsFTZz93PLvZ7MhCmudTjGImUpd-ehFnI4Go-1S7BGaKaHFILvP-sWy18Wpikowjxx9mSbzBM_cO6D1LI-kyYhXKWHgVdADfVIPniTDA7-ffhUpi7cAebEs\\",\\n \\"expires_in\\": 7200\\n}","type":"json"}]', - 'title' => '获取分享令牌', - 'description' => '文件分享中文件访问流程要求必须先获取share token，即使此分享的share_pwd=""(非私密分享)。', - ], - 'TrashFile' => [ - 'summary' => '文件或文件夹放入回收站。', - 'path' => '/v2/recyclebin/trash', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '收到的授权团队空间列表', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"drive_name\\": \\"drv1\\",\\n \\"description\\": \\"vipdrive\\",\\n \\"owner\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"owner_type\\": \\"user\\",\\n \\"drive_type\\": \\"normal\\",\\n \\"status\\": \\"enabled\\",\\n \\"used_size\\": 20480,\\n \\"total_size\\": 204800,\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\",\\n \\"root_group_drive\\": {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"drive_name\\": \\"drv1\\",\\n \\"description\\": \\"vipdrive\\",\\n \\"owner\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"owner_type\\": \\"user\\",\\n \\"drive_type\\": \\"normal\\",\\n \\"status\\": \\"enabled\\",\\n \\"used_size\\": 20480,\\n \\"total_size\\": 204800,\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\"\\n }\\n}","type":"json"}]', + ], + 'ListReceivedFile' => [ + 'path' => '/v2/file/list_received_file', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], - ], - [ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -15982,22 +7030,8 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间ID', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件或文件夹ID', - 'type' => 'string', - 'required' => true, - 'example' => '4221bf6e6ab43c255edc4463bf3a6f5f5d317406', - ], - 'custom_trashed_at' => [ - 'type' => 'string', - 'required' => false, - ], + 'limit' => ['description' => '限定此次返回资源的数量。如果不设定，默认返回100，最大不能超过100。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '100'], + 'marker' => ['description' => '设置此字段后，数据会从上次返回的位置开始继续返回。如果不设定，则从头开始返回数据。 默认值：无', 'type' => 'string', 'required' => false, 'example' => 'eym***'], ], 'required' => false, ], @@ -16005,56 +7039,36 @@ ], 'responses' => [ 200 => [ + 'headers' => [], 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '返回结构体。', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'title' => 'Id of the request', - 'description' => '域ID', - 'type' => 'string', - 'example' => 'bj1', - ], - 'drive_id' => [ - 'description' => '空间ID', - 'type' => 'string', - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件或文件夹ID', - 'type' => 'string', - 'example' => '4221bf6e6ab43c255edc4463bf3a6f5f5d317406', - ], - 'async_task_id' => [ - 'description' => '异步任务ID'."\n" - ."\n" - .'如果返回为空字符串，表示直接放入回收站成功。'."\n" - ."\n" - .'如果返回非空字符串，表示需要经过异步处理。调用GetAsyncTask，传递异步任务ID，获取任务信息。', - 'type' => 'string', - 'example' => '13ebd3a24dba4166b1527add676ef2866051b4d5dele16', + 'items' => [ + 'description' => '返回的文件列表', + 'type' => 'array', + 'items' => ['description' => '返回的文件信息', 'example' => ' ', '$ref' => '#/components/schemas/File'], ], + 'next_marker' => ['description' => '本次返回记录的断点，可用于下次继续查询', 'type' => 'string', 'example' => 'eym***'], ], ], ], - 204 => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"4221bf6e6ab43c255edc4463bf3a6f5f5d317406\\",\\n \\"async_task_id\\": \\"13ebd3a24dba4166b1527add676ef2866051b4d5dele16\\"\\n}","type":"json"}]', - 'title' => '放入回收站', - ], - 'ClearRecyclebin' => [ - 'summary' => '清空回收站中所有文件和文件夹。', - 'path' => '/v2/recyclebin/clear', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '收到的共享文件夹列表', + 'summary' => '收到的共享， 可通过此接口获取到从个人空间授权给此用户的文件列表。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"5d79206586bb5dd69fb34c349282718146c55da7\\",\\n \\"name\\": \\"1.mov\\",\\n \\"type\\": \\"file\\",\\n \\"content_type\\": \\"application/json\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"image file\\",\\n \\"trashed_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"file_extension\\": \\"txt\\",\\n \\"hidden\\": false,\\n \\"size\\": 1024,\\n \\"starred\\": false,\\n \\"status\\": \\"available\\",\\n \\"labels\\": [\\n \\"[\\\\\\"label1:1\\\\\\", \\\\\\"label2:2\\\\\\"]\\"\\n ],\\n \\"upload_id\\": \\"C9DCFE5A82644AC7A02DB74C30C934A6\\",\\n \\"parent_file_id\\": \\"3d5b846942cf94fa72324c8a4bda34e81da635a\\",\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"category\\": \\"image\\",\\n \\"local_created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"local_modified_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"revision_id\\": \\"5d5b846942cf94fa72324c14a4bda34e81da635d\\",\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\\\\\"128X128\\\\\\": \\\\\\"https://url1\\\\\\", \\\\\\"800X800\\\\\\": \\\\\\"url2\\\\\\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1024,\\n \\"height\\": 1024,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"sport\\",\\n \\"name\\": \\"basketball\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"play basketball\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\\\\\"k1\\\\\\":\\\\\\"v1\\\\\\", \\\\\\"k2\\\\\\",\\\\\\"v2\\\\\\"\\"\\n },\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"id_path\\": \\"id1/id2\\",\\n \\"name_path\\": \\"root/f1/f2\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 1,\\n \\"file_count\\": 10\\n },\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"auto_delete_left_sec\\": 0\\n }\\n ],\\n \\"next_marker\\": \\"eym***\\"\\n}","type":"json"}]', + ], + 'ListRecyclebin' => [ + 'path' => '/v2/recyclebin/list', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -16063,24 +7077,15 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'delete', - ], + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -16090,11 +7095,24 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间ID', - 'type' => 'string', - 'required' => true, - 'example' => '1', + 'drive_id' => ['description' => '空间ID', 'type' => 'string', 'required' => true, 'example' => '1'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'limit' => ['description' => '限定此次返回资源的数量，取值范围\\[1,200\\]，缺省50。'."\n" + ."\n" + .'返回结果可以小于指定的数量，但不能多于指定的数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '50'], + 'fields' => ['description' => '筛选返回字段：'."\n" + ."\n" + .'1\\. 当填 * 时，返回文件所有字段；'."\n" + ."\n" + .'2\\. 当填空值或不填时，返回的信息不包含文件创建者、文件修改者、用户自定义标签等字段'."\n" + ."\n" + .'默认为空值，只返回部分字段。', 'type' => 'string', 'required' => false, 'example' => '*'], + 'thumbnail_processes' => [ + 'description' => '缩略图配置，可一次性返回最多5个缩略图，map的key可以自定义，返回时按key返回对应的缩略图链接', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['$ref' => '#/components/schemas/ImageProcess', 'description' => '定义图片、视频、文档的缩略图处理规则'], ], ], 'required' => false, @@ -16108,47 +7126,29 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'title' => 'Id of the request', - 'description' => '域ID', - 'type' => 'string', - 'example' => 'bj1', - ], - 'drive_id' => [ - 'description' => '空间ID', - 'type' => 'string', - 'example' => '1', - ], - 'async_task_id' => [ - 'description' => '异步任务ID'."\n" - ."\n" - .'调用GetAsyncTask，传递异步任务ID，获取任务信息', - 'type' => 'string', - 'example' => '13ebd3a24dba4166b1527add676ef2866051b4d5dele16', + 'items' => [ + 'description' => '回收站中的文件和文件夹列表', + 'type' => 'array', + 'items' => ['description' => '文件或文件夹信息', '$ref' => '#/components/schemas/File'], ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhM1'], ], ], ], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"async_task_id\\": \\"13ebd3a24dba4166b1527add676ef2866051b4d5dele16\\"\\n}","type":"json"}]', - 'title' => '清空回收站', - ], - 'ListRecyclebin' => [ + 'title' => '列举回收站', 'summary' => '列举回收站。', - 'path' => '/v2/recyclebin/list', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"5d79206586bb5dd69fb34c349282718146c55da7\\",\\n \\"name\\": \\"1.mov\\",\\n \\"type\\": \\"file\\",\\n \\"content_type\\": \\"application/json\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"image file\\",\\n \\"trashed_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"file_extension\\": \\"txt\\",\\n \\"hidden\\": false,\\n \\"size\\": 1024,\\n \\"starred\\": false,\\n \\"status\\": \\"available\\",\\n \\"labels\\": [\\n \\"[\\\\\\"label1:1\\\\\\", \\\\\\"label2:2\\\\\\"]\\"\\n ],\\n \\"upload_id\\": \\"C9DCFE5A82644AC7A02DB74C30C934A6\\",\\n \\"parent_file_id\\": \\"3d5b846942cf94fa72324c8a4bda34e81da635a\\",\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"category\\": \\"image\\",\\n \\"local_created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"local_modified_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"revision_id\\": \\"5d5b846942cf94fa72324c14a4bda34e81da635d\\",\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\\\\\"128X128\\\\\\": \\\\\\"https://url1\\\\\\", \\\\\\"800X800\\\\\\": \\\\\\"url2\\\\\\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1024,\\n \\"height\\": 1024,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"sport\\",\\n \\"name\\": \\"basketball\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"play basketball\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\\\\\"k1\\\\\\":\\\\\\"v1\\\\\\", \\\\\\"k2\\\\\\",\\\\\\"v2\\\\\\"\\"\\n },\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"id_path\\": \\"id1/id2\\",\\n \\"name_path\\": \\"root/f1/f2\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 1,\\n \\"file_count\\": 10\\n },\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"auto_delete_left_sec\\": 0\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhM1\\"\\n}","type":"json"}]', + ], + 'ListRevision' => [ + 'path' => '/v2/file/revision/list', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -16157,24 +7157,14 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['title' => 'A short description of struct', 'description' => 'A short description of struct', 'type' => 'string', 'required' => true], ], [ 'name' => 'body', @@ -16184,49 +7174,19 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间ID', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'limit' => [ - 'description' => '限定此次返回资源的数量，取值范围\\[1,200\\]，缺省50。'."\n" - ."\n" - .'返回结果可以小于指定的数量，但不能多于指定的数量。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '50', - ], - 'fields' => [ - 'description' => '筛选返回字段：'."\n" - ."\n" - .'1\\. 当填 * 时，返回文件所有字段；'."\n" - ."\n" - .'2\\. 当填空值或不填时，返回的信息不包含文件创建者、文件修改者、用户自定义标签等字段'."\n" - ."\n" - .'默认为空值，只返回部分字段。', - 'type' => 'string', - 'required' => false, - 'example' => '*', - ], - 'thumbnail_processes' => [ - 'description' => '缩略图配置，可一次性返回最多5个缩略图，map的key可以自定义，返回时按key返回对应的缩略图链接', - 'type' => 'object', - 'required' => false, - 'additionalProperties' => [ - '$ref' => '#/components/schemas/ImageProcess', - 'description' => '定义图片、视频、文档的缩略图处理规则', - ], - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + ."\n" + .'默认值：无', 'type' => 'string', 'required' => false, 'example' => '40CB7794C929'], + 'limit' => ['description' => '限定此次返回资源的数量，取值范围\\[1,100\\]。'."\n" + ."\n" + .'默认值为50'."\n" + ."\n" + .'返回结果可以小于指定的数量，但不能多于指定的数量。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'maximum' => '200', 'minimum' => '1', 'example' => '100'], + 'fields' => ['description' => '筛选返回字段'."\n" + ."\n" + .'默认为空。当填 * 时，返回所有字段，会比为空时多返回创建者名称。', 'type' => 'string', 'required' => false, 'example' => '*'], ], 'required' => false, ], @@ -16240,63 +7200,45 @@ 'type' => 'object', 'properties' => [ 'items' => [ - 'description' => '回收站中的文件和文件夹列表', + 'description' => '版本信息数组', 'type' => 'array', - 'items' => [ - 'description' => '文件或文件夹信息', - '$ref' => '#/components/schemas/File', - ], - ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhM1', + 'items' => ['description' => '版本信息', '$ref' => '#/components/schemas/Revision'], ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"name\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"content_type\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"trashed_at\\": \\"\\",\\n \\"file_extension\\": \\"\\",\\n \\"mime_type\\": \\"\\",\\n \\"mime_extension\\": \\"\\",\\n \\"hidden\\": true,\\n \\"size\\": 0,\\n \\"starred\\": true,\\n \\"status\\": \\"\\",\\n \\"user_meta\\": \\"\\",\\n \\"labels\\": [\\n \\"\\"\\n ],\\n \\"upload_id\\": \\"\\",\\n \\"parent_file_id\\": \\"\\",\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"category\\": \\"\\",\\n \\"local_created_at\\": \\"\\",\\n \\"local_modified_at\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"investigation_info\\": {\\n \\"status\\": 0,\\n \\"suggestion\\": \\"\\"\\n },\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"运动\\",\\n \\"name\\": \\"篮球\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"一起打篮球\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"ex_fields_info\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"content_uri\\": \\"\\",\\n \\"streams_info\\": {\\n \\"key\\": {\\n \\"crc64_hash\\": \\"\\",\\n \\"size\\": 0,\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"thumbnail\\": \\"\\"\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"revision_version\\": 0,\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"punish_flag\\": 0,\\n \\"id_path\\": \\"\\",\\n \\"name_path\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\",\\n \\"last_modifier_type\\": \\"\\",\\n \\"last_modifier_id\\": \\"\\",\\n \\"last_modifier_name\\": \\"\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 0,\\n \\"file_count\\": 0\\n },\\n \\"trashed\\": true,\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"location\\": \\"\\",\\n \\"semantic_result\\": {\\n \\"semantic_similarity\\": 0.879,\\n \\"document_contents\\": [\\n {\\n \\"element_contents\\": [\\n {\\n \\"type\\": \\"text\\",\\n \\"content\\": \\"文本片段\\",\\n \\"url\\": \\"http://aliyun.com\\",\\n \\"time_range\\": [\\n 0\\n ]\\n }\\n ]\\n }\\n ],\\n \\"scene_contents\\": [\\n {\\n \\"time_range\\": [\\n 0\\n ],\\n \\"key_frames\\": [\\n {\\n \\"frame_time\\": 1000,\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ],\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ]\\n },\\n \\"sync_flag\\": true,\\n \\"sync_device_flag\\": true,\\n \\"origin_parent_file_id\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"custom_field_1\\": \\"\\",\\n \\"custom_field_2\\": \\"\\",\\n \\"auto_delete_left_sec\\": 0,\\n \\"ai_processed\\": \\"\\",\\n \\"modified_at\\": \\"\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhM1\\"\\n}","type":"json"}]', - 'title' => '列举回收站', - ], - 'RestoreFile' => [ - 'summary' => '从回收站恢复文件或文件夹。', - 'path' => '/v2/recyclebin/restore', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '列举版本', + 'summary' => '列举版本信息。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"9520943DC264\\",\\n \\"revision_id\\": \\"40CB7794C929\\",\\n \\"revision_name\\": \\"1.mov\\",\\n \\"revision_version\\": 1,\\n \\"size\\": 1024,\\n \\"file_extension\\": \\"mov\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"keep_forever\\": false,\\n \\"revision_description\\": \\"aaa\\",\\n \\"is_latest_version\\": false,\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\\\n\\",\\n \\"url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\\\n\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\\\n\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', + ], + 'ListShareLink' => [ + 'path' => '/v2/share_link/list', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], + 'BearerToken' => [], ], [ - 'BearerToken' => [], + 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - ], + 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -16306,18 +7248,37 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间ID', + 'creator' => ['description' => '创建者', 'type' => 'string', 'required' => false, 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4'], + 'limit' => ['description' => '限定此次返回资源的数量，取值范围\\[0,100\\]。'."\n" + ."\n" + .'返回结果可以小于指定的数量，但不能多于指定的数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '50'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'<br>默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'order_by' => [ + 'description' => '排序字段。'."\n" + .'默认按照创建时间倒序排列。'."\n" + .'枚举值如下：'."\n" + .'- share_name（分享名称）'."\n" + .'- updated_at（分享修改时间）'."\n" + .'- description（分享描述）'."\n" + .'- created_at（分享创建时间）', 'type' => 'string', - 'required' => true, - 'example' => '1', + 'required' => false, + 'enumValueTitles' => ['share_name' => '分享名称', 'updated_at' => '分享修改时间', 'description' => '分享描述', 'created_at' => '分享创建时间'], + 'example' => 'share_name', ], - 'file_id' => [ - 'description' => '文件或文件夹ID', + 'order_direction' => [ + 'description' => '排序方式。'."\n" + .'如果是排序字段是created_at或者updated_at，则默认是倒序，其他排序字段默认是升序。'."\n" + .'枚举值如下：'."\n" + .'- ASC（升序）'."\n" + .'- DESC（降序）', 'type' => 'string', - 'required' => true, - 'example' => '4221bf6e6ab43a255edc4463bffa6f5f5d317401', + 'required' => false, + 'enumValueTitles' => ['ASC' => '升序', 'DESC' => '降序'], + 'example' => 'ASC', ], + 'include_cancelled' => ['description' => '是否包含已取消的分享', 'type' => 'boolean', 'required' => false, 'example' => 'true'], ], 'required' => false, ], @@ -16330,51 +7291,30 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'title' => 'Id of the request', - 'description' => '域ID', - 'type' => 'string', - 'example' => 'bj1', - ], - 'drive_id' => [ - 'description' => '空间ID', - 'type' => 'string', - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件或文件夹ID', - 'type' => 'string', - 'example' => '4221bf6e6ab43a255edc4463bffa6f5f5d317401', - ], - 'async_task_id' => [ - 'description' => '异步任务 ID'."\n" - ."\n" - .'如果返回为空字符串，表示直接从回收站恢复成功。'."\n" - ."\n" - .'如果返回非空字符串，表示需要经过异步处理。调用 GetAsyncTask，传递异步任务 ID，获取任务信息。', - 'type' => 'string', - 'example' => '4221bf6e6ab43c255edc4463bf3a6f5f5d317406', + 'items' => [ + 'description' => '结果对象。', + 'type' => 'array', + 'items' => ['description' => '分享信息', '$ref' => '#/components/schemas/ShareLink'], ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空。', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], ], ], ], - 204 => [], - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"4221bf6e6ab43a255edc4463bffa6f5f5d317401\\",\\n \\"async_task_id\\": \\"4221bf6e6ab43c255edc4463bf3a6f5f5d317406\\"\\n}","type":"json"}]', - 'title' => '恢复文件或文件夹', - ], - 'UpdateFacegroup' => [ - 'summary' => '更新人脸分组信息。', - 'path' => '/v2/image/update_facegroup_info', - 'methods' => [ - 'post', ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '列举分享', + 'summary' => '列举分享。', + 'description' => 'Deprecated, 请使用分享SearchShareLink代替此接口。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"share_id\\": \\"7JQX1FswpQ8\\",\\n \\"share_pwd\\": \\"abcF123x\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id_list\\": [\\n \\"[\\\\\\"xx\\\\\\"]\\"\\n ],\\n \\"expiration\\": \\"2020-06-28T11:33:00.000+08:00\\",\\n \\"expired\\": false,\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"videos\\",\\n \\"share_name\\": \\"video-1.MP4\\",\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"status\\": \\"enabled\\",\\n \\"preview_count\\": 10,\\n \\"save_count\\": 2,\\n \\"download_count\\": 5,\\n \\"report_count\\": 0,\\n \\"video_preview_count\\": 1,\\n \\"access_count\\": 4,\\n \\"disable_preview\\": false,\\n \\"disable_save\\": false,\\n \\"disable_download\\": false,\\n \\"preview_limit\\": 100,\\n \\"save_limit\\": 100,\\n \\"download_limit\\": 100,\\n \\"require_login\\": false,\\n \\"share_all_files\\": true,\\n \\"share_msg\\": \\"pwd: 123\\",\\n \\"save_download_limit\\": 100,\\n \\"office_editable\\": true\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', + ], + 'ListTags' => [ + 'path' => '/v2/image/list_tags', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -16383,21 +7323,15 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -16407,41 +7341,9 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'group_id' => [ - 'description' => '人脸分组id, 通过列举人脸分组接口返回的结果中获取', - 'type' => 'string', - 'required' => true, - 'example' => 'group-abc', - ], - 'group_name' => [ - 'description' => '人脸分组名称，长度最大128字符', - 'type' => 'string', - 'required' => false, - 'example' => '张三人脸', - 'maxLength' => 128, - 'minLength' => 1, - ], - 'group_cover_face_id' => [ - 'description' => '人脸分组封面人脸ID, 通过文件接口file/get,file/list,file/search的返回结果**ImageMediaMetadata**字段中进行获取'."\n" - ."\n", - 'type' => 'string', - 'required' => false, - 'example' => 'face1', - ], - 'remarks' => [ - 'description' => '备注，长度最大128字符', - 'type' => 'string', - 'required' => false, - 'example' => '张三', - 'maxLength' => 128, - 'minLength' => 1, - ], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'image_thumbnail_process' => ['description' => '图片缩略图处理', 'type' => 'string', 'required' => false, 'example' => 'image/resize,w_200'], + 'video_thumbnail_process' => ['description' => '视频缩略图处理', 'type' => 'string', 'required' => false, 'example' => 'video/snapshot,t_7000,f_jpg,w_800,h_600,m_fast'], ], 'required' => false, ], @@ -16450,65 +7352,49 @@ 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'title' => 'Id of the request', - 'description' => '空间ID', - 'type' => 'string', - 'example' => '1', - ], - 'group_id' => [ - 'description' => '分组ID', - 'type' => 'string', - 'example' => 'group-abc', + 'tags' => [ + 'description' => '分组列表', + 'type' => 'array', + 'items' => ['description' => '标签信息', '$ref' => '#/components/schemas/ImageTag'], ], ], + 'description' => '', ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"drive_id\\": \\"1\\",\\n \\"group_id\\": \\"group-abc\\"\\n}","type":"json"}]', - 'title' => '更新人脸分组信息', - ], - 'ListTags' => [ + 'title' => '列举标签分组', 'summary' => '列举标签分组。', - 'path' => '/v2/image/list_tags', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'tags' => [ - 'api', + 'description' => '标签分组接口结果是一次性返回指定的drive内聚合的结果，按照分组内照片数取前top2000个返回。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"tags\\": [\\n {\\n \\"name\\": \\"动物\\",\\n \\"count\\": 1,\\n \\"cover_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"cover_file_id\\": \\"5d79206586bb5dd69fb34c349282718146c55da7\\",\\n \\"cover_file_category\\": \\"image\\",\\n \\"cover_tag_confidence\\": 1,\\n \\"cover_overall_score\\": 0.736\\n }\\n ]\\n}","type":"json"}]', + ], + 'ListUploadedParts' => [ + 'summary' => '列举已上传成功的多段。', + 'path' => '/v2/file/list_uploaded_parts', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], + 'BearerToken' => [], ], [ - 'BearerToken' => [], + 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'read', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -16518,24 +7404,13 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'image_thumbnail_process' => [ - 'description' => '图片缩略图处理', - 'type' => 'string', - 'required' => false, - 'example' => 'image/resize,w_200', - ], - 'video_thumbnail_process' => [ - 'description' => '视频缩略图处理', - 'type' => 'string', - 'required' => false, - 'example' => 'video/snapshot,t_7000,f_jpg,w_800,h_600,m_fast', - ], + 'part_number_marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。 默认值：无'."\n" + ."\n", 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'limit' => ['description' => '限定此次返回资源的数量。如果不设定，默认返回100，最大不能超过100。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '100'], + 'upload_id' => ['description' => '上传id', 'type' => 'string', 'required' => true, 'example' => '00166D06127B413BA1EC8ABB1144D101'], + 'file_id' => ['description' => '文件id', 'type' => 'string', 'required' => true, 'example' => '322fb07b975f4b0ae1b543fe8475eee4c19eb2b2'], + 'drive_id' => ['description' => '空间 id，除根据分享链接上传之外的其他场景，必填', 'type' => 'string', 'required' => false, 'example' => '1'], + 'share_id' => ['description' => '分享 id，当根据分享链接上传时必填', 'type' => 'string', 'required' => false, 'example' => '7JQX1FswpQ8'], ], 'required' => false, ], @@ -16544,36 +7419,35 @@ 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'tags' => [ - 'description' => '分组列表', + 'file_id' => ['title' => 'Id of the request', 'description' => '文件id', 'type' => 'string', 'example' => '322fb07b975f4b0ae1b543fe8475eee4c19eb2b2'], + 'upload_id' => ['description' => '上传id', 'type' => 'string', 'example' => '00166D06127B413BA1EC8ABB1144D101'], + 'uploaded_parts' => [ + 'description' => '分段信息列表', 'type' => 'array', - 'items' => [ - 'description' => '标签信息', - '$ref' => '#/components/schemas/ImageTag', - ], + 'items' => ['description' => '分段信息', '$ref' => '#/components/schemas/UploadPartInfo'], ], + 'next_part_number_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空。', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'parallel_upload' => ['description' => '是否并行上传', 'type' => 'boolean', 'example' => 'false'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"tags\\": [\\n {\\n \\"name\\": \\"动物\\",\\n \\"count\\": 10,\\n \\"cover_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"cover_file_id\\": \\"5d79206586bb5dd69fb34c349282718146c55da7\\",\\n \\"cover_file_category\\": \\"image\\",\\n \\"cover_tag_confidence\\": 1,\\n \\"cover_overall_score\\": 0.736\\n }\\n ]\\n}","type":"json"}]', - 'title' => '列举标签分组', - 'description' => '标签分组接口结果是一次性返回指定的drive内聚合的结果，按照分组内照片数取前top2000个返回。', - ], - 'ListAddressGroups' => [ - 'summary' => '列举地点聚类。', - 'path' => '/v2/image/list_address_groups', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '列举已上传分片', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"file_id\\": \\"322fb07b975f4b0ae1b543fe8475eee4c19eb2b2\\",\\n \\"upload_id\\": \\"00166D06127B413BA1EC8ABB1144D101\\",\\n \\"uploaded_parts\\": [\\n {\\n \\"part_number\\": 1,\\n \\"part_size\\": 1024,\\n \\"upload_url\\": \\"https://data.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661\\",\\n \\"internal_upload_url\\": \\"https://data-vpc.aliyunpds.com/xxx/xxx?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx&partNumber=1&uploadId=0CC175B9C0F1B6A831C399E269772661\\\\n\\",\\n \\"etag\\": \\"\\\\\\"0CC175B9C0F1B6A831C399E269772661\\\\\\"\\",\\n \\"parallel_sha1_ctx\\": {\\n \\"h\\": [\\n 0\\n ],\\n \\"part_offset\\": 10240\\n },\\n \\"upload_form_info\\": {\\n \\"endpoint\\": \\"\\",\\n \\"form_data\\": {\\n \\"key\\": \\"\\"\\n }\\n },\\n \\"parallel_sha256_ctx\\": {\\n \\"h\\": [\\n 0\\n ],\\n \\"part_offset\\": 0\\n }\\n }\\n ],\\n \\"next_part_number_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\",\\n \\"parallel_upload\\": false\\n}","type":"json"}]', + ], + 'ListUser' => [ + 'path' => '/v2/user/list', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -16582,21 +7456,14 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -16606,38 +7473,9 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'limit' => [ - 'description' => '限定此次返回资源的数量。如果不设定，默认返回100，最大不能超过100。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '100', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'默认值：无', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'image_thumbnail_process' => [ - 'description' => '图片缩略图处理样式', - 'type' => 'string', - 'required' => false, - 'example' => 'image/resize,w_200', - ], - 'video_thumbnail_process' => [ - 'description' => '视频缩略图处理样式', - 'type' => 'string', - 'required' => false, - 'example' => 'video_thumbnail_process', - ], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'limit' => ['description' => '查询数量，取值范围：1~100。默认值100', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '100'], ], 'required' => false, ], @@ -16650,38 +7488,30 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ + 'next_marker' => ['title' => 'Id of the request', 'description' => '下一页起始资源标识符, 最后一页该值为空', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], 'items' => [ - 'description' => '地点聚类列表', + 'description' => '用户信息列表', 'type' => 'array', - 'items' => [ - 'description' => '地点聚类', - '$ref' => '#/components/schemas/AddressGroup', - ], - ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空。', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', + 'items' => ['description' => '用户信息', '$ref' => '#/components/schemas/User'], ], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"name\\": \\"\\",\\n \\"location\\": \\"\\",\\n \\"count\\": 0,\\n \\"cover_url\\": \\"\\",\\n \\"cover_file_id\\": \\"\\",\\n \\"address_detail\\": {\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"余杭区\\",\\n \\"township\\": \\"文一西路\\"\\n }\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', - 'title' => '列举地点聚类', - ], - 'ListFacegroups' => [ - 'summary' => '列举人脸分组。', - 'path' => '/v2/image/list_facegroups', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'title' => '列举用户', + 'summary' => '列举用户。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\",\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"user_id\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"avatar\\": \\"http://aa.com/1.jpg\\",\\n \\"created_at\\": 1639762579768,\\n \\"updated_at\\": 1639762579768,\\n \\"email\\": \\"a@aliyunpds.com\\",\\n \\"nick_name\\": \\"001\\",\\n \\"phone\\": \\"13900001111\\",\\n \\"role\\": \\"user\\",\\n \\"status\\": \\"enabled\\",\\n \\"user_name\\": \\"pds\\",\\n \\"description\\": \\"vipuser\\",\\n \\"default_drive_id\\": \\"1\\",\\n \\"creator\\": \\"user1\\",\\n \\"last_login_time\\": 0,\\n \\"last_refresh_token_time\\": 0,\\n \\"user_data\\": {\\n \\"key\\": \\"\\"\\n }\\n }\\n ]\\n}","type":"json"}]', + ], + 'MoveFile' => [ + 'summary' => '移动文件或文件夹。', + 'path' => '/v2/file/move', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -16690,22 +7520,16 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -16715,39 +7539,23 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'remarks' => [ - 'description' => '查询过滤使用， 长度最大128字符，采用的是精确匹配过滤', - 'type' => 'string', - 'required' => false, - 'example' => '张三', - 'maxLength' => 128, - 'minLength' => 1, - ], - 'limit' => [ - 'description' => 'limit值，n的取值范围：1~100, 默认100。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'example' => '100', - ], - 'marker' => [ - 'description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" - .'默认值：无', + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'to_parent_file_id' => ['description' => '目的父文件夹 id，当移入根目录时，填 root', 'type' => 'string', 'required' => true, 'example' => '6520943DC261'], + 'check_name_mode' => [ + 'description' => '同名文件处理模式，可选值如下：'."\n" + ."\n" + .'ignore：允许同名文件；'."\n" + ."\n" + .'auto\\_rename：当发现同名文件时，云端自动重命名，默认为追加当前时间点，如 xxx\\_20060102\\_150405；'."\n" + ."\n" + .'refuse：当云端存在同名文件时，拒绝创建新文件，返回客户端已存在同名文件的详细信息。'."\n" + ."\n" + .'默认为 ignore', 'type' => 'string', 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'return_total_count' => [ - 'description' => '是否返回搜到的文件总数', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', + 'example' => 'ignore', + 'enum' => ['ignore', 'auto_rename', 'refuse'], ], ], 'required' => false, @@ -16757,180 +7565,115 @@ 'responses' => [ 200 => [ 'schema' => [ + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'items' => [ - 'description' => '人脸分组列表', - 'type' => 'array', - 'items' => [ - 'description' => '人脸分组', - '$ref' => '#/components/schemas/FaceGroup', - ], - ], - 'next_marker' => [ - 'description' => '下一页起始资源标识符, 最后一页该值为空。', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg', - ], - 'total_count' => [ - 'description' => '命中的文件总数', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '30', - ], + 'domain_id' => ['title' => 'Id of the request', 'description' => '域id', 'type' => 'string', 'example' => 'bj1'], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'example' => '1'], + 'file_id' => ['description' => '文件id', 'type' => 'string', 'example' => 'fileid1'], + 'async_task_id' => ['description' => '异步任务id。'."\n" + ."\n" + .'如果返回为空字符串，表示直接移动成功。'."\n" + ."\n" + .'如果返回非空字符串，表示需要经过异步处理。调用GetAsyncTask，传递异步任务id，获取任务信息。', 'type' => 'string', 'example' => '23ebd1a24dba4166b1527add476ef2866051b4d5del106'], + 'exist' => ['description' => '文件是否已存在', 'type' => 'boolean', 'example' => 'false'], + 'revision_id' => ['type' => 'string'], + 'file_name' => ['type' => 'string'], + 'updated_at' => ['type' => 'string'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"group_id\\": \\"Cluster-ae6e3472-999e-410b-b54e-cd5dba****\\",\\n \\"group_name\\": \\"name\\",\\n \\"image_count\\": 10,\\n \\"created_at\\": \\"2022-01-14T10:10:52.83948013+08:00\\",\\n \\"updated_at\\": \\"2022-01-14T10:10:52.83948013+08:00\\",\\n \\"group_cover_url\\": \\"https://xxx\\",\\n \\"group_cover_file_id\\": \\"6549c959640fbd517c9b4d93b3b36aecc45xxxxx\\",\\n \\"group_cover_width\\": 1920,\\n \\"group_cover_height\\": 1080,\\n \\"group_cover_face_boundary\\": {\\n \\"Width\\": 200,\\n \\"Height\\": 300,\\n \\"Top\\": 30,\\n \\"Left\\": 10\\n },\\n \\"remarks\\": \\"\\",\\n \\"remarks_array\\": [\\n \\"\\"\\n ]\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\",\\n \\"total_count\\": 30\\n}","type":"json"}]', - 'title' => '列举人脸分组', - ], - 'SearchAddressGroups' => [ - 'summary' => '根据地点列表查询地点聚类。', - 'path' => '/v2/image/search_address_groups', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"fileid1\\",\\n \\"async_task_id\\": \\"23ebd1a24dba4166b1527add476ef2866051b4d5del106\\",\\n \\"exist\\": false,\\n \\"revision_id\\": \\"\\",\\n \\"file_name\\": \\"\\",\\n \\"updated_at\\": \\"\\"\\n}","type":"json"}]', + 'title' => '移动文件或文件夹', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'PunishFile' => [ + 'summary' => '处罚文件。', + 'path' => '/v2/csi/business/punish_file', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], ], - [ - 'BearerToken' => [], - ], - ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'readAndWrite', 'deprecated' => false, + 'systemTags' => ['operationType' => 'none', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['title' => '域id', 'type' => 'string', 'example' => 'bj2'], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间id', + 'drive_id' => ['title' => '处罚的文件所属空间 ID', 'description' => '处罚的文件所属drive_id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['title' => '处罚的文件 ID', 'description' => '处罚的文件file_id', 'type' => 'string', 'required' => true, 'example' => '2498DZ2'], + 'action_code' => [ + 'title' => '处罚动作，枚举值：'."\n" + .'pds_file_meta_frozen: 冻结文件'."\n" + .'pds_file_meta_share_forbidden: 禁止分享'."\n" + .'pds_file_meta_remove_punish：解除处罚'."\n" + .'pds_file_frozen：冻结文件（文件内容级别）'."\n" + .'pds_fileshare_forbidden：禁止分享（文件内容级别）'."\n" + .'pds_file_remove_punish：解除处罚（文件内容级别）', + 'description' => '处罚动作，可选的值：'."\n" + .'`pds_file_meta_frozen`: 冻结文件'."\n" + .'`pds_file_meta_share_forbidden`: 禁止分享 '."\n" + .'`pds_file_meta_remove_punish`：解除处罚'."\n" + .'`pds_file_frozen`：冻结文件（文件内容级别）'."\n" + .'`'."\0".'pds_fileshare_forbidden`：禁止分享（文件内容级别）'."\n" + .'`pds_file_remove_punish`：解除处罚（文件内容级别）'."\n" + .'文件内容级别的处罚会影响所有内容相同的文件，非文件内容级别的处罚只影响指定的文件。', 'type' => 'string', 'required' => true, - 'example' => '1', - ], - 'tl_geo_point' => [ - 'description' => '矩形的左顶点位置（维度，经度）', - 'type' => 'string', - 'required' => false, - 'example' => '39.121,101.2121', - ], - 'br_geo_point' => [ - 'description' => '矩形的右底点位置（维度，经度）', - 'type' => 'string', - 'required' => false, - 'example' => '40.121,105.2121', - ], - 'address_level' => [ - 'description' => '查询的地点级别', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'country' => 'country', - 'province' => 'province', - 'city' => 'city', - 'district' => 'district', - 'township' => 'township', - ], - 'example' => 'city '."\n" - .'一共有5个值可选：如下所示'."\n" - .'- country'."\n" - .'- province'."\n" - .'- city'."\n" - .'- district'."\n" - .'- township', - ], - 'address_names' => [ - 'description' => '地点列表', - 'type' => 'array', - 'items' => [ - 'description' => '地点列表, 数组内个数最多10个， 内部的值需要与address_level 级别对应，'."\n" - .'该参数与上边tl_geo_point和br_geo_point参数互斥，二者选其一', - 'type' => 'string', - 'required' => false, - 'example' => '["杭州市","北京市"]', - ], - 'required' => false, - 'maxItems' => 10, - 'minItems' => 1, - ], - 'image_thumbnail_process' => [ - 'description' => '图片缩略图处理样式', - 'type' => 'string', - 'required' => false, - 'example' => 'image/resize,w_200', - ], - 'video_thumbnail_process' => [ - 'description' => '视频缩略图处理样式', - 'type' => 'string', - 'required' => false, - 'example' => 'video/snapshot,t_7000,f_jpg,w_800,h_600,m_fast', + 'enumValueTitles' => ['pds_file_remove_punish' => 'pds_file_remove_punish', 'pds_fileshare_forbidden' => 'pds_fileshare_forbidden', 'pds_file_frozen' => 'pds_file_frozen', 'pds_file_meta_frozen' => 'pds_file_meta_frozen', 'pds_file_meta_remove_punish' => 'pds_file_meta_remove_punish', 'pds_file_meta_share_forbidden' => 'pds_file_meta_share_forbidden'], + 'example' => 'pds_file_meta_frozen', ], + 'punish_reason' => ['title' => '处罚原因', 'description' => '处罚的原因', 'type' => 'string', 'required' => false, 'example' => 'illegal'], ], 'required' => false, + 'title' => '请求体', + 'description' => '请求体', ], ], ], 'responses' => [ - 200 => [ + 204 => [ 'schema' => [ 'title' => 'Schema of Response', 'description' => 'Schema of Response', 'type' => 'object', - 'properties' => [ - 'items' => [ - 'description' => '地点聚类列表', - 'type' => 'array', - 'items' => [ - 'description' => '地点聚类', - '$ref' => '#/components/schemas/AddressGroup', - ], - ], - ], + 'properties' => [], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"name\\": \\"\\",\\n \\"location\\": \\"\\",\\n \\"count\\": 0,\\n \\"cover_url\\": \\"\\",\\n \\"cover_file_id\\": \\"\\",\\n \\"address_detail\\": {\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"余杭区\\",\\n \\"township\\": \\"文一西路\\"\\n }\\n }\\n ]\\n}","type":"json"}]', - 'title' => '根据地点列表查询地点聚类', + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', + 'title' => '处罚文件', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], ], 'RemoveFaceGroupFile' => [ - 'summary' => '删除人脸分组中的文件。', 'path' => '/v2/albums/unassign_facegroup_item', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'BearerToken' => [], @@ -16939,22 +7682,15 @@ 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'operationType' => 'write', 'deprecated' => false, 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -16964,24 +7700,9 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'required' => true, - 'example' => '123', - ], - 'face_group_id' => [ - 'description' => '人脸分组 id', - 'type' => 'string', - 'required' => true, - 'example' => 'Cluster-abc', - ], - 'file_id' => [ - 'description' => '需要被移除人脸分组的文件id', - 'type' => 'string', - 'required' => true, - 'example' => 'abcd', - ], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '123'], + 'face_group_id' => ['description' => '人脸分组 id', 'type' => 'string', 'required' => true, 'example' => 'Cluster-abc'], + 'file_id' => ['description' => '需要被移除人脸分组的文件id', 'type' => 'string', 'required' => true, 'example' => 'abcd'], ], 'required' => false, ], @@ -16990,23 +7711,19 @@ 'responses' => [ 204 => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', 'title' => '删除人脸分组文件', - ], - 'CreateStory' => [ - 'summary' => '创建推荐故事。'."\n" - .'PDS 会根据请求参数中的故事类型和时间范围筛选 drive 空间下的图片和视频，将符合条件的图片、视频加入该故事的文件列表。'."\n" - .'若没有符合条件的图片、视频，则会创建空故事。', - 'path' => '/v2/image/create_story', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'summary' => '删除人脸分组中的文件。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', + ], + 'RemoveGroupMember' => [ + 'path' => '/v2/group/remove_member', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -17015,211 +7732,61 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['title' => 'A short description of struct', 'description' => 'A short description of struct', 'type' => 'string', 'required' => true], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'story_id' => [ - 'description' => '故事 id。由用户指定。', - 'type' => 'string', - 'required' => false, - 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003', - ], - 'story_type' => [ - 'description' => '故事类型', - 'type' => 'string', - 'required' => true, - 'enumValueTitles' => [ - 'PeopleMemory' => '人物故事', - 'TagMemory' => '标签故事', - 'TimeMemory' => '时光故事', - 'TravelMemory' => '旅行故事', - ], - 'example' => 'TagMemory', - 'enum' => [ - 'TimeMemory', - 'PeopleMemory', - 'TagMemory', - 'TravelMemory', - ], - ], - 'story_sub_type' => [ - 'description' => '故事子类型。其值取决于故事类型，详情可见请求参数补充说明。', - 'type' => 'string', - 'required' => false, - 'example' => 'Food', - ], - 'story_name' => [ - 'description' => '故事名称。'."\n" - .'长度不超过 1024 个字节。', - 'type' => 'string', - 'required' => false, - 'example' => '美食', - ], - 'story_start_time' => [ - 'description' => '创建故事照片或视频的开始时间。RFC3339。', - 'type' => 'string', - 'required' => false, - 'example' => '2016-12-30T16:00:00Z', - ], - 'story_end_time' => [ - 'description' => '创建故事照片或视频的结束时间。RFC3339。', - 'type' => 'string', - 'required' => false, - 'example' => '2022-12-30T16:00:00Z', - ], - 'min_image_count' => [ - 'description' => '创建故事照片或视频文件最小个数。'."\n" - .'须大于 0，小于等于 max\\_image\\_count，空值默认为 1。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'minimum' => '1', - 'example' => '1', - 'default' => '1', - ], - 'max_image_count' => [ - 'description' => '创建故事照片或视频文件最大个数。'."\n" - .'须小于等于 100，大于等于 min\\_image\\_count，空值默认 30。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'maximum' => '100', - 'example' => '30', - 'default' => '30', - ], - 'custom_labels' => [ - 'description' => '自定义标签。'."\n" - .'标签数量不能超过 20 个。', - 'type' => 'object', - 'deprecated' => true, - 'required' => false, - 'additionalProperties' => [ - 'type' => 'string', - 'example' => 'label_value', - 'description' => '自定义标签', - ], - ], - 'address' => [ - 'description' => '地址信息', - 'required' => false, - '$ref' => '#/components/schemas/Address', - ], + 'group_id' => ['description' => '目标群组ID，表示从哪个群组下移除成员', 'type' => 'string', 'required' => true, 'example' => '3e5***2c2'], + 'member_type' => ['description' => '成员类型，当前只能移除用户，群组移除可以通过删除群组完成'."\n" + ."\n" + .'- user（用户）'."\n" + ."\n" + .'注意：群组只能作为一个群组的成员，不能同时成为多个群组的成员。 用户可以同时成为多个群组的成员', 'type' => 'string', 'required' => true, 'example' => 'user'], + 'member_id' => ['description' => '成员ID， 当member\\_type为user时，此字段填对应的userID。'."\n", 'type' => 'string', 'required' => true, 'example' => '2e4***1b1'], ], 'required' => false, ], ], ], 'responses' => [ - 200 => [ + 204 => [ + 'headers' => [], 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回参数', + 'description' => 'Schema of Response', 'type' => 'object', - 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'example' => '1', - ], - ], + 'properties' => [], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '移除群组成员', + 'summary' => '从群组移除成员。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"drive_id\\": \\"1\\"\\n}","type":"json"}]', - 'title' => '创建推荐故事', - 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" - ."\n" - .'使用此功能须开通增值服务图片处理功能。故事相关接口限时免费。'."\n" - ."\n" - .'用户创建故事时可自己指定故事 id：'."\n" - .'- 若指定故事 id：'."\n" - .' - 若故事 id 不存在，则使用该 id 创建新故事；'."\n" - .' - 若故事 id 存在，则会根据新条件生成故事并覆盖更新该故事；'."\n" - .'- 若不指定 id，则会由 PDS 生成故事 id。'."\n" - ."\n\n" - .'> '."\n" - .'> - 该接口为异步接口，用户创建推荐故事后需要等待一定时间生成该故事。用户可以通过 GetStory 接口或者 FindStories 接口去查询创建故事的进度。', - 'requestParamsDescription' => '### 故事类型'."\n" - ."\n" - .'- TimeMemory：时光故事'."\n" - ."\n" - .'- PeopleMemory：人物故事'."\n" - ."\n" - .'- TagMemory：标签故事'."\n" - ."\n" - .'- TravelMemory：旅行故事'."\n" - ."\n" - .'### 故事子类型'."\n" - ."\n" - .'TimeMemory：空'."\n" - ."\n" - .'PeopleMemory：'."\n" - ."\n" - .'- Solo：人物故事，单人故事。搜索数据集里人脸数目最多的人物，根据已做过的人脸聚类的结果生成人物故事，可支持通过时间参数StoryStartTime和StoryEndTime传入时间间隔，即在某段时间间隔内，照片数量最多的人物为候选人物，不会关注是否已有该人物的故事生成'."\n" - ."\n" - .'TagMemory：'."\n" - ."\n" - .'- Food：美食标签故事'."\n" - ."\n" - .'- Pet：宠物标签故事'."\n" - ."\n" - .'- PetDog：宠物狗标签故事'."\n" - ."\n" - .'- PetCat：宠物猫标签故事'."\n" - ."\n" - .'- Scenery：风景标签故事'."\n" - ."\n" - .'TravelMemory：空', + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', ], - 'CreateCustomizedStory' => [ - 'summary' => '创建自定义故事。'."\n" - .'区别于推荐故事，自定义故事下面的文件列表由用户指定。', - 'path' => '/v2/image/create_customized_story', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'RemoveStoryFiles' => [ + 'path' => '/v2/image/remove_story_files', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -17228,115 +7795,41 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体', + 'description' => '请求体参数', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'story_type' => [ - 'description' => '故事类型。由用户自定义。', - 'type' => 'string', - 'required' => true, - 'example' => 'user_created', - ], - 'story_sub_type' => [ - 'description' => '故事子类型。由用户自定义。', - 'type' => 'string', - 'required' => true, - 'example' => 'user_created', - ], - 'story_name' => [ - 'description' => '故事名称。'."\n" - .'长度不能超过 1024 字节。', - 'type' => 'string', - 'required' => true, - 'example' => 'test_name', - ], - 'story_cover' => [ - 'description' => '故事封面。该封面必须在故事文件列表中。', - 'type' => 'object', - 'properties' => [ - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf', - ], - 'revision_id' => [ - 'description' => '文件版本 id', - 'type' => 'string', - 'required' => false, - 'example' => '642a88d4aff041ee68fd4fc89beb80e1119da343', - ], - ], - 'required' => true, - ], - 'story_files' => [ - 'description' => '故事文件列表', + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'story_id' => ['description' => '故事 id', 'type' => 'string', 'required' => true, 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003'], + 'files' => [ + 'description' => '文件列表', 'type' => 'array', 'items' => [ + 'description' => '文件信息', 'type' => 'object', 'properties' => [ - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf', - ], - 'revision_id' => [ - 'description' => '文件版本 id', - 'type' => 'string', - 'required' => false, - 'example' => '642a88d4aff041ee68fd4fc89beb80e1119da343', - ], + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf'], + 'revision_id' => ['description' => '版本 id', 'type' => 'string', 'required' => false, 'example' => '642a88dd06e49d9c0a14411ebae606f70edd9a59'], ], 'required' => false, ], - 'required' => true, - 'minItems' => 1, - ], - 'custom_labels' => [ - 'description' => '自定义标签。'."\n" - .'标签数量不能超过 20 个。', - 'type' => 'object', - 'deprecated' => true, 'required' => false, - 'additionalProperties' => [ - 'type' => 'string', - 'example' => 'label_value', - 'description' => '自定义标签', - ], + 'maxItems' => 100, ], ], 'required' => false, @@ -17350,46 +7843,32 @@ 'description' => '返回参数', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'example' => '1', - ], - 'story_id' => [ - 'description' => '故事 id', - 'type' => 'string', - 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'example' => '1'], + 'story_id' => ['description' => '故事 id', 'type' => 'string', 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"drive_id\\": \\"1\\",\\n \\"story_id\\": \\"9132e0d8-fe92-4e56-86c3-f5f112308003\\"\\n}","type":"json"}]', - 'title' => '创建自定义故事', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '故事中移除文件', + 'summary' => '移除指定故事中的文件。', 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" ."\n" - .'使用此功能须开通增值服务图片处理功能。故事相关接口限时免费。'."\n" - ."\n" - .'用户通过传入指定文件列表创建自定义故事。其中故事类型和故事子类型用户可自定义，不再有约束。'."\n" + .'使用此功能须开通增值服务图片处理功能。'."\n" ."\n" - .'><notice>通过该接口指定故事封面时，该封面文件必须存在于故事列表中，否则会返回错误。></notice>'."\n" - .'><notice>自定义故事列表中的文件类型只能为图片。></notice>', - ], - 'SearchStories' => [ - 'summary' => '根据用户指定的条件，查询指定 drive 空间下的故事列表。', - 'path' => '/v2/image/find_stories', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + .'用户在创建故事后，可以根据需求移除故事中不需要的文件。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"drive_id\\": \\"1\\",\\n \\"story_id\\": \\"9132e0d8-fe92-4e56-86c3-f5f112308003\\"\\n}","type":"json"}]', + ], + 'RestoreFile' => [ + 'summary' => '从回收站恢复文件或文件夹。', + 'path' => '/v2/recyclebin/restore', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -17398,217 +7877,26 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'read', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'update'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求参数', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'story_id' => [ - 'description' => '故事 id', - 'type' => 'string', - 'required' => false, - 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003', - ], - 'story_type' => [ - 'description' => '故事类型。由用户创建时指定。', - 'type' => 'string', - 'required' => false, - 'example' => 'PeopleMemory', - ], - 'story_name' => [ - 'description' => '故事名称。'."\n" - .'长度不超过 1024 字节。', - 'type' => 'string', - 'required' => false, - 'example' => '美食', - ], - 'story_start_time_range' => [ - 'description' => '创建故事照片或视频的开始时间范围', - 'type' => 'object', - 'properties' => [ - 'start' => [ - 'description' => '起始时间。时间格式为 RFC3339。', - 'type' => 'string', - 'required' => false, - 'example' => '2016-12-31T00:00:00+08:00', - ], - 'end' => [ - 'description' => '结束时间。时间格式为 RFC3339。', - 'type' => 'string', - 'required' => false, - 'example' => '2022-12-31T00:00:00+08:00', - ], - ], - 'required' => false, - ], - 'story_end_time_range' => [ - 'description' => '创建故事照片或视频的结束时间范围', - 'type' => 'object', - 'properties' => [ - 'start' => [ - 'description' => '起始时间。时间格式为 RFC3339。', - 'type' => 'string', - 'required' => false, - 'example' => '2016-12-31T00:00:00+08:00', - ], - 'end' => [ - 'description' => '结束时间。时间格式为 RFC3339。', - 'type' => 'string', - 'required' => false, - 'example' => '2022-12-31T00:00:00+08:00', - ], - ], - 'required' => false, - ], - 'create_time_range' => [ - 'description' => '创建故事时间范围', - 'type' => 'object', - 'properties' => [ - 'start' => [ - 'description' => '起始时间。时间格式为 RFC3339。', - 'type' => 'string', - 'required' => false, - 'example' => '2016-12-31T00:00:00+08:00', - ], - 'end' => [ - 'description' => '结束时间。时间格式为 RFC3339。', - 'type' => 'string', - 'required' => false, - 'example' => '2022-12-31T00:00:00+08:00', - ], - ], - 'required' => false, - ], - 'face_group_ids' => [ - 'description' => '人脸分组列表。'."\n" - .'查询人物故事时使用。', - 'type' => 'array', - 'items' => [ - 'description' => '人脸分组 id', - 'type' => 'string', - 'required' => false, - 'example' => 'Cluster-be377f73-3502-433c-8309-a01e659c128c', - ], - 'required' => false, - ], - 'custom_labels' => [ - 'description' => '自定义标签。'."\n" - .'可查询多个字段，使用 "," 分隔。', - 'type' => 'string', - 'deprecated' => true, - 'required' => false, - 'example' => 'key1=value1,key2!=value2', - ], - 'with_empty_stories' => [ - 'description' => '是否返回空故事。默认 false。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], - 'marker' => [ - 'description' => '查询的起始位置。若为空则表示从头开始查询。', - 'type' => 'string', - 'required' => false, - 'example' => 'NWQ1Yjk4YmI1ZDODBhNDQ2Nzhl***', - ], - 'limit' => [ - 'description' => '限定此次返回资源的数量，取值范围\\[1,100\\]。'."\n" - .'默认 100。'."\n" - .'返回结果可以小于指定的数量，但不能多于指定的数量。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '100', - 'default' => '100', - ], - 'sort' => [ - 'description' => '排序字段', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'StoryName' => '按故事名称排序', - 'StoryEndTime' => '按故事结束时间排序', - 'CreateTime' => '按故事创建时间排序', - 'StoryStartTime' => '按故事开始时间排序', - ], - 'example' => 'CreateTime', - 'enum' => [ - 'CreateTime', - 'StoryName', - 'StoryStartTime', - 'StoryEndTime', - ], - ], - 'order' => [ - 'description' => '排序方式', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'asc' => '升序', - 'desc' => '降序', - ], - 'example' => 'desc', - 'enum' => [ - 'asc', - 'desc', - ], - ], - 'cover_image_thumbnail_process' => [ - 'description' => '图片封面缩略图控制参数', - 'type' => 'string', - 'deprecated' => true, - 'required' => false, - 'example' => 'image/resize,m_fill,h_128,w_128,limit_0/format,jpg', - ], - 'cover_video_thumbnail_process' => [ - 'description' => '视频封面缩略图控制参数', - 'type' => 'string', - 'deprecated' => true, - 'required' => false, - 'example' => 'video/snapshot,t_1000,f_jpg,w_0,h_0,m_fast,ar_auto', - ], - 'url_expire_sec' => [ - 'description' => '缩略图过期时间。单位为秒，最短 10 秒，最长 86400 秒。', - 'type' => 'integer', - 'format' => 'int64', - 'deprecated' => true, - 'required' => false, - 'maximum' => '86400', - 'minimum' => '10', - 'example' => '900', - 'default' => '900', - ], + 'drive_id' => ['description' => '空间ID', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件或文件夹ID', 'type' => 'string', 'required' => true, 'example' => '4221bf6e6ab43a255edc4463bffa6f5f5d317401'], ], 'required' => false, ], @@ -17618,49 +7906,34 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回参数', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'items' => [ - 'description' => '故事列表', - 'type' => 'array', - 'items' => [ - 'description' => '故事详情', - '$ref' => '#/components/schemas/Story', - ], - ], - 'next_marker' => [ - 'description' => '下次查询位置', - 'type' => 'string', - 'example' => 'Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJ***', - ], + 'domain_id' => ['title' => 'Id of the request', 'description' => '域ID', 'type' => 'string', 'example' => 'bj1'], + 'drive_id' => ['description' => '空间ID', 'type' => 'string', 'example' => '1'], + 'file_id' => ['description' => '文件或文件夹ID', 'type' => 'string', 'example' => '4221bf6e6ab43a255edc4463bffa6f5f5d317401'], + 'async_task_id' => ['description' => '异步任务 ID'."\n" + ."\n" + .'如果返回为空字符串，表示直接从回收站恢复成功。'."\n" + ."\n" + .'如果返回非空字符串，表示需要经过异步处理。调用 GetAsyncTask，传递异步任务 ID，获取任务信息。', 'type' => 'string', 'example' => '4221bf6e6ab43c255edc4463bf3a6f5f5d317406'], ], ], ], + 204 => [], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '恢复文件或文件夹', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"story_id\\": \\"\\",\\n \\"story_type\\": \\"\\",\\n \\"story_sub_type\\": \\"\\",\\n \\"story_name\\": \\"\\",\\n \\"story_start_time\\": \\"\\",\\n \\"story_end_time\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"face_group_ids\\": [\\n \\"\\"\\n ],\\n \\"cover_file_id\\": \\"\\",\\n \\"cover_file_thumbnail_url\\": \\"\\",\\n \\"story_file_list\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"name\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"content_type\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"trashed_at\\": \\"\\",\\n \\"file_extension\\": \\"\\",\\n \\"mime_type\\": \\"\\",\\n \\"mime_extension\\": \\"\\",\\n \\"hidden\\": true,\\n \\"size\\": 0,\\n \\"starred\\": true,\\n \\"status\\": \\"\\",\\n \\"user_meta\\": \\"\\",\\n \\"labels\\": [\\n \\"\\"\\n ],\\n \\"upload_id\\": \\"\\",\\n \\"parent_file_id\\": \\"\\",\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"category\\": \\"\\",\\n \\"local_created_at\\": \\"\\",\\n \\"local_modified_at\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"investigation_info\\": {\\n \\"status\\": 0,\\n \\"suggestion\\": \\"\\"\\n },\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"运动\\",\\n \\"name\\": \\"篮球\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"一起打篮球\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"ex_fields_info\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"content_uri\\": \\"\\",\\n \\"streams_info\\": {\\n \\"key\\": {\\n \\"crc64_hash\\": \\"\\",\\n \\"size\\": 0,\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"thumbnail\\": \\"\\"\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"revision_version\\": 0,\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"punish_flag\\": 0,\\n \\"id_path\\": \\"\\",\\n \\"name_path\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\",\\n \\"last_modifier_type\\": \\"\\",\\n \\"last_modifier_id\\": \\"\\",\\n \\"last_modifier_name\\": \\"\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 0,\\n \\"file_count\\": 0\\n },\\n \\"trashed\\": true,\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"location\\": \\"\\",\\n \\"semantic_result\\": {\\n \\"semantic_similarity\\": 0.879,\\n \\"document_contents\\": [\\n {\\n \\"element_contents\\": [\\n {\\n \\"type\\": \\"text\\",\\n \\"content\\": \\"文本片段\\",\\n \\"url\\": \\"http://aliyun.com\\",\\n \\"time_range\\": [\\n 0\\n ]\\n }\\n ]\\n }\\n ],\\n \\"scene_contents\\": [\\n {\\n \\"time_range\\": [\\n 0\\n ],\\n \\"key_frames\\": [\\n {\\n \\"frame_time\\": 1000,\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ],\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ]\\n },\\n \\"sync_flag\\": true,\\n \\"sync_device_flag\\": true,\\n \\"origin_parent_file_id\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"custom_field_1\\": \\"\\",\\n \\"custom_field_2\\": \\"\\",\\n \\"auto_delete_left_sec\\": 0,\\n \\"ai_processed\\": \\"\\",\\n \\"modified_at\\": \\"\\"\\n }\\n ],\\n \\"custom_id\\": \\"\\",\\n \\"custom_labels\\": {\\n \\"key\\": \\"\\"\\n }\\n }\\n ],\\n \\"next_marker\\": \\"Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJ***\\"\\n}","type":"json"}]', - 'title' => '查询故事列表', - 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" - ."\n" - .'使用此功能须开通增值服务图片处理功能。'."\n" - ."\n" - .'使用查询故事列表前，需要用户调用 CreateStory 或 CreateCustomizedStory 接口创建故事，否则返回空列表。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"4221bf6e6ab43a255edc4463bffa6f5f5d317401\\",\\n \\"async_task_id\\": \\"4221bf6e6ab43c255edc4463bf3a6f5f5d317406\\"\\n}","type":"json"}]', ], - 'GetStory' => [ - 'summary' => '获取指定故事详情，包含封面、文件列表等。', - 'path' => '/v2/image/get_story', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'RestoreRevision' => [ + 'path' => '/v2/file/revision/restore', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -17669,96 +7942,26 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'read', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['title' => 'A short description of struct', 'description' => 'A short description of struct', 'type' => 'string', 'required' => true], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'story_id' => [ - 'description' => '故事 id', - 'type' => 'string', - 'required' => true, - 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003', - ], - 'cover_image_thumbnail_process' => [ - 'description' => '图片封面缩略图控制参数', - 'type' => 'string', - 'deprecated' => true, - 'required' => false, - 'example' => 'image/resize,m_fill,h_128,w_128,limit_0/format,jpg', - ], - 'cover_video_thumbnail_process' => [ - 'description' => '视频封面缩略图控制参数', - 'type' => 'string', - 'deprecated' => true, - 'required' => false, - 'example' => 'video/snapshot,t_1000,f_jpg,w_0,h_0,m_fast,ar_auto', - ], - 'image_url_process' => [ - 'description' => '故事文件图片URL控制参数', - 'type' => 'string', - 'deprecated' => true, - 'required' => false, - 'example' => 'image/resize,m_fill,h_128,w_128,limit_0/format,jpg', - ], - 'image_thumbnail_process' => [ - 'description' => '故事文件图片缩略图控制参数', - 'type' => 'string', - 'deprecated' => true, - 'required' => false, - 'example' => 'image/resize,m_fill,h_128,w_128,limit_0/format,jpg', - ], - 'video_thumbnail_process' => [ - 'description' => '故事文件视频缩略图控制参数', - 'type' => 'string', - 'deprecated' => true, - 'required' => false, - 'example' => 'video/snapshot,t_1000,f_jpg,w_0,h_0,m_fast,ar_auto', - ], - 'url_expire_sec' => [ - 'description' => '缩略图过期时间。单位为秒，最短 10 秒，最长 86400 秒'."\n" - ."\n" - .'默认15分钟。', - 'type' => 'integer', - 'format' => 'int64', - 'deprecated' => true, - 'required' => false, - 'maximum' => '86400', - 'minimum' => '10', - 'example' => '900', - 'default' => '900', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'revision_id' => ['description' => '版本 id', 'type' => 'string', 'required' => true, 'example' => '40CB7794C929'], ], 'required' => false, ], @@ -17766,123 +7969,73 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'description' => '故事详情', - '$ref' => '#/components/schemas/Story', - ], + 'schema' => ['description' => '版本信息', '$ref' => '#/components/schemas/Revision'], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '还原历史版本', + 'summary' => '将文件的某个历史版本，还原为文件的最新版本，还原时生成一个新版本，被还原的版本不变。不支持还原最新版本。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"story_id\\": \\"\\",\\n \\"story_type\\": \\"\\",\\n \\"story_sub_type\\": \\"\\",\\n \\"story_name\\": \\"\\",\\n \\"story_start_time\\": \\"\\",\\n \\"story_end_time\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"face_group_ids\\": [\\n \\"\\"\\n ],\\n \\"cover_file_id\\": \\"\\",\\n \\"cover_file_thumbnail_url\\": \\"\\",\\n \\"story_file_list\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"name\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"content_type\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"trashed_at\\": \\"\\",\\n \\"file_extension\\": \\"\\",\\n \\"mime_type\\": \\"\\",\\n \\"mime_extension\\": \\"\\",\\n \\"hidden\\": true,\\n \\"size\\": 0,\\n \\"starred\\": true,\\n \\"status\\": \\"\\",\\n \\"user_meta\\": \\"\\",\\n \\"labels\\": [\\n \\"\\"\\n ],\\n \\"upload_id\\": \\"\\",\\n \\"parent_file_id\\": \\"\\",\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"category\\": \\"\\",\\n \\"local_created_at\\": \\"\\",\\n \\"local_modified_at\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"investigation_info\\": {\\n \\"status\\": 0,\\n \\"suggestion\\": \\"\\"\\n },\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"运动\\",\\n \\"name\\": \\"篮球\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"一起打篮球\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"ex_fields_info\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"content_uri\\": \\"\\",\\n \\"streams_info\\": {\\n \\"key\\": {\\n \\"crc64_hash\\": \\"\\",\\n \\"size\\": 0,\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"thumbnail\\": \\"\\"\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"revision_version\\": 0,\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"punish_flag\\": 0,\\n \\"id_path\\": \\"\\",\\n \\"name_path\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\",\\n \\"last_modifier_type\\": \\"\\",\\n \\"last_modifier_id\\": \\"\\",\\n \\"last_modifier_name\\": \\"\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 0,\\n \\"file_count\\": 0\\n },\\n \\"trashed\\": true,\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"location\\": \\"\\",\\n \\"semantic_result\\": {\\n \\"semantic_similarity\\": 0.879,\\n \\"document_contents\\": [\\n {\\n \\"element_contents\\": [\\n {\\n \\"type\\": \\"text\\",\\n \\"content\\": \\"文本片段\\",\\n \\"url\\": \\"http://aliyun.com\\",\\n \\"time_range\\": [\\n 0\\n ]\\n }\\n ]\\n }\\n ],\\n \\"scene_contents\\": [\\n {\\n \\"time_range\\": [\\n 0\\n ],\\n \\"key_frames\\": [\\n {\\n \\"frame_time\\": 1000,\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ],\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ]\\n },\\n \\"sync_flag\\": true,\\n \\"sync_device_flag\\": true,\\n \\"origin_parent_file_id\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"custom_field_1\\": \\"\\",\\n \\"custom_field_2\\": \\"\\",\\n \\"auto_delete_left_sec\\": 0,\\n \\"ai_processed\\": \\"\\",\\n \\"modified_at\\": \\"\\"\\n }\\n ],\\n \\"custom_id\\": \\"\\",\\n \\"custom_labels\\": {\\n \\"key\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '获取故事详情', - 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" - ."\n" - .'使用此功能须开通增值服务图片处理功能。'."\n" - ."\n" - .'用户传入指定故事的 id，以获取该故事的详情。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"9520943DC264\\",\\n \\"revision_id\\": \\"40CB7794C929\\",\\n \\"revision_name\\": \\"1.mov\\",\\n \\"revision_version\\": 1,\\n \\"size\\": 1024,\\n \\"file_extension\\": \\"mov\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"keep_forever\\": false,\\n \\"revision_description\\": \\"aaa\\",\\n \\"is_latest_version\\": false,\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\\\n\\",\\n \\"url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\\\n\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\\\n\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\"\\n}","type":"json"}]', ], - 'UpdateStory' => [ - 'summary' => '更新指定故事的信息，包含名称、标签、自定义 id、封面等。', - 'path' => '/v2/image/update_story', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'ScanFile' => [ + 'path' => '/v2/file/scan', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], - ], - [ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'list'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数', + 'description' => '请求体', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'story_id' => [ - 'description' => '故事 id', - 'type' => 'string', - 'required' => true, - 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003', - ], - 'story_name' => [ - 'description' => '故事名称。'."\n" - .'长度不超过 1024 字节。', - 'type' => 'string', - 'required' => false, - 'example' => 'name1', - ], - 'custom_labels' => [ - 'description' => '自定义标签。'."\n" - .'标签数不超过 20 个。', - 'type' => 'object', - 'deprecated' => true, - 'required' => false, - 'additionalProperties' => [ - 'type' => 'string', - 'example' => 'label_value', - 'description' => '自定义标签', - ], - ], - 'cover' => [ - 'description' => '故事封面', - 'type' => 'object', - 'properties' => [ - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => false, - 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf', - ], - 'revision_id' => [ - 'description' => '版本 id', - 'type' => 'string', - 'required' => false, - 'example' => '642a88dd06e49d9c0a14411ebae606f70edd9a59', - ], - ], - 'required' => false, - ], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'limit' => ['description' => '限定此次返回资源的数量，取值范围\\[1,100\\]。'."\n" + ."\n" + .'返回结果可以小于指定的数量，但不能多于指定的数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '1', 'example' => '50', 'default' => '50'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'<br>默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'fields' => ['title' => 'scan file 想要获取的文件属性，'."\n" + .'1. 如果想要获取所有属性使用‘*’，'."\n" + .' 2.不传默认返回以下属性：'."\n" + .' file_id, drive_id, parent_file_id, type,'."\n" + .' created_at, updated_at, file_extention, size, starred, status,deleting, category, permissions'."\n" + .' 3 用户也可以指定属性进行返回，多个属性之间用，隔开'."\n" + .' '."\n", 'description' => 'scan file 想要获取的文件属性。'."\n" + .'- 如果想要获取所有属性使用‘*’。'."\n" + .'- 不传默认返回以下属性：'."\n" + .' - file_id, '."\n" + .' - drive_id, '."\n" + .' - parent_file_id, '."\n" + .' - type, '."\n" + .' - created_at, '."\n" + .' - updated_at, '."\n" + .' - file_extention, '."\n" + .' - size, '."\n" + .' - starred, '."\n" + .' - status,'."\n" + .' - category, '."\n" + .' - permissions。'."\n" + .'- 用户也可以指定属性进行返回，多个属性之间用\',\'隔开。', 'type' => 'string', 'required' => false, 'example' => '*'], ], 'required' => false, ], @@ -17892,44 +8045,33 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回参数', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'example' => '1', - ], - 'story_id' => [ - 'description' => '故事 id', - 'type' => 'string', - 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003', + 'items' => [ + 'description' => '文件列表', + 'type' => 'array', + 'items' => ['description' => '文件信息', '$ref' => '#/components/schemas/File'], ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空。', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '扫描文件', + 'summary' => '扫描文件。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"drive_id\\": \\"1\\",\\n \\"story_id\\": \\"9132e0d8-fe92-4e56-86c3-f5f112308003\\"\\n}","type":"json"}]', - 'title' => '更新故事', - 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" - ."\n" - .'使用此功能须开通增值服务图片处理功能。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"5d79206586bb5dd69fb34c349282718146c55da7\\",\\n \\"name\\": \\"1.mov\\",\\n \\"type\\": \\"file\\",\\n \\"content_type\\": \\"application/json\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"image file\\",\\n \\"trashed_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"file_extension\\": \\"txt\\",\\n \\"hidden\\": false,\\n \\"size\\": 1024,\\n \\"starred\\": false,\\n \\"status\\": \\"available\\",\\n \\"labels\\": [\\n \\"[\\\\\\"label1:1\\\\\\", \\\\\\"label2:2\\\\\\"]\\"\\n ],\\n \\"upload_id\\": \\"C9DCFE5A82644AC7A02DB74C30C934A6\\",\\n \\"parent_file_id\\": \\"3d5b846942cf94fa72324c8a4bda34e81da635a\\",\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"category\\": \\"image\\",\\n \\"local_created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"local_modified_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"revision_id\\": \\"5d5b846942cf94fa72324c14a4bda34e81da635d\\",\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\\\\\"128X128\\\\\\": \\\\\\"https://url1\\\\\\", \\\\\\"800X800\\\\\\": \\\\\\"url2\\\\\\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1024,\\n \\"height\\": 1024,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"sport\\",\\n \\"name\\": \\"basketball\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"play basketball\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\\\\\"k1\\\\\\":\\\\\\"v1\\\\\\", \\\\\\"k2\\\\\\",\\\\\\"v2\\\\\\"\\"\\n },\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"id_path\\": \\"id1/id2\\",\\n \\"name_path\\": \\"root/f1/f2\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 1,\\n \\"file_count\\": 10\\n },\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"auto_delete_left_sec\\": 0\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', ], - 'DeleteStory' => [ - 'summary' => '删除指定故事。', - 'path' => '/v2/image/delete_story', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'SearchAddressGroups' => [ + 'summary' => '根据地点列表查询地点聚类。', + 'path' => '/v2/image/search_address_groups', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -17938,48 +8080,45 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'delete', - 'riskType' => 'none', - 'chargeType' => 'free', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求数据', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'tl_geo_point' => ['description' => '矩形的左顶点位置（维度，经度）', 'type' => 'string', 'required' => false, 'example' => '39.121,101.2121'], + 'br_geo_point' => ['description' => '矩形的右底点位置（维度，经度）', 'type' => 'string', 'required' => false, 'example' => '40.121,105.2121'], + 'address_level' => [ + 'description' => '查询的地点级别', 'type' => 'string', - 'required' => true, - 'example' => '1', + 'required' => false, + 'enumValueTitles' => ['country' => 'country', 'province' => 'province', 'city' => 'city', 'district' => 'district', 'township' => 'township'], + 'example' => 'city', ], - 'story_id' => [ - 'description' => '故事 id', - 'type' => 'string', - 'required' => true, - 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003', + 'address_names' => [ + 'description' => '地点列表', + 'type' => 'array', + 'items' => ['description' => '地点列表, 数组内个数最多10个， 内部的值需要与address_level 级别对应，'."\n" + .'该参数与上边tl_geo_point和br_geo_point参数互斥，二者选其一', 'type' => 'string', 'required' => false, 'example' => '["杭州市","北京市"]'], + 'required' => false, + 'maxItems' => 10, + 'minItems' => 1, + 'example' => '["Hangzhou","Beijing"]', ], + 'image_thumbnail_process' => ['description' => '图片缩略图处理样式', 'type' => 'string', 'required' => false, 'example' => 'image/resize,w_200'], + 'video_thumbnail_process' => ['description' => '视频缩略图处理样式', 'type' => 'string', 'required' => false, 'example' => 'video/snapshot,t_7000,f_jpg,w_800,h_600,m_fast'], ], 'required' => false, ], @@ -17989,114 +8128,58 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回参数', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'example' => '1', + 'items' => [ + 'description' => '地点聚类列表', + 'type' => 'array', + 'items' => ['description' => '地点聚类', '$ref' => '#/components/schemas/AddressGroup'], ], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"name\\": \\"\\",\\n \\"location\\": \\"30.12231,120.1212\\",\\n \\"count\\": 10,\\n \\"cover_url\\": \\"\\",\\n \\"cover_file_id\\": \\"\\",\\n \\"address_detail\\": {\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"余杭区\\",\\n \\"township\\": \\"文一西路\\"\\n }\\n }\\n ]\\n}","type":"json"}]', + 'title' => '根据地点列表查询地点聚类', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"drive_id\\": \\"1\\"\\n}","type":"json"}]', - 'title' => '删除故事', - 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" - ."\n" - .'使用此功能须开通增值服务图片处理功能。', ], - 'AddStoryFiles' => [ - 'summary' => '给指定故事添加文件。', - 'path' => '/v2/image/add_story_files', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'SearchDomains' => [ + 'summary' => '搜索 domain', + 'path' => '/v2/domain/search', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'tags' => ['admin'], 'security' => [ [ 'AK' => [], ], - [ - 'BearerToken' => [], - ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ - 'name' => 'domain_id', - 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], - ], - [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数', + 'description' => '请求body', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'story_id' => [ - 'description' => '故事 id', - 'type' => 'string', - 'required' => true, - 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003', - ], - 'files' => [ - 'description' => '文件列表', - 'type' => 'array', - 'items' => [ - 'description' => '文件信息', - 'type' => 'object', - 'properties' => [ - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf', - ], - 'revision_id' => [ - 'description' => '版本 id', - 'type' => 'string', - 'required' => false, - 'example' => '642a88dd06e49d9c0a14411ebae606f70edd9a59', - ], - ], - 'required' => false, - ], - 'required' => false, - 'maxItems' => 100, - ], + 'name' => ['description' => '要搜索的 domain 名称，支持模糊搜索', 'type' => 'string', 'required' => false, 'example' => 'Hello Drive'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'<br>默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'limit' => ['description' => '限定此次返回资源的数量，取值范围\\[0,100\\]，默认100'."\n" + ."\n" + .'返回结果可以小于指定的数量，但不能多于指定的数量。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '50'], + 'order_by' => ['description' => '排序规则，当前仅支持：'."\n" + .'created_at，创建时间', 'type' => 'string', 'required' => false, 'example' => 'created_at'], ], 'required' => false, ], @@ -18105,58 +8188,33 @@ 'responses' => [ 200 => [ 'schema' => [ - 'title' => 'Schema of Response', - 'description' => '返回参数', + 'description' => 'domain 列表以及遍历 marker', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'example' => '1', - ], - 'story_id' => [ - 'description' => '故事 id', - 'type' => 'string', - 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003', - ], - 'files' => [ - 'description' => '文件列表', + 'items' => [ + 'description' => '搜索命中的 domain 列表', 'type' => 'array', - 'items' => [ - 'description' => '添加到故事中的文件信息', - '$ref' => '#/components/schemas/AddStoryFile', - ], - ], - 'request_id' => [ - 'type' => 'string', + 'items' => ['description' => 'domain 信息', '$ref' => '#/components/schemas/Domain'], ], + 'next_marker' => ['description' => '用作下次遍历的 marker', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'staticInfo' => ['returnType' => 'synchronous'], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"parent_domain_id\\": \\"bj1\\",\\n \\"domain_id\\": \\"bj2\\",\\n \\"domain_name\\": \\"pdsdomain\\",\\n \\"description\\": \\"my domain\\",\\n \\"init_drive_enable\\": true,\\n \\"init_drive_size\\": 1073741824,\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"size_quota\\": 1099511627776,\\n \\"size_quota_used\\": 1099511627776,\\n \\"user_count_quota\\": 50,\\n \\"status\\": 1,\\n \\"used_size\\": 1099511627776,\\n \\"published_app_access_strategy\\": {\\n \\"effect\\": \\"deny\\",\\n \\"except_app_id_list\\": [\\n \\"8ovxCTRUDdbpVWBP\\"\\n ]\\n },\\n \\"sharable\\": true,\\n \\"data_hash_name\\": \\"sha1\\",\\n \\"store_redundancy_type\\": \\"LRS\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', + 'title' => '搜索Domain', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"drive_id\\": \\"1\\",\\n \\"story_id\\": \\"9132e0d8-fe92-4e56-86c3-f5f112308003\\",\\n \\"files\\": [\\n {\\n \\"file_id\\": \\"63e5e4340f76cb3ead5f40f68163f0f967c1a7bf\\",\\n \\"revision_id\\": \\"642a88dd06e49d9c0a14411ebae606f70edd9a59\\",\\n \\"error_code\\": \\"\\",\\n \\"error_message\\": \\"\\"\\n }\\n ],\\n \\"request_id\\": \\"\\"\\n}","type":"json"}]', - 'title' => '故事中添加文件', - 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" - ."\n" - .'使用此功能须开通增值服务图片处理功能。'."\n" - ."\n" - .'用户在创建故事后，可以手动给指定故事添加想要的文件。', ], - 'RemoveStoryFiles' => [ - 'summary' => '移除指定故事中的文件。', - 'path' => '/v2/image/remove_story_files', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'SearchDrive' => [ + 'summary' => '搜索空间。', + 'path' => '/v2/drive/search', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -18165,72 +8223,38 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'story_id' => [ - 'description' => '故事 id', + 'drive_name' => ['description' => '空间名称', 'type' => 'string', 'required' => false, 'example' => 'My personal space'], + 'limit' => ['description' => '异步调用的返回个数。默认返回100个，取值范围\\[1,100]。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '0', 'exclusiveMinimum' => true, 'example' => '100', 'default' => '100'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'<br>默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'owner' => ['description' => '归属者', 'type' => 'string', 'required' => false, 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4'], + 'owner_type' => [ + 'description' => '归属者类型，可选值如下：'."\n" + ."\n" + .'user：用户'."\n" + .'group：团队', 'type' => 'string', - 'required' => true, - 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003', - ], - 'files' => [ - 'description' => '文件列表', - 'type' => 'array', - 'items' => [ - 'description' => '文件信息', - 'type' => 'object', - 'properties' => [ - 'file_id' => [ - 'description' => '文件 id', - 'type' => 'string', - 'required' => true, - 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf', - ], - 'revision_id' => [ - 'description' => '版本 id', - 'type' => 'string', - 'required' => false, - 'example' => '642a88dd06e49d9c0a14411ebae606f70edd9a59', - ], - ], - 'required' => false, - ], 'required' => false, - 'maxItems' => 100, + 'example' => 'user', + 'enum' => ['user', 'group'], ], ], 'required' => false, @@ -18241,46 +8265,32 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回参数', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'example' => '1', - ], - 'story_id' => [ - 'description' => '故事 id', - 'type' => 'string', - 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003', + 'items' => [ + 'description' => '空间信息列表', + 'type' => 'array', + 'items' => ['description' => '空间信息', '$ref' => '#/components/schemas/Drive'], ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空。', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"drive_name\\": \\"drv1\\",\\n \\"description\\": \\"vipdrive\\",\\n \\"owner\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"owner_type\\": \\"user\\",\\n \\"drive_type\\": \\"normal\\",\\n \\"status\\": \\"enabled\\",\\n \\"used_size\\": 20480,\\n \\"total_size\\": 204800,\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\"\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\"\\n}","type":"json"}]', + 'title' => '搜索空间', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"drive_id\\": \\"1\\",\\n \\"story_id\\": \\"9132e0d8-fe92-4e56-86c3-f5f112308003\\"\\n}","type":"json"}]', - 'title' => '故事中移除文件', - 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" - ."\n" - .'使用此功能须开通增值服务图片处理功能。'."\n" - ."\n" - .'用户在创建故事后，可以根据需求移除故事中不需要的文件。', ], - 'CreateSimilarImageClusterTask' => [ - 'summary' => '用户可以发起创建相似图片聚类任务，该任务会将指定 drive 空间下相似的图片聚类在一起。', - 'path' => '/v2/image/create_similar_image_cluster_task', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'SearchFile' => [ + 'summary' => '搜索文件。', + 'path' => '/v2/file/search', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -18289,42 +8299,67 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => false, 'example' => '1'], + 'query' => ['description' => '搜索条件，可以根据文件名或目录名模糊查询，最长 4096 字符', 'type' => 'string', 'required' => true, 'example' => 'name="123"', 'maxLength' => 4096], + 'order_by' => [ + 'description' => '排序字段，默认根据 created_at 排序，可选值如下：'."\n" + .'- created\\_at：根据创建时间排序'."\n" + .'- updated\\_at：根据更新时间排序'."\n" + .'- size：根据文件大小排序'."\n" + .'- name：根据文件名排序'."\n" + ."\n\n" + .'排序方向，可选值如下：'."\n" + .'- ASC代表正序'."\n" + .'- DESC代表逆序'."\n" + ."\n\n" + .'order\\_by语法为：字段名+空格+ASC/DESC，如果多个字段排序则需要用逗号隔开，前面的规则优先级高。如：'."\n" + .'- 按名称正序：name ASC'."\n" + .'- 按创建时间逆序： created_at DESC'."\n" + .'- 先按创建时间逆序，如果创建时间相同，则按名称正序：created_at DESC,name ASC', 'type' => 'string', - 'required' => true, - 'example' => '123', + 'required' => false, + 'enumValueTitles' => [], + 'example' => 'name ASC', + 'enum' => ['name', 'type', 'created_at', 'updated_at', 'size', 'image_time', 'last_access_at', 'custom_type', 'custom_field_1', 'custom_field_2', 'image_overall_score'], + ], + 'limit' => ['description' => '限定此次返回资源的数量，取值范围\\[1,100\\]。'."\n" + ."\n" + .'返回结果可以小于指定的数量，但不能多于指定的数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'maximum' => '100', 'minimum' => '1', 'example' => '50', 'default' => '50'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'<br>默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'return_total_count' => ['description' => '是否返回检索到的文件总数。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'recursive' => ['description' => '当 query 中设置了 parent_file_id= xxx 时，设置该字段可以对文件夹进行递归搜索', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'thumbnail_processes' => [ + 'description' => '缩略图配置，可一次性返回最多5个缩略图，map的key可以自定义，返回时按key返回对应的缩略图链接', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['$ref' => '#/components/schemas/ImageProcess', 'description' => '定义图片、视频、文档的缩略图处理规则'], ], + 'fields' => ['description' => '设置 fields 时，可以返回文件的额外信息时，支持的字段为：'."\n" + .'* dir_size 响应中返回每个子文件夹的统计信息'."\n" + .'* id_path 响应中返回每个子对象的 id_path'."\n" + .'* name_path 响应中返回每个子对象的 name_path'."\n" + ."\n" + .'当需要多个信息时，不同字段以逗号分割，如 "id_path,name_path,dir_size"', 'type' => 'string', 'required' => false, 'example' => 'id_path,name_path'], ], 'required' => false, ], @@ -18333,98 +8368,112 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => '返回参数', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'task_id' => [ - 'description' => '任务 id', - 'type' => 'string', - 'example' => 'i:SimilarImageClustering-b67d53e7-2fe8-460f-9b95-1e93636923eb', + 'items' => [ + 'description' => '文件信息列表。', + 'type' => 'array', + 'items' => ['description' => '文件信息', '$ref' => '#/components/schemas/File'], ], + 'next_marker' => ['description' => '下一页起始资源标识符, 最后一页该值为空。', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'total_count' => ['description' => '命中的文件总数', 'type' => 'integer', 'format' => 'int64', 'example' => '1022'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"5d79206586bb5dd69fb34c349282718146c55da7\\",\\n \\"name\\": \\"1.mov\\",\\n \\"type\\": \\"file\\",\\n \\"content_type\\": \\"application/json\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"image file\\",\\n \\"trashed_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"file_extension\\": \\"txt\\",\\n \\"hidden\\": false,\\n \\"size\\": 1024,\\n \\"starred\\": false,\\n \\"status\\": \\"available\\",\\n \\"labels\\": [\\n \\"[\\\\\\"label1:1\\\\\\", \\\\\\"label2:2\\\\\\"]\\"\\n ],\\n \\"upload_id\\": \\"C9DCFE5A82644AC7A02DB74C30C934A6\\",\\n \\"parent_file_id\\": \\"3d5b846942cf94fa72324c8a4bda34e81da635a\\",\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"category\\": \\"image\\",\\n \\"local_created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"local_modified_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"revision_id\\": \\"5d5b846942cf94fa72324c14a4bda34e81da635d\\",\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\\\\\"128X128\\\\\\": \\\\\\"https://url1\\\\\\", \\\\\\"800X800\\\\\\": \\\\\\"url2\\\\\\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1024,\\n \\"height\\": 1024,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"sport\\",\\n \\"name\\": \\"basketball\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"play basketball\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\\\\\"k1\\\\\\":\\\\\\"v1\\\\\\", \\\\\\"k2\\\\\\",\\\\\\"v2\\\\\\"\\"\\n },\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"id_path\\": \\"id1/id2\\",\\n \\"name_path\\": \\"root/f1/f2\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 1,\\n \\"file_count\\": 10\\n },\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"auto_delete_left_sec\\": 0\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\",\\n \\"total_count\\": 1022\\n}","type":"json"}]', + 'title' => '搜索文件', + 'description' => '<props="china">最佳实践可参考：[搜索文件](https://help.aliyun.com/document_detail/175890.html)。</props>', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"task_id\\": \\"i:SimilarImageClustering-b67d53e7-2fe8-460f-9b95-1e93636923eb\\"\\n}","type":"json"}]', - 'title' => '创建相似图片聚类任务', - 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" - ."\n" - .'使用此功能须开通增值服务图片处理功能，此功能目前限时免费。'."\n" - ."\n" - .'使用步骤：'."\n" - ."\n" - .'- 创建相似图片聚类任务'."\n" - .'- 通过 GetTaskStatus 接口查询相似图片聚类任务是否执行完成'."\n" - .'- 通过 SearchSimilarImageClusters 接口获取相似图片聚类结果'."\n" - ."\n" - .'同一 drive 同一时刻只能有一个相似图片聚类任务运行，若上一任务未结束，再次调用相似图片聚类任务会返回失败。', ], - 'GetTaskStatus' => [ - 'summary' => '查询增值服务异步任务执行状态。'."\n" - .'目前支持的接口有：CreateSimilarImageClusterTask。', - 'path' => '/v2/image/get_task_status', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'SearchShareLink' => [ + 'path' => '/v2/share_link/search', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], + 'BearerToken' => [], ], [ - 'BearerToken' => [], + 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'read', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', + 'limit' => ['description' => '限定此次返回资源的数量，取值范围\\[1,100\\]。如果没有填写，默认取值100。'."\n" + ."\n" + .'返回结果可以小于指定的数量，但不能多于指定的数量。', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '50'], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'<br>默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'return_total_count' => ['description' => '是否返回搜到到的总记录数', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + 'order_by' => [ + 'description' => '排序字段。'."\n" + .'默认按照创建时间倒序排列。'."\n" + .'枚举值如下：'."\n" + .'- share_name（分享名称）'."\n" + .'- updated_at（修改时间）'."\n" + .'- description（描述）'."\n" + .'- created_at（创建时间）'."\n", 'type' => 'string', - 'required' => true, - 'example' => '1', + 'required' => false, + 'enumValueTitles' => ['share_name' => '分享名称', 'updated_at' => '修改时间', 'description' => '描述', 'created_at' => '创建时间'], + 'example' => 'created_at', ], - 'task_id' => [ - 'description' => '任务 id', + 'order_direction' => [ + 'description' => '排序方式。'."\n" + .'如果是排序字段是created\\_at或者updated\\_at，则默认是倒序，其他排序字段默认是升序。'."\n" + .'枚举值如下：'."\n" + .'- ASC（升序）'."\n" + .'- DESC（降序）', 'type' => 'string', - 'required' => true, - 'example' => 'i:SimilarImageClustering-b67d53e7-2fe8-460f-9b95-1e93636923eb', + 'required' => false, + 'enumValueTitles' => ['ASC' => '升序', 'DESC' => '降序'], + 'example' => 'ASC', ], + 'creators' => [ + 'description' => '分享创建者（user_id）'."\n" + .'1）如果不指定, 那么会根据用户本身的权限进行查询'."\n" + .'1.1 网盘管理员/超管：所有成员'."\n" + .'1.2 团队管理员：团队成员'."\n" + .'1.3 普通用户：自身'."\n" + ."\n" + .'2）如果指定, 那么只能指定那些有权限的成员, 参考1）', + 'type' => 'array', + 'items' => ['description' => '分享创建者', 'type' => 'string', 'required' => false, 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4'], + 'required' => false, + ], + 'query' => ['description' => '查询条件'."\n" + .'1）支持字段：'."\n" + .'1.1 created\\_at 创建时间'."\n" + .'1.2 updated\\_at 更新时间'."\n" + .'1.3 share\\_name\\_for\\_fuzzy 分享名, 支持模糊匹配（match）'."\n" + .'1.4 status 分享状态, '."\n" + .'枚举值 enabled（分享中）/disabled（已取消）'."\n" + .'1.5 expired\\_time 超时时间'."\n" + .'永不过期：expired\\_time=\'1970-01-01T00:00:00\', 返回的expiration=""'."\n" + .'expired_time<\'1970-01-02T00:00:00\'系统保留使用,不表示具体时间', 'type' => 'string', 'required' => false, 'example' => 'created_at>=\'2022-01-18T02:50:00\' and created_at<\'2022-01-19T09:45:28\' and share_name_for_fuzzy match \'HD.mp4\' and status in [\'enabled\', \'disabled\'] and expired_time=\'1970-01-01T00:00:00\''], ], 'required' => false, ], @@ -18434,52 +8483,33 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回参数', + 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'status' => [ - 'description' => '任务状态', - 'type' => 'string', - 'required' => false, - 'enumValueTitles' => [ - 'running' => '运行中', - 'failed' => '失败', - 'succeeded' => '成功', - ], - 'example' => 'running', - 'enum' => [ - 'running', - 'succeeded', - 'failed', - ], + 'items' => [ + 'description' => '分享列表', + 'type' => 'array', + 'items' => ['description' => '分享', '$ref' => '#/components/schemas/ShareLink'], ], + 'next_marker' => ['description' => '下次起始点', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'total_count' => ['description' => '总数量', 'type' => 'integer', 'format' => 'int64', 'example' => '101'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'title' => '搜索分享', + 'summary' => '搜索分享。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"status\\": \\"running\\"\\n}","type":"json"}]', - 'title' => '查询任务状态', - 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" - ."\n" - .'使用此功能须开通增值服务图片处理功能。'."\n" - ."\n" - .'该接口旨在查询增值服务异步任务状态，调用该接口前需先创建增值服务异步任务，如 CreateSimilarImageClusterTask，拿到 task id，再查询任务运行状态，判断该任务是否运行成功。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"share_id\\": \\"7JQX1FswpQ8\\",\\n \\"share_pwd\\": \\"abcF123x\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id_list\\": [\\n \\"[\\\\\\"xx\\\\\\"]\\"\\n ],\\n \\"expiration\\": \\"2020-06-28T11:33:00.000+08:00\\",\\n \\"expired\\": false,\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"videos\\",\\n \\"share_name\\": \\"video-1.MP4\\",\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"status\\": \\"enabled\\",\\n \\"preview_count\\": 10,\\n \\"save_count\\": 2,\\n \\"download_count\\": 5,\\n \\"report_count\\": 0,\\n \\"video_preview_count\\": 1,\\n \\"access_count\\": 4,\\n \\"disable_preview\\": false,\\n \\"disable_save\\": false,\\n \\"disable_download\\": false,\\n \\"preview_limit\\": 100,\\n \\"save_limit\\": 100,\\n \\"download_limit\\": 100,\\n \\"require_login\\": false,\\n \\"share_all_files\\": true,\\n \\"share_msg\\": \\"pwd: 123\\",\\n \\"save_download_limit\\": 100,\\n \\"office_editable\\": true\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\",\\n \\"total_count\\": 101\\n}","type":"json"}]', ], 'SearchSimilarImageClusters' => [ - 'summary' => '获取指定 drive 空间下的相似图片。', 'path' => '/v2/image/query_similar_image_clusters', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -18488,27 +8518,16 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'list', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -18518,51 +8537,20 @@ 'description' => '请求参数', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'marker' => [ - 'description' => '分页标记，从指定位置查询结果。若为空则表示从头开始查询。', - 'type' => 'string', - 'required' => false, - 'example' => 'YWRzX3VzZXJfcHJvZmlsZV9je1bnQh***', - ], - 'limit' => [ - 'description' => '限定此次返回结果的数量，取值范围\\[1,100\\]，默认50。'."\n" - .'返回结果可以小于指定的数量，但不能多于指定的数量。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'maximum' => '100', - 'minimum' => '0', - 'example' => '50', - 'default' => '50', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'marker' => ['description' => '分页标记，从指定位置查询结果。若为空则表示从头开始查询。', 'type' => 'string', 'required' => false, 'example' => 'YWRzX3VzZXJfcHJvZmlsZV9je1bnQh***'], + 'limit' => ['description' => '限定此次返回结果的数量，取值范围\\[1,100\\]，默认50。'."\n" + .'返回结果可以小于指定的数量，但不能多于指定的数量。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'maximum' => '100', 'minimum' => '0', 'example' => '50', 'default' => '50'], 'order' => [ 'description' => '排序顺序', 'type' => 'string', 'required' => false, - 'enumValueTitles' => [ - 'asc' => '升序', - 'desc' => '降序', - ], + 'enumValueTitles' => ['asc' => '升序', 'desc' => '降序'], 'example' => 'desc', 'default' => 'desc', - 'enum' => [ - 'desc', - 'asc', - ], - ], - 'image_thumbnail_process' => [ - 'description' => '图片缩略图处理样式', - 'type' => 'string', - 'deprecated' => true, - 'required' => false, - 'example' => 'image/resize,m_fill,h_128,w_128,limit_0/format,jpg', + 'enum' => ['desc', 'asc'], ], + 'image_thumbnail_process' => ['description' => '图片缩略图处理样式', 'type' => 'string', 'deprecated' => true, 'required' => false, 'example' => 'image/resize,m_fill,h_128,w_128,limit_0/format,jpg'], ], 'required' => false, ], @@ -18585,28 +8573,19 @@ 'files' => [ 'description' => '相似图片列表', 'type' => 'array', - 'items' => [ - 'description' => '文件详情', - '$ref' => '#/components/schemas/File', - ], + 'items' => ['description' => '文件详情', '$ref' => '#/components/schemas/File'], ], ], ], ], - 'next_marker' => [ - 'description' => '用作下次遍历的 marker', - 'type' => 'string', - 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0***', - ], + 'next_marker' => ['description' => '用作下次遍历的 marker', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0***'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"similar_image_clusters\\": [\\n {\\n \\"files\\": [\\n {\\n \\"domain_id\\": \\"\\",\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"name\\": \\"\\",\\n \\"type\\": \\"\\",\\n \\"content_type\\": \\"\\",\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\",\\n \\"description\\": \\"\\",\\n \\"trashed_at\\": \\"\\",\\n \\"file_extension\\": \\"\\",\\n \\"mime_type\\": \\"\\",\\n \\"mime_extension\\": \\"\\",\\n \\"hidden\\": true,\\n \\"size\\": 0,\\n \\"starred\\": true,\\n \\"status\\": \\"\\",\\n \\"user_meta\\": \\"\\",\\n \\"labels\\": [\\n \\"\\"\\n ],\\n \\"upload_id\\": \\"\\",\\n \\"parent_file_id\\": \\"\\",\\n \\"crc64_hash\\": \\"\\",\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"thumbnail\\": \\"\\",\\n \\"category\\": \\"\\",\\n \\"local_created_at\\": \\"\\",\\n \\"local_modified_at\\": \\"\\",\\n \\"revision_id\\": \\"\\",\\n \\"investigation_info\\": {\\n \\"status\\": 0,\\n \\"suggestion\\": \\"\\"\\n },\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"运动\\",\\n \\"name\\": \\"篮球\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"一起打篮球\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"ex_fields_info\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"content_uri\\": \\"\\",\\n \\"streams_info\\": {\\n \\"key\\": {\\n \\"crc64_hash\\": \\"\\",\\n \\"size\\": 0,\\n \\"content_hash\\": \\"\\",\\n \\"content_hash_name\\": \\"\\",\\n \\"download_url\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"thumbnail\\": \\"\\"\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"revision_version\\": 0,\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"中国\\",\\n \\"province\\": \\"浙江省\\",\\n \\"city\\": \\"杭州市\\",\\n \\"district\\": \\"滨江区\\",\\n \\"township\\": \\"西兴街道\\",\\n \\"address_line\\": \\"浙江省杭州市滨江区西兴街道江陵路\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"punish_flag\\": 0,\\n \\"id_path\\": \\"\\",\\n \\"name_path\\": \\"\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\",\\n \\"last_modifier_type\\": \\"\\",\\n \\"last_modifier_id\\": \\"\\",\\n \\"last_modifier_name\\": \\"\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 0,\\n \\"file_count\\": 0\\n },\\n \\"trashed\\": true,\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"location\\": \\"\\",\\n \\"semantic_result\\": {\\n \\"semantic_similarity\\": 0.879,\\n \\"document_contents\\": [\\n {\\n \\"element_contents\\": [\\n {\\n \\"type\\": \\"text\\",\\n \\"content\\": \\"文本片段\\",\\n \\"url\\": \\"http://aliyun.com\\",\\n \\"time_range\\": [\\n 0\\n ]\\n }\\n ]\\n }\\n ],\\n \\"scene_contents\\": [\\n {\\n \\"time_range\\": [\\n 0\\n ],\\n \\"key_frames\\": [\\n {\\n \\"frame_time\\": 1000,\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ],\\n \\"thumbnail_url\\": \\"http://aliyun.com\\"\\n }\\n ]\\n },\\n \\"sync_flag\\": true,\\n \\"sync_device_flag\\": true,\\n \\"origin_parent_file_id\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"custom_field_1\\": \\"\\",\\n \\"custom_field_2\\": \\"\\",\\n \\"auto_delete_left_sec\\": 0,\\n \\"ai_processed\\": \\"\\",\\n \\"modified_at\\": \\"\\"\\n }\\n ]\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0***\\"\\n}","type":"json"}]', + 'staticInfo' => ['returnType' => 'synchronous'], 'title' => '查询相似图片聚类结果', + 'summary' => '获取指定 drive 空间下的相似图片。', 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" ."\n" .'使用此功能须开通增值服务图片处理功能。'."\n" @@ -18617,19 +8596,18 @@ .'- 未执行聚类任务调用该接口返回空列表。'."\n" .'- 相似图片聚类任务是增量更新聚类结果。若本次聚类任务未完成，则返回上一次聚类结果。'."\n" .'></notice>', - ], - 'GetAsyncTask' => [ - 'summary' => '获取异步任务信息。', - 'path' => '/v2/async_task/get', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"similar_image_clusters\\": [\\n {\\n \\"files\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"5d79206586bb5dd69fb34c349282718146c55da7\\",\\n \\"name\\": \\"1.mov\\",\\n \\"type\\": \\"file\\",\\n \\"content_type\\": \\"application/json\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"image file\\",\\n \\"trashed_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"file_extension\\": \\"txt\\",\\n \\"hidden\\": false,\\n \\"size\\": 1024,\\n \\"starred\\": false,\\n \\"status\\": \\"available\\",\\n \\"labels\\": [\\n \\"[\\\\\\"label1:1\\\\\\", \\\\\\"label2:2\\\\\\"]\\"\\n ],\\n \\"upload_id\\": \\"C9DCFE5A82644AC7A02DB74C30C934A6\\",\\n \\"parent_file_id\\": \\"3d5b846942cf94fa72324c8a4bda34e81da635a\\",\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"category\\": \\"image\\",\\n \\"local_created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"local_modified_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"revision_id\\": \\"5d5b846942cf94fa72324c14a4bda34e81da635d\\",\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\\\\\"128X128\\\\\\": \\\\\\"https://url1\\\\\\", \\\\\\"800X800\\\\\\": \\\\\\"url2\\\\\\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1024,\\n \\"height\\": 1024,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"sport\\",\\n \\"name\\": \\"basketball\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"play basketball\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\\\\\"k1\\\\\\":\\\\\\"v1\\\\\\", \\\\\\"k2\\\\\\",\\\\\\"v2\\\\\\"\\"\\n },\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"id_path\\": \\"id1/id2\\",\\n \\"name_path\\": \\"root/f1/f2\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 1,\\n \\"file_count\\": 10\\n },\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"auto_delete_left_sec\\": 0\\n }\\n ]\\n }\\n ],\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0***\\"\\n}","type":"json"}]', + ], + 'SearchStories' => [ + 'summary' => '根据用户指定的条件，查询指定 drive 空间下的故事列表。', + 'path' => '/v2/image/find_stories', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -18638,40 +8616,90 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体。', + 'description' => '请求参数', 'type' => 'object', 'properties' => [ - 'async_task_id' => [ - 'description' => '异步任务id', + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'story_id' => ['description' => '故事 id', 'type' => 'string', 'required' => false, 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003'], + 'story_type' => ['description' => '故事类型。由用户创建时指定。', 'type' => 'string', 'required' => false, 'example' => 'PeopleMemory'], + 'story_name' => ['description' => '故事名称。'."\n" + .'长度不超过 1024 字节。', 'type' => 'string', 'required' => false, 'example' => 'Food'], + 'story_start_time_range' => [ + 'description' => '创建故事照片或视频的开始时间范围', + 'type' => 'object', + 'properties' => [ + 'start' => ['description' => '起始时间。时间格式为 RFC3339。', 'type' => 'string', 'required' => false, 'example' => '2016-12-31T00:00:00+08:00'], + 'end' => ['description' => '结束时间。时间格式为 RFC3339。', 'type' => 'string', 'required' => false, 'example' => '2022-12-31T00:00:00+08:00'], + ], + 'required' => false, + ], + 'story_end_time_range' => [ + 'description' => '创建故事照片或视频的结束时间范围', + 'type' => 'object', + 'properties' => [ + 'start' => ['description' => '起始时间。时间格式为 RFC3339。', 'type' => 'string', 'required' => false, 'example' => '2016-12-31T00:00:00+08:00'], + 'end' => ['description' => '结束时间。时间格式为 RFC3339。', 'type' => 'string', 'required' => false, 'example' => '2022-12-31T00:00:00+08:00'], + ], + 'required' => false, + ], + 'create_time_range' => [ + 'description' => '创建故事时间范围', + 'type' => 'object', + 'properties' => [ + 'start' => ['description' => '起始时间。时间格式为 RFC3339。', 'type' => 'string', 'required' => false, 'example' => '2016-12-31T00:00:00+08:00'], + 'end' => ['description' => '结束时间。时间格式为 RFC3339。', 'type' => 'string', 'required' => false, 'example' => '2022-12-31T00:00:00+08:00'], + ], + 'required' => false, + ], + 'face_group_ids' => [ + 'description' => '人脸分组列表。'."\n" + .'查询人物故事时使用。', + 'type' => 'array', + 'items' => ['description' => '人脸分组 id', 'type' => 'string', 'required' => false, 'example' => 'Cluster-be377f73-3502-433c-8309-a01e659c128c'], + 'required' => false, + ], + 'custom_labels' => ['description' => '自定义标签。'."\n" + .'可查询多个字段，使用 "," 分隔。', 'type' => 'string', 'deprecated' => true, 'required' => false, 'example' => 'key1=value1,key2!=value2'], + 'with_empty_stories' => ['description' => '是否返回空故事。默认 false。', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + 'marker' => ['description' => '查询的起始位置。若为空则表示从头开始查询。', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDODBhNDQ2Nzhl***'], + 'limit' => ['description' => '限定此次返回资源的数量，取值范围\\[1,100\\]。'."\n" + .'默认 100。'."\n" + .'返回结果可以小于指定的数量，但不能多于指定的数量。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '100', 'default' => '100'], + 'sort' => [ + 'description' => '排序字段', 'type' => 'string', - 'required' => true, - 'example' => '000e89fb-cf8f-11e9-8ab4-b6e980803a3b', + 'required' => false, + 'enumValueTitles' => ['StoryName' => '按故事名称排序', 'StoryEndTime' => '按故事结束时间排序', 'CreateTime' => '按故事创建时间排序', 'StoryStartTime' => '按故事开始时间排序'], + 'example' => 'CreateTime', + 'enum' => ['CreateTime', 'StoryName', 'StoryStartTime', 'StoryEndTime'], + ], + 'order' => [ + 'description' => '排序方式', + 'type' => 'string', + 'required' => false, + 'enumValueTitles' => ['asc' => '升序', 'desc' => '降序'], + 'example' => 'desc', + 'enum' => ['asc', 'desc'], ], + 'cover_image_thumbnail_process' => ['description' => '图片封面缩略图控制参数', 'type' => 'string', 'deprecated' => true, 'required' => false, 'example' => 'image/resize,m_fill,h_128,w_128,limit_0/format,jpg'], + 'cover_video_thumbnail_process' => ['description' => '视频封面缩略图控制参数', 'type' => 'string', 'deprecated' => true, 'required' => false, 'example' => 'video/snapshot,t_1000,f_jpg,w_0,h_0,m_fast,ar_auto'], + 'url_expire_sec' => ['description' => '缩略图过期时间。单位为秒，最短 10 秒，最长 86400 秒。', 'type' => 'integer', 'format' => 'int64', 'deprecated' => true, 'required' => false, 'maximum' => '86400', 'minimum' => '10', 'example' => '900', 'default' => '900'], ], 'required' => false, ], @@ -18681,215 +8709,96 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '返回参数', 'type' => 'object', 'properties' => [ - 'async_task_id' => [ - 'title' => 'Id of the request', - 'description' => '异步任务id', - 'type' => 'string', - 'example' => '000e89fb-cf8f-11e9-8ab4-b6e980803a3b', - ], - 'status' => [ - 'description' => '<warning>已废弃（推荐使用state字段替代）</warning>'."\n" - ."\n" - .'任务状态'."\n" - ."\n" - .'- Failed（失败）'."\n" - ."\n" - .'- Running（运行中）'."\n" - ."\n" - .'- PartialSucceed（部分成功）'."\n" - ."\n" - .'- Succeed（成功）', - 'type' => 'string', - 'enumValueTitles' => [ - 'Failed' => '失败', - 'Running' => '运行中', - 'PartialSucceed' => '部分成功', - 'Succeed' => '成功', - ], - 'example' => 'Succeed', - ], - 'state' => [ - 'description' => '任务状态'."\n" - ."\n" - .'- Failed（失败）'."\n" - ."\n" - .'- Running（运行中）'."\n" - ."\n" - .'- PartialSucceed（部分成功）'."\n" - ."\n" - .'- Succeed（成功）', - 'type' => 'string', - 'example' => 'Succeed', - ], - 'message' => [ - 'description' => '<warning>已废弃（推荐使用error_message字段替代）</warning>'."\n" - .'异步任务错误信息', - 'type' => 'string', - 'example' => 'The request has been failed due to some unknown error. Please try again later.', - ], - 'err_code' => [ - 'description' => '<warning>已废弃（推荐使用error_code字段替代）</warning>'."\n" - .'异步任务错误码', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '404', - ], - 'total_process' => [ - 'description' => '异步任务需处理总量，如服务端打包下载需打包的文件量', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '1000', - ], - 'consumed_process' => [ - 'description' => '异步任务已处理总量，如服务端打包下载已打包的文件量', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '100', - ], - 'url' => [ - 'description' => '异步任务生成数据的下载地址，如服务端打包下载任务生成下载地址', - 'type' => 'string', - 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx', - ], - 'error_code' => [ - 'description' => '任务错误码', - 'type' => 'string', - 'example' => 'InternalError', - ], - 'error_message' => [ - 'description' => '任务错误信息', - 'type' => 'string', - 'example' => 'The request has been failed due to some unknown error. Please try again later.', - ], - 'uncompress_file_list' => [ - 'description' => '解压文件信息列表', + 'items' => [ + 'description' => '故事列表', 'type' => 'array', - 'items' => [ - 'description' => '解压文件信息', - '$ref' => '#/components/schemas/UncompressedFileInfo', - ], - ], - 'category' => [ - 'description' => '任务自定义类别', - 'type' => 'string', - 'example' => 'album', - ], - 'created_at' => [ - 'description' => '任务创建时间，ISO格式， 如：2019-03-28T13:03:29.298Z', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'started_at' => [ - 'description' => '任务开始时间，ISO格式， 如：2019-03-28T13:03:29.298Z', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'finished_at' => [ - 'description' => '任务完成时间，ISO格式， 如：2019-03-28T13:03:29.298Z', - 'type' => 'string', - 'example' => '2019-08-20T06:51:27.292Z', - ], - 'skipped_process' => [ - 'description' => '异步任务已跳过处理的数量', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', - ], - 'failed_process' => [ - 'description' => '异步任务已处理失败的数量', - 'type' => 'integer', - 'format' => 'int64', - 'example' => '0', + 'items' => ['description' => '故事详情', '$ref' => '#/components/schemas/Story'], ], + 'next_marker' => ['description' => '下次查询位置', 'type' => 'string', 'example' => 'Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJ***'], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"async_task_id\\": \\"000e89fb-cf8f-11e9-8ab4-b6e980803a3b\\",\\n \\"status\\": \\"Succeed\\",\\n \\"state\\": \\"Succeed\\",\\n \\"message\\": \\"The request has been failed due to some unknown error. Please try again later.\\",\\n \\"err_code\\": 404,\\n \\"total_process\\": 1000,\\n \\"consumed_process\\": 100,\\n \\"url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"error_code\\": \\"InternalError\\",\\n \\"error_message\\": \\"The request has been failed due to some unknown error. Please try again later.\\",\\n \\"uncompress_file_list\\": [\\n {\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"is_folder\\": true,\\n \\"name\\": \\"\\",\\n \\"size\\": 0,\\n \\"updated_at\\": 0,\\n \\"items\\": [\\n {\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"is_folder\\": true,\\n \\"name\\": \\"\\",\\n \\"size\\": 0,\\n \\"updated_at\\": 0,\\n \\"items\\": [\\n {\\n \\"drive_id\\": \\"\\",\\n \\"file_id\\": \\"\\",\\n \\"is_folder\\": true,\\n \\"name\\": \\"\\",\\n \\"size\\": 0,\\n \\"updated_at\\": 0,\\n \\"items\\": []\\n }\\n ]\\n }\\n ]\\n }\\n ],\\n \\"category\\": \\"album\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"started_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"finished_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"skipped_process\\": 0,\\n \\"failed_process\\": 0\\n}","type":"json"}]', - 'title' => '获取异步任务信息', - ], - 'GetVideoPreviewPlayMeta' => [ - 'summary' => '获取视频播放元信息。', - 'path' => '/v2/file/get_video_preview_play_meta', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', + 'staticInfo' => ['returnType' => 'synchronous'], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"story_id\\": \\"9132e0d8-fe92-4e56-86c3-f5f112308003\\",\\n \\"story_type\\": \\"PeopleMemory\\",\\n \\"story_sub_type\\": \\"Solo\\",\\n \\"story_name\\": \\"test_name\\",\\n \\"story_start_time\\": \\"2021-01-14T10:17:18.102700407+08:00\\",\\n \\"story_end_time\\": \\"2022-01-14T10:17:18.102700407+08:00\\",\\n \\"created_at\\": \\"2022-01-14T10:17:18.102700407+08:00\\",\\n \\"updated_at\\": \\"2022-01-14T10:17:18.102700407+08:00\\",\\n \\"face_group_ids\\": [\\n \\"Cluster-be377f73-3502-433c-8309-a01e659c128c\\"\\n ],\\n \\"cover_file_id\\": \\"63e5e4340f76cb3ead5f40f68163f0f967c1a7bf\\",\\n \\"cover_file_thumbnail_url\\": \\"https://pds-domain-bucket.oss-cn-hangzhou.aliyuncs.com/Bh1HqdAs%2F1001%2F642a88c26f99cad589904fc8a6b2db6021c6601f%2F642a88c29391c47f221e49e88a21fa9b0a9e5063?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5eGE8nGtYZ59bSnbUODlmsjTttVhpbFpjz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNXD6XXO2qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABVgD3mIAeUoDYKTJrFTPdmAPIrlUUQ1HZstB0ZVHvYByygr3oeitG9FEQ8lcfaZYJOtWRchdgH8tsSwHj2jI1vMeAiLHgbW98SPA3yfN8OR1kLW73uq3LAvekc9Qldz33YTM4JA5MNJzR8x5O6Oe4rY5OMSSVU5F%2Ffr8bJZD%2FXMM%3D&x-oss-access-key-id=STS.NT3XsrXYXBvLoe2rkvBTyiSnD&x-oss-expires=1685966251&x-oss-process=image%2Fresize%2Cw_500&x-oss-signature=XimW6haBxYktKg4cstMfpd%2F2LSoMibj6A%2B7ZqBJcSbQ%3D&x-oss-signature-version=OSS2\\",\\n \\"story_file_list\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"5d79206586bb5dd69fb34c349282718146c55da7\\",\\n \\"name\\": \\"1.mov\\",\\n \\"type\\": \\"file\\",\\n \\"content_type\\": \\"application/json\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"image file\\",\\n \\"trashed_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"file_extension\\": \\"txt\\",\\n \\"hidden\\": false,\\n \\"size\\": 1024,\\n \\"starred\\": false,\\n \\"status\\": \\"available\\",\\n \\"labels\\": [\\n \\"[\\\\\\"label1:1\\\\\\", \\\\\\"label2:2\\\\\\"]\\"\\n ],\\n \\"upload_id\\": \\"C9DCFE5A82644AC7A02DB74C30C934A6\\",\\n \\"parent_file_id\\": \\"3d5b846942cf94fa72324c8a4bda34e81da635a\\",\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"category\\": \\"image\\",\\n \\"local_created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"local_modified_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"revision_id\\": \\"5d5b846942cf94fa72324c14a4bda34e81da635d\\",\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\\\\\"128X128\\\\\\": \\\\\\"https://url1\\\\\\", \\\\\\"800X800\\\\\\": \\\\\\"url2\\\\\\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1024,\\n \\"height\\": 1024,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"sport\\",\\n \\"name\\": \\"basketball\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"play basketball\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\\\\\"k1\\\\\\":\\\\\\"v1\\\\\\", \\\\\\"k2\\\\\\",\\\\\\"v2\\\\\\"\\"\\n },\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"id_path\\": \\"id1/id2\\",\\n \\"name_path\\": \\"root/f1/f2\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 1,\\n \\"file_count\\": 10\\n },\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"auto_delete_left_sec\\": 0\\n }\\n ],\\n \\"custom_id\\": \\"test\\",\\n \\"custom_labels\\": {\\n \\"key\\": \\"value\\"\\n }\\n }\\n ],\\n \\"next_marker\\": \\"Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJ***\\"\\n}","type":"json"}]', + 'title' => '查询故事列表', + 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" + ."\n" + .'使用此功能须开通增值服务图片处理功能。'."\n" + ."\n" + .'使用查询故事列表前，需要用户调用 CreateStory 或 CreateCustomizedStory 接口创建故事，否则返回空列表。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'SearchUser' => [ + 'path' => '/v2/user/search', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'AK' => [], + 'BearerToken' => [], ], [ - 'BearerToken' => [], + 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'readAndWrite', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'read', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - ], + 'systemTags' => ['operationType' => 'list', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => false, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求body', 'type' => 'object', 'properties' => [ - 'share_id' => [ - 'description' => '分享id。'."\n" - .'如果通过分享操作文件，请携带`x-share-token` header鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。'."\n" - .'`share_id`和`drive_id`两者必须有一个字段赋值。', + 'nick_name' => ['description' => '用户昵称，最长128字符', 'type' => 'string', 'required' => false, 'example' => 'pdsuer', 'maxLength' => 128, 'minLength' => 0], + 'nick_name_for_fuzzy' => ['description' => '昵称-模糊搜索，最长128字符', 'type' => 'string', 'required' => false, 'example' => 'la', 'maxLength' => 128, 'minLength' => 0], + 'user_name' => ['description' => '用户名称，最长128字符', 'type' => 'string', 'required' => false, 'example' => 'pds', 'maxLength' => 128, 'minLength' => 0], + 'phone' => ['description' => '手机号', 'type' => 'string', 'required' => false, 'example' => '13900001111'], + 'email' => ['description' => '邮箱地址', 'type' => 'string', 'required' => false, 'example' => '123@pds.com'], + 'status' => [ + 'description' => '用户状态'."\n" + ."\n" + .'- disabled（禁止）'."\n" + ."\n" + .'- enabled（使能）', 'type' => 'string', 'required' => false, - 'example' => '7JQX1FswpQ8', + 'enumValueTitles' => ['disabled' => '禁止', 'enabled' => '使能'], + 'example' => 'enabled', ], - 'drive_id' => [ - 'description' => '空间id', + 'role' => [ + 'description' => '角色'."\n" + ."\n" + .'- superadmin（超级管理员）'."\n" + ."\n" + .'- admin（管理员）'."\n" + ."\n" + .'- user（用户）', 'type' => 'string', 'required' => false, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - 'category' => [ - 'description' => '所属分类。'."\n" - .'需要开通对应的转码功能，枚举如下：'."\n" - .'- live_transcoding（live边转边播）'."\n" - .'- quick_video（quick边转边播）'."\n" - .'- offline_audio（离线音频转码）'."\n" - .'- offline_video（离线视频转码）', - 'type' => 'string', - 'required' => true, - 'example' => 'live_transcoding', + 'enumValueTitles' => ['superadmin' => '超级管理员', 'admin' => '管理员', 'user' => '用户'], + 'example' => 'user', ], + 'marker' => ['description' => '设定结果从marker之后按字母排序的第一个开始返回。如果不设定，则从头开始返回数据。'."\n" + .'<br>默认值：无', 'type' => 'string', 'required' => false, 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'limit' => ['description' => '限定此次返回资源的数量，取值范围为[1,100]，默认返回100', 'type' => 'integer', 'format' => 'int32', 'required' => false, 'example' => '100'], ], 'required' => false, ], @@ -18902,77 +8811,134 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'title' => 'Id of the request', - 'description' => '域id', - 'type' => 'string', - 'example' => 'bj1', - ], - 'share_id' => [ - 'description' => '分享id', - 'type' => 'string', - 'example' => '7JQX1FswpQ8', - ], - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件id', - 'type' => 'string', - 'example' => 'fileid1', - ], - 'video_preview_play_meta' => [ - 'description' => '播放元信息', - '$ref' => '#/components/schemas/VideoPreviewPlayMeta', + 'next_marker' => ['title' => 'Id of the request', 'description' => '下一页起始资源标识符, 最后一页该值为空', 'type' => 'string', 'example' => 'NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg'], + 'items' => [ + 'description' => '用户信息列表', + 'type' => 'array', + 'items' => ['description' => '用户信息', '$ref' => '#/components/schemas/User'], ], ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"share_id\\": \\"7JQX1FswpQ8\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"fileid1\\",\\n \\"video_preview_play_meta\\": {\\n \\"meta\\": {\\n \\"duration\\": 10,\\n \\"width\\": 1280,\\n \\"height\\": 720\\n },\\n \\"live_transcoding_task_list\\": [\\n {\\n \\"template_id\\": \\"264_720p\\",\\n \\"status\\": \\"finished\\",\\n \\"keep_original_resolution\\": true\\n }\\n ],\\n \\"category\\": \\"live_transcoding\\",\\n \\"quick_video_list\\": [\\n {\\n \\"template_id\\": \\"264_720p\\",\\n \\"status\\": \\"finished\\"\\n }\\n ],\\n \\"offline_video_transcoding_list\\": [\\n {\\n \\"template_id\\": \\"264_720p\\",\\n \\"status\\": \\"finished\\",\\n \\"keep_original_resolution\\": \\"true\\"\\n }\\n ]\\n }\\n}","type":"json"}]', - 'title' => '获取视频播放元信息', - 'description' => '<props="china">详细请参考最佳实践文档：[在线预览视频](~~427477~~)。</props>', + 'title' => '搜索用户', + 'summary' => '搜索用户。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"next_marker\\": \\"NWQ1Yjk4YmI1ZDRlYmU1Y2E0YWE0NmJhYWJmODBhNDQ2NzhlMTRhMg\\",\\n \\"items\\": [\\n {\\n \\"domain_id\\": \\"bj1\\",\\n \\"user_id\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"avatar\\": \\"http://aa.com/1.jpg\\",\\n \\"created_at\\": 1639762579768,\\n \\"updated_at\\": 1639762579768,\\n \\"email\\": \\"a@aliyunpds.com\\",\\n \\"nick_name\\": \\"001\\",\\n \\"phone\\": \\"13900001111\\",\\n \\"role\\": \\"user\\",\\n \\"status\\": \\"enabled\\",\\n \\"user_name\\": \\"pds\\",\\n \\"description\\": \\"vipuser\\",\\n \\"default_drive_id\\": \\"1\\",\\n \\"user_data\\": {\\n \\"key\\": \\"\\"\\n },\\n \\"creator\\": \\"user1\\"\\n }\\n ]\\n}","type":"json"}]', ], - 'GetVideoPreviewPlayInfo' => [ - 'summary' => '获取视频播放信息。', - 'path' => '/v2/file/get_video_preview_play_info', - 'methods' => [ - 'post', + 'Token' => [ + 'summary' => 'OAuth2.0授权流程的获取访问令牌。', + 'path' => '/v2/oauth/token', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], + 'security' => [ + [ + 'Anonymous' => [], + ], ], - 'schemes' => [ - 'https', + 'consumes' => ['application/x-www-form-urlencoded'], + 'produces' => ['application/json'], + 'deprecated' => false, + 'parameters' => [ + [ + 'name' => 'domain_id', + 'in' => 'host', + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], + ], + [ + 'name' => 'grant_type', + 'in' => 'formData', + 'schema' => ['description' => '授权类型，有以下取值：'."\n" + ."\n" + .'authorization\\_code （通过认证完成后获取的code来换取token）'."\n" + ."\n" + .'refresh\\_token（通过上次授权获取的refresh_token来获取token）'."\n" + ."\n" + .'urn:ietf:params:oauth:grant-type:jwt-bearer（通过JWT方式获取token）', 'type' => 'string', 'required' => true, 'example' => 'refresh_token'], + ], + [ + 'name' => 'code', + 'in' => 'formData', + 'schema' => ['description' => '认证完成后回调地址中携带的code，当grant\\_type为authorization\\_code时，此参数必传'."\n" + ."\n", 'type' => 'string', 'required' => false, 'example' => '0045157fa8e24f4f9a0d9e3ff158c1e0'], + ], + [ + 'name' => 'redirect_uri', + 'in' => 'formData', + 'schema' => ['description' => '填写发起authorize时传入的redirect\\_uri，当grant\\_type为authorization\\_code时必填'."\n" + ."\n", 'type' => 'string', 'required' => false, 'example' => 'https://aliyun.com/pds'."\n"], + ], + [ + 'name' => 'client_id', + 'in' => 'formData', + 'schema' => ['description' => '在阿里云PDS控制台申请的App对应的ID'."\n" + ."\n", 'type' => 'string', 'required' => true, 'example' => '1Zu***flH'], + ], + [ + 'name' => 'client_secret', + 'in' => 'formData', + 'schema' => ['description' => '在阿里云PDS控制台申请的App对应的Secret，WebServer类型的App必填此参数'."\n" + ."\n", 'type' => 'string', 'required' => false, 'example' => '80D***3i5'."\n"], + ], + [ + 'name' => 'refresh_token', + 'in' => 'formData', + 'schema' => ['description' => '用于刷新Token的令牌，当grant\\_type为refresh\\_token时此参数必传'."\n" + ."\n", 'type' => 'string', 'required' => false, 'example' => '399623e13353490391266c7d48a13ed1'], + ], + [ + 'name' => 'assertion', + 'in' => 'formData', + 'schema' => ['description' => '通过JWT私钥签名的字符串，里面包含待授权的用户信息和授权参数，结构参考JWTPayload。当grant_type为urn:ietf:params:oauth:grant-type:jwt-bearer时此参数必填。'."\n" + ."\n", 'type' => 'string', 'required' => false, 'example' => 'ey***asd'."\n"], + ], ], - 'tags' => [ - 'api', + 'responses' => [ + 200 => [ + 'headers' => [], + 'schema' => ['description' => '访问令牌信息', '$ref' => '#/components/schemas/Token'], + ], + ], + 'title' => '获取访问令牌', + 'description' => '<props="china">详细使用方法参考用户指南：[用户指南链接](https://help.aliyun.com/document_detail/175894.html)。</props>'."\n" + ."\n" + .'<props="china">JWT方式登录参考文档：[JWT登录链接](https://help.aliyun.com/document_detail/175893.html)。</props>'."\n" + ."\n" + .'<props="intl">详细使用方法参考用户指南：[用户指南链接](https://www.alibabacloud.com/help/zh/pds/latest/oauth2-for-web-server-app?spm=a2c63.p38356.0.0.267148fbJdRB0P)。</props>'."\n" + ."\n" + .'<props="intl">JWT方式登录参考文档：[JWT登录链接](https://www.alibabacloud.com/help/zh/pds/latest/jwt-application?spm=a2c63.p38356.0.0.45ab5f06NnPJqj)。</props>', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'TrashFile' => [ + 'path' => '/v2/recyclebin/trash', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ - 'BearerToken' => [], + 'AK' => [], ], [ - 'AK' => [], + 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - ], + 'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', @@ -18982,73 +8948,8 @@ 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'share_id' => [ - 'description' => '分享id。'."\n" - .'如果通过分享操作文件，请携带`x-share-token` header鉴权并传递此字段，此时`drive_id`无效。否则请使用`aksk`或者`access_token`方式鉴权，并传递`drive_id`字段。'."\n" - .'`share_id`和`drive_id`两者必须有一个字段赋值。', - 'type' => 'string', - 'required' => false, - 'example' => '7JQX1FswpQ8', - ], - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'required' => false, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件id', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - 'category' => [ - 'description' => '所属分类。'."\n" - .'需要开通对应的转码功能，枚举如下：'."\n" - .'- live_transcoding（live边转边播）'."\n" - .'- quick_video（quick边转边播）'."\n" - .'- offline_audio（离线音频转码）'."\n" - .'- offline_video（离线视频转码）', - 'type' => 'string', - 'required' => true, - 'enumValueTitles' => [], - 'example' => 'quick_video', - ], - 'template_id' => [ - 'description' => '清晰度模板id。'."\n" - .'填空表示取所有可用清晰度模板', - 'type' => 'string', - 'required' => false, - 'example' => '264_480p', - ], - 'get_without_url' => [ - 'description' => '是否不获取播放url。'."\n" - .'如果填true，只会获取转码元信息，并不会触发ts转码，返回的信息中没有播放url。否则会返回播放url，如果此template_id的视频还未转码，后台将触发器转码。'."\n" - .'转码会产生对应的增值服务费用', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'url_expire_sec' => [ - 'description' => 'url超时时间，单位：秒。'."\n" - .'默认15分钟，最大4小时。', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '3600', - ], - 're_transcode' => [ - 'description' => '是否发起重转。设置为 true 时会对文件发起重转，固定响应 202 等待重试。使用该参数前请先联系我们配置开启支持。', - 'type' => 'boolean', - 'required' => false, - 'example' => 'true', - ], - 'get_master_url' => [ - 'description' => '是否获取 master m3u8 的 url，仅在 category = quick_video 时有效', - 'type' => 'boolean', - 'required' => false, - 'example' => 'false', - ], + 'drive_id' => ['description' => '空间ID', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件或文件夹ID', 'type' => 'string', 'required' => true, 'example' => '4221bf6e6ab43c255edc4463bf3a6f5f5d317406'], ], 'required' => false, ], @@ -19061,68 +8962,32 @@ 'description' => 'Schema of Response', 'type' => 'object', 'properties' => [ - 'domain_id' => [ - 'description' => '域id', - 'type' => 'string', - 'example' => 'bj1', - ], - 'share_id' => [ - 'title' => 'Id of the request', - 'description' => '分享id', - 'type' => 'string', - 'example' => '7JQX1FswpQ8', - ], - 'drive_id' => [ - 'description' => '空间id', - 'type' => 'string', - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件id', - 'type' => 'string', - 'example' => 'fileid1', - ], - 'video_preview_play_info' => [ - 'description' => '播放信息', - '$ref' => '#/components/schemas/VideoPreviewPlayInfo', - ], + 'domain_id' => ['title' => 'Id of the request', 'description' => '域ID', 'type' => 'string', 'example' => 'bj1'], + 'drive_id' => ['description' => '空间ID', 'type' => 'string', 'example' => '1'], + 'file_id' => ['description' => '文件或文件夹ID', 'type' => 'string', 'example' => '4221bf6e6ab43c255edc4463bf3a6f5f5d317406'], + 'async_task_id' => ['description' => '异步任务ID'."\n" + ."\n" + .'如果返回为空字符串，表示直接放入回收站成功。'."\n" + ."\n" + .'如果返回非空字符串，表示需要经过异步处理。调用GetAsyncTask，传递异步任务ID，获取任务信息。', 'type' => 'string', 'example' => '13ebd3a24dba4166b1527add676ef2866051b4d5dele16'], ], ], ], + 204 => [], ], - 'eventInfo' => [ - 'enable' => false, - 'eventNames' => [], + 'title' => '放入回收站', + 'summary' => '文件或文件夹放入回收站。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"share_id\\": \\"7JQX1FswpQ8\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"fileid1\\",\\n \\"video_preview_play_info\\": {\\n \\"category\\": \\"live_transcoding\\",\\n \\"meta\\": {\\n \\"duration\\": 0,\\n \\"width\\": 0,\\n \\"height\\": 0\\n },\\n \\"live_transcoding_task_list\\": [\\n {\\n \\"template_id\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"keep_original_resolution\\": true,\\n \\"preview_url\\": \\"\\"\\n }\\n ],\\n \\"quick_video_list\\": [\\n {\\n \\"template_id\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"url\\": \\"\\",\\n \\"preview_url\\": \\"\\"\\n }\\n ],\\n \\"offline_video_transcoding_list\\": [\\n {\\n \\"template_id\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"keep_original_resolution\\": true,\\n \\"url\\": \\"\\"\\n }\\n ],\\n \\"live_transcoding_subtitle_task_list\\": [\\n {\\n \\"language\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"url\\": \\"\\"\\n }\\n ],\\n \\"quick_video_subtitle_list\\": [\\n {\\n \\"language\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"url\\": \\"\\"\\n }\\n ],\\n \\"offline_video_transcoding_subtitle_list\\": [\\n {\\n \\"language\\": \\"\\",\\n \\"status\\": \\"\\",\\n \\"url\\": \\"\\"\\n }\\n ],\\n \\"master_url\\": \\"\\"\\n }\\n}","type":"json"}]', - 'title' => '获取视频播放信息', - 'description' => '- **请确保在使用该接口前，已充分了解网盘与相册服务产品的收费方式和[价格](~~425220~~)。**'."\n" - ."\n" - .'- 调用该接口前，请确保当前 domain 已开通对应 category 的转码功能。转码功能开通和转码模板配置请联系我们的技术支持，详情参考[联系我们](~~175917~~)。'."\n" - ."\n" - .'- 该接口为同步接口。如果请求时对应文件在对应转码方式上尚未转码，则接口会响应 **202 VideoPreviewWaitAndRetry** 提示等待重试。如果请求时对应文件在对应转码方式上无法转码，则接口会响应 **404 NotFound.VideoPreviewInfo**。'."\n" - ."\n" - .'- 该接口会产生转码数据并保存到租户 domain 的增值数据空间，以供最终用户进行音视频在线播放。对于特定的转码方式，该接口提供了 domain 级去重转码能力。'."\n" - ."\n" - .'- 该接口返回的播放链接在转码类型为 quick_video 时，将包含未进行 URL 编码的 `{ `和` }`字符。IOS 平台开发时请注意先对返回链接进行 URL 解码和编码以避免系统 NSURL 库解码失败。'."\n" - ."\n" - .'- 该接口返回的播放链接在转码类型为 quick_video 时，根据链接对应 m3u8 内容获取分片内容时将不支持 Range Get。'."\n" - ."\n" - .'<props="china">更多详细内容请参考最佳实践文档：[在线预览视频](~~427477~~)。</props>', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"4221bf6e6ab43c255edc4463bf3a6f5f5d317406\\",\\n \\"async_task_id\\": \\"13ebd3a24dba4166b1527add676ef2866051b4d5dele16\\"\\n}","type":"json"}]', ], - 'CreateIdentityToBenefitPkgMapping' => [ - 'summary' => '创建实体和权益包关联，可用于给用户绑定权益包。', - 'path' => '/v2/benefit/identity_to_benefit_pkg_mapping/create', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'tags' => [ - 'api', - ], + 'UnLinkAccount' => [ + 'path' => '/v2/account/unlink', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -19131,99 +8996,122 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'none'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['title' => 'A short description of struct', 'description' => 'A short description of struct', 'type' => 'string', 'required' => true], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数', + 'description' => '请求体', 'type' => 'object', 'properties' => [ - 'identity_type' => [ - 'description' => '实体的类型'."\n" - ."\n" - .'管理用户权益时，传user', - 'type' => 'string', - 'required' => true, - 'example' => 'user', - 'enum' => [ - 'user', - ], - ], - 'identity_id' => [ - 'description' => '实体的唯一标识'."\n" - ."\n" - .'管理用户权益时，传user_id', - 'type' => 'string', - 'required' => true, - 'example' => 'user123', - ], - 'benefit_pkg_id' => [ - 'description' => '权益包的唯一标识', - 'type' => 'string', - 'required' => true, - 'example' => '40cb7794c9294', - ], - 'amount' => [ - 'description' => '权益包数量'."\n" - ."\n" - .'对资源类权益包生效，非必填参数，默认为1', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1', - ], - 'expire_time' => [ - 'description' => '权益包超期时间的时间戳，格林威治时间1970年01月01日00时00分00秒起至现在的毫秒数'."\n" - ."\n" - .'默认永不过期', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1633167071000', - ], + 'user_id' => ['description' => '用户标识', 'type' => 'string', 'required' => true, 'example' => 'uid1'], + 'type' => ['description' => '账号类型'."\n" + ."\n" + .'mobile：手机号'."\n" + ."\n" + .'email：邮箱'."\n" + ."\n" + .'ding：钉钉'."\n" + ."\n" + .'ram：阿里云RAM子账号'."\n" + ."\n" + .'wechat：企业微信'."\n" + ."\n" + .'ldap：LDAP账号'."\n" + ."\n" + .'custom：自定义账号', 'type' => 'string', 'required' => true, 'example' => 'mobile'], + 'identity' => ['description' => '账号的唯一标识，比如手机号', 'type' => 'string', 'required' => true, 'example' => '139****'."\n"], + 'extra' => ['description' => '账号唯一标识的附加信息，比如当账号为手机号时，此字段填手机的区域编码，比如中国大陆为86，不填写默认为86', 'type' => 'string', 'required' => false, 'example' => '1'], ], 'required' => false, ], ], ], 'responses' => [ - 200 => [], + 204 => [], + ], + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '取消账号关联', + 'summary' => '取消账号绑定。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '创建实体和权益包关联', - 'description' => '如果您需要基于PDS做面向大量用户的二次运营，可以基于权益对用户可使用的功能和配额进行控制。 详情请联系官方钉钉群进行咨询：23146118', ], - 'UpdateIdentityToBenefitPkgMapping' => [ - 'summary' => '更新实体和权益包关联，可用于给用户绑定权益包。', - 'path' => '/v2/benefit/identity_to_benefit_pkg_mapping/update', - 'methods' => [ - 'post', + 'UpdateDomain' => [ + 'summary' => '更新 domain。', + 'path' => '/v2/domain/update', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'tags' => ['admin'], + 'security' => [ + [ + 'AK' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'readAndWrite', + 'deprecated' => false, + 'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free'], + 'parameters' => [ + [ + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', + 'schema' => [ + 'description' => '请求体。', + 'type' => 'object', + 'properties' => [ + 'domain_id' => ['description' => 'domain id', 'type' => 'string', 'required' => true, 'example' => 'bj1'], + 'domain_name' => ['description' => 'domain 名称', 'type' => 'string', 'required' => false, 'example' => 'Hello Enterprise Drive'], + 'description' => ['description' => 'domain 描述', 'type' => 'string', 'required' => false, 'example' => 'Hello enterprise drive debug environment'], + 'init_drive_enable' => ['description' => '是否开通默认网盘。为true则所有用户在第一次登录后都默认分配一个网盘。默认false', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'init_drive_size' => ['description' => 'init\\_drive\\_enable 为true时必选。 创建用户时，默认网盘的大小，单位：Bytes。'."\n" + .'默认为 0，此时创建的 drive 大小为0，不可以上传文件，如果需要初始化 drive， 请设置该值。'."\n" + .'-1则表示不限大小。', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1073741824'], + 'user_count_quota' => ['description' => 'domain 总用户数限制', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '50'], + 'size_quota' => ['description' => '容量配额，表示 domain 下所有 drive 的总quota 大小，0 表示不限制', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1099511627776'], + 'published_app_access_strategy' => ['description' => 'App 访问策略', 'required' => false, '$ref' => '#/components/schemas/AppAccessStrategy'], + ], + 'required' => false, + ], + ], + ], + 'responses' => [ + 200 => [ + 'schema' => ['description' => '更新后的 domain 信息', '$ref' => '#/components/schemas/Domain'], + ], ], - 'schemes' => [ - 'https', - 'http', + 'staticInfo' => ['returnType' => 'synchronous'], + 'eventInfo' => [ + 'enable' => false, + 'eventNames' => [], ], - 'tags' => [ - 'api', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"parent_domain_id\\": \\"bj1\\",\\n \\"domain_id\\": \\"bj2\\",\\n \\"domain_name\\": \\"pdsdomain\\",\\n \\"description\\": \\"my domain\\",\\n \\"init_drive_enable\\": true,\\n \\"init_drive_size\\": 1073741824,\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"size_quota\\": 1099511627776,\\n \\"size_quota_used\\": 1099511627776,\\n \\"user_count_quota\\": 50,\\n \\"status\\": 1,\\n \\"used_size\\": 1099511627776,\\n \\"published_app_access_strategy\\": {\\n \\"effect\\": \\"deny\\",\\n \\"except_app_id_list\\": [\\n \\"8ovxCTRUDdbpVWBP\\"\\n ]\\n },\\n \\"sharable\\": true,\\n \\"data_hash_name\\": \\"sha1\\",\\n \\"store_redundancy_type\\": \\"LRS\\"\\n}","type":"json"}]', + 'title' => '更新Domain', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'UpdateDrive' => [ + 'summary' => '修改空间信息。', + 'path' => '/v2/drive/update', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -19232,97 +9120,64 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数', + 'description' => '请求体', 'type' => 'object', 'properties' => [ - 'identity_type' => [ - 'description' => '实体的类型'."\n" - .'管理用户权益，传user', - 'type' => 'string', - 'required' => true, - 'example' => 'user', - 'enum' => [ - 'user', - ], - ], - 'identity_id' => [ - 'description' => '实体的唯一标识'."\n" + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'drive_name' => ['description' => '空间名称，最长 128 字符', 'type' => 'string', 'required' => false, 'example' => 'My personal space', 'maxLength' => 128], + 'description' => ['description' => '描述，最长 1024 字符', 'type' => 'string', 'required' => false, 'example' => 'VIP space', 'maxLength' => 1024], + 'status' => [ + 'description' => '空间状态，可选值如下：'."\n" ."\n" - .'管理用户权益时，传user_id', - 'type' => 'string', - 'required' => true, - 'example' => 'user123', - ], - 'benefit_pkg_id' => [ - 'description' => '权益包的唯一标识', + .'enabled：可用'."\n" + .'disabled：禁用', 'type' => 'string', - 'required' => true, - 'example' => '40cb7794c9294', - ], - 'amount' => [ - 'description' => '权益包数量'."\n" - ."\n" - .'对资源类权益包生效，非必填参数，默认为1', - 'type' => 'integer', - 'format' => 'int64', 'required' => false, - 'example' => '1', - ], - 'expire_time' => [ - 'description' => '权益包超期时间的时间戳，格林威治时间1970年01月01日00时00分00秒起至现在的毫秒数'."\n" - ."\n" - .'默认永不过期', - 'type' => 'integer', - 'format' => 'int64', - 'required' => false, - 'example' => '1633167071000', + 'enumValueTitles' => ['disabled' => '禁止', 'enabled' => '使能'], + 'example' => 'enabled', + 'enum' => ['enabled', 'disabled'], ], + 'total_size' => ['description' => '总大小，单位为字节，不限制大小时填 -1', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '10240'], + 'owner' => ['description' => '归属者'."\n" + .'注意，当前只允许通过 ak 来修改个人 drive 的所有者。', 'type' => 'string', 'required' => false, 'example' => 'user1'], ], 'required' => false, ], ], ], 'responses' => [ - 200 => [], - ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '更新实体和权益包关联', - ], - 'GetIdentityToBenefitPkgMapping' => [ - 'summary' => '获取实体和权益包关联，可用于获取用户绑定的权益包。', - 'path' => '/v2/benefit/identity_to_benefit_pkg_mapping/get', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', + 200 => [ + 'schema' => ['description' => 'Schema of Response', '$ref' => '#/components/schemas/Drive'], + ], ], - 'tags' => [ - 'api', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"drive_name\\": \\"drv1\\",\\n \\"description\\": \\"vipdrive\\",\\n \\"owner\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"owner_type\\": \\"user\\",\\n \\"drive_type\\": \\"normal\\",\\n \\"status\\": \\"enabled\\",\\n \\"used_size\\": 20480,\\n \\"total_size\\": 204800,\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\"\\n}","type":"json"}]', + 'title' => '修改空间信息', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'UpdateFacegroup' => [ + 'summary' => '更新人脸分组信息。', + 'path' => '/v2/image/update_facegroup_info', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -19331,55 +9186,29 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'identity_type' => [ - 'description' => '实体的类型'."\n" - .'管理用户权益，传user', - 'type' => 'string', - 'required' => true, - 'example' => 'user', - 'enum' => [ - 'user', - ], - ], - 'identity_id' => [ - 'description' => '实体的唯一标识'."\n" - ."\n" - .'管理用户权益时，传user_id', - 'type' => 'string', - 'required' => true, - 'example' => 'user123', - ], - 'benefit_pkg_id' => [ - 'description' => '权益包的唯一标识', - 'type' => 'string', - 'required' => true, - 'example' => '40cb7794c9294', - ], + 'drive_id' => ['description' => '空间id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'group_id' => ['description' => '人脸分组id, 通过列举人脸分组接口返回的结果中获取', 'type' => 'string', 'required' => true, 'example' => 'group-abc'], + 'group_name' => ['description' => '人脸分组名称，长度最大128字符', 'type' => 'string', 'required' => false, 'example' => 'Face of John', 'maxLength' => 128, 'minLength' => 1], + 'group_cover_face_id' => ['description' => '人脸分组封面人脸ID, 通过文件接口file/get,file/list,file/search的返回结果**ImageMediaMetadata**字段中进行获取'."\n" + ."\n", 'type' => 'string', 'required' => false, 'example' => 'face1'], + 'remarks' => ['description' => '备注，长度最大128字符', 'type' => 'string', 'required' => false, 'example' => 'John Doe', 'maxLength' => 128, 'minLength' => 1], ], 'required' => false, ], @@ -19388,27 +9217,29 @@ 'responses' => [ 200 => [ 'schema' => [ - 'description' => '实体绑定的权益包信息', - '$ref' => '#/components/schemas/IdentityToBenefitPkgMapping', + 'title' => 'Schema of Response', + 'description' => 'Schema of Response', + 'type' => 'object', + 'properties' => [ + 'drive_id' => ['title' => 'Id of the request', 'description' => '空间ID', 'type' => 'string', 'example' => '1'], + 'group_id' => ['description' => '分组ID', 'type' => 'string', 'example' => 'group-abc'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"identity_type\\": \\"\\",\\n \\"identity_id\\": \\"\\",\\n \\"benefit_pkg_owner_id\\": \\"\\",\\n \\"benefit_pkg_id\\": \\"\\",\\n \\"benefit_pkg_type\\": \\"\\",\\n \\"benefit_pkg_name\\": \\"\\",\\n \\"benefit_pkg_priority\\": 0,\\n \\"benefit_pkg_computation_rule\\": \\"\\",\\n \\"delivery_info_list\\": [\\n {\\n \\"amount\\": 0,\\n \\"is_permanent\\": true,\\n \\"expire_time\\": \\"\\",\\n \\"created_at\\": \\"\\"\\n }\\n ],\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\"\\n}","type":"json"}]', - 'title' => '获取实体和权益包关联', - ], - 'ListIdentityToBenefitPkgMapping' => [ - 'summary' => '列举实体和权益包关联，可用于获取用户绑定的权益包列表。', - 'path' => '/v2/benefit/identity_to_benefit_pkg_mapping/list', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'tags' => [ - 'api', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"drive_id\\": \\"1\\",\\n \\"group_id\\": \\"group-abc\\"\\n}","type":"json"}]', + 'title' => '更新人脸分组信息', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'UpdateFile' => [ + 'summary' => '修改文件信息，非数据。', + 'path' => '/v2/file/update', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -19417,55 +9248,55 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [], + 'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'identity_type' => [ - 'description' => '实体的类型'."\n" - .'管理用户权益，传user', - 'type' => 'string', - 'required' => true, - 'example' => 'user', - 'enum' => [ - 'user', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'name' => ['description' => '文件名称，按照 utf8 编码规则最长 1024 字节', 'type' => 'string', 'required' => false, 'example' => 'a.jpg', 'maxLength' => 102, 'minLength' => 1], + 'description' => ['description' => '文件描述信息，最长 1024 字符', 'type' => 'string', 'required' => false, 'example' => 'VIP user', 'maxLength' => 1024], + 'labels' => [ + 'description' => '标签列表，最多 100 个标签', + 'type' => 'array', + 'items' => ['description' => '标签，最长 128 字符', 'type' => 'string', 'required' => false, 'example' => 'animal'], + 'required' => false, + 'maxItems' => 100, ], - 'identity_id' => [ - 'description' => '实体的唯一标识'."\n" + 'check_name_mode' => [ + 'description' => '同名文件处理模式，可选值如下：'."\n" + ."\n" + .'ignore：允许同名文件；'."\n" ."\n" - .'管理用户权益时，传user_id', + .'auto_rename：当发现同名文件时，云端自动重命名，默认为追加当前时间点，如 xxx\\_20060102\\_150405；'."\n" + ."\n" + .'refuse：当云端存在同名文件时，拒绝创建新文件，返回客户端已存在同名文件的详细信息。'."\n" + ."\n" + .'默认为 ignore', 'type' => 'string', - 'required' => true, - 'example' => 'user123', - ], - 'include_expired' => [ - 'description' => '是否返回已经超期的权益包，默认为false', - 'type' => 'boolean', 'required' => false, - 'example' => 'false', + 'enumValueTitles' => ['refuse' => 'refuse', 'auto_rename' => 'auto_rename', 'ignore' => 'ignore'], + 'example' => 'ignore', + 'enum' => ['ignore', 'auto_rename', 'refuse'], ], + 'local_modified_at' => ['description' => '文件本地修改时间，格式为：yyyy-MM-ddTHH:mm:ssZ，采用 UTC +0 时区', 'type' => 'string', 'required' => false, 'example' => '2019-08-20T06:51:27.292Z'], + 'hidden' => ['description' => '是否隐藏', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'starred' => ['description' => '是否收藏', 'type' => 'boolean', 'required' => false, 'example' => 'true'], ], 'required' => false, ], @@ -19473,217 +9304,196 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'items' => [ - 'description' => '实体绑定的权益包信息列表', - 'type' => 'array', - 'items' => [ - 'description' => '实体绑定的权益包信息', - '$ref' => '#/components/schemas/IdentityToBenefitPkgMapping', - ], - ], - ], - ], + 'schema' => ['description' => '文件信息', '$ref' => '#/components/schemas/File'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"items\\": [\\n {\\n \\"identity_type\\": \\"\\",\\n \\"identity_id\\": \\"\\",\\n \\"benefit_pkg_owner_id\\": \\"\\",\\n \\"benefit_pkg_id\\": \\"\\",\\n \\"benefit_pkg_type\\": \\"\\",\\n \\"benefit_pkg_name\\": \\"\\",\\n \\"benefit_pkg_priority\\": 0,\\n \\"benefit_pkg_computation_rule\\": \\"\\",\\n \\"delivery_info_list\\": [\\n {\\n \\"amount\\": 0,\\n \\"is_permanent\\": true,\\n \\"expire_time\\": \\"\\",\\n \\"created_at\\": \\"\\"\\n }\\n ],\\n \\"created_at\\": \\"\\",\\n \\"updated_at\\": \\"\\"\\n }\\n ]\\n}","type":"json"}]', - 'title' => '列举实体和权益包关联', - ], - 'InvestigateFile' => [ - 'summary' => '将未经审核的文件送审。', - 'path' => '/v2/csi/investigate_file', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'tags' => [ - 'api', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"5d79206586bb5dd69fb34c349282718146c55da7\\",\\n \\"name\\": \\"1.mov\\",\\n \\"type\\": \\"file\\",\\n \\"content_type\\": \\"application/json\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"image file\\",\\n \\"trashed_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"file_extension\\": \\"txt\\",\\n \\"hidden\\": false,\\n \\"size\\": 1024,\\n \\"starred\\": false,\\n \\"status\\": \\"available\\",\\n \\"labels\\": [\\n \\"[\\\\\\"label1:1\\\\\\", \\\\\\"label2:2\\\\\\"]\\"\\n ],\\n \\"upload_id\\": \\"C9DCFE5A82644AC7A02DB74C30C934A6\\",\\n \\"parent_file_id\\": \\"3d5b846942cf94fa72324c8a4bda34e81da635a\\",\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\",\\n \\"category\\": \\"image\\",\\n \\"local_created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"local_modified_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"revision_id\\": \\"5d5b846942cf94fa72324c14a4bda34e81da635d\\",\\n \\"thumbnail_urls\\": {\\n \\"key\\": \\"\\\\\\"128X128\\\\\\": \\\\\\"https://url1\\\\\\", \\\\\\"800X800\\\\\\": \\\\\\"url2\\\\\\"\\"\\n },\\n \\"image_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1024,\\n \\"height\\": 1024,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"image_tags\\": [\\n {\\n \\"confidence\\": 0.98,\\n \\"parent_name\\": \\"sport\\",\\n \\"name\\": \\"basketball\\",\\n \\"tag_level\\": 3,\\n \\"source\\": \\"play basketball\\",\\n \\"centric_score\\": 0.877\\n }\\n ],\\n \\"faces\\": \\"[{\\\\\\"FaceId\\\\\\":\\\\\\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\\\\\",\\\\\\"GroupId\\\\\\":\\\\\\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\\\\\",\\\\\\"FaceConfidence\\\\\\":0.999,\\\\\\"Age\\\\\\":13,\\\\\\"AgeConfidence\\\\\\":4,\\\\\\"Gender\\\\\\":\\\\\\"female\\\\\\",\\\\\\"GenderConfidence\\\\\\":1,\\\\\\"Emotion\\\\\\":\\\\\\"none\\\\\\",\\\\\\"EmotionConfidence\\\\\\":0.672,\\\\\\"FaceAttributes\\\\\\":{\\\\\\"Mask\\\\\\":\\\\\\"none\\\\\\",\\\\\\"MaskConfidence\\\\\\":0.894,\\\\\\"Beard\\\\\\":\\\\\\"none\\\\\\",\\\\\\"BeardConfidence\\\\\\":0.997,\\\\\\"Glasses\\\\\\":\\\\\\"none\\\\\\",\\\\\\"GlassesConfidence\\\\\\":0.999,\\\\\\"Mouth\\\\\\":\\\\\\"close\\\\\\",\\\\\\"MouthConfidence\\\\\\":0.937,\\\\\\"Hat\\\\\\":\\\\\\"none\\\\\\",\\\\\\"HatConfidence\\\\\\":0.998,\\\\\\"HeadPose\\\\\\":{\\\\\\"Pitch\\\\\\":10.684,\\\\\\"Roll\\\\\\":-10.707,\\\\\\"Yaw\\\\\\":-20.094},\\\\\\"FaceBoundary\\\\\\":{\\\\\\"Width\\\\\\":457,\\\\\\"Height\\\\\\":687,\\\\\\"Top\\\\\\":1324,\\\\\\"Left\\\\\\":1356}}}]\\",\\n \\"faces_thumbnail\\": [\\n {\\n \\"face_id\\": \\"a9a66a86-73dd-4c95-8b79-1d8a49db5226\\",\\n \\"face_group_id\\": \\"Cluster-e3b7fb52-22b3-44f2-9746-8c1804bd6af0\\",\\n \\"face_thumbnail\\": \\"https://pds-domain.region.aliyuncs.com/QieGeH98%2F1001%2F63e5e551ee621482ab934a0687c6cda75fc07864%2F642a8a40c00f1ad379df421694713ee65170f09b?security-token=CAIS%2BgF1q6Ft5B2yfSjIr5bjHPCNnrdR8aSaSW7woVlmVd1Bt5HorDz2IHpPfHdoBe0btvU%2BlWxX6fwZlq5rR4QAXlDfNSyFeX20qFHPWZHInuDox55m4cTXNAr%2BIhr%2F29CoEIedZdjBe%2FCrRknZnytou9XTfimjWFrXWv%2Fgy%2BQQDLItUxK%2FcCBNCfpPOwJms7V6D3bKMuu3OROY6Qi5TmgQ41En1DIlt%2FXuk5DCtkqB12eXkLFF%2B97DRbG%2FdNRpMZtFVNO44fd7bKKp0lQLsUMSqv8q0fEcqGaW4o7CWQJLnzyCMvvJ9OVDFyN0aKEnH7J%2Bq%2FzxhTPrMnpkSlacGoABPMvZ8rSESUEP96Vbf%2Bk0JRg9Qb1MnaIJqWAgo8K6K0UP1CtqL2zrUtugpKKDHOYiKbq2O0S5yLUPVX5vBHqEi%2FFc7i6ZnHCMcXLJs4rKDKwRBEhovUXXlklq2q43OSVtLrXkBy9Xs1ers%2FhJhcxpNA0Vl3EWfJxa2BTylEdnLOQ%3D&x-oss-access-key-id=STS.NUVWJ9shpFfqKHAEY3YRmXTCN&x-oss-expires=1686455451&x-oss-process=image%2Fcrop%2Cx_1128%2Cy_1211%2Cw_914%2Ch_914%2Fformat%2Cjpg&x-oss-signature=jmhOz91Tww1ciMEwadDiioU7d93FDiBNr8s8mHyMqW0%3D&x-oss-signature-version=OSS2\\"\\n }\\n ],\\n \\"exif\\": \\"{\\\\\\"Compression\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"6\\\\\\"},\\\\\\"DateTime\\\\\\":{\\\\\\"value\\\\\\":\\\\\\"2020:08:19 17:11:11\\\\\\"}}\\",\\n \\"image_quality\\": {\\n \\"overall_score\\": 0.736\\n }\\n },\\n \\"user_tags\\": {\\n \\"key\\": \\"\\\\\\"k1\\\\\\":\\\\\\"v1\\\\\\", \\\\\\"k2\\\\\\",\\\\\\"v2\\\\\\"\\"\\n },\\n \\"video_media_metadata\\": {\\n \\"time\\": \\"2006-01-02T15:04:05.000Z07:00\\",\\n \\"width\\": 1920,\\n \\"height\\": 1080,\\n \\"location\\": \\"30.185453,120.218522\\",\\n \\"country\\": \\"China\\",\\n \\"province\\": \\"Zhejiang\\",\\n \\"city\\": \\"Hangzhou\\",\\n \\"district\\": \\"Xihu\\",\\n \\"township\\": \\"Xihu\\",\\n \\"address_line\\": \\"Zhejiang hangzhou xihu\\",\\n \\"video_media_video_stream\\": [\\n {\\n \\"duration\\": \\"22.88\\",\\n \\"bitrate\\": \\"108420\\",\\n \\"code_name\\": \\"h264\\",\\n \\"frame_count\\": \\"90\\"\\n }\\n ],\\n \\"video_media_audio_stream\\": [\\n {\\n \\"duration\\": \\"7704.573000\\",\\n \\"bit_rate\\": \\"129280\\",\\n \\"code_name\\": \\"aac\\"\\n }\\n ]\\n },\\n \\"id_path\\": \\"id1/id2\\",\\n \\"name_path\\": \\"root/f1/f2\\",\\n \\"dir_size_info\\": {\\n \\"dir_count\\": 1,\\n \\"file_count\\": 10\\n },\\n \\"action_list\\": [\\n \\"\\"\\n ],\\n \\"auto_delete_left_sec\\": 0\\n}","type":"json"}]', + 'title' => '修改文件信息', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'UpdateGroup' => [ + 'summary' => '根据群组ID定位到指定的群组，并修改群组信息。', + 'path' => '/v2/group/update', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ + 'BearerToken' => [], + ], + [ 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'operationType' => 'readAndWrite', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'create', - 'riskType' => 'none', - 'chargeType' => 'free', - ], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体。', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_file_ids' => [ - 'description' => '空间和文件ID的组合，至多5个。', - 'type' => 'array', - 'items' => [ - 'type' => 'object', - 'properties' => [ - 'drive_id' => [ - 'description' => '空间ID', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件ID', - 'type' => 'string', - 'required' => true, - 'example' => '9520943DC264', - ], - ], - 'required' => false, - ], - 'required' => true, - ], + 'group_id' => ['description' => '待修改的群组ID', 'type' => 'string', 'required' => true, 'example' => '2e43ec8427dd45f19431b7504649a1b4'], + 'group_name' => ['description' => '修改后的群组名称', 'type' => 'string', 'required' => false, 'example' => 'test group'], + 'description' => ['description' => '修改后的描述', 'type' => 'string', 'required' => false, 'example' => 'test group description'], ], 'required' => false, ], ], ], 'responses' => [ - 202 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [], - ], + 200 => [ + 'schema' => ['description' => '修改后的群组信息', '$ref' => '#/components/schemas/Group'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '审核文件', - 'description' => '可对图片和视频（不含音频）进行审核。动图、长图的截帧/切割频率为1，最多100张；视频的截帧频率为3秒，最多1500帧。审核结果可以通过列举文件、获取文件详情和获取文件内容安全详情接口查询以及使用事件通知功能推送。请勿使用此接口集中的批量送审文件，以免受资源限制导致审核失败。', - ], - 'CsiGetFileInfo' => [ - 'summary' => '获取文件的内容安全详情。', - 'path' => '/v2/csi/get_file_info', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - 'http', - ], - 'tags' => [ - 'api', + 'title' => '修改群组信息', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"group_id\\": \\"b45c0c0c373c41ec9ebb5c85a025a08f\\",\\n \\"group_name\\": \\"test group\\",\\n \\"description\\": \\"created by system\\",\\n \\"created_at\\": 1670573504600,\\n \\"updated_at\\": 1670573504600,\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"is_sync\\": true\\n}","type":"json"}]', + ], + 'UpdateIdentityToBenefitPkgMapping' => [ + 'summary' => '更新实体和权益包关联，可用于给用户绑定权益包。', + 'path' => '/v2/benefit/identity_to_benefit_pkg_mapping/update', + 'methods' => ['post'], + 'schemes' => ['https', 'http'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], ], + [ + 'BearerToken' => [], + ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, 'systemTags' => [], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求体参数', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'description' => '空间 id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'description' => '文件id', + 'identity_type' => [ + 'description' => '实体的类型'."\n" + .'管理用户权益，传user', 'type' => 'string', 'required' => true, - 'example' => '9520943DC264', - ], - 'url_expire_sec' => [ - 'description' => '可选填下载链接过期时间，单位为秒，取值范围为：[10,14400] 秒。'."\n" - .'填写此字段时提供下载链接，默认不提供下载链接。', - 'type' => 'integer', - 'format' => 'int32', - 'required' => false, - 'maximum' => '14400', - 'minimum' => '10', - 'example' => '100', + 'example' => 'user', + 'enum' => ['user'], ], + 'identity_id' => ['description' => '实体的唯一标识'."\n" + ."\n" + .'管理用户权益时，传user_id', 'type' => 'string', 'required' => true, 'example' => 'user123'], + 'benefit_pkg_id' => ['description' => '权益包的唯一标识', 'type' => 'string', 'required' => true, 'example' => '40cb7794c9294'], + 'amount' => ['description' => '权益包数量'."\n" + ."\n" + .'对资源类权益包生效，非必填参数，默认为1', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1'], + 'expire_time' => ['description' => '权益包超期时间的时间戳，格林威治时间1970年01月01日00时00分00秒起至现在的毫秒数'."\n" + ."\n" + .'默认永不过期', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1633167071000'], ], 'required' => false, ], ], ], 'responses' => [ - 200 => [ + 200 => [], + ], + 'title' => '更新实体和权益包关联', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', + ], + 'UpdateRevision' => [ + 'path' => '/v2/file/revision/update', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], + 'security' => [ + [ + 'AK' => [], + ], + [ + 'BearerToken' => [], + ], + ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'deprecated' => false, + 'parameters' => [ + [ + 'name' => 'domain_id', + 'in' => 'host', + 'schema' => ['title' => 'A short description of struct', 'description' => 'A short description of struct', 'type' => 'string', 'required' => true], + ], + [ + 'name' => 'body', + 'in' => 'body', + 'style' => 'json', 'schema' => [ + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'investigation_info' => [ - 'description' => '审核信息', - '$ref' => '#/components/schemas/InvestigationInfo', - ], - 'url' => [ - 'description' => '文件下载链接', - 'type' => 'string', - 'example' => 'https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => true, 'example' => '9520943DC264'], + 'revision_id' => ['description' => '版本 id', 'type' => 'string', 'required' => true, 'example' => '40CB7794C929'], + 'keep_forever' => ['description' => '是否永久保留'."\n" + ."\n" + .'默认不传递该参数，表示不修改版本的永久保留属性。', 'type' => 'boolean', 'required' => false, 'example' => 'true'], + 'revision_description' => ['description' => '版本描述信息，最长1024字符'."\n" + ."\n" + .'默认不传递该参数，表示不修改版本的版本描述信息。', 'type' => 'string', 'required' => false, 'example' => 'aaa'], ], + 'required' => false, ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"investigation_info\\": {\\n \\"status\\": 0,\\n \\"suggestion\\": \\"\\",\\n \\"video_detail\\": {\\n \\"block_frames\\": [\\n {\\n \\"rate\\": 0,\\n \\"offset\\": 0,\\n \\"label\\": \\"\\"\\n }\\n ]\\n }\\n },\\n \\"url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\"\\n}","type":"json"}]', - 'title' => '获取文件内容安全详情', - ], - 'Batch' => [ - 'summary' => '支持批量调用部分API，提升调用效率。', - 'path' => '/v2/batch', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', + 'responses' => [ + 200 => [ + 'schema' => ['description' => '版本信息', '$ref' => '#/components/schemas/Revision'], + ], ], - 'tags' => [ - 'api', + 'title' => '更新版本信息', + 'summary' => '更新版本信息，设置版本为永久保留，或者添加版本描述信息。支持将一个文件的最多50个版本设置为永久保留。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id\\": \\"9520943DC264\\",\\n \\"revision_id\\": \\"40CB7794C929\\",\\n \\"revision_name\\": \\"1.mov\\",\\n \\"revision_version\\": 1,\\n \\"size\\": 1024,\\n \\"file_extension\\": \\"mov\\",\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"keep_forever\\": false,\\n \\"revision_description\\": \\"aaa\\",\\n \\"is_latest_version\\": false,\\n \\"crc64_hash\\": \\"3574582125365864471\\",\\n \\"content_hash\\": \\"EA4942AA8761213890A5C386F88E6464D2C31CA3\\",\\n \\"content_hash_name\\": \\"sha1\\",\\n \\"thumbnail\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\\\n\\",\\n \\"url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\\\n\\",\\n \\"download_url\\": \\"https://data.aliyunpds.com/hz22%2F5d5b986facbec311ef844c25954f96821497b383%2F5d5b986f955410dd991646bb87c6b4e899eff525?Expires=xxx&OSSAccessKeyId=xxx&Signature=xxx\\\\n\\",\\n \\"creator_type\\": \\"\\",\\n \\"creator_id\\": \\"\\",\\n \\"creator_name\\": \\"\\"\\n}","type":"json"}]', + ], + 'UpdateShareLink' => [ + 'summary' => '修改分享。', + 'path' => '/v2/share_link/update', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'BearerToken' => [], @@ -19692,168 +9502,69 @@ 'AK' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - ], + 'systemTags' => ['operationType' => 'update'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求体。', 'type' => 'object', 'properties' => [ - 'resource' => [ - 'description' => '请求的资源，支持的资源类型包括：'."\n" - ."\n" - .'- file（文件）'."\n" - .'- drive（个人/团队云盘）'."\n" - .'- user（用户）'."\n" - .'- group（群组）'."\n" - .'- membership（群组成员）'."\n" - .'- share\\_link（分享）'."\n" - .'- async\\_task（异步任务）', + 'share_id' => ['description' => '分享id', 'type' => 'string', 'required' => true, 'example' => '7JQX1FswpQ8'], + 'share_pwd' => ['description' => '提取码。'."\n" + .'提取码长度范围[0, 64]。'."\n" + .'长度0表示提取码是""'."\n", 'type' => 'string', 'required' => false, 'example' => 'abcF123x'], + 'expiration' => ['description' => '失效时间点。'."\n" + .'RFC3339格式，比如："2020-06-28T11:33:00.000+08:00"。'."\n" + .'""表示永久有效'."\n", 'type' => 'string', 'required' => false, 'example' => '2020-06-28T11:33:00.000+08:00'], + 'description' => ['description' => '描述。'."\n" + .'长度范围[0, 1024]'."\n", 'type' => 'string', 'required' => false, 'example' => 'Complete lecture series'], + 'share_name' => ['description' => '分享名。'."\n" + .'默认使用第一个文件名。'."\n" + .'长度范围[0, 128]', 'type' => 'string', 'required' => false, 'example' => 'Lecture-1.mp4'], + 'status' => [ + 'description' => '分享状态。'."\n" + .'枚举值如下：'."\n" + .'- disabled（已取消）'."\n" + .'- enabled（有效）', 'type' => 'string', - 'required' => true, - 'enumValueTitles' => [ - 'share_link' => '分享', - 'file' => '文件', - 'async_task' => '异步任务', - 'membership' => '群组成员', - 'drive' => '个人/团队云盘', - 'user' => '用户', - 'group' => '群组', - ], - 'example' => 'file', - ], - 'requests' => [ - 'description' => '子请求合集'."\n" - ."\n" - .'子请求的数量，有效范围是[1,100]', - 'type' => 'array', - 'items' => [ - 'description' => '一个子请求内容', - 'type' => 'object', - 'properties' => [ - 'id' => [ - 'description' => '子请求 id，用于request 和 response关联， 不允许重复', - 'type' => 'string', - 'required' => true, - 'example' => '93433894994ad2e1', - ], - 'method' => [ - 'description' => '子请求的方法，支持：'."\n" - ."\n" - .'- POST'."\n" - .'- GET'."\n" - .'- PUT'."\n" - .'- DELETE'."\n" - .'- HEAD'."\n", - 'type' => 'string', - 'required' => true, - 'enumValueTitles' => [ - 'HEAD' => 'HEAD', - 'DELETE' => 'DELETE', - 'POST' => 'POST', - 'GET' => 'GET', - 'PUT' => 'PUT', - ], - 'example' => 'POST', - ], - 'url' => [ - 'description' => 'url 子请求的api path路径， 支持：'."\n" - ."\n" - .'- /file/get（获取文件详情）'."\n" - .'- /file/update（修改文件信息）'."\n" - .'- /file/search（搜索文件）'."\n" - .'- /file/copy（复制文件或文件夹）'."\n" - .'- /file/move（移动文件或文件夹）'."\n" - .'- /file/delete（删除文件或文件夹）'."\n" - .'- /file/get_download_url（获取文件下载地址）'."\n" - .'- /file/get_share_link_download_url（获取分享下载地址）'."\n" - .'- /recyclebin/trash（放入回收站）'."\n" - .'- /recyclebin/restore（恢复文件或文件夹）'."\n" - .'- /file/put_usertags（设置用户标签）'."\n" - .'- /file/delete_usertags（删除用户标签）'."\n" - .'- /drive/get（获取空间信息）'."\n" - .'- /user/get（获取用户信息）'."\n" - .'- /group/get（获取群组信息）'."\n" - .'- /share_link/create（创建分享）'."\n" - .'- /share_link/update（修改分享）'."\n" - .'- /share_link/cancel（取消分享）'."\n" - .'- /share_link/list（列举分享）'."\n" - .'- /share_link/get（获取分享信息）'."\n" - .'- /share_link/get_share_token（获取分享令牌）'."\n" - .'- /async_task/get（获取异步任务信息）', - 'type' => 'string', - 'required' => true, - 'enumValueTitles' => [ - '/file/copy' => '复制文件或文件夹', - '/file/get_share_link_download_url' => '获取分享下载地址', - '/file/move' => '移动文件或文件夹', - '/share_link/create' => '创建分享', - '/share_link/update' => '修改分享', - '/async_task/get' => '获取异步任务信息', - '/drive/get' => '获取空间信息', - '/group/get' => '获取群组信息', - '/share_link/list' => '列举分享', - '/file/delete' => '删除文件或文件夹', - '/share_link/get' => '获取分享信息', - '/file/get' => '获取文件详情', - '/file/get_download_url' => '获取文件下载地址', - '/recyclebin/restore' => '恢复文件或文件夹', - '/file/update' => '修改文件信息', - '/recyclebin/trash' => '放入回收站', - '/file/search' => '搜索文件', - '/user/get' => '获取用户信息', - '/share_link/get_share_token' => '获取分享令牌', - '/share_link/cancel' => '取消分享', - ], - 'example' => '/file/get', - ], - 'body' => [ - 'description' => '子请求的请求参数JSON字符串，可参考相应子请求API文档'."\n" - ."\n" - .'当指定了body必须传headers："Content-Type" 对应的类型，目前子请求入参是"application/json"', - 'type' => 'object', - 'required' => false, - 'additionalProperties' => [ - 'type' => 'any', - 'description' => '子请求的请求body', - 'example' => '{"domain_id":"1","drive_id":"1"}', - ], - ], - 'headers' => [ - 'description' => '子请求的请求头，表示body传入数据的类型', - 'type' => 'object', - 'required' => false, - 'additionalProperties' => [ - 'type' => 'string', - 'description' => '子请求的请求headers', - 'example' => '{"Content-Type":"application/json"}', - ], - ], - ], - 'required' => false, - ], - 'required' => true, + 'required' => false, + 'enumValueTitles' => ['disabled' => '已取消', 'enabled' => '有效'], + 'example' => 'enabled', ], + 'preview_count' => ['description' => '预览次数。'."\n" + .'次数要求>=0', 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '3'], + 'save_count' => ['description' => '转存次数。'."\n" + .'次数要求>=0'."\n", 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '5'], + 'download_count' => ['description' => '下载次数。'."\n" + .'次数要求>=0'."\n", 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '30'], + 'report_count' => ['description' => '举报次数。'."\n" + .'次数要求>=0'."\n", 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '1'], + 'video_preview_count' => ['description' => '视频预览次数。'."\n" + .'次数要求>=0'."\n", 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '100'], + 'disable_preview' => ['description' => '禁止预览', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + 'disable_save' => ['description' => '禁止转存', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + 'disable_download' => ['description' => '禁止下载', 'type' => 'boolean', 'required' => false, 'example' => 'false'], + 'preview_limit' => ['description' => '分享预览次数限制。'."\n" + .'次数要求>=0。'."\n" + .'次数0表示不限制'."\n", 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '100'], + 'save_limit' => ['description' => '分享转存次数限制。'."\n" + .'次数要求>=0。'."\n" + .'次数0表示不限制'."\n", 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '100'], + 'download_limit' => ['description' => '分享下载次数限制。'."\n" + .'次数要求>=0。'."\n" + .'次数0表示不限制'."\n", 'type' => 'integer', 'format' => 'int64', 'required' => false, 'example' => '100'], + 'office_editable' => ['description' => '允许在线编辑分享的文档', 'type' => 'boolean', 'required' => false, 'example' => 'true'], ], 'required' => false, ], @@ -19861,57 +9572,22 @@ ], 'responses' => [ 200 => [ - 'schema' => [ - 'title' => 'Schema of Response', - 'description' => 'Schema of Response', - 'type' => 'object', - 'properties' => [ - 'responses' => [ - 'description' => '子请求的响应合集', - 'type' => 'array', - 'items' => [ - 'description' => '一个子请求响应内容', - 'type' => 'object', - 'properties' => [ - 'id' => [ - 'description' => '子请求 id，和request进行关联', - 'type' => 'string', - 'example' => '93433894994ad2e1', - ], - 'status' => [ - 'description' => '子请求的返回状态码，可参考相应子请求API文档', - 'type' => 'integer', - 'format' => 'int32', - 'example' => '200', - ], - 'body' => [ - 'description' => '子请求的响应结果，可参考相应子请求API文档', - 'type' => 'object', - 'additionalProperties' => [ - 'type' => 'any', - 'description' => '子请求的响应body', - 'example' => '{"domain_id":"1","drive_id":"1","file_id":"9520943DC264"}', - ], - ], - ], - ], - ], - ], - ], + 'schema' => ['description' => '返回信息', '$ref' => '#/components/schemas/ShareLink'], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"responses\\": [\\n {\\n \\"id\\": \\"93433894994ad2e1\\",\\n \\"status\\": 200,\\n \\"body\\": {\\n \\"key\\": \\"{\\\\\\"domain_id\\\\\\":\\\\\\"1\\\\\\",\\\\\\"drive_id\\\\\\":\\\\\\"1\\\\\\",\\\\\\"file_id\\\\\\":\\\\\\"9520943DC264\\\\\\"}\\"\\n }\\n }\\n ]\\n}","type":"json"}]', - 'title' => '批量调用API', - ], - 'AuditLogExport' => [ - 'summary' => '导出审计日志。', - 'path' => '/v2/audit_log/export', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"share_id\\": \\"7JQX1FswpQ8\\",\\n \\"share_pwd\\": \\"abcF123x\\",\\n \\"drive_id\\": \\"1\\",\\n \\"file_id_list\\": [\\n \\"[\\\\\\"xx\\\\\\"]\\"\\n ],\\n \\"expiration\\": \\"2020-06-28T11:33:00.000+08:00\\",\\n \\"expired\\": false,\\n \\"created_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"updated_at\\": \\"2019-08-20T06:51:27.292Z\\",\\n \\"description\\": \\"videos\\",\\n \\"share_name\\": \\"video-1.MP4\\",\\n \\"creator\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"status\\": \\"enabled\\",\\n \\"preview_count\\": 10,\\n \\"save_count\\": 2,\\n \\"download_count\\": 5,\\n \\"report_count\\": 0,\\n \\"video_preview_count\\": 1,\\n \\"access_count\\": 4,\\n \\"disable_preview\\": false,\\n \\"disable_save\\": false,\\n \\"disable_download\\": false,\\n \\"preview_limit\\": 100,\\n \\"save_limit\\": 100,\\n \\"download_limit\\": 100,\\n \\"require_login\\": false,\\n \\"share_all_files\\": true,\\n \\"share_msg\\": \\"pwd: 123\\",\\n \\"save_download_limit\\": 100,\\n \\"office_editable\\": true\\n}","type":"json"}]', + 'title' => '修改分享', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'UpdateStory' => [ + 'summary' => '更新指定故事的信息，包含名称、标签、自定义 id、封面等。', + 'path' => '/v2/image/update_story', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], @@ -19920,68 +9596,45 @@ 'BearerToken' => [], ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], + 'consumes' => ['application/json'], + 'produces' => ['application/json'], + 'operationType' => 'write', 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - ], + 'systemTags' => ['operationType' => 'update', 'riskType' => 'none', 'chargeType' => 'free'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'title' => 'A short description of struct', - 'description' => 'A short description of struct', - 'type' => 'string', - 'required' => false, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'description' => '请求体参数。', + 'description' => '请求体参数', 'type' => 'object', 'properties' => [ - 'query' => [ - 'description' => '支持根据以下字段组合查询：'."\n" - .'- drive_id（空间ID，string）'."\n" - .'- actor_id（操作者ID，string）'."\n" - .'- acted_at（操作时间，date，格式"2006-01-02T00:00:00"，只支持零时区）'."\n" - .'- action_type（操作类型，string）', - 'type' => 'string', - 'required' => false, - 'example' => 'acted_at > \'2025-03-10T16:00:00\' and acted_at < \'2025-03-17T15:59:59\'', - ], - 'order_by' => [ - 'description' => '排序字段，支持操作时间（acted_at）排序。默认值：空，按照操作时间逆序排序。支持参数：'."\n" - ."\n" - .'- acted_at DESC（按操作时间逆序）'."\n" - .'- acted_at ASC（按操作时间正序）', - 'type' => 'string', - 'required' => false, - 'example' => 'acted_at DESC', - ], - 'file_name' => [ - 'description' => '导出的文件名，长度不超过1024。默认为log.csv', - 'type' => 'string', + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'required' => true, 'example' => '1'], + 'story_id' => ['description' => '故事 id', 'type' => 'string', 'required' => true, 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003'], + 'story_name' => ['description' => '故事名称。'."\n" + .'长度不超过 1024 字节。', 'type' => 'string', 'required' => false, 'example' => 'name1'], + 'custom_labels' => [ + 'description' => '自定义标签。'."\n" + .'标签数不超过 20 个。', + 'type' => 'object', + 'deprecated' => true, 'required' => false, - 'example' => '2024-01-log.csv', + 'additionalProperties' => ['type' => 'string', 'example' => 'label_value', 'description' => '自定义标签'], ], - 'language' => [ - 'description' => '导出语言，默认中文。支持参数：'."\n" - ."\n" - .'- zh_CN（中文）'."\n" - .'- en_US（英文）', - 'type' => 'string', + 'cover' => [ + 'description' => '故事封面', + 'type' => 'object', + 'properties' => [ + 'file_id' => ['description' => '文件 id', 'type' => 'string', 'required' => false, 'example' => '63e5e4340f76cb3ead5f40f68163f0f967c1a7bf'], + 'revision_id' => ['description' => '版本 id', 'type' => 'string', 'required' => false, 'example' => '642a88dd06e49d9c0a14411ebae606f70edd9a59'], + ], 'required' => false, - 'example' => 'zh_CN', ], ], 'required' => false, @@ -19992,320 +9645,285 @@ 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => '返回信息', + 'description' => '返回参数', 'type' => 'object', 'properties' => [ - 'async_task_id' => [ - 'title' => 'Id of the request', - 'description' => '审计日志导出的异步任务 id', - 'type' => 'string', - 'example' => '4221bf6e6ab43c255edc4463bf3a6f5f5d31****', - ], + 'drive_id' => ['description' => '空间 id', 'type' => 'string', 'example' => '1'], + 'story_id' => ['description' => '故事 id', 'type' => 'string', 'example' => '9132e0d8-fe92-4e56-86c3-f5f112308003'], ], ], ], ], - 'staticInfo' => [ - 'returnType' => 'synchronous', + 'staticInfo' => ['returnType' => 'synchronous'], + 'title' => '更新故事', + 'description' => '**请确保在使用该接口前，已充分了解 PDS 的收费方式和[价格](~~425220~~)**。'."\n" + ."\n" + .'使用此功能须开通增值服务图片处理功能。', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], - 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"async_task_id\\": \\"4221bf6e6ab43c255edc4463bf3a6f5f5d31****\\"\\n}","type":"json"}]', - 'title' => '导出审计日志', - 'description' => '网盘与相册服务开发版，日志审计属于增值功能，请确保在使用该接口前，已充分了解<props="china">[增值服务计费项](https://help.aliyun.com/zh/pds/drive-and-photo-service-dev/product-overview/billable-items-for-value-added-features)</props><props="intl">[增值服务计费项](https://www.alibabacloud.com/help/document_detail/425220.html)</props>。', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"drive_id\\": \\"1\\",\\n \\"story_id\\": \\"9132e0d8-fe92-4e56-86c3-f5f112308003\\"\\n}","type":"json"}]', ], - 'GetDomainQuota' => [ - 'summary' => '获取domain限额', - 'path' => '/v2/domain/get_quota', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'tags' => [ - 'admin', - ], + 'UpdateUser' => [ + 'summary' => '修改用户信息。', + 'path' => '/v2/user/update', + 'methods' => ['post'], + 'schemes' => ['https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], ], - ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'read', - 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'get', - 'riskType' => 'none', - 'chargeType' => 'free', - ], - 'parameters' => [], - 'responses' => [ - 200 => [ - 'schema' => [ - 'type' => 'object', - 'properties' => [ - 'size_quota' => [ - 'type' => 'integer', - 'format' => 'int64', - ], - 'size_used' => [ - 'type' => 'integer', - 'format' => 'int64', - ], - 'user_count_quota' => [ - 'type' => 'integer', - 'format' => 'int64', - ], - 'user_count_used' => [ - 'type' => 'integer', - 'format' => 'int64', - ], - ], - ], - ], - ], - 'staticInfo' => [ - 'returnType' => 'synchronous', - ], - 'responseDemo' => '', - ], - 'GroupUpdateName' => [ - 'summary' => '更新用户组名字', - 'path' => '/v2/group/update_name', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'https', - ], - 'tags' => [ - 'api', - ], - 'security' => [ [ 'BearerToken' => [], ], - [ - 'AK' => [], - ], - ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', ], - 'operationType' => 'write', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'update', - ], + 'systemTags' => ['operationType' => 'none'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'type' => 'string', - 'required' => true, - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'group_id' => [ + 'user_id' => ['description' => '用户id，最长64字符，不能包含字符#', 'type' => 'string', 'required' => true, 'example' => 'c9b7a5aa04d14ae3867fdc886fa01da4', 'maxLength' => 1024, 'minLength' => 1], + 'nick_name' => ['description' => '用户昵称，最长128字符', 'type' => 'string', 'required' => false, 'example' => 'pdsuer', 'maxLength' => 128, 'minLength' => 0], + 'status' => [ + 'description' => '用户状态'."\n" + ."\n" + .'- disabled（禁止）'."\n" + ."\n" + .'- enabled（使能）', 'type' => 'string', - 'required' => true, + 'required' => false, + 'enumValueTitles' => ['disabled' => '禁止', 'enabled' => '使能'], + 'example' => 'enabled', + 'enum' => ['enabled', 'disabled'], ], - 'name' => [ + 'role' => [ + 'description' => '角色'."\n" + ."\n" + .'- superadmin（超级管理员）'."\n" + ."\n" + .'- admin（管理员）'."\n" + ."\n" + .'- user（普通用户）', 'type' => 'string', + 'required' => false, + 'enumValueTitles' => ['superadmin' => '超级管理员', 'admin' => '管理员', 'user' => '普通用户'], + 'example' => 'user', + 'enum' => ['user', 'admin', 'superadmin', 'subdomain_admin', 'subdomain_super_admin'], + ], + 'avatar' => ['description' => '头像地址'."\n" + ."\n" + .'http形式时，以http:// 或https:// 作为前缀，参数长度最长4KB'."\n" + ."\n" + .'data形式时，以data://作为前缀，base64编码，参数长度最长300KB', 'type' => 'string', 'required' => false, 'example' => 'http://a.b.c/pds.jpg'], + 'description' => ['description' => '描述信息，最长1024字符', 'type' => 'string', 'required' => false, 'example' => 'Vip user', 'maxLength' => 1024, 'minLength' => 0], + 'phone' => ['description' => '手机号', 'type' => 'string', 'required' => false, 'example' => '13900001111'], + 'email' => ['description' => '邮箱', 'type' => 'string', 'required' => false, 'example' => 'a@aliyunpds.com'], + 'user_data' => [ + 'description' => '用户自定义数据，最长1024字符', + 'type' => 'object', + 'required' => false, + 'additionalProperties' => ['type' => 'string', 'example' => 'test', 'description' => '用户自定义数据'], + ], + 'group_info_list' => [ + 'description' => '群组信息列表', + 'type' => 'array', + 'items' => [ + 'description' => '群组信息', + 'type' => 'object', + 'properties' => [ + 'group_id' => ['description' => '群组id', 'type' => 'string', 'required' => false, 'example' => 'g123'], + ], + 'required' => false, + ], + 'required' => false, ], ], + 'required' => false, ], ], ], 'responses' => [ - 204 => [ - 'schema' => [ - '$ref' => '#/components/schemas/BaseGroupResponse', - ], + 200 => [ + 'schema' => ['description' => '用户信息', '$ref' => '#/components/schemas/User'], ], ], - 'responseDemo' => '', - ], - 'PunishFile' => [ - 'summary' => '处罚文件。', - 'path' => '/v2/csi/business/punish_file', - 'methods' => [ - 'post', - ], - 'schemes' => [ - 'http', - 'https', - ], - 'tags' => [ - 'api', + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"domain_id\\": \\"bj1\\",\\n \\"user_id\\": \\"c9b7a5aa04d14ae3867fdc886fa01da4\\",\\n \\"avatar\\": \\"http://aa.com/1.jpg\\",\\n \\"created_at\\": 1639762579768,\\n \\"updated_at\\": 1639762579768,\\n \\"email\\": \\"a@aliyunpds.com\\",\\n \\"nick_name\\": \\"001\\",\\n \\"phone\\": \\"13900001111\\",\\n \\"role\\": \\"user\\",\\n \\"status\\": \\"enabled\\",\\n \\"user_name\\": \\"pds\\",\\n \\"description\\": \\"vipuser\\",\\n \\"default_drive_id\\": \\"1\\",\\n \\"creator\\": \\"user1\\",\\n \\"last_login_time\\": 0,\\n \\"last_refresh_token_time\\": 0,\\n \\"user_data\\": {\\n \\"key\\": \\"\\"\\n }\\n}","type":"json"}]', + 'title' => '修改用户信息', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], + ], + 'VideoDRMLicense' => [ + 'summary' => '获取视频的DRM License。', + 'path' => '/v2/file/video_drm_license', + 'methods' => ['post'], + 'schemes' => ['http', 'https'], + 'tags' => ['api'], 'security' => [ [ 'AK' => [], ], + [ + 'BearerToken' => [], + ], ], - 'consumes' => [ - 'application/json', - ], - 'produces' => [ - 'application/json', - ], - 'operationType' => 'readAndWrite', + 'consumes' => ['application/json'], + 'produces' => ['application/json'], 'deprecated' => false, - 'systemTags' => [ - 'operationType' => 'none', - 'riskType' => 'none', - 'chargeType' => 'free', - ], + 'systemTags' => ['operationType' => 'get'], 'parameters' => [ [ 'name' => 'domain_id', 'in' => 'host', - 'schema' => [ - 'title' => '域id', - 'description' => '域id', - 'type' => 'string', - 'required' => false, - 'example' => 'bj2', - ], + 'schema' => ['type' => 'string', 'required' => true, 'description' => ''], ], [ 'name' => 'body', 'in' => 'body', 'style' => 'json', 'schema' => [ - 'title' => '请求体', - 'description' => '域id', + 'description' => '请求体参数。', 'type' => 'object', 'properties' => [ - 'drive_id' => [ - 'title' => '处罚的文件所属空间 ID', - 'description' => '处罚的文件所属drive_id', - 'type' => 'string', - 'required' => true, - 'example' => '1', - ], - 'file_id' => [ - 'title' => '处罚的文件 ID', - 'description' => '处罚的文件file_id', - 'type' => 'string', - 'required' => true, - 'example' => '2498DZ2', - ], - 'action_code' => [ - 'title' => '处罚动作，枚举值：'."\n" - .'pds_file_meta_frozen: 冻结文件'."\n" - .'pds_file_meta_share_forbidden: 禁止分享'."\n" - .'pds_file_meta_remove_punish：解除处罚'."\n" - .'pds_file_frozen：冻结文件（文件内容级别）'."\n" - .'pds_fileshare_forbidden：禁止分享（文件内容级别）'."\n" - .'pds_file_remove_punish：解除处罚（文件内容级别）', - 'description' => '处罚动作，可选的值：'."\n" - .'`pds_file_meta_frozen`: 冻结文件'."\n" - .'`pds_file_meta_share_forbidden`: 禁止分享 '."\n" - .'`pds_file_meta_remove_punish`：解除处罚'."\n" - .'`pds_file_frozen`：冻结文件（文件内容级别）'."\n" - .'`'."\0".'pds_fileshare_forbidden`：禁止分享（文件内容级别）'."\n" - .'`pds_file_remove_punish`：解除处罚（文件内容级别）'."\n" - .'文件内容级别的处罚会影响所有内容相同的文件，非文件内容级别的处罚只影响指定的文件。', + 'drmType' => [ + 'description' => 'DRM 加密类型。', 'type' => 'string', 'required' => true, - 'enumValueTitles' => [ - 'pds_file_remove_punish' => 'pds_file_remove_punish', - 'pds_fileshare_forbidden' => 'pds_fileshare_forbidden', - 'pds_file_frozen' => 'pds_file_frozen', - 'pds_file_meta_frozen' => 'pds_file_meta_frozen', - 'pds_file_meta_remove_punish' => 'pds_file_meta_remove_punish', - 'pds_file_meta_share_forbidden' => 'pds_file_meta_share_forbidden', - ], - 'example' => 'pds_file_meta_frozen', - ], - 'punish_reason' => [ - 'title' => '处罚原因', - 'description' => '处罚的原因', - 'type' => 'string', - 'required' => false, - 'example' => 'illegal', + 'enumValueTitles' => ['fairplay' => 'fairplay', 'widevine' => 'widevine'], + 'example' => 'widevine', ], + 'licenseRequest' => ['description' => '获取 license 请求体。', 'type' => 'string', 'required' => false, 'example' => 'CAES6B8SQgpACioSENGxDhqCLIVwwCBOyPayyWoSENGxDhqCLIVwwCBOyPayyWpI88aJmwYQARoQdRV32'], ], 'required' => false, - 'example' => 'bj2', ], ], ], 'responses' => [ - 204 => [ + 200 => [ 'schema' => [ 'title' => 'Schema of Response', - 'description' => 'Schema of Response', + 'description' => '返回结构体', 'type' => 'object', - 'properties' => [], + 'properties' => [ + 'data' => ['description' => '返回的DRM License。', 'type' => 'string', 'example' => 'cb9swCy8P50H9KePsxET3jZ1tm41bDs9HTsxbWnsjf3bsf6QGdiS4kZPhDaskimbNyAfNjmhQRmWFt3AhwNF3'], + 'states' => ['description' => 'DRM Server 返回的请求状态。', 'type' => 'string', 'example' => '0'], + 'device_info' => ['description' => '发起 DRM 请求的设备信息。', 'type' => 'string', 'example' => '""'], + ], ], ], ], - 'responseDemo' => '[{"errorExample":"","example":"{}","type":"json"}]', - 'title' => '处罚文件', + 'title' => '获取视频DRMLicense', + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], + ], + 'responseDemo' => '[{"errorExample":"","example":"{\\n \\"data\\": \\"cb9swCy8P50H9KePsxET3jZ1tm41bDs9HTsxbWnsjf3bsf6QGdiS4kZPhDaskimbNyAfNjmhQRmWFt3AhwNF3\\",\\n \\"states\\": \\"0\\",\\n \\"device_info\\": \\"\\\\\\"\\\\\\"\\"\\n}","type":"json"}]', ], ], 'endpoints' => [ - [ - 'regionId' => 'cn-shenzhen', - 'endpoint' => 'cn-shenzhen.admin.aliyunpds.com', - ], - [ - 'regionId' => 'cn-beijing', - 'endpoint' => 'cn-beijing.admin.aliyunpds.com', - ], - [ - 'regionId' => 'cn-zhangjiakou', - 'endpoint' => 'cn-zhangjiakou.admin.aliyunpds.com', - ], - [ - 'regionId' => 'cn-hangzhou', - 'endpoint' => 'cn-hangzhou.admin.aliyunpds.com', - ], - [ - 'regionId' => 'cn-shanghai', - 'endpoint' => 'cn-shanghai.admin.aliyunpds.com', - ], - [ - 'regionId' => 'ap-southeast-1', - 'endpoint' => 'ap-southeast-1.admin.aliyunpds.com', - ], - [ - 'regionId' => 'cn-guangzhou', - 'endpoint' => 'cn-guangzhou.admin.aliyunpds.com', - ], - [ - 'regionId' => 'cn-hongkong', - 'endpoint' => 'cn-hongkong.admin.aliyunpds.com', - ], - [ - 'regionId' => 'us-west-1', - 'endpoint' => 'us-west-1.admin.aliyunpds.com', - ], - [ - 'regionId' => 'eu-central-1', - 'endpoint' => 'eu-central-1.admin.aliyunpds.com', - ], - [ - 'regionId' => 'ap-southeast-5', - 'endpoint' => 'ap-southeast-5.admin.aliyunpds.com', - ], + ['regionId' => 'cn-zhangjiakou', 'regionName' => '华北3（张家口）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'cn-zhangjiakou.admin.aliyunpds.com', 'endpoint' => 'cn-zhangjiakou.admin.aliyunpds.com', 'vpc' => ''], + ['regionId' => 'cn-shenzhen', 'regionName' => '华南1（深圳）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'cn-shenzhen.admin.aliyunpds.com', 'endpoint' => 'cn-shenzhen.admin.aliyunpds.com', 'vpc' => ''], + ['regionId' => 'cn-shanghai', 'regionName' => '华东2（上海）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'cn-shanghai.admin.aliyunpds.com', 'endpoint' => 'cn-shanghai.admin.aliyunpds.com', 'vpc' => ''], + ['regionId' => 'cn-hongkong', 'regionName' => '中国香港', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'cn-hongkong.admin.aliyunpds.com', 'endpoint' => 'cn-hongkong.admin.aliyunpds.com', 'vpc' => ''], + ['regionId' => 'cn-hangzhou', 'regionName' => '华东1（杭州）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'cn-hangzhou.admin.aliyunpds.com', 'endpoint' => 'cn-hangzhou.admin.aliyunpds.com', 'vpc' => ''], + ['regionId' => 'cn-guangzhou', 'regionName' => '华南3（广州）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'cn-guangzhou.admin.aliyunpds.com', 'endpoint' => 'cn-guangzhou.admin.aliyunpds.com', 'vpc' => ''], + ['regionId' => 'cn-beijing', 'regionName' => '华北2（北京）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'cn-beijing.admin.aliyunpds.com', 'endpoint' => 'cn-beijing.admin.aliyunpds.com', 'vpc' => ''], + ['regionId' => 'ap-southeast-5', 'regionName' => '印度尼西亚（雅加达）', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'ap-southeast-5.admin.aliyunpds.com', 'endpoint' => 'ap-southeast-5.admin.aliyunpds.com', 'vpc' => ''], + ['regionId' => 'ap-southeast-1', 'regionName' => '新加坡', 'areaId' => 'asiaPacific', 'areaName' => '亚太', 'public' => 'ap-southeast-1.admin.aliyunpds.com', 'endpoint' => 'ap-southeast-1.admin.aliyunpds.com', 'vpc' => ''], + ['regionId' => 'eu-central-1', 'regionName' => '德国（法兰克福）', 'areaId' => 'europeAmerica', 'areaName' => '欧洲与美洲', 'public' => 'eu-central-1.admin.aliyunpds.com', 'endpoint' => 'eu-central-1.admin.aliyunpds.com', 'vpc' => ''], + ['regionId' => 'us-west-1', 'regionName' => '美国（硅谷）', 'areaId' => 'europeAmerica', 'areaName' => '欧洲与美洲', 'public' => 'us-west-1.admin.aliyunpds.com', 'endpoint' => 'us-west-1.admin.aliyunpds.com', 'vpc' => ''], + ], + 'errorCodes' => [ + ['code' => 'AccessTokenInvalid', 'message' => 'AccessTokenInvalid', 'http_code' => 401, 'description' => '访问令牌过期'], + ['code' => 'AccountInDebt', 'message' => 'AccountInDebt', 'http_code' => 403, 'description' => '租户欠费'], + ['code' => 'AccountNotFound', 'message' => 'AccountNotFound', 'http_code' => 403, 'description' => '租户云帐号未找到'], + ['code' => 'AKPolicyDenied', 'message' => 'AKPolicyDenied', 'http_code' => 403, 'description' => 'AccessKey Policy 禁止'], + ['code' => 'BadArchive', 'message' => 'BadArchive', 'http_code' => 400, 'description' => '压缩文件损坏'], + ['code' => 'BenefitNotEnabled', 'message' => 'BenefitNotEnabled', 'http_code' => 400, 'description' => '权益未使能'], + ['code' => 'ClearRecycleBinPartialSuccess', 'message' => 'ClearRecycleBinPartialSuccess', 'http_code' => 500, 'description' => '清空回收站部分成功'], + ['code' => 'ConcurrencyUpdateConflict', 'message' => 'ConcurrencyUpdateConflict', 'http_code' => 409, 'description' => '并发修改冲突'], + ['code' => 'CreateShareForbidden', 'message' => 'CreateShareForbidden', 'http_code' => 403, 'description' => '禁止创建分享'], + ['code' => 'CrossAccountAccessForbidden', 'message' => 'CrossAccountAccessForbidden', 'http_code' => 403, 'description' => '禁止跨租户访问'], + ['code' => 'CrossSubdomainAccessForbidden', 'message' => 'CrossSubdomainAccessForbidden', 'http_code' => 403, 'description' => '禁止跨子域访问'], + ['code' => 'DriveTotalSizeLessThanUsedSize', 'message' => 'DriveTotalSizeLessThanUsedSize', 'http_code' => 400, 'description' => '修改drive的总使用量时，不允许修改为小于已使用量'], + ['code' => 'DriveTotalSizeNeed', 'message' => 'DriveTotalSizeNeed', 'http_code' => 400, 'description' => '有quota限制不能创建不限制大小的drive'], + ['code' => 'FileNotInRecycleBinCannotBeDelete', 'message' => 'FileNotInRecycleBinCannotBeDelete', 'http_code' => 400, 'description' => '文件在回收站中不允许删除'], + ['code' => 'Forbidden', 'message' => 'Forbidden', 'http_code' => 403, 'description' => '禁止'], + ['code' => 'ForbiddenDriveLocked', 'message' => 'ForbiddenDriveLocked', 'http_code' => 403, 'description' => '空间已经锁定'], + ['code' => 'ForbiddenFileInTheRecycleBin', 'message' => 'ForbiddenFileInTheRecycleBin', 'http_code' => 403, 'description' => '文件在回收站中，禁止操作'], + ['code' => 'ForbiddenFileInTrashedFolder', 'message' => 'ForbiddenFileInTrashedFolder', 'http_code' => 403, 'description' => '回收站删除目录下的文件不支持单独恢复'], + ['code' => 'ForbiddenFileLocked', 'message' => 'ForbiddenFileLocked', 'http_code' => 403, 'description' => '文件已经锁定'], + ['code' => 'ForbiddenUpload', 'message' => 'ForbiddenUpload', 'http_code' => 403, 'description' => '禁止上传'], + ['code' => 'InternalError', 'message' => 'InternalError', 'http_code' => 500, 'description' => '内部错误'], + ['code' => 'InvalidAccountStatus', 'message' => 'InvalidAccountStatus', 'http_code' => 400, 'description' => '帐号状态非法'], + ['code' => 'InvalidFieldMissing', 'message' => 'InvalidFieldMissing', 'http_code' => 400, 'description' => '参数缺省'], + ['code' => 'InvalidFieldNotMatch', 'message' => 'InvalidFieldNotMatch', 'http_code' => 400, 'description' => '参数不匹配'], + ['code' => 'InvalidFieldNotSupported', 'message' => 'InvalidFieldNotSupported', 'http_code' => 400, 'description' => '请求参数不支持'], + ['code' => 'InvalidFieldOutOfRange', 'message' => 'InvalidFieldOutOfRange', 'http_code' => 400, 'description' => '参数超过范围'], + ['code' => 'InvalidFieldWrongFormat', 'message' => 'InvalidFieldWrongFormat', 'http_code' => 400, 'description' => '参数格式错误'], + ['code' => 'InvalidFileStatus', 'message' => 'InvalidFileStatus', 'http_code' => 400, 'description' => '文件状态非法'], + ['code' => 'InvalidHeader', 'message' => 'InvalidHeader', 'http_code' => 400, 'description' => 'http header 非法'], + ['code' => 'InvalidJSONFormat', 'message' => 'InvalidJSONFormat', 'http_code' => 400, 'description' => '请求的JSON格式错误'], + ['code' => 'InvalidParameter', 'message' => 'InvalidParameter', 'http_code' => 400, 'description' => '参数非法'], + ['code' => 'InvalidParameterEmpty', 'message' => 'InvalidParameterEmpty', 'http_code' => 400, 'description' => '参数不能为空'], + ['code' => 'InvalidPassword', 'message' => 'InvalidPassword', 'http_code' => 400, 'description' => '密码错误'], + ['code' => 'InvalidRapidProof', 'message' => 'InvalidRapidProof', 'http_code' => 400, 'description' => '秒传证明非法'], + ['code' => 'InvalidResource', 'message' => 'InvalidResource', 'http_code' => 400, 'description' => '资源无效'], + ['code' => 'InvalidResourceAlreadyExist', 'message' => 'InvalidResourceAlreadyExist', 'http_code' => 409, 'description' => '资源已存在'], + ['code' => 'InvalidResourceNotEmpty', 'message' => 'InvalidResourceNotEmpty', 'http_code' => 400, 'description' => '资源不为空'], + ['code' => 'InvalidResourceNotFound', 'message' => 'InvalidResourceNotFound', 'http_code' => 404, 'description' => '资源未找到'], + ['code' => 'InvalidResourceStatus', 'message' => 'InvalidResourceStatus', 'http_code' => 400, 'description' => '资源状态非法'], + ['code' => 'InvalidResourceUnsupported', 'message' => 'InvalidResourceUnsupported', 'http_code' => 400, 'description' => '资源不支持'], + ['code' => 'InvalidUserStatus', 'message' => 'InvalidUserStatus', 'http_code' => 400, 'description' => '用户状态非法'], + ['code' => 'LimitArchive', 'message' => 'LimitArchive', 'http_code' => 400, 'description' => '压缩文件大小超过配额'], + ['code' => 'LoginDenied', 'message' => 'LoginDenied', 'http_code' => 403, 'description' => '不允许登陆'], + ['code' => 'NeedChangePassword', 'message' => 'NeedChangePassword', 'http_code' => 400, 'description' => '需要修改密码'], + ['code' => 'NoPermissionToAccess', 'message' => 'NoPermissionToAccess', 'http_code' => 403, 'description' => '访问无权限'], + ['code' => 'NotFound.VideoPreviewInfo', 'message' => 'The resource video_preview_info cannot be found. $detail_info', 'http_code' => 404, 'description' => '转码信息不存在'], + ['code' => 'NotSupportedFileType', 'message' => 'NotSupportedFileType', 'http_code' => 400, 'description' => '文件类型不支持'], + ['code' => 'OfficeEditNotEnabled', 'message' => 'OfficeEditNotEnabled', 'http_code' => 400, 'description' => '文档编辑开关未打开'], + ['code' => 'OfficePreviewNotEnabled', 'message' => 'OfficePreviewNotEnabled', 'http_code' => 400, 'description' => '文档预览开关未打开'], + ['code' => 'OperationDenied', 'message' => 'OperationDenied', 'http_code' => 400, 'description' => '禁止操作'], + ['code' => 'OperationNotSupport', 'message' => 'OperationNotSupport', 'http_code' => 400, 'description' => '操作不支持'], + ['code' => 'ParentPathMappingExist', 'message' => 'ParentPathMappingExist', 'http_code' => 400, 'description' => '父目录已经存在同步映射'], + ['code' => 'PasswordTooSimple', 'message' => 'PasswordTooSimple', 'http_code' => 400, 'description' => '密码不符合规则'], + ['code' => 'QuotaExceeded', 'message' => 'QuotaExceeded', 'http_code' => 400, 'description' => '超过配额'], + ['code' => 'RapidProofNeed', 'message' => 'RapidProofNeed', 'http_code' => 400, 'description' => '需要秒传证明'], + ['code' => 'ResourceExpired', 'message' => 'ResourceExpired', 'http_code' => 403, 'description' => '资源已过期'], + ['code' => 'ShareLinkCancelled', 'message' => 'ShareLinkCancelled', 'http_code' => 400, 'description' => '共享链接已经取消'], + ['code' => 'ShareLinkContentInvalid', 'message' => 'ShareLinkContentInvalid', 'http_code' => 400, 'description' => '共享链接内容非法'], + ['code' => 'ShareLinkExpired', 'message' => 'ShareLinkExpired', 'http_code' => 400, 'description' => '共享链接已过期'], + ['code' => 'ShareLinkGlobalDisabled', 'message' => 'ShareLinkGlobalDisabled', 'http_code' => 400, 'description' => '共享链接功能全局关闭'], + ['code' => 'ShareLinkTokenInvalid', 'message' => 'ShareLinkTokenInvalid', 'http_code' => 401, 'description' => '共享链接令牌非法'], + ['code' => 'SignatureDoesNotMatch', 'message' => 'SignatureDoesNotMatch', 'http_code' => 403, 'description' => '签名不匹配'], + ['code' => 'StateConflict', 'message' => 'StateConflict', 'http_code' => 409, 'description' => '状态冲突'], + ['code' => 'SubdomainNameExists', 'message' => 'SubdomainNameExists', 'http_code' => 400, 'description' => '子域的名称已存在'], + ['code' => 'SubPathMappingExist', 'message' => 'SubPathMappingExist', 'http_code' => 400, 'description' => '同步目录映射已存在'], + ['code' => 'Timeout', 'message' => 'Timeout', 'http_code' => 408, 'description' => '超时'], + ['code' => 'TooManyRequests', 'message' => 'TooManyRequests', 'http_code' => 429, 'description' => '请求超过流控'], + ['code' => 'UserForbidShare', 'message' => 'UserForbidShare', 'http_code' => 401, 'description' => '用户禁止分享'], + ['code' => 'UserNotVerified', 'message' => 'UserNotVerified', 'http_code' => 401, 'description' => '用户未实名认证'], + ['code' => 'UserRightsForbidden', 'message' => 'UserRightsForbidden', 'http_code' => 403, 'description' => '用户权益禁止'], + ['code' => 'VideoPreviewWaitAndRetry', 'message' => 'video is transcoding, please wait and retry. $detail_info', 'http_code' => 202, 'description' => '正在转码中，请等待并重试'], + ], + 'changeSet' => [], + 'flowControl' => [ + 'flowControlList' => [], ], ]; |