Items - Discover Dataflow Parameters

Hizmet:: Dataflow

API Sürümü:: v1

Belirtilen Veri akışında tanımlanan tüm parametreleri alır.

Permissions

Çağıranın veri akışı için okuma izinlerine sahip olması gerekir.

Gerekli Temsilci Kapsamları

Dataflow.Read.All veya Dataflow.ReadWrite.All veya Item.Read.All veya Item.ReadWrite.All

Microsoft Entra destekli kimlikler

Bu API, bu bölümde listelenen Microsoft kimliklerini destekler.

Kimlik	Support
User	Yes
Hizmet sorumlusu ve yönetilen kimlikler	Yes

Arayüz

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

İsteğe bağlı parametrelerle:

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
dataflowId	path	True	string (uuid)	Veri Akışı Kimliği.
workspaceId	path	True	string (uuid)	Çalışma alanı kimliği.
continuationToken	query		string	Sonuçların sonraki sayfasını almak için bir belirteç.

Yanıtlar

Name Tür Description

200 OK

Name	Tür	Description
200 OK	DataflowParameters	İstek başarıyla tamamlandı.
429 Too Many Requests	ErrorResponse	Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir `Retry-After` üst bilgi döndürür. Üst Bilgiler Retry-After: integer
Other Status Codes	ErrorResponse	Yaygın hata kodları: ItemNotFound - İstenen öğe bulunamadı DataflowNotParametricError - İstenen veri akışı parametrik değil

DataflowParameters

İstek başarıyla tamamlandı.

429 Too Many Requests

ErrorResponse

Hizmet fiyatı sınırı aşıldı. Sunucu, istemcinin ek istek göndermeden önce ne kadar beklemesi gerektiğini saniye cinsinden belirten bir Retry-After üst bilgi döndürür.

Üst Bilgiler

Retry-After: integer

Other Status Codes

ErrorResponse

Yaygın hata kodları:

ItemNotFound - İstenen öğe bulunamadı
DataflowNotParametricError - İstenen veri akışı parametrik değil

Örnekler

Get Dataflow Parameters example

Örnek isteği

HTTP

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

Örnek yanıt

Durum kodu:: 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"
    }
  ]
}

Tanımlar

Name	Description
DataflowBooleanParameter	Boole türünde bir Veri Akışı parametresi.
DataflowDateParameter	Date türünde bir Veri Akışı parametresi. Biçimindeki `yyyy-MM-dd` dize (Örnek: `2025-09-15` 15 Eylül 2025 tarihi için). Veri akışını yürütürken bu parametre türünü geçersiz kılmak için "Otomatik" türünü kullanın.
DataflowDateTimeParameter	DateTime türünde bir Veri Akışı parametresi. Biçiminde `yyyy-MM-ddTHH:mm:ss.xxxZ` dize (Örnek: `2025-09-15T21:45:00.000Z`).
DataflowDateTimeZoneParameter	DateTimeZone türünde bir Veri Akışı parametresi. Biçiminde `yyyy-MM-ddTHH:mm:sszzz` dize (Örnek: `2025-09-15T21:45:00+02:00`). Veri akışını yürütürken bu parametre türünü geçersiz kılmak için "Otomatik" türünü kullanın.
DataflowDurationParameter	Duration türünde bir Veri Akışı parametresi. Biçimindeki `\Pd\DTH\Hm\Ms\S` dize (Örnek: `P5DT14H35M30S` 5 gün, 14 saat, 35 dakika ve 30 saniye için). Veri akışını yürütürken bu parametre türünü geçersiz kılmak için "Otomatik" türünü kullanın.
DataflowIntegerParameter	Long türünde bir Veri Akışı parametresi.
DataflowNumberParameter	Double türünde bir Veri Akışı parametresi.
DataflowParameters	Veri akışı parametrelerinin listesi.
DataflowStringParameter	Dize türünde bir Veri Akışı parametresi.
DataflowTimeParameter	Time türünde bir Veri Akışı parametresi. Biçiminde `HH:mm:ss` dize (Örnek: `21:45:00` 21:45 için). Veri akışını yürütürken bu parametre türünü geçersiz kılmak için "Otomatik" türünü kullanın.
ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları nesnesi.
ErrorResponse	Hata yanıtı.
ErrorResponseDetails	Hata yanıtı ayrıntıları.

DataflowBooleanParameter

Nesne

Boole türünde bir Veri Akışı parametresi.

Name	Tür	Description
defaultValue	boolean	Veri akışı yürütülürken hiçbir parametre sağlanmazsa parametresinin yenilendiği değer.
description	string	Parametresinin açıklaması.
isRequired	boolean	Parametresinin gerekli olup olmadığını gösterir.
name	string	Parametresinin adı.
type	string: Boolean	Parametresinin türü. Zaman içinde ek tür türleri eklenebilir.

DataflowDateParameter

Nesne

Date türünde bir Veri Akışı parametresi. Biçimindeki yyyy-MM-dd dize (Örnek: 2025-09-15 15 Eylül 2025 tarihi için). Veri akışını yürütürken bu parametre türünü geçersiz kılmak için "Otomatik" türünü kullanın.

Name	Tür	Description
defaultValue	string	Veri akışı yürütülürken hiçbir parametre sağlanmazsa parametresinin yenilendiği değer.
description	string	Parametresinin açıklaması.
isRequired	boolean	Parametresinin gerekli olup olmadığını gösterir.
name	string	Parametresinin adı.
type	string: Date	Parametresinin türü. Zaman içinde ek tür türleri eklenebilir.

DataflowDateTimeParameter

Nesne

DateTime türünde bir Veri Akışı parametresi. Biçiminde yyyy-MM-ddTHH:mm:ss.xxxZ dize (Örnek: 2025-09-15T21:45:00.000Z).

Name	Tür	Description
defaultValue	string (date-time)	Veri akışı yürütülürken hiçbir parametre sağlanmazsa parametresinin yenilendiği değer.
description	string	Parametresinin açıklaması.
isRequired	boolean	Parametresinin gerekli olup olmadığını gösterir.
name	string	Parametresinin adı.
type	string: DateTime	Parametresinin türü. Zaman içinde ek tür türleri eklenebilir.

DataflowDateTimeZoneParameter

Nesne

DateTimeZone türünde bir Veri Akışı parametresi. Biçiminde yyyy-MM-ddTHH:mm:sszzz dize (Örnek: 2025-09-15T21:45:00+02:00). Veri akışını yürütürken bu parametre türünü geçersiz kılmak için "Otomatik" türünü kullanın.

Name	Tür	Description
defaultValue	string	Veri akışı yürütülürken hiçbir parametre sağlanmazsa parametresinin yenilendiği değer.
description	string	Parametresinin açıklaması.
isRequired	boolean	Parametresinin gerekli olup olmadığını gösterir.
name	string	Parametresinin adı.
type	string: DateTimeZone	Parametresinin türü. Zaman içinde ek tür türleri eklenebilir.

DataflowDurationParameter

Nesne

Duration türünde bir Veri Akışı parametresi. Biçimindeki \Pd\DTH\Hm\Ms\S dize (Örnek: P5DT14H35M30S 5 gün, 14 saat, 35 dakika ve 30 saniye için). Veri akışını yürütürken bu parametre türünü geçersiz kılmak için "Otomatik" türünü kullanın.

Name	Tür	Description
defaultValue	string	Veri akışı yürütülürken hiçbir parametre sağlanmazsa parametresinin yenilendiği değer.
description	string	Parametresinin açıklaması.
isRequired	boolean	Parametresinin gerekli olup olmadığını gösterir.
name	string	Parametresinin adı.
type	string: Duration	Parametresinin türü. Zaman içinde ek tür türleri eklenebilir.

DataflowIntegerParameter

Nesne

Long türünde bir Veri Akışı parametresi.

