tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Cloud Infinite
    Documentation
    Download PDF

    Updating a Concatenation Template

    Last updated: 2021-12-31 17:05:22
    Download PDF

      Feature Description

      This API (UpdateMediaTemplate) is used to update a concatenation template.

      Request

      Sample request

      PUT /template/<TemplateId> HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-Type: application/xml
<body>
      Note：

      Authorization: Auth String (For more information, please see Request Signature.)

      Request headers

      Common request headers

      The implementation of this request operation uses a common request header. For more information on common request headers, see Common Request Headers.

      Non-common request headers

      This API does not use any non-common request header.

      Request body

      This request requires the following request body:

      <Request>
 <Tag>Concat</Tag>
 <Name>TemplateName</Name>
 <ConcatTemplate>
      <ConcatFragment>
          <Mode>Start</Mode>
          <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/start.mp4</Url>
      </ConcatFragment>
      <ConcatFragment>
          <Mode>End</Mode>
          <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/end.mp4</Url>
      </ConcatFragment>
      <Audio>
          <Codec>mp3</Codec>
          <Samplerate></Samplerate>
          <Bitrate></Bitrate>
          <Channels></Channels>
      </Audio>
      <Video>
          <Codec>H.264</Codec>
          <Bitrate>1000</Bitrate>
          <Width>1280</Width>
          <Height></Height>
          <Fps>30</Fps>
      </Video>
      <Container>
          <Format>mp4</Format>
      </Container>
 </ConcatTemplate>
</Request>

      The nodes are described as follows:

      Node Name (Keyword) Parent Node Description Type
      Response None Response container Container

      Request has the following sub-nodes:

      Node Name (Keyword) Parent Node Description Type Required
      Tag Request Task type: Concat String Yes
      Name Request Template name. The value can contain only Chinese characters, letters, digits, underscores (_), hyphens (-), and asterisks (*). String Yes
      ConcatTemplate Request Concatenation template Container Yes

      ConcatTemplate has the following sub-nodes:

      Node Name (Keyword) Parent Node Description Type Required Default Value Constraints
      ConcatFragment Request.ConcatTemplate Concatenation node Container Yes None None
      Audio Request.ConcatTemplate Audio parameter Container No None If the target file does not require audio information, set Audio.Remove to true.
      Video Request.ConcatTemplate Video parameter Container No None If the target file does not require video information, set Video.Remove to true.
      Container Request.ConcatTemplate Container format Container Yes None None

      ConcatFragment has the following sub-nodes:

      Node Name (Keyword) Parent Node Description Type Required Default Value Constraints
      Url Request.ConcatTemplate.
      ConcatFragment      		 Concatenation object address String Yes None Same as the address of the bucket object file.
      Mode Request.ConcatTemplate.
      ConcatFragment      		 Node type String Yes None
    • Start
    • End
      		•

      Audio has the following sub-nodes:

      Node Name (Keyword) Parent Node Description Type Required Default Value Constraints
      Codec Request.ConcatTemplate.
      Audio      		 Codec format String No Original code of the file Valid values: aac, mp3
      Samplerate Request.ConcatTemplate.
      Audio      		 Sample rate String No Original sample rate of the file
    • Unit: Hz
    • Valid values: 11025, 22050, 32000, 44100, 48000, 96000
    • Different container formats support different MP3 sample rates, as shown in the table below.
      		•
      Bitrate Request.ConcatTemplate.
      Audio      		 Audio bitrate String No Original audio bitrate of the file
    • Unit: Kbps
    • Value range: [8, 1000]
      		•
      Channels Request.ConcatTemplate.
      Audio      		 Number of sound channels String No Original number of sound channels of the file
    • If Codec is aac, the value can be 1, 2, 4, 5, 6, or 8.
    • If Codec is mp3, the value can be 1 or 2.
      		•

      Y indicates supported, and N indicates unsupported.

      Container Format/Audio Sample Rate 11025 22050 32000 44100 48000 96000
      mp3 Y Y Y Y Y N

      Container has the following sub-nodes:

      Node Name (Keyword) Parent Node Description Type Required
      Format Request.ConcatTemplate.
      Container      		 Container format: mp4, flv, hls, ts, mp3, aac String Yes

      Video has the following sub-nodes:

      Node Name (Keyword) Parent Node Description Type Required Default Value Constraints
      Codec Request.ConcatTemplate.
      Video      		 Codec format String No H.264 H.264
      Width Request.ConcatTemplate.
      Video      		 Width String No Original video width
    • Value range: [128, 4096]
    • Unit: px
    • If only Width is set, Height is calculated according to the original video proportion.
      		•
      Height Request.ConcatTemplate.
      Video      		 Height String No Original video height
    • Value range: [128, 4096]
    • Unit: px
    • If only Height is set, Width is calculated according to the original video proportion.
      		•
      Fps Request.ConcatTemplate.
      Video      		 Frame rate String No Original video frame rate
    • Value range: (0, 60]
    • Unit: fps
      		•
      Bitrate Request.ConcatTemplate.
      Video      		 Bitrate of the video output file String No Original video bitrate
    • Value range: [10, 50000]
    • Unit: Kbps
      • Remove Request.ConcatTemplate.
      Video      		 Whether to delete the video stream String No false Valid values: true, false

      Response

      Response headers

      Common response headers

      This response contains Common Response Headers.

      Non-common response headers

      This API does not use any non-common response header.

      Response body

      The response body returns application/xml data. The following contains all the nodes:

      <Response>
  <Template>
      <TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId>
      <Tag>Concat</Tag>
      <Name>TemplateName</Name>
      <ConcatTemplate>
          <ConcatFragment>
              <Mode>Start</Mode>
              <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/start.mp4</Url>
          </ConcatFragment>
          <ConcatFragment>
              <Mode>End</Mode>
              <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/end.mp4</Url>
          </ConcatFragment>
          <Audio>
              <Codec>mp3</Codec>
              <Samplerate></Samplerate>
              <Bitrate></Bitrate>
              <Channels></Channels>
          </Audio>
          <Video>
              <Codec>H.264</Codec>
              <Bitrate>1000</Bitrate>
              <Width>1280</Width>
              <Height></Height>
              <Fps>30</Fps>
          </Video>
          <Container>
              <Format>mp4</Format>
          </Container>
      </ConcatTemplate>
      <CreateTime>2020-08-05T11:35:24+0800</CreateTime>
      <UpdateTime>2020-08-31T16:15:20+0800</UpdateTime>
  </Template>
