Items - Create Environment

Υπηρεσία:: Environment

Έκδοση API:: v1

Δημιουργεί ένα περιβάλλον στον καθορισμένο χώρο εργασίας.
Αυτό το API υποστηρίζει λειτουργίες μεγάλης διάρκειας (LRO).

Δικαιώματα

Ο καλών πρέπει να έχει ρόλο συμβάλλοντα στον χώρο εργασίας.

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

Environment.ReadWrite.All ή Item.ReadWrite.All

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

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

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

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

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

Διασύνδεση

POST https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/environments

Παράμετροι URI

Όνομα	Μέσα	Απαιτούμενο	Δακτυλογραφώ	Περιγραφή
workspaceId	path	True	string (uuid)	Το αναγνωριστικό χώρου εργασίας.

Σώμα αιτήματος

Όνομα	Απαιτούμενο	Δακτυλογραφώ	Περιγραφή
displayName	True	string	Το εμφανιζόμενο όνομα του περιβάλλοντος.
definition		EnvironmentDefinition	Ο δημόσιος ορισμός περιβάλλοντος.
description		string	Η περιγραφή του περιβάλλοντος. Το μέγιστο μήκος είναι 256 χαρακτήρες.
folderId		string (uuid)	Το αναγνωριστικό φακέλου. Εάν δεν καθορίζεται ή null, το περιβάλλον δημιουργείται με τον χώρο εργασίας ως φάκελο.

Απαντήσεις

Όνομα	Δακτυλογραφώ	Περιγραφή
201 Created	Environment	Δημιουργήθηκε με επιτυχία
202 Accepted		Αποδεκτή αίτηση, παροχή περιβάλλοντος σε εξέλιξη Κεφαλίδες Location: string x-ms-operation-id: string Retry-After: integer
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: InvalidItemType - Ο τύπος στοιχείου δεν είναι έγκυρος ItemDisplayNameAlreadyInUse - Το εμφανιζόμενο όνομα στοιχείου χρησιμοποιείται ήδη CorruptedPayload - Το παρεχόμενο ωφέλιμο φορτίο είναι διεφθαρμένο. WorkspaceItemsLimitExceeded - Έγινε υπέρβαση του ορίου στοιχείων χώρου εργασίας.

Όνομα

Δακτυλογραφώ

Περιγραφή

201 Created

Environment

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

202 Accepted

Αποδεκτή αίτηση, παροχή περιβάλλοντος σε εξέλιξη

Κεφαλίδες

Location: string
x-ms-operation-id: string
Retry-After: integer

Other Status Codes

ErrorResponse

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

InvalidItemType - Ο τύπος στοιχείου δεν είναι έγκυρος
ItemDisplayNameAlreadyInUse - Το εμφανιζόμενο όνομα στοιχείου χρησιμοποιείται ήδη
CorruptedPayload - Το παρεχόμενο ωφέλιμο φορτίο είναι διεφθαρμένο.
WorkspaceItemsLimitExceeded - Έγινε υπέρβαση του ορίου στοιχείων χώρου εργασίας.

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

Create an environment example

Create an environment with public definition example

Create an environment example

Αίτημα δείγματος

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/environments

{
  "displayName": "Environment_1",
  "description": "An environment description."
}

Δείγμα απάντησης

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

{
  "displayName": "Environment_1",
  "description": "An environment description.",
  "type": "Environment",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

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

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Create an environment with public definition example

Αίτημα δείγματος

HTTP

POST https://api.fabric.microsoft.com/v1/workspaces/cfafbeb1-8037-4d0c-896e-a46fb27ff229/environments

{
  "displayName": "Environment_1",
  "description": "An environment description.",
  "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"
      }
    ]
  }
}

Δείγμα απάντησης

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

{
  "displayName": "Environment_1",
  "description": "An environment description.",
  "type": "Environment",
  "workspaceId": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
  "id": "5b218778-e7a5-4d73-8187-f10824047715"
}

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

Location: https://api.fabric.microsoft.com/v1/operations/0acd697c-1550-43cd-b998-91bfbfbd47c6
x-ms-operation-id: 0acd697c-1550-43cd-b998-91bfbfbd47c6
Retry-After: 30

Ορισμοί

