Compartilhar via


Cancelar operação

Observação

As APIs do Cloud Partner Portal estão integradas e continuarão funcionando no Partner Center. A transição apresenta pequenas alterações. Revise as alterações listadas na Referência da API do Portal de Parceiros em Nuvem para garantir que seu código continue funcionando após a transição para o Centro de Parceiros. As APIs de CPP devem ser usadas apenas para produtos existentes que já estavam integrados antes da transição para o Partner Center; novos produtos devem usar as APIs de submissão do Partner Center.

Essa API cancela uma operação atualmente em andamento na oferta. Use a API de operações de recuperação para obter umoperationId para passar para 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 de URI

Nome Descrição Tipo de dados
publisherId Identificador do editor, por exemplo, contoso fio
offerId Identificador de oferta fio
versão da API Versão atual da API Data (calendário)
Nome Valor
Tipo de conteúdo aplicativo/json
Autorização Portador SEU TOKEN

Exemplo de corpo


Solicitação

{
   "metadata": {
     "notification-emails": "jondoe@contoso.com"
    }
}     

Propriedades do corpo da solicitação

Nome Descrição
e-mails de notificação Lista separada por vírgulas de IDs de e-mail a serem notificadas 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
Localização O caminho relativo para recuperar o status dessa operação.

Códigos de status de resposta

Código Descrição
200 Okey. A solicitação foi processada com êxito e a operação é cancelada de forma síncrona.
202 Aceitado. A solicitação foi processada com êxito e a operação está em processo de cancelamento. O local da operação de cancelamento é retornado no cabeçalho de resposta.
400 Pedido ruim/malformado. O corpo da resposta de 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.