Aracılığıyla paylaş

Hub sürüm 1 (V1)

  • Makale

Not

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

Oluşturma veya Güncelleştirme

Yeni bir hub oluşturur veya mevcut bir hub'ın içeriğini güncelleştirir.

İstek

Oluşturma veya Güncelleştirme Hub'ı 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}/hubs/{HubName}?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.
DataFactoryName Yes Hub'ınızı oluşturmak istediğiniz veri fabrikasının adı.
HubName Yes Oluşturmak istediğiniz hub'ı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övdesi hub'ınızın türüne bağlıdır. İstek gövdesinin biçimi aşağıdaki gibidir:

  
{  
    "name": <hubname>,  
    "properties": {  
        "defaultCompute": <computemethod>,  
        "type": <hubtype>  
    }  
}

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

Öğe Adı Gerekli Açıklama
name Yes Hub'ın adı.
properties Yes Hub'ın özelliği.

Yanıt

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

Durum Kodları

  • 200 (Tamam) – İstek başarıyla tamamlandı.

  • 202 (Kabul Edildi) - İstek kabul edildi.

  • 400 (Hatalı İstek) - İstek gövdesi doğrulanamadı.

  • 404 (NotFound) - Abonelik veya kaynak grubu veya veri fabrikası yok.

  • 412 (Önkoşul Başarısız Oldu) - If-Match üst bilgisi tarafından belirtilen koşul başarısız oldu.

  • 501 (Uygulanmadı) - Doğrulama uygulanmadı

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.
Konum Oluşturmak veya almak istediğiniz nesnenin URI'sini seçin.

Yanıt Gövdesi

  
{  
    "name": <name>,  
    "properties":   
    {  
        "defaultCompute": <computemethod>,  
        "type": <hubtype>,  
        "hubId": <hubID>,  
        "provisioningState": <provisioningstate>  
    }  
}

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

Öğe Adı Açıklama
name Hub'ın adı
ComputeMethod Bu hub'ın işlem yöntemi.
tür Hub türü
hubID Bu hub için otomatik oluşturulan kimlik.
ProvisioningState Hub'ın geçerli sağlama durumunu belirtir. Hub başarıyla oluşturulduğunda öğesinin değeri Başarılı olur

Ö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/hubs/hubtest?api-version=2015-10-01

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

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

ve aşağıdaki gövde:

  
{  
    "name": "Hubtest",  
    "properties":   
    {  
        "defaultCompute": "SampleDefaultCompute",  
        "type": "Hub"  
    }  
}

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

Üstbilgi:

  
Status Code:  
Created  
  
Headers:  
Pragma                        : no-cache  
x-ms-request-id               : 00000000-1111-1111-1111-000000000000  
x-ms-ratelimit-remaining-subscription-writes: 11996  
x-ms-correlation-request-id   : 00000000-1111-2222-1111-000000000000  
x-ms-routing-request-id       : WESTUS:20141203T214448Z: 00000000-1111-2222-1111-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Wed, 03 Dec 2014 21:44:48 GMT  
Location                      : https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/adf/providers/Microsoft.DataFactory/datafactories/test/hubs/hubtest?api-version=2015-10-01  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET

Vücut:

  
{  
    "name": "Hubtest",  
    "properties":   
    {  
        "defaultCompute": "SampleDefaultCompute",  
        "type": "Hub",  
        "hubId": "c4753e2a-4297-49ab-8269-ca4378ae4e37",  
        "provisioningState": "Succeeded"  
    }  
}

Sil

Belirli bir hub'ı siler.

İstek

Delete Hub 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}/hubs/{HubName}?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 Hub'ınızı silmek istediğiniz veri fabrikasının adı.
HubName Yes Silmek istediğiniz hub'ın adı.
Api-Version Yes C# SDK'nızın/PowerShell'inizin API sürümü

İ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

  • İstek başarıyla tamamlandıysa 200 (Tamam).

  • İstek gövdesi doğrulamada başarısız olursa 400 (Hatalı İstek).

  • Abonelik veya kaynak grubu yoksa 404 (NotFound).

  • If-Match üst bilgisi tarafından belirtilen başarısız koşul durumunda 412 (Önkoşul Başarısız Oldu).

  • Doğrulama uygulanmazsa 501 (Uygulanmadı)

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/hubs/hubtest?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: 799992  
x-ms-correlation-request-id   : 00000000-1111-2222-1111-000000000000  
x-ms-routing-request-id       : WESTUS:20141203T214448Z: 00000000-1111-2222-1111-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Wed, 03 Dec 2014 21:44:48 GMT  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET  
client-tracking-id            : 66

Al

Mevcut bir hub hakkında bilgi alır.

İstek

Get Hub 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}/hubs/{HubName}?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 Hub'ınızı almak istediğiniz veri fabrikasının adı.
HubName Yes Almak istediğiniz hub'ı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) - belirtilen 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.

  • 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

Yanıt gövdesi, hub türünüze bağlıdır.

  
{  
    "name": <name>,  
    "properties": {  
        "defaultCompute": <computemethod>,  
        "type": <hubtype>,  
        "hubId": <hubID>,  
        "provisioningState": <provisioningstate>  
    }  
}

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

Öğe Adı Açıklama
name Hub'ın adı.
computemethod Bu hub'ın işlem yöntemi.
tür Hub'ın türü.
hubID Bu hub için otomatik oluşturulan kimlik.
ProvisioningState Hub'ın geçerli sağlama durumunu belirtir. Hub başarıyla oluşturulduğunda öğesinin değeri Başarılı olur.

Ö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/hubs/hubtest?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: 799992  
x-ms-correlation-request-id   : 00000000-1111-2222-1111-000000000000  
x-ms-routing-request-id       : WESTUS:20141203T214448Z: 00000000-1111-2222-1111-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Wed, 03 Dec 2014 21:44:48 GMT  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET  
The response includes the following XML body.  
{  
    "name": "Hubtest",  
    "properties": {  
        "type": "Hub",  
        "hubId": "c4753e2a-4297-49ab-8269-ca4378ae4e37",  
        "provisioningState": "Succeeded"  
    }  
}

Liste

Veri fabrikasındaki tüm hub'lar hakkındaki bilgileri listeler.

İstek

List Hubs 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}/hubs?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 Hub'ınızı bulmak 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
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>,  
        "properties": {  
              "type": <hubtype>,  
              "hubId": <hubID>,  
              "provisioningState": <provisioningstate>  
        }  
    },  
    {  
        "name": <name2>,  
        "properties": {  
            "defaultCompute": <computemethod>,  
            "type": <hubtype>,  
            "hubId": <hubID>,  
           "provisioningState": <provisioningstate>  
        }  
    }  
    ]  
}

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

Öğe Adı Açıklama
name Hub'ın adı.
computemethod Bu hub'ın işlem yöntemi.
tür Hub'ın türü
hubID Bu hub için otomatik oluşturulan kimlik
ProvisioningState Hub'ın geçerli sağlama durumunu belirtir. Hub başarıyla oluşturulduğunda öğesinin değeri Başarılı olur

Ö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/hubs?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: 799992  
x-ms-correlation-request-id   : 00000000-1111-2222-1111-000000000000  
x-ms-routing-request-id       : WESTUS:20141203T214448Z: 00000000-1111-2222-1111-000000000000  
Strict-Transport-Security     : max-age=31536000; includeSubDomains  
Cache-Control                 : no-cache  
Date                          : Wed, 03 Dec 2014 21:44:48 GMT  
Server                        : Microsoft-IIS/8.5  
X-Powered-By                  : ASP.NET  
The response includes the following XML body.  
{  
    "value": [  
        {  
            "name": "hubtest",  
            "properties": {  
                "type": "InternalHub",  
                "hubId": "39d4e663-cfcb-4ee9-ad19-92cf87de9197",  
                "provisioningState": "Succeeded"  
            }  
        },  
        {  
            "name": "hubtest2",  
            "properties": {  
                "defaultCompute": "SampleDefaultCompute",  
                "type": "Hub",  
                "hubId": "c4753e2a-4297-49ab-8269-ca4378ae4e37",  
                "provisioningState": "Succeeded"  
            }  
        }  
    ]  
}