Hämta en lista över Azure-berättigande för en prenumeration
Du kan använda Azure-berättiganderesursen (AzureEntitlement) för att hämta en samling resurser som tillhör en prenumeration.
Förutsättningar
Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder autentisering med både fristående app- och app+användarautentiseringsuppgifter.
Ett kund-ID (
customer-tenant-id
). Om du inte känner till kundens ID kan du söka efter det i Partnercenter genom att välja arbetsytan Kunder , sedan kunden från kundlistan och sedan Konto. På kundens kontosida letar du upp Microsoft-ID :t i avsnittet Kundkontoinformation . Microsoft-ID:t är samma som kund-ID:t (customer-tenant-id
).En prenumerationsidentifierare.
REST-begäran
Begärandesyntax
Metod | URI för förfrågan |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/azureentitlements HTTP/1.1 |
URI-parametrar
I följande tabell visas de frågeparametrar som krävs för att hämta alla Azure-rättigheter för en prenumeration.
Namn | Typ | Obligatorisk | Beskrivning |
---|---|---|---|
customer-tenant-id | Guid | Y | Ett GUID som motsvarar kunden. |
prenumerations-ID | Guid | Y | Ett GUID som motsvarar prenumerationen. |
Begärandehuvuden
Mer information finns i REST-huvuden för Partnercenter.
Begärandetext
Inga.
Exempel på begäran
GET https://api.partnercenter.microsoft.com/v1/customers/11f9bc2a-1f38-431c-a0b0-9455c6f5bbc0/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 16fee928-dc2c-412f-adbb-871f68babf16
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Connection: Keep-Alive
REST-svar
Om det lyckas returnerar den här metoden en samling AzureEntitlement-resurser i svarstexten.
Lyckade svar och felkoder
Varje svar levereras med en HTTP-statuskod som anger lyckat eller misslyckat och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder.
Exempel på svar
HTTP/1.1 200 OK
Content-Length: 73754
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 16fee928-dc2c-412f-adbb-871f68babf16
Date: Wed, 04 Oct 2019 05:50:45 GMT
{
"totalCount":1,
"items":[
{
"id":"899ae6f1-8a74-4d5e-b6c6-e6b5019bbff8",
"friendlyName":"Microsoft Azure",
"status":"active",
"subscriptionId":"aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
}],
"attributes":{"objectType":"Collection"}
}