Detener el lanzamiento del envío de una aplicaciónHalt the rollout for an app submission

Use este método en la API de envío de Microsoft Store para detener el lanzamiento de paquetes para un envío de aplicación.Use this method in the Microsoft Store submission API to halt the package rollout for an app submission. Para obtener más información sobre el proceso de creación de un envío de aplicación mediante el Microsoft Store API de envío, consulte Administración de envíos de aplicaciones.For more information about the process of process of creating an app submission by using the Microsoft Store submission API, see Manage app submissions.

Nota

Si detiene el lanzamiento de un envío de aplicación y, a continuación, crea un nuevo envío de aplicación, el nuevo envío es un clon del envío detenido.If you halt the rollout for an app submission and then create a new app submission, the new submission is a clone of the halted submission.

Requisitos previosPrerequisites

Para usar este método, primero debes hacer lo siguiente:To use this method, you need to first do the following:

SolicitudRequest

Este método tiene la siguiente sintaxis.This method has the following syntax. Consulta las siguientes secciones para ver ejemplos de uso y descripciones del encabezado y de los parámetros de la solicitud.See the following sections for usage examples and descriptions of the header and request parameters.

MétodoMethod URI de solicitudRequest URI
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/haltpackagerollout

Encabezado de solicitudRequest header

EncabezadoHeader TipoType DescripciónDescription
AuthorizationAuthorization stringstring Necesario.Required. El token de acceso de Azure AD del formulario Bearer <token>.The Azure AD access token in the form Bearer <token>.

Parámetros de solicitudRequest parameters

NombreName TipoType DescripciónDescription
applicationIdapplicationId stringstring Necesario.Required. El identificador de la Tienda de la aplicación que contiene el envío con el lanzamiento de paquete que quieres detener.The Store ID of the app that contains the submission with the package rollout you want to halt. Para obtener más información sobre el identificador de la Tienda, consulta Ver detalles de identidad de las aplicaciones.For more information about the Store ID, see View app identity details.
submissionIdsubmissionId stringstring Necesario.Required. El identificador del envío con el lanzamiento de paquete que quieres detener.The ID of the submission with the package rollout you want to halt. Este identificador está disponible en los datos de respuesta para las solicitudes para crear un envío de aplicación.This ID is available in the response data for requests to create an app submission. En el caso de 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.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

Cuerpo de la solicitudRequest body

No incluyas un cuerpo de la solicitud para este método.Do not provide a request body for this method.

Ejemplo de solicitudRequest example

En el siguiente ejemplo se muestra cómo detener el lanzamiento de paquete en el envío de una aplicación.The following example demonstrates how to halt the package rollout for an app submission.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243680/haltpackagerollout HTTP/1.1
Authorization: Bearer <your access token>

ResponseResponse

En el siguiente ejemplo se muestra el cuerpo de la respuesta JSON de una llamada satisfactoria a este método.The following example demonstrates the JSON response body for a successful call to this method. 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).For more details about the values in the response body, see Package rollout resource.

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

Códigos de errorError codes

Si la solicitud no se puede completar correctamente, la respuesta contendrá uno de los siguientes códigos de error HTTP.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

Código de errorError code DescripciónDescription
404404 No se pudo encontrar el envío.The submission could not be found.
409409 Este código indica uno de los siguientes errores:This code indicates one of the following errors: