Interruzione dell'implementazione per un pacchetto in anteprima

Usare questo metodo nell'API di invio di Microsoft Store per interrompere l'implementazione per un invio di un pacchetto in anteprima. Per ulteriori informazioni sul processo di creazione di un invio di pacchetto in anteprima tramite l'API di invio di Microsoft Store, vedere Gestire gli invii di pacchetti in anteprima.

Nota

Se si interrompe l'implementazione per un invio di pacchetto in anteprima e quindi si crea un nuovo invio del pacchetto in anteprima, il nuovo invio sarà un clone dell'invio interrotto.

Prerequisiti

Per usare questo metodo, è necessario prima eseguire le operazioni seguenti:

• Se non lo si ha ancora fatto, completare i prerequisiti per l'API di invio di Microsoft Store.
• Ottenere un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.
• Crea un invio per una delle tue app. Puoi farlo nel Centro per i partner oppure usando il metodo di creazione di un invio di un app.
• Abilitare un'implementazione graduale del pacchetto per l'invio. Puoi farlo nel Centro per i partner oppure puoi farlo usando l'API di invio a Microsoft Store.

Richiedi

Questo metodo ha la sintassi seguente. Vedere le sezioni seguenti per esempi di uso e descrizioni dell'intestazione e dei parametri della richiesta.

metodo	URI della richiesta
POST	https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/haltpackagerollout

Intestazione della richiesta

Intestazione	Type	Descrizione
Autorizzazione	stringa	Obbligatorio. Token di accesso di Azure AD nel formato Token di<connessione>.

Parametri della richiesta

Nome	Tipo	Descrizione
applicationId	string	Obbligatorio. ID dello Store dell'app che contiene l'invio di un pacchetto in anteprima con l'implementazione del pacchetto che si desidera interrompere. Per ulteriori informazioni sull'ID dello Store, vedere Visualizzare i dettagli dell'identità dell'app.
flightId	string	Obbligatorio. ID del pacchetto in anteprima che contiene l'invio con l'implementazione del pacchetto che si desidera interrompere. Questo ID è disponibile nei dati di risposta per le richieste di creazione di un pacchetto in anteprima e recupero dei pacchetti in anteprima per un'app. Per una distribuzione in anteprima creata nel Centro per i partner, questo ID è disponibile anche nell'URL per la pagina distribuzione in anteprima nel Centro per i partner.
submissionId	string	Obbligatorio. ID dell'invio con l'implementazione del pacchetto da interrompere. Questo ID è disponibile nei dati di risposta per le richieste di creazione di un invio di pacchetto in anteprima. Per un invio creato nel Centro per i partner, questo ID è disponibile anche nell'URL per la pagina di invio nel Centro per i partner.

Corpo della richiesta

Non fornire un corpo della richiesta per questo metodo.

Esempio di richiesta

L'esempio seguente illustra come interrompere l'implementazione del pacchetto per un invio di un pacchetto in anteprima.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243680/haltpackagerollout HTTP/1.1
Authorization: Bearer <your access token>

Response

Nell'esempio seguente viene illustrato il corpo della risposta JSON per una chiamata riuscita a questo metodo. Per altri dettagli sui valori nel corpo della risposta, vedere Risorsa implementazione pacchetto.

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 0.0,
    "packageRolloutStatus": "PackageRolloutStopped",
    "fallbackSubmissionId": "1212922684621243058"
}

Codici di errore

Se la richiesta non può essere completata, la risposta conterrà uno dei codici di errore HTTP seguenti.

Codice errore	Descrizione
404	L'invio del pacchetto in anteprima non è stato trovato.
409	Questo codice indica uno dei seguenti errori: L'invio non è in uno stato valido per l'operazione di implementazione graduale (prima di chiamare questo metodo, l'invio deve essere pubblicato e il valore packageRolloutStatus deve essere impostato su PackageRolloutInProgress). L'invio non appartiene all'app specificata. L'app usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio a Microsoft Store.

Argomenti correlati

• Implementazione graduale del pacchetto
• Gestire gli invii di pacchetti in anteprima usando l'API per l'invio in Microsoft Store
• Creare e gestire gli invii usando i servizi di Microsoft Store