Items - Get Environment Definition
Επιστρέφει τον καθορισμένο δημόσιο ορισμό περιβάλλοντος.
Αυτό το API υποστηρίζει λειτουργίες μεγάλης διάρκειας (LRO).
Όταν λαμβάνετε τον δημόσιο ορισμό ενός περιβάλλοντος, η ετικέτα ευαισθησίας δεν αποτελεί μέρος του ορισμού.
Δικαιώματα
Ο καλών πρέπει να έχει δικαιώματα ανάγνωσης και εγγραφής για το περιβάλλον.
Απαιτούμενες εμβέλειες με ανάθεση
Environment.ReadWrite.All ή Item.ReadWrite.All
Περιορισμοί
Αυτό το API αποκλείεται για ένα περιβάλλον με κρυπτογραφημένη ετικέτα ευαισθησίας.
Υποστηριζόμενες ταυτότητες Microsoft Entra
Αυτό το API υποστηρίζει τις ταυτότητες Microsoft που παρατίθενται σε αυτή την ενότητα.
| Ταυτότητα | Υποστήριξη |
|---|---|
| User | Όχι |
| Υπηρεσίας και διαχειριζόμενες ταυτότητες | Όχι |
Διασύνδεση
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}/getDefinition
POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments/{environmentId}/getDefinition?format={format}
Παράμετροι URI
| Όνομα | Σε | Απαιτείται | Τύπος | Περιγραφή |
|---|---|---|---|---|
|
environment
|
path | True |
string (uuid) |
Το αναγνωριστικό περιβάλλοντος. |
|
workspace
|
path | True |
string (uuid) |
Το αναγνωριστικό χώρου εργασίας. |
|
format
|
query |
string |
Η μορφή του δημόσιου ορισμού περιβάλλοντος. |
Αποκρίσεις
| Όνομα | Τύπος | Περιγραφή |
|---|---|---|
| 200 OK |
Η αίτηση ολοκληρώθηκε με επιτυχία. |
|
| 202 Accepted |
Η αίτηση έγινε δεκτή. Η ανάκτηση του ορισμού βρίσκεται σε εξέλιξη. Κεφαλίδες
|
|
| Other Status Codes |
Συνήθεις κωδικοί σφαλμάτων:
|
Παραδείγματα
Get a environment definition example
Δείγμα αίτησης
POST https://api.fabric.microsoft.com/v1/workspaces/6e335e92-a2a2-4b5a-970a-bd6a89fbb765/environments/cfafbeb1-8037-4d0c-896e-a46fb27ff229/getDefinition
Δείγμα απόκρισης
{
"definition": {
"parts": [
{
"path": "Libraries/CustomLibraries/samplelibrary.jar",
"payload": "eyJuYmZvcm1hdCI6N..",
"payloadType": "InlineBase64"
},
{
"path": "Libraries/CustomLibraries/samplepython.py",
"payload": "FyJuYmZvcm1hdCI6N..",
"payloadType": "InlineBase64"
},
{
"path": "Libraries/CustomLibraries/samplewheel-0.18.0-py2.py3-none-any.whl",
"payload": "LyJuYmZvcm1hdCI6N..",
"payloadType": "InlineBase64"
},
{
"path": "Libraries/CustomLibraries/sampleR.tar.gz",
"payload": "ZyJuYmZvcm1hdCI6N..",
"payloadType": "InlineBase64"
},
{
"path": "Libraries/PublicLibraries/environment.yml",
"payload": "IyJuYmZvcm1hdCI6N..",
"payloadType": "InlineBase64"
},
{
"path": "Setting/Sparkcompute.yml",
"payload": "GyJuYmZvcm1hdCI6N..",
"payloadType": "InlineBase64"
},
{
"path": ".platform",
"payload": "ZG90UGxhdGZvcm1CYXNlNjRTdHJpbmc",
"payloadType": "InlineBase64"
}
]
}
}
Location: https://api.fabric.microsoft.com/v1/operations/431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
x-ms-operation-id: 431e8d7b-4a95-4c02-8ccd-6faef5ba1bd7
Retry-After: 30
Ορισμοί
| Όνομα | Περιγραφή |
|---|---|
|
Environment |
Αντικείμενο δημόσιου ορισμού περιβάλλοντος. Ανατρέξτε σε αυτό το άρθρο για περισσότερες λεπτομέρειες σχετικά με τον τρόπο δημιουργίας ενός δημόσιου ορισμού περιβάλλοντος. |
|
Environment |
Αντικείμενο τμήματος ορισμού περιβάλλοντος. |
|
Environment |
Απόκριση δημόσιου ορισμού περιβάλλοντος. |
|
Error |
Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα. |
|
Error |
Η απόκριση σφάλματος. |
|
Error |
Οι λεπτομέρειες της απόκρισης σφάλματος. |
|
Payload |
Ο τύπος του ωφέλιμου φορτίου τμήματος ορισμού. Επιπλέον τύποι ωφέλιμου φορτίου μπορούν να προστεθούν με την πάροδο του χρόνου. |
EnvironmentDefinition
Αντικείμενο δημόσιου ορισμού περιβάλλοντος. Ανατρέξτε σε αυτό το άρθρο για περισσότερες λεπτομέρειες σχετικά με τον τρόπο δημιουργίας ενός δημόσιου ορισμού περιβάλλοντος.
| Όνομα | Τύπος | Περιγραφή |
|---|---|---|
| format |
string |
Η μορφή του ορισμού περιβάλλοντος. |
| parts |
Μια λίστα τμημάτων ορισμού. |
EnvironmentDefinitionPart
Αντικείμενο τμήματος ορισμού περιβάλλοντος.
| Όνομα | Τύπος | Περιγραφή |
|---|---|---|
| path |
string |
Η διαδρομή του τμήματος περιβάλλοντος. |
| payload |
string |
Το ωφέλιμο φορτίο του τμήματος περιβάλλοντος. |
| payloadType |
Ο τύπος ωφέλιμου φορτίου. |
EnvironmentDefinitionResponse
Απόκριση δημόσιου ορισμού περιβάλλοντος.
| Όνομα | Τύπος | Περιγραφή |
|---|---|---|
| definition |
Αντικείμενο δημόσιου ορισμού περιβάλλοντος. Ανατρέξτε σε αυτό το άρθρο για περισσότερες λεπτομέρειες σχετικά με τον τρόπο δημιουργίας ενός δημόσιου ορισμού περιβάλλοντος. |
ErrorRelatedResource
Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
| Όνομα | Τύπος | Περιγραφή |
|---|---|---|
| resourceId |
string |
Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα. |
| resourceType |
string |
Ο τύπος του πόρου που εμπλέκεται στο σφάλμα. |
ErrorResponse
Η απόκριση σφάλματος.
| Όνομα | Τύπος | Περιγραφή |
|---|---|---|
| errorCode |
string |
Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της. |
| message |
string |
Μια αναγνώσιμη αναπαράσταση του σφάλματος. |
| moreDetails |
Λίστα πρόσθετων λεπτομερειών σφάλματος. |
|
| relatedResource |
Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα. |
|
| requestId |
string |
Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα. |
ErrorResponseDetails
Οι λεπτομέρειες της απόκρισης σφάλματος.
| Όνομα | Τύπος | Περιγραφή |
|---|---|---|
| errorCode |
string |
Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της. |
| message |
string |
Μια αναγνώσιμη αναπαράσταση του σφάλματος. |
| relatedResource |
Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα. |
PayloadType
Ο τύπος του ωφέλιμου φορτίου τμήματος ορισμού. Επιπλέον τύποι ωφέλιμου φορτίου μπορούν να προστεθούν με την πάροδο του χρόνου.
| Τιμή | Περιγραφή |
|---|---|
| InlineBase64 |
Ενσωματωμένη βάση 64. |