Aggiornare la percentuale di rollout per una sottomissione di volo

Usa questo metodo nell'API di invio a Microsoft Store per aggiornare la percentuale di implementazione per un invio di pacchetto in anteprima. Per altre informazioni sul processo di creazione di un invio di pacchetto in anteprima tramite l'API di invio a Microsoft Store, vedi Gestire gli invii di pacchetti in anteprima.

Prerequisiti

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

• Se non l'hai già fatto, completa tutti i prerequisiti per l'API di invio al 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, si hanno 60 minuti per usarlo 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 puoi farlo usando il metodo di creazione di un invio di app .
• Abilitare una distribuzione graduale del pacchetto per l'invio. Puoi farlo nel Centro per i partner oppure puoi farlo usando l'API di invio a Microsoft Store.

Richiesta

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

Metodo	URI della richiesta
INSERISCI	https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/updatepackagerolloutpercentage

Header di richiesta

Intestazione	TIPO	Descrizione
Autorizzazione	corda	Obbligatorio. Token di accesso di Azure AD nel formato Bearer<token>.

Parametri della richiesta

Nome	TIPO	Descrizione
ID dell'applicazione	corda	Obbligatorio. ID dello Store dell'app che contiene l'invio del pacchetto in anteprima con la percentuale di implementazione del pacchetto che vuoi aggiornare. Per altre informazioni sull'ID dello Store, vedere Visualizzare i dettagli dell'identità dell'app.
flightId	corda	Obbligatorio. ID del volo del pacchetto che contiene la sottomissione con la percentuale di distribuzione del pacchetto da aggiornare. Questo ID è disponibile nei dati di risposta per le richieste di creare un pacchetto in anteprima e ottenere pacchetti in anteprima per un'app. Per un volo creato nel Partner Center, questo ID è disponibile anche nell'URL della pagina del volo nel Partner Center.
ID di invio	corda	Obbligatorio. ID dell'invio con la percentuale di implementazione del pacchetto da aggiornare. Questo ID è disponibile nei dati di risposta nelle richieste per creare un invio di pacchetto di volo . 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.
percentuale	galleggiare	Obbligatorio. Percentuale di utenti che riceveranno il pacchetto di implementazione graduale.

Testo della richiesta

Non bisogna fornire il corpo della richiesta per questo metodo.

Esempio di richiesta

L'esempio seguente illustra come aggiornare la percentuale di distribuzione del pacchetto per un invio di volo del pacchetto.

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>

Risposta

L'esempio seguente illustra il corpo della risposta JSON per una chiamata riuscita a questo metodo. Per altri dettagli sui valori nel corpo della risposta, vedere la risorsa di distribuzione del pacchetto .

{
    "isPackageRollout": true,
    "packageRolloutPercentage": 25.0,
    "packageRolloutStatus": "PackageRolloutInProgress",
    "fallbackSubmissionId": "1212922684621243058"
}

Codici di errore

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

Codice di errore	Descrizione
404	Impossibile trovare l'invio del pacchetto di volo.
409	Questo codice indica uno degli errori seguenti: 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 dei pacchetti
• Gestire gli invii di voli di pacchetti usando l'API di invio nel Microsoft Store
• Creare e gestire gli invii usando i servizi di Microsoft Store