Delen via


Jobs - ImportJobs List

Hiermee worden alle importtaken opgehaald. Statuscodes:

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

URI-parameters

Name In Vereist Type Description
api-version
query True

string

De aangevraagde API-versie.

Aanvraagkoptekst

Name Vereist Type Description
max-items-per-page

integer

Het maximum aantal items dat per aanvraag moet worden opgehaald. De server kan ervoor kiezen om minder dan het aangevraagde nummer te retourneren.

traceparent

string

Identificeert de aanvraag in een gedistribueerd traceringssysteem.

tracestate

string

Biedt leverancierspecifieke traceringsidentificatie-informatie en is een aanvulling op traceerouder.

Antwoorden

Name Type Description
200 OK

ImportJobCollection

Geslaagd

Other Status Codes

ErrorResponse

Standaardantwoord.

Headers

x-ms-error-code: string

Beveiliging

oauth2

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

Voorbeelden

Get all import jobs

Sample Request

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

Sample Response

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

Definities

Name Description
Error

Foutdefinitie.

ErrorResponse

Foutreactie.

ImportJob

Een taak die een verwijzing bevat naar de bewerkingen die moeten worden uitgevoerd, resultaten en metagegevens van de uitvoering.

ImportJobCollection

Een verzameling importtaakobjecten.

InnerError

Een specifiekere foutbeschrijving dan is opgegeven door de betreffende fout.

status

Status van de taak.

Error

Foutdefinitie.

Name Type Description
code

string

Servicespecifieke foutcode die fungeert als de substatus voor de HTTP-foutcode.

details

Error[]

Details van interne fouten.

innererror

InnerError

Een object met specifiekere informatie dan het huidige object over de fout.

message

string

Een door mensen leesbare weergave van de fout.

ErrorResponse

Foutreactie.

Name Type Description
error

Error

De foutdetails.

ImportJob

Een taak die een verwijzing bevat naar de bewerkingen die moeten worden uitgevoerd, resultaten en metagegevens van de uitvoering.

Name Type Description
createdDateTime

string

Begintijd van de taak. De tijdstempel is in RFC3339-indeling: yyyy-MM-ddTHH:mm:ssZ.

error

Error

Details van de fout(en) die zijn opgetreden bij het uitvoeren van de importtaak.

finishedDateTime

string

Eindtijd van de taak. De tijdstempel is in RFC3339-indeling: yyyy-MM-ddTHH:mm:ssZ.

id

string

De id van de importtaak.

inputBlobUri

string

Het pad naar de azure-opslagblob die een of meer bestanden bevat waarin de bewerkingen worden beschreven die in de taak moeten worden uitgevoerd.

lastActionDateTime

string

De laatste keer dat de service een actie heeft uitgevoerd vanuit de taak. De tijdstempel is in RFC3339-indeling: yyyy-MM-ddTHH:mm:ssZ.

outputBlobUri

string

Het pad naar de uitvoer-Azure Storage-blob die de fouten en voortgangslogboeken van de importtaak bevat.

purgeDateTime

string

Het tijdstip waarop de taak door de service uit het systeem wordt verwijderd. De tijdstempel is in RFC3339-indeling: yyyy-MM-ddTHH:mm:ssZ.

status

status

Status van de taak.

ImportJobCollection

Een verzameling importtaakobjecten.

Name Type Description
nextLink

string

Een URI om de volgende pagina met resultaten op te halen.

value

ImportJob[]

De lijst met importtaakobjecten.

InnerError

Een specifiekere foutbeschrijving dan is opgegeven door de betreffende fout.

Name Type Description
code

string

Een specifiekere foutcode dan is opgegeven door de betreffende fout.

innererror

InnerError

Een object met specifiekere informatie dan het huidige object over de fout.

status

Status van de taak.

Name Type Description
cancelled

string

cancelling

string

failed

string

notstarted

string

running

string

succeeded

string