External Data Shares - List External Data Shares

Αναφορά

Υπηρεσία:: Admin

Έκδοση API:: v1

Εμφανίζει τους κοινόχρηστους χώρους εξωτερικών δεδομένων στον μισθωτή.

Αυτό το API υποστηρίζει σελιδοποίησης .

Δικαιώματα

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

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

Tenant.ReadWrite.All

Απαιτούμενες ρυθμίσεις μισθωτή

Για να χρησιμοποιήσετε αυτό το API, ενεργοποιήστε τον διακόπτη διαχειριστή "Εξωτερική κοινή χρήση δεδομένων" για την κύρια κλήση.

Περιορισμούς

Το πολύ 10 αιτήσεις ανά λεπτό.

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

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

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

Διεπαφή

GET https://api.fabric.microsoft.com/v1/admin/items/externalDataShares

Με προαιρετικές παραμέτρους:

GET https://api.fabric.microsoft.com/v1/admin/items/externalDataShares?continuationToken={continuationToken}

Παράμετροι URI

Όνομα	Σε	Απαιτείται	Τύπος	Περιγραφή
continuationToken	query		string	Ένα διακριτικό για την ανάκτηση της επόμενης σελίδας αποτελεσμάτων.

Αποκρίσεις

Όνομα	Τύπος	Περιγραφή
200 OK	ExternalDataShares	Η αίτηση ολοκληρώθηκε με επιτυχία.
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: UnknownError - Παρουσιάστηκε σφάλμα.

Όνομα

Τύπος

Περιγραφή

200 OK

ExternalDataShares

Η αίτηση ολοκληρώθηκε με επιτυχία.

Other Status Codes

ErrorResponse

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

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

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

List external data shares in the tenant example

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

HTTP

GET https://api.fabric.microsoft.com/v1/admin/items/externalDataShares

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

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

{
  "value": [
    {
      "id": "dccc162f-7a41-4720-83c3-5c7e81187959",
      "paths": [
        "Files/Sales/Contoso_Sales_2023"
      ],
      "creatorPrincipal": {
        "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
        "displayName": "Jacob Hancock",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "jacob@contoso.com"
        }
      },
      "recipient": {
        "userPrincipalName": "lisa@fabrikam.com"
      },
      "status": "Pending",
      "expirationTimeUtc": "2024-12-13T00:00:00.000Z",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "itemId": "5b218778-e7a5-4d73-8187-f10824047715",
      "invitationUrl": "https://app.fabric.microsoft.com/externaldatasharing/accept?si=VyT5NJ3%2bNkySqEmf368Pjw-dccc162f-7a41-4720-83c3-5c7e81187959"
    },
    {
      "id": "96c21561-65b8-4b23-bb9a-ee8cef945c45",
      "paths": [
        "Files/Sales/Contoso_Sales_2023"
      ],
      "creatorPrincipal": {
        "id": "f3052d1c-61a9-46fb-8df9-0d78916ae041",
        "displayName": "Jacob Hancock",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "jacob@contoso.com"
        }
      },
      "recipient": {
        "userPrincipalName": "lisa@fabrikam.com"
      },
      "status": "Active",
      "expirationTimeUtc": "2024-08-31T00:00:00.000Z",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "itemId": "5b218778-e7a5-4d73-8187-f10824047715",
      "invitationUrl": "https://app.fabric.microsoft.com/externaldatasharing/accept?si=VyT5NJ3%2bNkySqEmf368Pjw-96c21561-65b8-4b23-bb9a-ee8cef945c45",
      "acceptedByTenantId": "c51dc03f-268a-4da0-a879-25f24947ab8b"
    },
    {
      "id": "0f40aeca-8f78-4a6f-a552-e5c45faadc60",
      "paths": [
        "Files/Sales/Contoso_Sales_2023"
      ],
      "creatorPrincipal": {
        "id": "81fac5e1-2a81-421b-a168-110b1c72fa11",
        "displayName": "Eric Solomon",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "eric@contoso.com"
        }
      },
      "recipient": {
        "userPrincipalName": "lisa@fabrikam.com"
      },
      "status": "InvitationExpired",
      "expirationTimeUtc": "2024-01-01T00:00:00.000Z",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "itemId": "5b218778-e7a5-4d73-8187-f10824047715",
      "invitationUrl": "https://app.fabric.microsoft.com/externaldatasharing/accept?si=VyT5NJ3%2bNkySqEmf368Pjw-0f40aeca-8f78-4a6f-a552-e5c45faadc60"
    },
    {
      "id": "89e82a82-0140-4837-8eee-9c919e3e5952",
      "paths": [
        "Files/Sales/Contoso_Sales_2023"
      ],
      "creatorPrincipal": {
        "id": "81fac5e1-2a81-421b-a168-110b1c72fa11",
        "displayName": "Eric Solomon",
        "type": "User",
        "userDetails": {
          "userPrincipalName": "eric@contoso.com"
        }
      },
      "recipient": {
        "userPrincipalName": "lisa@fabrikam.com"
      },
      "status": "Revoked",
      "expirationTimeUtc": "2024-12-01T00:00:00.000Z",
      "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
      "itemId": "5b218778-e7a5-4d73-8187-f10824047715",
      "invitationUrl": "https://app.fabric.microsoft.com/externaldatasharing/accept?si=VyT5NJ3%2bNkySqEmf368Pjw-89e82a82-0140-4837-8eee-9c919e3e5952",
      "acceptedByTenantId": "c51dc03f-268a-4da0-a879-25f24947ab8b"
    }
  ]
}

Ορισμοί

Όνομα	Περιγραφή
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
ExternalDataShare	Ένα αντικείμενο κοινής χρήσης εξωτερικών δεδομένων.
ExternalDataShareRecipient	Μια αναπαράσταση του παραλήπτη του κοινόχρηστου χώρου εξωτερικών δεδομένων.
ExternalDataShares	Μια λίστα εξωτερικών κοινόχρηστων δεδομένων με διακριτικό συνέχειας.
ExternalDataShareStatus	Η κατάσταση ενός συγκεκριμένου κοινόχρηστου χώρου εξωτερικών δεδομένων. Επιπλέον `ExternalDataShareStatus` τύποι μπορούν να προστεθούν με την πάροδο του χρόνου.
GroupDetails	Λεπτομέρειες συγκεκριμένης ομάδας. Ισχύει όταν ο κύριος τύπος είναι `Group`.
GroupType	Ο τύπος της ομάδας. Επιπλέον τύποι ομάδων μπορούν να προστεθούν με την πάροδο του χρόνου.
Principal	Αντιπροσωπεύει μια ταυτότητα ή μια ομάδα Microsoft Entra.
PrincipalType	Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.
ServicePrincipalDetails	Λεπτομέρειες για την κύρια υπηρεσία. Ισχύει όταν ο κύριος τύπος είναι `ServicePrincipal`.
ServicePrincipalProfileDetails	Λεπτομέρειες προφίλ κύριας υπηρεσίας. Ισχύει όταν ο κύριος τύπος είναι `ServicePrincipalProfile`.
UserDetails	Συγκεκριμένες λεπτομέρειες για την κύρια χρήστη. Ισχύει όταν ο κύριος τύπος είναι `User`.

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	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

ExternalDataShare

Object

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

Όνομα	Τύπος	Περιγραφή
acceptedByTenantId	string uuid	Το αναγνωριστικό μισθωτή στο οποίο έγινε αποδοχή του κοινόχρηστου χώρου εξωτερικών δεδομένων.
creatorPrincipal	Principal	Η αρχή που δημιούργησε τον κοινόχρηστο χώρο εξωτερικών δεδομένων.
expirationTimeUtc	string date-time	Η ημερομηνία και ώρα λήξης (UTC) της πρόσκλησης στον εξωτερικό κοινόχρηστο χώρο δεδομένων.
id	string uuid	Το αναγνωριστικό κοινόχρηστου χώρου εξωτερικών δεδομένων.
invitationUrl	string uri	Η διεύθυνση URL για την αποδοχή της πρόσκλησης στον κοινόχρηστο χώρο εξωτερικών δεδομένων.
itemId	string uuid	Το αναγνωριστικό στοιχείου.
paths	string[]	Η διαδρομή ή λίστα διαδρομών που κοινοποιούνται εξωτερικά.
recipient	ExternalDataShareRecipient	Ο παραλήπτης που προσκλήθηκε να αποδεχτεί τον κοινόχρηστο χώρο εξωτερικών δεδομένων.
status	ExternalDataShareStatus	Η κατάσταση του κοινόχρηστου χώρου εξωτερικών δεδομένων.
workspaceId	string uuid	Το αναγνωριστικό χώρου εργασίας.

ExternalDataShareRecipient

Object

Μια αναπαράσταση του παραλήπτη του κοινόχρηστου χώρου εξωτερικών δεδομένων.

Όνομα	Τύπος	Περιγραφή
tenantId	string uuid	Το αναγνωριστικό μισθωτή του παραλήπτη.
userPrincipalName	string	Η διεύθυνση ηλεκτρονικού ταχυδρομείου του παραλήπτη.

ExternalDataShares

Object

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

Όνομα	Τύπος	Περιγραφή
continuationToken	string	Το διακριτικό για την επόμενη δέσμη συνόλου αποτελεσμάτων. Εάν δεν υπάρχουν άλλες εγγραφές, καταργείται από την απόκριση.
continuationUri	string	Το URI της δέσμης επόμενου συνόλου αποτελεσμάτων. Εάν δεν υπάρχουν άλλες εγγραφές, καταργείται από την απόκριση.
value	ExternalDataShare[]	Μια λίστα εξωτερικών κοινόχρηστων δεδομένων.

