Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Active un AWS DataSync agent que vous déployez dans votre environnement de stockage. Le processus d'activation associe l'agent à votre Compte AWS.

Si vous n'avez pas encore déployé d'agent, consultez la section [Ai-je besoin d'un DataSync agent ?](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html) 

## Syntaxe de la requête
<a name="API_CreateAgent_RequestSyntax"></a>

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

## Paramètres de demande
<a name="API_CreateAgent_RequestParameters"></a>

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).

Cette demande accepte les données suivantes au format JSON.

 ** [ActivationKey](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-ActivationKey"></a>
Spécifie la clé d'activation de votre DataSync agent. Si vous n'avez pas de clé d'activation, consultez la section [Activation de votre agent](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html).  
Type : Chaîne  
Contraintes de longueur : longueur maximale de 29.  
Modèle : `[A-Z0-9]{5}(-[A-Z0-9]{5}){4}`   
Obligatoire : oui

 ** [AgentName](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-AgentName"></a>
Spécifie le nom de votre agent. Nous vous recommandons de spécifier un nom dont vous vous souviendrez.  
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 0. Longueur maximum de 256.  
Modèle : `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obligatoire : non

 ** [SecurityGroupArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SecurityGroupArns"></a>
Spécifie le nom de ressource Amazon (ARN) du groupe de sécurité qui autorise le trafic entre votre agent et le point de terminaison du service VPC. Vous ne pouvez spécifier qu'un seul ARN.  
Type : tableau de chaînes  
Membres du tableau : nombre fixe de 1 élément.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^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]+$`   
Obligatoire : non

 ** [SubnetArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SubnetArns"></a>
Spécifie l'ARN du sous-réseau où se trouve le point de terminaison de votre service VPC. Vous ne pouvez spécifier qu'un seul ARN.  
Type : tableau de chaînes  
Membres du tableau : nombre fixe de 1 élément.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^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]+$`   
Obligatoire : non

 ** [Tags](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-Tags"></a>
Spécifie des étiquettes qui vous aident à classer, filtrer et rechercher vos AWS ressources. Nous vous recommandons de créer au moins un tag pour votre agent.  
Type : tableau d’objets [TagListEntry](API_TagListEntry.md)  
Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments.  
Obligatoire : non

 ** [VpcEndpointId](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-VpcEndpointId"></a>
Spécifie l'ID du point de [terminaison du service VPC](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#datasync-in-vpc) que vous utilisez. Par exemple, un identifiant de point de terminaison VPC ressemble à. `vpce-01234d5aff67890e1`  
Le point de terminaison du service VPC que vous utilisez doit inclure le nom du DataSync service (par exemple,`com.amazonaws.us-east-2.datasync`).
Type : Chaîne  
Modèle : `^vpce-[0-9a-f]{17}$`   
Obligatoire : non

## Syntaxe de la réponse
<a name="API_CreateAgent_ResponseSyntax"></a>

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

## Eléments de réponse
<a name="API_CreateAgent_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [AgentArn](#API_CreateAgent_ResponseSyntax) **   <a name="DataSync-CreateAgent-response-AgentArn"></a>
L'ARN de l'agent que vous venez d'activer. Utilisez cette [ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html)opération pour renvoyer une liste d'agents dans votre Compte AWS et Région AWS.  
Type : Chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^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}$` 

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

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).

 ** InternalException **   
Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service.  
Code d’état HTTP : 500

 ** InvalidRequestException **   
Cette exception est levée lorsque le client soumet une demande mal formée.  
Code d’état HTTP : 400

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

### Exemple de demande
<a name="API_CreateAgent_Example_1"></a>

L'exemple suivant active un DataSync agent.

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

### Exemple de réponse
<a name="API_CreateAgent_Example_2"></a>

La réponse renvoie l'ARN de l'agent activé.

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

## Voir aussi
<a name="API_CreateAgent_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateAgent)