Bewerking

Artikel
08/05/2023

Vertegenwoordigt de huidige status van een langlopende bewerking. Voorbeelden van langlopende bewerkingen zijn het starten, stoppen en verwijderen van een Origin.

Dit onderwerp geeft een overzicht van de Operation entiteit en laat ook zien hoe u verschillende bewerkingen uitvoert met de Media Services REST API.

Eigenschappen van bewerkingsentiteit
Querybewerkingen
Foutcodes voor bewerkingen

Belangrijk

Bij het openen van entiteiten in Media Services moet u specifieke headervelden en -waarden instellen in uw HTTP-aanvragen.
Zie Setup for Media Services REST API Development and Connecting to Media Services with the Media Services REST API (Verbinding maken met Media Services met de Media Services REST API) voor meer informatie.

Eigenschappen van bewerkingsentiteit

`Property`	Type	Beschrijving
`Id` Alleen-lezen.	Tekenreeks	De bewerkings-id, toegewezen door Media Services bij het maken van een bewerking. De indeling is: `nb:opid:UUID:<GUID>`.
`ErrorCode` Alleen-lezen.	Tekenreeks	De foutcode van de mislukte bewerking. Zie Foutcodes voor bewerkingen voor informatie over mogelijke foutcodes.
`ErrorMessage` Alleen-lezen.	Tekenreeks	Het gedetailleerde foutbericht van de mislukte bewerking.
`State` Alleen-lezen.	Tekenreeks	De huidige status. Mogelijke waarden zijn: - Geslaagd - Mislukt - Wordt uitgevoerd
`TargetEntityId` Alleen-lezen.	Tekenreeks	De id van het doel van de actie.

Querybewerkingen

Hiermee voert u een query uit op de opgegeven bewerking.

Methode	Aanvraag-URI	HTTP-versie
GET	<https:// accountnaam.restv2>.<location.media.azure.net/api/Operations>('OperationId')	HTTP/1.1

Voorbeeldaanvraag

Zie Media Services REST voor de meest recente x-ms-version:versie.

GET api/Operations('nb:opid:UUID:ab66eff9-8945-4323-9f91-d257a695899b') HTTP/1.1  
MaxDataServiceVersion: 3.0;NetFx  
Content-Type: application/json;odata=minimalmetadata  
Accept: application/json;odata=minimalmetadata  
Authorization: Bearer <token value>  
x-ms-version: 2.19  
Host: <host URI>  
Content-Length: 0

Als dit lukt, wordt een 200 OK-statuscode geretourneerd, samen met een statusbericht in de hoofdtekst van het antwoord, zoals wordt weergegeven in het volgende voorbeeld.

Voorbeeldreactie

HTTP/1.1 200 OK  
Cache-Control: no-cache  
Content-Length: 280  
Content-Type: application/json;odata=minimalmetadata;streaming=true;charset=utf-8  
Server: Microsoft-IIS/7.5  
request-id: c3f3501a-8563-4cff-8aeb-66f68f9bdb8b  
x-ms-request-id: c3f3501a-8563-4cff-8aeb-66f68f9bdb8b  
X-Content-Type-Options: nosniff  
DataServiceVersion: 3.0;  
X-Powered-By: ASP.NET  
Date: Wed, 15 Jan 2014 19:31:13 GMT  
  
{"odata.metadata":"https://wamsbayclus001rest-hs.cloudapp.net/api/$metadata#Operations/@Element","Id":"nb:opid:UUID:ab66eff9-8945-4323-9f91-d257a695899b","State":"Succeeded","TargetEntityId":"nb:chid:UUID:1e518dbc-91ef-4044-a8bd-d20769dae833","ErrorCode":null,"ErrorMessage":null}

Foutcodes voor bewerkingen

Foutcodes voor bewerkingen worden hier vermeld.

Foutcode	Description
BadRequest	Wordt verzonden wanneer er geen andere fout van toepassing is of als de exacte fout onbekend is.
InsufficientCapacity	Het datacenter heeft onvoldoende capaciteit.
InternalError	Er zijn onverwachte fouten opgetreden in de service.
InvalidIdentifierFormat	De indeling van de entiteits-id is ongeldig.
InvalidOperation	De aanvraag is ongeldig in de huidige status van de entiteit.
InvalidResourceName	De opgegeven origin-naam is ongeldig.
OperationInProgress	Er wordt al een andere bewerking uitgevoerd op de opgegeven entiteit.
OperationNotFound	De bewerkingsrecord is niet gevonden voor de opgegeven bewerkings-id. De bewerking is mogelijk na een bepaalde periode verwijderd of de id is onjuist.
ResourceNameTaken	Er wordt geprobeerd een nieuwe origin te maken met een naam die al in gebruik is.
ResourceNotFound	De opgegeven resource is niet gevonden.
ExceededResourceQuota	De aanvraag overschrijdt de quotumlimiet voor resources.
Time-out	Er is een time-out opgetreden voor de asynchrone bewerking.
DeleteNotAllowedOnDefaultOrigin	U hebt geprobeerd de standaard origin te verwijderen.
SettingsUpdateInProgress	Er wordt al een update uitgevoerd.

Delen via