Connections - Create Connection

Αναφορά

Υπηρεσία:: Core

Έκδοση API:: v1

Σημείωση

Αυτό το API είναι σε προεπισκόπηση.

Δημιουργεί μια σύνδεση.
Για να κρυπτογραφήσετε διαπιστευτήρια, ανατρέξτε στο θέμα Ρύθμιση παραμέτρων διαπιστευτηρίων μέσω προγραμματισμού.

Δικαιώματα

Εάν δημιουργεί μια σύνδεση πύλης, ο καλών πρέπει να έχει δικαιώματα για την πύλη.

Απαιτούμενες εμβέλειες με ανάθεση

Connection.ReadWrite.All

Υποστηριζόμενες ταυτότητες Microsoft Entra

Αυτό το API υποστηρίζει τις ταυτότητες Microsoft που παρατίθενται σε αυτή την ενότητα.

Ταυτότητα	Υποστηρίζω
Χρήστης	Ναι
Υπηρεσίας και διαχειριζόμενες ταυτότητες	Ναι

Διεπαφή

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

Κυρίως τμήμα αίτησης

Το σώμα αίτησης μπορεί να είναι ένα από τα εξής:

Όνομα	Περιγραφή
CreateCloudConnectionRequest
CreateOnPremisesConnectionRequest
CreateVirtualNetworkGatewayConnectionRequest

CreateCloudConnectionRequest

Όνομα	Απαιτείται	Τύπος	Περιγραφή
connectionDetails	True	CreateConnectionDetails	Οι λεπτομέρειες σύνδεσης της σύνδεσης.
connectivityType	True	string: ShareableCloud	Ο τύπος συνδεσιμότητας της σύνδεσης.
credentialDetails	True	CreateCredentialDetails	Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης.
displayName	True	string	Το εμφανιζόμενο όνομα της σύνδεσης. Το μέγιστο μήκος είναι 200 χαρακτήρες.
privacyLevel		PrivacyLevel	(Προαιρετικό) Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "Εταιρικό".

CreateOnPremisesConnectionRequest

Όνομα	Απαιτείται	Τύπος	Περιγραφή
connectionDetails	True	CreateConnectionDetails	Οι λεπτομέρειες σύνδεσης της σύνδεσης.
connectivityType	True	string: OnPremisesGateway	Ο τύπος συνδεσιμότητας της σύνδεσης.
credentialDetails	True	CreateOnPremisesCredentialDetails	Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης.
displayName	True	string	Το εμφανιζόμενο όνομα της σύνδεσης. Το μέγιστο μήκος είναι 200 χαρακτήρες.
gatewayId	True	string uuid	Το αναγνωριστικό αντικειμένου της κύριας πύλης της πύλης εσωτερικής εγκατάστασης στην οποία δημιουργείται η σύνδεση.
privacyLevel		PrivacyLevel	(Προαιρετικό) Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "Εταιρικό".

CreateVirtualNetworkGatewayConnectionRequest

Όνομα	Απαιτείται	Τύπος	Περιγραφή
connectionDetails	True	CreateConnectionDetails	Οι λεπτομέρειες σύνδεσης της σύνδεσης.
connectivityType	True	string: VirtualNetworkGateway	Ο τύπος συνδεσιμότητας της σύνδεσης.
credentialDetails	True	CreateCredentialDetails	Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης.
displayName	True	string	Το εμφανιζόμενο όνομα της σύνδεσης. Το μέγιστο μήκος είναι 200 χαρακτήρες.
gatewayId	True	string uuid	Το αναγνωριστικό αντικειμένου της εικονικής πύλης δικτύου από την οποία δημιουργείται η σύνδεση.
privacyLevel		PrivacyLevel	(Προαιρετικό) Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "Εταιρικό".

Αποκρίσεις

Όνομα	Τύπος	Περιγραφή
201 Created	Connection	Δημιουργημένος. Η επιχείρηση ολοκληρώθηκε με επιτυχία.
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: DuplicateConnectionName - Το όνομα της σύνδεσης χρησιμοποιείται ήδη. InvalidConnectionDetails - Η παρεχόμενη είσοδος ConnectionDetails δεν είναι έγκυρη. InvalidCredentialDetails - Η παρεχόμενη είσοδος CredentialDetails δεν είναι έγκυρη. IncorrectCredentials - Απέτυχε η δημιουργία σύνδεσης με χρήση της εισόδου διαπιστευτηρίων. CreateGatewayConnectionFailed - Απέτυχε η δημιουργία σύνδεσης πύλης.

Όνομα

Τύπος

Περιγραφή

201 Created

Connection

Δημιουργημένος. Η επιχείρηση ολοκληρώθηκε με επιτυχία.

Other Status Codes

ErrorResponse

Συνήθεις κωδικοί σφαλμάτων:

DuplicateConnectionName - Το όνομα της σύνδεσης χρησιμοποιείται ήδη.
InvalidConnectionDetails - Η παρεχόμενη είσοδος ConnectionDetails δεν είναι έγκυρη.
InvalidCredentialDetails - Η παρεχόμενη είσοδος CredentialDetails δεν είναι έγκυρη.
IncorrectCredentials - Απέτυχε η δημιουργία σύνδεσης με χρήση της εισόδου διαπιστευτηρίων.
CreateGatewayConnectionFailed - Απέτυχε η δημιουργία σύνδεσης πύλης.

Παραδείγματα

Cloud example

Virtual network gateway example

Cloud example

Δείγμα αίτησης

HTTP

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

{
  "connectivityType": "ShareableCloud",
  "displayName": "ContosoCloudConnection",
  "connectionDetails": {
    "type": "SQL",
    "creationMethod": "SQL",
    "parameters": [
      {
        "dataType": "Text",
        "name": "server",
        "value": "contoso.database.windows.net"
      },
      {
        "dataType": "Text",
        "name": "database",
        "value": "sales"
      }
    ]
  },
  "privacyLevel": "Organizational",
  "credentialDetails": {
    "singleSignOnType": "None",
    "connectionEncryption": "NotEncrypted",
    "skipTestConnection": false,
    "credentials": {
      "credentialType": "Basic",
      "username": "admin",
      "password": "********"
    }
  }
}

Δείγμα απόκρισης

Κωδικός κατάστασης:: 201

{
  "id": "eeec9a3a-6ef5-4e2b-bb6a-0060bd2f0172",
  "displayName": "ContosoCloudConnection",
  "connectivityType": "ShareableCloud",
  "connectionDetails": {
    "type": "SQL",
    "path": "contoso.database.windows.net;sales"
  },
  "privacyLevel": "Organizational",
  "credentialDetails": {
    "credentialType": "Basic",
    "singleSignOnType": "None",
    "connectionEncryption": "NotEncrypted",
    "skipTestConnection": false
  }
}

Virtual network gateway example

Δείγμα αίτησης

HTTP

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

{
  "connectivityType": "VirtualNetworkGateway",
  "gatewayId": "93491300-cfbd-402f-bf17-9ace59a92354",
  "displayName": "ContosoVirtualNetworkGatewayConnection",
  "connectionDetails": {
    "type": "SQL",
    "creationMethod": "SQL",
    "parameters": [
      {
        "dataType": "Text",
        "name": "server",
        "value": "contoso.database.windows.net"
      },
      {
        "dataType": "Text",
        "name": "database",
        "value": "sales"
      }
    ]
  },
  "privacyLevel": "Organizational",
  "credentialDetails": {
    "singleSignOnType": "None",
    "connectionEncryption": "Encrypted",
    "skipTestConnection": false,
    "credentials": {
      "credentialType": "Basic",
      "username": "admin",
      "password": "*********"
    }
  }
}

Δείγμα απόκρισης

Κωδικός κατάστασης:: 201

{
  "id": "eeec9a3a-6ef5-4e2b-bb6a-0060bd2f0172",
  "displayName": "ContosoVirtualNetworkGatewayConnection",
  "gatewayId": "93491300-cfbd-402f-bf17-9ace59a92354",
  "connectivityType": "VirtualNetworkGateway",
  "connectionDetails": {
    "type": "SQL",
    "path": "contoso.database.windows.net;sales"
  },
  "privacyLevel": "Organizational",
  "credentialDetails": {
    "credentialType": "Basic",
    "singleSignOnType": "None",
    "connectionEncryption": "Encrypted",
    "skipTestConnection": false
  }
}

Ορισμοί

Όνομα	Περιγραφή
AnonymousCredentials	Διαπιστευτήρια για το ανώνυμο τύπο διαπιστευτηρίων.
BasicCredentials	Διαπιστευτήρια για το βασικό τύπο διαπιστευτηρίων.
Connection
ConnectionDetailsBooleanParameter	ConnectionDetailsParameter για δυαδική dataType.
ConnectionDetailsDateParameter	ConnectionDetailsParameter για dataType ημερομηνίας.
ConnectionDetailsDateTimeParameter	ConnectionDetailsParameter για dataType ημερομηνίας/ώρας.
ConnectionDetailsDateTimeZoneParameter	ConnectionDetailsParameter για dataType ημερομηνίας/ώρας/ζώνης.
ConnectionDetailsDurationParameter	ConnectionDetailsParameter για dataType διάρκειας.
ConnectionDetailsNumberParameter	ConnectionDetailsParameter για τον τύπο δεδομένων αριθμού.
ConnectionDetailsTextParameter	ConnectionDetailsParameter για το text dataType.
ConnectionDetailsTimeParameter	ConnectionDetailsParameter για dataType χρόνου.
ConnectionEncryption	Ο τύπος κρυπτογράφησης σύνδεσης της σύνδεσης. Ενδέχεται να προστεθούν πρόσθετες τιμές κρυπτογράφησης σύνδεσης με την πάροδο του χρόνου.
ConnectivityType	Ο τύπος συνδεσιμότητας της σύνδεσης. Πρόσθετοι τύποι συνδεσιμότητας μπορούν να προστεθούν με την πάροδο του χρόνου.
CreateCloudConnectionRequest
CreateConnectionDetails	Η είσοδος λεπτομερειών σύνδεσης για λειτουργίες δημιουργίας.
CreateCredentialDetails	Η εισαγωγή λεπτομερειών διαπιστευτηρίων για τη δημιουργία μιας σύνδεσης.
CreateOnPremisesConnectionRequest
CreateOnPremisesCredentialDetails	Τα δεδομένα εισόδου λεπτομερειών διαπιστευτηρίων για τη δημιουργία μιας σύνδεσης πύλης εσωτερικής εγκατάστασης.
CreateVirtualNetworkGatewayConnectionRequest
CredentialType	Ο τύπος διαπιστευτηρίων της σύνδεσης. Επιπλέον τύποι διαπιστευτηρίων μπορούν να προστεθούν με την πάροδο του χρόνου.
DataType	Ο τύπος δεδομένων της τιμής παραμέτρου δημιουργίας σύνδεσης. Μπορείτε να προσθέσετε επιπλέον τιμές τύπου δεδομένων με την πάροδο του χρόνου.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
KeyCredentials	Διαπιστευτήρια για το Key CredentialType.
ListConnectionDetails	Το αποτέλεσμα λεπτομερειών σύνδεσης για λειτουργίες λίστας.
ListCredentialDetails	Οι λεπτομέρειες διαπιστευτηρίων επιστρέφονται κατά τη λήψη μιας σύνδεσης.
OnPremisesCredentialEntry	Ένα αναγνωριστικό πύλης και τα κρυπτογραφημένα σειριοποιημένα διαπιστευτήριά του.
OnPremisesGatewayCredentials	Διαπιστευτήρια για τον έλεγχο ταυτότητας μέσω μιας πύλης εσωτερικής εγκατάστασης.
PrivacyLevel	Η ρύθμιση επιπέδου προστασίας προσωπικών δεδομένων της σύνδεσης. Μπορείτε να προσθέσετε επιπλέον επίπεδα προστασίας προσωπικών δεδομένων με την πάροδο του χρόνου.
ServicePrincipalCredentials	Διαπιστευτήρια για το ServicePrincipal CredentialType.
SharedAccessSignatureCredentials	Διαπιστευτήρια για το SharedAccessSignature CredentialType.
SingleSignOnType	Ο τύπος καθολικής σύνδεσης της σύνδεσης. Επιπλέον τύποι καθολικής σύνδεσης μπορούν να προστεθούν με την πάροδο του χρόνου.
WindowsCredentials	Διαπιστευτήρια για το Windows CredentialType.
WindowsWithoutImpersonationCredentials	Διαπιστευτήρια για το WindowsWithoutImpersonation CredentialType.
WorkspaceIdentityCredentials	Διαπιστευτήρια για το WorkspaceIdentity CredentialType.

AnonymousCredentials

Object

Διαπιστευτήρια για το ανώνυμο τύπο διαπιστευτηρίων.

Όνομα	Τύπος	Περιγραφή
credentialType	string: Anonymous	Ο τύπος διαπιστευτηρίων της σύνδεσης.

BasicCredentials

Object

Διαπιστευτήρια για το βασικό τύπο διαπιστευτηρίων.

Όνομα	Τύπος	Περιγραφή
credentialType	string: Basic	Ο τύπος διαπιστευτηρίων της σύνδεσης.
password	string	Ο κωδικός πρόσβασης.
username	string	Το όνομα χρήστη.

Connection

Object

Όνομα	Τύπος	Περιγραφή
connectionDetails	ListConnectionDetails	Οι λεπτομέρειες σύνδεσης της σύνδεσης.
connectivityType	ConnectivityType	Ο τύπος συνδεσιμότητας της σύνδεσης.
credentialDetails	ListCredentialDetails	Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης.
displayName	string	Το εμφανιζόμενο όνομα της σύνδεσης.
gatewayId	string uuid	Το αναγνωριστικό αντικειμένου πύλης της σύνδεσης.
id	string uuid	Το αναγνωριστικό αντικειμένου της σύνδεσης.
privacyLevel	PrivacyLevel	Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης.

ConnectionDetailsBooleanParameter

Object

ConnectionDetailsParameter για δυαδική dataType.

Όνομα	Τύπος	Περιγραφή
dataType	string: Boolean	Ο τύπος δεδομένων της παραμέτρου.
name	string	Το όνομα της παραμέτρου.
value	boolean	Η δυαδική τιμή.

ConnectionDetailsDateParameter

Object

ConnectionDetailsParameter για dataType ημερομηνίας.

