Connections - Get Connection

Hizmet:: Admin

API Sürümü:: v1

Belirtilen bağlantıyı döndürür.

Note

Fabric kiracı yöneticisi bağlantı yönetimi şu anda Önizleme aşamasındadır (daha fazla bilgi edinin).

Permissions

Çağıranın Doku yöneticisi olması veya hizmet sorumlusu kullanarak kimlik doğrulaması yapması gerekir.

Gerekli Devredilen Kapsamlar

Tenant.Read.All veya Tenant.ReadWrite.All

Limitations

None.

Microsoft Entra destekli kimlikler

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

Identity	Support
User	Yes
Hizmet sorumlusu ve yönetilen kimlikler	Yes

Arayüz

GET https://api.fabric.microsoft.com/v1/admin/connections/{connectionId}

URI Parametreleri

Veri Akışı Adı	İçinde	Gerekli	Tür	Description
connectionId	path	True	string (uuid)	Bağlantı kimliği.

Yanıtlar

Veri Akışı Adı Tür Description

200 OK

Veri Akışı Adı	Tür	Description
200 OK	Connection: ShareableCloudConnection PersonalCloudConnection OnPremisesGatewayConnection OnPremisesGatewayPersonalConnection VirtualNetworkGatewayConnection StreamingVirtualNetworkGatewayConnection	OK. İş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	Sık karşılaşılan hata kodları: EntityNotFound - İstenen kaynak bulunamadı.

Connection:

ShareableCloudConnection
PersonalCloudConnection
OnPremisesGatewayConnection
OnPremisesGatewayPersonalConnection
VirtualNetworkGatewayConnection
StreamingVirtualNetworkGatewayConnection

OK. İş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

Sık karşılaşılan hata kodları:

EntityNotFound - İstenen kaynak bulunamadı.

Örnekler

Get connection as admin example

Örnek isteği

HTTP

GET https://api.fabric.microsoft.com/v1/admin/connections/f6a39b76-9816-4e4b-b93a-f42e405017b7

Örnek yanıt

Durum kodu:: 200

{
  "id": "f6a39b76-9816-4e4b-b93a-f42e405017b7",
  "displayName": "ContosoConnection",
  "gatewayId": "58376c10-5f61-4024-887e-748df4beae45",
  "connectivityType": "OnPremisesGateway",
  "connectionDetails": {
    "type": "SQL",
    "path": "contoso.database.windows.net;sales"
  },
  "privacyLevel": "Organizational",
  "credentialDetails": {
    "credentialType": "Basic",
    "singleSignOnType": "None",
    "connectionEncryption": "NotEncrypted",
    "skipTestConnection": false
  }
}

Tanımlar

Veri Akışı Adı	Description
ConnectionEncryption	Bağlantının bağlantı şifreleme türü. Zaman içinde ek bağlantı şifreleme değerleri eklenebilir.
ConnectionRecency	Bağlantı hakkındaki geri kazanma ayrıntılarını temsil eder.
ConnectionRole	Bağlantı rolü. Zaman içinde ek bağlantı rolleri eklenebilir.
ConnectivityType	Bağlantının bağlantı türü. Zaman içinde ek bağlantı türleri eklenebilir.
CredentialType	Bağlantının kimlik bilgisi türü. Zaman içinde ek kimlik bilgisi türleri eklenebilir.
ErrorParameter	Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.
ErrorRelatedResource	Hata ile ilişkili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.
ListConnectionDetails	Liste işlemleri için bağlantı ayrıntıları çıktısı.
ListCredentialDetails	Bağlantı getirilirken döndürülen kimlik bilgisi ayrıntıları.
OnPremisesGatewayConnection	Şirket içi veri ağ geçidi üzerinden bağlanan bir bağlantı.
OnPremisesGatewayPersonalConnection	Kişisel şirket içi veri ağ geçidi üzerinden bağlanan bir bağlantı.
PersonalCloudConnection	Bulut üzerinden bağlanan ve paylaşılamayan bir bağlantı.
PrivacyLevel	Bağlantının gizlilik düzeyi ayarı. Zaman içinde ek gizlilik düzeyleri eklenebilir.
ShareableCloudConnection	Bulut üzerinden bağlanan bir bağlantı.
SingleSignOnType	Bağlantının çoklu oturum açma türü. Zaman içinde ek çoklu oturum açma türleri eklenebilir.
StreamingVirtualNetworkGatewayConnection	Akış sanal ağ veri ağ geçidi üzerinden bağlanan bir bağlantı.
VirtualNetworkGatewayConnection	Sanal ağ veri ağ geçidi üzerinden bağlanan bir bağlantı.

