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. # UpdateCluster **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/). Aunque el valor de `ClusterState` de un clúster tenga el estado `AwaitingQuorum`, puede actualizar parte de la información asociada a un clúster. Una vez que el clúster cambia a un estado de trabajo diferente, normalmente 60 minutos después de crearlo, esta acción deja de estar disponible. ## Sintaxis de la solicitud ``` { "AddressId": "string", "ClusterId": "string", "Description": "string", "ForwardingAddressId": "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" } }, "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" } ``` ## 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_UpdateCluster_RequestSyntax) ** El ID del objeto [Address](API_Address.md) actualizado. 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 ** [ClusterId](#API_UpdateCluster_RequestSyntax) ** El ID del clúster que desea actualizar, por ejemplo, `CID123e4567-e89b-12d3-a456-426655440000`. 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}` Obligatorio: sí ** [Description](#API_UpdateCluster_RequestSyntax) ** La descripción actualizada de este clúster. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres. Patrón: `.*` Obligatorio: no ** [ForwardingAddressId](#API_UpdateCluster_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 ** [Notification](#API_UpdateCluster_RequestSyntax) ** El objeto [Notification](API_Notification.md) nuevo o actualizado. Tipo: objeto [Notification](API_Notification.md) Obligatorio: no ** [OnDeviceServiceConfiguration](#API_UpdateCluster_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 ** [Resources](#API_UpdateCluster_RequestSyntax) ** Las matrices de objetos [JobResource](API_JobResource.md) actualizados que pueden incluir objetos [S3Resource](API_S3Resource.md) u objetos [LambdaResource](API_LambdaResource.md) actualizados. Tipo: objeto [JobResource](API_JobResource.md) Obligatorio: no ** [RoleARN](#API_UpdateCluster_RequestSyntax) ** El Nombre de recurso de Amazon (ARN) del rol nuevo que desea asociar a este clúster. Para crear un ARN de rol, usa la acción de [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_UpdateCluster_RequestSyntax) ** El valor actualizado de la opción de envío del objeto [ShippingDetails](API_ShippingDetails.md) de este clúster. Tipo: cadena Valores válidos: `SECOND_DAY | NEXT_DAY | EXPRESS | STANDARD` Obligatorio: no ## Elementos de respuesta Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío. ## 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:](API_CreateCluster.md#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 ** InvalidJobStateException ** La acción no se puede realizar porque el estado actual del trabajo no permite que se realice esa acción. 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/UpdateCluster) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/snowball-2016-06-30/UpdateCluster) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/snowball-2016-06-30/UpdateCluster) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/snowball-2016-06-30/UpdateCluster) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/snowball-2016-06-30/UpdateCluster) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/snowball-2016-06-30/UpdateCluster) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/snowball-2016-06-30/UpdateCluster) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/snowball-2016-06-30/UpdateCluster) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/snowball-2016-06-30/UpdateCluster) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/snowball-2016-06-30/UpdateCluster)