Interrompre le lancement d’une soumission d’application
Utilisez cette méthode dans l’API de soumission du Microsoft Store pour arrêter le déploiement du package pour une soumission d’application. Pour plus d’informations sur le processus de création d’une soumission d’application à l’aide de l’API de soumission au Microsoft Store, consultez Gérer les soumissions d’applications.
Remarque
Si vous arrêtez le déploiement d’une soumission d’application, puis créez une soumission d’application, la nouvelle soumission est un clone de la soumission arrêtée.
Prérequis
Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :
- Si vous ne l’avez pas déjà fait, remplissez toutes les conditions préalables pour l’API de soumission au Microsoft Store.
- Obtenir un jeton d’accès Azure AD à utiliser dans l’en-tête de requête pour cette méthode. Une fois que vous avez récupéré le jeton d’accès, vous avez 60 minutes pour l’utiliser avant qu’il n’expire. Une fois le jeton expiré, vous pouvez en obtenir un nouveau.
- Créez une soumission pour l’une de vos applications. Vous pouvez le faire dans l’Espace partenaires, ou vous pouvez le faire à l’aide de la méthode de création d’une soumission d’application.
- Activez le déploiement progressif d’un package pour la soumission. Vous pouvez le faire dans l’Espace partenaires, ou vous pouvez le faire à l’aide de l’API de soumission du Microsoft Store.
Requête
Cette méthode a la syntaxe suivante. Consultez les sections suivantes pour obtenir des exemples d’utilisation et des descriptions des paramètres d’en-tête et de requête.
| Méthode | URI de demande |
|---|---|
| POST | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/haltpackagerollout |
En-tête de requête
| En-tête | Type | Description |
|---|---|---|
| Autorisation | string | Obligatoire. Jeton d’accès Azure AD au format porteur<jeton>. |
Paramètres de la demande
| Nom | Type | Description |
|---|---|---|
| applicationId | string | Obligatoire. ID Store de l’application qui contient la soumission avec le déploiement du package que vous souhaitez arrêter. Pour plus d’informations sur l’ID store, consultez Afficher les détails de l’identité de l’application. |
| submissionId | string | Obligatoire. ID de la soumission avec le déploiement du package que vous souhaitez arrêter. Cet ID est disponible dans les données de réponse pour les demandes de création d’une soumission d’application. Pour une soumission créée dans l’Espace partenaires, cet ID est également disponible dans l’URL de la page de soumission dans l’Espace partenaires. |
Corps de la demande
Ne fournissez pas de corps de requête pour cette méthode.
Exemple de requête
L’exemple suivant montre comment arrêter le déploiement du package pour une soumission d’application.
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243680/haltpackagerollout HTTP/1.1
Authorization: Bearer <your access token>
Response
L’exemple suivant illustre le corps de la réponse JSON pour un appel réussi à cette méthode. Pour plus d’informations sur les valeurs dans le corps de la réponse, consultez la ressource de déploiement de package.
{
"isPackageRollout": true,
"packageRolloutPercentage": 0.0,
"packageRolloutStatus": "PackageRolloutStopped",
"fallbackSubmissionId": "1212922684621243058"
}
Codes d’erreur
Si la requête ne peut pas être terminée, la réponse contient l’un des codes d’erreur HTTP suivants.
| Code d'erreur | Description |
|---|---|
| 404 | Impossible de trouver la soumission. |
| 409 | Ce code indique l’une des erreurs suivantes :
|