Auftrag

Artikel
08/05/2023

Ein Auftrag ist eine Entität, die Metadaten zu einem Satz von Aufgaben enthält. Jede Ausgabe führt einen atomarischen Vorgang auf den Eingabemedienobjekten aus. Ein Auftrag wird normalerweise verwendet, um eine Audio-/Videodarstellung zu verarbeiten. Wenn Sie mehrere Videos verarbeiten, erstellen Sie einen Auftrag für jedes zu verschlüsselnde Video.

Dieser Artikel bietet eine Übersicht über die Job Entität und veranschaulicht außerdem, wie verschiedene Vorgänge mit der Media Services-REST-API ausgeführt werden.

Wichtig

Wenn Sie in Media Services auf Entitäten zugreifen, müssen Sie bestimmte Headerfelder und Werte in Ihren HTTP-Anforderungen festlegen.
Weitere Informationen finden Sie unter Einrichten der Media Services-REST-API-Entwicklung und Herstellen einer Verbindung mit Media Services mit der Media Services-REST-API.

Wenn Sie JSON verwenden und angeben, dass die __metadata Schlüsselwort (keyword) in der Anforderung verwendet werden soll (z. B. um auf ein verknüpftes Objekt zu verweisen), MÜSSEN Sie den Accept-Header auf das json-Format (Accept: application/json;odata=verbose) festlegen. OData versteht die __metadata-Eigenschaft in der Anforderung nur, wenn Sie das ausführliche Format verwenden.

Job-Entitätseigenschaften

Eigenschaft	type	BESCHREIBUNG
`Id` Schreibgeschützt. Von Media Services zum Erstellungszeitpunkt festgelegt.	Edm.String	Eindeutiger Bezeichner.
`Name` Optional.	Edm.String	Der Anzeigename für den Auftrag. Die Länge muss = 256 sein <.
`Created` Schreibgeschützt. Von Media Services zum Erstellungszeitpunkt festgelegt.	Edm.DateTime	Stellt die Anzahl der Millisekunden seit dem 1. Januar 1970 (0:00 Uhr) dar.
`LastModified` Schreibgeschützt. Wird von Media Services festgelegt.	Edm.DateTime	Dieser Wert wird von Media Services aktualisiert, nachdem Eigenschaftenänderungen vorgenommen wurden. Er stellt die Anzahl der Millisekunden seit dem 1. Januar 1970 (0:00 Uhr) dar.
`EndTime` Schreibgeschützt. Wird von Media Services festgelegt.	Edm.DateTime	Der Datetime-Zeitpunkt, an dem der Auftrag abgeschlossen, fehlgeschlagen oder abgebrochen wurde.
`Priority` Optional.	Edm.Int32	Die Priorität des Auftrags. Ein höherer Wert gibt eine höhere Priorität relativ zu den anderen geplanten Aufträgen an. Beispielsweise wird ein Auftrag mit Priorität = 40 vor einem Auftrag mit Priorität = 30 verarbeitet. Die Obergrenze ist gleich MaxInt. Die Standardeinstellung ist 0.
`RunningDuration` Schreibgeschützt. Wird von Media Services festgelegt.	Edm.Double	Die verstrichene Zeit (in Millisekunden) für den Auftrag
`StartTime` Schreibgeschützt. Wird von Media Services festgelegt.	Edm.DateTime	Das Datum und die Uhrzeit des Starts des Auftrags.
`State` Schreibgeschützt. Wird von Media Services festgelegt.	Edm.Int32	Der Status des Auftrags. Dies ist der Aggregatwert des Aufgabenstatus. Wenn bei einer Aufgabe ein Fehler auftritt, wir diese Eigenschaft auf Fehler (Failed) festgelegt. Gültige Werte sind: - Warteschlangen = 0 - Geplant = 1 - Verarbeitung = 2 - Abgeschlossen = 3 - Fehler = 4 - Abgebrochen = 5 - Abbrechen = 6
`TemplateId` Optional.	Edm.String	Die ID der JobTemplate-Entität.
`InputMediaAssets` Erforderlich.	Die Assets-Entitätssammlung.	Eine Navigationseigenschaft, die auf alle zugehörigen Asset-Entitäten verweist, die als Eingabemedienobjekte für den Auftrag fungieren.
`OutputMediaAssets` Schreibgeschützt. Wird von Media Services festgelegt.	Die Assets-Entitätssammlung.	Eine Navigationseigenschaft, die auf alle zugehörigen Asset-Entitäten verweist, die als Ausgabemedienobjekte für den Auftrag fungieren. Die Medienobjekte und ihre Blob-Speichercontainer werden bei der Austragserstellung erstellt. Ausgabemedienobjekte enthalten Dateien (Video, Audio, Miniaturansichten usw.) sowie die Metadaten zu den Eingabe- und Ausgabemedienobjekten. Weitere Informationen finden Sie in den Themen Ressourcen- und Ausgabemetadaten .
`Tasks` Optional.	Die Tasks-Entitätssammlung.	Eine Navigationseigenschaft, die auf alle zugehörigen Task-Entitäten verweist.
`JobNotificationSubscriptions` Optional. Kann nach der Erstellung der Entität nicht aktualisiert werden.	JobNotificationSubscription Diese Eigenschaft wurde in Media Services Version 2.1 hinzugefügt. Warnung: Azure-Warteschlangenbenachrichtigungen können eine gewisse Verzögerung aufweisen.	Eine Navigationseigenschaft, die auf Benachrichtigungsabonnements für den Auftrag verweist. Diese Eigenschaft kann nach der Erstellung des Auftrags nicht aktualisiert werden.

