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.

Resolución de problemas

En esta sección se proporciona orientación para la solución de problemas comunes con Transform custom. AWS

Ubicaciones de registro

AWS La CLI de Transform mantiene los registros en las siguientes ubicaciones:

Registros de conversación:

Linux and macOS

~/.aws/atx/custom/<conversation_id>/logs/<timestamp>-conversation.log

Windows

%USERPROFILE%\.aws\atx\custom\<conversation_id>\logs\<timestamp>-conversation.log

Estos registros contienen el historial completo de conversaciones para depurar ejecuciones de transformación específicas.

Registros de subagentes:

Linux and macOS

~/.aws/atx/custom/<conversation_id>/logs/subagents/<name>.log

Windows

%USERPROFILE%\.aws\atx\custom\<conversation_id>\logs\subagents\<name>.log

Estos registros contienen los resultados de los subagentes que el agente principal genera durante las transformaciones. No es necesario administrar los subagentes directamente.

Registros de depuración de desarrolladores:

Linux and macOS

~/.aws/atx/logs/debug*.log
~/.aws/atx/logs/error.log

Windows

%USERPROFILE%\.aws\atx\logs\debug*.log
%USERPROFILE%\.aws\atx\logs\error.log

Estos registros proporcionan información detallada sobre las operaciones y los errores de la CLI. Cada archivo de registro tiene un límite de 5 MB antes de que se renueve. Es posible que haya varios registros de depuración en este directorio, como debug1.log y debug2.log.

Problemas comunes

Problemas de instalación:

Si la instalación falla, asegúrese de tener instalada la versión Node.js 22 o posterior:

node --version

Node.js Descárguelo desde https://nodejs.org/en/download si es necesario.

Problemas de autenticación:

Compruebe que sus AWS credenciales estén configuradas correctamente:

aws sts get-caller-identity

Asegúrese de que su usuario o rol de IAM tenga los transform-custom:* permisos necesarios.

Problemas de conectividad de red:

Si se producen errores de conexión, compruebe el acceso a la red a los puntos finales necesarios:

Si trabaja en un entorno con acceso restringido a Internet, actualice las reglas del firewall para incluir estas URL en la lista de permitidos.

Problemas de configuración regional:

Si encuentra errores relacionados con la región:

Problemas con Git:

Asegúrate de que Git esté instalado y de que tu repositorio esté bajo el control de código fuente de git:

git --version
git status

AWS Transform custom requiere que los repositorios estén bajo el control de código fuente de git.

Problemas de ejecución de la transformación:

Si se produce un error en una transformación:

Problemas con la reanudación de la conversación:

Si no puedes reanudar una conversación:

Cómo obtener soporte

Para obtener ayuda adicional, visite el servicio de AWS asistencia a través de la AWS consola.

Al abrir un ticket de soporte, incluye:

Problemas de acceso a S3

El servicio personalizado AWS Transform vende las URL prefirmadas de S3 para facilitar la carga y descarga de los archivos de transformación que pueden ser grandes en las máquinas cliente. to/from Esto significa que la CLI no solo interactúa con los puntos finales del servicio AWS Transform, sino que también interactúa con los puntos finales del servicio S3. Estas interacciones utilizan URL prefirmadas, por lo que las credenciales de IAM del cliente no requieren ningún permiso de S3, pero a veces las configuraciones del servidor proxy de la máquina local y las políticas de punto final de la VPC de S3 de la red pueden restringir este tráfico.

Consulte esta sección Ubicaciones de registro para ver mensajes de error más detallados que ayuden a solucionar los fallos de las herramientas o la denegación de acceso a S3 relacionados con la descarga y la carga de archivos de transformación.

Si utiliza un VPN/Proxy servidor que aprovecha las variables de no_proxy entorno https_proxy y, por ejemplo, considere añadir los siguientes valores al valor de la variable de no_proxy entorno para evitar el uso de proxy en los puntos finales de los servicios personalizados de S3 y AWS Transform:

Linux and macOS

export no_proxy=.s3.amazonaws.com,transform-custom.<region>.api.aws

Windows (PowerShell)

$env:no_proxy=".s3.amazonaws.com,transform-custom.<region>.api.aws"

Si utiliza una AWS PrivateLink para Amazon S3 en su VPC, es posible que tenga una política definida para restringir el tráfico de S3. Asegúrese de que su política de puntos de conexión de VPC de S3 permita GetObject y PutObject opere en los buckets personalizados propiedad del servicio de AWS Transform. Para ello, añada la siguiente declaración a su política de puntos de conexión de la VPC:

{
    "Effect": "Allow",
    "Principal": "*",
    "Action": ["s3:PutObject","s3:GetObject"],
    "Resource": "arn:aws:s3:::aws-transform-custom-*/*"
}

DenyLas declaraciones explícitas en las políticas tienen prioridad sobre Allow las declaraciones. Consulta las políticas de terminales de la VPC de S3 para ver las Deny declaraciones que puedan estar restringiendo el acceso.