Όνομα	Τύπος	Περιγραφή
dataType	string: Date	Ο τύπος δεδομένων της παραμέτρου.
name	string	Το όνομα της παραμέτρου.
value	string date	Η τιμή ημερομηνίας που χρησιμοποιεί τη μορφή YYYY-MM-DD.

ConnectionDetailsDateTimeParameter

Object

ConnectionDetailsParameter για dataType ημερομηνίας/ώρας.

Όνομα	Τύπος	Περιγραφή
dataType	string: DateTime	Ο τύπος δεδομένων της παραμέτρου.
name	string	Το όνομα της παραμέτρου.
value	string date-time	Η τιμή ημερομηνίας/ώρας που χρησιμοποιεί ΕΕΕΕ-ΜΜ-ΗΗH:λλ:δδ. Μορφή FFFZ.

ConnectionDetailsDateTimeZoneParameter

Object

ConnectionDetailsParameter για dataType ημερομηνίας/ώρας/ζώνης.

Όνομα	Τύπος	Περιγραφή
dataType	string: DateTimeZone	Ο τύπος δεδομένων της παραμέτρου.
name	string	Το όνομα της παραμέτρου.
value	string date-time-offset	Η τιμή ζώνης ώρας που χρησιμοποιεί ΕΕΕΕ-ΜΜ-DDTHH:mm:ss. FFF±hh:mm μορφή.

ConnectionDetailsDurationParameter

Object

ConnectionDetailsParameter για dataType διάρκειας.

Όνομα	Τύπος	Περιγραφή
dataType	string: Duration	Ο τύπος δεδομένων της παραμέτρου.
name	string	Το όνομα της παραμέτρου.
value	string time-span	Η τιμή διάρκειας που χρησιμοποιεί τη μορφή [-]P(n)DT(n)H(n)M(n)S. Για παράδειγμα: P3DT4H30M10S (για 3 ημέρες, 4 ώρες, 30 λεπτά και 10 δευτερόλεπτα).

ConnectionDetailsNumberParameter

Object

ConnectionDetailsParameter για τον τύπο δεδομένων αριθμού.

Όνομα	Τύπος	Περιγραφή
dataType	string: Number	Ο τύπος δεδομένων της παραμέτρου.
name	string	Το όνομα της παραμέτρου.
value	number	Η αριθμητική τιμή.

ConnectionDetailsTextParameter

Object

ConnectionDetailsParameter για το text dataType.

Όνομα	Τύπος	Περιγραφή
dataType	string: Text	Ο τύπος δεδομένων της παραμέτρου.
name	string	Το όνομα της παραμέτρου.
value	string	Η τιμή κειμένου.

ConnectionDetailsTimeParameter

Object

ConnectionDetailsParameter για dataType χρόνου.

Όνομα	Τύπος	Περιγραφή
dataType	string: Time	Ο τύπος δεδομένων της παραμέτρου.
name	string	Το όνομα της παραμέτρου.
value	string time	Η τιμή ώρας που χρησιμοποιεί HH:mm:ss. Μορφή FFFZ.

ConnectionEncryption

Απαρίθμηση

Ο τύπος κρυπτογράφησης σύνδεσης της σύνδεσης. Ενδέχεται να προστεθούν πρόσθετες τιμές κρυπτογράφησης σύνδεσης με την πάροδο του χρόνου.

Τιμή	Περιγραφή
Any	Η προσπάθεια σύνδεσης πραγματοποιείται πρώτα χρησιμοποιώντας μια κρυπτογραφημένη σύνδεση και, στη συνέχεια, επιστρέφει σε μη κρυπτογραφημένη σύνδεση, εάν δεν είναι επιτυχής.
Encrypted	Η προσπάθεια σύνδεσης γίνεται χρησιμοποιώντας μια κρυπτογραφημένη σύνδεση.
NotEncrypted	Η προσπάθεια σύνδεσης γίνεται χρησιμοποιώντας μια μη κρυπτογραφημένη σύνδεση.

ConnectivityType

Απαρίθμηση

Ο τύπος συνδεσιμότητας της σύνδεσης. Πρόσθετοι τύποι συνδεσιμότητας μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή	Περιγραφή
Automatic	Η σύνδεση συνδέεται μέσω του cloud χρησιμοποιώντας μια έμμεση σύνδεση δεδομένων. Αυτή η επιλογή είναι διαθέσιμη μόνο για συγκεκριμένα σενάρια, όπως σημασιολογικά μοντέλα που χρησιμοποιούν Μονή Sign-On (SSO)."
None	Η σύνδεση δεν είναι δεσμευμένη
OnPremisesGateway	Η σύνδεση συνδέεται μέσω μιας πύλης δεδομένων εσωτερικής εγκατάστασης.
OnPremisesGatewayPersonal	Η σύνδεση συνδέεται μέσω μιας προσωπικής πύλης δεδομένων εσωτερικής εγκατάστασης.
PersonalCloud	Η σύνδεση συνδέεται μέσω του cloud και δεν είναι δυνατή η κοινή χρήση της με άλλους χρήστες.
ShareableCloud	Η σύνδεση συνδέεται μέσω του cloud και μπορεί να τεθεί σε κοινή χρήση με άλλους χρήστες.
VirtualNetworkGateway	Η σύνδεση συνδέεται μέσω μιας πύλης δεδομένων εικονικού δικτύου.

