Items - Discover Dataflow Parameters

Υπηρεσία:: Dataflow

Έκδοση API:: v1

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

Δικαιώματα

Ο καλών πρέπει να έχει δικαιώματα ανάγνωσης για τη ροή δεδομένων.

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

Dataflow.Read.All ή Dataflow.ReadWrite.All ή Item.Read.All ή Item.ReadWrite.All

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

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

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

Interface

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataflows/{dataflowId}/parameters

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

GET https://api.fabric.microsoft.com/v1/workspaces/{workspaceId}/dataflows/{dataflowId}/parameters?continuationToken={continuationToken}

Παράμετροι URI

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

Απαντήσεις

Όνομα Δακτυλογραφώ Περιγραφή

200 OK

Όνομα	Δακτυλογραφώ	Περιγραφή
200 OK	DataflowParameters	Η αίτηση ολοκληρώθηκε με επιτυχία.
429 Too Many Requests	ErrorResponse	Έγινε υπέρβαση του ορίου επιτοκίου υπηρεσίας. Ο διακομιστής επιστρέφει μια `Retry-After` κεφαλίδα που υποδεικνύει, σε δευτερόλεπτα, πόσο πρέπει να περιμένει ο υπολογιστής-πελάτης πριν από την αποστολή πρόσθετων αιτήσεων. Κεφαλίδες Retry-After: integer
Other Status Codes	ErrorResponse	Συνήθεις κωδικοί σφαλμάτων: ItemNotFound - Το στοιχείο που ζητήθηκε δεν βρέθηκε DataflowNotParametricError - Η ζητούμενη ροή δεδομένων δεν είναι παραμετρική

DataflowParameters

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

429 Too Many Requests

ErrorResponse

Έγινε υπέρβαση του ορίου επιτοκίου υπηρεσίας. Ο διακομιστής επιστρέφει μια Retry-After κεφαλίδα που υποδεικνύει, σε δευτερόλεπτα, πόσο πρέπει να περιμένει ο υπολογιστής-πελάτης πριν από την αποστολή πρόσθετων αιτήσεων.

Κεφαλίδες

Retry-After: integer

Other Status Codes

ErrorResponse

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

ItemNotFound - Το στοιχείο που ζητήθηκε δεν βρέθηκε
DataflowNotParametricError - Η ζητούμενη ροή δεδομένων δεν είναι παραμετρική

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

Get Dataflow Parameters example

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

HTTP

GET https://api.fabric.microsoft.com/v1/workspaces/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/dataflows/dddddddd-9999-0000-1111-eeeeeeeeeeee/parameters

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

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

{
  "value": [
    {
      "name": "manufacturer",
      "isRequired": true,
      "description": "Manufacturer of the item",
      "type": "String",
      "defaultValue": "test-value"
    },
    {
      "name": "isImported",
      "isRequired": false,
      "description": "Is the item imported",
      "type": "Boolean",
      "defaultValue": true
    },
    {
      "name": "quantity",
      "isRequired": false,
      "description": "Quantity of item",
      "type": "Integer",
      "defaultValue": 123456789
    },
    {
      "name": "weightThreshold",
      "isRequired": true,
      "description": "Weight threshold for item",
      "type": "Number",
      "defaultValue": 3.14
    },
    {
      "name": "datetimeOfOrder",
      "isRequired": true,
      "description": "Datetime of order",
      "type": "DateTime",
      "defaultValue": "2025-09-15T21:45:00.000Z"
    },
    {
      "name": "datetimeZoneOfOrder",
      "isRequired": true,
      "description": "DatetimeZone of order",
      "type": "DateTimeZone",
      "defaultValue": "2025-09-15T21:45:00+02:00"
    },
    {
      "name": "dateOfImport",
      "isRequired": true,
      "description": "Date of import",
      "type": "Date",
      "defaultValue": "2025-09-15"
    },
    {
      "name": "timeOfImport",
      "isRequired": true,
      "description": "Time of import",
      "type": "Time",
      "defaultValue": "21:45:00"
    },
    {
      "name": "durationOfImport",
      "isRequired": true,
      "description": "Duration of import",
      "type": "Duration",
      "defaultValue": "P5DT21H35M30S"
    }
  ]
}

Ορισμοί

Όνομα	Περιγραφή
DataflowBooleanParameter	Μια παράμετρος ροής δεδομένων του τύπου Δυαδική τιμή.
DataflowDateParameter	Μια παράμετρος ροής δεδομένων τύπου Ημερομηνία. Συμβολοσειρά με τη μορφή `yyyy-MM-dd` (Παράδειγμα: `2025-09-15` για την ημερομηνία 15 Σεπ. 2025). Χρησιμοποιήστε τον "Αυτόματο" τύπο για να παρακάμψετε αυτόν τον τύπο παραμέτρου κατά την εκτέλεση της ροής δεδομένων.
DataflowDateTimeParameter	Μια παράμετρος ροής δεδομένων τύπου ημερομηνίας/ώρας. Συμβολοσειρά με τη μορφή `yyyy-MM-ddTHH:mm:ss.xxxZ` (παράδειγμα: `2025-09-15T21:45:00.000Z`).
DataflowDateTimeZoneParameter	Μια παράμετρος ροής δεδομένων τύπου Ζώνη ημερομηνίας/ώρας. Συμβολοσειρά με τη μορφή `yyyy-MM-ddTHH:mm:sszzz` (παράδειγμα: `2025-09-15T21:45:00+02:00`). Χρησιμοποιήστε τον "Αυτόματο" τύπο για να παρακάμψετε αυτόν τον τύπο παραμέτρου κατά την εκτέλεση της ροής δεδομένων.
DataflowDurationParameter	Μια παράμετρος ροής δεδομένων τύπου Διάρκεια. Συμβολοσειρά με τη μορφή `\Pd\DTH\Hm\Ms\S` (Παράδειγμα: `P5DT14H35M30S` για 5 ημέρες, 14 ώρες, 35 λεπτά και 30 δευτερόλεπτα). Χρησιμοποιήστε τον "Αυτόματο" τύπο για να παρακάμψετε αυτόν τον τύπο παραμέτρου κατά την εκτέλεση της ροής δεδομένων.
DataflowIntegerParameter	Μια παράμετρος ροής δεδομένων τύπου Long.
DataflowNumberParameter	Μια παράμετρος ροής δεδομένων τύπου διπλή.
DataflowParameters	Μια λίστα παραμέτρων ροής δεδομένων.
DataflowStringParameter	Μια παράμετρος ροής δεδομένων τύπου Συμβολοσειρά.
DataflowTimeParameter	Μια παράμετρος ροής δεδομένων τύπου ώρας. Συμβολοσειρά με τη μορφή `HH:mm:ss` (Παράδειγμα: `21:45:00` για 9:45 Μ.Μ.). Χρησιμοποιήστε τον "Αυτόματο" τύπο για να παρακάμψετε αυτόν τον τύπο παραμέτρου κατά την εκτέλεση της ροής δεδομένων.
ErrorRelatedResource	Το αντικείμενο λεπτομερειών πόρου που σχετίζεται με το σφάλμα.
ErrorResponse	Η απόκριση σφάλματος.
ErrorResponseDetails	Οι λεπτομέρειες της απόκρισης σφάλματος.

DataflowBooleanParameter

Αντικείμενο

Μια παράμετρος ροής δεδομένων του τύπου Δυαδική τιμή.

Όνομα	Δακτυλογραφώ	Περιγραφή
defaultValue	boolean	Η τιμή με την οποία θα ανανεωθεί η παράμετρος εάν δεν παρέχεται καμία κατά την εκτέλεση της ροής δεδομένων.
description	string	Μια περιγραφή της παραμέτρου.
isRequired	boolean	Υποδεικνύει εάν η παράμετρος απαιτείται.
name	string	Το όνομα της παραμέτρου.
type	string: Boolean	Ο τύπος της παραμέτρου. Πρόσθετοι τύποι τύπων μπορούν να προστεθούν με την πάροδο του χρόνου.

DataflowDateParameter

Αντικείμενο

Μια παράμετρος ροής δεδομένων τύπου Ημερομηνία. Συμβολοσειρά με τη μορφή yyyy-MM-dd (Παράδειγμα: 2025-09-15 για την ημερομηνία 15 Σεπ. 2025). Χρησιμοποιήστε τον "Αυτόματο" τύπο για να παρακάμψετε αυτόν τον τύπο παραμέτρου κατά την εκτέλεση της ροής δεδομένων.

