API | Description |
Creates a hash calculation job. | |
Queries the result of a hash calculation job. |
public FileProcessJobResponse createFileProcessJob(FileProcessRequest request);
Request
has the following sub-nodes:Node Name (Keyword) | Parent Node | Description | Type | Required |
tag | Request | Job type. It is FileHashCode for hash calculation. | String | Yes |
operation | Request | Hash calculation rule. | Container | Yes |
queueId | Request | ID of the queue where the job is in. | String | Yes |
callBackFormat | Request | Job callback format, which can be JSON or XML (default). It takes priority over that of the queue. | String | No |
callBackType | Request | Job callback type, which can be Url (default) or TDMQ . It takes priority over that of the queue. | String | No |
callBack | Request | Job callback address. It takes priority over that of the queue. | String | No |
callBackMqConfig | Request | TDMQ configuration for job callback as described in Structure, which is required if CallBackType is TDMQ . | Container | No |
Input
has the following sub-nodes:Node Name (Keyword) | Parent Node | Description | Type | Required |
object | Request.Input | Filename, which is the full name of the file in the bucket. | String | Yes |
Operation
has the following sub-nodes:Node Name (Keyword) | Parent Node | Description | Type | Required |
fileHashCodeConfig | Request.Operation | Hash calculation rule. | Container | Yes |
userData | Request.Operation | The user information passed through, which is printable ASCII codes of up to 1,024 in length. | String | No |
FileHashCodeConfig
has the following sub-nodes:Node Name (Keyword) | Parent Node | Description | Type | Required |
Type | Request.Operation.FileHashCodeConfig | Hash algorithm. Valid values: MD5 , SHA1 , SHA256 . | String | Yes |
addToHeader | Request.Operation.FileHashCodeConfig | Whether to add the calculated hash value to the custom header in the file. Valid values: true , false (default).<br>The custom header varies depending on Type . For example, if Type is MD5 , the custom header is x-cos-meta-md5 . | String | No |
FileProcessJobResponse
object response information is returned.CosClientException
or CosServiceException
exception. For more information, see Troubleshooting.//1. Create a job request objectFileProcessRequest request = new FileProcessRequest();//2. Add request parameters as detailed in the API documentationrequest.setBucketName("demo-1234567890");request.setTag(FileProcessJobType.FileHashCode);request.getInput().setObject("input/1.mp4");FileHashCodeConfig fileHashCodeConfig = request.getOperation().getFileHashCodeConfig();fileHashCodeConfig.setType("MD5");fileHashCodeConfig.setAddToHeader("true");request.setQueueId("p1ff062b35a494cf0ac4b572df22a****");//3. Call the API to get the job response objectFileProcessJobResponse response = client.createFileProcessJob(request);
public FileProcessJobResponse describeFileProcessJob(FileProcessRequest request);
Parameter | Description | Type | Required |
bucketName | String | Yes | |
jobId | ID of the job to be queried. | String | Yes |
FileProcessJobResponse
.CosClientException
or CosServiceException
exception will be reported. For more information, see Troubleshooting.//1. Create a job request objectFileProcessRequest request = new FileProcessRequest();//2. Add request parameters as detailed in the API documentationrequest.setBucketName("demo-1234567890");request.setJobId("fda7eb1607b8411ed8c182156726*****");//3. Call the API to get the job response objectFileProcessJobResponse response = client.describeFileProcessJob(request);
Was this page helpful?