Aggiornare l'eccedenza

Articolo
09/25/2024

Si applica a

Centro per i partner

Ruoli appropriati

Agente amministratore

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 altre informazioni, vedere la panoramica delle nuove esperienze commerciali.

Usato per impostare l'eccedenza per un determinato cliente a una sottoscrizione a 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. L'eccedenza definisce l'eccedenza della sottoscrizione a consumo con pagamento in base al consumo verrà accumulata.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
ID cliente (customer-tenant-id). Se non si conosce l'ID del cliente, è possibile cercarlo nel Centro per i partner selezionando l'area di lavoro Clienti , quindi il cliente dall'elenco dei clienti, quindi Account. Nella pagina dell'account del cliente cerca l'ID Microsoft nella sezione Info account del cliente. L'ID Microsoft corrisponde all'ID del cliente (customer-tenant-id).
Almeno una sottoscrizione di eccedenza idonea 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 altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Nome	Tipo	Descrizione
azureEntitlementId	guid	GUID che definisce la sottoscrizione a consumo per l'eccedenza.
partnerId	guid	PartnerID di un rivenditore indiretto. Applicabile solo per un modello a due livelli (provider indiretto).
overageEnabled	bool	Indicare se l'eccedenza deve essere abilitata per una determinata 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 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

{
    "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