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 do platformy Azure dla subskrypcji, korzystając z tego interfejsu API, który uzyskuje uprawnienia do identyfikatora subskrypcji klienta.

Warunki wstępne

  • Poświadczenia weryfikacyjne opisane w sekcji uwierzytelnianie Centrum partnerskiego. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu autonomicznych poświadczeń aplikacji, jak i aplikacji i użytkownika.
  • Identyfikator_klienta
  • Subscription_id.
  • Identyfikator_uprawnień.

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 Żądanie URI
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 typu wymagane Opis
identyfikator_klienta Struna Y Wartość jest ciągiem, który określa identyfikator klienta.
identyfikator_subskrypcji Struna Y Wartość jest ciągiem, który określa identyfikator klienta.
identyfikator_uprawnienia Struna 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ę, zwraca uprawnienia platformy Azure dla zasobu subskrypcji w treści odpowiedzi.

Kody sukcesu 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.

stanu HTTP Kod HTTP kod błędu Opis
Niepoprawne Żądanie 400 900118 Nieprawidłowy identyfikator klienta.
Niepoprawne żądanie 400 800002 Identyfikator klienta {0} powinien mieć format GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
Złe żądanie 400 800002 Wymagany jest identyfikator subskrypcji.
Nieprawidłowe żądanie 400 800002 Wymagany jest identyfikator upoważnienia.
Niepoprawne żądanie 400 800002 Wymagana jest zawartość żądania anulowania uprawnień platformy Azure.
Zakazany 403 900159 Partner z identyfikatorem konta {0} i identyfikatorem organizacji {1} nie ma relacji handlowych z klientem z identyfikatorem konta {2} i identyfikatorem organizacji {3}.
Nieprawidłowe żądanie 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 określonego 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ść