Jobs - ImportJobs List

Service:

Azure Digital Twins

API Version:

2023-10-31

Tüm içeri aktarma işlerini alır. Durum kodları:

• 200 Tamam

GET https://digitaltwins-hostname/jobs/imports?api-version=2023-10-31

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
api-version	query	True	string	İstenen API sürümü.

İstek Başlığı

Name	Gerekli	Tür	Description
max-items-per-page		integer	İstek başına alınacak en fazla öğe sayısı. Sunucu, istenen sayıdan daha azını döndürmeyi seçebilir.
traceparent		string	Dağıtılmış izleme sistemindeki isteği tanımlar.
tracestate		string	Satıcıya özgü izleme tanımlama bilgilerini sağlar ve izlemeparent için yardımcıdır.

Yanıtlar

Name	Tür	Description
200 OK	ImportJobCollection	Başarılı
Other Status Codes	ErrorResponse	Varsayılan yanıt. Headers x-ms-error-code: string

Güvenlik

oauth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize?resource=0b07f429-9f4b-4714-9392-cc5e8e80c8b0

Örnekler

Get all import jobs

Sample Request

HTTP

GET https://digitaltwins-hostname/jobs/imports?api-version=2023-10-31

Sample Response

Status code:

200

{
  "value": [
    {
      "id": "importjob1",
      "inputBlobUri": "path to input blob",
      "outputBlobUri": "path to output blob",
      "createdDateTime": "2022-01-01T00:00:00.0000000+00:00",
      "lastActionDateTime": "2022-01-01T00:01:00.0000000+00:00",
      "finishedDateTime": "2022-01-01T00:01:00.0000000+00:00",
      "purgeDateTime": "2022-01-31T00:01:00.0000000+00:00",
      "status": "succeeded"
    },
    {
      "id": "importjob2",
      "inputBlobUri": "path to input blob",
      "outputBlobUri": "path to output blob",
      "createdDateTime": "2022-01-01T00:00:00.0000000+00:00",
      "lastActionDateTime": "2022-01-01T00:01:00.0000000+00:00",
      "finishedDateTime": "2022-01-01T00:01:00.0000000+00:00",
      "purgeDateTime": "2022-01-31T00:01:00.0000000+00:00",
      "status": "succeeded"
    }
  ],
  "nextLink": "url-to-next-page"
}

Tanımlar

Name	Description
Error	Hata tanımı.
ErrorResponse	Hata yanıtı.
ImportJob	Gerçekleştirilecek işlemlere, sonuçlara ve yürütme meta verilerine başvuru içeren bir iş.
ImportJobCollection	İçeri aktarma işi nesneleri koleksiyonu.
InnerError	İçeren hata tarafından sağlanandan daha belirgin bir hata açıklaması.
status	İşin durumu.

Error

Hata tanımı.

Name	Tür	Description
code	string	HTTP hata kodu için alt durum olarak hizmet veren hizmete özgü hata kodu.
details	Error[]	İç hata ayrıntıları.
innererror	InnerError	Hatayla ilgili geçerli nesneden daha özel bilgiler içeren bir nesne.
message	string	Hatanın insan tarafından okunabilen bir gösterimi.

ErrorResponse

Hata yanıtı.

Name	Tür	Description
error	Error	Hata ayrıntıları.

ImportJob

Gerçekleştirilecek işlemlere, sonuçlara ve yürütme meta verilerine başvuru içeren bir iş.

Name	Tür	Description
createdDateTime	string	İşin başlangıç saati. Zaman damgası RFC3339 biçimindedir: yyyy-MM-ddTHH:mm:ssZ.
error	Error	İçeri aktarma işi yürütülürken oluşan hataların ayrıntıları.
finishedDateTime	string	İşin bitiş saati. Zaman damgası RFC3339 biçimindedir: yyyy-MM-ddTHH:mm:ssZ.
id	string	İçeri aktarma işinin tanımlayıcısı.
inputBlobUri	string	İşte gerçekleştirilecek işlemleri açıklayan dosyaları içeren giriş Azure depolama blobunun yolu.
lastActionDateTime	string	Hizmetin işten herhangi bir eylem gerçekleştirdiği son zaman. Zaman damgası RFC3339 biçimindedir: yyyy-MM-ddTHH:mm:ssZ.
outputBlobUri	string	İçeri aktarma işinin hatalarını ve ilerleme günlüklerini içeren çıkış Azure depolama blobunun yolu.
purgeDateTime	string	İşin hizmet tarafından sistemden temizlenme zamanı. Zaman damgası RFC3339 biçimindedir: yyyy-MM-ddTHH:mm:ssZ.
status	status	İşin durumu.

ImportJobCollection

İçeri aktarma işi nesneleri koleksiyonu.

Name	Tür	Description
nextLink	string	Sonuçların sonraki sayfasını almak için bir URI.
value	ImportJob[]	İçeri aktarma işi nesnelerinin listesi.

InnerError

İçeren hata tarafından sağlanandan daha belirgin bir hata açıklaması.

Name	Tür	Description
code	string	İçeren hata tarafından sağlanandan daha özel bir hata kodu.
innererror	InnerError	Hatayla ilgili geçerli nesneden daha özel bilgiler içeren bir nesne.

status

İşin durumu.

Name	Tür	Description
cancelled	string
cancelling	string
failed	string
notstarted	string
running	string
succeeded	string