临时上传凭证

调用创建任务并获取上传密钥或再次获取上传密钥后，使用返回的 data.params 临时凭证上传建模输入数据。

通用约定

建议上传统一使用分片上传。
临时上传凭证的使用方式，均以具体云服务商的官方文档为准。
分片数量上限为 10000，大文件请按总大小计算分片大小，避免超出分片数上限。
文件最终 Key 为 savePath 加文件相对路径。
临时凭证默认有效期 12 小时，过期后调用再次获取上传密钥续期。

云服务商对应关系

接口返回的 data.params.cloudService 决定使用哪一套 SDK。每个接入方通常只固定对接一个云服务商，无需全部对接。

cloudService	云服务商	对接章节
`OSS`	阿里云对象存储	阿里云 OSS
`AWS`	亚马逊 S3	AWS S3
`KS3`	金山云对象存储	金山云 KS3

阿里云 OSS

参考文档	链接
STS 临时凭证创建 Client	使用 STS 临时访问凭证访问 OSS
分片上传	Java 分片上传

import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.CredentialsProvider;
import com.aliyun.oss.common.auth.DefaultCredentialProvider;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.PutObjectRequest;
import com.aliyun.oss.model.PutObjectResult;
import java.io.File;

public class Demo {
    public static void main(String[] args) throws Exception {
        // 填写接口返回的临时访问密钥与 SecurityToken
        // 注意：STS 获取的 AccessKeyId 以 STS 开头
        String accessKeyId     = "yourSTSAccessKeyID";
        String accessKeySecret = "yourSTSAccessKeySecret";
        String stsToken        = "yourSecurityToken";
        String endpoint        = "endpoint";
        String region          = "region";
        String bucket          = "bucket";
        // key = savePath + 文件相对路径
        String key = "prd/spatial-model/{accountId}/{taskCode}/input/render2/info/poses.json";

        CredentialsProvider credentialsProvider =
                new DefaultCredentialProvider(accessKeyId, accessKeySecret, stsToken);

        ClientBuilderConfiguration conf = new ClientBuilderConfiguration();
        conf.setSignatureVersion(SignVersion.V4);   // 显式声明使用 V4 签名算法

        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(conf)
                .region(region)
                .build();
        try {
            PutObjectRequest req =
                    new PutObjectRequest(bucket, key, new File("D:\\localpath\\poses.json"));
            PutObjectResult result = ossClient.putObject(req);
        } catch (OSSException oe) {
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:"    + oe.getErrorCode());
            System.out.println("Request ID:"    + oe.getRequestId());
        } catch (ClientException ce) {
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            if (ossClient != null) ossClient.shutdown();
        }
    }
}

AWS S3

参考文档	链接
STS 临时凭证创建 Client	Supply credentials explicitly
上传（Java）	PutObject 示例
上传（JS）	@aws-sdk/lib-storage

public static void main(String[] args) throws Exception {
    String accessKeyId     = "yourSTSAccessKeyID";
    String accessKeySecret = "yourSTSAccessKeySecret";
    String securityToken   = "yourSecurityToken";
    String region = "region";
    String bucket = "bucket";
    String key    = "prd/spatial-model/{accountId}/{taskCode}/input/render2/info/poses.json";

    AwsSessionCredentials sessionCredentials = AwsSessionCredentials.create(
            accessKeyId, accessKeySecret, securityToken);
    // 使用临时凭证初始化 S3 客户端
    S3Client s3Client = S3Client.builder()
            .region(Region.of(region))
            .credentialsProvider(StaticCredentialsProvider.create(sessionCredentials))
            .build();

    PutObjectRequest putObjectRequest = PutObjectRequest.builder()
            .bucket(bucket)
            .key(key)
            .build();

    s3Client.putObject(putObjectRequest, java.nio.file.Paths.get("D:\\resource\\poses.json"));
}

金山云 KS3

参考文档	链接
STS 临时凭证创建 Client	KS3 临时凭证
分片上传	KS3 上传

public Ks3Client initKs3Client() {
    String accessKeyId     = "yourSTSAccessKeyID";
    String accessKeySecret = "yourSTSAccessKeySecret";
    String securityToken   = "yourSecurityToken";
    String endpoint        = "yourEndpoint";
    String region          = "region";

    Ks3ClientConfig config = new Ks3ClientConfig();
    config.setEndpoint(endpoint);
    config.setRegion(Region.valueOf(region));
    config.setProtocol(Ks3ClientConfig.PROTOCOL.http);
    config.setHttpClientConfig(new HttpClientConfig());

    return new Ks3Client(accessKeyId, accessKeySecret, securityToken, config);
}

上传完成后

调用上传状态更新并传 status = 3，否则建模不会启动。