</Response>

      The nodes are described as follows:

      Node Name (Keyword) Parent Node Description Type
      Response None Response container

      Response has the following sub-nodes:

      Node Name (Keyword) Parent Node Description Type
      TemplateId Response Template ID String
      TotalCount Response Total number of templates Int
      PageNumber Response Current page number. Same as pageNumber in the request. Int
      PageSize Response Number of records per page. Same as pageSize in the request. Int
      ConcatTemplate Response Concatenation information. Same as ConcatTemplate in the request body. Container

      Error codes

      No special error message will be returned for this request. For the common error messages, please see Error Codes.

      Examples

      Request

      PUT /template/<TemplateId> HTTP/1.1
Authorization:q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR98****-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****
Host:bucket-1250000000.ci.ap-beijing.myqcloud.com
Content-Length: 1666
Content-Type: application/xml

<Request>
 <Tag>Concat</Tag>
 <Name>TemplateName</Name>
 <ConcatTemplate>
      <ConcatFragment>
          <Mode>Start</Mode>
          <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/start.mp4</Url>
      </ConcatFragment>
      <ConcatFragment>
          <Mode>End</Mode>
          <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/end.mp4</Url>
      </ConcatFragment>
      <Audio>
          <Codec>mp3</Codec>
          <Samplerate></Samplerate>
          <Bitrate></Bitrate>
          <Channels></Channels>
      </Audio>
      <Video>
          <Codec>H.264</Codec>
          <Bitrate>1000</Bitrate>
          <Width>1280</Width>
          <Height></Height>
          <Fps>30</Fps>
      </Video>
      <Container>
          <Format>mp4</Format>
      </Container>
 </ConcatTemplate>
</Request>

      Response

      HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 100
Connection: keep-alive
Date: Thu, 15 Jun 2017 12:37:29 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzh****=

<Response>
  <Template>
      <TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId>
      <Tag>Concat</Tag>
      <Name>TemplateName</Name>
      <ConcatTemplate>
          <ConcatFragment>
              <Mode>Start</Mode>
              <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/start.mp4</Url>
          </ConcatFragment>
          <ConcatFragment>
              <Mode>End</Mode>
              <Url>http://bucket-1250000000.cos.ap-beijing.myqcloud.com/end.mp4</Url>
          </ConcatFragment>
          <Audio>
              <Codec>mp3</Codec>
              <Samplerate></Samplerate>
              <Bitrate></Bitrate>
              <Channels></Channels>
          </Audio>
          <Video>
              <Codec>H.264</Codec>
              <Bitrate>1000</Bitrate>
              <Width>1280</Width>
              <Height></Height>
              <Fps>30</Fps>
          </Video>
          <Container>
              <Format>mp4</Format>
          </Container>
      </ConcatTemplate>
      <CreateTime>2020-08-05T11:35:24+0800</CreateTime>
      <UpdateTime>2020-08-31T16:15:20+0800</UpdateTime>
  </Template>
</Response>
      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
      tencent
      Copyright © 2013-2022 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy