Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Namespace: microsoft.graph
Cancela o processamento de quaisquer operações de mídia em andamento.
As operações de mídia referem-se às operações de IVR playPrompt e recordResponse, que são, por padrão, enfileiradas para serem processadas na ordem. O método cancelMediaProcessing cancela qualquer operação que esteja em processo, bem como operações que estão na fila. Por exemplo, esse método pode ser usado para limpar a fila de operação IVR para uma nova operação de mídia. No entanto, ele não cancelará uma operação subscribeToTone porque opera independentemente de qualquer fila de operações.
Essa API está disponível nas seguintes implantações de nuvem nacional.
| Serviço global | Governo dos EUA L4 | US Government L5 (DOD) | China operada pela 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ❌ |
Permissões
Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
| Tipo de permissão | Permissões menos privilegiadas | Permissões com privilégios mais elevados |
|---|---|---|
| Delegado (conta corporativa ou de estudante) | Sem suporte. | Sem suporte. |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | Calls.Initiate.All | Calls.AccessMedia.All |
Observação: As permissões são verificadas quando a chamada é criada; nenhuma marca de permissão adicional é feita ao chamar essa API. Calls.AccessMedia.All só é necessário para chamadas que usam mídia hospedada pelo aplicativo.
Solicitação HTTP
POST /communications/calls/{id}/cancelMediaProcessing
Cabeçalhos de solicitação
| Nome | Descrição |
|---|---|
| Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
| Content-type | application/json. Obrigatório. |
Corpo da solicitação
Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| clientContext | Cadeia de caracteres | O contexto do cliente. |
Resposta
Se for bem-sucedido, esse método retornará um código de 200 OK resposta HTTP e um cabeçalho Location com um URI para a commsOperation criada para essa solicitação.
Exemplo
O exemplo a seguir mostra como chamar essa API.
Solicitação
O exemplo a seguir mostra a solicitação.
POST https://graph.microsoft.com/v1.0/communications/calls/{id}/cancelMediaProcessing
Content-Type: application/json
Content-Length: 62
{
"clientContext": "clientContext-value"
}
Resposta
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Location: https://graph.microsoft.com/v1.0/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896/operations/17e3b46c-f61d-4f4d-9635-c626ef18e6ad
Content-Type: application/json
Content-Length: 259
{
"@odata.type": "#microsoft.graph.cancelMediaProcessingOperation",
"status": "completed",
"clientContext": "d45324c1-fcb5-430a-902c-f20af696537c",
"id": "0fe0623f-d628-42ed-b4bd-8ac290072cc5"
}
Notificação - Operação cancelada para recordResponse
POST https://bot.contoso.com/api/calls
Content-Type: application/json
{
"@odata.type": "#microsoft.graph.commsNotifications",
"value": [
{
"@odata.type": "#microsoft.graph.commsNotification",
"changeType": "deleted",
"resourceUrl": "/communications/calls/57DAB8B1894C409AB240BD8BEAE78896/operations/0FE0623FD62842EDB4BD8AC290072CC5",
"resourceData": {
"@odata.type": "#microsoft.graph.recordOperation",
"@odata.id": "/communications/calls/57DAB8B1894C409AB240BD8BEAE78896/operations/0FE0623FD62842EDB4BD8AC290072CC5",
"@odata.etag": "W/\"54451\"",
"id": "0fe0623f-d628-42ed-b4bd-8ac290072cc5",
"clientContext": "d45324c1-fcb5-430a-902c-f20af696537c",
"status": "failed",
"resultInfo": {
"@odata.type": "#microsoft.graph.resultInfo",
"code": 400,
"subcode": 8508,
"message": "Action failed, the operation was cancelled."
},
"recordingLocation": "",
"recordingAccessToken": "",
"completionReason": "operationCanceled"
}
}
]
}