Erstellen eines Auftrags ohne Benachrichtigungsabonnements

Aufträge können mit einer HTTP POST-Anforderung erstellt werden.

Methode	Anforderungs-URI	HTTP-Version
POST	<https:// accountname.restv2>.<location.media.azure.net/api/Jobs>	HTTP/1.1

Der folgende Code zeigt, wie Sie eine Anforderung mit Media Services Version 2.0 erstellen. Denken Sie daran, dass Sie bei Verwendung von JSON und angeben, um die __metadata Schlüsselwort (keyword) in der Anforderung zu verwenden (z. B. um auf ein verknüpftes Objekt zu verweisen), den Accept-Header auf das JSON-Ausführlich-Format (Accept: application/json;odata=verbose) festlegen müssen. OData versteht die __metadata-Eigenschaft in der Anforderung nur, wenn Sie das ausführliche Format verwenden.

POST https://<accountname>.restv2.<location>.media.azure.net/api/Jobs HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 474  
Expect: 100-continue  
  
{"Name" : "NewTestJob", "InputMediaAssets" : [{"__metadata" : {"uri" : "https://&lt;accountname&gt;.restv2.&lt;location&gt;.media.azure.net/api/Assets('nb%3Acid%3AUUID%3Aba5356eb-30ff-4dc6-9e5a-41e4223540e7')"}}], "Tasks" : [{"Configuration" : "H.264 HD 720p VBR", "MediaProcessorId" : "nb:mpid:UUID:2f381738-c504-4e4a-a38e-d199e207fcd5", "TaskBody" : "<?xml version=\"1.0\" encoding=\"utf-8\"?><taskBody><inputAsset>JobInputAsset(0)</inputAsset><outputAsset>JobOutputAsset(0)</outputAsset></taskBody>"}]}

Erstellen eines Auftrags mit Benachrichtigungsabonnements

Aufträge mit Benachrichtigungen können mithilfe einer HTTP POST-Batchanforderung erstellt werden.

Methode	Anforderungs-URI	HTTP-Version
POST	<https:// accountname.restv2>.<location.media.azure.net/api/$batch>	HTTP/1.1