ExternalDataShareStatus

Απαρίθμηση

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

Τιμή	Περιγραφή
Active	Η πρόσκληση έγινε αποδεκτή από τον παραλήπτη και ο κοινόχρηστος χώρος εξωτερικών δεδομένων είναι ενεργός.
InvitationExpired	Η πρόσκληση έληξε και δεν είναι πλέον δυνατή η αποδοχή της από τον παραλήπτη.
Pending	Δημιουργήθηκε μια πρόσκληση η οποία εκκρεμεί τώρα για αποδοχή από τον παραλήπτη.
Revoked	Ο εξωτερικός κοινόχρηστος χώρος δεδομένων ανακλήθηκε.

GroupDetails

Object

Λεπτομέρειες συγκεκριμένης ομάδας. Ισχύει όταν ο κύριος τύπος είναι Group.

Όνομα	Τύπος	Περιγραφή
groupType	GroupType	Ο τύπος της ομάδας. Επιπλέον τύποι ομάδων μπορούν να προστεθούν με την πάροδο του χρόνου.

GroupType

Απαρίθμηση

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

Τιμή	Περιγραφή
DistributionList	Το Principal είναι μια λίστα διανομής.
SecurityGroup	Το Principal είναι μια ομάδα ασφαλείας.
Unknown	Ο κύριος τύπος ομάδας είναι άγνωστος.

Principal

Object

Αντιπροσωπεύει μια ταυτότητα ή μια ομάδα Microsoft Entra.

Όνομα	Τύπος	Περιγραφή
displayName	string	Το εμφανιζόμενο όνομα της κύριας.
groupDetails	GroupDetails	Λεπτομέρειες συγκεκριμένης ομάδας. Ισχύει όταν ο κύριος τύπος είναι `Group`.
id	string uuid	Το αναγνωριστικό του διευθυντή.
servicePrincipalDetails	ServicePrincipalDetails	Λεπτομέρειες για την κύρια υπηρεσία. Ισχύει όταν ο κύριος τύπος είναι `ServicePrincipal`.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Λεπτομέρειες προφίλ κύριας υπηρεσίας. Ισχύει όταν ο κύριος τύπος είναι `ServicePrincipalProfile`.
type	PrincipalType	Ο τύπος της κύριας. Μπορείτε να προσθέσετε πρόσθετους κύριους τύπους με την πάροδο του χρόνου.
userDetails	UserDetails	Συγκεκριμένες λεπτομέρειες για την κύρια χρήστη. Ισχύει όταν ο κύριος τύπος είναι `User`.

PrincipalType

Απαρίθμηση

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

Τιμή	Περιγραφή
Group	Το Principal είναι μια ομάδα ασφαλείας.
ServicePrincipal	Το Principal είναι μια κύρια υπηρεσία Microsoft Entra.
ServicePrincipalProfile	Το Principal είναι ένα προφίλ κύριας υπηρεσίας.
User	Το Principal είναι μια κύρια χρήστης του Microsoft Entra.

ServicePrincipalDetails

Object

Λεπτομέρειες για την κύρια υπηρεσία. Ισχύει όταν ο κύριος τύπος είναι ServicePrincipal.

Όνομα	Τύπος	Περιγραφή
aadAppId	string uuid	Το Microsoft Entra AppId της κύριας υπηρεσίας.

ServicePrincipalProfileDetails

Object

Λεπτομέρειες προφίλ κύριας υπηρεσίας. Ισχύει όταν ο κύριος τύπος είναι ServicePrincipalProfile.

Όνομα	Τύπος	Περιγραφή
parentPrincipal	Principal	Η γονική οντότητα του προφίλ κύριας υπηρεσίας.

UserDetails

Object

Συγκεκριμένες λεπτομέρειες για την κύρια χρήστη. Ισχύει όταν ο κύριος τύπος είναι User.

Όνομα	Τύπος	Περιγραφή
userPrincipalName	string	Το κύριο όνομα χρήστη.

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

External Data Shares - List External Data Shares

Δικαιώματα

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

Απαιτούμενες ρυθμίσεις μισθωτή

Περιορισμούς

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

Διεπαφή

Παράμετροι URI

Αποκρίσεις

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

List external data shares in the tenant example

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

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

Ορισμοί

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ExternalDataShare

ExternalDataShareRecipient

ExternalDataShares

ExternalDataShareStatus

GroupDetails

GroupType

Principal

PrincipalType

ServicePrincipalDetails

ServicePrincipalProfileDetails

UserDetails

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