臨時上傳憑證

調用創建任務並獲取上傳密鑰或再次獲取上傳密鑰後，使用返回的 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，否則建模不會啟動。