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.