Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Risoluzione dei problemi

Questa sezione fornisce indicazioni per la risoluzione dei problemi comuni relativi a Transform custom. AWS

Posizioni dei log

AWS Transform CLI mantiene i log nelle seguenti posizioni:

Registri delle conversazioni:

Linux and macOS

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

Windows

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

Questi registri contengono la cronologia completa delle conversazioni per il debug di specifiche esecuzioni di trasformazione.

Registri di Subagent:

Linux and macOS

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

Windows

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

Questi registri contengono l'output dei subagenti generati dall'agente principale durante le trasformazioni. Non è necessario gestire direttamente i subagenti.

Registri di debug per sviluppatori:

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

Questi registri forniscono informazioni dettagliate sulle operazioni e sugli errori della CLI. Ogni file di registro ha un limite di 5 MB prima del rollover. In questa directory possono essere presenti più registri di debug, ad esempio debug1.log e debug2.log.

Problemi comuni

Problemi di installazione:

Se l'installazione fallisce, assicurati di avere installato Node.js 22 o versioni successive:

node --version

Node.js Scaricala da https://nodejs.org/en/download se necessario.

Problemi di autenticazione:

Verifica che AWS le tue credenziali siano configurate correttamente:

aws sts get-caller-identity

Assicurati che il tuo utente o ruolo IAM disponga delle transform-custom:* autorizzazioni richieste.

Problemi di connettività di rete:

Se riscontri errori di connessione, verifica l'accesso alla rete agli endpoint richiesti:

Se lavori in un ambiente con restrizioni Internet, aggiorna le regole del firewall per consentire questi URL.

Problemi di configurazione della regione:

Se riscontri errori relativi alla regione:

Problemi con Git:

Assicurati che Git sia installato e che il tuo repository sia sotto il controllo del codice sorgente git:

git --version
git status

AWS Transform custom richiede che i repository siano sotto il controllo del codice sorgente di git.

Problemi di esecuzione della trasformazione:

Se una trasformazione fallisce:

Problemi di ripresa della conversazione:

Se non riesci a riprendere una conversazione:

Ottenere supporto

Per ulteriore assistenza, visita AWS Support tramite la AWS console.

Quando apri un ticket di assistenza, includi:

Problemi di accesso a S3

Il servizio personalizzato AWS Transform fornisce URL prefirmati S3 per facilitare il caricamento e il download dei computer client dei file di trasformazione potenzialmente grandi. to/from Ciò significa che non solo la CLI interagisce con gli endpoint del servizio AWS Transform, ma interagisce anche con gli endpoint del servizio S3. Queste interazioni utilizzano URL prefirmati, quindi le credenziali IAM del cliente non richiedono alcuna autorizzazione S3, ma a volte le configurazioni del server proxy del computer locale e le policy degli endpoint VPC S3 della rete possono limitare questo traffico.

Esamina i messaggi di errore più dettagliati Posizioni dei log per aiutare a causare eventuali errori degli strumenti o negare l'accesso a S3 in relazione al download e al caricamento dei file di trasformazione.

Se utilizzi un VPN/Proxy server che sfrutta le variabili di no_proxy ambiente https_proxy e, ad esempio, prendi in considerazione l'aggiunta dei seguenti valori al valore della variabile di no_proxy ambiente per aggirare il proxy per gli endpoint dei servizi personalizzati S3 e 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"

Se utilizzi un account AWS PrivateLink per Amazon S3 nel tuo VPC, è possibile che sia stata definita una politica per limitare il traffico S3. Assicurati che la tua policy sugli endpoint VPC S3 GetObject consenta PutObject e operi per i bucket di proprietà AWS del servizio personalizzato Transform. Ciò può essere ottenuto aggiungendo la seguente dichiarazione alla policy degli endpoint VPC:

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

DenyLe dichiarazioni esplicite nelle policy hanno la precedenza sulle dichiarazioni. Allow Consulta le policy degli endpoint VPC di S3 Deny per le dichiarazioni che potrebbero limitare l'accesso.