Sintassi della richiesta URIParametri della richiesta Corpo della richiesta Sintassi della risposta Elementi di risposta Errori Vedi anche

Avviso di fine del supporto: il 10 settembre 2025, AWS interromperà il supporto per. AWS RoboMaker Dopo il 10 settembre 2025, non potrai più accedere alla AWS RoboMaker console o alle risorse. AWS RoboMaker Per ulteriori informazioni sulla transizione AWS Batch verso l'esecuzione di simulazioni containerizzate, consulta questo post del blog.

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à.

DescribeSimulationJob

Importante

Avviso di fine del supporto: il 10 settembre 2025, AWS verrà interrotto il supporto per. AWS RoboMaker Dopo il 10 settembre 2025, non potrai più accedere alla AWS RoboMaker console o alle risorse. AWS RoboMaker Per ulteriori informazioni sulla transizione AWS Batch verso l'esecuzione di simulazioni containerizzate, consulta questo post del blog.

Descrive un lavoro di simulazione.

Sintassi della richiesta


POST /describeSimulationJob HTTP/1.1
Content-type: application/json

{
   "job": "string"
}

URIParametri della richiesta

La richiesta non utilizza alcun URI parametro.

Corpo della richiesta

La richiesta accetta i seguenti dati nel JSON formato.

job

L'Amazon Resource Name (ARN) del lavoro di simulazione da descrivere.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1224.

Modello: arn:.*

Campo obbligatorio: sì

Sintassi della risposta


HTTP/1.1 200
Content-type: application/json

{
   "arn": "string",
   "clientRequestToken": "string",
   "compute": { 
      "computeType": "string",
      "gpuUnitLimit": number,
      "simulationUnitLimit": number
   },
   "dataSources": [ 
      { 
         "destination": "string",
         "name": "string",
         "s3Bucket": "string",
         "s3Keys": [ 
            { 
               "etag": "string",
               "s3Key": "string"
            }
         ],
         "type": "string"
      }
   ],
   "failureBehavior": "string",
   "failureCode": "string",
   "failureReason": "string",
   "iamRole": "string",
   "lastStartedAt": number,
   "lastUpdatedAt": number,
   "loggingConfig": { 
      "recordAllRosTopics": boolean
   },
   "maxJobDurationInSeconds": number,
   "name": "string",
   "networkInterface": { 
      "networkInterfaceId": "string",
      "privateIpAddress": "string",
      "publicIpAddress": "string"
   },
   "outputLocation": { 
      "s3Bucket": "string",
      "s3Prefix": "string"
   },
   "robotApplications": [ 
      { 
         "application": "string",
         "applicationVersion": "string",
         "launchConfig": { 
            "command": [ "string" ],
            "environmentVariables": { 
               "string" : "string" 
            },
            "launchFile": "string",
            "packageName": "string",
            "portForwardingConfig": { 
               "portMappings": [ 
                  { 
                     "applicationPort": number,
                     "enableOnPublicIp": boolean,
                     "jobPort": number
                  }
               ]
            },
            "streamUI": boolean
         },
         "tools": [ 
            { 
               "command": "string",
               "exitBehavior": "string",
               "name": "string",
               "streamOutputToCloudWatch": boolean,
               "streamUI": boolean
            }
         ],
         "uploadConfigurations": [ 
            { 
               "name": "string",
               "path": "string",
               "uploadBehavior": "string"
            }
         ],
         "useDefaultTools": boolean,
         "useDefaultUploadConfigurations": boolean
      }
   ],
   "simulationApplications": [ 
      { 
         "application": "string",
         "applicationVersion": "string",
         "launchConfig": { 
            "command": [ "string" ],
            "environmentVariables": { 
               "string" : "string" 
            },
            "launchFile": "string",
            "packageName": "string",
            "portForwardingConfig": { 
               "portMappings": [ 
                  { 
                     "applicationPort": number,
                     "enableOnPublicIp": boolean,
                     "jobPort": number
                  }
               ]
            },
            "streamUI": boolean
         },
         "tools": [ 
            { 
               "command": "string",
               "exitBehavior": "string",
               "name": "string",
               "streamOutputToCloudWatch": boolean,
               "streamUI": boolean
            }
         ],
         "uploadConfigurations": [ 
            { 
               "name": "string",
               "path": "string",
               "uploadBehavior": "string"
            }
         ],
         "useDefaultTools": boolean,
         "useDefaultUploadConfigurations": boolean,
         "worldConfigs": [ 
            { 
               "world": "string"
            }
         ]
      }
   ],
   "simulationTimeMillis": number,
   "status": "string",
   "tags": { 
      "string" : "string" 
   },
   "vpcConfig": { 
      "assignPublicIp": boolean,
      "securityGroups": [ "string" ],
      "subnets": [ "string" ],
      "vpcId": "string"
   }
}

Elementi di risposta

Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

arn

L'Amazon Resource Name (ARN) del processo di simulazione.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 1224.

Modello: arn:.*

clientRequestToken

Identificatore univoco con distinzione tra maiuscole e minuscole fornito per garantire l'idempotenza della richiesta.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.