CreateCloudConnectionRequest

Object

Όνομα	Τύπος	Περιγραφή
connectionDetails	CreateConnectionDetails	Οι λεπτομέρειες σύνδεσης της σύνδεσης.
connectivityType	string: ShareableCloud	Ο τύπος συνδεσιμότητας της σύνδεσης.
credentialDetails	CreateCredentialDetails	Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης.
displayName	string	Το εμφανιζόμενο όνομα της σύνδεσης. Το μέγιστο μήκος είναι 200 χαρακτήρες.
privacyLevel	PrivacyLevel	(Προαιρετικό) Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "Εταιρικό".

CreateConnectionDetails

Object

Η είσοδος λεπτομερειών σύνδεσης για λειτουργίες δημιουργίας.

Όνομα	Τύπος	Περιγραφή
creationMethod	string	Η μέθοδος δημιουργίας που χρησιμοποιήθηκε για τη δημιουργία της σύνδεσης.
parameters	ConnectionDetailsParameter[]: ConnectionDetailsBooleanParameter[] ConnectionDetailsDateParameter[] ConnectionDetailsDateTimeParameter[] ConnectionDetailsDateTimeZoneParameter[] ConnectionDetailsDurationParameter[] ConnectionDetailsNumberParameter[] ConnectionDetailsTextParameter[] ConnectionDetailsTimeParameter[]	Η λίστα παραμέτρων σύνδεσης.
type	string	Ο τύπος της σύνδεσης.

CreateCredentialDetails

Object

Η εισαγωγή λεπτομερειών διαπιστευτηρίων για τη δημιουργία μιας σύνδεσης.

Όνομα	Τύπος	Περιγραφή
connectionEncryption	ConnectionEncryption	(Προαιρετικό) Η ρύθμιση κρυπτογράφησης σύνδεσης που χρησιμοποιείται κατά τη διάρκεια της δοκιμαστικής σύνδεσης. Όταν δεν μεταβιβάζεται καμία τιμή, η σύνδεση δεν κρυπτογραφείται.
credentials	Credentials: AnonymousCredentials BasicCredentials KeyCredentials ServicePrincipalCredentials SharedAccessSignatureCredentials WindowsCredentials WindowsWithoutImpersonationCredentials WorkspaceIdentityCredentials	Τα διαπιστευτήρια της σύνδεσης.
singleSignOnType	SingleSignOnType	(Προαιρετικό) Ο τύπος καθολικής σύνδεσης της σύνδεσης. Όταν δεν διαβιβάζεται καμία τιμή, η σύνδεση δεν χρησιμοποιεί καθολική σύνδεση.
skipTestConnection	boolean	Εάν η σύνδεση θα πρέπει να παραλείπει τη δοκιμαστική σύνδεση κατά τη δημιουργία και την ενημέρωση. True - Παραλείπει τη δοκιμαστική σύνδεση, False - Μην παραλείψετε τη δοκιμαστική σύνδεση. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "False".

CreateOnPremisesConnectionRequest

Object

Όνομα	Τύπος	Περιγραφή
connectionDetails	CreateConnectionDetails	Οι λεπτομέρειες σύνδεσης της σύνδεσης.
connectivityType	string: OnPremisesGateway	Ο τύπος συνδεσιμότητας της σύνδεσης.
credentialDetails	CreateOnPremisesCredentialDetails	Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης.
displayName	string	Το εμφανιζόμενο όνομα της σύνδεσης. Το μέγιστο μήκος είναι 200 χαρακτήρες.
gatewayId	string uuid	Το αναγνωριστικό αντικειμένου της κύριας πύλης της πύλης εσωτερικής εγκατάστασης στην οποία δημιουργείται η σύνδεση.
privacyLevel	PrivacyLevel	(Προαιρετικό) Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "Εταιρικό".

CreateOnPremisesCredentialDetails

Object

Τα δεδομένα εισόδου λεπτομερειών διαπιστευτηρίων για τη δημιουργία μιας σύνδεσης πύλης εσωτερικής εγκατάστασης.

Όνομα	Τύπος	Περιγραφή
connectionEncryption	ConnectionEncryption	(Προαιρετικό) Η ρύθμιση κρυπτογράφησης σύνδεσης που χρησιμοποιείται κατά τη διάρκεια της δοκιμαστικής σύνδεσης. Όταν δεν μεταβιβάζεται καμία τιμή, η σύνδεση δεν κρυπτογραφείται.
credentials	OnPremisesGatewayCredentials	Τα διαπιστευτήρια της σύνδεσης.
singleSignOnType	SingleSignOnType	(Προαιρετικό) Ο τύπος καθολικής σύνδεσης της σύνδεσης. Όταν δεν διαβιβάζεται καμία τιμή, η σύνδεση δεν χρησιμοποιεί καθολική σύνδεση.
skipTestConnection	boolean	Εάν η σύνδεση θα πρέπει να παραλείπει τη δοκιμαστική σύνδεση κατά τη δημιουργία και την ενημέρωση. True - Παραλείπει τη δοκιμαστική σύνδεση, False - Μην παραλείψετε τη δοκιμαστική σύνδεση. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "False".

