Ağ geçidi sürüm 1 (V1)
Not
Bu başvuru belgeleri Azure Data Factory sürüm 1 (V1) için geçerlidir.
Oluştur
Yeni bir ağ geçidi oluşturur.
İstek
Ağ Geçidi Oluştur veya Güncelleştir isteği aşağıdaki gibi 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}/gateways/{GatewayName}?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 | Ağ geçidinizi oluşturmak istediğiniz veri fabrikasının adı. |
| GatewayName | Yes | Oluşturmak istediğiniz ağ geçidinin 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>,
"properties": {
"description": <description>
}
}
Aşağıdaki tabloda istek gövdesinin öğeleri açıklanmaktadır.
| Öğe Adı | Gerekli | Açıklama |
|---|---|---|
| name | Yes | Ağ geçidinin adı. |
| açıklama | No | Ağ geçidinin açıklaması. |
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.
202 (Kabul Edildi) - istek kabul edildiyse.
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 bilgisi tarafından belirtilen koşul başarısız olduysa.
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 |
Yanıt Gövdesi
{
"location": <location>,
"name": <name>,
"properties": {
"key": <key>,
"description": <description>,
"hostServiceUri": <hostServiceUri>,
"dataFactoryName": <dataFactoryName>,
"status": <status>,
"versionStatus": <versionStatus>,
"provisioningState": <provisioningState>,
"version": <version>,
"createTime": <createTime>,
"registerTime": <registerTime>,
"lastConnectTime": <lastConnectTime>,
"expiryTime": <expiryTime>
}
}
Aşağıdaki tabloda yanıt gövdesinin öğeleri açıklanmaktadır.
| Öğe Adı | Açıklama |
|---|---|
| name | Ağ geçidinin adı. |
| location | Ağ geçidinin konumu. |
| anahtar | Kayıt için kullanılan ağ geçidinin anahtarı. |
| açıklama | Ağ geçidinin açıklaması. |
| hostServiceUri | Ağ geçidinin konak makinesi için Uri |
| dataFactoryName | Ağ geçidinin ait olduğu veri fabrikasının adı. |
| durum | Ağ geçidinin durumu. Değerler Çevrimiçi, Çevrimdışı veya NeedRegistration olabilir. |
| versionStatus | Ağ geçidi sürümünün durumu. Değerler UpToDate, Expireing, Expired, NewVersionAvailable ve None olabilir. |
| provisioningState | Bağlı hizmetin geçerli sağlama durumunu belirtir. Bağlı hizmet başarıyla oluşturulduğunda öğesinin değeri Başarılı olur. |
| sürüm | Ağ geçidi sürümü |
| createTime | Ağ geçidinin oluşturulduğu saat. |
| registerTime | Ağ geçidinin kaydedildiği saat. |
| expiryTime | Ağ geçidinin süresinin dolacağı saat. |
| lastConnectTime | Ağ geçidinin son kez bağlantı olduğu zaman. |
Örnek İstek ve Yanıt
Örnek URI:
PUT: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test/gateways/gatewaytest?api-version=2015-10-01
İstek aşağıdaki üst bilgilerle gönderilir.
x-ms-client-request-id: 00000000-0000-0000-0000-000000000000
Ve aşağıdaki cesetle.
{
"name": "gatewaytest",
"properties": {
"description": "test description."
}
}
İ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: 11999
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213044Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:30:44 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
Yanıt aşağıdaki XML gövdesini içerir.
{
"location": "West US",
"name": "gatewaytest",
"properties": {
"key": "ADF#066b1a89-e84f-47a4-a784-a753b2e06623@21a6600e-6a83-4734-9a7a-b2a6b791b129@317515fd-a26a-4a08-a2f5-c13fb49b3851@wu#11gTEsN4o12bfYN26qbjlJMgihOlX7hyYAmrPwtLCRU=",
"description": "test description.",
"hostServiceUri": null,
"dataFactoryName": "test",
"status": "NeedRegistration",
"versionStatus": "None",
"provisioningState": "Succeeded",
"version": null,
"createTime": "2015-12-18T07:04:13.00664Z",
"registerTime": null,
"lastConnectTime": null,
"expiryTime": null
}
}
Sil
Belirli bir ağ geçidini siler.
İstek
Delete Gateway 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}/gateways/{GatewayName}?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 | Ağ geçidinizi oluşturmak istediğiniz veri fabrikasının adı. |
| GatewayName | Yes | Oluşturmak istediğiniz ağ geçidinin 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, 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.
412 (Önkoşul Başarısız Oldu) - If-Match üst bilgisi tarafından belirtilen koşul başarısız olduysa.
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 |
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/gateways/gatewaytest?api-version=2014-12-01-preview
İstek aşağıdaki üst bilgilerle gönderilir.
x-ms-client-request-id: 00000000-0000-0000-0000-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: 11999
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213044Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:30:44 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
Al
Mevcut bir ağ geçidi hakkında bilgi alır.
İstek
Get Gateway 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}/gateways/{GatewayName}?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 | Ağ geçidinizi oluşturmak istediğiniz veri fabrikasının adı. |
| GatewayName | Yes | Oluşturmak istediğiniz ağ geçidinin 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, 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, kaynak grubu veya ağ geçidi yoksa.
412 (Önkoşul Başarısız Oldu) - If-Match üst bilgisi tarafından belirtilen koşul başarısız olduysa.
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 |
Yanıt Gövdesi
{
"name": <name>,
"properties": {
"key": null,
"description": <description>,
"hostServiceUri": <hostServiceUri>,
"dataFactoryName": <dataFactoryName>,
"status": <status>,
"versionStatus": <versionStatus>,
"provisioningState": <provisioningState>,
"version": <version>,
"createTime": <createTime>,
"registerTime": <registerTime>,
"lastConnectTime": <lastConnectTime>,
"expiryTime": <expiryTime>
},
"id": <ID>
}
Aşağıdaki tabloda yanıt gövdesinin öğeleri açıklanmaktadır.
| Öğe Adı | Açıklama |
|---|---|
| name | Ağ geçidinin adı. |
| location | Ağ geçidinin konumu. |
| anahtar | Kayıt için kullanılan ağ geçidinin anahtarı. Anahtar alınamadığından alma işleminde her zaman null olur. |
| açıklama | Ağ geçidinin açıklaması. |
| hostServiceUri | Ağ geçidinin konak makinesine erişmek için Uri. |
| dataFactoryName | Ağ geçidinin ait olduğu veri fabrikasının adı. |
| durum | Çevrimiçi, Çevrimdışı veya NeedRegistration olabilecek ağ geçidinin durumu. |
| versionStatus | UpToDate, Expireing, Expired, NewVersionAvailable ve None olabilecek ağ geçidi sürümünün durumu. |
| provisioningState | Bağlı hizmetin geçerli sağlama durumunu belirtir. Bağlı hizmet başarıyla oluşturulduğunda öğesinin değeri Başarılı olur. |
| sürüm | Ağ geçidi sürümü. |
| createTime | Ağ geçidinin oluşturulduğu saat. |
| registerTime | Ağ geçidinin kaydedildiği saat. |
| expiryTime | Ağ geçidinin süresinin dolacağı saat. |
| lastConnectTime | Ağ geçidinin son kez bağlantı olduğu zaman. |
Örnek İstek ve Yanıt
Örnek URI:
GET: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/SPRestDataFactory/gateways/SPGateway?api-version=2015-10-01
İstek aşağıdaki üst bilgilerle gönderilir.
x-ms-client-request-id: 00000000-0000-0000-0000-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: 11999
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213044Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:30:44 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
Yanıt aşağıdaki XML gövdesini içerir.
{
"value": [
{
"name": "SPGateway",
"properties": {
"hostServiceUri": "https://{machine>.<domain>.corp.<company>.com:8050/HostServiceRemote.svc/",
"dataFactoryName": "sprestdatafactory",
"status": "Online",
"versionStatus": "UpToDate",
"provisioningState": "Succeeded",
"version": "1.9.5865.2",
"createTime": "2016-02-24T18:55:03.1149963Z",
"registerTime": "2016-02-24T18:56:13.299978Z",
"lastConnectTime": "2016-02-24T18:57:07.6144045Z"
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/SPRestDataFactory/gateways/SPGateway"
}
]
}
Liste
Veri fabrikasındaki tüm ağ geçitlerinin bilgilerini listeler.
İstek
Liste Ağ Geçitleri 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}/gateways?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 | Ağ geçidinizi 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
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 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 | İsteğ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 |
Yanıt Gövdesi
{
"value":[
{
"name": <name>,
"properties": {
"key": null,
"description": <description>,
"hostServiceUri": <hostServiceUri>,
"dataFactoryName": <dataFactoryName>,
"status": <status>,
"versionStatus": <versionStatus>,
"provisioningState": <provisioningState>,
"version": <version>,
"createTime": <createTime>,
"registerTime": <registerTime>,
"lastConnectTime": <lastConnectTime>,
"expiryTime": <expiryTime>
}
},
{
"name": <name>,
"properties": {
"key": null,
"description": <description>,
"hostServiceUri": <hostServiceUri>,
"dataFactoryName": <dataFactoryName>,
"status": <status>,
"versionStatus": <versionStatus>,
"provisioningState": <provisioningState>,
"version": <version>,
"createTime": <createTime>,
"registerTime": <registerTime>,
"lastConnectTime": <lastConnectTime>,
"expiryTime": <expiryTime>
}
]
}
Aşağıdaki tabloda yanıt gövdesinin öğeleri açıklanmaktadır.
| Öğe Adı | Açıklama |
|---|---|
| name | Ağ geçidinin adı. |
| location | Ağ geçidinin konumu. |
| anahtar | Kayıt için kullanılan ağ geçidinin anahtarı. |
| açıklama | Ağ geçidinin açıklaması. |
| hostServiceUri | Ağ geçidinin konak makinesine erişmek için Uri |
| dataFactoryName | Ağ geçidinin ait olduğu veri fabrikasının adı. |
| durum | Çevrimiçi, Çevrimdışı veya NeedRegistration olabilecek ağ geçidinin durumu |
| versionStatus | UpToDate, Expireing, Expired, NewVersionAvailable ve None olabilecek ağ geçidi sürümünün durumu. |
| provisioningState | Bağlı hizmetin geçerli sağlama durumunu belirtir. Bağlı hizmet başarıyla oluşturulduğunda öğesinin değeri Başarılı olur. |
| sürüm | Ağ geçidinin sürümü. |
| createTime | Ağ geçidinin oluşturulduğu saat. |
| registerTime | Ağ geçidinin kaydedildiği saat. |
| expiryTime | Ağ geçidinin süresinin dolacağı saat. |
| lastConnectTime | Ağ geçidinin son bağlantı olduğu zaman. |
Örnek İstek ve Yanıt
Örnek URI:
PUT: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/SPRestDataFactory/gateways?api-version=2015-10-01
İstek aşağıdaki üst bilgilerle gönderilir.
x-ms-client-request-id: 00000000-0000-0000-0000-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: 11999
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213044Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:30:44 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
Yanıt aşağıdaki XML gövdesini içerir.
{
"value": [
{
"name": "SPGateway",
"properties": {
"hostServiceUri": "https://{machine>.<domain>.corp.<company>.com:8050/HostServiceRemote.svc/",
"dataFactoryName": "sprestdatafactory",
"status": "Online",
"versionStatus": "UpToDate",
"provisioningState": "Succeeded",
"version": "1.9.5865.2",
"createTime": "2016-02-24T18:55:03.1149963Z",
"registerTime": "2016-02-24T18:56:13.299978Z",
"lastConnectTime": "2016-02-24T19:06:40.1454525Z"
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/SPRestDataFactory/gateways/SPGateway"
},
{
"name": "SPGateway2",
"properties": {
"hostServiceUri": "https://{machine>.<domain>.corp.<company>.com:8050/HostServiceRemote.svc/",
"dataFactoryName": "sprestdatafactory",
"status": "Online",
"versionStatus": "UpToDate",
"provisioningState": "Succeeded",
"version": "1.9.5865.2",
"createTime": "2016-02-24T18:55:03.1149963Z",
"registerTime": "2016-02-24T18:56:13.299978Z",
"lastConnectTime": "2016-02-24T19:06:40.1454525Z"
},
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/ADF/providers/Microsoft.DataFactory/datafactories/SPRestDataFactory/gateways/SPGateway"
}
]
}
Anahtarı yeniden oluşturma
Eski anahtarın yerini alan mevcut bir ağ geçidi için yeni bir anahtarı yeniden oluşturur.
İstek
Ağ Geçidi Anahtarını Yeniden Oluştur 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}/gateways/{GatewayName}/regeneratekey?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 | Ağ geçidinizi oluşturmak istediğiniz veri fabrikasının adı. |
| GatewayName | Yes | Oluşturmak istediğiniz ağ geçidinin 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, 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.
412 (Önkoşul Başarısız Oldu) - If-Match üst bilgisi tarafından belirtilen koşul başarısız olduysa.
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 |
Yanıt Gövdesi
{
"key": <key>
}
Aşağıdaki tabloda yanıt gövdesinin öğeleri açıklanmaktadır.
| Öğe Adı | Description |
|---|---|
| anahtar | Kayıt için kullanılan ağ geçidinin anahtarı |
Örnek İstek ve Yanıt
Örnek URI:
PUT: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test/gateways/gatewaytest/regeneratekey?api-version=2015-10-01
İstek aşağıdaki üst bilgilerle gönderilir.
x-ms-client-request-id: 00000000-0000-0000-0000-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: 11999
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213044Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:30:44 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
Yanıt aşağıdaki XML gövdesini içerir.
{
"key": " ADF#066b1a89-e84f-47a4-a784-a753b2e06623@21a6600e-6a83-4734-9a7a-b2a6b791b129@317515fd-a26a-4a08-a2f5-c13fb49b3851@wu#11gTEsN4o12bfYN26qbjlJMgihOlX7hyYAmrPwtLCRU="
}
Güncelleştir
Mevcut ağ geçidinin içeriğini Güncelleştirmeler.
İstek
Update Gateway isteği aşağıdaki gibi oluşturulabilir (HTTPS önerilir):
| HTTP Fiili | İstek URI'si | HTTP Sürümü |
|---|---|---|
| YAMA | https://management.azure.com/subscriptions/{SubscriptionID}/resourcegroups/{ResourceGroupName}/providers/Microsoft.DataFactory/datafactories/{DataFactoryName}/gateways/{GatewayName}?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 | Ağ geçidinizi oluşturmak istediğiniz veri fabrikasının adı. |
| GatewayName | Yes | Oluşturmak istediğiniz ağ geçidinin 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:
{
"properties": {
"description": <description>
}
}
Aşağıdaki tabloda istek gövdesinin öğeleri açıklanmaktadır.
| Öğe Adı | Gerekli | Açıklama |
|---|---|---|
| açıklama | No | Ağ geçidinin açıklaması. |
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.
412 (Önkoşul Başarısız Oldu) - If-Match üst bilgisi tarafından belirtilen koşul başarısız olduysa.
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 |
Yanıt Gövdesi
{
"name": <name>,
"properties": {
"key": null
"description": <description>,
"hostServiceUri": <hostServiceUri>,
"dataFactoryName": <dataFactoryName>,
"status": <status>,
"versionStatus": <versionStatus>,
"provisioningState": <provisioningState>,
"version": <version>,
"createTime": <createTime>,
"registerTime": <registerTime>,
"lastConnectTime": <lastConnectTime>,
"expiryTime": <expiryTime>
}
}
Aşağıdaki tabloda yanıt gövdesinin öğeleri açıklanmaktadır.
| Öğe Adı | Açıklama |
|---|---|
| name | Ağ geçidinin adı. |
| location | Ağ geçidinin konumu. |
| anahtar | Kayıt için kullanılan ağ geçidinin anahtarı. |
| açıklama | Ağ geçidinin açıklaması. |
| hostServiceUri | Ağ geçidinin konak makinesine erişmek için Uri. |
| dataFactoryName | Ağ geçidinin ait olduğu veri fabrikasının adı. |
| durum | Çevrimiçi, Çevrimdışı veya NeedRegistration olabilecek ağ geçidinin durumu. |
| versionStatus | UpToDate, Expireing, Expired, NewVersionAvailable ve None olabilecek ağ geçidi sürümünün durumu. |
| provisioningState | Bağlı hizmetin geçerli sağlama durumunu belirtir. Bağlı hizmet başarıyla oluşturulduğunda öğesinin değeri Başarılı olur. |
| sürüm | Ağ geçidi sürümü. |
| createTime | Ağ geçidinin oluşturulduğu saat. |
| registerTime | Ağ geçidinin kaydedildiği saat. |
| expiryTime | Ağ geçidinin süresinin dolacağı saat. |
| lastConnectTime | Ağ geçidinin son kez bağlantı olduğu zaman. |
Örnek İstek ve Yanıt
Örnek URI:
PATCH: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test/gateways/gatewaytest?api-version=2015-10-01
İstek aşağıdaki üst bilgilerle gönderilir.
x-ms-client-request-id: 00000000-0000-0000-0000-000000000000
Ve aşağıdaki gövde ile:
{
"properties": {
"description": "test description."
}
}
İ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: 11999
x-ms-correlation-request-id : 00000000-1111-2222-1111-000000000000
x-ms-routing-request-id : WESTUS:20141203T213044Z: 00000000-1111-2222-1111-000000000000
Strict-Transport-Security : max-age=31536000; includeSubDomains
Cache-Control : no-cache
Date : Wed, 03 Dec 2014 21:30:44 GMT
Server : Microsoft-IIS/8.5
X-Powered-By : ASP.NET
Yanıt aşağıdaki XML gövdesini içerir.
{
"name": "gatewaytest",
"properties": {
"key": null,
"description": "test description.",
"hostServiceUri": null,
"dataFactoryName": "test",
"status": "NeedRegistration",
"versionStatus": "None",
"provisioningState": "Succeeded",
"version": null,
"createTime": "2015-12-18T07:04:13.00664Z",
"registerTime": null,
"lastConnectTime": null,
"expiryTime": null
}
}