Data Factory versi 1 (V1)

Artikel
07/26/2022
12 menit untuk membaca

Catatan

Dokumentasi referensi ini berlaku untuk Azure Data Factory versi 1 (V1).

Membuat atau memperbarui

Operasi Buat atau Perbarui Data Factory membuat pabrik data baru, atau memperbarui konten pabrik data yang ada.

Minta

Permintaan Buat atau Perbarui Data Factory dapat dibuat sebagai berikut (HTTPS disarankan):.

Kata Kerja HTTP	URI Permintaan	Versi HTTP
PUT	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}?api-version={api-version}	HTTP/1.1

Parameter URI

URI Parameter	Diperlukan	Deskripsi
SubscriptionID	Ya	ID langganan Azure Anda.
ResourceGroupName	Ya	Nama unik untuk grup sumber daya yang menghosting Layanan pabrik data Azure Anda.
DataFactoryName	Ya	Nama pabrik data yang ingin Anda buat.
Api-Version	Ya	Menentukan versi protokol yang digunakan untuk membuat permintaan ini.

Judul Permintaan

Tabel berikut ini menjelaskan header permintaan.

Header Permintaan	Diperlukan	Deskripsi
x-ms-client-request-id	Ya	ID operasi untuk permintaan ini.

Isi Permintaan

Format isi permintaan adalah sebagai berikut:

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

Tabel berikut ini menjelaskan elemen isi permintaan.

Nama Elemen	Diperlukan	Deskripsi
nama	Ya	Menentukan nama pabrik data.
lokasi	Ya	Menentukan lokasi Azure pabrik data yang didukung.
tags	Tidak	Daftar pasangan kunci-nilai yang menjelaskan sumber daya.
properti	Tidak	Properti pabrik data.

Respons

Respons mencakup kode status HTTP, sekumpulan header respons, dan isi respons.

Kode Status

200 (OK) - jika permintaan berhasil diselesaikan.
202 (Diterima) - jika permintaan diterima.
400 (Permintaan Buruk) - jika isi permintaan gagal validasi.
404 (NotFound) - jika langganan atau grup sumber daya tidak ada.
412 (Prasyarat Gagal) - jika kondisi yang ditentukan oleh header If-Match gagal.
501 (Tidak Diimplementasikan) - jika validasi tidak diimplementasikan.

Header Respons

Respons untuk operasi ini mencakup header berikut. Respons juga dapat mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.

Header Respons	Deskripsi
x-ms-request-id	Pengidentifikasi unik untuk operasi saat ini, yang dihasilkan oleh layanan Data Factory.
x-ms-ratelimit-remaining-subscription-writes	Batas yang tersisa untuk langganan saat ini.
x-ms-correlation-request-id	Menentukan ID korelasi pelacakan untuk permintaan; penyedia sumber daya harus mencatat ID ini sehingga permintaan end-to-end dapat berkorelasi di seluruh Azure.
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tanggal	Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu di mana respons dimulai.
Lokasi	URI objek yang ingin Anda buat atau dapatkan.

Isi Respons

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

Tabel berikut ini menjelaskan elemen isi respons.

Nama Elemen	Deskripsi
nama	Menentukan nama pabrik data.
id	Menentukan URL identifikasi Data Factory.
lokasi	Menentukan lokasi Azure pabrik data yang didukung.
tags	Daftar pasangan kunci-nilai yang menjelaskan sumber daya.
datafactoryID	ID yang dibuat secara otomatis untuk Data Factory ini.
provisioningstate	Menentukan status penyediaan Data Factory saat ini. Saat Data Factory berhasil dibuat, nilai elemen berhasil.
kesalahan	Menentukan apakah terjadi kesalahan selama penyebaran.
errormessage	Pesan yang terkait dengan kesalahan.

Permintaan dan Respons Sampel

Untuk contoh URI berikut:

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

Header permintaan:

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

Isi permintaan:

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

Respons berikut dikembalikan:

  
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  
  }  
}

Hapus

Menghapus pabrik data tertentu.

Minta

Permintaan Hapus Data Factory dapat dibuat sebagai berikut (HTTPS disarankan):

Kata Kerja HTTP	URI Permintaan	Versi HTTP
HAPUS	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}?api-version={api-version}	HTTP/1.1

Parameter URI

URI Parameter	Diperlukan	Deskripsi
SubscriptionID	Ya	ID langganan Azure Anda.
ResourceGroupName	Ya	Nama unik untuk grup sumber daya yang menghosting pabrik data Azure Anda.
DataFactoryName	Ya	Nama pabrik data yang ingin Anda hapus.
Api-Version	Ya	Menentukan versi protokol yang digunakan untuk membuat permintaan ini..

Judul Permintaan

Tabel berikut ini menjelaskan header permintaan:

Header Permintaan	Diperlukan	Deskripsi
x-ms-client-request-id	Ya	Id operasi untuk permintaan ini.

Isi Permintaan

Tidak ada.

Respons

Respons mencakup kode status HTTP, sekumpulan header respons, dan isi respons.

Kode Status

200 (OK) - jika permintaan berhasil diselesaikan.
400 (Permintaan Buruk) - jika isi permintaan gagal validasi.
404 (NotFound) - jika langganan atau grup sumber daya tidak ada.
412 (Prasyarat Gagal) - jika kondisi yang ditentukan oleh header If-Match gagal.
501 (Tidak Diimplementasikan) - jika validasi tidak diimplementasikan

Header Respons

Respons untuk operasi ini mencakup header berikut. Respons juga dapat mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.

Header Respons	Deskripsi
x-ms-request-id	Pengidentifikasi unik untuk operasi saat ini, dihasilkan oleh layanan.
x-ms-ratelimit-remaining-subscription-writes	Batas yang tersisa untuk langganan saat ini.
x-ms-correlation-request-id	Menentukan Id korelasi pelacakan untuk permintaan; penyedia sumber daya harus mencatat ini sehingga permintaan end-to-end dapat berkorelasi di seluruh Azure.
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tanggal	Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu di mana respons dimulai.

Isi Respons

Tidak ada.

Permintaan dan Respons Sampel

Contoh URI:

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

Permintaan dikirim dengan header berikut:

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

Setelah permintaan dikirim, respons berikut dikembalikan:

  
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:

Dapatkan

Mendapatkan informasi tentang pabrik data yang ditentukan.

Minta

Permintaan Dapatkan Data Factory dapat dibuat sebagai berikut (HTTPS disarankan):

Kata Kerja HTTP	URI Permintaan	Versi HTTP
GET	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}?api-version={api-version}	HTTP/1.1

Parameter URI

URI Parameter	Diperlukan	Deskripsi
SubscriptionID	Ya	ID langganan Azure Anda
ResourceGroupName	Ya	Nama unik untuk grup sumber daya yang menghosting pabrik data Azure Anda.
DataFactoryName	Ya	Nama pabrik data yang ingin Anda dapatkan.
Api-Version	Ya	Menentukan versi protokol yang digunakan untuk membuat permintaan ini.

Judul Permintaan

Tabel berikut ini menjelaskan header permintaan.

Header Permintaan	Diperlukan	Deskripsi
x-ms-client-request-id	Ya	ID operasi untuk permintaan ini.

Isi Permintaan

Tidak ada.

Respons

Respons mencakup kode status HTTP, sekumpulan header respons, dan isi respons.

Kode Status

200 (OK) - jika permintaan berhasil diselesaikan.
400 (Permintaan Buruk) - jika isi permintaan gagal validasi.
404 (NotFound) - jika langganan atau grup sumber daya tidak ada.
412 (Prasyarat Gagal) - jika kondisi yang ditentukan oleh header If-Match gagal.
501 (Tidak Diimplementasikan) - jika validasi tidak diimplementasikan

Header Respons

Respons untuk operasi ini mencakup header berikut. Respons juga dapat mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.

Header Respons	Deskripsi
x-ms-request-id	Pengidentifikasi unik untuk operasi saat ini, dihasilkan oleh layanan.
x-ms-ratelimit-remaining-subscription-writes	Batas yang tersisa untuk langganan saat ini.
x-ms-correlation-request-id	Menentukan Id korelasi pelacakan untuk permintaan; penyedia sumber daya harus mencatat ini sehingga permintaan end-to-end dapat berkorelasi di seluruh Azure.
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tanggal	Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu di mana respons dimulai

