Apis - Get
Tanımlayıcısı tarafından belirtilen API'nin ayrıntılarını alır.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}?api-version=2022-08-01
URI Parametreleri
Name | İçinde | Gerekli | Tür | Description |
---|---|---|---|---|
api
|
path | True |
string |
API düzeltme tanımlayıcısı. Geçerli API Management hizmet örneğinde benzersiz olmalıdır. Geçerli olmayan düzeltmede ; rev=n sonek olarak, burada n düzeltme numarasıdır. Normal ifade deseni: |
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. |
api-version
|
query | True |
string |
Bu işlem için kullanılacak API sürümü. |
Yanıtlar
Name | Tür | Description |
---|---|---|
200 OK |
Yanıt gövdesi belirtilen API varlığını içerir. Üst Bilgiler ETag: string |
|
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
Api |
Api |
ApiManagementGetApiContract
Örnek isteği
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a?api-version=2022-08-01
Örnek yanıt
{
"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
Örnek isteği
GET https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/echo-api;rev=3?api-version=2022-08-01
Örnek yanıt
{
"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"
}
}
Tanımlar
Name | Description |
---|---|
Api |
API iletişim bilgileri |
Api |
API ayrıntıları. |
Api |
API lisans bilgileri |
Api |
API türü. |
Api |
API Sürüm Kümesi, ilgili API Sürümleri kümesi için ortak yapılandırmayı içerir |
Authentication |
API Kimlik Doğrulama Ayarları. |
bearer |
Sunucuya belirteç gönderme. |
Error |
Hata Alanı sözleşmesi. |
Error |
Hata Yanıtı. |
OAuth2Authentication |
API OAuth2 Kimlik Doğrulama ayarları ayrıntıları. |
Open |
API OAuth2 Kimlik Doğrulama ayarları ayrıntıları. |
Protocol |
Bu API'deki işlemlerin hangi protokollerin çağrılabileceğini açıklar. |
Subscription |
Abonelik anahtarı parametre adları ayrıntıları. |
versioning |
API Sürüm tanımlayıcısının HTTP isteğinde nerede bulunacağını belirleyen bir değer. |
ApiContactInformation
API iletişim bilgileri
Name | Tür | Description |
---|---|---|
string |
İlgili kişinin/kuruluşun e-posta adresi. E-posta adresi biçiminde OLMALıDıR |
|
name |
string |
İlgili kişinin/kuruluşun tanımlayıcı adı |
url |
string |
Kişi bilgilerine işaret eden URL. URL biçiminde olmalıdır |
ApiContract
API ayrıntıları.
Name | Tür | Description |
---|---|---|
id |
string |
Kaynağın tam kaynak kimliği. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Kaynağın adı |
properties.apiRevision |
string |
API'nin düzeltmesini açıklar. Değer sağlanmazsa varsayılan düzeltme 1 oluşturulur |
properties.apiRevisionDescription |
string |
API Düzeltmesi'nin açıklaması. |
properties.apiVersion |
string |
API sürümlendiyse API'nin sürüm tanımlayıcısını gösterir |
properties.apiVersionDescription |
string |
API Sürümünün Açıklaması. |
properties.apiVersionSet |
Sürüm kümesi ayrıntıları |
|
properties.apiVersionSetId |
string |
İlgili ApiVersionSet için kaynak tanımlayıcısı. |
properties.authenticationSettings |
Bu API'ye dahil edilen kimlik doğrulama ayarlarının koleksiyonu. |
|
properties.contact |
API için iletişim bilgileri. |
|
properties.description |
string |
API'nin açıklaması. HTML biçimlendirme etiketlerini içerebilir. |
properties.displayName |
string |
API adı. 1 ile 300 karakter uzunluğunda olmalıdır. |
properties.isCurrent |
boolean |
API düzeltmenin geçerli API düzeltmesi olup olmadığını gösterir. |
properties.isOnline |
boolean |
API düzeltmesine ağ geçidi üzerinden erişilip erişilmediğini gösterir. |
properties.license |
API için lisans bilgileri. |
|
properties.path |
string |
Bu API'yi ve API Management hizmet örneği içindeki tüm kaynak yollarını benzersiz olarak tanımlayan göreli URL. Bu API'nin genel URL'sini oluşturmak için hizmet örneği oluşturma sırasında belirtilen API uç noktası temel URL'sine eklenir. |
properties.protocols |
Protocol[] |
Bu API'deki işlemlerin hangi protokollerin çağrılabileceğini açıklar. |
properties.serviceUrl |
string |
Bu API'yi uygulayan arka uç hizmetinin mutlak URL'si. 2000 karakterden uzun olamaz. |
properties.sourceApiId |
string |
Kaynak API'nin API tanımlayıcısı. |
properties.subscriptionKeyParameterNames |
API'nin kullanılabilir hale getirildiği protokoller. |
|
properties.subscriptionRequired |
boolean |
API'ye erişmek için bir API'nin mi yoksa Ürün aboneliğinin mi gerekli olduğunu belirtir. |
properties.termsOfServiceUrl |
string |
API için Hizmet Koşulları'nın URL'si. URL biçiminde OLMALıDıR. |
properties.type |
API türü. |
|
type |
string |
Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts" |
ApiLicenseInformation
API lisans bilgileri
Name | Tür | Description |
---|---|---|
name |
string |
API için kullanılan lisans adı |
url |
string |
API için kullanılan lisansın URL'si. URL biçiminde olmalıdır |
ApiType
API türü.
Name | Tür | Description |
---|---|---|
graphql |
string |
|
http |
string |
|
soap |
string |
|
websocket |
string |
ApiVersionSetContractDetails
API Sürüm Kümesi, ilgili API Sürümleri kümesi için ortak yapılandırmayı içerir
Name | Tür | Description |
---|---|---|
description |
string |
API Sürüm Kümesi açıklaması. |
id |
string |
Mevcut API Sürüm Kümesi tanımlayıcısı. Yeni bir Sürüm Kümesi oluşturmak için bu değeri atla. |
name |
string |
API Sürüm Kümesinin görünen Adı. |
versionHeaderName |
string |
VersioningScheme olarak ayarlandıysa |
versionQueryName |
string |
VersioningScheme olarak ayarlandıysa |
versioningScheme |
API Sürüm tanımlayıcısının HTTP isteğinde nerede bulunacağını belirleyen bir değer. |
AuthenticationSettingsContract
API Kimlik Doğrulama Ayarları.
Name | Tür | Description |
---|---|---|
oAuth2 |
OAuth2 Kimlik Doğrulama ayarları |
|
oAuth2AuthenticationSettings |
Bu API'ye dahil edilen OAuth2 kimlik doğrulama ayarlarının koleksiyonu. |
|
openid |
OpenID Connect Kimlik Doğrulama Ayarları |
|
openidAuthenticationSettings |
Bu API'ye dahil edilen Open ID Connect kimlik doğrulama ayarlarının koleksiyonu. |
bearerTokenSendingMethods
Sunucuya belirteç gönderme.
Name | Tür | Description |
---|---|---|
authorizationHeader |
string |
Erişim belirteci Taşıyıcı şeması kullanılarak Yetkilendirme üst bilgisinde iletilir |
query |
string |
Erişim belirteci sorgu parametreleri olarak iletilir. |
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. |
OAuth2AuthenticationSettingsContract
API OAuth2 Kimlik Doğrulama ayarları ayrıntıları.
Name | Tür | Description |
---|---|---|
authorizationServerId |
string |
OAuth yetkilendirme sunucusu tanımlayıcısı. |
scope |
string |
işlem kapsamı. |
OpenIdAuthenticationSettingsContract
API OAuth2 Kimlik Doğrulama ayarları ayrıntıları.
Name | Tür | Description |
---|---|---|
bearerTokenSendingMethods |
Sunucuya belirteç gönderme. |
|
openidProviderId |
string |
OAuth yetkilendirme sunucusu tanımlayıcısı. |
Protocol
Bu API'deki işlemlerin hangi protokollerin çağrılabileceğini açıklar.
Name | Tür | Description |
---|---|---|
http |
string |
|
https |
string |
|
ws |
string |
|
wss |
string |
SubscriptionKeyParameterNamesContract
Abonelik anahtarı parametre adları ayrıntıları.
Name | Tür | Description |
---|---|---|
header |
string |
Abonelik anahtarı üst bilgi adı. |
query |
string |
Abonelik anahtarı sorgu dizesi parametre adı. |
versioningScheme
API Sürüm tanımlayıcısının HTTP isteğinde nerede bulunacağını belirleyen bir değer.
Name | Tür | Description |
---|---|---|
Header |
string |
API Sürümü bir HTTP üst bilgisinde geçirilir. |
Query |
string |
API Sürümü bir sorgu parametresinde geçirilir. |
Segment |
string |
API Sürümü bir yol kesiminde geçirilir. |