Gateway Hostname Configuration - Create Or Update

Bir Ağ Geçidi için güncelleştirme ana bilgisayar adı yapılandırması oluşturur.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/gateways/{gatewayId}/hostnameConfigurations/{hcId}?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

hcId
path True

string

Ağ geçidi ana bilgisayar adı yapılandırma tanımlayıcısı. Üst Ağ Geçidi varlığı kapsamında benzersiz olmalı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ü.

İstek Başlığı

Name Gerekli Tür Description
If-Match

string

Varlığın ETag'i. Varlık oluştururken gerekli değildir, ancak varlığı güncelleştirirken gereklidir.

İstek Gövdesi

Name Tür Description
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

Yanıtlar

Name Tür Description
200 OK

GatewayHostnameConfigurationContract

Ağ Geçidi ana bilgisayar adı yapılandırma ayrıntıları başarıyla güncelleştirildi.

Headers

ETag: string

201 Created

GatewayHostnameConfigurationContract

Yeni Ağ Geçidi ana bilgisayar adı yapılandırması başarıyla oluşturuldu.

Headers

ETag: string

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

ApiManagementCreateGatewayHostnameConfiguration

Sample Request

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

{
  "properties": {
    "hostname": "*",
    "certificateId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/certificates/cert1",
    "negotiateClientCertificate": false,
    "tls10Enabled": false,
    "tls11Enabled": false,
    "http2Enabled": true
  }
}

Sample Response

{
  "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,
    "tls10Enabled": false,
    "tls11Enabled": false,
    "http2Enabled": true
  }
}
{
  "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,
    "tls10Enabled": false,
    "tls11Enabled": false,
    "http2Enabled": true
  }
}

Tanımlar

Name Description
ErrorFieldContract

Hata Alanı sözleşmesi.

ErrorResponse

Hata Yanıtı.

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.

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"