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.
UpdateHypervisor
Actualiza los metadatos de un hipervisor, lo que incluye el host, el nombre de usuario y la contraseña. Especifique el hipervisor que desea actualizar mediante el nombre de recurso de Amazon (ARN) del hipervisor en su solicitud.
Sintaxis de la solicitud
{
"Host": "string
",
"HypervisorArn": "string
",
"LogGroupArn": "string
",
"Name": "string
",
"Password": "string
",
"Username": "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.
- Host
-
El host actualizado del hipervisor. Puede ser una dirección IP o un nombre de dominio completo (FQDN).
Tipo: cadena
Limitaciones de longitud: longitud mínima de 3. Longitud máxima de 128.
Patrón:
^.+$
Requerido: no
- HypervisorArn
-
El nombre de recurso de Amazon (ARN) del hipervisor que se va a actualizar.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.
Patrón:
^arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+$
Obligatorio: sí
- LogGroupArn
-
El nombre de recurso de Amazon (ARN) de grupo de puertas de enlace dentro del registro solicitado.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 0 caracteres. La longitud máxima es de 2048 caracteres.
Patrón:
^$|^arn:(aws|aws-cn|aws-us-gov):logs:([a-zA-Z0-9-]+):([0-9]+):log-group:[a-zA-Z0-9_\-\/\.]+:\*$
Requerido: no
- Name
-
El nombre actualizado del hipervisor
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.
Patrón:
^[a-zA-Z0-9-]*$
Requerido: no
- Password
-
La contraseña actualizada del hipervisor.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.
Patrón:
^[ -~]+$
Requerido: no
- Username
-
El nombre de usuario actualizado del hipervisor.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 100 caracteres.
Patrón:
^[ -\.0-\[\]-~]*[!-\.0-\[\]-~][ -\.0-\[\]-~]*$
Requerido: no
Sintaxis de la respuesta
{
"HypervisorArn": "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.
- HypervisorArn
-
El nombre de recurso de Amazon (ARN) del hipervisor que ha actualizado.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 50. La longitud máxima es de 500 caracteres.
Patrón:
^arn:(aws|aws-cn|aws-us-gov):backup-gateway(:[a-zA-Z-0-9]+){3}\/[a-zA-Z-0-9]+$
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- AccessDeniedException
-
La operación no puede continuar porque no tiene permisos suficientes.
Código de estado HTTP: 400
- ConflictException
-
La operación no puede continuar porque no se admite.
Código de estado HTTP: 400
- InternalServerException
-
La operación no se realizó correctamente porque se produjo un error interno. Inténtelo de nuevo más tarde.
Código de estado HTTP: 500
- ResourceNotFoundException
-
No se encontró un recurso necesario para la acción.
Código de estado HTTP: 400
- ThrottlingException
-
Las TPS se han limitado para proteger frente a altos volúmenes de solicitudes, intencionados o no.
Código de estado HTTP: 400
- ValidationException
-
La operación no se realizó correctamente porque se produjo un error de validación.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte: