Reports - List By Time
Een lijst met rapportrecords per tijd.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byTime?$filter={$filter}&interval={interval}&api-version=2022-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byTime?$filter={$filter}&$top={$top}&$skip={$skip}&$orderby={$orderby}&interval={interval}&api-version=2022-08-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
De naam van de resourcegroep. De naam is niet hoofdlettergevoelig. |
service
|
path | True |
string |
De naam van de API Management service. Regex pattern: |
subscription
|
path | True |
string |
De id van het doelabonnement. |
$filter
|
query | True |
string |
| Veld | Gebruik | Ondersteunde operators | Ondersteunde functies | |
api-version
|
query | True |
string |
De API-versie die voor deze bewerking moet worden gebruikt. |
interval
|
query | True |
string duration |
Op tijdsinterval. Interval moet meerdere van 15 minuten zijn en mag niet nul zijn. De waarde moet de ISO 8601-indeling () hebben.http://en.wikipedia.org/wiki/ISO_8601#Durations Deze code kan worden gebruikt om TimeSpan te converteren naar een geldige intervaltekenreeks: XmlConvert.ToString(new TimeSpan(hours, minutes, seconds)). |
$orderby
|
query |
string |
OData-volgorde op queryoptie. |
|
$skip
|
query |
integer int32 |
Aantal records dat moet worden overgeslagen. |
|
$top
|
query |
integer int32 |
Het aantal te retourneren records. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
Hiermee wordt een verzameling rapportrecords weergegeven. |
|
Other Status Codes |
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | uw gebruikersaccount imiteren |
Voorbeelden
ApiManagementGetReportsByTime
Sample Request
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/reports/byTime?$filter=timestamp ge datetime'2017-06-01T00:00:00' and timestamp le datetime'2017-06-04T00:00:00'&interval=PT15M&api-version=2022-08-01
Sample Response
{
"value": [
{
"timestamp": "2017-06-03T00:15:00Z",
"interval": "PT15M",
"callCountSuccess": 4,
"callCountBlocked": 0,
"callCountFailed": 0,
"callCountOther": 0,
"callCountTotal": 4,
"bandwidth": 3243,
"cacheHitCount": 0,
"cacheMissCount": 0,
"apiTimeAvg": 1337.46335,
"apiTimeMin": 885.0839000000001,
"apiTimeMax": 1819.2173,
"serviceTimeAvg": 1255.917425,
"serviceTimeMin": 882.8264,
"serviceTimeMax": 1697.3612
},
{
"timestamp": "2017-06-03T00:30:00Z",
"interval": "PT15M",
"callCountSuccess": 9,
"callCountBlocked": 1,
"callCountFailed": 0,
"callCountOther": 0,
"callCountTotal": 10,
"bandwidth": 7776,
"cacheHitCount": 0,
"cacheMissCount": 0,
"apiTimeAvg": 872.7818777777778,
"apiTimeMin": 330.3206,
"apiTimeMax": 1093.8407,
"serviceTimeAvg": 824.2847111111112,
"serviceTimeMin": 215.24,
"serviceTimeMax": 973.2262000000001
}
],
"count": 2,
"nextLink": ""
}
Definities
Name | Description |
---|---|
Error |
Fout Veldcontract. |
Error |
Foutreactie. |
Report |
Weergave van lijst met gepagineerde rapportrecords. |
Report |
Rapportgegevens. |
ErrorFieldContract
Fout Veldcontract.
Name | Type | Description |
---|---|---|
code |
string |
Foutcode op eigenschapsniveau. |
message |
string |
Door mensen leesbare weergave van fout op eigenschapsniveau. |
target |
string |
Naam van eigenschap. |
ErrorResponse
Foutreactie.
Name | Type | Description |
---|---|---|
error.code |
string |
Door de service gedefinieerde foutcode. Deze code fungeert als een substatus voor de HTTP-foutcode die is opgegeven in het antwoord. |
error.details |
De lijst met ongeldige velden verzenden in aanvraag, in het geval van een validatiefout. |
|
error.message |
string |
Door mensen leesbare weergave van de fout. |
ReportCollection
Weergave van lijst met gepagineerde rapportrecords.
Name | Type | Description |
---|---|---|
count |
integer |
Totaal aantal records voor alle pagina's. |
nextLink |
string |
Koppeling naar volgende pagina, indien aanwezig. |
value |
Paginawaarden. |
ReportRecordContract
Rapportgegevens.
Name | Type | Description |
---|---|---|
apiId |
string |
API-id-pad. /apis/{apiId} |
apiRegion |
string |
API-regio-id. |
apiTimeAvg |
number |
De gemiddelde tijd die nodig was om de aanvraag te verwerken. |
apiTimeMax |
number |
Maximale tijd die nodig was om de aanvraag te verwerken. |
apiTimeMin |
number |
Minimale tijd die nodig was om de aanvraag te verwerken. |
bandwidth |
integer |
Verbruikte bandbreedte. |
cacheHitCount |
integer |
Aantal keren dat inhoud is geleverd vanuit cachebeleid. |
cacheMissCount |
integer |
Het aantal keren dat inhoud is opgehaald uit de back-end. |
callCountBlocked |
integer |
Aantal geblokkeerde aanroepen vanwege ongeldige referenties. Dit omvat aanroepen die HttpStatusCode.Unauthorized en HttpStatusCode.Forbidden en HttpStatusCode.TooManyRequests retourneren |
callCountFailed |
integer |
Het aantal aanroepen is mislukt vanwege gateway- of back-endfouten. Dit omvat aanroepen die HttpStatusCode.BadRequest(400) en code tussen HttpStatusCode.InternalServerError (500) en 600 retourneren |
callCountOther |
integer |
Aantal andere oproepen. |
callCountSuccess |
integer |
Aantal geslaagde oproepen. Dit omvat aanroepen die HttpStatusCode <= 301 en HttpStatusCode.NotModified en HttpStatusCode.TemporaryRedirect retourneren |
callCountTotal |
integer |
Totaal aantal oproepen. |
country |
string |
Het land waaraan deze recordgegevens zijn gerelateerd. |
interval |
string |
Lengte van de aggregatieperiode. Interval moet meerdere van 15 minuten zijn en mag niet nul zijn. De waarde moet de ISO 8601-indeling () hebben.http://en.wikipedia.org/wiki/ISO_8601#Durations |
name |
string |
Naam, afhankelijk van het rapporteindpunt, geeft de naam van het product, de API, de bewerking of de naam van de ontwikkelaar op. |
operationId |
string |
Pad naar bewerkings-id. /apis/{apiId}/operations/{operationId} |
productId |
string |
Pad naar product-id. /products/{productId} |
region |
string |
Landregio waaraan deze recordgegevens zijn gerelateerd. |
serviceTimeAvg |
number |
Gemiddelde tijd die nodig was om de aanvraag op de back-end te verwerken. |
serviceTimeMax |
number |
Maximale tijd die nodig was om de aanvraag op de back-end te verwerken. |
serviceTimeMin |
number |
Minimale tijd die nodig was om de aanvraag op de back-end te verwerken. |
subscriptionId |
string |
Pad naar abonnements-id. /subscriptions/{subscriptionId} |
timestamp |
string |
Begin van de aggregatieperiode. De datum voldoet aan de volgende notatie: |
userId |
string |
Pad naar gebruikers-id. /users/{userId} |
zip |
string |
Postcode waaraan deze recordgegevens zijn gerelateerd. |