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

Esta sección proporciona orientación para solucionar problemas comunes con Transform custom. AWS

Registrar ubicaciones

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

Registros de conversaciones:

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 transformaciones 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 gestionar 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 transferirse. 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 Node.js 22 o una versión posterior instalada:

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 de la red a los puntos finales necesarios:

Si trabajas en un entorno con acceso restringido a Internet, actualiza las reglas del firewall para incluir estas URL en una lista de direcciones URL permitidas.

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 una transformación falla:

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

Si no puedes reanudar una conversación:

Cómo obtener soporte

Para obtener asistencia adicional, visita AWS Support through the AWS Console.

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 de gran tamaño 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 de su cliente no requieren ningún permiso de S3, pero a veces las configuraciones del servidor proxy de su máquina local y las políticas de punto final de VPC de S3 de su red pueden restringir este tráfico.

Examine los mensajes de error más detallados Registrar ubicaciones para ayudar a identificar la causa de cualquier fallo en las herramientas o la denegación del 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 las variables de entorno, considere la posibilidad de añadir los siguientes valores al valor de la variable de no_proxy entorno para evitar el proxy de los puntos finales de los servicios personalizados de S3 y AWS Transform, por ejemplo:

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 finales de VPC de S3 permita GetObject y PutObject opere para los buckets propiedad del servicio personalizado de AWS Transform. Esto se puede lograr añadiendo la siguiente declaración a la política de puntos finales 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. Consulte las políticas de puntos finales de VPC de S3 para ver las Deny afirmaciones que puedan restringir el acceso.