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

OneLake Shortcuts - Create Shortcut

  • Αναφορά
Υπηρεσία:
Core
Έκδοση API:
v1

Δημιουργεί μια νέα συντόμευση ή ενημερώνει μια υπάρχουσα συντόμευση.

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

OneLake.ReadWrite.All

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

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

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

Διασύνδεση

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/shortcuts
Με προαιρετικές παραμέτρους: 
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/items/{itemId}/shortcuts?shortcutConflictPolicy={shortcutConflictPolicy}

Παράμετροι URI

Όνομα Σε Απαιτείται Τύπος Περιγραφή
itemId
 path True

string (uuid)

Το αναγνωριστικό του στοιχείου δεδομένων.
workspaceId
 path True

string (uuid)

Το αναγνωριστικό του χώρου εργασίας.
shortcutConflictPolicy
 query

ShortcutConflictPolicy

Όταν παρέχεται, ορίζει την ενέργεια που θα εκτελεστεί όταν υπάρχει ήδη μια συντόμευση με το ίδιο όνομα και διαδρομή. Η προεπιλεγμένη ενέργεια είναι "Ματαίωση". Πρόσθετοι τύποι ShortcutConflictPolicy μπορούν να προστεθούν με την πάροδο του χρόνου.

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

Όνομα Απαιτείται Τύπος Περιγραφή
name True

string

Το όνομα της συντόμευσης.
path True

string

Μια συμβολοσειρά που αντιπροσωπεύει την πλήρη διαδρομή όπου δημιουργείται η συντόμευση, συμπεριλαμβανομένων των στοιχείων "Αρχεία" ή "Πίνακες".
target True

CreatableShortcutTarget

Ένα αντικείμενο που περιέχει την προέλευση δεδομένων προορισμού και πρέπει να καθορίσει ακριβώς έναν από τους υποστηριζόμενους προορισμούς: OneLake, Amazon S3, ADLS Gen2, Χώρο αποθήκευσης Google Cloud, συμβατό με S3 ή Dataverse.

Αποκρίσεις

Όνομα Τύπος Περιγραφή
200 OK

Shortcut

Επιτυχής ενημέρωση.

Κεφαλίδες

Location: string
201 Created

Shortcut

Δημιουργήθηκε με επιτυχία.

Κεφαλίδες

Location: string
Other Status Codes

ErrorResponse

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

  • ItemNotFound - Ο διακομιστής δεν μπορεί να βρει το στοιχείο που ζητήθηκε.

  • UnknownError - Παρουσιάστηκε σφάλμα.

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

Create or update shortcut target to OneLake
Create shortcut AdlsGen2 target example
Create shortcut AmazonS3 target example
Create shortcut Google Cloud Storage target example
Create shortcut One Lake target example
Create shortcut S3 Compatible target example
Update shortcut target to OneLake

Create or update shortcut target to OneLake

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

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts?shortcutConflictPolicy=CreateOrOverwrite

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

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

Κωδικός κατάστασης:
200 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/blafolder/folder3/MyOneLakeShortcut
{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "type": "OneLake",
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Create shortcut AdlsGen2 target example

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

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/landingZone",
  "name": "PartnerProducts",
  "target": {
    "adlsGen2": {
      "location": "https://contosoadlsaccount.dfs.core.windows.net",
      "subpath": "/mycontainer/data/ContosoProducts",
      "connectionId": "91324db9-8dc4-4730-a1e5-bafabf1fb91e"
    }
  }
}

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

Κωδικός κατάστασης:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/landingZone/PartnerProducts
{
  "path": "Files/landingZone",
  "name": "PartnerProducts",
  "target": {
    "type": "AdlsGen2",
    "adlsGen2": {
      "location": "https://contosoadlsaccount.dfs.core.windows.net",
      "subpath": "/mycontainer/data/ContosoProducts",
      "connectionId": "91324db9-8dc4-4730-a1e5-bafabf1fb91e"
    }
  }
}

