Condividi tramite


Annullare una sottoscrizione di Azure

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 ruoli dell'agente di amministrazione.

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.

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 String Y Il valore è una stringa che indica l'identificatore del cliente.
subscription_id String Y Il valore è una stringa che indica l'identificatore della sottoscrizione.
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: 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/425829ba-6938-4b55-af29-fbbd28ebeebf/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
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: 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/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"method": "GET",
"headers": []
 }
}