Reports - List By Request
Een lijst met rapportrecords per aanvraag.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byRequest?$filter={$filter}&api-version=2022-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byRequest?$filter={$filter}&$top={$top}&$skip={$skip}&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-patroon: |
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. |
$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
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
Name | Description |
---|---|
user_impersonation | uw gebruikersaccount imiteren |
Voorbeelden
ApiManagementGetReportsByRequest
Voorbeeldaanvraag
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/reports/byRequest?$filter=timestamp ge datetime'2017-06-01T00:00:00' and timestamp le datetime'2017-06-04T00:00:00'&api-version=2022-08-01
Voorbeeldrespons
{
"value": [
{
"apiId": "/apis/5931a75ae4bbd512a88c680b",
"operationId": "/apis/5931a75ae4bbd512a88c680b/operations/-",
"productId": "/products/-",
"userId": "/users/1",
"method": "GET",
"url": "https://apimService1.azure-api.net/echo/resource?param1=sample",
"ipAddress": "207.xx.155.xx",
"responseCode": 404,
"responseSize": 405,
"timestamp": "2017-06-03T00:17:00.1649134Z",
"cache": "none",
"apiTime": 221.1544,
"serviceTime": 0,
"apiRegion": "East Asia",
"subscriptionId": "/subscriptions/5600b59475ff190048070002",
"requestId": "63e7119c-26aa-433c-96d7-f6f3267ff52f",
"requestSize": 0
},
{
"apiId": "/apis/5931a75ae4bbd512a88c680b",
"operationId": "/apis/5931a75ae4bbd512a88c680b/operations/-",
"productId": "/products/-",
"userId": "/users/1",
"method": "POST",
"url": "https://apimService1.azure-api.net/echo/resource",
"ipAddress": "207.xx.155.xx",
"responseCode": 404,
"responseSize": 403,
"timestamp": "2017-06-03T00:17:20.5255131Z",
"cache": "none",
"apiTime": 6.675400000000001,
"serviceTime": 0,
"apiRegion": "East Asia",
"subscriptionId": "/subscriptions/5600b59475ff190048070002",
"requestId": "e581b7f7-c9ec-4fc6-8ab9-3855d9b00b04",
"requestSize": 0
}
],
"count": 2
}
Definities
Name | Description |
---|---|
Error |
Fout Veldcontract. |
Error |
Foutreactie. |
Request |
Weergave van lijst met gepagineerde rapportrecords. |
Request |
Rapportgegevens aanvragen. |
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. |
RequestReportCollection
Weergave van lijst met gepagineerde rapportrecords.
Name | Type | Description |
---|---|---|
count |
integer |
Totaal aantal records voor alle pagina's. |
value |
Paginawaarden. |
RequestReportRecordContract
Rapportgegevens aanvragen.
Name | Type | Description |
---|---|---|
apiId |
string |
API-id-pad. /apis/{apiId} |
apiRegion |
string |
Azure-regio waar de gateway zich bevindt die deze aanvraag heeft verwerkt. |
apiTime |
number |
De totale tijd die nodig was om deze aanvraag te verwerken. |
backendResponseCode |
string |
De HTTP-statuscode die door de gateway is ontvangen als gevolg van het doorsturen van deze aanvraag naar de back-end. |
cache |
string |
Hiermee geeft u op of de antwoordcache is betrokken bij het genereren van het antwoord. Als de waarde geen is, is de cache niet gebruikt. Als de waarde wordt bereikt, wordt het antwoord in de cache geretourneerd. Als de waarde ontbreekt, is de cache gebruikt, maar de zoekactie heeft geleid tot een fout en de aanvraag is voltooid door de back-end. |
ipAddress |
string |
Het IP-adres van de client dat aan deze aanvraag is gekoppeld. |
method |
string |
De HTTP-methode die aan deze aanvraag is gekoppeld. |
operationId |
string |
Pad naar bewerkings-id. /apis/{apiId}/operations/{operationId} |
productId |
string |
Pad naar product-id. /products/{productId} |
requestId |
string |
Aanvraag-id. |
requestSize |
integer |
De grootte van deze aanvraag. |
responseCode |
integer |
De HTTP-statuscode die door de gateway wordt geretourneerd. |
responseSize |
integer |
De grootte van het antwoord dat door de gateway wordt geretourneerd. |
serviceTime |
number |
De tijd die nodig was om deze aanvraag door te sturen naar de back-end en het antwoord terug te krijgen. |
subscriptionId |
string |
Pad naar abonnements-id. /subscriptions/{subscriptionId} |
timestamp |
string |
De datum en tijd waarop deze aanvraag is ontvangen door de gateway in ISO 8601-indeling. |
url |
string |
De volledige URL die aan deze aanvraag is gekoppeld. |
userId |
string |
Pad naar gebruikers-id. /users/{userId} |