Ottenere un diritto di Azure per una sottoscrizione
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.
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} 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: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
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: 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": “inactive",
"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": []
}
}
Passaggi successivi
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per