Data Factory sürüm 1 (V1)

Makale
08/04/2023

Not

Bu başvuru belgeleri Azure Data Factory sürüm 1 (V1) için geçerlidir.

Oluşturma veya güncelleştirme

Data Factory Oluşturma veya Güncelleştirme işlemi yeni bir veri fabrikası oluşturur veya mevcut bir veri fabrikasının içeriğini güncelleştirir.

İstek

Data Factory Oluştur veya Güncelleştir isteği şu şekilde oluşturulabilir (HTTPS önerilir):.

HTTP Fiili	İstek URI'si	HTTP Sürümü
PUT	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}?api-version={api-version}	HTTP/1.1

URI Parametreleri

URI Parametresi	Gerekli	Açıklama
SubscriptionID	Yes	Azure abonelik kimliğiniz.
ResourceGroupName	Yes	Azure data factory Hizmetinizi barındıran kaynak grubunun benzersiz adı.
DataFactoryName	Yes	Oluşturmak istediğiniz veri fabrikasının adı.
Api-Version	Yes	Bu isteği yapmak için kullanılan protokolün sürümünü belirtir.

İstek Üst Bilgileri

Aşağıdaki tabloda istek üst bilgileri açıklanmaktadır.

İstek Başlığı	Gerekli	Açıklama
x-ms-client-request-id	Yes	Bu isteğin işlem kimliği.

İstek Gövdesi

İstek gövdesinin biçimi aşağıdaki gibidir:

{  
    "name": <name>,  
    "location": <location>,  
    "tags": <tags>,  
    "properties": <properties>  
}

Aşağıdaki tabloda istek gövdesinin öğeleri açıklanmaktadır.

Öğe Adı	Gerekli	Açıklama
name	Yes	Veri fabrikasının adını belirtir.
location	Yes	Veri fabrikasının desteklenen Azure konumunu belirtir.
etiketler	No	Kaynağı açıklayan anahtar-değer çiftlerinin listesi.
properties	No	Veri fabrikasının özellikleri.

Yanıt

Yanıt bir HTTP durum kodu, bir dizi yanıt üst bilgisi ve yanıt gövdesi içerir.

Durum Kodu

200 (Tamam) - isteğin başarıyla tamamlandığını gösterir.
202 (Kabul Edildi) - isteğin kabul edildiyse.
400 (Hatalı İstek) - İstek gövdesi doğrulamanın başarısız olup olmadığını belirtir.
404 (NotFound) - abonelik veya kaynak grubu yoksa.
412 (Önkoşul Başarısız Oldu) - If-Match üst bilgisi tarafından belirtilen koşulun başarısız olup olmadığını belirtir.
501 (Uygulanmadı) - doğrulama uygulanmadıysa.

Yanıt Üst Bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt Üst Bilgisi	Açıklama
x-ms-request-id	Data Factory hizmeti tarafından oluşturulan geçerli işlem için benzersiz bir tanımlayıcı.
x-ms-ratelimit-remaining-subscription-writes	Geçerli abonelik için kalan sınır.
x-ms-correlation-request-id	İstek için izleme bağıntı kimliğini belirtir; Uçtan uca isteklerin Azure arasında ilişkilendirilmesi için kaynak sağlayıcısının bu kimliği günlüğe kaydetmesi gerekir .
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tarih	Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.
Konum	Oluşturmak veya almak istediğiniz nesnenin URI'sini.

Yanıt Gövdesi

{
	"name": "<Name>",
	"id": "<ID>",
	"type": "Microsoft.DataFactory/datafactories",
	"location": "<location>",
	"tags": "<tag>",
	"properties": {
		"dataFactoryId": "<DataFactoryID>",
		"provisioningState": "<provisioningstate>",
		"error": "<Error>",
		"errorMessage": "<ErrorMessage>"
	}
}

Aşağıdaki tabloda yanıt gövdesinin öğeleri açıklanmaktadır.

Öğe Adı	Açıklama
name	Veri fabrikasının adını belirtir.
kimlik	Data Factory'nin tanımlayıcı URL'sini belirtir.
location	Veri fabrikasının desteklenen Azure konumunu belirtir.
etiketler	Kaynağı açıklayan anahtar-değer çiftlerinin listesi.
datafactoryID	Bu Data Factory için otomatik oluşturulan kimlik.
provisioningstate	Data Factory'nin geçerli sağlama durumunu belirtir. Data Factory başarıyla oluşturulduğunda öğesinin değeri Başarılı olur.
error	Dağıtım sırasında hata oluşup oluşmadığını belirtir.
errormessage	Hatayla ilgili ileti.

