アップロード用一時認証情報

タスクを作成してアップロード認証情報を取得またはアップロード認証情報の再取得を呼び出した後、data.params の一時認証情報を使用してモデリングの入力データをアップロードします。

共通ルール

アップロードはすべてマルチパートアップロードで行ってください。
一時アップロード認証情報の使い方は、各クラウドプロバイダーの公式ドキュメントに従ってください。
最大パート数は 10,000 です。大きなファイルは、上限を超えないよう総サイズからパートサイズを計算してください。
最終的なファイルの Key は savePath にファイルの相対パスを付加したものです。
一時認証情報の有効期間はデフォルトで 12 時間です。期限切れ後はアップロード認証情報の再取得を呼び出して更新してください。

クラウドプロバイダーの対応表

レスポンスの data.params.cloudService の値によって、使用する SDK が決まります。通常、連携先ごとに 1 つのクラウドプロバイダーに固定されるため、すべてに対応する必要はありません。

cloudService	クラウドプロバイダー	セクション
`OSS`	Alibaba Cloud オブジェクトストレージ	Alibaba Cloud OSS
`AWS`	Amazon S3	AWS S3
`KS3`	Kingsoft Cloud オブジェクトストレージ	Kingsoft Cloud KS3

Alibaba Cloud OSS

参考資料	リンク
STS 一時認証情報でクライアントを作成する	Use temporary access credentials provided by STS to access OSS
マルチパートアップロード	Multipart upload (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 {
        // API が返した一時アクセスキーと 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 一時認証情報でクライアントを作成する	Supply credentials explicitly
アップロード（Java）	PutObject example
アップロード（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"));
}

Kingsoft Cloud KS3

参考資料	リンク
STS 一時認証情報でクライアントを作成する	KS3 temporary credentials
マルチパートアップロード	KS3 upload

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 で呼び出してください。呼び出さないとモデリングは開始されません。