Aggiorna l'eccedenza

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.

Il gruppo di risorse è sempre M365. I partner possono aggiungere tag e posizioni al gruppo di risorse, ma non possono modificarli.

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	Required. GUID che definisce l'abbonamento di consumo per l'eccedenza.
azureResourceGroup	oggetto	Optional. Valore del nome dei tag e della posizione del gruppo di risorse.
partnerId	guid	Applicabile solo per un modello a due livelli (provider indiretto). PartnerID di un rivenditore indiretto.
overageEnabled	bool	Required. 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: 00000000-0000-0000-0000-000000000000
MS-CorrelationId: 00000000-0000-0000-0000-000000000000
X-Locale: en-US

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
  },
    "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: 00000000-0000-0000-0000-000000000000
MS-RequestId: 00000000-0000-0000-0000-000000000000
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "00000000-0000-0000-0000-000000000000",
    "partnerId": "5357563",
    "azureResourceGroup": {
        "tags": {
          "teams phone": "pay as you go calls"
    },
    "location": "canadacentral"
    },
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/00000000-0000-0000-0000-000000000000/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}