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.
UpdateFramework
Actualiza el marco especificado.
Sintaxis de la solicitud
PUT /audit/frameworks/frameworkName HTTP/1.1
Content-type: application/json
{
"FrameworkControls": [
{
"ControlInputParameters": [
{
"ParameterName": "string",
"ParameterValue": "string"
}
],
"ControlName": "string",
"ControlScope": {
"ComplianceResourceIds": [ "string" ],
"ComplianceResourceTypes": [ "string" ],
"Tags": {
"string" : "string"
}
}
}
],
"FrameworkDescription": "string",
"IdempotencyToken": "string"
}Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- frameworkName
-
El nombre único de un marco. Este nombre debe contener entre 1 y 256 caracteres, comenzando por una letra, y contar con letras (a-z, A-Z), números (0-9) y guiones bajos (_).
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.
Patrón:
[a-zA-Z][_a-zA-Z0-9]*Obligatorio: sí
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- FrameworkControls
-
Los controles que componen el marco. Cada control de la lista tiene un nombre, parámetros de entrada y alcance.
Tipo: matriz de objetos FrameworkControl
Requerido: no
- FrameworkDescription
-
Una descripción opcional del marco con un máximo de 1024 caracteres.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1024 caracteres.
Patrón:
.*\S.*Requerido: no
- IdempotencyToken
-
Una cadena elegida por el cliente que puede utilizar para distinguir entre llamadas a
UpdateFrameworkInputque, de otro modo, serían idénticas. Si se vuelve a intentar una solicitud correcta con el mismo token de idempotencia, aparece un mensaje de confirmación y no se realiza ninguna acción.Tipo: cadena
Requerido: no
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"CreationTime": number,
"FrameworkArn": "string",
"FrameworkName": "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.
- CreationTime
-
Es la fecha y la hora en que se creó un marco con la norma ISO 8601. El valor de
CreationTimetiene una precisión de milisegundos. Por ejemplo, 2020-07-10T15:00:00.000-08:00 representa el 10 de julio de 2020 a las 15:00 h, 8 horas menos que UTC.Tipo: marca temporal
- FrameworkArn
-
Un nombre de recurso de Amazon (ARN) que identifica de forma exclusiva un recurso. El formato del ARN depende del tipo de recurso.
Tipo: cadena
- FrameworkName
-
El nombre único de un marco. Este nombre debe contener entre 1 y 256 caracteres, comenzando por una letra, y contar con letras (a-z, A-Z), números (0-9) y guiones bajos (_).
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.
Patrón:
[a-zA-Z][_a-zA-Z0-9]*
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- AlreadyExistsException
-
El recurso ya existe.
Código de estado HTTP: 400
- ConflictException
-
AWS Backup no puede realizar la acción que ha solicitado hasta que termine de realizar una acción anterior. Inténtelo de nuevo más tarde.
Código de estado HTTP: 400
- InvalidParameterValueException
-
Indica que hay algún problema con el valor de un parámetro. Por ejemplo, el valor está fuera del rango.
Código de estado HTTP: 400
- LimitExceededException
-
Se ha superado un límite en la solicitud; por ejemplo, el número máximo de elementos permitidos en una solicitud.
Código de estado HTTP: 400
- MissingParameterValueException
-
Indica que falta un parámetro obligatorio.
Código de estado HTTP: 400
- ResourceNotFoundException
-
No existe un recurso necesario para la acción.
Código de estado HTTP: 400
- ServiceUnavailableException
-
La solicitud no se ha ejecutado correctamente debido a un error temporal del servidor.
Código de estado HTTP: 500
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:
