View a markdown version of this page

CreateAnalyzer - IAM Access Analyzer

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.

CreateAnalyzer

Crea un analizador para tu cuenta.

Sintaxis de la solicitud

PUT /analyzer HTTP/1.1 Content-type: application/json { "analyzerName": "string", "archiveRules": [ { "filter": { "string" : { "contains": [ "string" ], "eq": [ "string" ], "exists": boolean, "neq": [ "string" ] } }, "ruleName": "string" } ], "clientToken": "string", "configuration": { ... }, "tags": { "string" : "string" }, "type": "string" }

Parámetros de solicitud del URI

La solicitud no utiliza ningún parámetro de URI.

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

analyzerName

El nombre del analizador que se va a crear.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.

Patrón: [A-Za-z][A-Za-z0-9_.-]*

Obligatorio: sí

archiveRules

Especifica las reglas de archivo que se van a agregar para el analizador. Las reglas de archivado archivan automáticamente los hallazgos que cumplen los criterios que usted defina para la regla.

Tipo: matriz de objetos InlineArchiveRule

Obligatorio: no

clientToken

Un token de cliente.

Tipo: cadena

Requerido: no

configuration

Especifica la configuración del analizador. Si el analizador es un analizador de acceso no utilizado, para la configuración se utiliza el ámbito de acceso no utilizado especificado. Si el analizador es un analizador de acceso interno, para la configuración se utilizan las reglas de análisis de acceso interno especificadas.

Tipo: objeto AnalyzerConfiguration

Nota: Este objeto es una unión. Solo se puede especificar o devolver un miembro de este objeto.

Obligatorio: no

tags

Un conjunto de pares clave-valor para aplicar al analizador. Puede usar el conjunto de letras Unicode, dígitos, espacios en blanco,,,, _., / y. = + -

Para la clave de etiqueta, puede especificar un valor que tenga entre 1 y 128 caracteres y que no pueda incluir un prefijo. aws:

Para el valor de la etiqueta, puede especificar un valor que tenga una longitud de 0 a 256 caracteres.

Tipo: mapa de cadena a cadena

Obligatorio: no

type

El tipo de analizador que se va a crear. Solo puede crear un analizador por cuenta por región. Puede crear hasta 5 analizadores por organización por región.

Tipo: cadena

Valores válidos: ACCOUNT | ORGANIZATION | ACCOUNT_UNUSED_ACCESS | ORGANIZATION_UNUSED_ACCESS | ACCOUNT_INTERNAL_ACCESS | ORGANIZATION_INTERNAL_ACCESS

Obligatorio: sí

Sintaxis de la respuesta

HTTP/1.1 200 Content-type: application/json { "arn": "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.

arn

El ARN del analizador creado por la solicitud.

Tipo: cadena

Patrón: [^:]*:[^:]*:[^:]*:[^:]*:[^:]*:analyzer/.{1,255}

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

ConflictException

Un error de excepción de conflicto.

resourceId

El ID del recurso.

resourceType

El tipo de recurso.

Código de estado HTTP: 409

InternalServerException

Error interno de servicio

retryAfterSeconds

Los segundos de espera para volver a intentarlo.

Código de estado HTTP: 500

ServiceQuotaExceededException

Se produjo un error en la cotización del servicio.

resourceId

El ID del recurso.

resourceType

El tipo de recurso.

Código de estado HTTP: 402

ThrottlingException

Error superado el 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: