Compartilhar via


Cancelar operação

Nota

As APIs do Portal do Cloud Partner são integradas e continuarão trabalhando no Partner Center. A transição apresenta pequenas alterações. Examine as alterações listadas no de Referência da API do Portal do Cloud Partner para garantir que seu código continue funcionando após a transição para o Partner Center. As APIs do CPP só devem ser usadas para produtos existentes que já estavam integrados antes da transição para o Partner Center; Novos produtos devem usar APIs de envio do Partner Center.

Essa API cancela uma operação em andamento na oferta. Use o de API de operações de recuperação de 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

Name descrição de tipo de dados
publisherId O identificador do publicador, por exemplo, contoso Corda
offerId Identificador de oferta Corda
api-version Versão atual da API Data
Name Value
Tipo de conteúdo application/json
Autorização Portador de SEU TOKEN

Exemplo de corpo


Pedir

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

Propriedades do corpo da solicitação

Name descrição
notification-emails Lista separada por vírgulas de IDs de email 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

Name Value
Localização O caminho relativo para recuperar o status dessa operação.

Códigos de status de resposta

de 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 Solicitação inválida/malformada. 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.