Isi Respons

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

Tabel berikut ini menjelaskan elemen isi respons.

Nama Elemen	Deskripsi
nama	Menentukan nama pabrik data
id	Menentukan URL identifikasi Data Factory.
lokasi	Menentukan lokasi Azure yang didukung dari pabrik data
tags	Daftar pasangan kunci-nilai yang menjelaskan sumber daya
datafactoryID	ID yang dibuat secara otomatis untuk pabrik data ini.
provisioningstate	Menentukan status penyediaan Data Factory saat ini. Saat Data Factory berhasil dibuat, nilai elemen berhasil
kesalahan	Menentukan apakah terjadi kesalahan selama penyebaran.
errormessage	Pesan yang terkait dengan kesalahan

Permintaan dan Respons Sampel

Contoh URI:

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

Permintaan dikirim dengan header berikut.

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

Setelah permintaan dikirim, respons berikut dikembalikan.

  
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  
    }  
}

Daftar

Mencantumkan informasi semua pabrik data dalam grup sumber daya.

Minta

Permintaan List Data Factories dapat dibuat sebagai berikut (HTTPS disarankan).:

Kata Kerja HTTP	URI Permintaan	Versi HTTP
GET	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories?api-version={api-version}	HTTP/1.1

Parameter URI

URI Parameter	Diperlukan	Deskripsi
SubscriptionID	Ya	ID langganan Azure Anda.
ResourceGroupName	Ya	Nama unik untuk grup sumber daya yang menghosting Layanan pabrik data Azure Anda.
Api-Version	Ya	Menentukan versi protokol yang digunakan untuk membuat permintaan ini.

Judul Permintaan

Tabel berikut ini menjelaskan header permintaan.

Header Permintaan	Diperlukan	Deskripsi
x-ms-client-request-id	Ya	Id operasi untuk permintaan ini.

Isi Permintaan

Tidak ada.

Respons

Respons mencakup kode status HTTP, sekumpulan header respons, dan isi respons.

Kode Status

200 (OK) - jika permintaan berhasil diselesaikan.
400 (Permintaan Buruk) - jika isi permintaan gagal validasi.
404 (NotFound) - jika langganan atau grup sumber daya tidak ada.
412 (Prasyarat Gagal) - jika kondisi yang ditentukan oleh header If-Match gagal.

Header Respons

Respons untuk operasi ini mencakup header berikut. Respons juga dapat mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.

Header Respons	Deskripsi
x-ms-request-id	Pengidentifikasi unik untuk operasi saat ini, dihasilkan oleh layanan.
x-ms-ratelimit-remaining-subscription-writes	Batas yang tersisa untuk langganan saat ini.
x-ms-correlation-request-id	Menentukan Id korelasi pelacakan untuk permintaan tersebut. Penyedia sumber daya harus mencatat ini sehingga permintaan end-to-end dapat berkorelasi di seluruh Azure.
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tanggal	Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu dimulainya respons.

Isi Respons

{  
    "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  
        }  
    }  
    ]  
}

Tabel berikut ini menjelaskan elemen isi respons.

Nama Elemen	Deskripsi
nama	Menentukan nama pabrik data.
id	Menentukan URL identifikasi Data Factory.
lokasi	Menentukan lokasi Azure pabrik data yang didukung.
tags	Daftar pasangan nilai kunci yang menjelaskan sumber daya.
datafactoryID	ID yang dibuat secara otomatis untuk pabrik data ini.
provisioningstate	Menentukan status penyediaan pabrik data saat ini. Saat pabrik data berhasil dibuat, nilai elemen berhasil.
kesalahan	Menentukan kesalahan yang terjadi selama penyebaran.
errormessage	Pesan yang terkait dengan kesalahan.

Jika ada lebih dari 100 rekaman, Anda akan mendapatkan 100 rekaman sekali waktu dengan NextLink:

{
    "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"
}

Anda mengirim permintaan berikutnya menggunakan URL NextLink untuk mendapatkan kumpulan rekaman berikutnya. Anda mungkin perlu membungkus & dengan tanda kutip ganda ("") di URL NextLink. Hanya 100 rekaman yang dikembalikan pada satu waktu.

