Partilhar via


Cancelar operação

Nota

As APIs do Cloud Partner Portal estão integradas e continuarão a trabalhar no Partner Center. A transição introduz pequenas alterações. Analise as alterações listadas na Referência da API do Cloud Partner Portal para garantir que seu código continue funcionando após a transição para o Partner Center. As APIs de 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.

Esta API cancela uma operação atualmente em andamento na oferta. Use a API de operações Retrieve para obter umoperationId passe 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 operação 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 Tipo de dados
editorId Identificador do editor, por exemplo, contoso String
offerId Identificador da oferta String
api-version Versão atual da API Date
Nome Valor
Tipo de Conteúdo application/json
Autorização Portador SEU TOKEN

Exemplo de corpo


Pedir

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

Solicitar propriedades do corpo

Name Descrição
e-mails de notificação Lista separada por vírgulas de IDs de e-mail para ser notificado do progresso da operação de publicação.

Response

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
Location O caminho relativo para recuperar o status desta 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 Aceito. O pedido foi processado com sucesso e a operação está em processo de cancelamento. O local da operação de cancelamento é retornado no cabeçalho da resposta.
400 Pedido ruim/malformado. O corpo da resposta de erro poderia 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.