Condividi tramite

Ottenere un'autorizzazione di Azure per un abbonamento

  • 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

I partner possono visualizzare i diritti di utilizzo di Azure relativi a una sottoscrizione utilizzando questa API, che ottiene i diritti relativi all'identificatore di sottoscrizione per un cliente.

Prerequisiti

  • Credenziali descritte in 'autenticazione del Centro partner. Questo scenario supporta l'autenticazione con le credenziali sia delle app autonome che delle app+utente.
  • ID_cliente.
  • ID_sottoscrizione.
  • Entitlement_id.

C#

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

Richiesta REST

Sintassi della richiesta

metodo URI della richiesta
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id} 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_abbonamento Stringa Y Il valore è una stringa che indica l'identificatore del cliente.
entitlement_id Stringa Y Il valore è una stringa che indica l'identificatore del diritto di sottoscrizione di Azure.

Intestazioni della richiesta

Consulta intestazioni REST del Centro Partner.

Corpo della richiesta

Non è richiesto alcun corpo della richiesta.

Esempio di richiesta

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}

HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Risposta REST

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

Codici di errore e esito positivo 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, vedere codici di errore REST del Centro per i partner.

stato dell'HTTP Codice HTTP codice di errore Descrizione
Richiesta Non Valida 400 900118 ID cliente non valido.
Richiesta Non Valida 400 800002 L'ID cliente {0} deve avere il formato GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
Richiesta Non Valida 400 800002 L'ID sottoscrizione è obbligatorio.
Richiesta Non Valida 400 800002 L'ID di autorizzazione è obbligatorio.
RichiestaNonValida 400 800002 Il contenuto della richiesta di annullamento dei diritti di accesso di Azure è obbligatorio.
Vietato 403 900159 Il partner con ID account {0} e ID organizzazione {1} non ha alcuna relazione commerciale con il cliente con ID account {2} e ID organizzazione {3}.
Richiesta Non Valida 400 900307 Motivo di annullamento '{0} non è valido.
Non trovato 404 800111 L'assegnazione di Azure con ID {0} non è stata trovata.

Esempio di risposta

La risposta restituisce l'autorizzazione Azure per un dato cliente.

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": “inactive", 
    "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