Permintaan dan Respons Sampel

Contoh URI:

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

Permintaan dikirim dengan header berikut.

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

Setelah permintaan dikirim, respons berikut dikembalikan.

  
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  
        }  
    }  
]  
}

Windows Aktivitas Daftar

Mencantumkan halaman pertama instans jendela aktivitas yang terkait dengan pabrik data bersama dengan tautan ke halaman berikutnya.

Minta

Permintaan jendela Dapatkan Aktivitas dapat dibuat sebagai berikut (HTTPS disarankan):

Kata Kerja HTTP	Meminta URI	Versi HTTP
POST	https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/activitywindows?api-version={api-version}	HTTP/1.1

Parameter URI

URI Parameter	Diperlukan	Deskripsi
SubscriptionID	Ya	ID langganan Azure Anda.
ResourceGroupName	Ya	Nama grup sumber daya yang menghosting pabrik data Azure Anda.
DataFactoryName	Ya	Nama pabrik data.
Api-Version	Ya	Menentukan versi protokol yang digunakan untuk membuat permintaan ini.

Judul Permintaan

Tabel berikut ini menjelaskan header permintaan.

Header Permintaan	Diperlukan	Deskripsi
x-ms-client-request-id	Ya	Id operasi untuk permintaan ini.

Isi Permintaan

Nama Elemen	Deskripsi	Diperlukan
Filter	Filter jendela aktivitas yang ditentukan menggunakan tata bahasa filter Azure Search. Lihat https://msdn.microsoft.com/library/azure/dn798921.aspx untuk detailnya.	Tidak
OrderBy	Pesan respons berdasarkan properti jendela aktivitas yang ditentukan. Ini adalah daftar properti yang dipisahkan koma. Misalnya: WindowStart, PercentComplete. Dengan befault, urutannya adalah urutan naik (ASC). Tentukan DESC jika Anda ingin daftar diurutkan dalam urutan turun.	Tidak
$top	Jumlah jendela aktivitas yang akan dicantumkan.	Tidak
JalankanMulai	Waktu mulai eksekusi jendela aktivitas.	Tidak
RunEnd	Waktu akhir eksekusi jendela aktivitas.	Tidak
WindowStart	Waktu mulai jendela aktivitas.	Tidak
WindowEnd	Waktu akhir jendela aktivitas.	Tidak
WindowState	Status jendela aktivitas. Harus salah satu nilai yang ditentukan dalam artikel ini.	Tidak
WindowSubstate	Substat jendela aktivitas. Harus salah satu nilai yang ditentukan dalam artikel ini.	Tidak

Respons

Respons mencakup kode status HTTP, sekumpulan header respons, dan isi respons.

Kode Status

200 (OK) - jika permintaan berhasil diselesaikan.
400 (Permintaan Buruk) - jika isi permintaan gagal validasi.
404 (NotFound) - jika langganan atau grup sumber daya tidak ada.

Header Respons

Respons untuk operasi ini mencakup header berikut. Respons juga dapat mencakup header HTTP standar tambahan. Semua header standar sesuai dengan spesifikasi protokol HTTP/1.1.

Header Respons	Deskripsi
x-ms-request-id	Pengidentifikasi unik untuk operasi saat ini, dihasilkan oleh layanan.
x-ms-ratelimit-remaining-subscription-writes	Batas yang tersisa untuk langganan saat ini.
x-ms-correlation-request-id	Menentukan Id korelasi pelacakan untuk permintaan tersebut. Penyedia sumber daya harus mencatat ini sehingga permintaan end-to-end dapat berkorelasi di seluruh Azure.
x-ms-routing-request-id	Location+DateTime+correlation-request-ID
Tanggal	Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu di mana respons dimulai.

Isi Respons

{  
    "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>"  
}

Permintaan dan Respons Sampel

Contoh 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

Permintaan dikirim dengan header dan isi berikut:

Header:

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

Isi:

{
  "top": 5
}

Setelah permintaan dikirim, respons berikut dikembalikan.

  
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

Respons mencakup isi XML berikut.

"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"}

Gunakan URL NextLink untuk mendapatkan halaman hasil berikutnya.

Menggunakan filter dalam isi permintaan

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