Cancelar operação
Observação
As APIs do Portal do Cloud Partner são integradas ao Partner Center e continuarão funcionando nele. A transição introduz pequenas alterações. Examine as alterações listadas na API do Portal do Cloud Partner para garantir que seu código continue funcionando após a transição para o Cloud Partner. As APIs do CPP somente devem ser usadas em produtos existentes que já foram integrados antes da transição para o Partner Center. Os novos produtos devem usar as APIs de envio do Partner Center.
Essa API cancela uma operação atualmente em andamento na oferta. Use Recuperar API de operações para obter um operationId para passar a essa API. O cancelamento é geralmente uma operação síncrona, no entanto, em alguns cenários complexos, uma nova operação pode ser necessária para cancelar uma existente. Nesse caso, o corpo da resposta HTTP contém o local da operação que deve ser usado para consultar o status.
POST https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>/cancel?api-version=2017-10-31
Parâmetros do URI
| Nome | Descrição | Data type |
|---|---|---|
| publisherId | Identificador do publicar, por exemplo, contoso |
String |
| offerId | Identificador da oferta | String |
| api-version | Versão atual da API | Data |
Cabeçalho
| Nome | Valor |
|---|---|
| Content-Type | application/json |
| Autorização | TOKEN de seu portador |
Exemplo de corpo
Solicitar
{
"metadata": {
"notification-emails": "jondoe@contoso.com"
}
}
Solicitar propriedades do corpo
| Nome | Descrição |
|---|---|
| emails de notificação | Lista separada por vírgula de IDs de email a serem notificados sobre o andamento da operação de publicação. |
Resposta
Ofertas migradas
Location: /api/publishers/contoso/offers/contoso-offer/operations/56615b67-2185-49fe-80d2-c4ddf77bb2e8?api-version=2017-10-31
Ofertas não migradas
Location: /api/operations/contoso$contoso-offer$2$preview?api-version=2017-10-31
Cabeçalho de Resposta
| Nome | Valor |
|---|---|
| Localidade | O caminho relativo para recuperar o status da operação. |
Códigos de status de resposta
| Código | Descrição |
|---|---|
| 200 | OK. A solicitação foi processada com êxito e a operação é cancelada de forma síncrona. |
| 202 | Aceita. A solicitação foi processada com êxito e a operação está em processo de cancelamento. A localização da operação de cancelamento é retornada no cabeçalho de resposta. |
| 400 | Solicitação incorreta/malformada. O corpo da resposta ao erro pode fornecer mais informações. |
| 403 | Acesso proibido. O cliente não tem acesso ao namespace especificado na solicitação. |
| 404 | Não encontrado. A entidade especificada não existe. |