Der folgende Beispielcode erstellt einen Job für die Codierung mit Benachrichtigungsabonnements für den Auftrag. Die JobNotificationSubscriptions Eigenschaft wurde in Media Services Version 2.5 hinzugefügt. Denken Sie daran, dass Sie bei Verwendung von JSON und angeben, um die __metadata Schlüsselwort (keyword) in der Anforderung zu verwenden (z. B. um auf ein verknüpftes Objekt zu verweisen), den Accept-Header auf das JSON-Ausführlich-Format (Accept: application/json;odata=verbose) festlegen müssen. OData versteht die __metadata-Eigenschaft in der Anforderung nur, wenn Sie das ausführliche Format verwenden.

Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services REST.

POST https://<accountname>.restv2.<location>.media.azure.net/api/$batch HTTP/1.1  
User-Agent: Microsoft ADO.NET Data Services  
DataServiceVersion: 1.0  
MaxDataServiceVersion: 3.0  
Accept: multipart/mixed  
Accept-Charset: UTF-8  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
Content-Type: multipart/mixed; boundary=batch_c8ccf56a-87f6-4a61-bfa2-46aac3bb87d9  
Host: media.windows.net  
Content-Length: 3856  
  
--batch_c8ccf56a-87f6-4a61-bfa2-46aac3bb87d9  
Content-Type: multipart/mixed; boundary=changeset_0e31bdec-b799-400c-aa2f-d040aaa6ef2d  
  
--changeset_0e31bdec-b799-400c-aa2f-d040aaa6ef2d  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
POST https://<accountname>.restv2.<location>.media.azure.net/api/Jobs HTTP/1.1  
Content-ID: 1  
Content-Type: application/atom+xml  
DataServiceVersion: 3.0;NetFx  
MaxDataServiceVersion: 3.0;NetFx  
Accept: application/atom+xml,application/xml  
Accept-Charset: UTF-8  
  
<?xml version="1.0" encoding="utf-8"?><entry xmlns="http://www.w3.org/2005/Atom" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns:georss="http://www.georss.org/georss" xmlns:gml="http://www.opengis.net/gml"><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/InputMediaAssets" type="application/atom+xml;type=feed" title="InputMediaAssets" href="https://&lt;accountname&gt;.restv2.&lt;location&gt;.media.azure.net/api/Assets('nb%3Acid%3AUUID%3A33662ded-f00b-4020-9fcf-4c4a22070c01')" /><id /><title /><updated>2013-04-20T22:41:57Z</updated><author><name /></author><content type="application/xml"><m:properties><d:Created m:type="Edm.DateTime">0001-01-01T00:00:00</d:Created><d:EndTime m:null="true" /><d:Id m:null="true" /><d:JobNotificationSubscriptions><d:element><d:NotificationEndPointId>nb:nepid:UUID:36e510df-8560-4bae-a698-87723f677e98</d:NotificationEndPointId><d:TargetJobState m:type="Edm.Int32">2</d:TargetJobState></d:element></d:JobNotificationSubscriptions><d:LastModified m:type="Edm.DateTime">0001-01-01T00:00:00</d:LastModified><d:Name>My MP4 to Smooth Streaming encoding job</d:Name><d:Priority m:type="Edm.Int32">0</d:Priority><d:RunningDuration m:type="Edm.Double">0</d:RunningDuration><d:StartTime m:null="true" /><d:State m:type="Edm.Int32">0</d:State><d:TemplateId m:null="true" /></m:properties></content></entry>  
--changeset_0e31bdec-b799-400c-aa2f-d040aaa6ef2d  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
POST https://<accountname>.restv2.<location>.media.azure.net/api/$1/Tasks HTTP/1.1  
Content-ID: 2  
Content-Type: application/atom+xml  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
Accept: application/atom+xml,application/xml  
Accept-Charset: UTF-8  
  
