Aggiorna l'eccedenza

Articolo
03/09/2025

Si applica a

Centro per i partner

Ruoli appropriati

Agente amministrativo

Nota

Le nuove esperienze commerciali per i servizi basati su licenza includono molte nuove funzionalità e sono disponibili per tutti i provider di soluzioni cloud. Per ulteriori informazioni, vedere una panoramica delle nuove esperienze di commercio.

Usato per impostare l'eccedenza di un determinato cliente su una sottoscrizione basata sul consumo. Può essere usato anche per rimuovere l'eccedenza impostandolo su false. L'eccedenza consente a un cliente di continuare a usare i servizi se utilizza il servizio oltre i limiti indicati. La sovrattassa definisce l'ammontare in eccesso rispetto alla sottoscrizione a consumo che verrà addebitato come tariffa a consumo.

Prerequisiti

Le credenziali sono descritte in Autenticazione Partner Center. Questo scenario supporta l'autenticazione con le credenziali App indipendenti e App+Utente.
Un ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Partner Center selezionando l'area clienti, poi il cliente dall'elenco dei clienti e quindi Account. Nella pagina dell'account del cliente, cerca il ID Microsoft nella sezione Info account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).
Almeno una sottoscrizione aggiuntiva idonea è stata acquistata per il cliente.

Richiesta REST

[PUT] /customers/{customer-tenant-id}/subscriptions/overage

Sintassi della richiesta

metodo	URI della richiesta
PUT	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

Parametro URI

Usare i parametri di query seguenti per restituire l'eccedenza di un cliente.

Nome	Digita	Obbligatorio	Descrizione
customer-tenant-id	guid	Y	GUID corrispondente al tenant del cliente.

Intestazioni delle richieste

Per ulteriori informazioni, consulta Intestazioni REST di Partner Center.

Testo della richiesta

Nome	Digita	Descrizione
azureEntitlementId	guid	GUID che definisce l'abbonamento di consumo per l'eccedenza.
partnerId	guid	PartnerID di un rivenditore indiretto. Applicabile solo per un modello a due livelli (provider indiretto).
overageEnabled	bool	Indica se l'eccedenza deve essere abilitata per una specifica sottoscrizione a consumo.

Esempio di richiesta

PUT https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "overageEnabled": true
}

Risposta REST

In caso di esito positivo, questo metodo restituisce l'eccedenza per i clienti.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore.

Risposta di esempio

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/f62cf10b-8f76-4fc4-9774-c5291f8faf86/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}

Condividi tramite