Όνομα	Δακτυλογραφώ	Περιγραφή
defaultValue	string	Η τιμή με την οποία θα ανανεωθεί η παράμετρος εάν δεν παρέχεται καμία κατά την εκτέλεση της ροής δεδομένων.
description	string	Μια περιγραφή της παραμέτρου.
isRequired	boolean	Υποδεικνύει εάν η παράμετρος απαιτείται.
name	string	Το όνομα της παραμέτρου.
type	string: Date	Ο τύπος της παραμέτρου. Πρόσθετοι τύποι τύπων μπορούν να προστεθούν με την πάροδο του χρόνου.

DataflowDateTimeParameter

Αντικείμενο

Μια παράμετρος ροής δεδομένων τύπου ημερομηνίας/ώρας. Συμβολοσειρά με τη μορφή yyyy-MM-ddTHH:mm:ss.xxxZ (παράδειγμα: 2025-09-15T21:45:00.000Z).

Όνομα	Δακτυλογραφώ	Περιγραφή
defaultValue	string (date-time)	Η τιμή με την οποία θα ανανεωθεί η παράμετρος εάν δεν παρέχεται καμία κατά την εκτέλεση της ροής δεδομένων.
description	string	Μια περιγραφή της παραμέτρου.
isRequired	boolean	Υποδεικνύει εάν η παράμετρος απαιτείται.
name	string	Το όνομα της παραμέτρου.
type	string: DateTime	Ο τύπος της παραμέτρου. Πρόσθετοι τύποι τύπων μπορούν να προστεθούν με την πάροδο του χρόνου.

DataflowDateTimeZoneParameter

Αντικείμενο

Μια παράμετρος ροής δεδομένων τύπου Ζώνη ημερομηνίας/ώρας. Συμβολοσειρά με τη μορφή yyyy-MM-ddTHH:mm:sszzz (παράδειγμα: 2025-09-15T21:45:00+02:00). Χρησιμοποιήστε τον "Αυτόματο" τύπο για να παρακάμψετε αυτόν τον τύπο παραμέτρου κατά την εκτέλεση της ροής δεδομένων.

Όνομα	Δακτυλογραφώ	Περιγραφή
defaultValue	string	Η τιμή με την οποία θα ανανεωθεί η παράμετρος εάν δεν παρέχεται καμία κατά την εκτέλεση της ροής δεδομένων.
description	string	Μια περιγραφή της παραμέτρου.
isRequired	boolean	Υποδεικνύει εάν η παράμετρος απαιτείται.
name	string	Το όνομα της παραμέτρου.
type	string: DateTimeZone	Ο τύπος της παραμέτρου. Πρόσθετοι τύποι τύπων μπορούν να προστεθούν με την πάροδο του χρόνου.

DataflowDurationParameter

Αντικείμενο

Μια παράμετρος ροής δεδομένων τύπου Διάρκεια. Συμβολοσειρά με τη μορφή \Pd\DTH\Hm\Ms\S (Παράδειγμα: P5DT14H35M30S για 5 ημέρες, 14 ώρες, 35 λεπτά και 30 δευτερόλεπτα). Χρησιμοποιήστε τον "Αυτόματο" τύπο για να παρακάμψετε αυτόν τον τύπο παραμέτρου κατά την εκτέλεση της ροής δεδομένων.

Όνομα	Δακτυλογραφώ	Περιγραφή
defaultValue	string	Η τιμή με την οποία θα ανανεωθεί η παράμετρος εάν δεν παρέχεται καμία κατά την εκτέλεση της ροής δεδομένων.
description	string	Μια περιγραφή της παραμέτρου.
isRequired	boolean	Υποδεικνύει εάν η παράμετρος απαιτείται.
name	string	Το όνομα της παραμέτρου.
type	string: Duration	Ο τύπος της παραμέτρου. Πρόσθετοι τύποι τύπων μπορούν να προστεθούν με την πάροδο του χρόνου.

DataflowIntegerParameter

Αντικείμενο

Μια παράμετρος ροής δεδομένων τύπου Long.

Όνομα	Δακτυλογραφώ	Περιγραφή
defaultValue	integer (int64)	Η τιμή με την οποία θα ανανεωθεί η παράμετρος εάν δεν παρέχεται καμία κατά την εκτέλεση της ροής δεδομένων.
description	string	Μια περιγραφή της παραμέτρου.
isRequired	boolean	Υποδεικνύει εάν η παράμετρος απαιτείται.
name	string	Το όνομα της παραμέτρου.
type	string: Integer	Ο τύπος της παραμέτρου. Πρόσθετοι τύποι τύπων μπορούν να προστεθούν με την πάροδο του χρόνου.

DataflowNumberParameter

Αντικείμενο

Μια παράμετρος ροής δεδομένων τύπου διπλή.

Όνομα	Δακτυλογραφώ	Περιγραφή
defaultValue	number (double)	Η τιμή με την οποία θα ανανεωθεί η παράμετρος εάν δεν παρέχεται καμία κατά την εκτέλεση της ροής δεδομένων.
description	string	Μια περιγραφή της παραμέτρου.
isRequired	boolean	Υποδεικνύει εάν η παράμετρος απαιτείται.
name	string	Το όνομα της παραμέτρου.
type	string: Number	Ο τύπος της παραμέτρου. Πρόσθετοι τύποι τύπων μπορούν να προστεθούν με την πάροδο του χρόνου.

DataflowParameters

Αντικείμενο

Μια λίστα παραμέτρων ροής δεδομένων.

Όνομα	Δακτυλογραφώ	Περιγραφή
continuationToken	string	Το διακριτικό για την επόμενη δέσμη συνόλου αποτελεσμάτων. Εάν δεν υπάρχουν άλλες εγγραφές, καταργείται από την απόκριση.
continuationUri	string	Το URI της δέσμης επόμενου συνόλου αποτελεσμάτων. Εάν δεν υπάρχουν άλλες εγγραφές, καταργείται από την απόκριση.
value	DataflowParameter[]: DataflowBooleanParameter[] DataflowDateParameter[] DataflowDateTimeParameter[] DataflowDateTimeZoneParameter[] DataflowDurationParameter[] DataflowIntegerParameter[] DataflowNumberParameter[] DataflowStringParameter[] DataflowTimeParameter[]	Μια λίστα παραμέτρων που ορίζονται στη ροή δεδομένων.

DataflowStringParameter

Αντικείμενο

Μια παράμετρος ροής δεδομένων τύπου Συμβολοσειρά.

Όνομα	Δακτυλογραφώ	Περιγραφή
defaultValue	string	Η τιμή με την οποία θα ανανεωθεί η παράμετρος, εάν δεν παρέχεται καμία κατά την εκτέλεση της ροής δεδομένων .
description	string	Μια περιγραφή της παραμέτρου.
isRequired	boolean	Υποδεικνύει εάν η παράμετρος απαιτείται.
name	string	Το όνομα της παραμέτρου.
type	string: String	Ο τύπος της παραμέτρου. Πρόσθετοι τύποι τύπων μπορούν να προστεθούν με την πάροδο του χρόνου.

DataflowTimeParameter

Αντικείμενο

Μια παράμετρος ροής δεδομένων τύπου ώρας. Συμβολοσειρά με τη μορφή HH:mm:ss (Παράδειγμα: 21:45:00 για 9:45 Μ.Μ.). Χρησιμοποιήστε τον "Αυτόματο" τύπο για να παρακάμψετε αυτόν τον τύπο παραμέτρου κατά την εκτέλεση της ροής δεδομένων.

Όνομα	Δακτυλογραφώ	Περιγραφή
defaultValue	string	Η τιμή με την οποία θα ανανεωθεί η παράμετρος εάν δεν παρέχεται καμία κατά την εκτέλεση της ροής δεδομένων.
description	string	Μια περιγραφή της παραμέτρου.
isRequired	boolean	Υποδεικνύει εάν η παράμετρος απαιτείται.
name	string	Το όνομα της παραμέτρου.
type	string: Time	Ο τύπος της παραμέτρου. Πρόσθετοι τύποι τύπων μπορούν να προστεθούν με την πάροδο του χρόνου.

ErrorRelatedResource

Αντικείμενο

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

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

ErrorResponse

Αντικείμενο

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

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

ErrorResponseDetails

Αντικείμενο

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

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

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

Items - Discover Dataflow Parameters

Δικαιώματα

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

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

Interface

Παράμετροι URI

Απαντήσεις

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

Get Dataflow Parameters example

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

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

Ορισμοί

DataflowBooleanParameter

DataflowDateParameter

DataflowDateTimeParameter

DataflowDateTimeZoneParameter

DataflowDurationParameter

DataflowIntegerParameter

DataflowNumberParameter

DataflowParameters

DataflowStringParameter

DataflowTimeParameter

ErrorRelatedResource

ErrorResponse

ErrorResponseDetails