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.

# DescribeTask
<a name="API_devicemanagement_DescribeTask"></a>

Überprüft die Metadaten auf eine bestimmte Aufgabe auf einem Gerät. 

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

```
POST /task/{{taskId}} HTTP/1.1
```

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

Die Anforderung verwendet die folgenden URI-Parameter.

 ** [taskId](#API_devicemanagement_DescribeTask_RequestSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-request-taskId"></a>
ID der zu beschreibenden Aufgabe  
Einschränkungen für die Länge: Mindestlänge 1. Höchstlänge = 64 Zeichen.  
Erforderlich: Ja

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

Der Anforderung besitzt keinen Anforderungstext.

## Antwortsyntax
<a name="API_devicemanagement_DescribeTask_ResponseSyntax"></a>

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

{
   "completedAt": number,
   "createdAt": number,
   "description": "string",
   "lastUpdatedAt": number,
   "state": "string",
   "tags": { 
      "string" : "string" 
   },
   "targets": [ "string" ],
   "taskArn": "string",
   "taskId": "string"
}
```

## Antwortelemente
<a name="API_devicemanagement_DescribeTask_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.

 ** [completedAt](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-completedAt"></a>
Als die Aufgabe abgeschlossen war.  
Type: Zeitstempel

 ** [createdAt](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-createdAt"></a>
Wenn die`CreateTask`Operation wurde aufgerufen.  
Type: Zeitstempel

 ** [description](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-description"></a>
Die Beschreibung der Aufgabe und der verwalteten Geräte.  
Type: String (Zeichenfolge)  
Einschränkungen für die Länge: Mindestlänge 1. Maximale Länge beträgt 128 Zeichen.  
Pattern: `[A-Za-z0-9 _.,!#]*` 

 ** [lastUpdatedAt](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-lastUpdatedAt"></a>
Wann der Status der Aufgabe zuletzt aktualisiert wurde.  
Type: Zeitstempel

 ** [state](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-state"></a>
Der aktuelle Status der Aufgabe.  
Type: String (Zeichenfolge)  
Zulässige Werte:` IN_PROGRESS | CANCELED | COMPLETED` 

 ** [tags](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-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

 ** [targets](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-targets"></a>
Die verwalteten Geräte, an die die Aufgabe gesendet wurde.  
Type: Zeichenfolgen-Array  
Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 10 Elemente.

 ** [taskArn](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-taskArn"></a>
Der Amazon-Ressourcenname (ARN) der Aufgabe.  
Type: String (Zeichenfolge)

 ** [taskId](#API_devicemanagement_DescribeTask_ResponseSyntax) **   <a name="Snowball-devicemanagement_DescribeTask-response-taskId"></a>
Die ID der Aufgabe.  
Type: String (Zeichenfolge)

## Fehler
<a name="API_devicemanagement_DescribeTask_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

 ** ThrottlingException **   
Die Anforderung wurde aufgrund der Drosselung von Anforderungen abgelehnt.  
HTTP-Statuscode: 429

 ** ValidationException **   
Die Eingabe erfüllt nicht die durch eineAWSService-Service.  
HTTP-Statuscode: 400

## Weitere Informationen finden Sie unter:
<a name="API_devicemanagement_DescribeTask_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/DescribeTask) 
+  [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/snow-device-management-2021-08-04/DescribeTask) 
+  [AWS-SDK für C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/snow-device-management-2021-08-04/DescribeTask) 
+  [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/snow-device-management-2021-08-04/DescribeTask) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snow-device-management-2021-08-04/DescribeTask) 
+  [AWS-SDK für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/snow-device-management-2021-08-04/DescribeTask) 
+  [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snow-device-management-2021-08-04/DescribeTask) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/snow-device-management-2021-08-04/DescribeTask) 
+  [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snow-device-management-2021-08-04/DescribeTask)