Modello: [a-zA-Z0-9_\-=]*

compute

Informazioni di calcolo per il lavoro di simulazione.

Tipo: oggetto ComputeResponse

dataSources

Le fonti di dati per il lavoro di simulazione.

Tipo: matrice di oggetti DataSource

failureBehavior

Il comportamento in caso di errore del lavoro di simulazione.

Tipo: stringa

Valori validi: Fail | Continue

failureCode

Il codice di errore del processo di simulazione in caso di esito negativo:

InternalServiceError: Errore interno del servizio.
RobotApplicationCrash: L'applicazione robotica è stata chiusa in modo anomalo.
SimulationApplicationCrash: L'applicazione di simulazione è stata chiusa in modo anomalo.
BadPermissionsRobotApplication: Impossibile scaricare il pacchetto di applicazioni Robot.
BadPermissionsSimulationApplication: Impossibile scaricare il pacchetto di applicazioni di simulazione.
BadPermissionsUscita S3: Impossibile pubblicare gli output nel bucket S3 fornito dal cliente.
BadPermissionsCloudwatchLogs: Impossibile pubblicare i log sulla risorsa Logs fornita dal cliente. CloudWatch
SubnetIpLimitExceeded: Limite IP di sottorete superato.
ENILimitExceeded: ENIlimite superato.
BadPermissionsUserCredentials: Impossibile utilizzare il ruolo fornito.
InvalidBundleRobotApplication: Il pacchetto Robot non può essere estratto (formato non valido, errore di raggruppamento o altro problema).
InvalidBundleSimulationApplication: Il pacchetto di simulazione non può essere estratto (formato non valido, errore di raggruppamento o altro problema).
RobotApplicationVersionMismatchedEtag: Etag for RobotApplication non corrisponde al valore durante la creazione della versione.
SimulationApplicationVersionMismatchedEtag: Etag for non SimulationApplication corrisponde al valore durante la creazione della versione.

Tipo: stringa

failureReason

Dettagli sul motivo per cui il processo di simulazione non è riuscito. Per ulteriori informazioni sulla risoluzione dei problemi, vedere Risoluzione dei problemi.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 0. La lunghezza massima è 1024 caratteri.

Modello: .*

iamRole

Il IAM ruolo che consente all'istanza di simulazione di chiamare per AWS APIs conto dell'utente i parametri specificati nelle politiche associate.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.

Modello: arn:aws:iam::\w+:role/.*

lastStartedAt

L'ora, in millisecondi dall'epoca, in cui il processo di simulazione è stato avviato l'ultima volta.

Tipo: Timestamp

lastUpdatedAt

L'ora, in millisecondi dall'epoca, in cui il lavoro di simulazione è stato aggiornato l'ultima volta.

Tipo: Timestamp

loggingConfig

La configurazione della registrazione.

Tipo: oggetto LoggingConfig

maxJobDurationInSeconds

La durata massima del lavoro in secondi. Il valore deve essere inferiore o uguale a 8 giorni (691.200 secondi).

Tipo: long

name

Il nome del processo di simulazione.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.

Modello: [a-zA-Z0-9_\-]*

networkInterface

Le informazioni sull'interfaccia di rete per il lavoro di simulazione.

Tipo: oggetto NetworkInterface

outputLocation

Posizione dei file di output generati dal lavoro di simulazione.

Tipo: oggetto OutputLocation

robotApplications

Un elenco di applicazioni robotiche.

Tipo: matrice di oggetti RobotApplicationConfig

Membri dell'array: numero minimo di 1 elemento.

simulationApplications

Un elenco di applicazioni di simulazione.

Tipo: matrice di oggetti SimulationApplicationConfig

Membri dell'array: numero minimo di 1 elemento.

simulationTimeMillis

La durata dell'esecuzione del processo di simulazione in millisecondi.

Tipo: long

status

Lo stato del lavoro di simulazione.

Tipo: stringa

tags

L'elenco di tutti i tag aggiunti al lavoro di simulazione specificato.

Tipo: mappatura stringa a stringa

Voci sulla mappa: numero minimo di 0 elementi. Numero massimo di 50 item.

Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.

Modello di chiave:[a-zA-Z0-9 _.\-\/+=:]*

Limiti di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.

Modello di valore: [a-zA-Z0-9 _.\-\/+=:]*

vpcConfig

La VPC configurazione.

Tipo: oggetto VPCConfigResponse

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

InternalServerException

AWS RoboMaker ha riscontrato un problema di servizio. Riprova la chiamata.

HTTPCodice di stato: 500

InvalidParameterException

Un parametro specificato in una richiesta non è valido, non è supportato o non può essere utilizzato. Il messaggio restituito fornisce una spiegazione del valore di errore.

HTTPCodice di stato: 400

ResourceNotFoundException

La risorsa specificata non esiste.

HTTPCodice di stato: 400

ThrottlingException

AWS RoboMaker non è temporaneamente in grado di elaborare la richiesta. Riprova la chiamata.

HTTPCodice di stato: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue:

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

DescribeSimulationApplication

DescribeSimulationJobBatch