Ottenere eccedenza

Articolo
03/08/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 la panoramica delle nuove esperienze commerciali.

Utilizzato per ottenere l'eccedenza per un determinato cliente. L'eccedenza consente a un cliente di continuare a usare i servizi se utilizza il servizio oltre i limiti indicati. Il sovrapprezzo definisce il consumo in eccesso della sottoscrizione che verrà addebitato secondo il modello pay-as-you-go.

Prerequisiti

Credenziali come descritto in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali App standalone e App+Utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Partner Center selezionando la sezione Clienti, quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina Account del cliente, cerca l'ID Microsoft nella sezione Info account del cliente. L'ID Microsoft è lo stesso dell'ID cliente (customer-tenant-id).

Richiesta REST

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

Sintassi della richiesta

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

Parametro URI

Usare i parametri di query seguenti per restituire le eccedenze di un cliente.

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

Intestazioni delle richieste

Per ulteriori informazioni, consultare Intestazioni REST del Centro per i partner.

Testo della richiesta

None

Esempio di richiesta

GET 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

Risposta REST

In caso di esito positivo, questo metodo restituisce l'eccedenza per un cliente.

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

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

Condividi tramite