帮你快速理解、总结文档立即下载
文档中心>智能媒资托管>SDK 文档>Java SDK>分享管理

分享管理

最近更新时间：2026-09-30 16:51:31
我的收藏

本页目录：

前期准备

开始操作前，确保您已经完成了 SDK 初始化。如果您还没有初始化 SDK，请先参考快速入门文档完成。
注意：
分享相关接口分为两类：分享管理接口（创建、查询、更新、删除分享等，需要访问令牌）和分享访问接口（通过分享码/提取码访问分享内容，部分无需认证）。
访问分享文件前，需要先通过「验证提取码」接口获取分享访问令牌（有效期 10 分钟），并将其作为 accessToken 传入后续分享访问接口。
仅当 adminEnabled 与 ownerEnabled 同时为 true 时，分享外链才可用。

创建分享

功能说明
createShare 用于创建文件或目录的分享链接，支持设置有效期、提取码、预览/下载/转存权限等。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.ShareApi;
import com.tencent.cloud.smh.model.CreateShareRequest;
import com.tencent.cloud.smh.model.CreateShareRequestConfig;
import com.tencent.cloud.smh.model.CreateShare200Response;
import java.time.OffsetDateTime;
import java.util.List;

CreateShareRequestConfig config = new CreateShareRequestConfig()
    .isPermanent(false)
    .expireTime(OffsetDateTime.parse("2026-12-31T23:59:59+08:00"))
    .canPreview(true)
    .canDownload(true);

CreateShareRequest shareBody = new CreateShareRequest()
    .name("report.pdf")
    .filePath(List.of("/documents/report.pdf"))
    .config(config);