<?xml version="1.0" encoding="utf-8"?><entry xmlns="http://www.w3.org/2005/Atom" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns:georss="http://www.georss.org/georss" xmlns:gml="http://www.opengis.net/gml"><id /><title /><updated>2013-04-20T22:41:57Z</updated><author><name /></author><content type="application/xml"><m:properties><d:Configuration>H264 Smooth Streaming 720p</d:Configuration><d:EncryptionKeyId m:null="true" /><d:EncryptionScheme m:null="true" /><d:EncryptionVersion m:null="true" /><d:EndTime m:null="true" /><d:ErrorDetails /><d:HistoricalEvents /><d:Id></d:Id><d:InitializationVector m:null="true" /><d:MediaProcessorId>nb:mpid:UUID:70bdc2c3-ebf4-42a9-8542-5afc1e55d217</d:MediaProcessorId><d:Name>My Mp4 to Smooth Task</d:Name><d:Options m:type="Edm.Int32">0</d:Options><d:PerfMessage m:null="true" /><d:Priority m:type="Edm.Int32">0</d:Priority><d:Progress m:type="Edm.Double">0</d:Progress><d:RunningDuration m:type="Edm.Double">0</d:RunningDuration><d:StartTime m:null="true" /><d:State m:type="Edm.Int32">0</d:State><d:TaskBody><?xml version="1.0" encoding="utf-16"?>  
<taskBody>  
  <inputAsset>JobInputAsset(0)</inputAsset>  
  <outputAsset assetCreationOptions="0" assetName="Output asset">JobOutputAsset(0)</outputAsset>  
</taskBody></d:TaskBody></m:properties></content></entry>  
--changeset_0e31bdec-b799-400c-aa2f-d040aaa6ef2d--  
--batch_c8ccf56a-87f6-4a61-bfa2-46aac3bb87d9--

Bei der Auftragserstellung mit Benachrichtigungen erfolgt die folgende Antwort:

HTTP/1.1 202 Accepted  
Cache-Control: no-cache  
Content-Length: 6056  
Content-Type: multipart/mixed; boundary=batchresponse_2ae0b2a5-ec8b-438b-ae62-a02bf2b4a502  
Server: Microsoft-IIS/7.5  
request-id: 9a3f6a5e-8363-42db-97bd-1f693b71f7f0  
x-ms-request-id: 9a3f6a5e-8363-42db-97bd-1f693b71f7f0  
X-Content-Type-Options: nosniff  
DataServiceVersion: 1.0;  
X-Powered-By: ASP.NET  
Date: Sat, 20 Apr 2013 22:42:02 GMT  
  
--batchresponse_2ae0b2a5-ec8b-438b-ae62-a02bf2b4a502  
Content-Type: multipart/mixed; boundary=changesetresponse_10441dcf-ec34-4b8a-919e-2368b2c6444e  
  
--changesetresponse_10441dcf-ec34-4b8a-919e-2368b2c6444e  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
HTTP/1.1 201 Created  
DataServiceVersion: 3.0;  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Content-ID: 1  
X-Content-Type-Options: nosniff  
Cache-Control: no-cache  
Location: https://&lt;accountname&gt;.restv2.&lt;location&gt;.media.azure.net/api/Jobs('nb%3Ajid%3AUUID%3A7dc2642f-ab1e-9f4c-8ecd-027eeac2a4ab')  
  
