All Products
Search
Document Center

Object Storage Service:0044-00000003

Last Updated:Mar 20, 2026

Problem description

A PutLiveChannel request fails when its XML body contains more than one <Snapshot> node.

Causes

The <Snapshot> node configures high-frequency snapshot options for a live channel. Each PutLiveChannel request accepts exactly one <Snapshot> node. Including a second node violates this constraint and causes the request to fail.

Examples

The following request fails because it contains two <Snapshot> nodes:

PUT /test-channel?live HTTP/1.1
Date: Wed, 24 Aug 2016 11:11:28 GMT
Content-Length: xxx
Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************
<?xml version="1.0" encoding="utf-8"?>
<LiveChannelConfiguration>
    <Description />
    <Status>enabled</Status>
    <Target>
        <Type>HLS</Type>
        <FragDuration>2</FragDuration>
        <FragCount>3</FragCount>
    </Target>
    <Snapshot>
        <RoleName>role_for_snapshot</RoleName>
        <DestBucket>snapshotdest</DestBucket>
        <NotifyTopic>snapshotnotify</NotifyTopic>
        <Interval>1</Interval>
    </Snapshot>
    <Snapshot>                              <!-- Remove this second Snapshot node -->
        <RoleName>role2_for_snapshot</RoleName>
        <DestBucket>snapshotdest2</DestBucket>
        <NotifyTopic>snapshotnotify</NotifyTopic>
        <Interval>1</Interval>
    </Snapshot>
</LiveChannelConfiguration>

Solutions

Remove all but one <Snapshot> node from the <LiveChannelConfiguration> body. The following example shows a valid request:

PUT /test-channel?live HTTP/1.1
Date: Wed, 24 Aug 2016 11:11:28 GMT
Content-Length: xxx
Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************
<?xml version="1.0" encoding="utf-8"?>
<LiveChannelConfiguration>
    <Description />
    <Status>enabled</Status>
    <Target>
        <Type>HLS</Type>
        <FragDuration>2</FragDuration>
        <FragCount>3</FragCount>
    </Target>
    <Snapshot>
        <RoleName>role_for_snapshot</RoleName>
        <DestBucket>snapshotdest</DestBucket>
        <NotifyTopic>snapshotnotify</NotifyTopic>
        <Interval>1</Interval>
    </Snapshot>
</LiveChannelConfiguration>

References