Finalizar el lanzamiento de un envío pilotoFinalize the rollout for a flight submission

Use este método en la API de envío de Microsoft Store para finalizar el lanzamiento de paquetes para un envío de paquetes piloto.Use this method in the Microsoft Store submission API to finalize the package rollout for a package flight submission. Para obtener más información sobre el proceso de creación de un envío de paquetes piloto mediante el Microsoft Store API de envío, vea Administrar envíos de paquetes de paquetes.For more information about the process of process of creating a package flight submission by using the Microsoft Store submission API, see Manage package flight submissions.

Requisitos previosPrerequisites

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

  • Si todavía no lo ha hecho, complete todos los requisitos previos de la API de envío de Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • Obtén un token de acceso de Azure AD para usarlo en el encabezado de la solicitud de este método.Obtain an Azure AD access token to use in the request header for this method. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire.After you obtain an access token, you have 60 minutes to use it before it expires. Si el token expira, puedes obtener uno nuevo.After the token expires, you can obtain a new one.
  • Cree un envío para una aplicación en el centro de Partners.Create a submission for an app in Partner Center. Puede hacerlo en el centro de Partners o puede hacerlo mediante el método crear un envío de aplicación .You can do this in Partner Center, or you can do this by using the create an app submission method.
  • Habilita un lanzamiento de paquete gradual para el envío.Enable a gradual package rollout for the submission. Puede hacerlo en el centro de Partnerso puede hacerlo mediante el Microsoft Store API de envío.You can do this in Partner Center, or you can do this by using the Microsoft Store submission API.

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}/flights/{flightId}/submissions/{submissionId}/finalizepackagerollout

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 Id. de la Tienda de la aplicación que contiene el envío del paquete piloto con el lanzamiento de paquetes que quieres finalizar.The Store ID of the app that contains the package flight submission with the package rollout you want to finalize. 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.
flightIdflightId stringstring Necesario.Required. El identificador del paquete piloto que contiene el envío con el lanzamiento de paquetes que quieres finalizar.The ID of the package flight that contains the submission with the package rollout you want to finalize. Este identificador está disponible en los datos de respuesta para las solicitudes para crear un paquete piloto y obtener paquetes piloto para una aplicación.This ID is available in the response data for requests to create a package flight and get package flights for an app. En el caso de un vuelo creado en el centro de Partners, este identificador también está disponible en la dirección URL de la página de vuelo del centro de Partners.For a flight that was created in Partner Center , this ID is also available in the URL for the flight page in Partner Center.
submissionIdsubmissionId stringstring Necesario.Required. El identificador del envío con el lanzamiento de paquetes que quieres finalizar.The ID of the submission with the package rollout you want to finalize. Este identificador está disponible en los datos de respuesta para las solicitudes para crear un envío de paquetes piloto.This ID is available in the response data for requests to create a package flight 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 finalizar el lanzamiento de paquete para el envío del paquete piloto.The following example demonstrates how to finalize the package rollout for a package flight submission.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243680/finalizepackagerollout 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": 100.0,
    "packageRolloutStatus": "PackageRolloutComplete",
    "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 de paquete piloto.The package flight submission could not be found.
409409 Este código indica uno de los siguientes errores:This code indicates one of the following errors: