Aviso de fim do suporte: em 10 de setembro de 2025, AWS
interromperá o suporte para AWS RoboMaker. Depois de 10 de setembro de 2025, você não poderá mais acessar o AWS RoboMaker console ou AWS RoboMaker os recursos. Para obter mais informações sobre como fazer a transição para ajudar AWS Batch a executar simulações em contêineres, visite esta postagem no blog.
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
CreateDeploymentJob
Essa ação está defasada.
Importante
Aviso de fim do suporte: em 10 de setembro de 2025, AWS
interromperá o suporte para AWS RoboMaker. Depois de 10 de setembro de 2025, você não poderá mais acessar o AWS RoboMaker console ou AWS RoboMaker os recursos. Para obter mais informações sobre como fazer a transição para ajudar AWS Batch a executar simulações em contêineres, visite esta postagem no blog.
Importante
Isso não API é mais suportado e gerará um erro se usado. Para obter mais informações, consulte a atualização de 31 de janeiro de 2022 na página da política de suporte.
Implanta uma versão específica de um aplicativo de robô em robôs em uma frota.
O aplicativo de robô deve ter uma applicationVersion numerada por motivos de consistência. Para criar uma nova versão, use CreateRobotApplicationVersion ou consulte Criando uma versão do aplicativo de robô.
nota
Após 90 dias, os trabalhos de implantação expiram e serão excluídos. Eles não serão mais acessíveis.
Sintaxe da Solicitação
POST /createDeploymentJob HTTP/1.1
Content-type: application/json
{
"clientRequestToken": "string",
"deploymentApplicationConfigs": [
{
"application": "string",
"applicationVersion": "string",
"launchConfig": {
"environmentVariables": {
"string" : "string"
},
"launchFile": "string",
"packageName": "string",
"postLaunchFile": "string",
"preLaunchFile": "string"
}
}
],
"deploymentConfig": {
"concurrentDeploymentPercentage": number,
"downloadConditionFile": {
"bucket": "string",
"etag": "string",
"key": "string"
},
"failureThresholdPercentage": number,
"robotDeploymentTimeoutInSeconds": number
},
"fleet": "string",
"tags": {
"string" : "string"
}
}URIParâmetros de solicitação
A solicitação não usa nenhum URI parâmetro.
Corpo da Solicitação
A solicitação aceita os seguintes dados no JSON formato.
- clientRequestToken
-
Identificador exclusivo e que diferencia maiúsculas e minúsculas que você fornece para garantir a idempotência da solicitação.
Tipo: string
Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.
Padrão:
[a-zA-Z0-9_\-=]*Exigido: Sim
- deploymentApplicationConfigs
-
A configuração do aplicativo de implantação.
Tipo: matriz de objetos DeploymentApplicationConfig
Membros da matriz: número fixo de 1 item.
Obrigatório: Sim
- deploymentConfig
-
A configuração de implantação solicitada.
Tipo: objeto DeploymentConfig
Obrigatório: Não
- fleet
-
O Amazon Resource Name (ARN) da frota a ser implantada.
Tipo: string
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.224.
Padrão:
arn:.*Exigido: Sim
-
Um mapa com as chaves e os valores de tag anexados ao trabalho de implantação.
Tipo:: mapa de string para string
Entradas do mapa: número mínimo de 0 itens. Número máximo de 50 itens.
Restrições de Tamanho de Chave: Tamanho mínimo de 1. O tamanho máximo é 128.
Padrão da chave:
[a-zA-Z0-9 _.\-\/+=:]*Restrições de comprimento do valor: Comprimento mínimo de 0. Tamanho máximo de 256.
Padrão de valor:
[a-zA-Z0-9 _.\-\/+=:]*Obrigatório: Não
Sintaxe da Resposta
HTTP/1.1 200
Content-type: application/json
{
"arn": "string",
"createdAt": number,
"deploymentApplicationConfigs": [
{
"application": "string",
"applicationVersion": "string",
"launchConfig": {
"environmentVariables": {
"string" : "string"
},
"launchFile": "string",
"packageName": "string",
"postLaunchFile": "string",
"preLaunchFile": "string"
}
}
],
"deploymentConfig": {
"concurrentDeploymentPercentage": number,
"downloadConditionFile": {
"bucket": "string",
"etag": "string",
"key": "string"
},
"failureThresholdPercentage": number,
"robotDeploymentTimeoutInSeconds": number
},
"failureCode": "string",
"failureReason": "string",
"fleet": "string",
"status": "string",
"tags": {
"string" : "string"
}
}Elementos de Resposta
Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP de 200.
Os dados a seguir são retornados em JSON formato pelo serviço.
- arn
-
O Amazon Resource Name (ARN) do trabalho de implantação.
Tipo: string
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.224.
Padrão:
arn:.* - createdAt
-
O tempo, em milissegundos, desde o período em que a frota foi criada.
Tipo: carimbo de data/hora
- deploymentApplicationConfigs
-
A configuração do aplicativo de implantação.
Tipo: matriz de objetos DeploymentApplicationConfig
Membros da matriz: número fixo de 1 item.
- deploymentConfig
-
A configuração de implantação.
Tipo: objeto DeploymentConfig
- failureCode
-
O código de falha da tarefa de simulação, se ela falhar:
- BadPermissionError
-
AWSO Greengrass exige uma permissão de função de nível de serviço para acessar outros serviços. A função deve incluir a política gerenciada de
AWSGreengrassResourceAccessRolePolicy. - ExtractingBundleFailure
-
O aplicativo do robô não pôde ser extraído do pacote.
- FailureThresholdBreached
-
A porcentagem de robôs que não puderam ser atualizados excedeu a porcentagem definida para a implantação.
- GreengrassDeploymentFailed
-
O aplicativo do robô não pôde ser implantado no robô.
- GreengrassGroupVersionDoesNotExist
-
O grupo ou a versão do AWS Greengrass associada a um robô está ausente.
- InternalServerError
-
Ocorreu um erro interno. Tente fazer sua solicitação novamente, mas se o problema persistir, entre em contato conosco para fornecer detalhes.
- MissingRobotApplicationArchitecture
-
O aplicativo do robô não tem uma fonte que corresponda à arquitetura do robô.
- MissingRobotDeploymentResource
-
Um ou mais dos recursos especificados para o aplicativo do robô estão ausentes. Por exemplo, o aplicativo do robô tem o pacote de inicialização e o arquivo de inicialização corretos?
- PostLaunchFileFailure
-
O script pós-lançamento falhou.
- PreLaunchFileFailure
-
O script de pré-lançamento falhou.
- ResourceNotFound
-
Faltam um ou mais recursos de implantação. Por exemplo, os pacotes de origem de aplicativos de robôs ainda existem?
- RobotDeploymentNoResponse
-
Não há resposta do robô. Pode ser que o computador não esteja ligado ou conectado à Internet.
Tipo: string
Valores Válidos:
ResourceNotFound | EnvironmentSetupError | EtagMismatch | FailureThresholdBreached | RobotDeploymentAborted | RobotDeploymentNoResponse | RobotAgentConnectionTimeout | GreengrassDeploymentFailed | InvalidGreengrassGroup | MissingRobotArchitecture | MissingRobotApplicationArchitecture | MissingRobotDeploymentResource | GreengrassGroupVersionDoesNotExist | LambdaDeleted | ExtractingBundleFailure | PreLaunchFileFailure | PostLaunchFileFailure | BadPermissionError | DownloadConditionFailed | BadLambdaAssociated | InternalServerError | RobotApplicationDoesNotExist | DeploymentFleetDoesNotExist | FleetDeploymentTimeout - failureReason
-
O motivo da falha do trabalho de implantação, se ele falhar.
Tipo: string
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 1.024.
Padrão:
.* - fleet
-
A frota alvo do trabalho de implantação.
Tipo: string
Restrições de comprimento: tamanho mínimo de 1. Tamanho máximo de 1.224.
Padrão:
arn:.* - status
-
O status do trabalho de implantação.
Tipo: string
Valores Válidos:
Pending | Preparing | InProgress | Failed | Succeeded | Canceled -
A lista de todas as tags adicionadas ao trabalho de implantação.
Tipo:: mapa de string para string
Entradas do mapa: número mínimo de 0 itens. Número máximo de 50 itens.
Restrições de Tamanho de Chave: Tamanho mínimo de 1. O tamanho máximo é 128.
Padrão da chave:
[a-zA-Z0-9 _.\-\/+=:]*Restrições de comprimento do valor: Comprimento mínimo de 0. Tamanho máximo de 256.
Padrão de valor:
[a-zA-Z0-9 _.\-\/+=:]*
Erros
Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.
- ConcurrentDeploymentException
-
A porcentagem limite de porcentagem de falha foi atingida.
HTTPCódigo de status: 400
- IdempotentParameterMismatchException
-
A solicitação usa o mesmo token do cliente de uma solicitação anterior, mas não idêntica. Não reutilize um token do cliente com diferentes solicitações, a menos que as solicitações sejam idênticas.
HTTPCódigo de status: 400
- InternalServerException
-
AWS RoboMaker teve um problema de serviço. Tente fazer a chamada novamente.
HTTPCódigo de status: 500
- InvalidParameterException
-
Um parâmetro especificado em uma solicitação é inválido, não tem suporte ou não pode ser usado. A mensagem retornada fornece uma explicação do valor do erro.
HTTPCódigo de status: 400
- LimitExceededException
-
O recurso solicitado excede o número máximo permitido ou o número de solicitações de streaming simultâneas excede o número máximo permitido.
HTTPCódigo de status: 400
- ResourceNotFoundException
-
O recurso especificado não existe.
HTTPCódigo de status: 400
- ThrottlingException
-
AWS RoboMaker está temporariamente incapaz de processar a solicitação. Tente fazer a chamada novamente.
HTTPCódigo de status: 400
Consulte também
Para obter mais informações sobre como usar isso API em um idioma específico AWS SDKs, consulte o seguinte:
