Cancelar operación

  • Artículo

Nota:

Las API de Cloud Partner Portal se integran en el Centro de partners y seguirán funcionando en este. La transición presenta pequeños cambios. Revise los cambios que se muestran en Referencia de API de Cloud Partner Portal para asegurarse de que el código sigue funcionando después de la transición al Centro de partners. Las API de CPP solo deben usarse para los productos existentes que ya estaban integrados antes de la transición al Centro de partners. Los nuevos productos deben usar las API de envío del Centro de partners.

Esta API cancela una operación en curso en la oferta. Use Retrieve operations API para obtener operationId para pasar a esta API. La cancelación suele ser una operación sincrónica, pero en algunos escenarios complejos es posible que se requiera una nueva operación para cancelar una existente. En este caso, el cuerpo de la respuesta HTTP contiene la ubicación de la operación que se debe usar para consultar el estado.

POST https://cloudpartner.azure.com/api/publishers/<publisherId>/offers/<offerId>/cancel?api-version=2017-10-31

Parámetros del identificador URI

Nombre Descripción Tipo de datos
publisherId Identificador del editor, por ejemplo, contoso Cadena
offerId Identificador de la oferta. Cadena
api-version Versión actual de la API Date
Nombre Valor
Tipo de contenido application/json
Authorization SU TOKEN de portador

Ejemplo de cuerpo

Solicitar

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

Propiedades del cuerpo de la solicitud

Nombre Descripción
notification-emails Lista de identificadores de correo electrónico delimitados por coma para recibir una notificación del progreso de la operación de publicación.

Respuesta

Ofertas migradas

Location: /api/publishers/contoso/offers/contoso-offer/operations/56615b67-2185-49fe-80d2-c4ddf77bb2e8?api-version=2017-10-31

Ofertas no migradas

Location: /api/operations/contoso$contoso-offer$2$preview?api-version=2017-10-31

Encabezado de respuesta

Nombre Valor
Location La ruta de acceso relativa para recuperar el estado de esta operación.

Códigos de estado de respuesta

Código Descripción
200 OK. La solicitud se procesó correctamente y la operación se canceló de manera sincrónica.
202 Accepted. La solicitud se procesó correctamente y la operación está en proceso de ser cancelada. La ubicación de la operación de cancelación se devuelve en el encabezado de la respuesta.
400 Bad/Malformed request. El cuerpo de la respuesta del error podría proporcionar más información.
403 Access Forbidden. El cliente no tiene acceso al espacio de nombres especificado en la solicitud.
404 Not found. La entidad especificada no existe.