Delen via

Alle gebruiksanalysegegevens van Azure ophalen

  • Artikel

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud for US Government

Alle azure-gebruiksanalysegegevens voor uw klanten ophalen.

Vereisten

  • Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met alleen gebruikersreferenties.

REST-aanvraag

Aanvraagsyntaxis

Methode Aanvraag-URI
GET {baseURL}/partner/v1/analytics/usage/azure HTTP/1.1

URI-parameters

Parameter Type Beschrijving
top tekenreeks Het aantal rijen met gegevens dat in de aanvraag moet worden geretourneerd. De maximumwaarde en de standaardwaarde als deze niet is opgegeven, is 10000. Als de query meer rijen bevat, bevat de antwoordtekst een volgende koppeling die u kunt gebruiken om de volgende pagina met gegevens op te vragen.
skip int Het aantal rijen dat in de query moet worden overgeslagen. Gebruik deze parameter om grote gegevenssets te doorlopen. Haalt bijvoorbeeld top=10000 and skip=0 de eerste 10000 rijen met gegevens op, top=10000 and skip=10000 haalt de volgende 10000 rijen met gegevens op, enzovoort.
filter tekenreeks De filterparameter van de aanvraag bevat een of meer instructies waarmee de rijen in het antwoord worden gefilterd. Elke instructie bevat een veld en waarde die zijn gekoppeld aan de eq operatoren of ne , en instructies kunnen worden gecombineerd met of andor. U kunt de volgende tekenreeksen opgeven:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Voorbeeld:
.../usage/azure?filter=meterCategory eq 'Data Management'

Voorbeeld:
.../usage/azure?filter=meterCategory eq 'Data Management' or (usageDate le cast('2018-01-01', Edm.DateTimeOffset) and usageDate le cast('2018-04-01', Edm.DateTimeOffset))
aggregationLevel tekenreeks Hiermee geeft u het tijdsbereik op waarvoor geaggregeerde gegevens moeten worden opgehaald. Kan een van de volgende tekenreeksen zijn: day, weekof month. Als dit niet wordt opgegeven, is dayde standaardwaarde .

De aggregationLevel parameter wordt niet ondersteund zonder een groupby. De aggregationLevel parameter is van toepassing op alle datumvelden die aanwezig zijn in de groupby.
Orderby tekenreeks Een instructie waarmee de resultaatgegevenswaarden voor elke installatie worden besteld. De syntaxis is ...&orderby=field [order],field [order],.... De field parameter kan een van de volgende tekenreeksen zijn:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


De parameter order is optioneel en kan of zijn ascdesc om respectievelijk een oplopende of aflopende volgorde voor elk veld op te geven. De standaardwaarde is asc.

Voorbeeld:
...&orderby=meterCategory,meterUnit
groupby tekenreeks Een instructie waarmee gegevensaggregatie alleen wordt toegepast op de opgegeven velden. U kunt de volgende velden opgeven:

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


De geretourneerde gegevensrijen bevatten de velden die zijn opgegeven in de groupby parameter en hoeveelheid.

De groupby parameter kan worden gebruikt met de aggregationLevel parameter .

Voorbeeld:
...&groupby=meterCategory,meterUnit

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen.

Voorbeeld van aanvraag

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/usage/azure HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

REST-antwoord

Als dit lukt, bevat de antwoordtekst een verzameling Azure-gebruiksresources .

Geslaagde respons- en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die een geslaagde of mislukte status aangeeft en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor de volledige lijst.

Voorbeeld van antwoord

{
  "customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "customerName": "A",
  "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
  "subscriptionName": "AZURE PURCHSE SAMPLE APP",
  "usageDate": "2018-05-27T00:00:00",
  "resourceLocation": "useast",
  "meterCategory": "Data Management",
  "meterSubcategory": "None",
  "meterUnit": "10,000s",
  "quantity": 20
}

Zie ook