Udostępnij za pośrednictwem

Uzyskiwanie uprawnień platformy Azure dla subskrypcji

  • Artykuł

Dotyczy: Centrum partnerskie | Centrum partnerskie obsługiwane przez firmę 21Vianet | Centrum partnerskie dla chmury firmy Microsoft dla instytucji rządowych USA

Partnerzy mogą wyświetlać swoje uprawnienia platformy Azure dla subskrypcji przy użyciu tego interfejsu API, który uzyskuje uprawnienie do identyfikatora subskrypcji dla klienta.

Wymagania wstępne

  • Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
  • Customer_id.
  • Subscription_id.
  • Entitlement_id.

C#

Aby anulować subskrypcję platformy Azure, musisz zidentyfikować identyfikator klienta, identyfikator subskrypcji i identyfikator uprawnień dla subskrypcji platformy Azure, którą chcesz anulować.

Żądanie REST

Składnia żądania

Metoda Identyfikator URI żądania
POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id} HTTP/1.1

Parametr identyfikatora URI

W tej tabeli wymieniono wymagane parametry zapytania w celu anulowania subskrypcji platformy Azure.

Nazwa/nazwisko Type Wymagane Opis
customer_id String Y Wartość jest ciągiem, który określa identyfikator klienta.
subscription_id String Y Wartość jest ciągiem, który określa identyfikator klienta.
entitlement_id String Y Wartość jest ciągiem, który określa identyfikator uprawnienia subskrypcji platformy Azure.

Nagłówki żądań

Zobacz Nagłówki REST Centrum partnerskiego.

Treść żądania

Treść żądania nie jest wymagana.

Przykład żądania

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

Odpowiedź REST

Jeśli ta metoda powiedzie się, ta metoda zwraca uprawnienie platformy Azure dla zasobu subskrypcji w treści odpowiedzi.

Kody powodzenia i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i więcej informacji o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i inne parametry. Aby uzyskać pełną listę, zobacz Kody błędów REST Centrum partnerskiego.

Stan HTTP Kod HTTP Kod błędu Opis
BadRequest 400 900118 Nieprawidłowy identyfikator klienta.
BadRequest 400 800002 Identyfikator {0} klienta powinien mieć format GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
BadRequest 400 800002 Wymagany jest identyfikator subskrypcji.
BadRequest 400 800002 Wymagany jest identyfikator upoważnienia.
BadRequest 400 800002 Wymagana jest zawartość żądania anulowania uprawnień platformy Azure.
Dostęp zabroniony 403 900159 Partner z identyfikatorem {0} konta i identyfikatorem {1} organizacji nie ma relacji handlowych z klientem z identyfikatorem konta i identyfikatorem {2} {3}organizacji.
BadRequest 400 900307 Przyczyna anulowania "{0} jest nieprawidłowa.
Nie znaleziono 404 800111 Nie można odnaleźć uprawnień platformy Azure o identyfikatorze {0} .

Przykład odpowiedzi

Odpowiedź zwraca uprawnienie platformy Azure dla danego klienta.

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

Powiązana zawartość