Actualización de un envío de paquete piloto
Usa este método en la API de envío de Microsoft Store para actualizar un envío de paquete piloto existente. Después de actualizar correctamente un envío mediante este método, debes confirmar el envío para su ingesta y publicación.
Para obtener más información sobre cómo encaja este método en 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 de paquete piloto 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 paquete piloto .
Solicitud
Este método tiene la siguiente sintaxis. Consulta las siguientes secciones para ver ejemplos de uso y descripciones tanto del encabezado como del cuerpo de la solicitud.
Método | URI de la solicitud |
---|---|
PUT | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId} |
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. Id. de la Tienda de la aplicación para la cual quieres actualizar un envío de paquete piloto. Para obtener más información sobre el identificador de la Tienda, consulta Ver detalles de identidad de las aplicaciones. |
flightId | string | Necesario. Id. del paquete piloto para el cual quieres actualizar un envío. 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. Identificador del envío que se debe 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. |
Cuerpo de la solicitud
El cuerpo de la solicitud tiene los siguientes parámetros.
Valor | Tipo | Descripción |
---|---|---|
flightPackages | array | Contiene los objetos que proporcionan detalles acerca de cada paquete del envío. Para obtener más información acerca de los valores que se encuentran en el cuerpo de respuesta, consulta Flight package resource (Recurso del paquete piloto). Al llamar a este método para actualizar un envío de aplicación, solo los valores fileName, fileStatus, minimumDirectXVersion y minimumSystemRam de esos objetos son necesarios en el cuerpo de la solicitud. Los demás valores se rellenan mediante el Centro de partners. |
packageDeliveryOptions | object | Contiene el lanzamiento de paquete gradual y la configuración de actualización obligatoria del envío. Para obtener más información, consulta Package delivery options object (Objeto de opciones de entrega de paquete). |
targetPublishMode | string | Modo de publicación del envío. Puede ser uno de los siguientes valores:
|
targetPublishDate | cadena | Fecha de publicación del envío en formato ISO 8601, si el valor targetPublishMode se establece en SpecificDate. |
notesForCertification | cadena | Proporciona información adicional de los evaluadores de certificación como, por ejemplo, las credenciales de la cuenta de prueba y los pasos para obtener acceso y comprobar las características. Para obtener más información, consulta Notas para la certificación. |
Ejemplo de solicitud
En el siguiente ejemplo se muestra cómo actualizar el envío de paquete piloto de una aplicación.
PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
"flightPackages": [
{
"fileName": "newPackage.appx",
"fileStatus": "PendingUpload",
"minimumDirectXVersion": "None",
"minimumSystemRam": "None"
}
],
"packageDeliveryOptions": {
"packageRollout": {
"isPackageRollout": false,
"packageRolloutPercentage": 0.0,
"packageRolloutStatus": "PackageRolloutNotStarted",
"fallbackSubmissionId": "0"
},
"isMandatoryUpdate": false,
"mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
},
"targetPublishMode": "Immediate",
"targetPublishDate": "",
"notesForCertification": "No special steps are required for certification of this app."
}
Response
En el siguiente ejemplo se muestra el cuerpo de la respuesta JSON de una llamada satisfactoria a este método. El cuerpo de la respuesta contiene información sobre el envío actualizado. Para obtener más información acerca de los valores que se encuentran en el cuerpo de la respuesta, consulta Package flight submission resource (Recurso de envío del paquete piloto).
{
"id": "1152921504621243649",
"flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
"status": "PendingCommit",
"statusDetails": {
"errors": [],
"warnings": [],
"certificationReports": []
},
"flightPackages": [
{
"fileName": "newPackage.appx",
"fileStatus": "PendingUpload",
"id": "",
"version": "1.0.0.0",
"languages": ["en-us"],
"capabilities": [],
"minimumDirectXVersion": "None",
"minimumSystemRam": "None"
}
],
"packageDeliveryOptions": {
"packageRollout": {
"isPackageRollout": false,
"packageRolloutPercentage": 0.0,
"packageRolloutStatus": "PackageRolloutNotStarted",
"fallbackSubmissionId": "0"
},
"isMandatoryUpdate": false,
"mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
},
"fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
"targetPublishMode": "Immediate",
"targetPublishDate": "",
"notesForCertification": "No special steps are required for certification of this app."
}
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 |
---|---|
400 | No se pudo actualizar el envío del paquete piloto porque la solicitud no es válida. |
409 | No se pudo actualizar el envío del paquete piloto debido al estado actual de la aplicación o la aplicación usa una característica del Centro de partners que actualmente no es compatible con la API de envío de Microsoft Store. |
Temas relacionados
- Creación y administración de envíos mediante el uso de servicios de Microsoft Store
- Manage package flight submissions (Administrar envíos de paquetes piloto)
- Get a package flight submission (Obtener un envío de paquete piloto)
- Crear un envío de paquete piloto
- Commit a package flight submission (Confirmar un envío de paquete piloto)
- Eliminar un envío de paquete piloto
- Get the status of a package flight submission (Obtener el estado de un envío de paquete piloto)
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