Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Activa un AWS DataSync agente que se implementa en el entorno de almacenamiento. El proceso de activación asocia el agente con el suyo Cuenta de AWS.

Si aún no ha desplegado un agente, consulte [¿Necesito un DataSync agente?](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html) 

## Sintaxis de la solicitud
<a name="API_CreateAgent_RequestSyntax"></a>

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

## Parámetros de la solicitud
<a name="API_CreateAgent_RequestParameters"></a>

Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md).

La solicitud acepta los siguientes datos en formato JSON.

 ** [ActivationKey](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-ActivationKey"></a>
Especifica la clave de activación de su DataSync agente. Si no tiene una clave de activación, consulte [Activar el agente](https://docs.aws.amazon.com/datasync/latest/userguide/activate-agent.html).  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 29 caracteres.  
Patrón: `[A-Z0-9]{5}(-[A-Z0-9]{5}){4}`   
Obligatorio: sí

 ** [AgentName](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-AgentName"></a>
Especifica un nombre para el agente. Le recomendamos que especifique un nombre que pueda recordar.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 256 caracteres.  
Patrón: `^[a-zA-Z0-9\s+=._:@/-]+$`   
Obligatorio: no

 ** [SecurityGroupArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SecurityGroupArns"></a>
Especifica el nombre de recurso de Amazon (ARN) del grupo de seguridad que permite el tráfico entre su agente y el punto de conexión del servicio de VPC. Solo puede especificar un ARN.  
Tipo: matriz de cadenas  
Miembros de la matriz: número fijo de 1 elemento.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: no

 ** [SubnetArns](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-SubnetArns"></a>
Especifica el ARN de la subred en la que se encuentra el punto de conexión del servicio de VPC. Solo puede especificar un ARN.  
Tipo: matriz de cadenas  
Miembros de la matriz: número fijo de 1 elemento.  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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]+$`   
Obligatorio: no

 ** [Tags](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-Tags"></a>
Especifica las etiquetas que le ayudan a clasificar, filtrar y buscar AWS los recursos. Le recomendamos que cree al menos una etiqueta para el agente.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.  
Obligatorio: no

 ** [VpcEndpointId](#API_CreateAgent_RequestSyntax) **   <a name="DataSync-CreateAgent-request-VpcEndpointId"></a>
Especifica el ID del [punto de conexión del servicio de VPC](https://docs.aws.amazon.com/datasync/latest/userguide/choose-service-endpoint.html#datasync-in-vpc) que está utilizando. Por ejemplo, un ID de punto de conexión de VPC se parece a `vpce-01234d5aff67890e1`.  
El punto final del servicio de VPC que utilice debe incluir el nombre del DataSync servicio (por ejemplo,`com.amazonaws.us-east-2.datasync`).
Tipo: cadena  
Patrón: `^vpce-[0-9a-f]{17}$`   
Obligatorio: no

## Sintaxis de la respuesta
<a name="API_CreateAgent_ResponseSyntax"></a>

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

## Elementos de respuesta
<a name="API_CreateAgent_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

 ** [AgentArn](#API_CreateAgent_ResponseSyntax) **   <a name="DataSync-CreateAgent-response-AgentArn"></a>
Estos comandos devuelven el ARN del agente que acaba de activar. Utilice la [ListAgents](https://docs.aws.amazon.com/datasync/latest/userguide/API_ListAgents.html)operación para devolver una lista de los agentes que tiene en su mano Cuenta de AWS . Región de AWS  
Tipo: cadena  
Limitaciones de longitud: longitud máxima de 128 caracteres.  
Patrón: `^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}$` 

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

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** InternalException **   
Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .  
Código de estado HTTP: 500

 ** InvalidRequestException **   
Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.  
Código de estado HTTP: 400

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

### Solicitud de ejemplo
<a name="API_CreateAgent_Example_1"></a>

El siguiente ejemplo activa un DataSync agente.

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

### Respuesta de ejemplo
<a name="API_CreateAgent_Example_2"></a>

La respuesta devuelve el ARN del agente activado.

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

## Véase también
<a name="API_CreateAgent_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateAgent) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateAgent)