Κοινοποίηση μέσω


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

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

string (uuid)

Το αναγνωριστικό περιβάλλοντος.

workspaceId
path True

string (uuid)

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

format
query

string

Η μορφή του δημόσιου ορισμού περιβάλλοντος.

Αποκρίσεις

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

EnvironmentDefinitionResponse

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

202 Accepted

Η αίτηση έγινε δεκτή. Η ανάκτηση του ορισμού βρίσκεται σε εξέλιξη.

Κεφαλίδες

  • Location: string
  • x-ms-operation-id: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

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

  • OperationNotSupportedForItem - Η λειτουργία δεν υποστηρίζεται για το στοιχείο που ζητήθηκε.

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

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

Ορισμοί

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

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

EnvironmentDefinitionPart

Αντικείμενο τμήματος ορισμού περιβάλλοντος.

EnvironmentDefinitionResponse

Απόκριση δημόσιου ορισμού περιβάλλοντος.

ErrorRelatedResource

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

ErrorResponse

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

ErrorResponseDetails

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

PayloadType

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

EnvironmentDefinition

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

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

string

Η μορφή του ορισμού περιβάλλοντος.

parts

EnvironmentDefinitionPart[]

Μια λίστα τμημάτων ορισμού.

EnvironmentDefinitionPart

Αντικείμενο τμήματος ορισμού περιβάλλοντος.

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

string

Η διαδρομή του τμήματος περιβάλλοντος.

payload

string

Το ωφέλιμο φορτίο του τμήματος περιβάλλοντος.

payloadType

PayloadType

Ο τύπος ωφέλιμου φορτίου.

EnvironmentDefinitionResponse

Απόκριση δημόσιου ορισμού περιβάλλοντος.

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

EnvironmentDefinition

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

ErrorRelatedResource

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

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

string

Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.

resourceType

string

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

ErrorResponse

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

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

string

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

message

string

Μια αναγνώσιμη αναπαράσταση του σφάλματος.

moreDetails

ErrorResponseDetails[]

Λίστα πρόσθετων λεπτομερειών σφάλματος.

relatedResource

ErrorRelatedResource

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

requestId

string

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

ErrorResponseDetails

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

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

string

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

message

string

Μια αναγνώσιμη αναπαράσταση του σφάλματος.

relatedResource

ErrorRelatedResource

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

PayloadType

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

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

Ενσωματωμένη βάση 64.