<?xml version="1.0" encoding="utf-8"?><entry xml:base="https://&lt;accountname&gt;.restv2.&lt;location&gt;.media.azure.net/api/" xmlns="http://www.w3.org/2005/Atom" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns:georss="http://www.georss.org/georss" xmlns:gml="http://www.opengis.net/gml"><id>https://&lt;accountname&gt;.restv2.&lt;location&gt;.media.azure.net/api/Jobs('nb%3Ajid%3AUUID%3A7dc2642f-ab1e-9f4c-8ecd-027eeac2a4ab')</id><category term="Microsoft.Cloud.Media.Vod.Rest.Data.Models.Job" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" /><link rel="edit" title="Job" href="Jobs('nb%3Ajid%3AUUID%3A7dc2642f-ab1e-9f4c-8ecd-027eeac2a4ab')" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/Tasks" type="application/atom+xml;type=feed" title="Tasks" href="Jobs('nb%3Ajid%3AUUID%3A7dc2642f-ab1e-9f4c-8ecd-027eeac2a4ab')/Tasks" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/OutputMediaAssets" type="application/atom+xml;type=feed" title="OutputMediaAssets" href="Jobs('nb%3Ajid%3AUUID%3A7dc2642f-ab1e-9f4c-8ecd-027eeac2a4ab')/OutputMediaAssets" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/InputMediaAssets" type="application/atom+xml;type=feed" title="InputMediaAssets" href="Jobs('nb%3Ajid%3AUUID%3A7dc2642f-ab1e-9f4c-8ecd-027eeac2a4ab')/InputMediaAssets" /><title /><updated>2013-04-20T22:42:02Z</updated><author><name /></author><content type="application/xml"><m:properties><d:Id>nb:jid:UUID:7dc2642f-ab1e-9f4c-8ecd-027eeac2a4ab</d:Id><d:Name>My MP4 to Smooth Streaming encoding job</d:Name><d:Created m:type="Edm.DateTime">0001-01-01T00:00:00</d:Created><d:LastModified m:type="Edm.DateTime">0001-01-01T00:00:00</d:LastModified><d:EndTime m:null="true" /><d:Priority m:type="Edm.Int32">0</d:Priority><d:RunningDuration m:type="Edm.Double">0</d:RunningDuration><d:StartTime m:null="true" /><d:State m:type="Edm.Int32">0</d:State><d:TemplateId m:null="true" /><d:JobNotificationSubscriptions m:type="Collection(Microsoft.Cloud.Media.Vod.Rest.Data.Models.JobNotificationSubscription)"><d:element><d:TargetJobState m:type="Edm.Int32">2</d:TargetJobState><d:NotificationEndPointId>nb:nepid:UUID:36e510df-8560-4bae-a698-87723f677e98</d:NotificationEndPointId></d:element></d:JobNotificationSubscriptions></m:properties></content></entry>  
--changesetresponse_10441dcf-ec34-4b8a-919e-2368b2c6444e  
Content-Type: application/http  
Content-Transfer-Encoding: binary  
  
HTTP/1.1 201 Created  
DataServiceVersion: 3.0;  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Content-ID: 2  
X-Content-Type-Options: nosniff  
Cache-Control: no-cache  
Location: https://&lt;accountname&gt;.restv2.&lt;location&gt;.media.azure.net/api/Tasks('nb%3Atid%3AUUID%3A94d3c509-24c2-467f-aa65-d16a4ea28b19')  
  
