Aggiornare la percentuale di implementazione per un invio in anteprima
Usa questo metodo nell'API di invio a Microsoft Store per aggiornare la percentuale di implementazione del pacchetto 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, è 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}/updatepackagerolloutpercentage |
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 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 | string | Obbligatorio. ID del pacchetto in anteprima che contiene l'invio con la percentuale di implementazione del pacchetto che vuoi 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 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 la percentuale di implementazione del pacchetto da aggiornare. 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. |
| percentage | float | Obbligatorio. Percentuale di utenti che riceveranno il pacchetto di implementazione graduale. |
Corpo della richiesta
Non fornire un corpo della richiesta per questo metodo.
Esempio di richiesta
L'esempio seguente illustra come aggiornare la percentuale di implementazione per l'invio del pacchetto in anteprima.
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>
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": 25.0,
"packageRolloutStatus": "PackageRolloutInProgress",
"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:
|