Gateways - List Gateways

Hizmet:: Core

API Sürümü:: v1

Şirket içi, şirket içi (kişisel mod) ve sanal ağ geçitleri dahil olmak üzere kullanıcının izin aldığı tüm ağ geçitlerinin listesini döndürür.

İzinler

Çağıranın ağ geçidi için izinleri olmalıdır.

Gerekli Temsilci Kapsamları

Gateway.Read.All veya 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

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

İsteğe bağlı parametrelerle:

GET https://api.fabric.microsoft.com/v1/gateways?continuationToken={continuationToken}

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
continuationToken	query		string	Sonuçların sonraki sayfasını almak için bir belirteç.

Yanıtlar

Name Tür Description

200 OK

Name	Tür	Description
200 OK	ListGatewaysResponse	TAMAM. İş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ı: UnknownError - Bir hata oluştu.

ListGatewaysResponse

TAMAM. İş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ı:

UnknownError - Bir hata oluştu.

Örnekler

Example

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:: 200

{
  "value": [
    {
      "id": "8e41c4dd-a382-4937-9bf3-695ab881f7c2",
      "type": "OnPremises",
      "displayName": "ContosoOnPremisesGateway",
      "publicKey": {
        "exponent": "AQGB",
        "modulus": "od9b...90Jp1Q=="
      },
      "version": "3000.1.1",
      "numberOfMemberGateways": 2,
      "loadBalancingSetting": "DistributeEvenly",
      "allowCloudConnectionRefresh": true,
      "allowCustomConnectors": true
    },
    {
      "id": "ca8979ff-4238-4489-ad13-2e1bd69a8412",
      "type": "OnPremisesPersonal",
      "publicKey": {
        "exponent": "AQOV",
        "modulus": "pt9b...87Jp1Q=="
      },
      "version": "3000.1.1"
    },
    {
      "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": 1440,
      "numberOfMemberGateways": 3
    }
  ],
  "continuationToken": "LDEsMTAwMDAwLDA%3D",
  "continuationUri": "https://api.fabric.microsoft.com/v1/connections?continuationToken=LDEsMTAwMDAwLDA%3D"
}

Tanımlar

Name	Description
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.
ListGatewaysResponse
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

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.

ListGatewaysResponse

Nesne

Name	Tür	Description
continuationToken	string	Sonraki sonuç kümesi toplu işleminin belirteci. Başka kayıt yoksa yanıttan kaldırılır.
continuationUri	string	Sonraki sonuç kümesi toplu işleminin URI'sini. Başka kayıt yoksa yanıttan kaldırılır.
value	Gateway[]: OnPremisesGateway[] OnPremisesGatewayPersonal[] VirtualNetworkGateway[]	Döndürülen ağ geçitlerinin listesi.

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ğı.