Api Diagnostic - Get

Odwołanie

Service:: API Management

API Version:: 2023-03-01-preview

Pobiera szczegóły diagnostyki dla interfejsu API określonego przez jego identyfikator.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/diagnostics/{diagnosticId}?api-version=2023-03-01-preview

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
apiId	path	True	string	Identyfikator interfejsu API. Musi być unikatowa w bieżącym wystąpieniu usługi API Management.
diagnosticId	path	True	string	Identyfikator diagnostyczny. Musi być unikatowa w bieżącym wystąpieniu usługi API Management. Regex pattern: `^[^*#&+:<>?]+$`
resourceGroupName	path	True	string	Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.
serviceName	path	True	string	Nazwa usługi API Management. Regex pattern: `^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$`
subscriptionId	path	True	string uuid	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string	Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	DiagnosticContract	Treść odpowiedzi zawiera określoną jednostkę diagnostyczną. Headers ETag: string
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Nazwa

Typ

Opis

200 OK

DiagnosticContract

Treść odpowiedzi zawiera określoną jednostkę diagnostyczną.

Headers

ETag: string

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

ApiManagementGetApiDiagnostic

Sample Request

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/diagnostics/applicationinsights?api-version=2023-03-01-preview

Sample Response

Status code:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echo-api/diagnostics/applicationinsights",
  "type": "Microsoft.ApiManagement/service/apis/diagnostics",
  "name": "applicationinsights",
  "properties": {
    "alwaysLog": "allErrors",
    "httpCorrelationProtocol": "Legacy",
    "logClientIp": true,
    "loggerId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/loggers/aisamplingtest",
    "sampling": {
      "samplingType": "fixed",
      "percentage": 100
    },
    "frontend": {
      "request": {
        "headers": [],
        "body": {
          "bytes": 100
        }
      },
      "response": {
        "headers": [],
        "body": {
          "bytes": 100
        }
      }
    },
    "backend": {
      "request": {
        "headers": [],
        "body": {
          "bytes": 100
        }
      },
      "response": {
        "headers": [],
        "body": {
          "bytes": 100
        }
      }
    }
  }
}

Definicje

Nazwa	Opis
AlwaysLog	Określa, jakiego typu ustawienia próbkowania komunikatów nie powinny być stosowane.
BodyDiagnosticSettings	Ustawienia rejestrowania treści.
DataMasking
DataMaskingEntity
DataMaskingMode	Tryb maskowania danych.
DiagnosticContract	Szczegóły diagnostyczne.
ErrorFieldContract	Błąd Kontrakt pola.
ErrorResponse	Odpowiedź na błąd.
HttpCorrelationProtocol	Ustawia protokół korelacji do użycia na potrzeby diagnostyki usługi Application Insights.
HttpMessageDiagnostic	Ustawienia diagnostyczne komunikatu HTTP.
OperationNameFormat	Format nazwy operacji dla telemetrii usługi Application Insights. Wartość domyślna to Nazwa.
PipelineDiagnosticSettings	Ustawienia diagnostyczne dla przychodzących/wychodzących komunikatów HTTP do bramy.
SamplingSettings	Ustawienia próbkowania dla diagnostyki.
SamplingType	Typ próbkowania.
Verbosity	Poziom szczegółowości stosowany do śladów emitowanych przez zasady śledzenia.

AlwaysLog

Określa, jakiego typu ustawienia próbkowania komunikatów nie powinny być stosowane.

Nazwa	Typ	Opis
allErrors	string	Zawsze rejestruj wszystkie błędne żądanie niezależnie od ustawień próbkowania.

BodyDiagnosticSettings

Ustawienia rejestrowania treści.

Nazwa	Typ	Opis
bytes	integer	Liczba bajtów treści żądania do zarejestrowania.

DataMasking

Nazwa	Typ	Opis
headers	DataMaskingEntity[]	Ustawienia maskowania nagłówków
queryParams	DataMaskingEntity[]	Ustawienia maskowania parametrów zapytania adresu URL

DataMaskingEntity

Nazwa	Typ	Opis
mode	DataMaskingMode	Tryb maskowania danych.
value	string	Nazwa jednostki do maskowania (np. nazwa nagłówka lub parametru zapytania).

DataMaskingMode

Tryb maskowania danych.

Nazwa	Typ	Opis
Hide	string	Ukryj obecność jednostki.
Mask	string	Maskuj wartość jednostki.

DiagnosticContract

