Esta documentação é somente para a versão 1 da AWS CLI. Para obter a documentação relacionada à AWS CLI versão 2, consulte o Guia do usuário da versão 2.
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com o AWS RoboMaker.
Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
Tópicos
Ações
O código de exemplo a seguir mostra como usar batch-describe-simulation-job
.
- AWS CLI
-
Descrever em lote os trabalhos de simulação
O exemplo
batch-describe-simulation-job
a seguir recupera detalhes para os três trabalhos de simulação especificados.Comando:
aws robomaker batch-describe-simulation-job \ --job
arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-66bbb3gpxm8x
arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-p0cpdrrwng2n
arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-g8h6tglmblgw
Saída:
{ "jobs": [ { "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-66bbb3gpxm8x", "status": "Completed", "lastUpdatedAt": 1548959178.0, "failureBehavior": "Continue", "clientRequestToken": "6020408e-b05c-4310-9f13-4ed71c5221ed", "outputLocation": { "s3Bucket": "awsrobomakerobjecttracker-111111111-bundlesbucket-2lk584kiq1oa", "s3Prefix": "output" }, "maxJobDurationInSeconds": 3600, "simulationTimeMillis": 0, "iamRole": "arn:aws:iam::111111111111:role/AWSRoboMakerObjectTracker-154895-SimulationJobRole-14D5ASA7PQE3A", "simulationApplications": [ { "application": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/AWSRoboMakerObjectTracker-1548959046124_NPvyfcatq/1548959170096", "applicationVersion": "$LATEST", "launchConfig": { "packageName": "object_tracker_simulation", "launchFile": "local_training.launch", "environmentVariables": { "MARKOV_PRESET_FILE": "object_tracker.py", "MODEL_S3_BUCKET": "awsrobomakerobjecttracker-111111111-bundlesbucket-2lk584kiq1oa", "MODEL_S3_PREFIX": "model-store", "ROS_AWS_REGION": "us-west-2" } } } ], "tags": {}, "vpcConfig": { "subnets": [ "subnet-716dd52a", "subnet-43c22325", "subnet-3f526976" ], "securityGroups": [ "sg-3fb40545" ], "vpcId": "vpc-99895eff", "assignPublicIp": true } }, { "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-p0cpdrrwng2n", "status": "Completed", "lastUpdatedAt": 1548168817.0, "failureBehavior": "Continue", "clientRequestToken": "e4a23e75-f9a7-411d-835f-21881c82c58b", "outputLocation": { "s3Bucket": "awsrobomakercloudwatch-111111111111-bundlesbucket-14e5s9jvwtmv7", "s3Prefix": "output" }, "maxJobDurationInSeconds": 3600, "simulationTimeMillis": 0, "iamRole": "arn:aws:iam::111111111111:role/AWSRoboMakerCloudWatch-154766341-SimulationJobRole-G0OBWTQ8YBG6", "robotApplications": [ { "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/AWSRoboMakerCloudWatch-1547663411642_NZbpqEJ3T/1547663517377", "applicationVersion": "$LATEST", "launchConfig": { "packageName": "cloudwatch_robot", "launchFile": "await_commands.launch", "environmentVariables": { "LAUNCH_ID": "1548168752173", "ROS_AWS_REGION": "us-west-2" } } } ], "simulationApplications": [ { "application": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/AWSRoboMakerCloudWatch-1547663411642_0LIt6D1h6/1547663521470", "applicationVersion": "$LATEST", "launchConfig": { "packageName": "cloudwatch_simulation", "launchFile": "bookstore_turtlebot_navigation.launch", "environmentVariables": { "LAUNCH_ID": "1548168752173", "ROS_AWS_REGION": "us-west-2", "TURTLEBOT3_MODEL": "waffle_pi" } } } ], "tags": {}, "vpcConfig": { "subnets": [ "subnet-716dd52a", "subnet-43c22325", "subnet-3f526976" ], "securityGroups": [ "sg-3fb40545" ], "vpcId": "vpc-99895eff", "assignPublicIp": true } }, { "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-g8h6tglmblgw", "status": "Canceled", "lastUpdatedAt": 1546543442.0, "failureBehavior": "Fail", "clientRequestToken": "d796bbb4-2a2c-1abc-f2a9-0d9e547d853f", "outputLocation": { "s3Bucket": "sample-bucket", "s3Prefix": "SimulationLog_115490482698" }, "maxJobDurationInSeconds": 28800, "simulationTimeMillis": 0, "iamRole": "arn:aws:iam::111111111111:role/RoboMakerSampleTheFirst", "robotApplications": [ { "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/RoboMakerHelloWorldRobot/1546541208251", "applicationVersion": "$LATEST", "launchConfig": { "packageName": "hello_world_robot", "launchFile": "rotate.launch" } } ], "simulationApplications": [ { "application": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/RoboMakerHelloWorldSimulation/1546541198985", "applicationVersion": "$LATEST", "launchConfig": { "packageName": "hello_world_simulation", "launchFile": "empty_world.launch" } } ], "tags": {} } ], "unprocessedJobs": [] }
-
Para ver detalhes da API, consulte BatchDescribeSimulationJob
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar cancel-simulation-job
.
- AWS CLI
-
Cancelar um trabalho de simulação
O exemplo
cancel-simulation-job
a seguir cancela o trabalho de simulação especificado.aws robomaker cancel-simulation-job \ --job
arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-66bbb3gpxm8x
-
Para ver detalhes da API, consulte CancelSimulationJob
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar create-deployment-job
.
- AWS CLI
-
Criar um trabalho de implantação
Este exemplo cria um trabalho de implantação para a frota MyFleet. Ela inclui uma variável de ambiente chamada “AMBIENTE”. Ele também anexa uma tag chamada “região”.
Comando:
aws robomaker create-deployment-job --deployment-config
concurrentDeploymentPercentage=20,failureThresholdPercentage=25
--fleetarn:aws:robomaker:us-west-2:111111111111:deployment-fleet/Trek/1539894765711
--tagsRegion=West
--deployment-application-configsapplication=arn:aws:robomaker:us-west-2:111111111111:robot-application/RoboMakerVoiceInteractionRobot/1546537110575,applicationVersion=1,launchConfig={environmentVariables={ENVIRONMENT=Beta},launchFile=await_commands.launch,packageName=voice_interaction_robot}
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/sim-0974h36s4v0t", "fleet": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1539894765711", "status": "Pending", "deploymentApplicationConfigs": [ { "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/RoboMakerVoiceInteractionRobot/1546537110575", "applicationVersion": "1", "launchConfig": { "packageName": "voice_interaction_robot", "launchFile": "await_commands.launch", "environmentVariables": { "ENVIRONMENT": "Beta" } } } ], "createdAt": 1550770236.0, "deploymentConfig": { "concurrentDeploymentPercentage": 20, "failureThresholdPercentage": 25 }, "tags": { "Region": "West" } }
-
Para ver detalhes da API, consulte CreateDeploymentJob
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar create-fleet
.
- AWS CLI
-
Criar uma frota
Este exemplo cria uma frota. Ele anexa uma tag chamada região.
Comando:
aws robomaker create-fleet --name
MyFleet
--tagsRegion=East
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyOtherFleet/1550771394395", "name": "MyFleet", "createdAt": 1550771394.0, "tags": { "Region": "East" } }
-
Para ver detalhes da API, consulte CreateFleet
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar create-robot-application-version
.
- AWS CLI
-
Criar uma versão da aplicação de robô
Cria uma versão de uma aplicação de robô.
Comando:
aws robomaker create-robot-application-version --application
arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551201873931
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551201873931", "name": "MyRobotApplication", "version": "1", "sources": [ { "s3Bucket": "amzn-s3-demo-bucket", "s3Key": "my-robot-application.tar.gz", "etag": "f8cf5526f1c6e7b3a72c3ed3f79c5493-70", "architecture": "ARMHF" } ], "robotSoftwareSuite": { "name": "ROS", "version": "Kinetic" }, "lastUpdatedAt": 1551201873.0, "revisionId": "9986bb8d-a695-4ab4-8810-9f4a74d1aa00" "tags": {} }
-
Para ver detalhes da API, consulte CreateRobotApplicationVersion
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar create-robot-application
.
- AWS CLI
-
Criar uma aplicação de robô
Este exemplo cria uma aplicação de robô.
Comando:
aws robomaker create-robot-application --name
MyRobotApplication
--sourcess3Bucket=amzn-s3-demo-bucket,s3Key=my-robot-application.tar.gz,architecture=X86_64
--robot-software-suitename=ROS,version=Kinetic
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551201873931", "name": "MyRobotApplication", "version": "$LATEST", "sources": [ { "s3Bucket": "amzn-s3-demo-bucket", "s3Key": "my-robot-application.tar.gz", "architecture": "ARMHF" } ], "robotSoftwareSuite": { "name": "ROS", "version": "Kinetic" }, "lastUpdatedAt": 1551201873.0, "revisionId": "1f3cb539-9239-4841-a656-d3efcffa07e1", "tags": {} }
-
Para ver detalhes da API, consulte CreateRobotApplication
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar create-robot
.
- AWS CLI
-
Criar um robô
Este exemplo cria um robô. Ele usa a arquitetura ARMHF. Ele também anexa uma tag chamada região.
Comando:
aws robomaker create-robot --name
MyRobot
--architectureARMHF
--greengrass-group-id0f728a3c-7dbf-4a3e-976d-d16a8360caba
--tagsRegion=East
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1550772324398", "name": "MyRobot", "createdAt": 1550772325.0, "greengrassGroupId": "0f728a3c-7dbf-4a3e-976d-d16a8360caba", "architecture": "ARMHF", "tags": { "Region": "East" } }
-
Para ver detalhes da API, consulte CreateRobot
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar create-simulation-application-version
.
- AWS CLI
-
Criar uma versão da aplicação de simulação
Cria uma versão de uma aplicação de robô.
Comando:
aws robomaker create-simulation-application-version --application
arn:aws:robomaker:us-west-2:111111111111:robot-application/MySimulationApplication/1551203427605
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/MyRobotApplication/1551203427605", "name": "MyRobotApplication", "version": "1", "sources": [ { "s3Bucket": "amzn-s3-demo-bucket", "s3Key": "my-simulation-application.tar.gz", "etag": "00d8a94ff113856688c4fce618ae0f45-94", "architecture": "X86_64" } ], "simulationSoftwareSuite": { "name": "Gazebo", "version": "7" }, "robotSoftwareSuite": { "name": "ROS", "version": "Kinetic" }, "renderingEngine": { "name": "OGRE", "version": "1.x" }, "lastUpdatedAt": 1551203853.0, "revisionId": "ee753e53-519c-4d37-895d-65e79bcd1914", "tags": {} }
-
Para ver detalhes da API, consulte CreateSimulationApplicationVersion
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar create-simulation-application
.
- AWS CLI
-
Criar uma aplicação de simulação
Cria uma aplicação de simulação.
Comando:
aws robomaker create-simulation-application --name
MyRobotApplication
--sourcess3Bucket=amzn-s3-demo-bucket,s3Key=my-simulation-application.tar.gz,architecture=ARMHF
--robot-software-suitename=ROS,version=Kinetic
--simulation-software-suitename=Gazebo,version=7
--rendering-enginename=OGRE,version=1.x
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/MyRobotApplication/1551203301792", "name": "MyRobotApplication", "version": "$LATEST", "sources": [ { "s3Bucket": "amzn-s3-demo-bucket", "s3Key": "my-simulation-application.tar.gz", "architecture": "X86_64" } ], "simulationSoftwareSuite": { "name": "Gazebo", "version": "7" }, "robotSoftwareSuite": { "name": "ROS", "version": "Kinetic" }, "renderingEngine": { "name": "OGRE", "version": "1.x" }, "lastUpdatedAt": 1551203301.0, "revisionId": "ee753e53-519c-4d37-895d-65e79bcd1914", "tags": {} }
-
Para ver detalhes da API, consulte CreateSimulationApplication
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar create-simulation-job
.
- AWS CLI
-
Ciar um trabalho de simulação
Este exemplo cria um trabalho de simulação. Ele usa uma aplicação de robô e uma aplicação de simulação.
Comando:
aws robomaker create-simulation-job --max-job-duration-in-seconds
3600
--iam-rolearn:aws:iam::111111111111:role/AWSRoboMakerCloudWatch-154766341-SimulationJobRole-G0OBWTQ8YBG6
--robot-applicationsapplication=arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821,launchConfig={packageName=hello_world_robot,launchFile=rotate.launch}
--simulation-applicationsapplication=arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605,launchConfig={packageName=hello_world_simulation,launchFile=empty_world.launch}
--tagsRegion=North
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-w7m68wpr05h8", "status": "Pending", "lastUpdatedAt": 1551213837.0, "failureBehavior": "Fail", "clientRequestToken": "b283ccce-e468-43ee-8642-be76a9d69f15", "maxJobDurationInSeconds": 3600, "simulationTimeMillis": 0, "iamRole": "arn:aws:iam::111111111111:role/MySimulationRole", "robotApplications": [ { "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821", "applicationVersion": "$LATEST", "launchConfig": { "packageName": "hello_world_robot", "launchFile": "rotate.launch" } } ], "simulationApplications": [ { "application": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605", "applicationVersion": "$LATEST", "launchConfig": { "packageName": "hello_world_simulation", "launchFile": "empty_world.launch" } } ], "tags": { "Region": "North" } }
-
Para ver detalhes da API, consulte CreateSimulationJob
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar delete-fleet
.
- AWS CLI
-
Excluir uma frota
Este exemplo exclui uma frota.
Comando:
aws robomaker delete-fleet --fleet
arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1550771394395
-
Para ver detalhes da API, consulte DeleteFleet
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar delete-robot-application
.
- AWS CLI
-
Excluir uma aplicação de robô
Este exemplo exclui uma aplicação de robô.
Comando:
aws robomaker delete-robot-application --application
arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821
-
Para ver detalhes da API, consulte DeleteRobotApplication
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar delete-robot
.
- AWS CLI
-
Excluir um robô
Este exemplo exclui um robô.
Comando:
aws robomaker delete-robot --robot
arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1540829698778
-
Para ver detalhes da API, consulte DeleteRobot
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar delete-simulation-application
.
- AWS CLI
-
Excluir uma aplicação de simulação
Este exemplo exclui uma aplicação de simulação.
Comando:
aws robomaker delete-simulation-application --application
arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605
-
Para ver detalhes da API, consulte DeleteSimulationApplication
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar deregister-robot
.
- AWS CLI
-
Cancelar o registro de um robô em uma frota
Este exemplo cancela o registro de um robô em uma frota.
Comando:
aws robomaker deregister-robot --fleet
arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1550771358907
--robotarn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1550772324398
Saída:
{ "fleet": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1550771358907", "robot": "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1550772324398" }
-
Para ver detalhes da API, consulte DeregisterRobot
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar describe-deployment-job
.
- AWS CLI
-
Descrever um trabalho de implantação
O exemplo
describe-deployment-job
a seguir recupera os detalhes sobre o trabalho de implantação especificado.aws robomaker describe-deployment-job \ --job
arn:aws:robomaker:us-west-2:111111111111:deployment-job/deployment-xl8qssl6pbcn
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/deployment-xl8qssl6pbcn", "fleet": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/Trek/1539894765711", "status": "InProgress", "deploymentConfig": { "concurrentDeploymentPercentage": 20, "failureThresholdPercentage": 25 }, "deploymentApplicationConfigs": [ { "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/RoboMakerHelloWorldRobot/1546541208251", "applicationVersion": "1", "launchConfig": { "packageName": "hello_world_robot", "launchFile": "rotate.launch" } } ], "createdAt": 1551218369.0, "robotDeploymentSummary": [ { "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1540834232469", "deploymentStartTime": 1551218376.0, "status": "Deploying", "progressDetail": {} } ], "tags": {} }
-
Para ver detalhes da API, consulte DescribeDeploymentJob
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar describe-fleet
.
- AWS CLI
-
Descrever uma frota
O exemplo
describe-fleet
a seguir recupera os detalhes da frota especificada.aws robomaker describe-fleet \ --fleet
arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1550771358907
Saída:
{ "name": "MyFleet", "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1539894765711", "robots": [ { "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1540834232469", "createdAt": 1540834232.0 }, { "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/MyOtherRobot/1540829698778", "createdAt": 1540829698.0 } ], "createdAt": 1539894765.0, "lastDeploymentStatus": "Succeeded", "lastDeploymentJob": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/deployment-xl8qssl6pbcn", "lastDeploymentTime": 1551218369.0, "tags": {} }
-
Para ver detalhes da API, consulte DescribeFleet
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar describe-robot-application
.
- AWS CLI
-
Descrever uma aplicação de robô
Este exemplo descreve uma aplicação de robô.
Comando:
aws robomaker describe-robot-application --application
arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821", "name": "MyRobotApplication", "version": "$LATEST", "sources": [ { "s3Bucket": "amzn-s3-demo-bucket", "s3Key": "my-robot-application.tar.gz", "architecture": "X86_64" } ], "robotSoftwareSuite": { "name": "ROS", "version": "Kinetic" }, "revisionId": "e72efe0d-f44f-4333-b604-f6fa5c6bb50b", "lastUpdatedAt": 1551203485.0, "tags": {} }
-
Para ver detalhes da API, consulte DescribeRobotApplication
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar describe-robot
.
- AWS CLI
-
Descrever um robô
Este exemplo descreve um robô.
Comando:
aws robomaker describe-robot --robot
arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1550772324398
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1550772324398", "name": "MyRobot", "status": "Available", "greengrassGroupId": "0f728a3c-7dbf-4a3e-976d-d16a8360caba", "createdAt": 1550772325.0, "architecture": "ARMHF", "tags": { "Region": "East" } }
-
Para ver detalhes da API, consulte DescribeRobot
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar describe-simulation-application
.
- AWS CLI
-
Descrever uma aplicação de simulação
Este exemplo descreve uma aplicação de robô.
Comando:
aws robomaker describe-simulation-application --application
arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605", "name": "MySimulationApplication", "version": "$LATEST", "sources": [ { "s3Bucket": "amzn-s3-demo-bucket", "s3Key": "my-simulation-application.tar.gz", "architecture": "X86_64" } ], "simulationSoftwareSuite": { "name": "Gazebo", "version": "7" }, "robotSoftwareSuite": { "name": "ROS", "version": "Kinetic" }, "renderingEngine": { "name": "OGRE", "version": "1.x" }, "revisionId": "783674ab-b7b8-42d9-b01f-9373907987e5", "lastUpdatedAt": 1551203427.0, "tags": {} }
-
Para ver detalhes da API, consulte DescribeSimulationApplication
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar describe-simulation-job
.
- AWS CLI
-
Descrever um trabalho de simulação
Este exemplo descreve um trabalho de simulação.
Comando:
aws robomaker describe-simulation-job --job
arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-pql32v7pfjy6
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-pql32v7pfjy6", "status": "Running", "lastUpdatedAt": 1551219349.0, "failureBehavior": "Continue", "clientRequestToken": "a19ec4b5-e50d-3591-33da-c2e593c60615", "outputLocation": { "s3Bucket": "my-output-bucket", "s3Prefix": "output" }, "maxJobDurationInSeconds": 3600, "simulationTimeMillis": 0, "iamRole": "arn:aws:iam::111111111111:role/MySimulationRole", "robotApplications": [ { "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551206341136", "applicationVersion": "$LATEST", "launchConfig": { "packageName": "hello_world_robot", "launchFile": "rotate.launch" } } ], "simulationApplications": [ { "application": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551206347967", "applicationVersion": "$LATEST", "launchConfig": { "packageName": "hello_world_simulation", "launchFile": "empty_world.launch" } } ], "tags": {} }
-
Para ver detalhes da API, consulte DescribeSimulationJob
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar list-deployment-jobs
.
- AWS CLI
-
Listar tarefas de implantação
O exemplo
list-deployment-jobs
a seguir recupera uma lista de trabalhos de implantação.aws robomaker list-deployment-jobs
Saída:
{ "deploymentJobs": [ { "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/sim-6293szzm56rv", "fleet": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1539894765711", "status": "InProgress", "deploymentApplicationConfigs": [ { "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/HelloWorldRobot/1546537110575", "applicationVersion": "1", "launchConfig": { "packageName": "hello_world_robot", "launchFile": "rotate.launch", "environmentVariables": { "ENVIRONMENT": "Desert" } } } ], "deploymentConfig": { "concurrentDeploymentPercentage": 20, "failureThresholdPercentage": 25 }, "createdAt": 1550689373.0 }, { "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/deployment-4w4g69p25zdb", "fleet": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1539894765711", "status": "Pending", "deploymentApplicationConfigs": [ { "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/AWSRoboMakerHelloWorld-1544562726923_YGHM_sh5M/1544562822877", "applicationVersion": "1", "launchConfig": { "packageName": "fail", "launchFile": "fail" } } ], "deploymentConfig": { "concurrentDeploymentPercentage": 20, "failureThresholdPercentage": 25 }, "failureReason": "", "failureCode": "", "createdAt": 1544719763.0 } ] }
-
Para ver detalhes da API, consulte ListDeploymentJobs
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar list-fleets
.
- AWS CLI
-
Listar frotas
Este exemplo lista frotas. Serão devolvidas no máximo 20 frotas.
Comando:
aws robomaker list-fleets --max-items
20
Saída:
{ "fleetDetails": [ { "name": "Trek", "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1539894765711", "createdAt": 1539894765.0, "lastDeploymentStatus": "Failed", "lastDeploymentJob": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/deployment-4w4g69p25zdb", "lastDeploymentTime": 1544719763.0 } ] }
-
Para ver detalhes da API, consulte ListFleets
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar list-robot-applications
.
- AWS CLI
-
Listar aplicações de robô
Este exemplo lista aplicações de robôs. Os resultados são limitados a 20 aplicações de robôs.
Comando:
aws robomaker list-robot-applications --max-results
20
Saída:
{ "robotApplicationSummaries": [ { "name": "MyRobot", "arn": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobot/1546537110575", "version": "$LATEST", "lastUpdatedAt": 1546540372.0 }, { "name": "AnotherRobot", "arn": "arn:aws:robomaker:us-west-2:111111111111:robot-application/AnotherRobot/1546541208251", "version": "$LATEST", "lastUpdatedAt": 1546541208.0 }, { "name": "MySuperRobot", "arn": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MySuperRobot/1547663517377", "version": "$LATEST", "lastUpdatedAt": 1547663517.0 } ] }
-
Para ver detalhes da API, consulte ListRobotApplications
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar list-robots
.
- AWS CLI
-
Listar robôs
Este exemplo lista robôs. Serão devolvidas no máximo 20 frotas.
Comando:
aws robomaker list-robots --max-results
20
Saída:
{ "robots": [ { "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/Robot100/1544035373264", "name": "Robot100", "status": "Available", "createdAt": 1544035373.0, "architecture": "X86_64" }, { "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/Robot101/1542146976587", "name": "Robot101", "status": "Available", "createdAt": 1542146976.0, "architecture": "X86_64" }, { "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/Robot102/1540834232469", "name": "Robot102", "fleetArn": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/Trek/1539894765711", "status": "Available", "createdAt": 1540834232.0, "architecture": "X86_64", "lastDeploymentJob": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/deployment-jb007b75gl5f", "lastDeploymentTime": 1550689533.0 }, { "arn": "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1540829698778", "name": "MyRobot", "status": "Registered", "createdAt": 1540829698.0, "architecture": "X86_64" } ] }
-
Para ver detalhes da API, consulte ListRobots
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar list-simulation-applications
.
- AWS CLI
-
Listar aplicações de simulação
Este exemplo lista aplicações de simulação. Serão devolvidas no máximo 20 frotas.
Comando:
aws robomaker list-simulation-applications --max-results
20
Saída:
{ "simulationApplicationSummaries": [ { "name": "AWSRoboMakerObjectTracker-1548959046124_NPvyfcatq", "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/AWSRoboMakerObjectTracker-1548959046124_NPvyfcatq/1548959170096", "version": "$LATEST", "lastUpdatedAt": 1548959170.0 }, { "name": "RoboMakerHelloWorldSimulation", "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/RoboMakerHelloWorldSimulation/1546541198985", "version": "$LATEST", "lastUpdatedAt": 1546541198.0 }, { "name": "RoboMakerObjectTrackerSimulation", "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/RoboMakerObjectTrackerSimulation/1545846795615", "version": "$LATEST", "lastUpdatedAt": 1545847405.0 }, { "name": "RoboMakerVoiceInteractionSimulation", "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/RoboMakerVoiceInteractionSimulation/1546537100507", "version": "$LATEST", "lastUpdatedAt": 1546540352.0 }, { "name": "AWSRoboMakerCloudWatch-1547663411642_0LIt6D1h6", "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/AWSRoboMakerCloudWatch-1547663411642_0LIt6D1h6/1547663521470", "version": "$LATEST", "lastUpdatedAt": 1547663521.0 }, { "name": "AWSRoboMakerDeepRacer-1545848257672_1YZCaieQ-", "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/AWSRoboMakerDeepRacer-1545848257672_1YZCaieQ-/1545848370525", "version": "$LATEST", "lastUpdatedAt": 1545848370.0 } ] }
-
Para ver detalhes da API, consulte ListSimulationApplications
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar list-simulation-jobs
.
- AWS CLI
-
Listar trabalhos de simulação
Este exemplo lista trabalhos de simulação.
Comando:
aws robomaker list-simulation-jobs
Saída:
{ "simulationJobSummaries": [ { "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-66bbb3gpxm8x", "lastUpdatedAt": 1548959178.0, "status": "Completed", "simulationApplicationNames": [ "AWSRoboMakerObjectTracker-1548959046124_NPvyfcatq" ], "robotApplicationNames": [ null ] }, { "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-b27c4rkrtzcw", "lastUpdatedAt": 1543514088.0, "status": "Canceled", "simulationApplicationNames": [ "AWSRoboMakerPersonDetection-1543513948280_T8rHW2_lu" ], "robotApplicationNames": [ "AWSRoboMakerPersonDetection-1543513948280_EYaMT0mYb" ] }, { "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-51vxjbzy4q8t", "lastUpdatedAt": 1543508858.0, "status": "Canceled", "simulationApplicationNames": [ "AWSRoboMakerCloudWatch-1543504747391_lFF9ZQyx6" ], "robotApplicationNames": [ "AWSRoboMakerCloudWatch-1543504747391_axbYa3S3K" ] }, { "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-kgf1fqxflqbx", "lastUpdatedAt": 1543504862.0, "status": "Completed", "simulationApplicationNames": [ "AWSRoboMakerCloudWatch-1543504747391_lFF9ZQyx6" ], "robotApplicationNames": [ "AWSRoboMakerCloudWatch-1543504747391_axbYa3S3K" ] }, { "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-vw8lvh061nqt", "lastUpdatedAt": 1543441430.0, "status": "Completed", "simulationApplicationNames": [ "AWSRoboMakerHelloWorld-1543437372341__yb_Jg96l" ], "robotApplicationNames": [ "AWSRoboMakerHelloWorld-1543437372341_lNbmKHvs9" ] }, { "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-txy5ypxmhz84", "lastUpdatedAt": 1543437488.0, "status": "Completed", "simulationApplicationNames": [ "AWSRoboMakerHelloWorld-1543437372341__yb_Jg96l" ], "robotApplicationNames": [ "AWSRoboMakerHelloWorld-1543437372341_lNbmKHvs9" ] } ] }
-
Para ver detalhes da API, consulte ListSimulationJobs
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar list-tags-for-resource
.
- AWS CLI
-
Para listar as tags para um recurso
Este exemplo lista as tags de um recurso do AWS RoboMaker.
Comando:
aws robomaker list-tags-for-resource --resource-arn
"arn:aws:robomaker:us-west-2:111111111111:robot/Robby_the_Robot/1544035373264"
Saída:
{ "tags": { "Region": "North", "Stage": "Initial" } }
-
Para obter detalhes sobre a API, consulte ListTagsForResource
na AWS CLI Command Reference.
-
O código de exemplo a seguir mostra como usar register-robot
.
- AWS CLI
-
Registrar de um robô
Este exemplo registra um robô em uma frota.
Comando:
aws robomaker register-robot --fleet
arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1550771358907
--robotarn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1550772324398
Saída:
{ "fleet": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1550771358907", "robot": "arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1550772324398" }
-
Para ver detalhes da API, consulte RegisterRobot
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar restart-simulation-job
.
- AWS CLI
-
Reiniciar uma simulação
Este exemplo reinicia uma simulação.
Comando:
aws robomaker restart-simulation-job --job
arn:aws:robomaker:us-west-2:111111111111:simulation-job/sim-t6rdgt70mftr
-
Para ver detalhes da API, consulte RestartSimulationJob
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar sync-deployment-job
.
- AWS CLI
-
Sincronizar um trabalho de implantação
Este exemplo sincroniza um trabalho de implantação.
Comando:
aws robomaker sync-deployment-job --fleet
arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/Trek/1539894765711
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:deployment-job/deployment-09ccxs3tlfms", "fleet": "arn:aws:robomaker:us-west-2:111111111111:deployment-fleet/MyFleet/1539894765711", "status": "Pending", "deploymentConfig": { "concurrentDeploymentPercentage": 20, "failureThresholdPercentage": 25 }, "deploymentApplicationConfigs": [ { "application": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1546541208251", "applicationVersion": "1", "launchConfig": { "packageName": "hello_world_simulation", "launchFile": "empty_world.launch" } } ], "createdAt": 1551286954.0 }
-
Para ver detalhes da API, consulte SyncDeploymentJob
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar tag-resource
.
- AWS CLI
-
Como marcar um recurso
Este exemplo marca um recurso. Ele anexa duas tags: Região e Estágio.
Comando:
aws robomaker tag-resource --resource-arn
"arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1544035373264"
--tagsRegion=North,Stage=Initial
-
Para obter detalhes da API, consulte TagResource
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar untag-resource
.
- AWS CLI
-
Como desmarcar um recurso
Esta ação remove a etiqueta de um recurso. Ele remove a tag região.
Comando:
aws robomaker untag-resource --resource-arn
"arn:aws:robomaker:us-west-2:111111111111:robot/MyRobot/1544035373264"
--tag-keysRegion
-
Para obter detalhes sobre a API, consulte UntagResource
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar update-robot-application
.
- AWS CLI
-
Atualizar uma aplicação de robô
Este exemplo atualiza uma aplicação de robô.
Comando:
aws robomaker update-robot-application --application
arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821
--sourcess3Bucket=amzn-s3-demo-bucket,s3Key=my-robot-application.tar.gz,architecture=X86_64
--robot-software-suitename=ROS,version=Kinetic
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:robot-application/MyRobotApplication/1551203485821", "name": "MyRobotApplication", "version": "$LATEST", "sources": [ { "s3Bucket": "amzn-s3-demo-bucket", "s3Key": "my-robot-application.tar.gz", "architecture": "X86_64" } ], "robotSoftwareSuite": { "name": "ROS", "version": "Kinetic" }, "lastUpdatedAt": 1551287993.0, "revisionId": "20b5e331-24fd-4504-8b8c-531afe5f4c94" }
-
Para ver detalhes da API, consulte UpdateRobotApplication
na Referência de comandos da AWS CLI.
-
O código de exemplo a seguir mostra como usar update-simulation-application
.
- AWS CLI
-
Atualizar uma aplicação de robô
Este exemplo atualiza uma aplicação de robô.
Comando:
aws robomaker update-simulation-application --application
arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605
--sourcess3Bucket=amzn-s3-demo-bucket,s3Key=my-simulation-application.tar.gz,architecture=X86_64
--robot-software-suitename=ROS,version=Kinetic
--simulation-software-suitename=Gazebo,version=7
--rendering-enginename=OGRE,version=1.x
Saída:
{ "arn": "arn:aws:robomaker:us-west-2:111111111111:simulation-application/MySimulationApplication/1551203427605", "name": "MySimulationApplication", "version": "$LATEST", "sources": [ { "s3Bucket": "amzn-s3-demo-bucket", "s3Key": "my-simulation-application.tar.gz", "architecture": "X86_64" } ], "simulationSoftwareSuite": { "name": "Gazebo", "version": "7" }, "robotSoftwareSuite": { "name": "ROS", "version": "Kinetic" }, "renderingEngine": { "name": "OGRE", "version": "1.x" }, "lastUpdatedAt": 1551289361.0, "revisionId": "4a22cb5d-93c5-4cef-9311-52bdd119b79e" }
-
Para ver detalhes da API, consulte UpdateSimulationApplication
na Referência de comandos da AWS CLI.
-