Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Usa este método en la API de envío de Microsoft Store para detener el lanzamiento del paquete para un envío de aplicación. Para obtener más información sobre el proceso de creación de un envío de aplicación mediante la API de envío de Microsoft Store, consulta Administrar envíos de aplicaciones.
Nota:
Si detienes el despliegue de un envío de aplicación y luego creas un nuevo envío de aplicación, el nuevo envío es un clon del envío detenido.
Prerrequisitos
Para usar este método, primero debe hacer lo siguiente:
- Si aún no lo ha hecho, complete todos los requisitos previos para la API de envío de Microsoft Store.
- Obtenga un token de acceso de Azure AD para usarlo en el encabezado de solicitud para este método. Después de obtener un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.
- Cree una solicitud para una de tus aplicaciones. Puedes hacerlo en el Centro de socios o mediante el método crear un envío de aplicación.
- Habilitar el despliegue gradual de paquetes 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 sintaxis siguiente. Consulte las secciones siguientes para ver ejemplos de uso y descripciones de los parámetros de encabezado y solicitud.
| Método | Solicitud de URI |
|---|---|
| PUBLICACIÓN | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/haltpackagerollout |
Cabecera de solicitud
| Cabecera | Tipo | Descripción |
|---|---|---|
| Autorización | cuerda / cadena | Obligatorio. El token de acceso de Azure AD en la forma Bearer<token>. |
Parámetros de solicitud
| Nombre | Tipo | Descripción |
|---|---|---|
| applicationId | cuerda / cadena | Obligatorio. El ID de la Tienda de la aplicación que contiene la publicación con la implementación del paquete que desea detener. Para obtener más información sobre el identificador de la Tienda, consulta Ver los detalles de la identidad de la aplicación. |
| Id de envío | cuerda / cadena | Obligatorio. Identificador del envío con el lanzamiento del paquete que desea detener. Este identificador está disponible en los datos de respuesta de las solicitudes para crear un envío de aplicación. Para una presentación que se creó en el Centro de socios, este identificador también está disponible en la URL de la página de la presentación en el Centro de socios. |
Cuerpo de la solicitud
No incluya un contenido de la solicitud para este método.
Ejemplo de solicitud
En el ejemplo siguiente se muestra cómo detener el lanzamiento del paquete para un envío de aplicación.
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243680/haltpackagerollout HTTP/1.1
Authorization: Bearer <your access token>
Respuesta
En el ejemplo siguiente se muestra el cuerpo de la respuesta JSON para una llamada correcta a este método. Para obtener más información sobre los valores del cuerpo de la respuesta, consulte el recurso de implementación 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 encontró la solicitud. |
| 409 | Este código indica uno de los siguientes errores:
|