Actualizar el porcentaje de lanzamiento de un envío piloto
Usa este método en la API de envío de Microsoft Store para actualizar el porcentaje de 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.
Requisitos previos
Para usar este método, primero debes hacer lo siguiente:
- Si aún no lo ha hecho, complete todos los requisitos previos para la API de envío de Microsoft Store.
- Obtén un token de acceso de Azure AD para usarlo en el encabezado de la solicitud de este método. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Si el token expira, puedes obtener uno nuevo.
- Cree un envío para una de las aplicaciones. Puedes hacerlo en el Centro de partners, o puedes hacerlo mediante el método de creación de un envío de aplicación .
- Habilita un lanzamiento de paquete gradual para el envío. Puedes hacerlo en el Centro de partners o puedes hacerlo mediante la API de envío de Microsoft Store.
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}/updatepackagerolloutpercentage |
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 id. de la Tienda de la aplicación que contiene el envío del paquete piloto con el porcentaje de lanzamiento de paquete que quieres actualizar. Para obtener más información sobre el identificador de la Tienda, consulta Ver detalles de identidad de las aplicaciones. |
flightId | string | Necesario. El id. del paquete piloto que contiene el envío con el porcentaje de lanzamiento de paquete que quieres actualizar. 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 porcentaje de lanzamiento de paquete que quieres actualizar. 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 en el Centro de partners. |
percentage | FLOAT | Necesario. El porcentaje de usuarios que recibirán el paquete de lanzamiento gradual. |
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 actualizar el porcentaje de lanzamiento de paquete para un envío de paquete piloto.
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243680/updatepackagerolloutpercentage?percentage=25 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": 25.0,
"packageRolloutStatus": "PackageRolloutInProgress",
"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:
|
Temas relacionados
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de