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.
ValidatePolicy
Solicita la validación de una política y devuelve una lista de hallazgos. Los hallazgos ayudan a identificar los problemas y proporcionan recomendaciones prácticas para resolverlos y permiten crear políticas funcionales que cumplan con las prácticas recomendadas de seguridad.
Sintaxis de la solicitud
POST /policy/validation?maxResults=maxResults&nextToken=nextToken HTTP/1.1
Content-type: application/json
{
"locale": "string",
"policyDocument": "string",
"policyType": "string",
"validatePolicyResourceType": "string"
}Parámetros de solicitud del URI
La solicitud utiliza los siguientes parámetros URI.
- maxResults
-
El número máximo de resultados que se devolverá en la respuesta.
- nextToken
-
Un token que se utiliza para la paginación de los resultados devueltos.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- locale
-
La configuración regional que se utilizará para localizar los hallazgos.
Tipo: cadena
Valores válidos:
DE | EN | ES | FR | IT | JA | KO | PT_BR | ZH_CN | ZH_TWObligatorio: no
- policyDocument
-
El documento de política JSON que se utilizará como contenido de la política.
Tipo: cadena
Obligatorio: sí
- policyType
-
El tipo de política que se va a validar. Las políticas de identidad otorgan permisos a los directores de IAM. Las políticas de identidad incluyen políticas administradas e integradas para los roles, usuarios y grupos de IAM.
Las políticas de recursos conceden permisos sobre AWS los recursos. Las políticas de recursos incluyen políticas de confianza para las funciones de IAM y políticas de buckets para los buckets de Amazon S3. Puede proporcionar una entrada genérica, como la política de identidad o la política de recursos, o una entrada específica, como la política administrada o la política de cubos de Amazon S3.
Las políticas de control de servicios (SCP) son un tipo de política organizativa asociada a una AWS organización, una unidad organizativa (OU) o una cuenta.
Tipo: cadena
Valores válidos:
IDENTITY_POLICY | RESOURCE_POLICY | SERVICE_CONTROL_POLICY | RESOURCE_CONTROL_POLICYObligatorio: sí
- validatePolicyResourceType
-
El tipo de recurso que se va a adjuntar a la política de recursos. Especifique un valor para el tipo de recurso de validación de políticas solo si el tipo de política es
RESOURCE_POLICY. Por ejemplo, para validar una política de recursos para adjuntarla a un bucket de Amazon S3, puede elegir el tipoAWS::S3::Bucketde recurso de validación de la política.En el caso de los tipos de recursos que no se admiten como valores válidos, IAM Access Analyzer realiza comprobaciones de políticas que se aplican a todas las políticas de recursos. Por ejemplo, para validar una política de recursos para adjuntarla a una clave de KMS, no especifique un valor para el tipo de recurso de validación de la política e IAM Access Analyzer realizará las comprobaciones de políticas que se apliquen a todas las políticas de recursos.
Tipo: cadena
Valores válidos:
AWS::S3::Bucket | AWS::S3::AccessPoint | AWS::S3::MultiRegionAccessPoint | AWS::S3ObjectLambda::AccessPoint | AWS::IAM::AssumeRolePolicyDocument | AWS::DynamoDB::TableObligatorio: no
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"findings": [
{
"findingDetails": "string",
"findingType": "string",
"issueCode": "string",
"learnMoreLink": "string",
"locations": [
{
"path": [
{ ... }
],
"span": {
"end": {
"column": number,
"line": number,
"offset": number
},
"start": {
"column": number,
"line": number,
"offset": number
}
}
}
]
}
],
"nextToken": "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.
- findings
-
La lista de resultados de una política devuelta por IAM Access Analyzer en función de su conjunto de comprobaciones de políticas.
Tipo: matriz de objetos ValidatePolicyFinding
- nextToken
-
Un token utilizado para la paginación de los resultados devueltos.
Tipo: cadena
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Tipos de errores comunes.
- AccessDeniedException
-
No tiene acceso suficiente para realizar esta acción.
Código de estado HTTP: 403
- InternalServerException
-
Error interno de servicio
- retryAfterSeconds
-
Los segundos de espera para volver a intentarlo.
Código de estado HTTP: 500
- ThrottlingException
-
Error de superación del límite de velocidad.
- retryAfterSeconds
-
Los segundos de espera para volver a intentarlo.
Código de estado HTTP: 429
- ValidationException
-
Error de excepción de validación.
- fieldList
-
Una lista de campos que no se han validado.
- reason
-
El motivo de la excepción.
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 AWS SDK específicos del idioma, consulta lo siguiente:
