Credenciales temporales de carga

Después de llamar a Crear tarea y obtener las credenciales de carga o a Obtener de nuevo las credenciales de carga, usa las credenciales temporales de data.params para subir los datos de entrada del modelado.

Convenciones generales

Usa la carga por partes para todas las cargas.
Para saber cómo usar las credenciales temporales de carga, sigue la documentación oficial del proveedor de nube correspondiente.
El número máximo de partes es 10.000. Para archivos grandes, calcula el tamaño de parte a partir del tamaño total para no superar el límite.
La Key final del archivo es savePath más la ruta relativa del archivo.
Las credenciales temporales son válidas durante 12 horas de forma predeterminada. Cuando caduquen, llama a Obtener de nuevo las credenciales de carga para renovarlas.

Correspondencia de proveedores de nube

El valor data.params.cloudService de la respuesta determina qué SDK usar. Normalmente cada integrador trabaja con un único proveedor de nube fijo, por lo que no necesitas admitirlos todos.

cloudService	Proveedor de nube	Sección
`OSS`	Almacenamiento de objetos de Alibaba Cloud	Alibaba Cloud OSS
`AWS`	Amazon S3	AWS S3
`KS3`	Almacenamiento de objetos de Kingsoft Cloud	Kingsoft Cloud KS3

Alibaba Cloud OSS

Referencia	Enlace
Crear un cliente con credenciales temporales de STS	Use temporary access credentials provided by STS to access OSS
Carga por partes	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 {
        // Rellena la clave de acceso temporal y el SecurityToken devueltos por la API
        // Nota: un AccessKeyId obtenido de STS empieza por "STS"
        String accessKeyId     = "yourSTSAccessKeyID";
        String accessKeySecret = "yourSTSAccessKeySecret";
        String stsToken        = "yourSecurityToken";
        String endpoint        = "endpoint";
        String region          = "region";
        String bucket          = "bucket";
        // key = savePath + ruta relativa del archivo
        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);   // Usar explícitamente el algoritmo de firma 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

Referencia	Enlace
Crear un cliente con credenciales temporales de STS	Supply credentials explicitly
Carga (Java)	PutObject example
Carga (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);
    // Inicializar el cliente de S3 con las credenciales temporales
    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

Referencia	Enlace
Crear un cliente con credenciales temporales de STS	KS3 temporary credentials
Carga por partes	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);
}

Después de la carga

Llama a Actualizar el estado de carga con status = 3; de lo contrario, el modelado no se iniciará.