Sdílet prostřednictvím

Získání nároku Na Azure pro předplatné

  • Článek

Platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Partneři můžou zobrazit svůj nárok na Azure pro předplatné pomocí tohoto rozhraní API, které získá nárok na identifikátor předplatného pro zákazníka.

Požadavky

  • Přihlašovací údaje popsané v ověřování v Partnerském centru Tento scénář podporuje ověřování pomocí samostatných přihlašovacích údajů aplikace i aplikace a uživatele.
  • Customer_id.
  • Subscription_id.
  • Entitlement_id.

C#

Pokud chcete zrušit předplatné Azure, budete muset identifikovat ID zákazníka, ID předplatného a ID nároku pro předplatné Azure, které chcete zrušit.

Požadavek REST

Syntaxe požadavku

Metoda Identifikátor URI požadavku
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id} HTTP/1.1

Parametr identifikátoru URI

Tato tabulka obsahuje seznam požadovaných parametrů dotazu pro zrušení předplatného Azure.

Název Typ Povinné Popis
customer_id String Y Hodnota je řetězec, který označuje identifikátor zákazníka.
subscription_id String Y Hodnota je řetězec, který označuje identifikátor zákazníka.
entitlement_id String Y Hodnota je řetězec, který označuje identifikátor nároku na předplatné Azure.

Záhlaví žádosti

Viz hlavičky REST Partnerského centra.

Text požadavku

Nevyžaduje se žádný text požadavku.

Příklad požadavku

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}

HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Odpověď REST

Pokud je tato metoda úspěšná, vrátí nárok Azure na prostředek předplatného v textu odpovědi.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který indikuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Stav HTTP Kód HTTP Kód chyby Popis
BadRequest 400 900118 Neplatné ID zákazníka
BadRequest 400 800002 ID {0} zákazníka by mělo mít formát GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
BadRequest 400 800002 Vyžaduje se ID předplatného.
BadRequest 400 800002 Je vyžadováno ID nároku.
BadRequest 400 800002 Vyžaduje se obsah žádosti o zrušení nároku Azure.
Zakázáno 403 900159 Partner s ID {0} účtu a ID {1} organizace nemá žádný obchodní vztah se zákazníkem s ID {2} účtu a ID {3}organizace .
BadRequest 400 900307 Důvod zrušení je{0} neplatný.
NotFound 404 800111 Nárok Azure s ID {0} se nenašel.

Příklad odpovědi

Odpověď vrátí nárok Azure pro daného zákazníka.

HTTP
HTTP/1.1 200 OK
Content-Length: 1132
Content-Type: application/json; charset=utf-8
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT

{ 
    "id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f", 
    "friendlyName": " Cancel_Azure_Subscription", 
    "status": “inactive", 
    "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e", 
    "links": { 
        "self": { 
            "uri": "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f", 
            "method": "GET", 
            "headers": [] 
        } 
    }

Související obsah