Örnek İstek ve Yanıt

Aşağıdaki örnek URI için:

PUT: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test?api-version=2015-10-01

İstek üst bilgisi:

  
Headers:  
x-ms-client-request-id        : 029a8839-027e-43c5-8854-af4388dcd232

İstek gövdesi:

Body:  
{  
  "name": "RestDataFactory",  
  "location": "West US",  
  "tags": {}  
}

Aşağıdaki yanıt döndürülür:

  
Status Code:  
Created  
  
Headers:  
Pragma                        : no-cache  
x-ms-request-id               : 00000000-1111-1111-1111-000000000000  
x-ms-ratelimit-remaining-subscription-writes: 11999  
x-ms-correlation-request-id   : 00000000-1111-2222-1111-000000000000  
x-ms-routing-request-id       : WESTUS:20141203T212810Z: 00000000-1111-2222-1111-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Wed, 03 Dec 2014 21:28:09 GMT  
Location                      : https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test?api-version=2015-10-01  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET  
client-tracking-id            : 10  
The response includes the following XML body.  
{  
  "name": "test",  
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test",  
  "type": "Microsoft.DataFactory/datafactories",  
  "location": "westus",  
  "tags": {},  
  "properties": {  
    "dataFactoryId": "39d4e663-cfcb-4ee9-ad19-92cf87de9197",
    "provisioningState": "Succeeded",  
    "error": null,  
    "errorMessage": null  
  }  
}

Sil

Belirli bir veri fabrikasını siler.

İstek

Data Factory'yi Sil isteği aşağıdaki gibi oluşturulabilir (HTTPS önerilir):

HTTP Fiili	İstek URI'si	HTTP Sürümü
DELETE	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}?api-version={api-version}	HTTP/1.1

URI Parametreleri

URI Parametresi	Gerekli	Açıklama
SubscriptionID	Yes	Azure abonelik kimliğiniz.
ResourceGroupName	Yes	Azure veri fabrikanızı barındıran kaynak grubu için benzersiz bir ad.
DataFactoryName	Yes	Silmek istediğiniz veri fabrikasının adı.
Api-Version	Yes	Bu isteği yapmak için kullanılan protokolün sürümünü belirtir..

İstek Üst Bilgileri

Aşağıdaki tabloda istek üst bilgileri açıklanmaktadır:

İstek Başlığı	Gerekli	Açıklama
x-ms-client-request-id	Yes	Bu isteğin işlem kimliği.

İstek Gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu, bir dizi yanıt üst bilgisi ve yanıt gövdesi içerir.

Durum Kodu

200 (Tamam) - istek başarıyla tamamlandıysa.
400 (Hatalı İstek) - istek gövdesi doğrulamada başarısız olursa.
404 (NotFound) - abonelik veya kaynak grubu yoksa.
412 (Önkoşul Başarısız Oldu) - If-Match üst bilgi tarafından belirtilen koşul başarısız olduysa.
501 (Uygulanmadı) - doğrulama uygulanmadıysa

Yanıt Üst Bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt Üst Bilgisi	Açıklama
x-ms-request-id	Geçerli işlem için benzersiz bir tanımlayıcı, hizmet oluşturuldu.
x-ms-ratelimit-remaining-subscription-writes	Geçerli abonelik için kalan sınır.
x-ms-correlation-request-id	İstek için izleme bağıntı kimliğini belirtir; Uçtan uca isteklerin Azure arasında ilişkilendirilmesi için kaynak sağlayıcısının bunu günlüğe kaydetmesi gerekir .
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tarih	Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri.

Yanıt Gövdesi

Yok.

Örnek İstek ve Yanıt

Örnek URI:

DELETE: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test?api-version=2015-10-01

İstek aşağıdaki üst bilgilerle gönderilir:

x-ms-client-request-id        : 00000000-1111-1111-1111-000000000000

İstek gönderildikten sonra aşağıdaki yanıt döndürülür:

  
Status Code:  
OK  
  
Headers:  
Pragma                        : no-cache  
x-ms-request-id               : f8c04a54-259b-4085-b596-e6c97fa6433a  
x-ms-ratelimit-remaining-subscription-writes: 1199  
x-ms-correlation-request-id   : ad02c0f4-ca01-49fe-b1d2-5149629d2412  
x-ms-routing-request-id       : EASTUS:20160205T230719Z:ad02c0f4-ca01-49fe-b1d2-5149629d2412  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Fri, 05 Feb 2016 23:07:19 GMT  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET  
  
Body:

Get

Belirtilen veri fabrikası hakkında bilgi alır.

İstek

Get Data Factory isteği aşağıdaki gibi oluşturulabilir (HTTPS önerilir):

HTTP Fiili	İstek URI'si	HTTP Sürümü
GET	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}?api-version={api-version}	HTTP/1.1

URI Parametreleri

URI Parametresi	Gerekli	Açıklama
SubscriptionID	Yes	Azure abonelik kimliğiniz
ResourceGroupName	Yes	Azure veri fabrikanızı barındıran kaynak grubunun benzersiz adı.
DataFactoryName	Yes	Almak istediğiniz veri fabrikasının adı.
Api-Version	Yes	Bu isteği yapmak için kullanılan protokolün sürümünü belirtir.

İstek Üst Bilgileri

Aşağıdaki tabloda istek üst bilgileri açıklanmaktadır.

İstek Başlığı	Gerekli	Açıklama
x-ms-client-request-id	Yes	Bu isteğin işlem kimliği.

İstek Gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu, bir dizi yanıt üst bilgisi ve yanıt gövdesi içerir.

Durum Kodu

200 (Tamam) - istek başarıyla tamamlandıysa.
400 (Hatalı İstek) - istek gövdesi doğrulamada başarısız olursa.
404 (NotFound) - abonelik veya kaynak grubu yoksa.
412 (Önkoşul Başarısız Oldu) - If-Match üst bilgi tarafından belirtilen koşul başarısız olduysa.
501 (Uygulanmadı) - doğrulama uygulanmadıysa

Yanıt Üst Bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt Üst Bilgisi	Açıklama
x-ms-request-id	Geçerli işlem için benzersiz bir tanımlayıcı, hizmet oluşturuldu.
x-ms-ratelimit-remaining-subscription-writes	Geçerli abonelik için kalan sınır.
x-ms-correlation-request-id	İstek için izleme bağıntı kimliğini belirtir; Uçtan uca isteklerin Azure arasında ilişkilendirilmesi için kaynak sağlayıcısının bunu günlüğe kaydetmesi gerekir .
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tarih	Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren UTC tarih/saat değeri

Yanıt Gövdesi

{  
    "name": "<Name>",  
    "id": "<ID>",  
    "type": "Microsoft.DataFactory/datafactories",  
    "location": "<location>",  
    "tags": "<tag>",  
    "properties": {  
        "dataFactoryId": "<DataFactoryID>",
        "provisioningState": "<provisioningstate>",  
        "error": "<Error>",  
        "errorMessage": "<ErrorMessage>"  
    }  
}

Aşağıdaki tabloda yanıt gövdesinin öğeleri açıklanmaktadır.

Öğe Adı	Açıklama
name	Veri fabrikasının adını belirtir
kimlik	Data Factory'nin tanımlayıcı URL'sini belirtir.
location	Data Factory'nin desteklenen Azure konumunu belirtir
etiketler	Kaynağı açıklayan anahtar-değer çiftlerinin listesi
datafactoryID	Bu veri fabrikası için otomatik oluşturulan kimlik.
provisioningstate	Data Factory'nin geçerli sağlama durumunu belirtir. Data Factory başarıyla oluşturulduğunda öğesinin değeri Başarılı olur
error	Dağıtım sırasında herhangi bir hata oluşup oluşmadığını belirtir.
errormessage	Hatayla ilgili ileti

Örnek İstek ve Yanıt

Örnek URI:

GET: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test?api-version=2015-10-01

İstek aşağıdaki üst bilgilerle gönderilir.

x-ms-client-request-id        : 00000000-1111-1111-1111-000000000000

İstek gönderildikten sonra aşağıdaki yanıt döndürülür.

  
Status Code:  
OK  
  
Headers:  
Pragma                        : no-cache  
x-ms-request-id               : 00000000-1111-1111-1111-000000000000  
x-ms-ratelimit-remaining-subscription-writes: 799986  
x-ms-correlation-request-id   : 00000000-1111-2222-1111-000000000000  
x-ms-routing-request-id       : WESTUS:20141203T221428Z: 00000000-1111-2222-1111-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Wed, 03 Dec 2014 22:14:27 GMT  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET  
  
The response includes the following XML body.  
{  
    "name": "test",  
    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test",  
    "type": "Microsoft.DataFactory/datafactories",  
    "location": "westus",  
    "tags": {},  
    "properties": {  
        "dataFactoryId": "00000000-1111-1111-1111-000000000000",  
        "provisioningState": "Succeeded",  
        "error": null,  
        "errorMessage": null  
    }  
}

Liste

Bir kaynak grubundaki tüm veri fabrikalarının bilgilerini Listeler.

İstek

Veri Fabrikalarını Listele isteği aşağıdaki gibi oluşturulabilir (HTTPS önerilir).:

HTTP Fiili	İstek URI'si	HTTP Sürümü
GET	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories?api-version={api-version}	HTTP/1.1

URI Parametreleri

URI Parametresi	Gerekli	Açıklama
SubscriptionID	Yes	Azure abonelik kimliğiniz.
ResourceGroupName	Yes	Azure data factory Hizmetinizi barındıran kaynak grubu için benzersiz bir ad.
Api-Version	Yes	Bu isteği yapmak için kullanılan protokolün sürümünü belirtir.

İstek Üst Bilgileri

Aşağıdaki tabloda istek üst bilgileri açıklanmaktadır.

İstek Başlığı	Gerekli	Açıklama
x-ms-client-request-id	Yes	Bu isteğin işlem kimliği.

İstek Gövdesi

Yok.

Yanıt

Yanıt bir HTTP durum kodu, bir dizi yanıt üst bilgisi ve yanıt gövdesi içerir.

Durum Kodu

200 (Tamam) - isteğin başarıyla tamamlandığını gösterir.
400 (Hatalı İstek) - İstek gövdesi doğrulamada başarısız olursa.
404 (NotFound) - abonelik veya kaynak grubu yoksa.
412 (Önkoşul Başarısız Oldu) - If-Match üst bilgisi tarafından belirtilen koşulun başarısız olup olmadığını belirtir.

Yanıt Üst Bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt Üst Bilgisi	Açıklama
x-ms-request-id	Geçerli işlem için oluşturulan hizmet için benzersiz bir tanımlayıcı.
x-ms-ratelimit-remaining-subscription-writes	Geçerli abonelik için kalan sınır.
x-ms-correlation-request-id	İstek için izleme bağıntı kimliğini belirtir. Uçtan uca isteklerin Azure arasında ilişkilendirilebilmesi için kaynak sağlayıcısının bunu günlüğe kaydetmesi gerekir .
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tarih	Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren utc tarih/saat değeri.

Yanıt Gövdesi

{  
    "value": [  
    {  
        "name": <name1> ,  
        "id": <id>,  
        "type": "Microsoft.DataFactory/datafactories",  
        "location": <location>,  
        "tags": {},  
        "properties": {  
            "dataFactoryId": <datafactoryID>
            "provisioningState": "Succeeded",  
            "error": null,  
            "errorMessage": null  
        }  
    },   
    {  
        "name": <name2> ,  
        "id": <id>,  
        "type": "Microsoft.DataFactory/datafactories",  
        "location": <location>,  
        "tags": {},  
        "properties": {  
            "dataFactoryId": <datafactoryID>
            "provisioningState": "Succeeded",  
            "error": null,  
            "errorMessage": null  
        }  
    }  
    ]  
}

Aşağıdaki tabloda yanıt gövdesinin öğeleri açıklanmaktadır.

Öğe Adı	Açıklama
name	Veri fabrikasının adını belirtir.
kimlik	Data Factory'nin tanımlayıcı URL'sini belirtir.
location	Data Factory'nin desteklenen Azure konumunu belirtir.
etiketler	Kaynağı açıklayan anahtar değer çiftlerinin listesi.
datafactoryID	Bu veri fabrikası için otomatik oluşturulan kimlik.
provisioningstate	Veri fabrikasının geçerli sağlama durumunu belirtir. Bir veri fabrikası başarıyla oluşturulduğunda öğesinin değeri Başarılı olur.
error	Dağıtım sırasında oluşan hataları belirtir.
errormessage	Hatayla ilgili ileti.