ConnectionEncryption

Numaralandırma

Bağlantının bağlantı şifreleme türü. Zaman içinde ek bağlantı şifreleme değerleri eklenebilir.

Değer	Description
Encrypted	Bağlantı girişimi şifreli bir bağlantı kullanılarak yapılır.
Any	Bağlantı girişimi önce şifreli bir bağlantı kullanılarak yapılır, ardından başarısız olursa şifrelenmemiş bağlantıya geri döner.
NotEncrypted	Bağlantı girişimi şifrelenmemiş bir bağlantı kullanılarak yapılır.

ConnectionRecency

Nesne

Bağlantı hakkındaki geri kazanma ayrıntılarını temsil eder.

Veri Akışı Adı	Tür	Description
createdDateTime	string (date-time)	YYYY-MM-DDTHH:mm:ssZ biçimi kullanılarak utc'de bağlantının oluşturulduğu zaman damgası.
lastBoundDateTime	string (date-time)	YYYY-AA-GGTHH:mm:ssZ biçimini kullanarak, bağlantının UTC'deki herhangi bir öğeye en son bağlı olduğu zaman damgası.
lastCredentialUsedDateTime	string (date-time)	YYYY-MM-DDTHH:mm:ssZ biçimi kullanılarak, bağlantı kimlik bilgilerinin en son UTC'de kullanıldığı zaman damgası.
myLastBoundDateTime	string (date-time)	YYYY-AA-GGTHH:mm:ssZ biçimini kullanarak utc'de çağıran kullanıcı tarafından bağlantının en son herhangi bir öğeye bağlı olduğu zaman damgası.
myLastCredentialUsedDateTime	string (date-time)	YYYY-MM-DDTHH:mm:ssZ biçimi kullanılarak, utc'de çağıran kullanıcı tarafından bağlantı kimlik bilgilerinin en son kullanıldığı zaman damgası.

ConnectionRole

Numaralandırma

Bağlantı rolü. Zaman içinde ek bağlantı rolleri eklenebilir.

Değer	Description
User	Bağlantı için kullanıcı erişimini etkinleştirir.
UserWithReshare	Bağlantı için yeniden paylaşma erişimi olan kullanıcıyı etkinleştirir.
Owner	Bağlantı için sahiplik erişimini etkinleştirir.
PendingOwner	Bağlantının sahipliği henüz etkili değildir; sorumlunun etkili olması için bağlantı kimlik bilgilerini ( Güncelleştirme Bağlantısı API'sini kullanarak) güncelleştirmesi gerekir.

ConnectivityType

Numaralandırma

Bağlantının bağlantı türü. Zaman içinde ek bağlantı türleri eklenebilir.

Değer	Description
ShareableCloud	Bağlantı bulut üzerinden bağlanır ve başkalarıyla paylaşılabilir.
PersonalCloud	Bağlantı bulut üzerinden bağlanır ve başkalarıyla paylaşılamaz.
OnPremisesGateway	Bağlantı, şirket içi veri ağ geçidi üzerinden bağlanır.
OnPremisesGatewayPersonal	Bağlantı, kişisel bir şirket içi veri ağ geçidi üzerinden bağlanır.
VirtualNetworkGateway	Bağlantı bir sanal ağ veri ağ geçidi üzerinden bağlanır.
StreamingVirtualNetworkGateway	Bağlantı, akış sanal ağ veri ağ geçidi üzerinden bağlanır.
Automatic	Bağlantı, örtük bir veri bağlantısı kullanarak bulut üzerinden bağlanır. Bu seçenek yalnızca Tek Sign-On (SSO) kullanan anlamsal modeller gibi belirli senaryolarda kullanılabilir."
None	Bağlantı bağlı değil

CredentialType

Numaralandırma

Bağlantının kimlik bilgisi türü. Zaman içinde ek kimlik bilgisi türleri eklenebilir.

Değer	Description
Windows	Bağlantı, bağlanmak için Windows kimlik doğrulamasını kullanır. Yalnızca şirket içi ağ geçitleri için desteklenir.
Anonymous	Bağlantı, bağlanmak için anonim kimlik doğrulaması kullanır.
Basic	Bağlantı, bağlanmak için temel kimlik doğrulamasını kullanır.
Key	Bağlantı, bağlanmak için anahtar kimlik doğrulamasını kullanır.
OAuth2	Bağlantı, bağlanmak için OAuth 2.0 kimlik doğrulamasını kullanır.
WindowsWithoutImpersonation	Bağlantı, bağlanmak için Windows (kimliğe bürünme seçeneği olmadan) kimlik doğrulamasını kullanır. Yalnızca şirket içi ağ geçitleri (kişisel mod) için desteklenir.
SharedAccessSignature	Bağlantı, bağlanmak için paylaşılan erişim imzası (SAS) kimlik doğrulamasını kullanır.
ServicePrincipal	Bağlantı, bağlanmak için hizmet sorumlusu kimlik doğrulamasını kullanır.
WorkspaceIdentity	Bağlantı, bağlanmak için çalışma alanı kimliği kimlik doğrulamasını kullanır.
KeyPair	Bağlantı, bağlanmak için anahtar çifti kimlik doğrulamasını kullanır.

ErrorParameter

Nesne

Bir hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametre.

Veri Akışı Adı	Tür	Description
message	string	Parametrenin anlamının insan tarafından okunabilen açıklaması.
name	string	Parametre tanımlayıcısı.
value	string	Parametre değeridir.

ErrorRelatedResource

Nesne

Hata ile ilişkili kaynak ayrıntıları nesnesi.

Veri Akışı Adı	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ı.

Veri Akışı Adı	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 insan tarafından okunabilir bir temsilidir.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
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ı.

Veri Akışı Adı	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 insan tarafından okunabilir bir temsilidir.
parameters	ErrorParameter[]	Hata hakkında makine tarafından okunabilir ek bağlam sağlayan yapılandırılmış parametreler.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.

ListConnectionDetails

Nesne

Liste işlemleri için bağlantı ayrıntıları çıktısı.

Veri Akışı Adı	Tür	Description
path	string	Bağlantının yolu.
type	string	Bağlantının türü.

ListCredentialDetails

Nesne

Bağlantı getirilirken döndürülen kimlik bilgisi ayrıntıları.

Veri Akışı Adı	Tür	Description
connectionEncryption	ConnectionEncryption	Test bağlantısı sırasında kullanılan bağlantı şifreleme ayarı.
credentialType	CredentialType	Bağlantının kimlik bilgisi türü.
singleSignOnType	SingleSignOnType	Bağlantının çoklu oturum açma türü.
skipTestConnection	boolean	Oluşturma ve güncelleştirme sırasında bağlantının test bağlantısını atlayıp atlamaması. True - Test bağlantısını atla, False - Test bağlantısını atlamayın.

OnPremisesGatewayConnection

Nesne

Şirket içi veri ağ geçidi üzerinden bağlanan bir bağlantı.

Veri Akışı Adı	Tür	Description
connectionDetails	ListConnectionDetails	Bağlantının bağlantı ayrıntıları.
connectionRecency	ConnectionRecency	Bağlantı hakkındaki geri kazanma ayrıntıları.
connectivityType	string: OnPremisesGateway	Bağlantının bağlantı türü.
credentialDetails	ListCredentialDetails	Bağlantının kimlik bilgileri.
displayName	string	Bağlantının görünen adı.
gatewayId	string (uuid)	Bağlantının yapıldığı ağ geçidi nesne kimliği. Bulut bağlantıları için bu sanal ağ geçidi kimliğidir.
id	string (uuid)	Bağlantının nesne kimliği.
myRole	ConnectionRole	Çağrı sorumlusunun bağlantıdaki etkin rolü. Sorumlu farklı rollere sahip birden çok güvenlik grubunun parçası olduğunda, en yüksek rol döndürülür. Sorumlunun bağlantıda rolü yoksa, bu özellik döndürülmedi.
privacyLevel	PrivacyLevel	Bağlantının gizlilik düzeyi.

OnPremisesGatewayPersonalConnection

Nesne

Kişisel şirket içi veri ağ geçidi üzerinden bağlanan bir bağlantı.

Veri Akışı Adı	Tür	Description
connectionDetails	ListConnectionDetails	Bağlantının bağlantı ayrıntıları.
connectionRecency	ConnectionRecency	Bağlantı hakkındaki geri kazanma ayrıntıları.
connectivityType	string: OnPremisesGatewayPersonal	Bağlantının bağlantı türü.
credentialDetails	ListCredentialDetails	Bağlantının kimlik bilgileri.
displayName	string	Bağlantının görünen adı.
gatewayId	string (uuid)	Bağlantının yapıldığı ağ geçidi nesne kimliği. Bulut bağlantıları için bu sanal ağ geçidi kimliğidir.
id	string (uuid)	Bağlantının nesne kimliği.
myRole	ConnectionRole	Çağrı sorumlusunun bağlantıdaki etkin rolü. Sorumlu farklı rollere sahip birden çok güvenlik grubunun parçası olduğunda, en yüksek rol döndürülür. Sorumlunun bağlantıda rolü yoksa, bu özellik döndürülmedi.
privacyLevel	PrivacyLevel	Bağlantının gizlilik düzeyi.

PersonalCloudConnection

Nesne

Bulut üzerinden bağlanan ve paylaşılamayan bir bağlantı.

Veri Akışı Adı	Tür	Description
allowConnectionUsageInGateway	boolean	Bu bağlantının şirket içi veri ağ geçitleriyle veya sanal ağ veri ağ geçitleriyle kullanılmasına izin verin.
connectionDetails	ListConnectionDetails	Bağlantının bağlantı ayrıntıları.
connectionRecency	ConnectionRecency	Bağlantı hakkındaki geri kazanma ayrıntıları.
connectivityType	string: PersonalCloud	Bağlantının bağlantı türü.
credentialDetails	ListCredentialDetails	Bağlantının kimlik bilgileri.
displayName	string	Bağlantının görünen adı.
gatewayId	string (uuid)	Bağlantının yapıldığı ağ geçidi nesne kimliği. Bulut bağlantıları için bu sanal ağ geçidi kimliğidir.
id	string (uuid)	Bağlantının nesne kimliği.
myRole	ConnectionRole	Çağrı sorumlusunun bağlantıdaki etkin rolü. Sorumlu farklı rollere sahip birden çok güvenlik grubunun parçası olduğunda, en yüksek rol döndürülür. Sorumlunun bağlantıda rolü yoksa, bu özellik döndürülmedi.
privacyLevel	PrivacyLevel	Bağlantının gizlilik düzeyi.

PrivacyLevel

Numaralandırma

Bağlantının gizlilik düzeyi ayarı. Zaman içinde ek gizlilik düzeyleri eklenebilir.

Değer	Description
None	Hiçbir gizlilik düzeyi ayarı yapılandırılmadı.
Private	Özel olarak ayarlanan bağlantılar hassas veya gizli bilgiler içerir. Görünürlük yetkili kullanıcılarla sınırlandırılabilir. Özel bağlantıdaki veriler, diğer özel bağlantılar da dahil olmak üzere diğer bağlantılara katlanamaz.
Organizational	Kuruluşa ayarlanan bağlantılar, özel ve diğer kuruluş bağlantılarına katlanabilir. Ortak bağlantılara katlayamazlar. Görünürlük güvenilir bir gruba ayarlanır.
Public	Dosyalar, internet bağlantıları ve çalışma kitabı verileri genel olarak ayarlanabilir. Veriler diğer bağlantılara katlanabilir. Görünürlük herkes tarafından kullanılabilir.

ShareableCloudConnection

Nesne

Bulut üzerinden bağlanan bir bağlantı.

Veri Akışı Adı	Tür	Description
allowConnectionUsageInGateway	boolean	Bu bağlantının şirket içi veri ağ geçitleriyle veya sanal ağ veri ağ geçitleriyle kullanılmasına izin verin.
allowUsageInUserControlledCode	boolean	Bu bağlantının Not Defteri gibi kullanıcı tarafından denetlenen koda izin veren öğelerle kullanılmasına izin verin.
connectionDetails	ListConnectionDetails	Bağlantının bağlantı ayrıntıları.
connectionRecency	ConnectionRecency	Bağlantı hakkındaki geri kazanma ayrıntıları.
connectivityType	string: ShareableCloud	Bağlantının bağlantı türü.
credentialDetails	ListCredentialDetails	Bağlantının kimlik bilgileri.
displayName	string	Bağlantının görünen adı.
gatewayId	string (uuid)	Bağlantının yapıldığı ağ geçidi nesne kimliği. Bulut bağlantıları için bu sanal ağ geçidi kimliğidir.
id	string (uuid)	Bağlantının nesne kimliği.
myRole	ConnectionRole	Çağrı sorumlusunun bağlantıdaki etkin rolü. Sorumlu farklı rollere sahip birden çok güvenlik grubunun parçası olduğunda, en yüksek rol döndürülür. Sorumlunun bağlantıda rolü yoksa, bu özellik döndürülmedi.
privacyLevel	PrivacyLevel	Bağlantının gizlilik düzeyi.

SingleSignOnType

Numaralandırma

Bağlantının çoklu oturum açma türü. Zaman içinde ek çoklu oturum açma türleri eklenebilir.

Değer	Description
None	Bağlantı, bağlanmak için çoklu oturum açma kullanmaz.
Kerberos	Bağlantı, bağlanmak için Kerberos çoklu oturum açma kullanır.
MicrosoftEntraID	Bağlantı, bağlanmak için Microsoft Entra ID çoklu oturum açmayı kullanır.
SecurityAssertionMarkupLanguage	Bağlantı, bağlanmak için Güvenlik Onaylama İşaretleme Dili (SAML) çoklu oturum açma kullanır.
KerberosDirectQueryAndRefresh	Bağlantı, bağlanmak için Kerberos DirectQuery ve Refresh çoklu oturum açmayı kullanır.

StreamingVirtualNetworkGatewayConnection

Nesne

Akış sanal ağ veri ağ geçidi üzerinden bağlanan bir bağlantı.

Veri Akışı Adı	Tür	Description
connectionDetails	ListConnectionDetails	Bağlantının bağlantı ayrıntıları.
connectionRecency	ConnectionRecency	Bağlantı hakkındaki geri kazanma ayrıntıları.
connectivityType	string: StreamingVirtualNetworkGateway	Bağlantının bağlantı türü.
credentialDetails	ListCredentialDetails	Bağlantının kimlik bilgileri.
displayName	string	Bağlantının görünen adı.
gatewayId	string (uuid)	Bağlantının ağ geçidi nesne kimliği.
id	string (uuid)	Bağlantının nesne kimliği.
myRole	ConnectionRole	Çağrı sorumlusunun bağlantıdaki etkin rolü. Sorumlu farklı rollere sahip birden çok güvenlik grubunun parçası olduğunda, en yüksek rol döndürülür. Sorumlunun bağlantıda rolü yoksa, bu özellik döndürülmedi.
privacyLevel	PrivacyLevel	Bağlantının gizlilik düzeyi.

VirtualNetworkGatewayConnection

Nesne

Sanal ağ veri ağ geçidi üzerinden bağlanan bir bağlantı.

Veri Akışı Adı	Tür	Description
connectionDetails	ListConnectionDetails	Bağlantının bağlantı ayrıntıları.
connectionRecency	ConnectionRecency	Bağlantı hakkındaki geri kazanma ayrıntıları.
connectivityType	string: VirtualNetworkGateway	Bağlantının bağlantı türü.
credentialDetails	ListCredentialDetails	Bağlantının kimlik bilgileri.
displayName	string	Bağlantının görünen adı.
gatewayId	string (uuid)	Bağlantının yapıldığı ağ geçidi nesne kimliği. Bulut bağlantıları için bu sanal ağ geçidi kimliğidir.
id	string (uuid)	Bağlantının nesne kimliği.
myRole	ConnectionRole	Çağrı sorumlusunun bağlantıdaki etkin rolü. Sorumlu farklı rollere sahip birden çok güvenlik grubunun parçası olduğunda, en yüksek rol döndürülür. Sorumlunun bağlantıda rolü yoksa, bu özellik döndürülmedi.
privacyLevel	PrivacyLevel	Bağlantının gizlilik düzeyi.