Interrompe uma tarefa de gravação em nuvem do RTC.
Descrição da operação
A tarefa a ser interrompida deve estar no estado Running ou Abnormal.
Para tarefas que estão no estado Stopping ou Stopped, esta operação retorna diretamente uma resposta de sucesso.
Para tarefas que foram iniciadas recentemente e ainda não estão no estado Running, um erro InvalidParameter.TaskId é retornado. Se você receber este erro, aguarde alguns segundos e tente novamente.
Se NotFound.Task for retornado e você confirmou que o TaskId especificado existe, a tarefa foi iniciada recentemente e ainda não está em execução. Aguarde alguns segundos e tente novamente.
Limite de QPS
O limite de QPS por usuário para esta operação é de 50 chamadas por segundo. Se o limite for excedido, as chamadas de API serão limitadas, o que pode afetar seus negócios. Utilize esta operação adequadamente.
Experimente agora
Testar
Autorização RAM
|
Ação |
Nível de acesso |
Tipo de recurso |
Chave de condição |
Ação dependente |
|
live:StopRtcCloudRecording |
delete |
*Todos os recursos.
|
Nenhuma | Nenhuma |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| TaskId |
string |
Sim |
O ID da tarefa retornado quando a tarefa de gravação em nuvem do RTC foi iniciada. |
******73-8501-****-8ac1-72295a****** |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
O corpo da resposta. |
||
| RequestId |
string |
O ID da solicitação. |
******58-5876-****-83CA-B56278****** |
| TaskId |
string |
O ID da tarefa. |
******73-8501-****-8ac1-72295a****** |
Exemplos
Resposta de sucesso
JSON formato
{
"RequestId": "******58-5876-****-83CA-B56278******",
"TaskId": "******73-8501-****-8ac1-72295a******"
}
Códigos de erro
|
Código de status HTTP |
Código de erro |
Mensagem de erro |
Descrição |
|---|---|---|---|
| 400 | NotFound.Task | %s, please check the TaskId. | O parâmetro TaskId não existe. |
| 400 | InvalidParameter.TaskId | %s, please check the TaskId. | A tarefa especificada deve estar no estado Running ou Recovering. |
| 400 | MissingParameter | %s. | Um parâmetro obrigatório está ausente. |
| 403 | InvalidParameter.UserId | %s, please check the UserId. | O UserId é inválido. Verifique o parâmetro. |
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.