Quick Start

1. In the left-side navigation pane, click Buckets. On the Buckets page, find and click the desired bucket.

2. In the navigation pane on the left, choose Object Management > Objects.

3. Click the name of the image or document that you want to process. In the View Details dialog box, use the IMM features.

   You can also click View Details in the Actions column of the target file to open the View Details dialog box.

The following code provides an example of how to use IMM with the OSS SDK for Java.

import com.aliyun.oss.*;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.common.comm.SignVersion;
import com.aliyun.oss.model.GeneratePresignedUrlRequest;
import java.net.URL;
import java.util.Date;

public class Demo {
    // The China (Hangzhou) region is used as an example. Specify the actual endpoint.
    private static String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
    // Specify the region ID that corresponds to the endpoint. For example, cn-hangzhou.
    private static String region = "cn-hangzhou";
    // Obtain access credentials from environment variables. Before you run this sample code, make sure that the OSS_ACCESS_KEY_ID and OSS_ACCESS_KEY_SECRET environment variables are configured.
    static EnvironmentVariableCredentialsProvider credentialsProvider;

    static {
        try {
            credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
        } catch (com.aliyuncs.exceptions.ClientException e) {
            e.printStackTrace();
        }
    }

    // Specify the bucket name. For example, examplebucket.
    private static String bucketName = "examplebucket";
    // Specify the full path of the object. The full path cannot contain the bucket name.
    private static String objectKey = "example.jpg";

    public static void main(String[] args) {
        // Obtain the signed URL for facial recognition on the object.
        URL url = getUrl("imm/detectface", bucketName, objectKey);
        customerPrint(url);
        bucketName = "examplebucket";
        objectKey = "example.txt";
        // Obtain the signed URL for document preview of the object.
        url = getUrl("imm/previewdoc", bucketName, objectKey);
        customerPrint(url);
    }

    private static void customerPrint(URL url){
        if(url != null){
            System.out.println(url.toString());
        }else{
            System.out.println("Failed to obtain the URL.");
        }
    }

    private static URL getUrl(String process, String bucketName, String objectKey) {
        // Create an OSSClient instance.
        // When the OSSClient instance is no longer used, call the shutdown method to release resources.
        ClientBuilderConfiguration clientBuilderConfiguration = new ClientBuilderConfiguration();
        // Explicitly declare the use of the V4 signature algorithm.
        clientBuilderConfiguration.setSignatureVersion(SignVersion.V4);
        OSS ossClient = OSSClientBuilder.create()
                .endpoint(endpoint)
                .credentialsProvider(credentialsProvider)
                .clientConfiguration(clientBuilderConfiguration)
                .region(region)
                .build();

        try {
            GeneratePresignedUrlRequest request = new GeneratePresignedUrlRequest(bucketName, objectKey);
            request.setProcess(process);
            // Set the expiration time of the signed URL. Unit: milliseconds.
            request.setExpiration(new Date(new Date().getTime() + 3600 * 1000));
            return ossClient.generatePresignedUrl(request);
        } catch (OSSException oe) {
            System.out.println("Error Message:" + oe.getErrorMessage());
            System.out.println("Error Code:" + oe.getErrorCode());
            System.out.println("Request ID:" + oe.getRequestId());
            System.out.println("Host ID:" + oe.getHostId());
        } catch (ClientException ce) {
            System.out.println("Error Message:" + ce.getMessage());
        } finally {
            // Shut down the OSSClient instance.
            ossClient.shutdown();
        }
        return null;
    }
}