try {
    ShareApi.APICreateShareRequest request = ShareApi.APICreateShareRequest.newBuilder()
        .libraryId("your-library-id")
        .spaceId("your-space-id")
        .accessToken("your-access-token")
        .createShareRequest(shareBody)
        .build();

    ApiResponse<Object> apiResponse = client.share().createShareWithHttpInfo(request);

    if (apiResponse.getStatusCode() == 200) {
        CreateShare200Response result = (CreateShare200Response) apiResponse.getData();
        System.out.println("Share ID: " + result.getId());
        System.out.println("Share code: " + result.getCode());
        System.out.println("Endpoint: " + result.getEndpoint());
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
String
是
spaceId
空间 ID，如果媒体库为单租户模式，则该参数固定为连字符(-)；如果媒体库为多租户模式，则必须指定该参数
String
是
createShareRequest
创建分享请求对象
CreateShareRequest
是
accessToken
访问令牌；对于公有读媒体库或租户空间可不指定，否则需通过本参数传入或提前调用 client.withToken() 注入，二者取一
String
否
userId
用户身份识别，当访问令牌对应的权限为管理员权限且申请访问令牌时的用户身份识别为空时用来临时指定用户身份
String
否
CreateShareRequest 对象说明
字段
参数描述
类型
是否必填
name
分享名称
String
是
filePath
分享的文件或目录路径数组，最多1000个
List<String>
是
config
分享配置
CreateShareRequestConfig
否
CreateShareRequestConfig 对象说明
字段
参数描述
类型
是否必填
isPermanent
是否永久有效，默认 false
Boolean
否
expireTime
过期时间，isPermanent 为 false 时必填
OffsetDateTime
条件必填
extractionCode
提取码，不超过6位
String
否
canPreview
是否允许预览，默认 false
Boolean
否
canDownload
是否允许下载，默认 false
Boolean
否
canSaveToNetdisk
是否允许转存，默认 false
Boolean
否
forbidAnonymousUser
是否禁止匿名用户访问，默认 false
Boolean
否
previewLimit
预览次数限制，仅单文件分享生效，canPreview 为 false 时忽略
Integer
否
downloadLimit
下载次数限制，仅单文件分享生效，canDownload 为 false 时忽略
Integer
否
userLimit
访问人数限制
Integer
否
shareToUsers
指定可访问的用户，设置后禁止匿名访问
List<String>
否
返回值说明
HTTP 状态码：200，创建成功。
字段
说明
类型
id
分享 ID
Long
code
分享码，用于访问分享
String
endpoint
分享访问地址
String
createTime
创建时间
OffsetDateTime
expireTime
过期时间
OffsetDateTime
isPermanent
是否永久有效
Boolean
domain
分享域名信息，含 shareDomain 数组
Object

列出分享

功能说明
listShares 用于列出当前媒体库下的分享列表，支持分页。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.ShareApi;
import com.tencent.cloud.smh.model.ListShares200Response;

try {
    ShareApi.APIListSharesRequest request = ShareApi.APIListSharesRequest.newBuilder()
        .libraryId("your-library-id")
        .accessToken("your-access-token")
        .limit(20)
        .orderByType("desc")
        .withFileInfo(1)
        .build();

    ApiResponse<Object> apiResponse = client.share().listSharesWithHttpInfo(request);

    if (apiResponse.getStatusCode() == 200) {
        ListShares200Response result = (ListShares200Response) apiResponse.getData();
        for (var share : result.getContents()) {
            System.out.println("Share: " + share.getName() + ", code: " + share.getCode());
        }
        if (Boolean.TRUE.equals(result.getHasMore())) {
            System.out.println("More shares, next marker: " + result.getMarker());
        }
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
String
是
limit
每页数量，默认 10，最大 100
Integer
否
marker
分页标识
String
否
orderBy
排序字段，默认 createTime
String
否
orderByType
排序方式：asc（默认）、desc
String
否
creatorId
按创建者筛选，仅管理员可用
String
否
withFileInfo
是否返回文件信息，0（默认）或 1
Integer
否
accessToken
访问令牌；对于公有读媒体库或租户空间可不指定，否则需通过本参数传入或提前调用 client.withToken() 注入，二者取一
String
否
userId
用户身份识别
String
否
返回值说明
HTTP 状态码：200，返回 contents 分享数组、marker 分页标识与 hasMore。分享对象主要字段：id、name、code、creatorId、createTime、expireTime、isPermanent、adminEnabled、ownerEnabled、canPreview、canDownload、canSaveToNetdisk、previewLimit/previewUsed、downloadLimit/downloadUsed、status（0 未审核、1 审核中、2 审核通过、3 审核不通过）、userLimit/userLimitUsed、fileInfo（withFileInfo=1 时返回）。

搜索分享

功能说明
searchShares 用于按名称、创建者、时间范围等条件搜索分享。仅管理员可用，QPS 上限 10。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.ShareApi;
import com.tencent.cloud.smh.model.SearchSharesRequest;
import com.tencent.cloud.smh.model.SearchShares200Response;

SearchSharesRequest searchBody = new SearchSharesRequest()
    .name("report")
    .orderBy(SearchSharesRequest.OrderByEnum.CREATE_TIME)
    .orderByType(SearchSharesRequest.OrderByTypeEnum.DESC);

try {
    ShareApi.APISearchSharesRequest request = ShareApi.APISearchSharesRequest.newBuilder()
        .libraryId("your-library-id")
        .accessToken("your-access-token")
        .limit(20)
        .searchSharesRequest(searchBody)
        .build();

    ApiResponse<Object> apiResponse = client.share().searchSharesWithHttpInfo(request);

    if (apiResponse.getStatusCode() == 200) {
        SearchShares200Response result = (SearchShares200Response) apiResponse.getData();
        for (var share : result.getContents()) {
            System.out.println("Share: " + share.getName());
        }
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
String
是
limit
每页数量，默认10，最大50
Integer
否
marker
分页标识
String
否
searchSharesRequest
搜索条件对象
SearchSharesRequest
否
accessToken
访问令牌；对于公有读媒体库或租户空间可不指定，否则需通过本参数传入或提前调用 client.withToken() 注入，二者取一
String
否
SearchSharesRequest 对象说明：name（名称模糊匹配）、creatorId（创建者精确匹配）、orderBy（createTime/expireTime/name/creatorId）、orderByType（asc/desc）、expireTimeStart/expireTimeEnd、createTimeStart/createTimeEnd。

获取分享详情

功能说明
getShareDetail 用于获取指定分享的详细信息。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.ShareApi;
import com.tencent.cloud.smh.model.GetShareDetail200Response;
import java.math.BigDecimal;

try {
    ShareApi.APIGetShareDetailRequest request = ShareApi.APIGetShareDetailRequest.newBuilder()
        .libraryId("your-library-id")
        .shareId("12345")
        .detail(1)
        .accessToken("your-access-token")
        .withFileInfo(1)
        .build();

    ApiResponse<Object> apiResponse = client.share().getShareDetailWithHttpInfo(request);

    if (apiResponse.getStatusCode() == 200) {
        GetShareDetail200Response result = (GetShareDetail200Response) apiResponse.getData();
        System.out.println("Name: " + result.getName());
        System.out.println("Code: " + result.getCode());
        System.out.println("Expired: " + result.getIsExpired());
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
String
是
shareId
分享 ID
String
是
detail
固定值1，表示获取分享详情
BigDecimal
是
withFileInfo
是否返回文件信息，0（默认）或1
Integer
否
accessToken
访问令牌；对于公有读媒体库或租户空间可不指定，否则需通过本参数传入或提前调用 client.withToken() 注入，二者取一
String
否
返回值说明
HTTP 状态码：200。主要字段：id、libraryId、name、code、creatorId、creationTime、expireTime、isPermanent、isExpired、extractionCode、ownerEnabled、adminEnabled、status（0-3）、canPreview、canDownload、canSaveToNetdisk、forbidAnonymousUser、previewLimit/previewUsed、downloadLimit/downloadUsed、fileInfo、toUsers、userLimit/userLimitUsed、watermarkText。

获取分享 URL 详情

功能说明
getShareUrlDetail 用于通过分享码（shareToken）获取分享的基本信息，无需认证，适用于访问者打开分享链接时展示分享概况。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.ShareApi;
import com.tencent.cloud.smh.model.GetShareUrlDetail200Response;

try {
    ShareApi.APIGetShareUrlDetailRequest request = ShareApi.APIGetShareUrlDetailRequest.newBuilder()
        .shareToken("share-token-from-url")
        .build();

    ApiResponse<Object> apiResponse = client.share().getShareUrlDetailWithHttpInfo(request);

    if (apiResponse.getStatusCode() == 200) {
        GetShareUrlDetail200Response result = (GetShareUrlDetail200Response) apiResponse.getData();
        System.out.println("Name: " + result.getName());
        System.out.println("Need extraction code: " + result.getNeedExtractionCode());
        System.out.println("Enabled: " + result.getEnabled());
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
shareToken
分享链接中的分享码
String
是
返回值说明
HTTP 状态码：200。主要字段：name、enabled、isExpired、needExtractionCode、allowAnonymousUser、canPreview、canDownload、canSaveToNetDisc、status、enableShareWatermark、shareWatermarkType、watermarkText、fileName、domain（含 shareDomain 数组）。

更新分享

功能说明
updateShare 用于更新分享的名称和配置。不允许修改 shareToUsers；更新后预览/下载次数统计（previewUsed/downloadUsed）会重置为 0。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.ShareApi;
import com.tencent.cloud.smh.model.UpdateShareRequest;
import com.tencent.cloud.smh.model.UpdateShareRequestConfig;
import com.tencent.cloud.smh.model.UpdateShare200Response;
import java.math.BigDecimal;

UpdateShareRequestConfig config = new UpdateShareRequestConfig()
    .isPermanent(false)
    .expireTime(java.time.OffsetDateTime.parse("2027-06-30T23:59:59+08:00"))
    .canPreview(true)
    .canDownload(true);

UpdateShareRequest updateBody = new UpdateShareRequest()
    .name("report-v2.pdf")
    .config(config);

try {
    ShareApi.APIUpdateShareRequest request = ShareApi.APIUpdateShareRequest.newBuilder()
        .libraryId("your-library-id")
        .shareId("12345")
        .update(1)
        .accessToken("your-access-token")
        .updateShareRequest(updateBody)
        .build();

    ApiResponse<Object> apiResponse = client.share().updateShareWithHttpInfo(request);

    if (apiResponse.getStatusCode() == 200) {
        UpdateShare200Response result = (UpdateShare200Response) apiResponse.getData();
        System.out.println("Updated, endpoint: " + result.getEndpoint());
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
String
是
shareId
分享 ID
String
是
update
固定值1，表示更新分享
BigDecimal
是
updateShareRequest
更新分享请求对象，config 字段必填（字段同创建配置，但不支持 shareToUsers）
UpdateShareRequest
是
accessToken
访问令牌；对于公有读媒体库或租户空间可不指定，否则需通过本参数传入或提前调用 client.withToken() 注入，二者取一
String
否

禁用或启用分享

功能说明
setShareEnabled 用于禁用或启用分享。仅当 adminEnabled 与 ownerEnabled 同时为 true 时，分享外链才可用。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.ShareApi;
import com.tencent.cloud.smh.model.SetShareEnabledRequest;
import java.math.BigDecimal;

SetShareEnabledRequest enabledBody = new SetShareEnabledRequest()
    .ownerEnabled(false); // 创建者禁用分享

try {
    ShareApi.APISetShareEnabledRequest request = ShareApi.APISetShareEnabledRequest.newBuilder()
        .libraryId("your-library-id")
        .shareId("12345")
        .setEnabled(1)
        .accessToken("your-access-token")
        .setShareEnabledRequest(enabledBody)
        .build();

    ApiResponse<Object> apiResponse = client.share().setShareEnabledWithHttpInfo(request);
    System.out.println("Status code: " + apiResponse.getStatusCode());
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
String
是
shareId
分享 ID
String
是
setEnabled
固定值1，表示禁用或启用分享
BigDecimal
是
setShareEnabledRequest
启用状态对象：adminEnabled（仅管理员可设置）、ownerEnabled（创建者可设置）
SetShareEnabledRequest
是
accessToken
访问令牌；对于公有读媒体库或租户空间可不指定，否则需通过本参数传入或提前调用 client.withToken() 注入，二者取一
String
否

删除分享

功能说明
deleteShare 用于删除指定分享，删除后分享链接立即失效。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.ShareApi;

try {
    ShareApi.APIDeleteShareRequest request = ShareApi.APIDeleteShareRequest.newBuilder()
        .libraryId("your-library-id")
        .shareId("12345")
        .accessToken("your-access-token")
        .build();

    ApiResponse<Object> apiResponse = client.share().deleteShareWithHttpInfo(request);
    System.out.println("Status code: " + apiResponse.getStatusCode());
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
libraryId
媒体库 ID
String
是
shareId
分享 ID
String
是
accessToken
访问令牌；对于公有读媒体库或租户空间可不指定，否则需通过本参数传入或提前调用 client.withToken() 注入，二者取一
String
否
返回值说明
HTTP 状态码：204，删除成功，无响应体。

验证提取码

功能说明
verifyExtractionCode 用于校验分享提取码，验证成功后返回分享访问令牌（有效期 10 分钟），后续访问分享文件需携带该令牌。本接口无需认证。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.ShareApi;
import com.tencent.cloud.smh.model.VerifyExtractionCodeRequest;
import com.tencent.cloud.smh.model.VerifyExtractionCode200Response;

VerifyExtractionCodeRequest verifyBody = new VerifyExtractionCodeRequest()
    .extractionCode("ab12");

try {
    ShareApi.APIVerifyExtractionCodeRequest request = ShareApi.APIVerifyExtractionCodeRequest.newBuilder()
        .shareCode("share-code")
        .verifyExtractionCodeRequest(verifyBody)
        .build();

    ApiResponse<Object> apiResponse = client.share().verifyExtractionCodeWithHttpInfo(request);

    if (apiResponse.getStatusCode() == 200) {
        VerifyExtractionCode200Response result = (VerifyExtractionCode200Response) apiResponse.getData();
        System.out.println("Share access token: " + result.getAccessToken());
        System.out.println("Expire time: " + result.getExpireTime());
        // 后续访问分享文件时，将该 accessToken 作为访问令牌传入
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
shareCode
分享码
String
是
verifyExtractionCodeRequest
验证请求对象：extractionCode（必填）；libraryId 与 accessToken（分享要求登录时必填）；deviceId（可选）
VerifyExtractionCodeRequest
是
返回值说明
HTTP 状态码：200，验证成功。
字段
说明
类型
accessToken
分享访问令牌，有效期 10 分钟
String
expireTime
令牌过期时间
OffsetDateTime

列出分享文件

功能说明
listShareFiles 用于列出分享中的文件和目录，支持分页浏览目录内容。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.ShareApi;
import com.tencent.cloud.smh.model.ListShareFiles200Response;
import java.math.BigDecimal;

try {
    ShareApi.APIListShareFilesRequest request = ShareApi.APIListShareFilesRequest.newBuilder()
        .shareCode("share-code")
        .inodes("root-inode")
        ._list(1)
        .accessToken("share-access-token") // 验证提取码获取的分享访问令牌
        .limit(50)
        .build();

    ApiResponse<Object> apiResponse = client.share().listShareFilesWithHttpInfo(request);

    if (apiResponse.getStatusCode() == 200) {
        ListShareFiles200Response result = (ListShareFiles200Response) apiResponse.getData();
        for (var file : result.getContents()) {
            System.out.println(file.getName() + " (" + file.getType() + ")");
        }
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
shareCode
分享码
String
是
inodes
目录 inode，指定列出的目录层级
String
是
list
固定值 1，表示列出分享文件
BigDecimal
是
limit
每页数量，默认 10，取值 0-100
Integer
否
marker
分页标识
String
否
orderBy
排序字段：name、size、updatedAt
String
否
orderByType
排序方式：asc（默认）、desc
String
否
accessToken
分享访问令牌
String
否
返回值说明
HTTP 状态码：200，返回 contents（name、spaceId、type（file/dir）、size、updateTime、canPreview、canDownload、canSaveToNetdisk、inode）、marker、hasMore。

预览或下载分享文件

功能说明
previewShareFile 与 downloadShareFile 分别用于预览和下载分享中的文件，均通过 HTTP 302 重定向到实际地址。默认情况下 SDK 自动跟随重定向。如需获取 Location 中的 URL 而非跟随跳转，请先调用 client.setFollowRedirects(HttpClient.Redirect.NEVER)，再从 ApiException 的响应头中读取（302 按非 2xx 抛出）。调用前需先通过「验证提取码」获取分享访问令牌；预览/下载次数受分享配置的 previewLimit/downloadLimit 限制并计入 previewUsed/downloadUsed。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.ShareApi;
import java.math.BigDecimal;

try {
    // 预览分享文件
    ShareApi.APIPreviewShareFileRequest previewRequest = ShareApi.APIPreviewShareFileRequest.newBuilder()
        .shareCode("share-code")
        .inodes("file-inode")
        .preview(1)
        .accessToken("share-access-token")
        .build();
    ApiResponse<Object> previewResponse = client.share().previewShareFileWithHttpInfo(previewRequest);
    System.out.println("Preview status: " + previewResponse.getStatusCode());

    // 下载分享文件
    ShareApi.APIDownloadShareFileRequest downloadRequest = ShareApi.APIDownloadShareFileRequest.newBuilder()
        .shareCode("share-code")
        .inodes("file-inode")
        .download(1)
        .accessToken("share-access-token")
        .build();
    ApiResponse<Object> downloadResponse = client.share().downloadShareFileWithHttpInfo(downloadRequest);
    System.out.println("Download status: " + downloadResponse.getStatusCode());
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
shareCode
分享码
String
是
inodes
文件 inode，必须指向文件
String
是
preview / download
固定值1，分别表示预览或下载
BigDecimal
是
internalDomain
是否使用内网域名
Integer
否
accessToken
分享访问令牌
String
否

转存分享文件

功能说明
saveShareFile 用于将分享中的文件转存到自己媒体库的指定空间，需分享配置开启 canSaveToNetdisk。转存可能同步完成（200）、转为异步任务（202）或部分成功（207）。
使用示例
import com.tencent.cloud.smh.ApiException;
import com.tencent.cloud.smh.ApiResponse;
import com.tencent.cloud.smh.api.ShareApi;
import com.tencent.cloud.smh.model.SaveShareFileRequest;
import com.tencent.cloud.smh.model.SaveShareFile200Response;
import com.tencent.cloud.smh.model.SaveShareFile202Response;
import java.math.BigDecimal;
import java.util.List;

SaveShareFileRequest saveBody = new SaveShareFileRequest()
    .targetSpaceId("your-space-id")
    .targetPath("/saved/")
    .sourceInodesPath("/")
    .inodes(List.of("file-inode-1"))
    .conflictResolutionStrategy(SaveShareFileRequest.ConflictResolutionStrategyEnum.RENAME);

try {
    ShareApi.APISaveShareFileRequest request = ShareApi.APISaveShareFileRequest.newBuilder()
        .shareCode("share-code")
        .save(1)
        .accessToken("share-access-token")
        .saveShareFileRequest(saveBody)
        .build();

    ApiResponse<Object> apiResponse = client.share().saveShareFileWithHttpInfo(request);
    int statusCode = apiResponse.getStatusCode();

    if (statusCode == 200) {
        SaveShareFile200Response result = (SaveShareFile200Response) apiResponse.getData();
        for (var item : result.getResult()) {
            System.out.println("status: " + item.getStatus() + ", path: " + item.getPath());
        }
    } else if (statusCode == 202) {
        SaveShareFile202Response result = (SaveShareFile202Response) apiResponse.getData();
        System.out.println("Async save task, taskId: " + result.getTaskId());
    } else if (statusCode == 207) {
        System.out.println("Partial success");
    }
} catch (ApiException e) {
    System.err.println("Error: " + e.getCode() + " - " + e.getMessage());
}
参数说明
参数名
参数描述
类型
是否必填
shareCode
分享码
String
是
save
固定值1，表示转存分享文件
BigDecimal
是
saveShareFileRequest
转存请求对象
SaveShareFileRequest
是
accessToken
分享访问令牌
String
否
SaveShareFileRequest 对象说明
字段
参数描述
类型
是否必填
targetSpaceId
转存目标空间 ID
String
是
targetPath
转存目标路径
String
否
sourceInodesPath
分享中的源目录路径
String
是
inodes
转存的文件或目录 inode 数组，最多 1000 个
List<String>
是
conflictResolutionStrategy
冲突处理：ask、rename、overwrite；目标为目录时默认 ask 且不支持 overwrite，目标为文件时默认 rename
String
否
中国站