<?xml version="1.0" encoding="utf-8"?><entry xml:base="https://&lt;accountname&gt;.restv2.&lt;location&gt;.media.azure.net/api/" xmlns="http://www.w3.org/2005/Atom" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns:georss="http://www.georss.org/georss" xmlns:gml="http://www.opengis.net/gml"><id>https://&lt;accountname&gt;.restv2.&lt;location&gt;.media.azure.net/api/Tasks('nb%3Atid%3AUUID%3A94d3c509-24c2-467f-aa65-d16a4ea28b19')</id><category term="Microsoft.Cloud.Media.Vod.Rest.Data.Models.Task" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" /><link rel="edit" title="Task" href="Tasks('nb%3Atid%3AUUID%3A94d3c509-24c2-467f-aa65-d16a4ea28b19')" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/OutputMediaAssets" type="application/atom+xml;type=feed" title="OutputMediaAssets" href="Tasks('nb%3Atid%3AUUID%3A94d3c509-24c2-467f-aa65-d16a4ea28b19')/OutputMediaAssets" /><link rel="http://schemas.microsoft.com/ado/2007/08/dataservices/related/InputMediaAssets" type="application/atom+xml;type=feed" title="InputMediaAssets" href="Tasks('nb%3Atid%3AUUID%3A94d3c509-24c2-467f-aa65-d16a4ea28b19')/InputMediaAssets" /><title /><updated>2013-04-20T22:42:02Z</updated><author><name /></author><content type="application/xml"><m:properties><d:Id>nb:tid:UUID:94d3c509-24c2-467f-aa65-d16a4ea28b19</d:Id><d:Configuration>H264 Smooth Streaming 720p</d:Configuration><d:EndTime m:null="true" /><d:ErrorDetails m:type="Collection(Microsoft.Cloud.Media.Vod.Rest.Data.Models.ErrorDetail)" /><d:HistoricalEvents m:type="Collection(Microsoft.Cloud.Media.Vod.Rest.Data.Models.TaskHistoricalEvent)" /><d:MediaProcessorId>nb:mpid:UUID:70bdc2c3-ebf4-42a9-8542-5afc1e55d217</d:MediaProcessorId><d:Name>My Mp4 to Smooth Task</d:Name><d:PerfMessage m:null="true" /><d:Priority m:type="Edm.Int32">0</d:Priority><d:Progress m:type="Edm.Double">0</d:Progress><d:RunningDuration m:type="Edm.Double">0</d:RunningDuration><d:StartTime m:null="true" /><d:State m:type="Edm.Int32">0</d:State><d:TaskBody><?xml version="1.0" encoding="utf-16"?>  
<taskBody>  
  <inputAsset>JobInputAsset(0)</inputAsset>  
  <outputAsset assetCreationOptions="0" assetName="Output asset">JobOutputAsset(0)</outputAsset>  
</taskBody></d:TaskBody><d:Options m:type="Edm.Int32">0</d:Options><d:EncryptionKeyId m:null="true" /><d:EncryptionScheme m:null="true" /><d:EncryptionVersion m:null="true" /><d:InitializationVector m:null="true" /></m:properties></content></entry>  
--changesetresponse_10441dcf-ec34-4b8a-919e-2368b2c6444e--  
--batchresponse_2ae0b2a5-ec8b-438b-ae62-a02bf2b4a502--

Der Vorgang Nachrichten abrufen für die Warteschlange mit der zuvor angegebenen Endpunktadresse generiert die folgenden Benachrichtigungen:

{  
"MessageVersion":"1.0",  
"EventType":"NotificationEndPointRegistration",  
"ETag":"d7a67e6e19acdb35c3de63e5d5a655b0a06cefb18192b4a6d6dc551298a2c01f",  
"TimeStamp":"2013-04-22T19:33:32",  
"Properties":  
    {  
    "NotificationEndPointId":"nb:nepid:UUID:36e510df-8560-4bae-a698-87723f677e98",  
    "State":"Registered",  
    "Name":"c9251969-d74e-40b3-927f-62de9c0cc3d1",  
    "Created":"2013-04-22T19:33:31"  
    }  
}  
  
{  
"MessageVersion":"1.0",  
"EventType":"JobStateChange",  
"ETag":"4bc48c4bf9ae7f50e4dfdc5cda32a032e30c9ba94f9cd45d859c64e28e7e9937",  
"TimeStamp":"2013-04-22T19:34:12",  
"Properties":  
    {  
    "JobId":"nb:jid:UUID:3A7dc2642f-ab1e-9f4c-8ecd-027eeac2a4ab",  
    "JobName":"My MP4 to Smooth Streaming encoding job",  
    "NewState":"Scheduled",  
    "OldState":"Queued",  
    "AccountName":"account001"  
    }  
}  
  
{  
"MessageVersion":"1.0",  
"EventType":"JobStateChange",  
"ETag":"4f5ca985235ed262df7b995a278de24fea4bae1a630d5106dd215853a42cf2ca",  
"TimeStamp":"2013-04-22T19:34:13",  
"Properties":  
    {  
    "JobId":"nb:jid:UUID:3A7dc2642f-ab1e-9f4c-8ecd-027eeac2a4ab",  
    "JobName":"My MP4 to Smooth Streaming encoding job",  
    "NewState":"Processing",  
    "OldState":"Scheduled",  
    "AccountName":"account001"  
    }  
}  
  
