removeConfig
This command will both stop the stream and remove the corresponding configuration entry. This command is the same as performing shutdownStream permanently=1
.
This function has the following parameters:
Parameter Name | Mandatory | Default Value | Description |
---|---|---|---|
id | true | null | The configId of the configuration that needs to be removed. ConfigId’s can be obtained from the listConfig interface. Removing an inbound stream will also automatically remove all associated outbound streams. |
groupName | true | null | The name of the group that needs to be removed (applicable to HLS, HDS and external processes). *Mandatory only if the id parameter is not specified. |
removeHlsHdsFiles | false | 0 false | If 1 (true) and the stream is HLS or HDS, the folder associated with it will be removed |
Example:
API Call:
removeConfig id=555
JSON Response:
{
"data":{
*..remove details for clarity*
},
"description":"Configuration terminated",
"status":"SUCCESS"
}
The JSON response contains the following details about the pull/push configuration:
- data – The data to parse.
- configId – The identifier for the pullPushConfig.xml entry
- Other fields present are dependent on stream type
- description – Describes the result of parsing/executing the command
- status –
SUCCESS
if the command was parsed and executed successfully,FAIL
if not
Note:
The config ID shown by the listConfig command is not the same as the stream ID shown by the listStreams command. The removeConfig command uses the config ID, not the stream ID.