Annullare una sottoscrizione di Azure

Articolo
02/05/2024

Si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

In caso di compromissione o abuso, i partner con sottoscrizioni dei clienti di Azure possono annullare le sottoscrizioni direttamente dal portale del Centro per i partner o dall'API, arrestando le attività sospette individuate nelle sottoscrizioni del piano di Azure.

Questa API annulla una sottoscrizione di Azure. Se i partner vogliono annullare più sottoscrizioni, è necessario chiamare separatamente l'API per annullare ogni sottoscrizione.

Se i partner vogliono sospendere il piano di Azure, devono usare l'API esistente disponibile, aggiornare una sottoscrizione in base all'ID.

L'annullamento del piano di Azure non è supportato dall'API seguente.

Per annullare i partner devono essere Amministrazione istrator globali con ruoli Amministrazione Agent.

Prerequisiti

Credenziali come descritto in Autenticazione del Centro per i partner Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
Customer_id.
Subscription_id.
Entitlement_id.

C#

Per annullare una sottoscrizione di Azure, è necessario identificare l'ID cliente, l'ID sottoscrizione e l'ID entitlement per tale sottoscrizione.

Per ottenere un cliente, fare riferimento a Ottenere un cliente in base all'ID cliente e Ottenere un cliente in base all'ID cliente - API REST per altre informazioni.
Per ottenere una sottoscrizione, vedere Ottenere una sottoscrizione in base all'ID e Ottenere una sottoscrizione per ID - API REST per altre informazioni.
Per ottenere un diritto, vedere Ottenere un diritto di Azure per una sottoscrizione - API REST.

Richiesta REST

Sintassi della richiesta

Metodo	URI della richiesta
POST	{baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel HTTP/1.1

Parametro URI

Questa tabella elenca i parametri di query necessari per annullare una sottoscrizione di Azure.

Nome	Tipo	Obbligatorio	Descrizione
customer_id	String	Y	Il valore è una stringa che indica l'identificatore del cliente.
subscription_id	String	Y	Il valore è una stringa che indica l'identificatore del cliente.
entitlement_id	String	Y	Il valore è una stringa che indica l'identificatore dell'entitlement della sottoscrizione di Azure.

Intestazioni delle richieste

Vedere Intestazioni REST del Centro per i partner.

Corpo della richiesta

HTTP
{ "cancellationReason": "compromise" }

Esempio di richiesta

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": []
   }
  }
}

Risposta REST

In caso di esito positivo, questo metodo restituisce un diritto di Azure per una risorsa di sottoscrizione nel corpo della risposta.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e altre informazioni di debug. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Stato HTTP	Codice HTTP	Codice errore	Descrizione
BadRequest	400	900118	ID cliente non valido.
BadRequest	400	800002	L'ID {0} cliente deve avere un formato GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
BadRequest	400	800002	L'ID sottoscrizione è obbligatorio.
BadRequest	400	800002	L'ID entitlement è obbligatorio.
BadRequest	400	800002	Il contenuto della richiesta di annullamento entitlement di Azure è obbligatorio.
Non consentito	403	900159	Il partner con ID {0} account e ID {1} organizzazione non ha alcuna relazione commerciale con il cliente con ID {2} account e ID {3}organizzazione.
BadRequest	400	900307	Motivo di annullamento '{0} non valido.
NotFound	404	800111	Il diritto di Azure con ID {0} non viene trovato.

Risposta di esempio

La risposta per annullare una sottoscrizione include lo stato entitlement. Si prevede che vengano visualizzati circa 10 minuti per lo stato (ovvero attivo inattivo).

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": []
 }
}

Condividi tramite