CreateVirtualNetworkGatewayConnectionRequest

Object

Όνομα	Τύπος	Περιγραφή
connectionDetails	CreateConnectionDetails	Οι λεπτομέρειες σύνδεσης της σύνδεσης.
connectivityType	string: VirtualNetworkGateway	Ο τύπος συνδεσιμότητας της σύνδεσης.
credentialDetails	CreateCredentialDetails	Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης.
displayName	string	Το εμφανιζόμενο όνομα της σύνδεσης. Το μέγιστο μήκος είναι 200 χαρακτήρες.
gatewayId	string uuid	Το αναγνωριστικό αντικειμένου της εικονικής πύλης δικτύου από την οποία δημιουργείται η σύνδεση.
privacyLevel	PrivacyLevel	(Προαιρετικό) Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "Εταιρικό".

CredentialType

Απαρίθμηση

Ο τύπος διαπιστευτηρίων της σύνδεσης. Επιπλέον τύποι διαπιστευτηρίων μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή	Περιγραφή
Anonymous	Η σύνδεση χρησιμοποιεί ανώνυμο έλεγχο ταυτότητας για τη σύνδεση.
Basic	Η σύνδεση χρησιμοποιεί βασικό έλεγχο ταυτότητας για τη σύνδεση.
Key	Η σύνδεση χρησιμοποιεί έλεγχο ταυτότητας κλειδιού για τη σύνδεση.
OAuth2	Η σύνδεση χρησιμοποιεί έλεγχο ταυτότητας OAuth 2.0 για τη σύνδεση.
ServicePrincipal	Η σύνδεση χρησιμοποιεί έλεγχο ταυτότητας κύριας υπηρεσίας για τη σύνδεση.
SharedAccessSignature	Η σύνδεση χρησιμοποιεί έλεγχο ταυτότητας υπογραφής κοινόχρηστής πρόσβασης (SAS) για σύνδεση.
Windows	Η σύνδεση χρησιμοποιεί έλεγχο ταυτότητας των Windows για τη σύνδεση. Υποστηρίζεται μόνο για πύλες εσωτερικής εγκατάστασης.
WindowsWithoutImpersonation	Η σύνδεση χρησιμοποιεί τον έλεγχο ταυτότητας των Windows (χωρίς την επιλογή απομίμησης) για τη σύνδεση. Υποστηρίζεται μόνο για πύλες εσωτερικής εγκατάστασης (προσωπική λειτουργία).
WorkspaceIdentity	Η σύνδεση χρησιμοποιεί έλεγχο ταυτότητας χώρου εργασίας για τη σύνδεση.

DataType

Απαρίθμηση

Ο τύπος δεδομένων της τιμής παραμέτρου δημιουργίας σύνδεσης. Μπορείτε να προσθέσετε επιπλέον τιμές τύπου δεδομένων με την πάροδο του χρόνου.

Τιμή	Περιγραφή
Boolean	Χρησιμοποιήστε δυαδική τιμή ως τιμή εισόδου παραμέτρου. False - η τιμή είναι false, True - η τιμή είναι true.
Date	Χρησιμοποιήστε την ημερομηνία ως τιμή εισόδου παραμέτρου, χρησιμοποιώντας τη μορφήMM-DD YYYY.
DateTime	Χρησιμοποιήστε την ώρα ημερομηνίας ως τιμή εισόδου παραμέτρου, χρησιμοποιώντας ΕΕΕΕ-ΜΜ-DDTHH:mm:ss. Μορφή FFFZ.
DateTimeZone	Χρησιμοποιήστε τη ζώνη ώρας ως τιμή εισόδου παραμέτρου, χρησιμοποιώντας ΕΕΕΕ-ΜΜ-DDTHH:mm:ss. FFF±hh:mm μορφή.
Duration	Χρησιμοποιήστε τη διάρκεια ως τιμή εισόδου παραμέτρου, χρησιμοποιώντας τη μορφή [-]P(n)DT(n)H(n)M(n)S. Για παράδειγμα: P3DT4H30M10S (για 3 ημέρες, 4 ώρες, 30 λεπτά και 10 δευτερόλεπτα).
Number	Χρησιμοποιήστε τον αριθμό ως την τιμή εισόδου παραμέτρου (ακέραιο ή κινητής υποδιαστολής).
Text	Χρησιμοποιήστε κείμενο ως τιμή εισόδου παραμέτρου.
Time	Χρησιμοποιήστε τον χρόνο ως τιμή εισόδου παραμέτρου, χρησιμοποιώντας HH:mm:ss. Μορφή FFFZ.