100'den fazla kayıt varsa nextLink ile aynı anda 100 kayıt alırsınız:

{
    "value": [  
    {  
        "name": <name1> ,  
        "id": <id>,  
        "type": "Microsoft.DataFactory/datafactories",  
        "location": <location>,  
        "tags": {},  
        "properties": {  
            "dataFactoryId": <datafactoryID>,
            "provisioningState": "Succeeded",  
            "error": null,  
            "errorMessage": null  
        }  
    },   
    {  
        "name": <name2> ,  
        "id": <id>,  
        "type": "Microsoft.DataFactory/datafactories",  
        "location": <location>,  
        "tags": {},  
        "properties": {  
            "dataFactoryId": <datafactoryID>,  
            "provisioningState": "Succeeded",  
            "error": null,  
            "errorMessage": null  
        }  
    }  
    ],  

    "nextLink": "https://management.azure.com/subscriptions/{subscription ID>/resourcegroups/{Resource group name>/providers/Microsoft.DataFactory/datafactories?api-version=2015-10-01&%24skipToken=MSExNiFSR0YwWVVGeWRHbG1ZV04wCjEhNTIhUkVGZlpUSXlaR1UyTXpndFpURTJNeTAwWXpZNUxUaGhNR0l0Wm1VMU1ETmpOakF4T0RObA%3d%3d"
}

Sonraki kayıt kümesini almak için nextLink URL'sini kullanarak sonraki isteği gönderirsiniz. & nextLink URL'sinde çift tırnak ("") ile sarmalamanız gerekebilir. Aynı anda yalnızca 100 kayıt döndürülür.

Örnek İstek ve Yanıt

Örnek URI:

GET: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories?api-version=2015-10-01

İstek aşağıdaki üst bilgilerle gönderilir.

x-ms-client-request-id        : 00000000-1111-1111-1111-000000000000

İstek gönderildikten sonra aşağıdaki yanıt döndürülür.

  
Status Code:  
OK  
  
Headers:  
Pragma                        : no-cache  
x-ms-request-id               : 00000000-1111-1111-1111-000000000000  
x-ms-ratelimit-remaining-subscription-writes: 799986  
x-ms-correlation-request-id   : 00000000-1111-2222-1111-000000000000  
x-ms-routing-request-id       : WESTUS:20141203T221428Z: 00000000-1111-2222-1111-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Wed, 03 Dec 2014 22:14:27 GMT  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET  
  
The response includes the following XML body.  
{  
"value": [  
    {  
        "name": "test",  
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test",  
        "type": "Microsoft.DataFactory/datafactories",  
        "location": "westus",  
        "tags": {},  
        "properties": {  
            "dataFactoryId": "00000000-1111-1111-1111-000000000000",  
            "provisioningState": "Succeeded",  
            "error": null,  
            "errorMessage": null  
        }  
    },  
    {  
        "name": "test2",  
        "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test2",  
        "type": "Microsoft.DataFactory/datafactories",  
        "location": "westus",  
        "tags": {},  
        "properties": {  
            "dataFactoryId": "00000000-1111-1111-1111-000000000001",  
            "provisioningState": "Succeeded",  
            "error": null,  
            "errorMessage": null  
        }  
    }  
]  
}

Etkinlik Pencerelerini Listele

Bir veri fabrikasıyla ilişkili etkinlik penceresi örneklerinin ilk sayfasını ve sonraki sayfaya bağlantı Listeler.

İstek

Etkinlik Al penceresi isteği aşağıdaki gibi oluşturulabilir (HTTPS önerilir):

HTTP Fiili	İstek URI'si	HTTP Sürümü
POST	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/activitywindows?api-version={api-version}	HTTP/1.1

URI Parametreleri

URI Parametresi	Gerekli	Açıklama
SubscriptionID	Yes	Azure abonelik kimliğiniz.
ResourceGroupName	Yes	Azure veri fabrikanızı barındıran kaynak grubunun adı.
DataFactoryName	Yes	Veri fabrikasının adı.
Api-Version	Yes	Bu isteği yapmak için kullanılan protokolün sürümünü belirtir.

İstek Üst Bilgileri

Aşağıdaki tabloda istek üst bilgileri açıklanmaktadır.

İstek Başlığı	Gerekli	Açıklama
x-ms-client-request-id	Yes	Bu isteğin işlem kimliği.

İstek Gövdesi

Öğe Adı	Açıklama	Gerekli
Filtre	Azure Search filtresi dil bilgisi kullanılarak belirtilen etkinlik penceresi filtresi. Ayrıntılar için bkz. https://msdn.microsoft.com/library/azure/dn798921.aspx.	No
Orderby	Yanıtı belirtilen etkinlik penceresi özelliklerine göre sırala. Bu, virgülle ayrılmış özelliklerin listesidir. Örneğin: WindowStart, PercentComplete. Befault tarafından sıra artan düzendir (ASC). Listenin azalan düzende sıralanmasını istiyorsanız DESC belirtin.	No
Üst	Listelenecek etkinlik pencerelerinin sayısı.	No
RunStart	Etkinlik penceresinin başlangıç saati çalıştırılır.	No
RunEnd	Etkinlik penceresinin bitiş saati çalıştırılır.	No
Pencere Başlangıcı	Etkinlik penceresinin başlangıç saati.	No
Pencere Ucu	Etkinlik penceresinin bitiş saati.	No
Windowstate	Etkinlik penceresinin durumu. Bu makalede belirtilen değerlerden biri olmalıdır.	No
WindowSubstate	Etkinlik penceresinin alt durumu. Bu makalede belirtilen değerlerden biri olmalıdır.	No

Yanıt

Yanıt bir HTTP durum kodu, yanıt üst bilgileri kümesi ve yanıt gövdesi içerir.

Durum Kodu

200 (Tamam) - isteğin başarıyla tamamlandığını gösterir.
400 (Hatalı İstek) - istek gövdesi doğrulamada başarısız olursa.
404 (NotFound) - abonelik veya kaynak grubu yoksa.

Yanıt Üst Bilgileri

Bu işlemin yanıtı aşağıdaki üst bilgileri içerir. Yanıt, ek standart HTTP üst bilgileri de içerebilir. Tüm standart üst bilgiler HTTP/1.1 protokol belirtimine uygundur.

Yanıt Üst Bilgisi	Description
x-ms-request-id	Geçerli işlem için oluşturulan hizmet için benzersiz bir tanımlayıcı.
x-ms-ratelimit-remaining-subscription-writes	Geçerli abonelik için kalan sınır.
x-ms-correlation-request-id	İstek için izleme bağıntı kimliğini belirtir. Uçtan uca isteklerin Azure arasında ilişkilendirilebilmesi için kaynak sağlayıcısının bunu günlüğe kaydetmesi gerekir.
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tarih	Hizmet tarafından oluşturulan ve yanıtın başlatıldığı saati gösteren utc tarih/saat değeri.

Yanıt Gövdesi

{  
    "value": {  
    "activityWindows": [  
      {  
        "resourceGroupName": "<resource group name>",  
        "dataFactoryName": "<data factory name>",  
        "pipelineName": "<pipeline name>",  
        "activityName": "<Pipeline activity name.>",  
        "linkedServiceName": "<linked service name>",  
        "activityType": "<The activity type>",  
        "runAttempts": "<Number of activity run attempts.>",  
        "runStart": "<start time of the last run>",  
        "runEnd": "<end time of the last run>",  
        "duration": "<duration of the activity window>",  
        "percentComplete": "<percent completion of activity window>",  
        "windowStart": "<window start time>",  
        "windowEnd": "<window end time>",  
        "windowState": "<window state>",  
        "windowSubstate": "<window substate>",  
        "inputDatasets": "[<input dataset names>]",  
        "outputDatasets": [  
          "<output dataset names>"  
        ],  
        "inputDatasetIds":["<input dataset ids>"],  
        "outputDatasetIds": [  
          "<output dataset ids>" 
        ]  
      }  
    ],  
    "lastUpdate":"<The approximate time for the last activity windows>",  
    "aggregates": {}  
  },  
    "nextLink": "<Link to next page>"  
}

Örnek İstek ve Yanıt

Örnek URI:

POST:https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/dfName/activitywindows?api-version=2015-10-01

İstek aşağıdaki üst bilgi ve gövde ile gönderilir:

