Condividi tramite

Annullare una sottoscrizione di Azure

  • Articolo

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 amministratori globali con il ruolo di Agente Amministrativo.

Prerequisiti

  • Credenziali come descritto in Partner Center authentication. Questo scenario supporta l'autenticazione con le credenziali App indipendenti e App+Utente.

  • ID cliente

  • Identificativo_abbonamento.

  • Entitlement_id.

C#

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

Richiesta REST

Sintassi della richiesta

Metodo URI delle 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 Stringa Y Il valore è una stringa che indica l'identificatore del cliente.
ID sottoscrizione Stringa Y Il valore è una stringa che indica l'identificatore della sottoscrizione.
entitlement_id Stringa Y Il valore è una stringa che indica l'identificatore del diritto della sottoscrizione di Azure.

Intestazioni delle richieste

Consultare le intestazioni REST di Partner Center.

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

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
Richiesta non valida 400 900118 ID cliente non valido.
Richiesta non valida 400 800002 L'ID {0} cliente deve avere un formato GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
Richiesta non valida 400 800002 L'ID sottoscrizione è obbligatorio.
Richiesta non valida 400 800002 L'ID del diritto è obbligatorio.
Richiesta non valida 400 800002 Il contenuto della richiesta di annullamento dell'assegnazione di Azure è obbligatorio.
Non consentito 403 900159 Il partner con account ID {0} e organizzazione ID {1} non ha alcuna relazione commerciale con il cliente con account ID {2} e organizzazione ID {3}.
Richiesta non valida 400 900307 Motivo di annullamento '{0} non valido.
Non Trovato 404 800111 Il diritto di Azure con ID {0} non viene trovato.

Risposta di esempio

La risposta per la cancellazione di un abbonamento include lo stato dell'autorizzazione. Ci vorranno circa 10 minuti affinché lo stato venga aggiornato, ovvero da attivo a inattivo.

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

Contenuto correlato