ErrorRelatedResource

Object

Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.

Όνομα	Τύπος	Περιγραφή
resourceId	string	Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.
resourceType	string	Ο τύπος του πόρου που εμπλέκεται στο σφάλμα.

ErrorResponse

Object

Η απόκριση σφάλματος.

Όνομα	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
moreDetails	ErrorResponseDetails[]	Λίστα πρόσθετων λεπτομερειών σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.
requestId	string	Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα.

ErrorResponseDetails

Object

Οι λεπτομέρειες της απόκρισης σφάλματος.

Όνομα	Τύπος	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

KeyCredentials

Object

Διαπιστευτήρια για το Key CredentialType.

Όνομα	Τύπος	Περιγραφή
credentialType	string: Key	Ο τύπος διαπιστευτηρίων της σύνδεσης.
key	string	Το κλειδί.

ListConnectionDetails

Object

Το αποτέλεσμα λεπτομερειών σύνδεσης για λειτουργίες λίστας.

Όνομα	Τύπος	Περιγραφή
path	string	Η διαδρομή της σύνδεσης.
type	string	Ο τύπος της σύνδεσης.

ListCredentialDetails

Object

Οι λεπτομέρειες διαπιστευτηρίων επιστρέφονται κατά τη λήψη μιας σύνδεσης.

Όνομα	Τύπος	Περιγραφή
connectionEncryption	ConnectionEncryption	Η ρύθμιση κρυπτογράφησης σύνδεσης που χρησιμοποιείται κατά τη διάρκεια της δοκιμαστικής σύνδεσης.
credentialType	CredentialType	Ο τύπος διαπιστευτηρίων της σύνδεσης.
singleSignOnType	SingleSignOnType	Ο τύπος καθολικής σύνδεσης της σύνδεσης.
skipTestConnection	boolean	Εάν η σύνδεση θα πρέπει να παραλείπει τη δοκιμαστική σύνδεση κατά τη δημιουργία και την ενημέρωση. True - Παραλείπει τη δοκιμαστική σύνδεση, False - Μην παραλείψετε τη δοκιμαστική σύνδεση.

OnPremisesCredentialEntry

Object

Ένα αναγνωριστικό πύλης και τα κρυπτογραφημένα σειριοποιημένα διαπιστευτήριά του.

Όνομα	Τύπος	Περιγραφή
encryptedCredentials	string	Η κρυπτογραφημένη σειριοποιημένη .json της λίστας ζευγών τιμών ονόματος. Το όνομα είναι ένα όνομα διαπιστευτηρίων και η τιμή είναι μια τιμή διαπιστευτηρίων. Η κρυπτογράφηση εκτελείται με χρήση του αλγόριθμου κρυπτογράφησης Rivest-Shamir-Adleman (RSA) με το δημόσιο κλειδί του μέλους πύλης εσωτερικής εγκατάστασης.
gatewayId	string uuid	Το αναγνωριστικό αντικειμένου της πύλης.

OnPremisesGatewayCredentials

Object

Διαπιστευτήρια για τον έλεγχο ταυτότητας μέσω μιας πύλης εσωτερικής εγκατάστασης.

Όνομα	Τύπος	Περιγραφή
credentialType	CredentialType	Ο τύπος διαπιστευτηρίων της σύνδεσης.
values	OnPremisesCredentialEntry[]	Το ωφέλιμο φορτίο διαπιστευτηρίων που θα αποσταλεί στην πύλη εσωτερικής εγκατάστασης.

PrivacyLevel

Απαρίθμηση

Η ρύθμιση επιπέδου προστασίας προσωπικών δεδομένων της σύνδεσης. Μπορείτε να προσθέσετε επιπλέον επίπεδα προστασίας προσωπικών δεδομένων με την πάροδο του χρόνου.

Τιμή	Περιγραφή
None	Δεν έχει ρυθμιστεί καμία ρύθμιση επιπέδου προστασίας προσωπικών δεδομένων.
Organizational	Οι συνδέσεις που έχουν οριστεί σε εταιρικές μπορούν να αναδιπλωθούν σε ιδιωτικές και άλλες εταιρικές συνδέσεις. Δεν μπορούν να αναδιπλωθούν σε δημόσιες συνδέσεις. Η ορατότητα ορίζεται σε μια αξιόπιστη ομάδα.
Private	Οι συνδέσεις που έχουν οριστεί σε ιδιωτικές περιέχουν ευαίσθητες ή εμπιστευτικές πληροφορίες. Η ορατότητα μπορεί να περιοριστεί σε εξουσιοδοτημένους χρήστες. Τα δεδομένα από μια ιδιωτική σύνδεση δεν θα αναδιπλώνονται σε άλλες συνδέσεις, συμπεριλαμβανομένων άλλων ιδιωτικών συνδέσεων.
Public	Τα αρχεία, οι συνδέσεις Internet και τα δεδομένα βιβλίων εργασίας μπορούν να οριστούν σε δημόσια. Τα δεδομένα μπορούν να αναδιπλωθούν σε άλλες συνδέσεις. Η ορατότητα είναι διαθέσιμη σε όλους.

