Gateways - Create Gateway

Hizmet:: Core

API Sürümü:: v1

Bir ağ geçidi oluşturur.

Gerekli Temsilci Kapsamları

Gateway.ReadWrite.All

Microsoft Entra tarafından desteklenen kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Kimlik	Destek
Kullanıcı	Evet
Hizmet sorumlusu ve yönetilen kimlikler	Evet

Arayüz

POST https://api.fabric.microsoft.com/v1/gateways

İstek Gövdesi

CreateVirtualNetworkGatewayRequest

Name	Gerekli	Tür	Description
capacityId	True	string (uuid)	Doku lisans kapasitesinin nesne kimliği.
displayName	True	string	Sanal ağ geçidinin görünen adı. Uzunluk üst sınırı 200 karakterdir.
inactivityMinutesBeforeSleep	True	integer	Sanal ağ geçidi otomatik uyku moduna geçmeden önce geçen işlem yapılmadan geçen dakika sayısı. Şu değerlerden biri olmalıdır: 30, 60, 90, 120, 150, 240, 360, 480, 720, 1440.
numberOfMemberGateways	True	integer	Üye ağ geçitlerinin sayısı. 1 ile 9 arasında bir sayı.
type	True	string: VirtualNetwork	Ağ geçidinin türü.
virtualNetworkAzureResource	True	VirtualNetworkAzureResource	Azure sanal ağ kaynağı.

Yanıtlar

Name Tür Description

201 Created

Name	Tür	Description
201 Created	Gateway: OnPremisesGateway OnPremisesGatewayPersonal VirtualNetworkGateway	Oluşturulan. İşlem başarılı oldu.
429 Too Many Requests	ErrorResponse	Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir `Retry-After` üst bilgi döndürür. Üst Bilgiler Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: DuplicateGatewayName - Ağ geçidi adı zaten kullanılıyor. InvalidCapacityState - Kapasitenin durumu geçersiz. InvalidCapacitySKU - Kapasitenin SKU'su geçersiz. PowerPlatformVirtualNetworkSubnetNotConfiguredForDelegation - Power Platform sanal ağı temsil için yapılandırılmamış.

Gateway:

OnPremisesGateway
OnPremisesGatewayPersonal
VirtualNetworkGateway

Oluşturulan. İşlem başarılı oldu.

429 Too Many Requests

ErrorResponse

Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir Retry-After üst bilgi döndürür.

Üst Bilgiler

Retry-After: integer

Other Status Codes

ErrorResponse

Yaygın hata kodları:

DuplicateGatewayName - Ağ geçidi adı zaten kullanılıyor.
InvalidCapacityState - Kapasitenin durumu geçersiz.
InvalidCapacitySKU - Kapasitenin SKU'su geçersiz.
PowerPlatformVirtualNetworkSubnetNotConfiguredForDelegation - Power Platform sanal ağı temsil için yapılandırılmamış.

Örnekler

Virtual network gateway example

Örnek isteği

HTTP

POST https://api.fabric.microsoft.com/v1/gateways

{
  "type": "VirtualNetwork",
  "displayName": "ContosoVirtualNetworkGateway",
  "capacityId": "ed26b6f3-7bc5-44b0-9565-a8942619ef4c",
  "virtualNetworkAzureResource": {
    "subscriptionId": "879b4ba0-ed17-4ff2-851e-4a2228e00b70",
    "resourceGroupName": "ContosoResourceGroup",
    "virtualNetworkName": "ContosoVirtualNetwork",
    "subnetName": "ContosoSubnet"
  },
  "inactivityMinutesBeforeSleep": 120,
  "numberOfMemberGateways": 3
}

Örnek yanıt

Durum kodu:: 200

{
  "id": "271c5c9a-0860-4927-b1da-ce49008d6565",
  "type": "VirtualNetwork",
  "displayName": "ContosoVirtualNetworkGateway",
  "capacityId": "ed26b6f3-7bc5-44b0-9565-a8942619ef4c",
  "virtualNetworkAzureResource": {
    "subscriptionId": "879b4ba0-ed17-4ff2-851e-4a2228e00b70",
    "resourceGroupName": "ContosoResourceGroup",
    "virtualNetworkName": "ContosoVirtualNetwork",
    "subnetName": "ContosoSubnet"
  },
  "inactivityMinutesBeforeSleep": 120,
  "numberOfMemberGateways": 3
}

Tanımlar

Name	Description
CreateVirtualNetworkGatewayRequest
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
GatewayType	Ağ geçidinin türü. Zaman içinde ek ağ geçidi türleri eklenebilir.
LoadBalancingSetting	Ağ geçidi kümesinin yük dengeleme ayarı. Zaman içinde ek yük dengeleme ayarları eklenebilir.
OnPremisesGateway
OnPremisesGatewayPersonal
PublicKey	Şirket içi ağ geçidinin ortak anahtarı.
VirtualNetworkAzureResource	Sanal Ağ Azure kaynağının özellikleri
VirtualNetworkGateway

CreateVirtualNetworkGatewayRequest

Nesne

Name	Tür	Description
capacityId	string (uuid)	Doku lisans kapasitesinin nesne kimliği.
displayName	string	Sanal ağ geçidinin görünen adı. Uzunluk üst sınırı 200 karakterdir.
inactivityMinutesBeforeSleep	integer	Sanal ağ geçidi otomatik uyku moduna geçmeden önce geçen işlem yapılmadan geçen dakika sayısı. Şu değerlerden biri olmalıdır: 30, 60, 90, 120, 150, 240, 360, 480, 720, 1440.
numberOfMemberGateways	integer	Üye ağ geçitlerinin sayısı. 1 ile 9 arasında bir sayı.
type	string: VirtualNetwork	Ağ geçidinin türü.
virtualNetworkAzureResource	VirtualNetworkAzureResource	Azure sanal ağ kaynağı.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
isRetriable	boolean	True olduğunda istek yeniden denenebilir. Varsa gecikmeyi `Retry-After` belirlemek için yanıt üst bilgisini kullanın.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string (uuid)	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

GatewayType

Numaralandırma

Ağ geçidinin türü. Zaman içinde ek ağ geçidi türleri eklenebilir.

Değer	Description
OnPremises	Şirket içi ağ geçidi.
OnPremisesPersonal	Şirket içi ağ geçidi (kişisel mod).
VirtualNetwork	Sanal ağ geçidi.

LoadBalancingSetting

Numaralandırma

Ağ geçidi kümesinin yük dengeleme ayarı. Zaman içinde ek yük dengeleme ayarları eklenebilir.

Değer	Description
Failover	İstekler kullanılabilir ilk ağ geçidi kümesi üyesine gönderilir.
DistributeEvenly	İstekler, etkinleştirilen tüm ağ geçidi kümesi üyeleri arasında eşit olarak dağıtılır.

OnPremisesGateway

Nesne

Name	Tür	Description
allowCloudConnectionRefresh	boolean	Bulut bağlantılarının bu şirket içi ağ geçidi aracılığıyla yenilenmesine izin verilip verilmeyeceği. True - İzin Ver, Yanlış - İzin verme.
allowCustomConnectors	boolean	Özel bağlayıcıların bu şirket içi ağ geçidiyle kullanılmasına izin verilip verilmeyeceği. True - İzin Ver, Yanlış - İzin verme.
displayName	string	Şirket içi ağ geçidinin görünen adı.
id	string (uuid)	Ağ geçidinin nesne kimliği.
loadBalancingSetting	LoadBalancingSetting	Şirket içi ağ geçidinin yük dengeleme ayarı.
numberOfMemberGateways	integer	Şirket içi ağ geçidindeki ağ geçidi üyelerinin sayısı.
publicKey	PublicKey	Birincil ağ geçidi üyesinin ortak anahtarı. Bağlantıları oluşturmak ve güncelleştirmek için kimlik bilgilerini şifrelemek için kullanılır.
type	string: OnPremises	Ağ geçidinin türü.
version	string	Yüklü birincil ağ geçidi üyesinin sürümü.

OnPremisesGatewayPersonal

Nesne

Name	Tür	Description
id	string (uuid)	Ağ geçidinin nesne kimliği.
publicKey	PublicKey	Ağ geçidinin ortak anahtarı. Bağlantıları oluşturmak ve güncelleştirmek için kimlik bilgilerini şifrelemek için kullanılır.
type	string: OnPremisesPersonal	Ağ geçidinin türü.
version	string	Ağ geçidinin sürümü.

PublicKey

Nesne

Şirket içi ağ geçidinin ortak anahtarı.

Name	Tür	Description
exponent	string	Ortak anahtarın üssü.
modulus	string	Ortak anahtarın modulus.

VirtualNetworkAzureResource

Nesne

Sanal Ağ Azure kaynağının özellikleri

Name	Tür	Description
resourceGroupName	string	Kaynak grubunun adı
subnetName	string	Alt ağın adı
subscriptionId	string (uuid)	Abonelik kimliği
virtualNetworkName	string	Sanal ağın adı

VirtualNetworkGateway

Nesne

Name	Tür	Description
capacityId	string (uuid)	Doku lisans kapasitesinin nesne kimliği.
displayName	string	Sanal ağ geçidinin görünen adı.
id	string (uuid)	Ağ geçidinin nesne kimliği.
inactivityMinutesBeforeSleep	integer	Sanal ağ geçidi otomatik uyku moduna geçmeden önce geçen işlem yapılmadan geçen dakika sayısı.
numberOfMemberGateways	integer	Üye ağ geçitlerinin sayısı.
type	string: VirtualNetwork	Ağ geçidinin türü.
virtualNetworkAzureResource	VirtualNetworkAzureResource	Azure sanal ağ kaynağı.