Reports - List By User
Rapor kayıtlarını Kullanıcıya göre listeler.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byUser?$filter={$filter}&api-version=2022-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/reports/byUser?$filter={$filter}&$top={$top}&$skip={$skip}&$orderby={$orderby}&api-version=2022-08-01
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Kaynak grubunun adı. Ad büyük/küçük harfe duyarlı değildir. |
service
|
path | True |
string |
API Management hizmetinin adı. Normal ifade deseni: |
subscription
|
path | True |
string |
Hedef aboneliğin kimliği. |
$filter
|
query | True |
string |
| Alan | Kullanım | Desteklenen işleçler | Desteklenen işlevler | |
api-version
|
query | True |
string |
Bu işlem için kullanılacak API sürümü. |
$orderby
|
query |
string |
Sorguya göre OData sırası seçeneği. |
|
$skip
|
query |
integer int32 |
At edilecek kayıt sayısı. |
|
$top
|
query |
integer int32 |
Döndürülecek kayıt sayısı. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Rapor kaydı koleksiyonunu listeler. |
|
Other Status Codes |
İşlemin neden başarısız olduğunu açıklayan hata yanıtı. |
Güvenlik
azure_auth
Azure Active Directory OAuth2 Flow.
Tür:
oauth2
Akış:
implicit
Yetkilendirme URL’si:
https://login.microsoftonline.com/common/oauth2/authorize
Kapsamlar
Name | Description |
---|---|
user_impersonation | kullanıcı hesabınızın kimliğine bürünme |
Örnekler
ApiManagementGetReportsByUser
Örnek isteği
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/reports/byUser?$filter=timestamp ge datetime'2017-06-01T00:00:00' and timestamp le datetime'2017-06-04T00:00:00'&api-version=2022-08-01
Örnek yanıt
{
"value": [
{
"name": "Administrator",
"userId": "/users/1",
"callCountSuccess": 13,
"callCountBlocked": 1,
"callCountFailed": 0,
"callCountOther": 0,
"callCountTotal": 14,
"bandwidth": 11019,
"cacheHitCount": 0,
"cacheMissCount": 0,
"apiTimeAvg": 1015.7607923076923,
"apiTimeMin": 330.3206,
"apiTimeMax": 1819.2173,
"serviceTimeAvg": 957.094776923077,
"serviceTimeMin": 215.24,
"serviceTimeMax": 1697.3612
},
{
"name": "Samir Solanki",
"userId": "/users/56eaec62baf08b06e46d27fd",
"callCountSuccess": 0,
"callCountBlocked": 0,
"callCountFailed": 0,
"callCountOther": 0,
"callCountTotal": 0,
"bandwidth": 0,
"cacheHitCount": 0,
"cacheMissCount": 0,
"apiTimeAvg": 0,
"apiTimeMin": 0,
"apiTimeMax": 0,
"serviceTimeAvg": 0,
"serviceTimeMin": 0,
"serviceTimeMax": 0
},
{
"name": "Anonymous",
"userId": "/users/54c800b332965a0035030000",
"callCountSuccess": 0,
"callCountBlocked": 0,
"callCountFailed": 0,
"callCountOther": 0,
"callCountTotal": 0,
"bandwidth": 0,
"cacheHitCount": 0,
"cacheMissCount": 0,
"apiTimeAvg": 0,
"apiTimeMin": 0,
"apiTimeMax": 0,
"serviceTimeAvg": 0,
"serviceTimeMin": 0,
"serviceTimeMax": 0
}
],
"count": 3,
"nextLink": ""
}
Tanımlar
Name | Description |
---|---|
Error |
Hata Alanı sözleşmesi. |
Error |
Hata Yanıtı. |
Report |
Sayfalanmış Rapor kayıtları listesi gösterimi. |
Report |
Rapor verileri. |
ErrorFieldContract
Hata Alanı sözleşmesi.
Name | Tür | Description |
---|---|---|
code |
string |
Özellik düzeyi hata kodu. |
message |
string |
Özellik düzeyi hatanın insan tarafından okunabilir gösterimi. |
target |
string |
Özellik adı. |
ErrorResponse
Hata Yanıtı.
Name | Tür | Description |
---|---|---|
error.code |
string |
Hizmet tanımlı hata kodu. Bu kod, yanıtta belirtilen HTTP hata kodu için bir alt durum görevi görür. |
error.details |
Doğrulama hatası durumunda istekte gönderilen geçersiz alanların listesi. |
|
error.message |
string |
Hatanın insan tarafından okunabilen gösterimi. |
ReportCollection
Sayfalanmış Rapor kayıtları listesi gösterimi.
Name | Tür | Description |
---|---|---|
count |
integer |
Tüm sayfalardaki toplam kayıt sayısı. |
nextLink |
string |
Varsa sonraki sayfa bağlantısı. |
value |
Sayfa değerleri. |
ReportRecordContract
Rapor verileri.
Name | Tür | Description |
---|---|---|
apiId |
string |
API tanımlayıcı yolu. /apis/{apiId} |
apiRegion |
string |
API bölge tanımlayıcısı. |
apiTimeAvg |
number |
İsteğin işlenmesi için geçen ortalama süre. |
apiTimeMax |
number |
İsteği işlemek için geçen en uzun süre. |
apiTimeMin |
number |
İsteği işlemek için gereken en kısa süre. |
bandwidth |
integer |
Kullanılan bant genişliği. |
cacheHitCount |
integer |
önbellek ilkesinden içeriğin sunulma sayısı. |
cacheMissCount |
integer |
Arka uçtan içeriğin kaç kez getirildiği. |
callCountBlocked |
integer |
Geçersiz kimlik bilgileri nedeniyle engellenen çağrı sayısı. Bu, HttpStatusCode.Unauthorized ve HttpStatusCode.Forbidden ve HttpStatusCode.TooManyRequests döndüren çağrıları içerir |
callCountFailed |
integer |
Ağ geçidi veya arka uç hataları nedeniyle başarısız olan çağrı sayısı. Buna HttpStatusCode.BadRequest(400) döndüren çağrılar ve HttpStatusCode.InternalServerError (500) ile 600 arasındaki herhangi bir Kod dahildir |
callCountOther |
integer |
Diğer aramaların sayısı. |
callCountSuccess |
integer |
Başarılı çağrı sayısı. Bu, HttpStatusCode <= 301 ve HttpStatusCode.NotModified ve HttpStatusCode.TemporaryRedirect döndüren çağrıları içerir |
callCountTotal |
integer |
Toplam arama sayısı. |
country |
string |
Bu kayıt verilerinin ilişkili olduğu ülke. |
interval |
string |
Toplama döneminin uzunluğu. Aralık 15 dakikanın katı olmalı ve sıfır olmayabilir. Değer ISO 8601 biçiminde olmalıdır (http://en.wikipedia.org/wiki/ISO_8601#Durations). |
name |
string |
Rapor uç noktasına bağlı olarak ad ürün, API, işlem veya geliştirici adını belirtir. |
operationId |
string |
İşlem tanımlayıcı yolu. /apis/{apiId}/operations/{operationId} |
productId |
string |
Ürün tanımlayıcı yolu. /products/{productId} |
region |
string |
Bu kayıt verilerinin ilişkili olduğu ülke bölgesi. |
serviceTimeAvg |
number |
Arka uçta isteğin işlenmesi için geçen ortalama süre. |
serviceTimeMax |
number |
Arka uçta isteğin işlenmesi için geçen en uzun süre. |
serviceTimeMin |
number |
Arka uçta isteğin işlenmesi için geçen en kısa süre. |
subscriptionId |
string |
Abonelik tanımlayıcı yolu. /subscriptions/{subscriptionId} |
timestamp |
string |
Toplama döneminin başlangıcı. Tarih şu biçime uygundur: |
userId |
string |
Kullanıcı tanımlayıcı yolu. /users/{userId} |
zip |
string |
Bu kayıt verilerinin ilişkili olduğu posta kodu. |