Szczegóły diagnostyczne.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nazwa zasobu
properties.alwaysLog	AlwaysLog	Określa, jakiego typu ustawienia próbkowania komunikatów nie powinny być stosowane.
properties.backend	PipelineDiagnosticSettings	Ustawienia diagnostyczne dla przychodzących/wychodzących komunikatów HTTP do zaplecza
properties.frontend	PipelineDiagnosticSettings	Ustawienia diagnostyczne dla przychodzących/wychodzących komunikatów HTTP do bramy.
properties.httpCorrelationProtocol	HttpCorrelationProtocol	Ustawia protokół korelacji do użycia na potrzeby diagnostyki usługi Application Insights.
properties.logClientIp	boolean	Zarejestruj element ClientIP. Wartość domyślna to false.
properties.loggerId	string	Identyfikator zasobu docelowego rejestratora.
properties.metrics	boolean	Emituj metryki niestandardowe za pośrednictwem zasad emisji metryk. Dotyczy tylko ustawień diagnostycznych usługi Application Insights.
properties.operationNameFormat	OperationNameFormat	Format nazwy operacji dla telemetrii usługi Application Insights. Wartość domyślna to Nazwa.
properties.sampling	SamplingSettings	Ustawienia próbkowania dla diagnostyki.
properties.verbosity	Verbosity	Poziom szczegółowości stosowany do śladów emitowanych przez zasady śledzenia.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ErrorFieldContract

Błąd Kontrakt pola.

Nazwa	Typ	Opis
code	string	Kod błędu poziomu właściwości.
message	string	Czytelna dla człowieka reprezentacja błędu na poziomie właściwości.
target	string	Nazwa właściwości.

ErrorResponse

Odpowiedź na błąd.

Nazwa	Typ	Opis
error.code	string	Kod błędu zdefiniowany przez usługę. Ten kod służy jako podstan kodu błędu HTTP określonego w odpowiedzi.
error.details	ErrorFieldContract[]	Lista nieprawidłowych pól jest wysyłana w żądaniu w przypadku błędu walidacji.
error.message	string	Czytelna dla człowieka reprezentacja błędu.

HttpCorrelationProtocol

Ustawia protokół korelacji do użycia na potrzeby diagnostyki usługi Application Insights.

Nazwa	Typ	Opis
Legacy	string	Wstrzykiwanie nagłówków Request-Id i Request-Context przy użyciu danych korelacji żądań. Zobacz: .
None	string	Nie należy odczytywać i wstrzykiwać nagłówków korelacji.
W3C	string	Wstrzykiwanie nagłówków kontekstu śledzenia. Zobacz: .

HttpMessageDiagnostic

Ustawienia diagnostyczne komunikatu HTTP.

Nazwa	Typ	Opis
body	BodyDiagnosticSettings	Ustawienia rejestrowania treści.
dataMasking	DataMasking	Ustawienia maskowania danych.
headers	string[]	Tablica nagłówków HTTP do rejestrowania.

OperationNameFormat

Format nazwy operacji dla telemetrii usługi Application Insights. Wartość domyślna to Nazwa.

Nazwa	Typ	Opis
Name	string	API_NAME;rev=API_REVISION — OPERATION_NAME
Url	string	HTTP_VERB URL

PipelineDiagnosticSettings

Ustawienia diagnostyczne dla przychodzących/wychodzących komunikatów HTTP do bramy.

Nazwa	Typ	Opis
request	HttpMessageDiagnostic	Ustawienia diagnostyczne dla żądania.
response	HttpMessageDiagnostic	Ustawienia diagnostyczne odpowiedzi.

SamplingSettings

Ustawienia próbkowania dla diagnostyki.

Nazwa	Typ	Opis
percentage	number	Częstotliwość próbkowania dla próbkowania o stałej szybkości.
samplingType	SamplingType	Typ próbkowania.

SamplingType

Typ próbkowania.

Nazwa	Typ	Opis
fixed	string	Próbkowanie o stałej szybkości.

Verbosity

Poziom szczegółowości stosowany do śladów emitowanych przez zasady śledzenia.

Nazwa	Typ	Opis
error	string	Tylko ślady o ważności ustawione na wartość "błąd" będą wysyłane do rejestratora dołączonego do tego wystąpienia diagnostycznego.
information	string	Ślady z ustawioną ważnością na "informacje" i "błąd" zostaną wysłane do rejestratora dołączonego do tego wystąpienia diagnostycznego.
verbose	string	Wszystkie ślady emitowane przez zasady śledzenia zostaną wysłane do rejestratora dołączonego do tego wystąpienia diagnostycznego.

Api Diagnostic - Get

Parametry identyfikatora URI

Odpowiedzi

Zabezpieczenia

azure_auth

Scopes

Przykłady

ApiManagementGetApiDiagnostic

Sample Request

Sample Response

Definicje

AlwaysLog

BodyDiagnosticSettings

DataMasking

DataMaskingEntity

DataMaskingMode

DiagnosticContract

ErrorFieldContract

ErrorResponse

HttpCorrelationProtocol

HttpMessageDiagnostic

OperationNameFormat

PipelineDiagnosticSettings

SamplingSettings

SamplingType

Verbosity

Dodatkowe zasoby