Gateway Hostname Configuration - List By Service

Belirtilen ağ geçidi için konak adı yapılandırmaları koleksiyonunu listeler.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/hostnameConfigurations?api-version=2022-08-01
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/hostnameConfigurations?$filter={$filter}&$top={$top}&$skip={$skip}&api-version=2022-08-01

URI Parametreleri

Name İçinde Gerekli Tür Description
gatewayId
path True

string

Ağ geçidi varlık tanımlayıcısı. Geçerli API Management hizmet örneğinde benzersiz olmalıdır. 'Managed' değerine sahip olmamalıdır

resourceGroupName
path True

string

Kaynak grubunun adı. Ad büyük/küçük harfe duyarlı değildir.

serviceName
path True

string

API Management hizmetinin adı.

Regex pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$

subscriptionId
path True

string

Hedef aboneliğin kimliği.

api-version
query True

string

Bu işlem için kullanılacak API sürümü.

$filter
query

string

| Alan | Kullanım | Desteklenen işleçler | Desteklenen işlevler |
|-------------|-------------|-------------|-------------|
| ad | filtre | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |
| ana bilgisayar adı | filtre | ge, le, eq, ne, gt, lt | substringof, contains, startswith, endswith |

$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

GatewayHostnameConfigurationCollection

Konak adı yapılandırma varlıklarının koleksiyonu.

Other Status Codes

ErrorResponse

İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

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

Scopes

Name Description
user_impersonation kullanıcı hesabınızın kimliğine bürünme

Örnekler

ApiManagementListGatewayHostnameConfigurations

Sample Request

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

Sample Response

{
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/hostnameConfigurations/default",
      "type": "Microsoft.ApiManagement/service/gateways/hostnameConfigurations",
      "name": "default",
      "properties": {
        "hostname": "*",
        "certificateId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1",
        "negotiateClientCertificate": false
      }
    },
    {
      "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/gateways/gw1/hostnameConfigurations/hostname1",
      "type": "Microsoft.ApiManagement/service/gateways/hostnameConfigurations",
      "name": "default",
      "properties": {
        "hostname": "foo.bar.com",
        "certificateId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert2",
        "negotiateClientCertificate": true
      }
    }
  ],
  "nextLink": ""
}

Tanımlar

Name Description
ErrorFieldContract

Hata Alanı sözleşmesi.

ErrorResponse

Hata Yanıtı.

GatewayHostnameConfigurationCollection

Paged Gateway ana bilgisayar adı yapılandırma listesi gösterimi.

GatewayHostnameConfigurationContract

Ağ geçidi ana bilgisayar adı yapılandırma ayrıntıları.

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

ErrorFieldContract[]

Doğrulama hatası durumunda istekte gönderilen geçersiz alanların listesi.

error.message

string

Hatanın insan tarafından okunabilen gösterimi.

GatewayHostnameConfigurationCollection

Paged Gateway ana bilgisayar adı yapılandırma listesi gösterimi.

Name Tür Description
nextLink

string

Varsa sonraki sayfa bağlantısı.

value

GatewayHostnameConfigurationContract[]

Sayfa değerleri.

GatewayHostnameConfigurationContract

Ağ geçidi ana bilgisayar adı yapılandırma 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.certificateId

string

TLS bağlantısı kurulması için kullanılacak Sertifika varlığının tanımlayıcısı

properties.hostname

string

Ana bilgisayar adı değeri. Geçerli etki alanı adını destekler, kısmi veya tam joker karakter

properties.http2Enabled

boolean

HTTP/2.0'ın desteklenip desteklenmediğini belirtir

properties.negotiateClientCertificate

boolean

Ağ geçidinin istemci sertifikası isteyip istemediğini belirler

properties.tls10Enabled

boolean

TLS 1.0'ın desteklenip desteklenmediğini belirtir

properties.tls11Enabled

boolean

TLS 1.1'in desteklenip desteklenmediğini belirtir

type

string

Kaynağın türü. Örneğin, "Microsoft.Compute/virtualMachines" veya "Microsoft.Storage/storageAccounts"