Όνομα	Περιγραφή
ComponentPublishInfo	Δημοσιεύστε πληροφορίες για κάθε στοιχείο στο περιβάλλον.
CreateEnvironmentRequest	Δημιουργία ωφέλιμου φορτίου αίτησης περιβάλλοντος.
Environment	Ένα στοιχείο περιβάλλοντος.
EnvironmentDefinition	Αντικείμενο δημόσιου ορισμού περιβάλλοντος. Ανατρέξτε σε αυτό το άρθρο για περισσότερες λεπτομέρειες σχετικά με τον τρόπο δημιουργίας ενός δημόσιου ορισμού περιβάλλοντος.
EnvironmentDefinitionPart	Αντικείμενο τμήματος ορισμού περιβάλλοντος.
EnvironmentProperties	Ιδιότητες περιβάλλοντος.
EnvironmentPublishState	Δημοσιεύστε την πολιτεία. Πρόσθετοι τύποι πολιτειών μπορούν να προστεθούν με την πάροδο του χρόνου.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.
ItemTag	Αντιπροσωπεύει μια ετικέτα που έχει εφαρμοστεί σε ένα στοιχείο.
ItemType	Ο τύπος του στοιχείου. Επιπλέον τύποι στοιχείων μπορούν να προστεθούν με την πάροδο του χρόνου.
PayloadType	Ο τύπος του ωφέλιμου φορτίου τμήματος ορισμού. Επιπλέον τύποι ωφέλιμου φορτίου μπορούν να προστεθούν με την πάροδο του χρόνου.
PublishDetails	Λεπτομέρειες της λειτουργίας δημοσίευσης.
SparkLibraries	Βιβλιοθήκες Spark.
SparkSettings	Ρυθμίσεις Spark.

ComponentPublishInfo

Αντικείμενο

Δημοσιεύστε πληροφορίες για κάθε στοιχείο στο περιβάλλον.

Όνομα	Δακτυλογραφώ	Περιγραφή
sparkLibraries	SparkLibraries	Οι βιβλιοθήκες Spark δημοσιεύουν πληροφορίες.
sparkSettings	SparkSettings	Οι ρυθμίσεις Spark δημοσιεύουν πληροφορίες.

CreateEnvironmentRequest

Αντικείμενο

Δημιουργία ωφέλιμου φορτίου αίτησης περιβάλλοντος.

Όνομα	Δακτυλογραφώ	Περιγραφή
definition	EnvironmentDefinition	Ο δημόσιος ορισμός περιβάλλοντος.
description	string	Η περιγραφή του περιβάλλοντος. Το μέγιστο μήκος είναι 256 χαρακτήρες.
displayName	string	Το εμφανιζόμενο όνομα του περιβάλλοντος.
folderId	string (uuid)	Το αναγνωριστικό φακέλου. Εάν δεν καθορίζεται ή null, το περιβάλλον δημιουργείται με τον χώρο εργασίας ως φάκελο.

Environment

Αντικείμενο

Ένα στοιχείο περιβάλλοντος.

Όνομα	Δακτυλογραφώ	Περιγραφή
description	string	Η περιγραφή του στοιχείου.
displayName	string	Το εμφανιζόμενο όνομα του στοιχείου.
folderId	string (uuid)	Το αναγνωριστικό φακέλου.
id	string (uuid)	Το αναγνωριστικό στοιχείου.
properties	EnvironmentProperties	Οι ιδιότητες περιβάλλοντος.
tags	ItemTag[]	Λίστα εφαρμοσμένων ετικετών.
type	ItemType	Ο τύπος στοιχείου.
workspaceId	string (uuid)	Το αναγνωριστικό χώρου εργασίας.

EnvironmentDefinition

Αντικείμενο

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

Όνομα	Δακτυλογραφώ	Περιγραφή
format	string	Η μορφή του ορισμού περιβάλλοντος.
parts	EnvironmentDefinitionPart[]	Μια λίστα τμημάτων ορισμού.

EnvironmentDefinitionPart

Αντικείμενο

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

Όνομα	Δακτυλογραφώ	Περιγραφή
path	string	Η διαδρομή του τμήματος περιβάλλοντος.
payload	string	Το ωφέλιμο φορτίο του τμήματος περιβάλλοντος.
payloadType	PayloadType	Ο τύπος ωφέλιμου φορτίου.

EnvironmentProperties

Αντικείμενο

Ιδιότητες περιβάλλοντος.

Όνομα	Δακτυλογραφώ	Περιγραφή
publishDetails	PublishDetails	Λεπτομέρειες λειτουργίας δημοσίευσης περιβάλλοντος.

EnvironmentPublishState

Απαρίθμηση

Δημοσιεύστε την πολιτεία. Πρόσθετοι τύποι πολιτειών μπορούν να προστεθούν με την πάροδο του χρόνου.

Τιμή	Περιγραφή
Success	Η δημοσίευση περιβάλλοντος είναι σε κατάσταση επιτυχίας.
Cancelled	Η δημοσίευση περιβάλλοντος είναι σε ακυρωμένη κατάσταση.
Failed	Η δημοσίευση περιβάλλοντος είναι σε κατάσταση αποτυχίας.
Cancelling	Η δημοσίευση περιβάλλοντος είναι σε κατάσταση ακύρωσης.
Running	Η δημοσίευση περιβάλλοντος είναι σε κατάσταση εκτέλεσης.
Waiting	Η δημοσίευση περιβάλλοντος είναι σε κατάσταση αναμονής.

ErrorRelatedResource

Αντικείμενο

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

Όνομα	Δακτυλογραφώ	Περιγραφή
resourceId	string	Το αναγνωριστικό πόρου που εμπλέκεται στο σφάλμα.
resourceType	string	Ο τύπος του πόρου που εμπλέκεται στο σφάλμα.

ErrorResponse

Αντικείμενο

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

Όνομα	Δακτυλογραφώ	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
moreDetails	ErrorResponseDetails[]	Λίστα πρόσθετων λεπτομερειών σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.
requestId	string	Το αναγνωριστικό της αίτησης που σχετίζεται με το σφάλμα.

ErrorResponseDetails

Αντικείμενο

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

Όνομα	Δακτυλογραφώ	Περιγραφή
errorCode	string	Ένα συγκεκριμένο αναγνωριστικό που παρέχει πληροφορίες σχετικά με μια συνθήκη σφάλματος, επιτρέποντας τυποποιημένη επικοινωνία μεταξύ της υπηρεσίας μας και των χρηστών της.
message	string	Μια αναγνώσιμη αναπαράσταση του σφάλματος.
relatedResource	ErrorRelatedResource	Οι λεπτομέρειες του πόρου που σχετίζονται με το σφάλμα.

ItemTag

Αντικείμενο

Αντιπροσωπεύει μια ετικέτα που έχει εφαρμοστεί σε ένα στοιχείο.

Όνομα	Δακτυλογραφώ	Περιγραφή
displayName	string	Το όνομα της ετικέτας.
id	string (uuid)	Το αναγνωριστικό ετικέτας.

ItemType

Απαρίθμηση

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

Τιμή	Περιγραφή
Dashboard	Πίνακας εργαλείων του PowerBI.
Report	Αναφορά PowerBI.
SemanticModel	Σημασιολογικό μοντέλο PowerBI.
PaginatedReport	Σελιδοποιημένη αναφορά PowerBI.
Datamart	Datamart του PowerBI.
Lakehouse	Ένα λιμνοθάσπιτο.
Eventhouse	Μια εκδήλωση.
Environment	Ένα περιβάλλον.
KQLDatabase	Μια βάση δεδομένων KQL.
KQLQueryset	Ένα σύνολο ερωτημάτων KQL.
KQLDashboard	Ένας πίνακας εργαλείων KQL.
DataPipeline	Μια διοχέτευση δεδομένων.
Notebook	Ένα σημειωματάριο.
SparkJobDefinition	Ένας ορισμός εργασίας σπινθήρα.
MLExperiment	Ένα πείραμα εκμάθησης μηχανής.
MLModel	Ένα μοντέλο εκμάθησης μηχανής.
Warehouse	Μια αποθήκη.
Eventstream	Μια ροή συμβάντος.
SQLEndpoint	Ένα τελικό σημείο SQL.
MirroredWarehouse	Μια αποθήκη με κατοπτρικό καθρέφτη.
MirroredDatabase	Μια βάση δεδομένων κατοπτρισμού.
Reflex	Αντανακλαστικά.
GraphQLApi	Ένα API για το στοιχείο GraphQL.
MountedDataFactory	A MountedDataFactory.
SQLDatabase	Μια βάση δεδομένων SQL.
CopyJob	Μια εργασία αντιγραφής.
VariableLibrary	Μια μεταβλητήLibrary.
Dataflow	Μια ροή δεδομένων.
ApacheAirflowJob	Ένα ApacheAirflowJob.
WarehouseSnapshot	Ένα στιγμιότυπο αποθήκης.
DigitalTwinBuilder	Μια DigitalTwinBuilder.
DigitalTwinBuilderFlow	Μια ψηφιακή ροή Twin Builder.
MirroredAzureDatabricksCatalog	Ένας κατοπτρικός κατάλογος azure databricks.
Map	Ένας χάρτης.
AnomalyDetector	Ένας εντοπισμός ανωμαλιών.
UserDataFunction	Μια συνάρτηση δεδομένων χρήστη.
GraphModel	Ένα GraphModel.
GraphQuerySet	Ένα σύνολο ερωτημάτων Graph.
SnowflakeDatabase	Μια βάση δεδομένων Snowflake για την αποθήκευση πινάκων Iceberg που δημιουργήθηκαν από τον λογαριασμό Snowflake.
OperationsAgent	A OperationsAgent.
CosmosDBDatabase	Μια βάση δεδομένων Cosmos DB.
Ontology	Μια ογκολογία.
EventSchemaSet	Ένα EventSchemaSet.

PayloadType

Απαρίθμηση

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

Τιμή	Περιγραφή
InlineBase64	Ενσωματωμένη βάση 64.

PublishDetails

Αντικείμενο

Λεπτομέρειες της λειτουργίας δημοσίευσης.

Όνομα	Δακτυλογραφώ	Περιγραφή
componentPublishInfo	ComponentPublishInfo	Το στοιχείο περιβάλλοντος δημοσιεύει πληροφορίες.
endTime	string (date-time)	Ώρα λήξης της λειτουργίας δημοσίευσης σε μορφή UTC, χρησιμοποιώντας τη μορφή ΕΕΕΕ-ΜΜ-DDTHH:mm:ss.ssssZ.
startTime	string (date-time)	Ώρα έναρξης της λειτουργίας δημοσίευσης σε μορφή UTC, χρησιμοποιώντας τη μορφή ΕΕΕΕ-ΜΜ-DDTHH:mm:ss.ssssZ.
state	EnvironmentPublishState	Δημοσιεύστε την πολιτεία. Πρόσθετοι τύποι πολιτειών μπορούν να προστεθούν με την πάροδο του χρόνου.
targetVersion	string (uuid)	Έκδοση-στόχος προς δημοσίευση.

SparkLibraries

Αντικείμενο

Βιβλιοθήκες Spark.

Όνομα	Δακτυλογραφώ	Περιγραφή
state	EnvironmentPublishState	Δημοσιεύστε την πολιτεία. Πρόσθετοι τύποι πολιτειών μπορούν να προστεθούν με την πάροδο του χρόνου.

SparkSettings

Αντικείμενο

Ρυθμίσεις Spark.

Όνομα	Δακτυλογραφώ	Περιγραφή
state	EnvironmentPublishState	Δημοσιεύστε την πολιτεία. Πρόσθετοι τύποι πολιτειών μπορούν να προστεθούν με την πάροδο του χρόνου.

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

Items - Create Environment

Δικαιώματα

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

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

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

Διασύνδεση

Παράμετροι URI

Σώμα αιτήματος

Απαντήσεις

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

Create an environment example

Αίτημα δείγματος

Δείγμα απάντησης

Create an environment with public definition example

Αίτημα δείγματος

Δείγμα απάντησης

Ορισμοί

ComponentPublishInfo

CreateEnvironmentRequest

Environment

EnvironmentDefinition

EnvironmentDefinitionPart

EnvironmentProperties

EnvironmentPublishState

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails

ItemTag

ItemType

PayloadType

PublishDetails

SparkLibraries

SparkSettings