ServicePrincipalCredentials

Object

Διαπιστευτήρια για το ServicePrincipal CredentialType.

Όνομα	Τύπος	Περιγραφή
credentialType	string: ServicePrincipal	Ο τύπος διαπιστευτηρίων της σύνδεσης.
servicePrincipalClientId	string uuid	Το αναγνωριστικό προγράμματος-πελάτη της κύριας υπηρεσίας.
servicePrincipalSecret	string	Το μυστικό της κύριας υπηρεσίας.
tenantId	string uuid	Το αναγνωριστικό μισθωτή της κύριας υπηρεσίας.

SharedAccessSignatureCredentials

Object

Διαπιστευτήρια για το SharedAccessSignature CredentialType.

Όνομα	Τύπος	Περιγραφή
credentialType	string: SharedAccessSignature	Ο τύπος διαπιστευτηρίων της σύνδεσης.
token	string	Το διακριτικό.

SingleSignOnType

Απαρίθμηση

Ο τύπος καθολικής σύνδεσης της σύνδεσης. Επιπλέον τύποι καθολικής σύνδεσης μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή	Περιγραφή
Kerberos	Η σύνδεση χρησιμοποιεί καθολική σύνδεση Kerberos για σύνδεση.
KerberosDirectQueryAndRefresh	Η σύνδεση χρησιμοποιεί τα Kerberos DirectQuery και καθολική σύνδεση ανανέωσης για τη σύνδεση.
MicrosoftEntraID	Η σύνδεση χρησιμοποιεί το Αναγνωριστικό Microsoft Entra για σύνδεση.
None	Η σύνδεση δεν χρησιμοποιεί καθολική σύνδεση για σύνδεση.
SecurityAssertionMarkupLanguage	Η σύνδεση χρησιμοποιεί καθολική σύνδεση γλώσσας σήμανσης διεκδίκησης ασφαλείας (SAML) για σύνδεση.

WindowsCredentials

Object

Διαπιστευτήρια για το Windows CredentialType.

Όνομα	Τύπος	Περιγραφή
credentialType	string: Windows	Ο τύπος διαπιστευτηρίων της σύνδεσης.
password	string	Ο κωδικός πρόσβασης.
username	string	Το όνομα χρήστη.

WindowsWithoutImpersonationCredentials

Object

Διαπιστευτήρια για το WindowsWithoutImpersonation CredentialType.

Όνομα	Τύπος	Περιγραφή
credentialType	string: WindowsWithoutImpersonation	Ο τύπος διαπιστευτηρίων της σύνδεσης.

WorkspaceIdentityCredentials

Object

Διαπιστευτήρια για το WorkspaceIdentity CredentialType.

Όνομα	Τύπος	Περιγραφή
credentialType	string: WorkspaceIdentity	Ο τύπος διαπιστευτηρίων της σύνδεσης.

Κοινή χρήση μέσω

Connections - Create Connection

Δικαιώματα

Απαιτούμενες εμβέλειες με ανάθεση

Υποστηριζόμενες ταυτότητες Microsoft Entra

Διεπαφή

Κυρίως τμήμα αίτησης

CreateCloudConnectionRequest

CreateOnPremisesConnectionRequest

CreateVirtualNetworkGatewayConnectionRequest

Αποκρίσεις

Παραδείγματα

Cloud example

Δείγμα αίτησης

Δείγμα απόκρισης

Virtual network gateway example

Δείγμα αίτησης

Δείγμα απόκρισης

Ορισμοί

AnonymousCredentials

BasicCredentials

Connection

ConnectionDetailsBooleanParameter

ConnectionDetailsDateParameter

ConnectionDetailsDateTimeParameter

ConnectionDetailsDateTimeZoneParameter

ConnectionDetailsDurationParameter

ConnectionDetailsNumberParameter

ConnectionDetailsTextParameter

ConnectionDetailsTimeParameter

ConnectionEncryption

ConnectivityType

CreateCloudConnectionRequest

CreateConnectionDetails

CreateCredentialDetails

CreateOnPremisesConnectionRequest

CreateOnPremisesCredentialDetails

CreateVirtualNetworkGatewayConnectionRequest

CredentialType

DataType

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

KeyCredentials

ListConnectionDetails

ListCredentialDetails

OnPremisesCredentialEntry

OnPremisesGatewayCredentials

PrivacyLevel

ServicePrincipalCredentials

SharedAccessSignatureCredentials

SingleSignOnType

WindowsCredentials

WindowsWithoutImpersonationCredentials

WorkspaceIdentityCredentials

Πρόσθετοι πόροι