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. # CreateCluster **nota** AWS Snowball Edge ya no está disponible para nuevos clientes. Los nuevos clientes deberían [AWS DataSync](https://aws.amazon.com/datasync/)buscar transferencias en línea, un [terminal de transferencia de AWS datos](https://aws.amazon.com/data-transfer-terminal/) para transferencias físicas seguras o soluciones de AWS socios. Para la computación perimetral, explora [AWS Outposts](https://aws.amazon.com/outposts/). Crea un clúster vacío. Cada clúster admite cinco nodos. La acción [CreateJob](API_CreateJob.md) se usa por separado para crear los trabajos para cada uno de estos nodos. El clúster no se envía hasta que se hayan creado estos cinco trabajos de nodo. ## Sintaxis de la solicitud ``` { "AddressId": "string", "Description": "string", "ForceCreateJobs": boolean, "ForwardingAddressId": "string", "InitialClusterSize": number, "JobType": "string", "KmsKeyARN": "string", "LongTermPricingIds": [ "string" ], "Notification": { "DevicePickupSnsTopicARN": "string", "JobStatesToNotify": [ "string" ], "NotifyAll": boolean, "SnsTopicARN": "string" }, "OnDeviceServiceConfiguration": { "EKSOnDeviceService": { "EKSAnywhereVersion": "string", "KubernetesVersion": "string" }, "NFSOnDeviceService": { "StorageLimit": number, "StorageUnit": "string" }, "S3OnDeviceService": { "FaultTolerance": number, "ServiceSize": number, "StorageLimit": number, "StorageUnit": "string" }, "TGWOnDeviceService": { "StorageLimit": number, "StorageUnit": "string" } }, "RemoteManagement": "string", "Resources": { "Ec2AmiResources": [ { "AmiId": "string", "SnowballAmiId": "string" } ], "LambdaResources": [ { "EventTriggers": [ { "EventResourceARN": "string" } ], "LambdaArn": "string" } ], "S3Resources": [ { "BucketArn": "string", "KeyRange": { "BeginMarker": "string", "EndMarker": "string" }, "TargetOnDeviceServices": [ { "ServiceName": "string", "TransferOption": "string" } ] } ] }, "RoleARN": "string", "ShippingOption": "string", "SnowballCapacityPreference": "string", "SnowballType": "string", "TaxDocuments": { "IND": { "GSTIN": "string" } } } ``` ## Parámetros de la solicitud 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. ** [AddressId](#API_CreateCluster_RequestSyntax) ** El ID de la dirección a la que desea que se envíe el clúster. Tipo: cadena Limitaciones de longitud: longitud fija de 40. Patrón: `ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Obligatorio: sí ** [Description](#API_CreateCluster_RequestSyntax) ** Una descripción opcional de este clúster específico, por ejemplo, `Environmental Data Cluster-01`. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres. Patrón: `.*` Obligatorio: no ** [ForceCreateJobs](#API_CreateCluster_RequestSyntax) ** Obliga a crear un clúster cuando el usuario intenta sobreaprovisionar o subaprovisionar un clúster. Un clúster está sobreaprovisionado o subaprovisionado si su tamaño inicial es superior (sobreaprovisionado) o inferior (subaprovisionado) al necesario para cumplir con el requisito de capacidad especificado con `OnDeviceServiceConfiguration`. Tipo: Booleano Obligatorio: no ** [ForwardingAddressId](#API_CreateCluster_RequestSyntax) ** Este campo no se admite en su región. Tipo: cadena Limitaciones de longitud: longitud fija de 40. Patrón: `ADID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Obligatorio: no ** [InitialClusterSize](#API_CreateCluster_RequestSyntax) ** Si se proporciona, cada trabajo se creará automáticamente y se asociará al nuevo clúster. Si no se proporciona, se tratará como 0. Tipo: entero Rango válido: valor mínimo de 0. Valor máximo de 16. Obligatorio: no ** [JobType](#API_CreateCluster_RequestSyntax) ** El tipo de trabajo de este clúster. Actualmente, el único tipo de trabajo que se admite para los clústeres es `LOCAL_USE`. Para obtener información sobre los tipos de dispositivos de Snowball Edge, consulte la [información sobre el hardware del dispositivo](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html) en la Guía del desarrollador de Snowball Edge. Tipo: cadena Valores válidos: `IMPORT | EXPORT | LOCAL_USE` Obligatorio: sí ** [KmsKeyARN](#API_CreateCluster_RequestSyntax) ** El `KmsKeyARN` valor que desea asociar a este clúster. `KmsKeyARN`los valores se crean mediante la acción de la [CreateKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_CreateKey.html)API en AWS Key Management Service (AWS KMS). Tipo: cadena Limitaciones de longitud: longitud máxima de 255 caracteres. Patrón: `arn:aws.*:kms:.*:[0-9]{12}:key/.*` Obligatorio: no ** [LongTermPricingIds](#API_CreateCluster_RequestSyntax) ** Muestra el ID de precios a largo plazo que se utilizará para asociarlo a los trabajos que se creen automáticamente para el nuevo clúster. Tipo: matriz de cadenas Limitaciones de longitud: longitud fija de 41. Patrón: `LTPID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` Obligatorio: no ** [Notification](#API_CreateCluster_RequestSyntax) ** La configuración de notificación de Amazon Simple Notification Service (Amazon SNS) para este clúster. Tipo: objeto [Notification](API_Notification.md) Obligatorio: no ** [OnDeviceServiceConfiguration](#API_CreateCluster_RequestSyntax) ** Especifica el servicio o los servicios del dispositivo Snowball Edge desde los que se exportarán o importarán los datos transferidos. AWS Los clústeres de dispositivos Snowball Edge son compatibles con Amazon S3 y NFS (Network File System). Tipo: objeto [OnDeviceServiceConfiguration](API_OnDeviceServiceConfiguration.md) Obligatorio: no ** [RemoteManagement](#API_CreateCluster_RequestSyntax) ** Le permite utilizar y administrar de forma segura los dispositivos Snow de un clúster de forma remota desde fuera de su red interna. Si se establece en `INSTALLED_AUTOSTART`, la administración remota estará disponible automáticamente cuando el dispositivo llegue a su ubicación. De lo contrario, tendrá que utilizar el cliente de Snowball para administrar el dispositivo. Tipo: cadena Valores válidos: `INSTALLED_ONLY | INSTALLED_AUTOSTART | NOT_INSTALLED` Obligatorio: no ** [Resources](#API_CreateCluster_RequestSyntax) ** Los recursos asociados con el trabajo del clúster. Estos recursos incluyen buckets de Amazon S3 y AWS Lambda funciones opcionales escritas en el lenguaje Python. Tipo: objeto [JobResource](API_JobResource.md) Obligatorio: no ** [RoleARN](#API_CreateCluster_RequestSyntax) ** Lo `RoleARN` que desea asociar a este clúster. `RoleArn`los valores se crean mediante la acción de la [CreateRole](https://docs.aws.amazon.com/IAM/latest/APIReference/API_CreateRole.html)API en AWS Identity and Access Management (IAM). Tipo: cadena Limitaciones de longitud: longitud máxima de 255 caracteres. Patrón: `arn:aws.*:iam::[0-9]{12}:role/.*` Obligatorio: no ** [ShippingOption](#API_CreateCluster_RequestSyntax) ** La velocidad de envío de cada nodo de este clúster. Esta velocidad no determina la rapidez con la que recibirá cada dispositivo Snowball Edge, sino que representa la rapidez con la que cada dispositivo se mueve a su destino mientras está en tránsito. Las velocidades de envío regionales son: + En Australia, tiene acceso al envío urgente. Normalmente, los dispositivos Snow que se envían con la modalidad urgente tardan alrededor de un día en entregarse. + En la Unión Europea (UE), tiene acceso al envío urgente. Normalmente, los dispositivos Snow que se envían con la modalidad urgente tardan alrededor de un día en entregarse. Además, la mayoría de los países de la UE pueden utilizar el envío estándar, que suele tardar menos de una semana, de ida o de vuelta. + En la India, los dispositivos Snow se entregan en un plazo de uno a siete días. + En Estados Unidos de América (EE. UU.) dispone de opciones de envío en uno o dos días. + En Australia, tiene acceso al envío urgente. Normalmente, los dispositivos que se envían con la modalidad urgente tardan alrededor de un día en entregarse. + En la Unión Europea (UE), tiene acceso al envío urgente. Normalmente, los dispositivos Snow que se envían con la modalidad urgente tardan alrededor de un día en entregarse. Además, la mayoría de los países de la UE pueden utilizar el envío estándar, que suele tardar menos de una semana, de ida o de vuelta. + En la India, los dispositivos Snow se entregan en un plazo de uno a siete días. + En Estados Unidos, es posible utilizar el envío en un día o en dos días. Tipo: cadena Valores válidos: `SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD` Obligatorio: sí ** [SnowballCapacityPreference](#API_CreateCluster_RequestSyntax) ** Si su trabajo se está creando en una de las regiones de EE. UU., tiene la opción de especificar el tamaño del dispositivo Snow que desea para este trabajo. En el resto de regiones, los dispositivos Snowball vienen con una capacidad de almacenamiento de 80 TB. Para obtener información sobre los tipos de dispositivos de Snowball Edge, consulte la [información sobre el hardware del dispositivo](/snowball/latest/developer-guide/device-differences.html) en la Guía del desarrollador de Snowball Edge. Tipo: cadena Valores válidos: `T50 | T80 | T100 | T42 | T98 | T8 | T14 | T32 | NoPreference | T240 | T13` Obligatorio: no ** [SnowballType](#API_CreateCluster_RequestSyntax) ** Los tipos de dispositivos Snow Family que se utilizarán para este clúster. Para los trabajos de clúster, AWS Snowball Edge actualmente solo admite el tipo de `EDGE` dispositivo. Para obtener información sobre los tipos de dispositivos de Snowball Edge, consulte la [información sobre el hardware del dispositivo](https://docs.aws.amazon.com/snowball/latest/developer-guide/device-differences.html) en la Guía del desarrollador de Snowball Edge. Tipo: cadena Valores válidos: `STANDARD | EDGE | EDGE_C | EDGE_CG | EDGE_S | SNC1_HDD | SNC1_SSD | V3_5C | V3_5S | RACK_5U_C` Obligatorio: sí ** [TaxDocuments](#API_CreateCluster_RequestSyntax) ** Los documentos fiscales requeridos en su. Región de AWS Tipo: objeto [TaxDocuments](API_TaxDocuments.md) Obligatorio: no ## Sintaxis de la respuesta ``` { "ClusterId": "string", "JobListEntries": [ { "CreationDate": number, "Description": "string", "IsMaster": boolean, "JobId": "string", "JobState": "string", "JobType": "string", "SnowballType": "string" } ] } ``` ## Elementos de respuesta Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200. El servicio devuelve los datos siguientes en formato JSON. ** [ClusterId](#API_CreateCluster_ResponseSyntax) ** El ID generado automáticamente para un clúster. Tipo: cadena Limitaciones de longitud: longitud fija de 39. Patrón: `CID[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` ** [JobListEntries](#API_CreateCluster_ResponseSyntax) ** Lista de trabajos creados para este clúster. Para ver la sintaxis, consulte [ListJobsResult\$1 JobListEntries](https://amazonaws.com/snowball/latest/api-reference/API_ListJobs.html#API_ListJobs_ResponseSyntax) en esta guía. Tipo: matriz de objetos [JobListEntry](API_JobListEntry.md) ## Errores Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md). ** Ec2RequestFailedException ** El usuario carece de los EC2 permisos de Amazon necesarios para realizar el intento de acción. Código de estado HTTP: 400 ** InvalidInputCombinationException ** Error al crear el trabajo o clúster. Una o más entradas no son válidas. Confirma que el SnowballType valor [CreateCluster:](#Snowball-CreateCluster-request-SnowballType) es compatible con tu [CreateJob: JobType](API_CreateJob.md#Snowball-CreateJob-request-JobType) e inténtalo de nuevo. Código de estado HTTP: 400 ** InvalidResourceException ** No se ha encontrado el recurso especificado. Compruebe la información que proporcionó en la última solicitud e inténtelo de nuevo. ** ResourceType ** El valor de recurso proporcionado no es válido. Código de estado HTTP: 400 ** KMSRequestFailedException ** La AWS Key Management Service clave proporcionada carece de los permisos necesarios para realizar la [UpdateJob](API_UpdateJob.md) acción [CreateJob](API_CreateJob.md) o acción especificada. Código de estado HTTP: 400 ## Véase también Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/snowball-2016-06-30/CreateCluster) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/snowball-2016-06-30/CreateCluster) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/CreateCluster) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/CreateCluster) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/CreateCluster) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/CreateCluster) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/snowball-2016-06-30/CreateCluster) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/CreateCluster) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/CreateCluster) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/CreateCluster)