Name	Tür	Description
defaultValue	integer (int64)	Veri akışı yürütülürken hiçbir parametre sağlanmazsa parametresinin yenilendiği değer.
description	string	Parametresinin açıklaması.
isRequired	boolean	Parametresinin gerekli olup olmadığını gösterir.
name	string	Parametresinin adı.
type	string: Integer	Parametresinin türü. Zaman içinde ek tür türleri eklenebilir.

DataflowNumberParameter

Nesne

Double türünde bir Veri Akışı parametresi.

Name	Tür	Description
defaultValue	number (double)	Veri akışı yürütülürken hiçbir parametre sağlanmazsa parametresinin yenilendiği değer.
description	string	Parametresinin açıklaması.
isRequired	boolean	Parametresinin gerekli olup olmadığını gösterir.
name	string	Parametresinin adı.
type	string: Number	Parametresinin türü. Zaman içinde ek tür türleri eklenebilir.

DataflowParameters

Nesne

Veri akışı parametrelerinin listesi.

Name	Tür	Description
continuationToken	string	Sonraki sonuç kümesi toplu işleminin belirteci. Başka kayıt yoksa yanıttan kaldırılır.
continuationUri	string	Sonraki sonuç kümesi toplu işleminin URI'sini. Başka kayıt yoksa yanıttan kaldırılır.
value	DataflowParameter[]: DataflowBooleanParameter[] DataflowDateParameter[] DataflowDateTimeParameter[] DataflowDateTimeZoneParameter[] DataflowDurationParameter[] DataflowIntegerParameter[] DataflowNumberParameter[] DataflowStringParameter[] DataflowTimeParameter[]	Veri akışında tanımlanan parametrelerin listesi.

DataflowStringParameter

Nesne

Dize türünde bir Veri Akışı parametresi.

Name	Tür	Description
defaultValue	string	Veri akışı yürütülürken hiçbiri sağlanmazsa parametresinin yenilendiği değer.
description	string	Parametresinin açıklaması.
isRequired	boolean	Parametresinin gerekli olup olmadığını gösterir.
name	string	Parametresinin adı.
type	string: String	Parametresinin türü. Zaman içinde ek tür türleri eklenebilir.

DataflowTimeParameter

Nesne

Time türünde bir Veri Akışı parametresi. Biçiminde HH:mm:ss dize (Örnek: 21:45:00 21:45 için). Veri akışını yürütürken bu parametre türünü geçersiz kılmak için "Otomatik" türünü kullanın.

Name	Tür	Description
defaultValue	string	Veri akışı yürütülürken hiçbir parametre sağlanmazsa parametresinin yenilendiği değer.
description	string	Parametresinin açıklaması.
isRequired	boolean	Parametresinin gerekli olup olmadığını gösterir.
name	string	Parametresinin adı.
type	string: Time	Parametresinin türü. Zaman içinde ek tür türleri eklenebilir.

ErrorRelatedResource

Nesne

Hatayla ilgili kaynak ayrıntıları nesnesi.

Name	Tür	Description
resourceId	string	Hataya dahil olan kaynak kimliği.
resourceType	string	Hataya dahil olan kaynağın türü.

ErrorResponse

Nesne

Hata yanıtı.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
isRetriable	boolean	True olduğunda istek yeniden denenebilir. Varsa gecikmeyi `Retry-After` belirlemek için yanıt üst bilgisini kullanın.
message	string	Hatanın okunabilir bir gösterimi.
moreDetails	ErrorResponseDetails[]	Ek hata ayrıntılarının listesi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.
requestId	string (uuid)	Hatayla ilişkili isteğin kimliği.

ErrorResponseDetails

Nesne

Hata yanıtı ayrıntıları.

Name	Tür	Description
errorCode	string	Hizmetimiz ve kullanıcıları arasında standartlaştırılmış iletişime olanak sağlayan bir hata koşulu hakkında bilgi sağlayan belirli bir tanımlayıcı.
message	string	Hatanın okunabilir bir gösterimi.
relatedResource	ErrorRelatedResource	Hatayla ilgili kaynak ayrıntıları.