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
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.
La solicitud acepta los siguientes datos en formato JSON.
- AddressId
-
El ID del objeto Address 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
-
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
-
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
-
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
-
El objeto Notification nuevo o actualizado.
Tipo: objeto Notification
Obligatorio: no
- OnDeviceServiceConfiguration
-
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
Obligatorio: no
- Resources
-
Las matrices de objetos JobResource actualizados que pueden incluir objetos S3Resource u objetos LambdaResource actualizados.
Tipo: objeto JobResource
Obligatorio: no
- RoleARN
-
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 CreateRoleAPI 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
-
El valor actualizado de la opción de envío del objeto ShippingDetails de este clúster.
Tipo: cadena
Valores válidos:
SECOND_DAY | NEXT_DAY | EXPRESS | STANDARDObligatorio: 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 Errores comunes.
- 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: es compatible con tu CreateJob: 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 acción CreateJob 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:
