Condividi tramite

Ottenere un diritto di Azure per una sottoscrizione

  • 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 il diritto di Azure per una sottoscrizione usando questa API, che ottiene il diritto dell'identificatore della sottoscrizione per un cliente.

Prerequisiti

  • Credenziali descritte 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 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 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

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 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 restituisce il diritto di Azure per un determinato 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