Üstbilgi:

x-ms-client-request-id        : 00000000-1111-1111-1111-000000000000

Vücut:

{
  "top": 5
}

İstek gönderildikten sonra aşağıdaki yanıt döndürülür.

  
Status Code:  
OK  
  
Headers:  
Pragma                        : no-cache  
x-ms-request-id               : 00000000-1111-1111-1111-000000000000  
x-ms-ratelimit-remaining-subscription-writes: 799985  
x-ms-correlation-request-id   : 00000000-1111-2222-1111-000000000000  
x-ms-routing-request-id       : WESTUS:20141203T213307Z: 00000000-1111-2222-1111-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Wed, 03 Dec 2014 21:33:07 GMT  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET

Yanıt aşağıdaki XML gövdesini içerir.

"value": {  
    "activityWindows": [  
      {  
        "resourceGroupName": "rgName",  
        "dataFactoryName": "dfName",  
        "pipelineName": "DA_WikipediaClickEvents",  
        "activityName": "DA_WikipediaClickEvents",  
        "linkedServiceName": "LS_Wikipedia",  
        "activityType": "Copy",  
        "runAttempts": 1,  
        "runStart": "2016-01-26T21:41:48.636Z",  
        "runEnd": "2016-01-26T21:41:48.886Z",  
        "duration": "00:00:00.0000250",  
        "percentComplete": 100,  
        "windowStart": "2016-01-25T01:00:00Z",  
        "windowEnd": "2016-01-25T02:00:00Z",  
        "windowState": "Pending",  
        "windowSubstate": "Validating",  
        "inputDatasets": ["DA_WikipediaEvents"],  
        "outputDatasets": [  
           "DA_WikipediaClickEvents"  
        ],  
        "inputDatasetIds": ["308F5E07-5B0C-4AE9-95EB-9CEF26CFDD21"],  
        "outputDatasetIds": [  
          "1e4a0e42-5df3-4a7e-9860-7f75d306ff75"  
        ]  
      },
        {  
        "resourceGroupName": "rgName",  
        "dataFactoryName": "dfName",  
        "pipelineName": "DA_WikipediaClickEvents",  
        "activityName": "DA_WikipediaClickEvents",  
        "linkedServiceName": "LS_Wikipedia",  
        "activityType": "Copy",  
        "runAttempts": 1,  
        "runStart": "2016-01-26T21:41:48.636Z",  
        "runEnd": "2016-01-26T21:41:48.886Z",  
        "duration": "00:00:00.0000250",  
        "percentComplete": 100,  
        "windowStart": "2016-01-25T02:00:00Z",  
        "windowEnd": "2016-01-25T03:00:00Z",  
        "windowState": "Pending",  
        "windowSubstate": "Validating",  
        "inputDatasets": ["DA_WikipediaEvents"],  
        "outputDatasets": [  
           "DA_WikipediaClickEvents"  
        ],  
        "inputDatasetIds": ["308F5E07-5B0C-4AE9-95EB-9CEF26CFDD21"],  
        "outputDatasetIds": [  
          "1e4a0e42-5df3-4a7e-9860-7f75d306ff75"  
        ]  
      },
      {  
        "resourceGroupName": "rgName",  
        "dataFactoryName": "dfName",  
        "pipelineName": "DA_WikipediaClickEvents",  
        "activityName": "DA_WikipediaClickEvents",  
        "linkedServiceName": "LS_Wikipedia",  
        "activityType": "Copy",  
        "runAttempts": 1,  
        "runStart": "2016-01-26T21:41:48.636Z",  
        "runEnd": "2016-01-26T21:41:48.886Z",  
        "duration": "00:00:00.0000250",  
        "percentComplete": 100,  
        "windowStart": "2016-01-03:00:00Z",  
        "windowEnd": "2016-01-25T04:00:00Z",  
        "windowState": "Pending",  
        "windowSubstate": "Validating",  
        "inputDatasets": ["DA_WikipediaEvents"],  
        "outputDatasets": [  
           "DA_WikipediaClickEvents"  
        ],  
        "inputDatasetIds": ["308F5E07-5B0C-4AE9-95EB-9CEF26CFDD21"],  
        "outputDatasetIds": [  
          "1e4a0e42-5df3-4a7e-9860-7f75d306ff75"  
        ]  
      },
      {  
        "resourceGroupName": "rgName",  
        "dataFactoryName": "dfName",  
        "pipelineName": "DA_WikipediaClickEvents",  
        "activityName": "DA_WikipediaClickEvents",  
        "linkedServiceName": "LS_Wikipedia",  
        "activityType": "Copy",  
        "runAttempts": 1,  
        "runStart": "2016-01-26T21:41:48.636Z",  
        "runEnd": "2016-01-26T21:41:48.886Z",  
        "duration": "00:00:00.0000250",  
        "percentComplete": 100,  
        "windowStart": "2016-01-04:00:00Z",  
        "windowEnd": "2016-01-25T05:00:00Z",  
        "windowState": "Pending",  
        "windowSubstate": "Validating",  
        "inputDatasets": ["DA_WikipediaEvents"],  
        "outputDatasets": [  
           "DA_WikipediaClickEvents"  
        ],  
        "inputDatasetIds": ["308F5E07-5B0C-4AE9-95EB-9CEF26CFDD21"],  
        "outputDatasetIds": [  
          "1e4a0e42-5df3-4a7e-9860-7f75d306ff75"  
        ]  
      },
      {  
        "resourceGroupName": "rgName",  
        "dataFactoryName": "dfName",  
        "pipelineName": "DA_WikipediaClickEvents",  
        "activityName": "DA_WikipediaClickEvents",  
        "linkedServiceName": "LS_Wikipedia",  
        "activityType": "Copy",  
        "runAttempts": 1,  
        "runStart": "2016-01-26T21:41:48.636Z",  
        "runEnd": "2016-01-26T21:41:48.886Z",  
        "duration": "00:00:00.0000250",  
        "percentComplete": 100,  
        "windowStart": "2016-01-25T05:00:00Z",  
        "windowEnd": "2016-01-25T06:00:00Z",  
        "windowState": "Pending",  
        "windowSubstate": "Validating",  
        "inputDatasets": ["DA_WikipediaEvents"],  
        "outputDatasets": [  
           "DA_WikipediaClickEvents"  
        ],  
        "inputDatasetIds": ["308F5E07-5B0C-4AE9-95EB-9CEF26CFDD21"],  
        "outputDatasetIds": [  
          "1e4a0e42-5df3-4a7e-9860-7f75d306ff75"  
        ]  
      }
    ],  
    "lastUpdate": "2016-01-26T21:43:45.6837301+00:00",  
    "aggregates": {}  
  },  
    "nextLink": "https://localhost:86/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rgName/datafactories/dfName/activitywindows/skip=FG154H?ApiVerion01012015"}

