CreateDeploymentJob - AWS RoboMaker
Sintassi della richiestaParametri della richiesta URI:Corpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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

CreateDeploymentJob

Questa operazione è stata resa obsoleta.

Importante

Questa API non è più supportata e genererà un errore se utilizzata. Per ulteriori informazioni, consulta l'aggiornamento del 31 gennaio 2022 nella pagina delle norme di supporto.

Implementa una versione specifica di un'applicazione robotica ai robot di una flotta.

L'applicazione robot deve disporre di una applicationVersion numerata per motivi di coerenza. Per creare una nuova versione, usa CreateRobotApplicationVersion o consulta Creazione di una versione di un'applicazione robot.

Nota

Dopo 90 giorni, i processi di distribuzione scadono e saranno eliminati. Non saranno più accessibili.

Sintassi della richiesta

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" 
   }
}

Parametri della richiesta URI:

La richiesta non utilizza parametri URI.

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

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_\-=]*

Campo obbligatorio: sì

deploymentApplicationConfigs

La configurazione dell'applicazione di distribuzione.

Tipo: matrice di oggetti DeploymentApplicationConfig

Membri dell'array: numero minimo di 1 elemento.

Campo obbligatorio: sì

deploymentConfig

La configurazione di distribuzione richiesta.

Tipo: oggetto DeploymentConfig

Campo obbligatorio: no

fleet

L'Amazon Resource Name (ARN) della flotta da distribuire.

▬Tipo: stringa

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

Modello: arn:.*

Campo obbligatorio: sì

tags

Una mappa che contiene le chiavi e i valori dei tag allegati al processo di distribuzione.

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 _.\-\/+=:]*

Campo obbligatorio: no

Sintassi della risposta

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" 
   }
}

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

arn

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

▬Tipo: stringa

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

Modello: arn:.*

createdAt

L'ora, in millisecondi, dall'epoca in cui è stata creata la flotta.

Tipo: Timestamp

deploymentApplicationConfigs

La configurazione dell'applicazione di distribuzione.

Tipo: matrice di oggetti DeploymentApplicationConfig

Membri dell'array: numero minimo di 1 elemento.

deploymentConfig

La configurazione di distribuzione.

Tipo: oggetto DeploymentConfig

failureCode

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

BadPermissionError

AWS Greengrass richiede un'autorizzazione a livello di servizio per accedere ad altri servizi. Il ruolo deve includere la policy gestita. AWSGreengrassResourceAccessRolePolicy

ExtractingBundleFailure

L'applicazione robotica non può essere estratta dal pacchetto.

FailureThresholdBreached

La percentuale di robot che non è stato possibile aggiornare ha superato la percentuale impostata per la distribuzione.

GreengrassDeploymentFailed

L'applicazione robotica non può essere distribuita sul robot.

GreengrassGroupVersionDoesNotExist

Manca il gruppo o la versione di AWS Greengrass associata a un robot.

InternalServerError

Si è verificato un errore interno. Riprova la richiesta, ma se il problema persiste, contattaci con i dettagli.

MissingRobotApplicationArchitecture

L'applicazione robotica non dispone di una fonte che corrisponda all'architettura del robot.

MissingRobotDeploymentResource

Mancano una o più risorse specificate per l'applicazione robotica. Ad esempio, l'applicazione robot ha il pacchetto di avvio e il file di avvio corretti?

PostLaunchFileFailure

Lo script post-lancio non è riuscito.

PreLaunchFileFailure

Lo script di pre-lancio non è riuscito.

ResourceNotFound

Mancano una o più risorse di distribuzione. Ad esempio, esistono ancora pacchetti di sorgenti per applicazioni robotiche?

RobotDeploymentNoResponse

Non c'è alcuna risposta dal robot. Potrebbe non essere acceso o connesso a Internet.

▬Tipo: stringa

Valori validi: 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

Il motivo dell'errore del processo di distribuzione, in caso di esito negativo.

▬Tipo: stringa

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

Modello: .*

fleet

La flotta di destinazione per il lavoro di distribuzione.

▬Tipo: stringa

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

Modello: arn:.*

status

Lo stato del processo di distribuzione.

▬Tipo: stringa

Valori validi: Pending | Preparing | InProgress | Failed | Succeeded | Canceled

tags

L'elenco di tutti i tag aggiunti al processo di distribuzione.

Tipo: mappatura stringa a stringa

Voci della 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 _.\-\/+=:]*

Errori

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

ConcurrentDeploymentException

La percentuale di soglia della percentuale di fallimento è stata raggiunta.

Codice di stato HTTP: 400

IdempotentParameterMismatchException

La richiesta usa lo stesso token client di una precedente, ma non è una richiesta identica. Non riutilizzare un token client con richieste diverse a meno che le richieste non siano identiche.

Codice di stato HTTP: 400

InternalServerException

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

Codice di stato HTTP: 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.

Codice di stato HTTP: 400

LimitExceededException

La risorsa richiesta supera il numero massimo consentito o il numero di richieste di streaming simultanee supera il numero massimo consentito.

Codice di stato HTTP: 400

ResourceNotFoundException

La risorsa specificata non esiste.

Codice di stato HTTP: 400

ThrottlingException

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

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue: