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.

# CreateAgent
<a name="API_CreateAgent"></a>

Aktiviert einen AWS DataSync Agenten, den Sie in Ihrer Speicherumgebung bereitstellen. Der Aktivierungsprozess verknüpft den Agenten mit Ihrem AWS-Konto.

Falls Sie noch keinen Agenten eingesetzt haben, finden Sie weitere Informationen unter [Benötige ich einen DataSync Agenten?](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html) 

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

```
{
   "ActivationKey": "string",
   "AgentName": "string",
   "SecurityGroupArns": [ "string" ],
   "SubnetArns": [ "string" ],
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "VpcEndpointId": "string"
}
```

## Anforderungsparameter
<a name="API_CreateAgent_RequestParameters"></a>

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter [Allgemeine Parameter](CommonParameters.md).

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

 ** [ActivationKey](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-ActivationKey"></a>
Gibt den Aktivierungsschlüssel Ihres DataSync Agenten an. Wenn Sie keinen Aktivierungsschlüssel haben, finden Sie weitere Informationen unter [Aktivierung Ihres Agenten](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html).  
Typ: Zeichenfolge  
Längenbeschränkungen: Die maximale Länge beträgt 29.  
Pattern: `[A-Z0-9]{5}(-[A-Z0-9]{5}){4}`   
Erforderlich: Ja

 ** [AgentName](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-AgentName"></a>
Gibt einen Namen für Ihren Agenten an. Wir empfehlen, einen Namen anzugeben, an den Sie sich erinnern können.  
Typ: Zeichenfolge  
Längenbeschränkungen: Minimale Länge von 0. Maximale Länge beträgt 256 Zeichen.  
Pattern: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Erforderlich: Nein

 ** [SecurityGroupArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SecurityGroupArns"></a>
Gibt den Amazon-Ressourcennamen (ARN) der Sicherheitsgruppe an, die den Datenverkehr zwischen Ihrem Agenten und dem VPC-Serviceendpunkt zulässt. Sie können nur einen ARN angeben.  
Typ: Zeichenfolgen-Array  
Array-Mitglieder: Feste Anzahl von 1 Element.  
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.  
Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:security-group/sg-[a-f0-9]+$`   
Erforderlich: Nein

 ** [SubnetArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SubnetArns"></a>
Gibt den ARN des Subnetzes an, in dem sich Ihr VPC-Dienstendpunkt befindet. Sie können nur einen ARN angeben.  
Typ: Zeichenfolgen-Array  
Array-Mitglieder: Feste Anzahl von 1 Element.  
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.  
Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):ec2:[a-z\-0-9]*:[0-9]{12}:subnet/subnet-[a-f0-9]+$`   
Erforderlich: Nein

 ** [Tags](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-Tags"></a>
Gibt Labels an, die Ihnen helfen, Ihre AWS Ressourcen zu kategorisieren, zu filtern und nach ihnen zu suchen. Wir empfehlen, mindestens ein Tag für Ihren Agenten zu erstellen.  
Typ: Array von [TagListEntry](API_TagListEntry.md)-Objekten  
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente.  
Erforderlich: Nein

 ** [VpcEndpointId](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-VpcEndpointId"></a>
Gibt die ID des [VPC-Dienstendpunkts](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#datasync-in-vpc) an, den Sie verwenden. Eine VPC-Endpunkt-ID sieht beispielsweise so `vpce-01234d5aff67890e1` aus.  
Der von Ihnen verwendete VPC-Dienstendpunkt muss den DataSync Dienstnamen enthalten (z. B.`com.amazonaws.us-east-2.datasync`).
Typ: Zeichenfolge  
Pattern: `^vpce-[0-9a-f]{17}$`   
Erforderlich: Nein

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

```
{
   "AgentArn": "string"
}
```

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

 ** [AgentArn](#API_CreateAgent_ResponseSyntax) **   <a name="DataSync-CreateAgent-response-AgentArn"></a>
Der ARN des Agenten, den Sie gerade aktiviert haben. Verwenden Sie den [ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html)Vorgang, um eine Liste der Agenten in Ihrem Land AWS-Konto zurückzugeben AWS-Region.  
Typ: Zeichenfolge  
Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.  
Pattern: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$` 

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

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter [Häufige Fehler](CommonErrors.md).

 ** InternalException **   
Diese Ausnahme wird ausgelöst, wenn im AWS DataSync Dienst ein Fehler auftritt.  
HTTP Status Code: 500

 ** InvalidRequestException **   
Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet.  
HTTP-Statuscode: 400

## Beispiele
<a name="API_CreateAgent_Examples"></a>

### Beispielanforderung
<a name="API_CreateAgent_Example_1"></a>

Im folgenden Beispiel wird ein DataSync Agent aktiviert.

```
{
    "ActivationKey": "AAAAA-1AAAA-BB1CC-33333-EEEEE",
    "AgentName": "MyAgent",
    "Tags": [{
        "Key": "Job",
        "Value": "TransferJob-1"
    }]
}
```

### Beispielantwort
<a name="API_CreateAgent_Example_2"></a>

Die Antwort gibt den ARN des aktivierten Agenten zurück.

```
{
    "AgentArn": "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44baca3"
}
```

## Weitere Informationen finden Sie unter:
<a name="API_CreateAgent_SeeAlso"></a>

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden:
+  [AWS Befehlszeilenschnittstelle V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK für JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK für Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateAgent)