Sdílet prostřednictvím

Zrušení předplatného Azure

  • Článek

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

Pokud dojde k ohrožení nebo zneužití, můžou partneři s předplatnými zákazníků Azure zrušit předplatná přímo z portálu Partnerského centra nebo rozhraní API a vypnout podezřelou aktivitu zjištěnou v předplatných plánů Azure.

Toto rozhraní API zruší předplatné Azure. Pokud partneři chtějí zrušit více než jedno předplatné, musí rozhraní API volat samostatně, aby zrušili každou z nich.

Pokud chtějí partneři pozastavit svůj plán Azure, měli by použít stávající dostupné rozhraní API a aktualizovat předplatné podle ID.

Následující rozhraní API nepodporuje zrušení plánu Azure.

Aby mohli partneři zrušit, musí být globální správci s rolemi agenta pro správu.

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, musíte pro toto předplatné identifikovat ID zákazníka, ID předplatného a ID nároku.

Požadavek REST

Syntaxe požadavku

Metoda Identifikátor URI požadavku
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel 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 předplatného.
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

HTTP
{ "cancellationReason": "compromise" }

Příklad požadavku

POST
[https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel](https://api.partnercenter.microsoft.com/v1/customers/%7bcustomer_id%7d/subscriptions/%7bsubscription_id%7d/azureEntitlements/%7bentitlement_id%7d/cancel)
HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
{
 "id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
 "friendlyName": "Cancel_Azure_Subscription ",
 "status": "active",
 "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": []
   }
  }
}

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ěď na zrušení předplatného zahrnuje stav nároku. Očekávejte přibližně 10 minut, než se stav projeví (to znamená aktivní až neaktivní).

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": "active",
"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