CreateTask - AWS Snowball
AnforderungssyntaxURI-AnfrageparameterAnforderungstextAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

CreateTask

Weist ein oder mehrere Geräte an, eine Aufgabe zu starten, z. B. das Entsperren oder Neustart.

Anforderungssyntax

POST /task HTTP/1.1
Content-type: application/json

{
   "clientToken": "string",
   "command": { 
      "reboot": { 
      },
      "unlock": { 
      }
   },
   "description": "string",
   "tags": { 
      "string" : "string" 
   },
   "targets": [ "string" ]
}

URI-Anfrageparameter

Die Anforderung verwendet keine URI-Parameter.

Anforderungstext

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

clientToken

Ein Token, das sicherstellt, dass die Aktion nur einmal mit den angegebenen Details aufgerufen wird.

Type: String (Zeichenfolge)

Einschränkungen: Mindestlänge 1. Höchstlänge = 64 Zeichen.

Pattern: [!-~]+

: Erforderlich Nein

command

Die auszuführende Aufgabe. Auf einem Gerät wird immer nur eine Aufgabe ausgeführt.

Typ: Command Objekt

: Erforderlich Ja

description

Eine Beschreibung der Aufgabe und ihrer Ziele.

Type: String (Zeichenfolge)

Einschränkungen: Mindestlänge 1. Maximale Länge beträgt 128 Zeichen.

Pattern: [A-Za-z0-9 _.,!#]*

: Erforderlich Nein

tags

Optionale Metadaten, die Sie einer Ressource zuweisen. Mithilfe von Tags können Sie eine Ressource unterschiedlich kategorisieren, beispielsweise nach Zweck, Besitzer oder Umgebung.

Type: Zeichenfolge-zu-Zeichenfolge-Zuweisung

: Erforderlich Nein

targets

Eine Liste verwalteter Geräte-IDs.

Type: Zeichenfolgen-Array

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 10 Elemente.

: Erforderlich Ja

Antwortsyntax

HTTP/1.1 200
Content-type: application/json

{
   "taskArn": "string",
   "taskId": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

taskArn

Der Amazon-Ressourcenname (ARN) der von Ihnen erstellten Aufgabe.

Type: String (Zeichenfolge)

taskId

Die ID der von Ihnen erstellten Aufgabe

Type: String (Zeichenfolge)

Fehler

Informationen zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehleraus.

AccessDeniedException

Sie haben keinen ausreichenden Zugriff zum Durchführen dieser Aktion.

HTTP-Statuscode: 403

InternalServerException

Bei der Verarbeitung der Anforderung ist ein unerwarteter Fehler aufgetreten.

HTTP-Statuscode: 500

ResourceNotFoundException

Die Anforderung verweist eine Ressource, die nicht vorhanden ist.

HTTP-Statuscode: 404

ServiceQuotaExceededException

Die Anfrage würde dazu führen, dass ein Service-Kontingent überschritten wird.

HTTP-Statuscode: 402

ThrottlingException

Die Anforderung wurde aufgrund der Drosselung von Anforderungen abgelehnt.

HTTP-Statuscode: 429

ValidationException

Die Eingabe erfüllt nicht die von einemAWSService-Service.

HTTP-Statuscode: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: