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
<a name="API_devicemanagement_CreateTask"></a>

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

## Anforderungssyntax
<a name="API_devicemanagement_CreateTask_RequestSyntax"></a>

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

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

## URI-Anfrageparameter
<a name="API_devicemanagement_CreateTask_RequestParameters"></a>

Die Anforderung verwendet keine URI-Parameter.

## Anforderungstext
<a name="API_devicemanagement_CreateTask_RequestBody"></a>

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [clientToken](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-clientToken"></a>
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](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-command"></a>
Die auszuführende Aufgabe. Auf einem Gerät wird immer nur eine Aufgabe ausgeführt.  
Typ: [Command](API_devicemanagement_Command.md) Objekt  
: Erforderlich Ja

 ** [description](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-description"></a>
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](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-tags"></a>
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](#API_devicemanagement_CreateTask_RequestSyntax) **   <a name="Snowball-devicemanagement_CreateTask-request-targets"></a>
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
<a name="API_devicemanagement_CreateTask_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

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

## Antwortelemente
<a name="API_devicemanagement_CreateTask_ResponseElements"></a>

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](#API_devicemanagement_CreateTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_CreateTask-response-taskArn"></a>
Der Amazon-Ressourcenname (ARN) der von Ihnen erstellten Aufgabe.  
Type: String (Zeichenfolge)

 ** [taskId](#API_devicemanagement_CreateTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_CreateTask-response-taskId"></a>
Die ID der von Ihnen erstellten Aufgabe  
Type: String (Zeichenfolge)

## Fehler
<a name="API_devicemanagement_CreateTask_Errors"></a>

Informationen zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unter[Häufige Fehler](CommonErrors.md)aus.

 ** 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:
<a name="API_devicemanagement_CreateTask_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:
+  [AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/goto/aws-cli/snow-device-management-2021-08-04/CreateTask) 
+  [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snow-device-management-2021-08-04/CreateTask) 
+  [AWS-SDK für C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snow-device-management-2021-08-04/CreateTask) 
+  [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snow-device-management-2021-08-04/CreateTask) 
+  [AWS-SDK für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/snow-device-management-2021-08-04/CreateTask) 
+  [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snow-device-management-2021-08-04/CreateTask)