Zrušení předplatného Azure

Článek
02/05/2024

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.

Partneři musí být globálními Správa istrátory s rolemi agenta Správa ke zrušení.

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.

Další pomoc najdete v tématu Získání zákazníka podle ID a získání zákazníka podle ID zákazníka – rozhraní REST API .
Pokud chcete získat předplatné, přečtěte si další nápovědu v tématu Získání předplatného podle ID a získání předplatného podle ID – rozhraní REST API .
Pokud chcete získat nárok, přečtěte si článek Získání nároku Azure pro předplatné – REST API.

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

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: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
{
 "id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
 "friendlyName": "Cancel_Azure_Subscription ",
 "status": "active",
 "subscriptionId": "065eefc4-915b-453d-c558-152e39ec25b1",
 "links": {
  "self": {
  "uri":
  "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/065eefc4-915b-453d-c558-152e39ec25b1/azureEntitlements/5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
  "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: 6eacec93-852d-4167-9d96-c57809bea7ed
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT
{
"id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
"friendlyName": " Cancel_Azure_Subscription",
"status": "active",
"subscriptionId": "065eefc4-915b-453d-c558-152e39ec25b1",
"links": {
"self": {
"uri":
"/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/065eefc4-915b-453d-c558-152e39ec25b1/azureEntitlements/5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
"method": "GET",
"headers": []
 }
}

Share via