Condividi tramite


Aggiornare la percentuale di implementazione per un invio dell'app

Usa questo metodo nell'API di invio a Microsoft Store per aggiornare la percentuale di implementazione del pacchetto per un invio di app. Per ulteriori informazioni su questo metodo nell'ambito del processo di creazione di un invio di un'app mediante l'API di invio di Microsoft Store, vedere Gestire gli invii di app.

Prerequisiti

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

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}/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 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.
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 app. 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 del pacchetto per un invio di app.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/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 di errore Descrizione
404 Non è stato possibile trovare l'invio.
409 Questo codice indica uno dei seguenti errori: