Udostępnij za pośrednictwem


Apis - Get

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

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}?api-version=2022-08-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
apiId
path True

string

Identyfikator poprawki interfejsu API. Musi być unikatowa w bieżącym wystąpieniu usługi API Management. Nieobsługiwana poprawka ma wartość ; rev=n jako sufiks, gdzie n jest numerem poprawki.

Wzorzec wyrażenia regularnego: ^[^*#&+:<>?]+$

resourceGroupName
path True

string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

serviceName
path True

string

Nazwa usługi API Management.

Wzorzec wyrażenia regularnego: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True

string

Identyfikator subskrypcji docelowej.

api-version
query True

string

Wersja interfejsu API do użycia dla tej operacji.

Odpowiedzi

Nazwa Typ Opis
200 OK

ApiContract

Treść odpowiedzi zawiera określoną jednostkę interfejsu API.

Nagłówki

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.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa Opis
user_impersonation personifikacja konta użytkownika

Przykłady

ApiManagementGetApiContract
ApiManagementGetApiRevisionContract

ApiManagementGetApiContract

Przykładowe żądanie

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a?api-version=2022-08-01

Przykładowa odpowiedź

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a",
  "type": "Microsoft.ApiManagement/service/apis",
  "name": "57d1f7558aa04f15146d9d8a",
  "properties": {
    "displayName": "Service",
    "apiRevision": "1",
    "serviceUrl": "https://api.plexonline.com/DataSource/Service.asmx",
    "path": "schulte",
    "protocols": [
      "https"
    ],
    "authenticationSettings": {
      "oAuth2": {
        "authorizationServerId": "authorizationServerId2283",
        "scope": "oauth2scope2580"
      },
      "oAuth2AuthenticationSettings": [
        {
          "authorizationServerId": "authorizationServerId2283",
          "scope": "oauth2scope2580"
        },
        {
          "authorizationServerId": "authorizationServerId2284",
          "scope": "oauth2scope2581"
        }
      ]
    },
    "subscriptionKeyParameterNames": {
      "header": "Ocp-Apim-Subscription-Key",
      "query": "subscription-key"
    },
    "type": "soap",
    "isCurrent": true,
    "isOnline": true
  }
}

ApiManagementGetApiRevisionContract

Przykładowe żądanie

GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echo-api;rev=3?api-version=2022-08-01

Przykładowa odpowiedź

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echo-api;rev=3",
  "type": "Microsoft.ApiManagement/service/apis",
  "name": "echo-api;rev=3",
  "properties": {
    "displayName": "Service",
    "apiRevision": "3",
    "serviceUrl": "https://api.plexonline.com/DataSource/Service.asmx",
    "path": "schulte",
    "protocols": [
      "https"
    ],
    "authenticationSettings": {
      "oAuth2": {
        "authorizationServerId": "authorizationServerId2283",
        "scope": "oauth2scope2580"
      },
      "oAuth2AuthenticationSettings": [
        {
          "authorizationServerId": "authorizationServerId2283",
          "scope": "oauth2scope2580"
        },
        {
          "authorizationServerId": "authorizationServerId2284",
          "scope": "oauth2scope2581"
        }
      ]
    },
    "subscriptionKeyParameterNames": {
      "header": "Ocp-Apim-Subscription-Key",
      "query": "subscription-key"
    },
    "apiRevisionDescription": "fixed bug in contract"
  }
}

Definicje

Nazwa Opis
ApiContactInformation

Informacje kontaktowe interfejsu API

ApiContract

Szczegóły interfejsu API.

ApiLicenseInformation

Informacje o licencji interfejsu API

ApiType

Typ interfejsu API.

ApiVersionSetContractDetails

Zestaw wersji interfejsu API zawiera wspólną konfigurację zestawu wersji interfejsu API dotyczących

AuthenticationSettingsContract

Ustawienia uwierzytelniania interfejsu API.

bearerTokenSendingMethods

Jak wysłać token do serwera.

ErrorFieldContract

Błąd Kontrakt pola.

ErrorResponse

Odpowiedź na błąd.

OAuth2AuthenticationSettingsContract

Szczegóły ustawień uwierzytelniania OAuth2 interfejsu API.

OpenIdAuthenticationSettingsContract

Szczegóły ustawień uwierzytelniania OAuth2 interfejsu API.

Protocol

Opisuje, na których protokołach można wywołać operacje w tym interfejsie API.

SubscriptionKeyParameterNamesContract

Szczegóły nazw parametrów klucza subskrypcji.

versioningScheme

Wartość określająca, gdzie identyfikator wersji interfejsu API będzie znajdować się w żądaniu HTTP.

ApiContactInformation

Informacje kontaktowe interfejsu API

Nazwa Typ Opis
email

string

Adres e-mail osoby kontaktowej/organizacji. MUSI być w formacie adresu e-mail

name

string

Nazwa identyfikująca osoby kontaktowej/organizacji

url

string

Adres URL wskazujący informacje kontaktowe. MUSI być w formacie adresu URL

ApiContract

Szczegóły interfejsu API.

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.apiRevision

string

Opisuje poprawkę interfejsu API. Jeśli nie podano żadnej wartości, zostanie utworzona domyślna poprawka 1

properties.apiRevisionDescription

string

Opis poprawki interfejsu API.

properties.apiVersion

string

Wskazuje identyfikator wersji interfejsu API, jeśli interfejs API jest w wersji

properties.apiVersionDescription

string

Opis wersji interfejsu API.

properties.apiVersionSet

ApiVersionSetContractDetails

Szczegóły zestawu wersji

properties.apiVersionSetId

string

Identyfikator zasobu powiązanego elementu ApiVersionSet.

properties.authenticationSettings

AuthenticationSettingsContract

Kolekcja ustawień uwierzytelniania uwzględnionych w tym interfejsie API.

properties.contact

ApiContactInformation

Informacje kontaktowe dotyczące interfejsu API.

properties.description

string

Opis interfejsu API. Może zawierać tagi formatowania HTML.

properties.displayName

string

Nazwa interfejsu API. Musi mieć długość od 1 do 300 znaków.

properties.isCurrent

boolean

Wskazuje, czy poprawka interfejsu API jest bieżącą poprawką interfejsu API.

properties.isOnline

boolean

Wskazuje, czy poprawka interfejsu API jest dostępna za pośrednictwem bramy.

properties.license

ApiLicenseInformation

Informacje o licencji interfejsu API.

properties.path

string

Względny adres URL jednoznacznie identyfikujący ten interfejs API i wszystkie jego ścieżki zasobów w wystąpieniu usługi API Management. Jest on dołączany do podstawowego adresu URL punktu końcowego interfejsu API określonego podczas tworzenia wystąpienia usługi w celu utworzenia publicznego adresu URL dla tego interfejsu API.

properties.protocols

Protocol[]

Opisuje, na których protokołach można wywołać operacje w tym interfejsie API.

properties.serviceUrl

string

Bezwzględny adres URL usługi zaplecza implementowania tego interfejsu API. Nie można mieć więcej niż 2000 znaków.

properties.sourceApiId

string

Identyfikator interfejsu API źródłowego.

properties.subscriptionKeyParameterNames

SubscriptionKeyParameterNamesContract

Protokoły, za pośrednictwem których udostępniany jest interfejs API.

properties.subscriptionRequired

boolean

Określa, czy do uzyskiwania dostępu do interfejsu API jest wymagana subskrypcja interfejsu API lub produktu.

properties.termsOfServiceUrl

string

Adres URL do warunków użytkowania interfejsu API. MUSI być w formacie adresu URL.

properties.type

ApiType

Typ interfejsu API.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ApiLicenseInformation

Informacje o licencji interfejsu API

Nazwa Typ Opis
name

string

Nazwa licencji używana dla interfejsu API

url

string

Adres URL licencji używanej dla interfejsu API. MUSI być w formacie adresu URL

ApiType

Typ interfejsu API.

Nazwa Typ Opis
graphql

string

http

string

soap

string

websocket

string

ApiVersionSetContractDetails

Zestaw wersji interfejsu API zawiera wspólną konfigurację zestawu wersji interfejsu API dotyczących

Nazwa Typ Opis
description

string

Opis zestawu wersji interfejsu API.

id

string

Identyfikator istniejącego zestawu wersji interfejsu API. Pomiń tę wartość, aby utworzyć nowy zestaw wersji.

name

string

Wyświetlana nazwa zestawu wersji interfejsu API.

versionHeaderName

string

Nazwa parametru nagłówka HTTP wskazująca wersję interfejsu API, jeśli parametr versioningScheme ma wartość header.

versionQueryName

string

Nazwa parametru zapytania, który wskazuje wersję interfejsu API, jeśli opcja VersioningScheme jest ustawiona na querywartość .

versioningScheme

versioningScheme

Wartość określająca, gdzie identyfikator wersji interfejsu API będzie znajdować się w żądaniu HTTP.

AuthenticationSettingsContract

Ustawienia uwierzytelniania interfejsu API.

Nazwa Typ Opis
oAuth2

OAuth2AuthenticationSettingsContract

Ustawienia uwierzytelniania OAuth2

oAuth2AuthenticationSettings

OAuth2AuthenticationSettingsContract[]

Kolekcja ustawień uwierzytelniania OAuth2 uwzględnionych w tym interfejsie API.

openid

OpenIdAuthenticationSettingsContract

Ustawienia uwierzytelniania openID Connect

openidAuthenticationSettings

OpenIdAuthenticationSettingsContract[]

Kolekcja ustawień uwierzytelniania open ID Connect uwzględnionych w tym interfejsie API.

bearerTokenSendingMethods

Jak wysłać token do serwera.

Nazwa Typ Opis
authorizationHeader

string

Token dostępu zostanie przesłany w nagłówku Autoryzacja przy użyciu schematu elementu nośnego

query

string

Token dostępu zostanie przesłany jako parametry zapytania.

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 wysyłanych w żądaniu w przypadku błędu walidacji.

error.message

string

Czytelna dla człowieka reprezentacja błędu.

OAuth2AuthenticationSettingsContract

Szczegóły ustawień uwierzytelniania OAuth2 interfejsu API.

Nazwa Typ Opis
authorizationServerId

string

Identyfikator serwera autoryzacji OAuth.

scope

string

zakres operacji.

OpenIdAuthenticationSettingsContract

Szczegóły ustawień uwierzytelniania OAuth2 interfejsu API.

Nazwa Typ Opis
bearerTokenSendingMethods

bearerTokenSendingMethods[]

Jak wysłać token do serwera.

openidProviderId

string

Identyfikator serwera autoryzacji OAuth.

Protocol

Opisuje, na których protokołach można wywołać operacje w tym interfejsie API.

Nazwa Typ Opis
http

string

https

string

ws

string

wss

string

SubscriptionKeyParameterNamesContract

Szczegóły nazw parametrów klucza subskrypcji.

Nazwa Typ Opis
header

string

Nazwa nagłówka klucza subskrypcji.

query

string

Nazwa parametru ciągu zapytania klucza subskrypcji.

versioningScheme

Wartość określająca, gdzie identyfikator wersji interfejsu API będzie znajdować się w żądaniu HTTP.

Nazwa Typ Opis
Header

string

Wersja interfejsu API jest przekazywana w nagłówku HTTP.

Query

string

Wersja interfejsu API jest przekazywana w parametrze zapytania.

Segment

string

Wersja interfejsu API jest przekazywana w segmencie ścieżki.