tencent cloud

All product documents
Cloud Object Storage
DocumentationCloud Object StorageSDK DocumentationGo SDKFile ProcessingFile Decompression
File Decompression
Download PDF
Last updated: 2024-02-02 15:51:37
File Decompression
Last updated: 2024-02-02 15:51:37
Download PDF

Overview

This document provides an overview of APIs and SDK code samples for file decompression in CI.
API
Description
Submits a file decompression job.
Queries the result of a specified file decompression job.

Submitting a File Decompression Job

Feature description

This API is used to submit a job to perform file decompression and asynchronously return decompressed files.

Method prototype

func (s *CIService) CreateFileProcessJob(ctx context.Context, opt *FileProcessJobOptions) (*FileProcessJobResult, *Response, error)

Sample request

createJobOpt := &cos.FileProcessJobOptions{
    Tag: "FileUncompress",
    Input: &cos.FileProcessInput{
        Object: "294028.zip",
    },
    Operation: &cos.FileProcessJobOperation{
        FileUncompressConfig: &cos.FileUncompressConfig{
            Prefix:         "uncomp",
            PrefixReplaced: "1",
        },
        Output: &cos.FileProcessOutput{
            Region: "ap-beijing",
            Bucket: "test-1250000000",
        }
    },
    QueueId: "p111a8dd208104ce3b11c78398f658ca8",
}
res, _, err := c.CI.CreateFileProcessJob(context.Background(), createJobOpt)

Parameter description

type FileProcessJobOptions struct {
    XMLName          xml.Name
    Tag              string
    Input            *FileProcessInput
    Operation        *FileProcessJobOperation
    QueueId          string
    CallBackFormat   string
    CallBackType     string
    CallBack         string
    CallBackMqConfig *NotifyConfigCallBackMqConfig
}
type FileProcessInput struct {
    Region     string
    Bucket     string
    Object           string
}
type FileProcessJobOperation struct {
    FileHashCodeConfig   *FileHashCodeConfig
    FileHashCodeResult   *FileHashCodeResult
    FileUncompressConfig *FileUncompressConfig
    FileUncompressResult *FileUncompressResult
    FileCompressConfig   *FileCompressConfig
    FileCompressResult   *FileCompressResult
    Output               *FileProcessOutput
    UserData             string
}
type FileHashCodeConfig struct {
    Type        string
    AddToHeader bool
}
type FileHashCodeResult struct {
    MD5          string
    SHA1         string
    SHA256       string
    FileSize     int
    LastModified string
    Etag         string
}
type FileUncompressConfig struct {
    Prefix         string
    PrefixReplaced string
}
type FileUncompressResult struct {
    Region    string
    Bucket    string
    FileCount string
}
type FileCompressConfig struct {
    Flatten string
    Format  string
    UrlList string
    Prefix  string
    Key     string
}
type FileCompressResult struct {
    Region     string
    Bucket     string
    Object           string
}
type FileProcessOutput struct {
    Region     string
    Bucket     string
    Object           string
}
type NotifyConfigCallBackMqConfig struct {
    MqMode   string
    MqRegion string
    MqName   string
}
Parameter
Description
Type
Required
Tag
Job tag, which currently can only be FileUncompress.
String
Yes
Input
The object to be processed. For more information, see Input.
Container
Yes
Operation
Operation rule
Container
Yes
Operation.FileUncompressConfig
File decompression rule. For more information, see Submitting File Decompression Job.
Container
Yes
Operation.FileUncompressResult
File decompression result, which will not be returned when the job is not completed. For more information, see Submitting File Decompression Job.
Container
No
Operation.Output
Address where the output file is stored. For more information, see Submitting Multi-File Zipping Job.
Container
Yes
Operation.UserData
The user information passed through, which is printable ASCII codes of up to 1,024 in length.
String
No
QueueId
ID of the queue where the job is in
String
Yes
CallBackFormat
Job callback format, which can be JSON or XML (default). It takes priority over that of the queue.
String
No
CallBackType
Job callback type, which can be Url (default) or TDMQ. It takes priority over that of the queue.
String
No
CallBack
Job callback address. It takes higher priority over that of the queue.
String
No
CallBackMqConfig
TDMQ configuration for job callback as described in Structure, which is required if CallBackType is TDMQ.
Container
No

Response description

type FileProcessJobResult struct {
    JobsDetail FileProcessJobResult
}
type FileProcessJobResult struct {
    Code         string
    Message      string
    JobId        string
    Tag          string
    State        string
    CreationTime string
    StartTime    string
    EndTime      string
    QueueId      string
    Input        *FileProcessInput
    Operation    *FileProcessJobOperation
}
Parameter
Description
Type
JobsDetail
Job details
Container
Code
Error code, which will be returned only if State is Failed.
String
Message
Error message, which will be returned only if State is Failed.
String
JobId
Job ID
String
Tag
Job tag: FileUncompress
String
State
Job status. Valid values: Submitted, Running, Success, Failed, Pause, Cancel.
String
CreationTime
Job creation time
String
StartTime
Job start time
String
EndTime
Job end time
String
QueueId
ID of the queue which the job is in
String
Input
Path of the input file for this job. For more information, see FileProcessJobOptions.Input.
Container
Operation
Operation rule. For more information, see FileProcessJobOptions.Operation.
Container

Querying File Decompression Result

Feature description

This API is used to query the details of a file processing job by job ID.

Method prototype

func (s *CIService) DescribeFileProcessJob(ctx context.Context, jobid string) (*FileProcessJobResult, *Response, error)

Sample request

jobid := "<jobid>"
res, _, err := c.CI.DescribeFileProcessJob(context.Background(), jobid)

Parameter description

Parameter
Description
Type
Required
jobid
File processing job ID
String
Yes

Response description

type FileProcessJobResult struct {
    JobsDetail *FileProcessJobsDetail
}
Parameter
Description
Type
JobsDetail
Job details, which is the same as Response.JobsDetail in the CreateFileProcessJob API.
Container
Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback

Contact Us

Contact our sales team or business advisors to help your business.

Contact Us
Technical Support

Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

Submit a Ticket
7x24 Phone Support
Hong Kong, China
+852 800 906 020 (Toll Free)
United States
+1 844 606 0804 (Toll Free)
United Kingdom
+44 808 196 4551 (Toll Free)
Canada
+1 888 605 7930 (Toll Free)
Australia
+61 1300 986 386 (Toll Free)
EdgeOne hotline
+852 300 80699
More local hotlines coming soon