Túlforgalom frissítése

A következőkre vonatkozik:

• Partnerközpont

Megfelelő szerepkörök

• Rendszergazdai ügynök

Feljegyzés

A licencalapú szolgáltatások új kereskedelmi felületei számos új képességet tartalmaznak, és minden Felhőszolgáltató (CSP) számára elérhetők. További információkért tekintse meg az új kereskedelmi élmények áttekintése című dokumentumot.

Egy adott ügyfél számára a használati előfizetés túllépésének beállítására szolgál. A túlhasználat eltávolítására is használható, ha hamis értékre állítja. A túlhasználat lehetővé teszi az ügyfél számára, hogy továbbra is használja a szolgáltatásokat, ha a szolgáltatást a megadott korlátokon túl használják. A túlfogyasztás meghatározza azt a fogyasztás túllépést, amelyet használat alapján fognak felszámolni.

Az erőforráscsoport mindig M365. A partnerek címkéket és helyeket adhatnak az erőforráscsoporthoz, de nem módosíthatják.

Előfeltételek

• Hitelesítő adatok a Partnerközpont hitelesítés leírásának megfelelően. Ez a forgatókönyv támogatja az önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.

• Ügyfélazonosító (customer-tenant-id). Ha nem ismeri az ügyfél azonosítóját, megkeresheti a Partnerközpontban az Ügyfelek munkaterület kiválasztásával, majd az ügyféllistából kiválasztja a megfelelő ügyfelet, és végül a Fiók részhez lép. Az ügyfél Fiók lapján keresse meg a Microsoft azonosítót az Ügyfél fiók adatai szakaszban. A Microsoft-azonosító megegyezik az ügyfél-azonosítóval (customer-tenant-id).

• Legalább egy jogosult, az ügyfél számára vásárolt túlhasználati előfizetés.

REST-kérés

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

Kérés szintaxisa

Metódus	URI kérelem
PUT	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

URI-paraméter

Az ügyfél túlhasználatának visszaadásához használja az alábbi lekérdezési paramétereket.

Név	Típus	Kötelező	Leírás
ügyfél-bérlő-azonosító	útmutató	Y	Az ügyfél bérlőjének megfelelő GUID.

Kérésfejlécek

További információkért lásd: Partner Center REST fejlécek.

Kérés törzse

Név	Típus	Leírás
azureEntitlementId	útmutató	Kötelező. A túlhasználat fogyasztási előfizetését meghatározó GUID.
azureResourceGroup	objektum	Optional. A címkék névértéke és az erőforráscsoport helye.
partnerazonosító	útmutató	Csak kétrétegű modellre (közvetett szolgáltatóra) alkalmazható. Közvetett viszonteladó partnerazonosítója.
overageEnabled	bool	Kötelező. Adja meg, hogy engedélyezni kell-e a túlhasználatot egy adott használati előfizetéshez.

Példa kérése

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
}

REST-válasz

Ha sikeres, ez a módszer az ügyfél többletköltségeit adja vissza.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát lásd a Hibakódok oldalon.

Példa válaszra

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