Sonuçların sonraki sayfasını almak için nextLink URL'sini kullanın.

İstek gövdesinde filtre kullanma

{
  "filter": "(ActivityName eq 'BlobToSqlCopyActivity') and (PipelineName eq 'DP_WikipediaSamplePipeline')"
}

Aracılığıyla paylaş

Data Factory sürüm 1 (V1)

Oluşturma veya güncelleştirme

İstek

URI Parametreleri

İstek Üst Bilgileri

İstek Gövdesi

Yanıt

Durum Kodu

Yanıt Üst Bilgileri

Yanıt Gövdesi

Örnek İstek ve Yanıt

Sil

İstek

URI Parametreleri

İstek Üst Bilgileri

İstek Gövdesi

Yanıt

Durum Kodu

Yanıt Üst Bilgileri

Yanıt Gövdesi

Örnek İstek ve Yanıt

Get

İstek

URI Parametreleri

İstek Üst Bilgileri

İstek Gövdesi

Yanıt

Durum Kodu

Yanıt Üst Bilgileri

Yanıt Gövdesi

Örnek İstek ve Yanıt

Liste

İstek

URI Parametreleri

İstek Üst Bilgileri

İstek Gövdesi

Yanıt

Durum Kodu

Yanıt Üst Bilgileri

Yanıt Gövdesi

Örnek İstek ve Yanıt

Etkinlik Pencerelerini Listele

İstek

URI Parametreleri

İstek Üst Bilgileri

İstek Gövdesi

Yanıt

Durum Kodu

Yanıt Üst Bilgileri

Yanıt Gövdesi

Örnek İstek ve Yanıt

İstek gövdesinde filtre kullanma

Ek kaynaklar