Configures snapshot callbacks.
QPS limit
You can call this operation up to 30 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limits.
Debugging
Request parameters
Parameter |
Type |
Required |
Example |
Description |
Action | String | Yes | AddLiveSnapshotNotifyConfig | The operation that you want to perform. Set the value to AddLiveSnapshotNotifyConfig. |
DomainName | String | Yes | www.yourdomain***.com | The main streaming domain. |
NotifyUrl | String | Yes | http://callback.yourdomain***.com | The callback URL. Specify a valid URL that is up to 500 characters in length. |
NotifyReqAuth | String | No | yes | Specifies whether to enable callback authentication. Valid values:
Note This parameter is required if you set the NotifyAuthKey parameter to yes. |
NotifyAuthKey | String | No | yourkey | The callback authentication key. The key must be 16 to 32 characters in length and can contain only letters and digits. Note This parameter is required if you set the NotifyReqAuth parameter to yes. |
Response parameters
Parameter |
Type |
Example |
Description |
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F3EC5 | The request ID. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=AddLiveSnapshotNotifyConfig
&DomainName=www.yourdomain***.com
&NotifyUrl=http://callback.yourdomain***.com
&NotifyReqAuth=yes
&NotifyAuthKey=yourkey
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<AddLiveSnapshotNotifyConfigResponse>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F3EC5</RequestId>
</AddLiveSnapshotNotifyConfigResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "16A96B9A-F203-4EC5-8E43-CB92E68F3EC5"
}
Error codes
For a list of error codes, see Service error codes.