{  
"MessageVersion":"1.0",  
"EventType":"JobStateChange",  
"ETag":"25af87b23c92a52d140fcf0915b3b1868f3bd9822347de9287688a9cff653623",  
"TimeStamp":"2013-04-22T19:35:28",  
"Properties":  
    {  
    "JobId":"nb:jid:UUID:3A7dc2642f-ab1e-9f4c-8ecd-027eeac2a4ab",  
    "JobName":"My MP4 to Smooth Streaming encoding job",  
    "NewState":"Finished",  
    "OldState":"Processing",  
    "AccountName":"account001"  
    }  
}

Die Benachrichtigung EventType kann die folgenden Werte aufweisen: None = 0, JobStateChange = 1, NotificationEndPointRegistration = 2 und NotificationEndPointUnregistration = 3.

Das JobStateChange Ereignis kann die folgenden Auftragszustände aufweisen: Queued = 0, Scheduled = 1, Processing = 2, Finished = 3, Error = 4, Canceled = 5 und Canceling = 6.

List Jobs

Aufträge können mithilfe einer HTTP GET-Anforderung abgerufen werden.

Wichtig

Wenn Sie eine Anforderung zum Auflisten von Auftragsentitäten stellen, werden pro Anforderung maximal 1000 zurückgegeben. Falls Sie alle gesendeten Aufträge nachverfolgen müssen, können Sie "Nach oben"/"Überspringen" wie in OData-Systemabfrageoptionenbeschrieben verwenden.

Methode	Anforderungs-URI	HTTP-Version
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Jobs>	HTTP/1.1

Methode	Anforderungs-URI	HTTP-Version
GET	<https:// accountname.restv2>.<location.media.azure.net/api/Jobs>('jobid')	HTTP/1.1

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services REST.

GET https://<accountname>.restv2.<location>.media.azure.net/api/Jobs('nb:jid:UUID:b1f956b3-774c-bb44-a3f7-ee47e23add31') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Host: media.windows.net

Abbrechen eines Auftrags

Aktuell ausgeführte Aufträge können mithilfe der Funktion CancelJob abgebrochen werden. Ein Beispiel finden Sie unter REST-API-Funktionen.

Löschen eines Auftrags

Aufträge können mithilfe einer HTTP DELETE-Anforderung gelöscht werden. Dies ist sinnvoll, um alte, abgeschlossene Aufträge aus der Azure Media Service-Kontodatenbank zu bereinigen.

Methode	Anforderungs-URI	HTTP-Version
Delete	<https:// accountname.restv2>.<location.media.azure.net/api/Jobs>('jobid')	HTTP/1.1

Beispiel für eine Anforderung

Informationen zum Aktuellen x-ms-version:finden Sie unter Media Services REST.

DELETE https://<accountname>.restv2.<location>.media.azure.net/api/Jobs('nb:jid:UUID:9f5b35d0-68ac-c249-8ece-ece9ea22a461') HTTP/1.1  
Content-Type: application/json;odata=verbose  
Accept: application/json;odata=verbose  
DataServiceVersion: 3.0  
MaxDataServiceVersion: 3.0  
x-ms-version: 2.19  
Authorization: Bearer <token value>  
Host: media.windows.net  
Content-Length: 0

Weitere Informationen

ContentKey
Asset
AccessPolicy
AssetFile
JobTemplate
Locator
MediaProcessor
Aufgabe
TaskTemplate
Kontingente und Einschränkungen

Freigeben über

Auftrag

Job-Entitätseigenschaften

Erstellen eines Auftrags ohne Benachrichtigungsabonnements

Erstellen eines Auftrags mit Benachrichtigungsabonnements

List Jobs

Beispiel für eine Anforderung

Abbrechen eines Auftrags

Löschen eines Auftrags

Beispiel für eine Anforderung

Weitere Informationen

Zusätzliche Ressourcen