Create shortcut AmazonS3 target example

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

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/landingZone",
  "name": "PartnerEmployees",
  "target": {
    "amazonS3": {
      "location": "https://my-s3-bucket.s3.us-west-2.amazonaws.com",
      "subpath": "/data/ContosoEmployees",
      "connectionId": "cf480513-2c1c-46b2-958a-42556ee584c3"
    }
  }
}

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

Κωδικός κατάστασης:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/landingZone/PartnerEmployees
{
  "path": "Files/landingZone",
  "name": "PartnerEmployees",
  "target": {
    "type": "AmazonS3",
    "amazonS3": {
      "location": "https://my-s3-bucket.s3.us-west-2.amazonaws.com",
      "subpath": "/data/ContosoEmployees",
      "connectionId": "cf480513-2c1c-46b2-958a-42556ee584c3"
    }
  }
}

Create shortcut Google Cloud Storage target example

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

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/landingZone",
  "name": "MyGCSShortcut1",
  "target": {
    "googleCloudStorage": {
      "location": "https://gcs-contosoBucket.storage.googleapis.com",
      "subpath": "/gcsDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

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

Κωδικός κατάστασης:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/landingZone/MyGCSShortcut1
{
  "path": "Files/landingZone",
  "name": "MyGCSShortcut1",
  "target": {
    "type": "GoogleCloudStorage",
    "googleCloudStorage": {
      "location": "https://gcs-contosoBucket.storage.googleapis.com",
      "subpath": "/gcsDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

Create shortcut One Lake target example

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

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

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

Κωδικός κατάστασης:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/blafolder/folder3/MyOneLakeShortcut
{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "type": "OneLake",
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Create shortcut S3 Compatible target example

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

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts

{
  "path": "Files/landingZone",
  "name": "MyS3CompatibleShortcut1",
  "target": {
    "s3Compatible": {
      "location": "https://s3endpoint.contoso.com",
      "bucket": "contosoBucket1",
      "subpath": "/s3CompatibleDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

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

Κωδικός κατάστασης:
201 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/landingZone/MyS3CompatibleShortcut1
{
  "path": "Files/landingZone",
  "name": "MyS3CompatibleShortcut1",
  "target": {
    "type": "S3Compatible",
    "s3Compatible": {
      "location": "https://s3endpoint.contoso.com",
      "bucket": "contosoBucket1",
      "subpath": "/s3CompatibleDirectory/data/ContosoProducts",
      "connectionId": "3c976446-0bda-472e-8800-f1d6e4f162dc"
    }
  }
}

Update shortcut target to OneLake

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

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts?shortcutConflictPolicy=CreateOrOverwrite

{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

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

Κωδικός κατάστασης:
200 
Location: https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff222/items/25bac802-080d-4f73-8a42-1b406eb1fceb/shortcuts/Files/blafolder/folder3/MyOneLakeShortcut
{
  "path": "Files/blafolder/folder3",
  "name": "MyOneLakeShortcut",
  "target": {
    "type": "OneLake",
    "oneLake": {
      "workspaceId": "acafbeb1-8037-4d0c-896e-a46fb27ff256",
      "itemId": "56bac802-080d-4f73-8a42-1b406eb1fcac",
      "path": "Tables/myTablesFolder/someTableSubFolder"
    }
  }
}

Ορισμοί

Όνομα Περιγραφή
AdlsGen2

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων ADLS Gen2 προορισμού.
AmazonS3

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων Amazon S3 προορισμού.
CreatableShortcutTarget

Ένα αντικείμενο που περιέχει την προέλευση δεδομένων προορισμού και πρέπει να καθορίσει ακριβώς έναν από τους υποστηριζόμενους προορισμούς, όπως περιγράφεται στον παρακάτω πίνακα.
CreateShortcutRequest

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

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων dataverse προορισμού.
ErrorRelatedResource

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

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

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

Ένα αντικείμενο που περιέχει τις ιδιότητες του κοινόχρηστου χώρου εξωτερικών δεδομένων προορισμού.
GoogleCloudStorage

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων χώρου αποθήκευσης Cloud Google προορισμού.
OneLake

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων OneLake προορισμού.
S3Compatible

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων συμβατής με S3 προορισμού.
Shortcut

Ένα αντικείμενο που αντιπροσωπεύει μια αναφορά που παραπέμπει σε άλλες θέσεις αποθήκευσης, οι οποίες μπορεί να είναι εσωτερικές ή εξωτερικές του OneLake. Η συντόμευση ορίζεται με βάση το όνομα, τη διαδρομή όπου δημιουργείται η συντόμευση και τον προορισμό καθορίζοντας τη θέση αποθήκευσης προορισμού.
ShortcutConflictPolicy

Όταν παρέχεται, ορίζει την ενέργεια που θα εκτελεστεί όταν υπάρχει ήδη μια συντόμευση με το ίδιο όνομα και διαδρομή. Η προεπιλεγμένη ενέργεια είναι "Ματαίωση". Πρόσθετοι τύποι ShortcutConflictPolicy μπορούν να προστεθούν με την πάροδο του χρόνου.
Target

Ένα αντικείμενο που περιέχει την προέλευση δεδομένων προορισμού και πρέπει να καθορίσει ακριβώς έναν από τους υποστηριζόμενους προορισμούς, όπως περιγράφεται στον παρακάτω πίνακα.
Type

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

AdlsGen2

Object

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων ADLS Gen2 προορισμού.

Όνομα Τύπος Περιγραφή
connectionId

string (uuid)

Μια συμβολοσειρά που αντιπροσωπεύει τη σύνδεση που συνδέεται με τη συντόμευση. Το connectionId είναι ένα μοναδικό αναγνωριστικό που χρησιμοποιείται για τη δημιουργία μιας σύνδεσης μεταξύ της συντόμευσης και της προέλευσης δεδομένων προορισμού. Για να βρείτε αυτό το αναγνωριστικό σύνδεσης, δημιουργήστε πρώτα μια σύνδεση cloud που θα χρησιμοποιηθεί από τη συντόμευση κατά τη σύνδεση στη θέση δεδομένων ADLS. Ανοίξτε την προβολή Ρυθμίσεις της σύνδεσης cloud και αντιγράψτε το αναγνωριστικό σύνδεσης. αυτό είναι ένα GUID.
location

string (uri)

Καθορίζει τη θέση του κοντέινερ ADLS προορισμού. Το URI πρέπει να έχει τη μορφή https://[account-name].dfs.core.windows.net όπου [account-name] είναι το όνομα του λογαριασμού ADLS προορισμού.
subpath

string

Καθορίζει το κοντέινερ και τον υποφάκελο στον λογαριασμό ADLS όπου βρίσκεται ο φάκελος προορισμού. Πρέπει να έχει τη μορφή [κοντέινερ]/[υποφάκελος] όπου [κοντέινερ] είναι το όνομα του κοντέινερ που περιέχει τα αρχεία και τους φακέλους. [υποφάκελος] είναι το όνομα του υποφακέλου μέσα στο κοντέινερ (προαιρετικό). Για παράδειγμα: /mycontainer/mysubfolder

AmazonS3

Object

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων Amazon S3 προορισμού.

Όνομα Τύπος Περιγραφή
connectionId

string (uuid)

Μια συμβολοσειρά που αντιπροσωπεύει τη σύνδεση που συνδέεται με τη συντόμευση. Το connectionId είναι ένα μοναδικό αναγνωριστικό που χρησιμοποιείται για τη δημιουργία μιας σύνδεσης μεταξύ της συντόμευσης και της προέλευσης δεδομένων προορισμού. Για να βρείτε αυτό το αναγνωριστικό σύνδεσης, δημιουργήστε πρώτα μια σύνδεση cloud που θα χρησιμοποιηθεί από τη συντόμευση κατά τη σύνδεση στην τοποθεσία δεδομένων Amazon S3. Ανοίξτε την προβολή Ρυθμίσεις της σύνδεσης cloud και αντιγράψτε το αναγνωριστικό σύνδεσης. αυτό είναι ένα GUID.
location

string (uri)

Διεύθυνση URL HTTP που δείχνει στον κάδο προορισμού στο S3. Η διεύθυνση URL πρέπει να έχει τη μορφή https://[όνομα-κάδου].s3. [κωδικός-περιοχής].amazonaws.com, όπου "όνομα-κάδου" είναι το όνομα του κάδου S3 στον οποίο θέλετε να επισημάνετε και "κωδικός περιοχής" είναι ο κωδικός για την περιοχή στην οποία βρίσκεται ο κάδος. Για παράδειγμα: https://my-s3-bucket.s3.us-west-2.amazonaws.com
subpath

string

Καθορίζει έναν φάκελο προορισμού ή υποφάκελο εντός του κάδου S3.

CreatableShortcutTarget

Object

Ένα αντικείμενο που περιέχει την προέλευση δεδομένων προορισμού και πρέπει να καθορίσει ακριβώς έναν από τους υποστηριζόμενους προορισμούς, όπως περιγράφεται στον παρακάτω πίνακα.

Όνομα Τύπος Περιγραφή
adlsGen2

AdlsGen2

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων ADLS Gen2 προορισμού.
amazonS3

AmazonS3

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων Amazon S3 προορισμού.
dataverse

Dataverse

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων dataverse προορισμού.
googleCloudStorage

GoogleCloudStorage

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων χώρου αποθήκευσης Cloud Google προορισμού.
oneLake

OneLake

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων OneLake προορισμού.
s3Compatible

S3Compatible

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων συμβατής με S3 προορισμού.

CreateShortcutRequest

Object

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

Όνομα Τύπος Περιγραφή
name

string

Το όνομα της συντόμευσης.
path

string

Μια συμβολοσειρά που αντιπροσωπεύει την πλήρη διαδρομή όπου δημιουργείται η συντόμευση, συμπεριλαμβανομένων των στοιχείων "Αρχεία" ή "Πίνακες".
target

CreatableShortcutTarget

Ένα αντικείμενο που περιέχει την προέλευση δεδομένων προορισμού και πρέπει να καθορίσει ακριβώς έναν από τους υποστηριζόμενους προορισμούς: OneLake, Amazon S3, ADLS Gen2, Χώρο αποθήκευσης Google Cloud, συμβατό με S3 ή Dataverse.

Dataverse

Object

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων dataverse προορισμού.

Όνομα Τύπος Περιγραφή
connectionId

string (uuid)

Μια συμβολοσειρά που αντιπροσωπεύει τη σύνδεση που συνδέεται με τη συντόμευση. Το connectionId είναι ένα μοναδικό αναγνωριστικό που χρησιμοποιείται για τη δημιουργία μιας σύνδεσης μεταξύ της συντόμευσης και της προέλευσης δεδομένων προορισμού. Για να βρείτε αυτό το αναγνωριστικό σύνδεσης, δημιουργήστε πρώτα μια σύνδεση cloud που θα χρησιμοποιηθεί από τη συντόμευση κατά τη σύνδεση στη θέση δεδομένων Dataverse. Ανοίξτε την προβολή Ρυθμίσεις της σύνδεσης cloud και αντιγράψτε το αναγνωριστικό σύνδεσης. αυτό είναι ένα GUID.
deltaLakeFolder

string

Καθορίζει τη διαδρομή φακέλου DeltaLake όπου αποθηκεύονται τα δεδομένα προορισμού.
environmentDomain

string (uri)

URI που υποδεικνύει το όνομα τομέα του περιβάλλοντος προορισμού του Dataverse. Το URI πρέπει να μορφοποιηθεί ως "https://[orgname].crm[xx].dynamics.com", όπου [orgname] αντιπροσωπεύει το όνομα του οργανισμού σας Dataverse.
tableName

string

Καθορίζει το όνομα του πίνακα προορισμού στο Dataverse

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

Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

ExternalDataShareTarget

Object

Ένα αντικείμενο που περιέχει τις ιδιότητες του κοινόχρηστου χώρου εξωτερικών δεδομένων προορισμού.

Όνομα Τύπος Περιγραφή
connectionId

string (uuid)

Μια συμβολοσειρά που αντιπροσωπεύει τη σύνδεση που συνδέεται με τη συντόμευση. Το connectionId είναι ένα μοναδικό αναγνωριστικό που χρησιμοποιείται για τη δημιουργία μιας σύνδεσης μεταξύ της συντόμευσης και της προέλευσης δεδομένων προορισμού.

GoogleCloudStorage

Object

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων χώρου αποθήκευσης Cloud Google προορισμού.

Όνομα Τύπος Περιγραφή
connectionId

string (uuid)

Μια συμβολοσειρά που αντιπροσωπεύει τη σύνδεση που συνδέεται με τη συντόμευση. Το connectionId είναι ένα μοναδικό αναγνωριστικό που χρησιμοποιείται για τη δημιουργία μιας σύνδεσης μεταξύ της συντόμευσης και της προέλευσης δεδομένων προορισμού.
location

string (uri)

Διεύθυνση URL HTTP που δείχνει στον κάδο προορισμού στο GCS. Η διεύθυνση URL θα πρέπει να έχει τη μορφή https://[όνομα-κάδου].storage.googleapis.com, όπου [όνομα-κάδου] είναι το όνομα του κάδου στον οποίο θέλετε να υποδείξετε. Για παράδειγμα: https://my-gcs-bucket.storage.googleapis.com
subpath

string

Καθορίζει έναν φάκελο προορισμού ή υποφάκελο μέσα στον κάδο GCS. Για παράδειγμα: /folder

OneLake

Object

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων OneLake προορισμού.

Όνομα Τύπος Περιγραφή
itemId

string (uuid)

Το αναγνωριστικό του προορισμού στο OneLake. Ο προορισμός μπορεί να είναι ένα στοιχείο του Lakehouse, KQLDatabase ή Warehouse.
path

string

Μια συμβολοσειρά που αντιπροσωπεύει την πλήρη διαδρομή προς τον φάκελο προορισμού μέσα στο Στοιχείο. Αυτή η διαδρομή θα πρέπει να είναι σχετική με τη ρίζα της δομής καταλόγου OneLake. Για παράδειγμα: "Tables/myTablesFolder/someTableSubFolder".
workspaceId

string (uuid)

Το αναγνωριστικό του χώρου εργασίας προορισμού.

S3Compatible

Object

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων συμβατής με S3 προορισμού.

Όνομα Τύπος Περιγραφή
bucket

string

Καθορίζει τον κάδο προορισμού μέσα στη θέση συμβατής με S3.
connectionId

string (uuid)

Μια συμβολοσειρά που αντιπροσωπεύει τη σύνδεση που συνδέεται με τη συντόμευση. Το connectionId είναι ένα μοναδικό αναγνωριστικό που χρησιμοποιείται για τη δημιουργία μιας σύνδεσης μεταξύ της συντόμευσης και της προέλευσης δεδομένων προορισμού.
location

string (uri)

Διεύθυνση URL HTTP του τελικού σημείου συμβατής με S3. Αυτό το τελικό σημείο πρέπει να μπορεί να λαμβάνει κλήσεις API ListBuckets S3. Η διεύθυνση URL πρέπει να είναι σε μορφή που δεν είναι κάδος. δεν πρέπει να καθοριστεί κάδος εδώ. Για παράδειγμα: https://s3endpoint.contoso.com
subpath

string

Καθορίζει έναν φάκελο προορισμού ή έναν υποφάκελο στον κάδο που είναι συμβατός με S3. Για παράδειγμα: /folder

Shortcut

Object

Ένα αντικείμενο που αντιπροσωπεύει μια αναφορά που παραπέμπει σε άλλες θέσεις αποθήκευσης, οι οποίες μπορεί να είναι εσωτερικές ή εξωτερικές του OneLake. Η συντόμευση ορίζεται με βάση το όνομα, τη διαδρομή όπου δημιουργείται η συντόμευση και τον προορισμό καθορίζοντας τη θέση αποθήκευσης προορισμού.

Όνομα Τύπος Περιγραφή
name

string

Το όνομα της συντόμευσης.
path

string

Μια συμβολοσειρά που αντιπροσωπεύει την πλήρη διαδρομή όπου δημιουργείται η συντόμευση, συμπεριλαμβανομένων των στοιχείων "Αρχεία" ή "Πίνακες".
target

Target

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

ShortcutConflictPolicy

Απαρίθμηση

Όταν παρέχεται, ορίζει την ενέργεια που θα εκτελεστεί όταν υπάρχει ήδη μια συντόμευση με το ίδιο όνομα και διαδρομή. Η προεπιλεγμένη ενέργεια είναι "Ματαίωση". Πρόσθετοι τύποι ShortcutConflictPolicy μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή Περιγραφή
Abort

Όταν υπάρχει ήδη μια συντόμευση με το ίδιο όνομα και διαδρομή, η δημιουργία συντόμευσης θα ακυρωθεί.
CreateOrOverwrite

Όταν υπάρχει ήδη μια συντόμευση με το ίδιο όνομα και διαδρομή, η δημιουργία συντόμευσης θα αντικαταστήσει την υπάρχουσα συντόμευση. Δημιουργήστε συντόμευση εάν δεν υπάρχει.
GenerateUniqueName

Όταν υπάρχει ήδη μια συντόμευση με το ίδιο όνομα και διαδρομή, η δημιουργία συντόμευσης θα συνεχίσει με ένα νέο μοναδικό όνομα συντόμευσης.
OverwriteOnly

Όταν υπάρχει ήδη μια συντόμευση με το ίδιο όνομα και διαδρομή, η δημιουργία συντόμευσης θα αντικαταστήσει την υπάρχουσα συντόμευση.

Target

Object

Ένα αντικείμενο που περιέχει την προέλευση δεδομένων προορισμού και πρέπει να καθορίσει ακριβώς έναν από τους υποστηριζόμενους προορισμούς, όπως περιγράφεται στον παρακάτω πίνακα.

Όνομα Τύπος Περιγραφή
adlsGen2

AdlsGen2

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων ADLS Gen2 προορισμού.
amazonS3

AmazonS3

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων Amazon S3 προορισμού.
dataverse

Dataverse

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων dataverse προορισμού.
externalDataShare

ExternalDataShareTarget

Ένα αντικείμενο που περιέχει τις ιδιότητες του κοινόχρηστου χώρου εξωτερικών δεδομένων προορισμού.
googleCloudStorage

GoogleCloudStorage

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων χώρου αποθήκευσης Cloud Google προορισμού.
oneLake

OneLake

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων OneLake προορισμού.
s3Compatible

S3Compatible

Ένα αντικείμενο που περιέχει τις ιδιότητες της προέλευσης δεδομένων συμβατής με S3 προορισμού.
type

Type

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

Type

Απαρίθμηση

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

Τιμή Περιγραφή
AdlsGen2

AdlsGen2
AmazonS3

AmazonS3
Dataverse

Dataverse
ExternalDataShare

ExternalDataShare
GoogleCloudStorage

Αποθήκευση GoogleCloud
OneLake

OneLake
S3Compatible

S3 Δεν είναι συμβατό