Detener el lanzamiento de un vuelo

  • Artículo

Usa este método en la API de envío de Microsoft Store para detener el lanzamiento de un envío de paquete piloto. Para obtener más información sobre el proceso de creación de un envío de paquete piloto mediante la API de envío de Microsoft Store, consulta Administrar envíos de paquetes piloto.

Nota

Si detienes el lanzamiento de un envío de paquete piloto y, a continuación, creas un nuevo envío de paquete piloto, el nuevo envío es un clon del envío detenido.

Requisitos previos

Para usar este método, primero debes hacer lo siguiente:

Solicitud

Este método tiene la siguiente sintaxis. Consulta las siguientes secciones para ver ejemplos de uso y descripciones del encabezado y de los parámetros de la solicitud.

Método URI de solicitud
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/haltpackagerollout

Encabezado de solicitud

Encabezado Tipo Descripción
Authorization string Necesario. Token de acceso de Azure AD con el formato Token de portador<>.

Parámetros de solicitud

Nombre Tipo Descripción
applicationId string Necesario. El identificador de la Tienda de la aplicación que contiene el envío del paquete piloto con el lanzamiento de paquete que quieres detener. Para obtener más información sobre el identificador de la Tienda, consulta Ver detalles de identidad de las aplicaciones.
flightId string Necesario. El identificador del paquete piloto que contiene el envío con el lanzamiento de paquete que quieres detener. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un paquete piloto y obtener paquetes piloto para una aplicación. Para un vuelo creado en el Centro de partners, este identificador también está disponible en la dirección URL de la página piloto del Centro de partners.
submissionId string Necesario. El identificador del envío con el lanzamiento de paquete que quieres detener. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un envío de paquete piloto. Para un envío creado en el Centro de partners, este identificador también está disponible en la dirección URL de la página de envío del Centro de partners.

Cuerpo de la solicitud

No incluyas un cuerpo de la solicitud para este método.

Ejemplo de solicitud

En el siguiente ejemplo se muestra cómo detener el lanzamiento de un paquete en el caso del envío de un paquete piloto.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243680/haltpackagerollout HTTP/1.1
Authorization: Bearer <your access token>

Response

En el siguiente ejemplo se muestra el cuerpo de la respuesta JSON de una llamada satisfactoria a este método. Para obtener más información sobre los valores que se encuentran en el cuerpo de respuesta, consulta el recurso Package rollout object (Objeto de lanzamiento de paquete).

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 0.0,
    "packageRolloutStatus": "PackageRolloutStopped",
    "fallbackSubmissionId": "1212922684621243058"
}

Códigos de error

Si la solicitud no se puede completar correctamente, la respuesta contendrá uno de los siguientes códigos de error HTTP.

Código de error Descripción
404 No se pudo encontrar el envío de paquete piloto.
409 Este código indica uno de los siguientes errores: