Connections - Create Connection
Δημιουργεί μια σύνδεση.
Για να κρυπτογραφήσετε διαπιστευτήρια, ανατρέξτε στο θέμα Ρύθμιση παραμέτρων διαπιστευτηρίων μέσω προγραμματισμού.
- Εάν δημιουργεί μια σύνδεση πύλης, ο καλών πρέπει να έχει δικαιώματα για την πύλη.
- Οι οντότητες υπηρεσίας πρέπει να έχουν εκχωρηθεί δικαιώματα από τον διαχειριστή Fabric. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα: Οι οντότητες υπηρεσίας μπορούν να δημιουργούν χώρους εργασίας, συνδέσεις και διοχετεύσεις ανάπτυξης.
Connection.ReadWrite.All
Αυτό το API υποστηρίζει τις ταυτότητες Microsoft που παρατίθενται σε αυτή την ενότητα.
POST https://api.fabric.microsoft.com/v1/connections
Το σώμα αίτησης μπορεί να είναι ένα από τα εξής:
Όνομα | Περιγραφή |
---|---|
Create |
|
Create |
|
Create |
Όνομα | Απαιτείται | Τύπος | Περιγραφή |
---|---|---|---|
connectionDetails | True |
Οι λεπτομέρειες σύνδεσης της σύνδεσης. |
|
connectivityType | True |
string:
Shareable |
Ο τύπος συνδεσιμότητας της σύνδεσης. |
credentialDetails | True |
Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης. |
|
displayName | True |
string |
Το εμφανιζόμενο όνομα της σύνδεσης. Το μέγιστο μήκος είναι 200 χαρακτήρες. |
allowConnectionUsageInGateway |
boolean |
Να επιτρέπεται η χρήση αυτής της σύνδεσης με πύλες δεδομένων εσωτερικής εγκατάστασης ή πύλες δεδομένων VNet. |
|
privacyLevel |
(Προαιρετικό) Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "Εταιρικό". |
Όνομα | Απαιτείται | Τύπος | Περιγραφή |
---|---|---|---|
connectionDetails | True |
Οι λεπτομέρειες σύνδεσης της σύνδεσης. |
|
connectivityType | True |
string:
On |
Ο τύπος συνδεσιμότητας της σύνδεσης. |
credentialDetails | True |
Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης. |
|
displayName | True |
string |
Το εμφανιζόμενο όνομα της σύνδεσης. Το μέγιστο μήκος είναι 200 χαρακτήρες. |
gatewayId | True |
string (uuid) |
Το αναγνωριστικό αντικειμένου της κύριας πύλης της πύλης εσωτερικής εγκατάστασης στην οποία δημιουργείται η σύνδεση. |
privacyLevel |
(Προαιρετικό) Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "Εταιρικό". |
Όνομα | Απαιτείται | Τύπος | Περιγραφή |
---|---|---|---|
connectionDetails | True |
Οι λεπτομέρειες σύνδεσης της σύνδεσης. |
|
connectivityType | True |
string:
Virtual |
Ο τύπος συνδεσιμότητας της σύνδεσης. |
credentialDetails | True |
Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης. |
|
displayName | True |
string |
Το εμφανιζόμενο όνομα της σύνδεσης. Το μέγιστο μήκος είναι 200 χαρακτήρες. |
gatewayId | True |
string (uuid) |
Το αναγνωριστικό αντικειμένου της εικονικής πύλης δικτύου από την οποία δημιουργείται η σύνδεση. |
privacyLevel |
(Προαιρετικό) Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "Εταιρικό". |
Όνομα | Τύπος | Περιγραφή |
---|---|---|
201 Created | Connection: |
Created. Η επιχείρηση ολοκληρώθηκε με επιτυχία. |
Other Status Codes |
Συνήθεις κωδικοί σφαλμάτων:
|
Δείγμα αίτησης
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": "********"
}
}
}
Δείγμα απόκρισης
{
"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
}
}
Δείγμα αίτησης
POST https://api.fabric.microsoft.com/v1/connections
{
"connectivityType": "OnPremisesGateway",
"gatewayId": "93491300-cfbd-402f-bf17-9ace59a92354",
"displayName": "ContosoOnPremisesConnection",
"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": "Windows",
"values": [
{
"gatewayId": "93491300-cfbd-402f-bf17-9ace59a92354",
"encryptedCredentials": "************************************"
},
{
"gatewayId": "55226bab-5024-4b72-9716-6dc8ef3a97fe",
"encryptedCredentials": "************************************"
}
]
}
}
}
Δείγμα απόκρισης
{
"id": "eeec9a3a-6ef5-4e2b-bb6a-0060bd2f0172",
"displayName": "ContosoOnPremisesConnection",
"gatewayId": "93491300-cfbd-402f-bf17-9ace59a92354",
"connectivityType": "OnPremisesGateway",
"connectionDetails": {
"type": "SQL",
"path": "contoso.database.windows.net;sales"
},
"privacyLevel": "Organizational",
"credentialDetails": {
"credentialType": "Basic",
"singleSignOnType": "None",
"connectionEncryption": "NotEncrypted",
"skipTestConnection": false
}
}
Δείγμα αίτησης
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": "*********"
}
}
}
Δείγμα απόκρισης
{
"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
}
}
Όνομα | Περιγραφή |
---|---|
Anonymous |
Διαπιστευτήρια για το ανώνυμο τύπο διαπιστευτηρίων. |
Basic |
Διαπιστευτήρια για το βασικό τύπο διαπιστευτηρίων. |
Connection |
ConnectionDetailsParameter για δυαδική dataType. |
Connection |
ConnectionDetailsParameter για dataType ημερομηνίας. |
Connection |
ConnectionDetailsParameter για dataType ημερομηνίας/ώρας. |
Connection |
ConnectionDetailsParameter για dataType ημερομηνίας/ώρας/ζώνης. |
Connection |
ConnectionDetailsParameter για dataType διάρκειας. |
Connection |
ConnectionDetailsParameter για τον τύπο δεδομένων αριθμού. |
Connection |
ConnectionDetailsParameter για το text dataType. |
Connection |
ConnectionDetailsParameter για dataType χρόνου. |
Connection |
Ο τύπος κρυπτογράφησης σύνδεσης της σύνδεσης. Ενδέχεται να προστεθούν πρόσθετες τιμές κρυπτογράφησης σύνδεσης με την πάροδο του χρόνου. |
Connectivity |
Ο τύπος συνδεσιμότητας της σύνδεσης. Πρόσθετοι τύποι συνδεσιμότητας μπορούν να προστεθούν με την πάροδο του χρόνου. |
Create |
|
Create |
Η είσοδος λεπτομερειών σύνδεσης για λειτουργίες δημιουργίας. |
Create |
Η εισαγωγή λεπτομερειών διαπιστευτηρίων για τη δημιουργία μιας σύνδεσης. |
Create |
|
Create |
Τα δεδομένα εισόδου λεπτομερειών διαπιστευτηρίων για τη δημιουργία μιας σύνδεσης πύλης εσωτερικής εγκατάστασης. |
Create |
|
Credential |
Ο τύπος διαπιστευτηρίων της σύνδεσης. Επιπλέον τύποι διαπιστευτηρίων μπορούν να προστεθούν με την πάροδο του χρόνου. |
Data |
Ο τύπος δεδομένων της τιμής παραμέτρου δημιουργίας σύνδεσης. Μπορείτε να προσθέσετε επιπλέον τιμές τύπου δεδομένων με την πάροδο του χρόνου. |
Error |
Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα. |
Error |
Η απόκριση σφάλματος. |
Error |
Οι λεπτομέρειες της απόκρισης σφάλματος. |
Key |
Διαπιστευτήρια για το Key CredentialType. |
List |
Το αποτέλεσμα λεπτομερειών σύνδεσης για λειτουργίες λίστας. |
List |
Οι λεπτομέρειες διαπιστευτηρίων επιστρέφονται κατά τη λήψη μιας σύνδεσης. |
On |
Ένα αναγνωριστικό πύλης και τα κρυπτογραφημένα σειριοποιημένα διαπιστευτήριά του. |
On |
Μια σύνδεση που συνδέεται μέσω πύλης δεδομένων εσωτερικής εγκατάστασης. |
On |
Διαπιστευτήρια για τον έλεγχο ταυτότητας μέσω μιας πύλης εσωτερικής εγκατάστασης. |
On |
Μια σύνδεση που συνδέεται μέσω μιας προσωπικής πύλης δεδομένων εσωτερικής εγκατάστασης. |
Personal |
Μια σύνδεση που συνδέεται μέσω του cloud και δεν είναι δυνατή η κοινή χρήση της. |
Privacy |
Η ρύθμιση επιπέδου προστασίας προσωπικών δεδομένων της σύνδεσης. Μπορείτε να προσθέσετε επιπλέον επίπεδα προστασίας προσωπικών δεδομένων με την πάροδο του χρόνου. |
Service |
Διαπιστευτήρια για το ServicePrincipal CredentialType. |
Shareable |
Μια σύνδεση που συνδέεται μέσω του cloud. |
Shared |
Διαπιστευτήρια για το SharedAccessSignature CredentialType. |
Single |
Ο τύπος καθολικής σύνδεσης της σύνδεσης. Επιπλέον τύποι καθολικής σύνδεσης μπορούν να προστεθούν με την πάροδο του χρόνου. |
Virtual |
Μια σύνδεση που συνδέεται μέσω μιας πύλης δεδομένων εικονικού δικτύου. |
Windows |
Διαπιστευτήρια για το Windows CredentialType. |
Windows |
Διαπιστευτήρια για το WindowsWithoutImpersonation CredentialType. |
Workspace |
Διαπιστευτήρια για το WorkspaceIdentity CredentialType. |
Διαπιστευτήρια για το ανώνυμο τύπο διαπιστευτηρίων.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
credentialType |
string:
Anonymous |
Ο τύπος διαπιστευτηρίων της σύνδεσης. |
Διαπιστευτήρια για το βασικό τύπο διαπιστευτηρίων.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
credentialType |
string:
Basic |
Ο τύπος διαπιστευτηρίων της σύνδεσης. |
password |
string |
Ο κωδικός πρόσβασης. |
username |
string |
Το όνομα χρήστη. |
ConnectionDetailsParameter για δυαδική dataType.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
dataType |
string:
Boolean |
Ο τύπος δεδομένων της παραμέτρου. |
name |
string |
Το όνομα της παραμέτρου. |
value |
boolean |
Η δυαδική τιμή. |
ConnectionDetailsParameter για dataType ημερομηνίας.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
dataType |
string:
Date |
Ο τύπος δεδομένων της παραμέτρου. |
name |
string |
Το όνομα της παραμέτρου. |
value |
string (date) |
Η τιμή ημερομηνίας που χρησιμοποιεί τη μορφή YYYY-MM-DD. |
ConnectionDetailsParameter για dataType ημερομηνίας/ώρας.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
dataType |
string:
Date |
Ο τύπος δεδομένων της παραμέτρου. |
name |
string |
Το όνομα της παραμέτρου. |
value |
string (date-time) |
Η τιμή ημερομηνίας/ώρας που χρησιμοποιεί ΕΕΕΕ-ΜΜ-ΗΗH:λλ:δδ. Μορφή FFFZ. |
ConnectionDetailsParameter για dataType ημερομηνίας/ώρας/ζώνης.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
dataType |
string:
Date |
Ο τύπος δεδομένων της παραμέτρου. |
name |
string |
Το όνομα της παραμέτρου. |
value |
string (date-time-offset) |
Η τιμή ζώνης ώρας που χρησιμοποιεί ΕΕΕΕ-ΜΜ-DDTHH:mm:ss. FFF±hh:mm μορφή. |
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 δευτερόλεπτα). |
ConnectionDetailsParameter για τον τύπο δεδομένων αριθμού.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
dataType |
string:
Number |
Ο τύπος δεδομένων της παραμέτρου. |
name |
string |
Το όνομα της παραμέτρου. |
value |
number |
Η αριθμητική τιμή. |
ConnectionDetailsParameter για το text dataType.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
dataType |
string:
Text |
Ο τύπος δεδομένων της παραμέτρου. |
name |
string |
Το όνομα της παραμέτρου. |
value |
string |
Η τιμή κειμένου. |
ConnectionDetailsParameter για dataType χρόνου.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
dataType |
string:
Time |
Ο τύπος δεδομένων της παραμέτρου. |
name |
string |
Το όνομα της παραμέτρου. |
value |
string (time) |
Η τιμή ώρας που χρησιμοποιεί HH:mm:ss. Μορφή FFFZ. |
Ο τύπος κρυπτογράφησης σύνδεσης της σύνδεσης. Ενδέχεται να προστεθούν πρόσθετες τιμές κρυπτογράφησης σύνδεσης με την πάροδο του χρόνου.
Τιμή | Περιγραφή |
---|---|
Encrypted |
Η προσπάθεια σύνδεσης γίνεται χρησιμοποιώντας μια κρυπτογραφημένη σύνδεση. |
Any |
Η προσπάθεια σύνδεσης πραγματοποιείται πρώτα χρησιμοποιώντας μια κρυπτογραφημένη σύνδεση και, στη συνέχεια, επιστρέφει σε μη κρυπτογραφημένη σύνδεση, εάν δεν είναι επιτυχής. |
NotEncrypted |
Η προσπάθεια σύνδεσης γίνεται χρησιμοποιώντας μια μη κρυπτογραφημένη σύνδεση. |
Ο τύπος συνδεσιμότητας της σύνδεσης. Πρόσθετοι τύποι συνδεσιμότητας μπορούν να προστεθούν με την πάροδο του χρόνου.
Τιμή | Περιγραφή |
---|---|
ShareableCloud |
Η σύνδεση συνδέεται μέσω του cloud και μπορεί να τεθεί σε κοινή χρήση με άλλους χρήστες. |
PersonalCloud |
Η σύνδεση συνδέεται μέσω του cloud και δεν είναι δυνατή η κοινή χρήση της με άλλους χρήστες. |
OnPremisesGateway |
Η σύνδεση συνδέεται μέσω μιας πύλης δεδομένων εσωτερικής εγκατάστασης. |
OnPremisesGatewayPersonal |
Η σύνδεση συνδέεται μέσω μιας προσωπικής πύλης δεδομένων εσωτερικής εγκατάστασης. |
VirtualNetworkGateway |
Η σύνδεση συνδέεται μέσω μιας πύλης δεδομένων εικονικού δικτύου. |
Automatic |
Η σύνδεση συνδέεται μέσω του cloud χρησιμοποιώντας μια έμμεση σύνδεση δεδομένων. Αυτή η επιλογή είναι διαθέσιμη μόνο για συγκεκριμένα σενάρια, όπως σημασιολογικά μοντέλα που χρησιμοποιούν Μονή Sign-On (SSO)." |
None |
Η σύνδεση δεν είναι δεσμευμένη |
Όνομα | Τύπος | Περιγραφή |
---|---|---|
allowConnectionUsageInGateway |
boolean |
Να επιτρέπεται η χρήση αυτής της σύνδεσης με πύλες δεδομένων εσωτερικής εγκατάστασης ή πύλες δεδομένων VNet. |
connectionDetails |
Οι λεπτομέρειες σύνδεσης της σύνδεσης. |
|
connectivityType |
string:
Shareable |
Ο τύπος συνδεσιμότητας της σύνδεσης. |
credentialDetails |
Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης. |
|
displayName |
string |
Το εμφανιζόμενο όνομα της σύνδεσης. Το μέγιστο μήκος είναι 200 χαρακτήρες. |
privacyLevel |
(Προαιρετικό) Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "Εταιρικό". |
Η είσοδος λεπτομερειών σύνδεσης για λειτουργίες δημιουργίας.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
creationMethod |
string |
Η μέθοδος δημιουργίας που χρησιμοποιήθηκε για τη δημιουργία της σύνδεσης. Για μια λίστα μεθόδων δημιουργίας, χρησιμοποιήστε το API ListSupportedConnectionTypes . |
parameters | ConnectionDetailsParameter[]: |
Η λίστα παραμέτρων σύνδεσης. Για μια λίστα παραμέτρων για κάθε μέθοδο δημιουργίας, χρησιμοποιήστε το API ListSupportedConnectionTypes . |
type |
string |
Ο τύπος της σύνδεσης. |
Η εισαγωγή λεπτομερειών διαπιστευτηρίων για τη δημιουργία μιας σύνδεσης.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
connectionEncryption |
(Προαιρετικό) Η ρύθμιση κρυπτογράφησης σύνδεσης που χρησιμοποιείται κατά τη διάρκεια της δοκιμαστικής σύνδεσης. Όταν δεν μεταβιβάζεται καμία τιμή, η σύνδεση δεν κρυπτογραφείται. |
|
credentials | Credentials: |
Τα διαπιστευτήρια της σύνδεσης. |
singleSignOnType |
(Προαιρετικό) Ο τύπος καθολικής σύνδεσης της σύνδεσης. Όταν δεν διαβιβάζεται καμία τιμή, η σύνδεση δεν χρησιμοποιεί καθολική σύνδεση. |
|
skipTestConnection |
boolean |
Εάν η σύνδεση θα πρέπει να παραλείπει τη δοκιμαστική σύνδεση κατά τη δημιουργία και την ενημέρωση. True - Παραλείπει τη δοκιμαστική σύνδεση, False - Μην παραλείψετε τη δοκιμαστική σύνδεση. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "False". |
Όνομα | Τύπος | Περιγραφή |
---|---|---|
connectionDetails |
Οι λεπτομέρειες σύνδεσης της σύνδεσης. |
|
connectivityType |
string:
On |
Ο τύπος συνδεσιμότητας της σύνδεσης. |
credentialDetails |
Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης. |
|
displayName |
string |
Το εμφανιζόμενο όνομα της σύνδεσης. Το μέγιστο μήκος είναι 200 χαρακτήρες. |
gatewayId |
string (uuid) |
Το αναγνωριστικό αντικειμένου της κύριας πύλης της πύλης εσωτερικής εγκατάστασης στην οποία δημιουργείται η σύνδεση. |
privacyLevel |
(Προαιρετικό) Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "Εταιρικό". |
Τα δεδομένα εισόδου λεπτομερειών διαπιστευτηρίων για τη δημιουργία μιας σύνδεσης πύλης εσωτερικής εγκατάστασης.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
connectionEncryption |
(Προαιρετικό) Η ρύθμιση κρυπτογράφησης σύνδεσης που χρησιμοποιείται κατά τη διάρκεια της δοκιμαστικής σύνδεσης. Όταν δεν μεταβιβάζεται καμία τιμή, η σύνδεση δεν κρυπτογραφείται. |
|
credentials |
Τα διαπιστευτήρια της σύνδεσης. |
|
singleSignOnType |
(Προαιρετικό) Ο τύπος καθολικής σύνδεσης της σύνδεσης. Όταν δεν διαβιβάζεται καμία τιμή, η σύνδεση δεν χρησιμοποιεί καθολική σύνδεση. |
|
skipTestConnection |
boolean |
Εάν η σύνδεση θα πρέπει να παραλείπει τη δοκιμαστική σύνδεση κατά τη δημιουργία και την ενημέρωση. True - Παραλείπει τη δοκιμαστική σύνδεση, False - Μην παραλείψετε τη δοκιμαστική σύνδεση. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "False". |
Όνομα | Τύπος | Περιγραφή |
---|---|---|
connectionDetails |
Οι λεπτομέρειες σύνδεσης της σύνδεσης. |
|
connectivityType |
string:
Virtual |
Ο τύπος συνδεσιμότητας της σύνδεσης. |
credentialDetails |
Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης. |
|
displayName |
string |
Το εμφανιζόμενο όνομα της σύνδεσης. Το μέγιστο μήκος είναι 200 χαρακτήρες. |
gatewayId |
string (uuid) |
Το αναγνωριστικό αντικειμένου της εικονικής πύλης δικτύου από την οποία δημιουργείται η σύνδεση. |
privacyLevel |
(Προαιρετικό) Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. Όταν δεν διαβιβαστεί καμία τιμή, αυτή ορίζεται σε "Εταιρικό". |
Ο τύπος διαπιστευτηρίων της σύνδεσης. Επιπλέον τύποι διαπιστευτηρίων μπορούν να προστεθούν με την πάροδο του χρόνου.
Τιμή | Περιγραφή |
---|---|
Windows |
Η σύνδεση χρησιμοποιεί έλεγχο ταυτότητας των Windows για τη σύνδεση. Υποστηρίζεται μόνο για πύλες εσωτερικής εγκατάστασης. |
Anonymous |
Η σύνδεση χρησιμοποιεί ανώνυμο έλεγχο ταυτότητας για τη σύνδεση. |
Basic |
Η σύνδεση χρησιμοποιεί βασικό έλεγχο ταυτότητας για τη σύνδεση. |
Key |
Η σύνδεση χρησιμοποιεί έλεγχο ταυτότητας κλειδιού για τη σύνδεση. |
OAuth2 |
Η σύνδεση χρησιμοποιεί έλεγχο ταυτότητας OAuth 2.0 για τη σύνδεση. |
WindowsWithoutImpersonation |
Η σύνδεση χρησιμοποιεί τον έλεγχο ταυτότητας των Windows (χωρίς την επιλογή απομίμησης) για τη σύνδεση. Υποστηρίζεται μόνο για πύλες εσωτερικής εγκατάστασης (προσωπική λειτουργία). |
SharedAccessSignature |
Η σύνδεση χρησιμοποιεί έλεγχο ταυτότητας υπογραφής κοινόχρηστής πρόσβασης (SAS) για σύνδεση. |
ServicePrincipal |
Η σύνδεση χρησιμοποιεί έλεγχο ταυτότητας κύριας υπηρεσίας για τη σύνδεση. |
WorkspaceIdentity |
Η σύνδεση χρησιμοποιεί έλεγχο ταυτότητας χώρου εργασίας για τη σύνδεση. |
Ο τύπος δεδομένων της τιμής παραμέτρου δημιουργίας σύνδεσης. Μπορείτε να προσθέσετε επιπλέον τιμές τύπου δεδομένων με την πάροδο του χρόνου.
Τιμή | Περιγραφή |
---|---|
Text |
Χρησιμοποιήστε κείμενο ως τιμή εισόδου παραμέτρου. |
Number |
Χρησιμοποιήστε τον αριθμό ως την τιμή εισόδου παραμέτρου (ακέραιο ή κινητής υποδιαστολής). |
Boolean |
Χρησιμοποιήστε δυαδική τιμή ως τιμή εισόδου παραμέτρου. False - η τιμή είναι false, True - η τιμή είναι true. |
Duration |
Χρησιμοποιήστε τη διάρκεια ως τιμή εισόδου παραμέτρου, χρησιμοποιώντας τη μορφή [-]P(n)DT(n)H(n)M(n)S. Για παράδειγμα: P3DT4H30M10S (για 3 ημέρες, 4 ώρες, 30 λεπτά και 10 δευτερόλεπτα). |
Date |
Χρησιμοποιήστε την ημερομηνία ως τιμή εισόδου παραμέτρου, χρησιμοποιώντας τη μορφήMM-DD YYYY. |
DateTime |
Χρησιμοποιήστε την ώρα ημερομηνίας ως τιμή εισόδου παραμέτρου, χρησιμοποιώντας ΕΕΕΕ-ΜΜ-DDTHH:mm:ss. Μορφή FFFZ. |
DateTimeZone |
Χρησιμοποιήστε τη ζώνη ώρας ως τιμή εισόδου παραμέτρου, χρησιμοποιώντας ΕΕΕΕ-ΜΜ-DDTHH:mm:ss. FFF±hh:mm μορφή. |
Time |
Χρησιμοποιήστε τον χρόνο ως τιμή εισόδου παραμέτρου, χρησιμοποιώντας HH:mm:ss. Μορφή FFFZ. |
Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
resourceId |
string |
Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα. |
resourceType |
string |
Ο τύπος του πόρου που εμπλέκεται στο σφάλμα. |
Η απόκριση σφάλματος.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
errorCode |
string |
Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της. |
message |
string |
Μια αναγνώσιμη αναπαράσταση του σφάλματος. |
moreDetails |
Λίστα πρόσθετων λεπτομερειών σφάλματος. |
|
relatedResource |
Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα. |
|
requestId |
string |
Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα. |
Οι λεπτομέρειες της απόκρισης σφάλματος.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
errorCode |
string |
Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της. |
message |
string |
Μια αναγνώσιμη αναπαράσταση του σφάλματος. |
relatedResource |
Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα. |
Διαπιστευτήρια για το Key CredentialType.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
credentialType |
string:
Key |
Ο τύπος διαπιστευτηρίων της σύνδεσης. |
key |
string |
Το κλειδί. |
Το αποτέλεσμα λεπτομερειών σύνδεσης για λειτουργίες λίστας.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
path |
string |
Η διαδρομή της σύνδεσης. |
type |
string |
Ο τύπος της σύνδεσης. |
Οι λεπτομέρειες διαπιστευτηρίων επιστρέφονται κατά τη λήψη μιας σύνδεσης.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
connectionEncryption |
Η ρύθμιση κρυπτογράφησης σύνδεσης που χρησιμοποιείται κατά τη διάρκεια της δοκιμαστικής σύνδεσης. |
|
credentialType |
Ο τύπος διαπιστευτηρίων της σύνδεσης. |
|
singleSignOnType |
Ο τύπος καθολικής σύνδεσης της σύνδεσης. |
|
skipTestConnection |
boolean |
Εάν η σύνδεση θα πρέπει να παραλείπει τη δοκιμαστική σύνδεση κατά τη δημιουργία και την ενημέρωση. True - Παραλείπει τη δοκιμαστική σύνδεση, False - Μην παραλείψετε τη δοκιμαστική σύνδεση. |
Ένα αναγνωριστικό πύλης και τα κρυπτογραφημένα σειριοποιημένα διαπιστευτήριά του.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
encryptedCredentials |
string |
Η κρυπτογραφημένη σειριοποιημένη .json της λίστας ζευγών τιμών ονόματος. Το όνομα είναι ένα όνομα διαπιστευτηρίων και η τιμή είναι μια τιμή διαπιστευτηρίων. Η κρυπτογράφηση εκτελείται με χρήση του αλγόριθμου κρυπτογράφησης Rivest-Shamir-Adleman (RSA) με το δημόσιο κλειδί του μέλους πύλης εσωτερικής εγκατάστασης. |
gatewayId |
string (uuid) |
Το αναγνωριστικό αντικειμένου της πύλης. |
Μια σύνδεση που συνδέεται μέσω πύλης δεδομένων εσωτερικής εγκατάστασης.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
connectionDetails |
Οι λεπτομέρειες σύνδεσης της σύνδεσης. |
|
connectivityType |
string:
On |
Ο τύπος συνδεσιμότητας της σύνδεσης. |
credentialDetails |
Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης. |
|
displayName |
string |
Το εμφανιζόμενο όνομα της σύνδεσης. |
gatewayId |
string (uuid) |
Το αναγνωριστικό αντικειμένου πύλης της σύνδεσης. |
id |
string (uuid) |
Το αναγνωριστικό αντικειμένου της σύνδεσης. |
privacyLevel |
Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. |
Διαπιστευτήρια για τον έλεγχο ταυτότητας μέσω μιας πύλης εσωτερικής εγκατάστασης.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
credentialType |
Ο τύπος διαπιστευτηρίων της σύνδεσης. |
|
values |
Το ωφέλιμο φορτίο διαπιστευτηρίων που θα αποσταλεί στην πύλη εσωτερικής εγκατάστασης. |
Μια σύνδεση που συνδέεται μέσω μιας προσωπικής πύλης δεδομένων εσωτερικής εγκατάστασης.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
connectionDetails |
Οι λεπτομέρειες σύνδεσης της σύνδεσης. |
|
connectivityType |
string:
On |
Ο τύπος συνδεσιμότητας της σύνδεσης. |
credentialDetails |
Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης. |
|
displayName |
string |
Το εμφανιζόμενο όνομα της σύνδεσης. |
gatewayId |
string (uuid) |
Το αναγνωριστικό αντικειμένου πύλης της σύνδεσης. |
id |
string (uuid) |
Το αναγνωριστικό αντικειμένου της σύνδεσης. |
privacyLevel |
Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. |
Μια σύνδεση που συνδέεται μέσω του cloud και δεν είναι δυνατή η κοινή χρήση της.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
allowConnectionUsageInGateway |
boolean |
Να επιτρέπεται η χρήση αυτής της σύνδεσης με πύλες δεδομένων εσωτερικής εγκατάστασης ή πύλες δεδομένων VNet. |
connectionDetails |
Οι λεπτομέρειες σύνδεσης της σύνδεσης. |
|
connectivityType |
string:
Personal |
Ο τύπος συνδεσιμότητας της σύνδεσης. |
credentialDetails |
Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης. |
|
displayName |
string |
Το εμφανιζόμενο όνομα της σύνδεσης. |
id |
string (uuid) |
Το αναγνωριστικό αντικειμένου της σύνδεσης. |
privacyLevel |
Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. |
Η ρύθμιση επιπέδου προστασίας προσωπικών δεδομένων της σύνδεσης. Μπορείτε να προσθέσετε επιπλέον επίπεδα προστασίας προσωπικών δεδομένων με την πάροδο του χρόνου.
Τιμή | Περιγραφή |
---|---|
None |
Δεν έχει ρυθμιστεί καμία ρύθμιση επιπέδου προστασίας προσωπικών δεδομένων. |
Private |
Οι συνδέσεις που έχουν οριστεί σε ιδιωτικές περιέχουν ευαίσθητες ή εμπιστευτικές πληροφορίες. Η ορατότητα μπορεί να περιοριστεί σε εξουσιοδοτημένους χρήστες. Τα δεδομένα από μια ιδιωτική σύνδεση δεν θα αναδιπλώνονται σε άλλες συνδέσεις, συμπεριλαμβανομένων άλλων ιδιωτικών συνδέσεων. |
Organizational |
Οι συνδέσεις που έχουν οριστεί σε εταιρικές μπορούν να αναδιπλωθούν σε ιδιωτικές και άλλες εταιρικές συνδέσεις. Δεν μπορούν να αναδιπλωθούν σε δημόσιες συνδέσεις. Η ορατότητα ορίζεται σε μια αξιόπιστη ομάδα. |
Public |
Τα αρχεία, οι συνδέσεις Internet και τα δεδομένα βιβλίων εργασίας μπορούν να οριστούν σε δημόσια. Τα δεδομένα μπορούν να αναδιπλωθούν σε άλλες συνδέσεις. Η ορατότητα είναι διαθέσιμη σε όλους. |
Διαπιστευτήρια για το ServicePrincipal CredentialType.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
credentialType |
string:
Service |
Ο τύπος διαπιστευτηρίων της σύνδεσης. |
servicePrincipalClientId |
string (uuid) |
Το αναγνωριστικό προγράμματος-πελάτη της κύριας υπηρεσίας. |
servicePrincipalSecret |
string |
Το μυστικό της κύριας υπηρεσίας. |
tenantId |
string (uuid) |
Το αναγνωριστικό μισθωτή της κύριας υπηρεσίας. |
Μια σύνδεση που συνδέεται μέσω του cloud.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
allowConnectionUsageInGateway |
boolean |
Να επιτρέπεται η χρήση αυτής της σύνδεσης με πύλες δεδομένων εσωτερικής εγκατάστασης ή πύλες δεδομένων VNet. |
connectionDetails |
Οι λεπτομέρειες σύνδεσης της σύνδεσης. |
|
connectivityType |
string:
Shareable |
Ο τύπος συνδεσιμότητας της σύνδεσης. |
credentialDetails |
Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης. |
|
displayName |
string |
Το εμφανιζόμενο όνομα της σύνδεσης. |
id |
string (uuid) |
Το αναγνωριστικό αντικειμένου της σύνδεσης. |
privacyLevel |
Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. |
Διαπιστευτήρια για το SharedAccessSignature CredentialType.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
credentialType |
string:
Shared |
Ο τύπος διαπιστευτηρίων της σύνδεσης. |
token |
string |
Το διακριτικό. |
Ο τύπος καθολικής σύνδεσης της σύνδεσης. Επιπλέον τύποι καθολικής σύνδεσης μπορούν να προστεθούν με την πάροδο του χρόνου.
Τιμή | Περιγραφή |
---|---|
None |
Η σύνδεση δεν χρησιμοποιεί καθολική σύνδεση για σύνδεση. |
Kerberos |
Η σύνδεση χρησιμοποιεί καθολική σύνδεση Kerberos για σύνδεση. |
MicrosoftEntraID |
Η σύνδεση χρησιμοποιεί το Αναγνωριστικό Microsoft Entra για σύνδεση. |
SecurityAssertionMarkupLanguage |
Η σύνδεση χρησιμοποιεί καθολική σύνδεση γλώσσας σήμανσης διεκδίκησης ασφαλείας (SAML) για σύνδεση. |
KerberosDirectQueryAndRefresh |
Η σύνδεση χρησιμοποιεί τα Kerberos DirectQuery και καθολική σύνδεση ανανέωσης για τη σύνδεση. |
Μια σύνδεση που συνδέεται μέσω μιας πύλης δεδομένων εικονικού δικτύου.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
connectionDetails |
Οι λεπτομέρειες σύνδεσης της σύνδεσης. |
|
connectivityType |
string:
Virtual |
Ο τύπος συνδεσιμότητας της σύνδεσης. |
credentialDetails |
Οι λεπτομέρειες διαπιστευτηρίων της σύνδεσης. |
|
displayName |
string |
Το εμφανιζόμενο όνομα της σύνδεσης. |
gatewayId |
string (uuid) |
Το αναγνωριστικό αντικειμένου πύλης της σύνδεσης. |
id |
string (uuid) |
Το αναγνωριστικό αντικειμένου της σύνδεσης. |
privacyLevel |
Το επίπεδο προστασίας προσωπικών δεδομένων της σύνδεσης. |
Διαπιστευτήρια για το Windows CredentialType.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
credentialType |
string:
Windows |
Ο τύπος διαπιστευτηρίων της σύνδεσης. |
password |
string |
Ο κωδικός πρόσβασης. |
username |
string |
Το όνομα χρήστη. |
Διαπιστευτήρια για το WindowsWithoutImpersonation CredentialType.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
credentialType |
string:
Windows |
Ο τύπος διαπιστευτηρίων της σύνδεσης. |
Διαπιστευτήρια για το WorkspaceIdentity CredentialType.
Όνομα | Τύπος | Περιγραφή |
---|---|---|
credentialType |
string:
Workspace |
Ο τύπος διαπιστευτηρίων της σύνδεσης. |