CreateDeploymentJob - AWS RoboMaker
請求語法URI 請求參數請求主體回應語法回應元素錯誤另請參閱

支援終止通知：2025 年 9 月 10 日， AWS 將停止對 的支援 AWS RoboMaker。2025 年 9 月 10 日後，您將無法再存取 AWS RoboMaker 主控台或 AWS RoboMaker 資源。如需有關轉換至 AWS Batch 以協助執行容器化模擬的詳細資訊，請造訪此部落格文章 。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

CreateDeploymentJob

此動作已被取代。

重要

支援終止通知：2025 年 9 月 10 日， AWS 將停止對 的支援 AWS RoboMaker。2025 年 9 月 10 日後，您將無法再存取 AWS RoboMaker 主控台或 AWS RoboMaker 資源。如需有關轉換至 AWS Batch 以協助執行容器化模擬的詳細資訊，請造訪此部落格文章 。

重要

已API不再支援此 ，如果使用 ，則會擲回錯誤。如需詳細資訊，請參閱 支援政策頁面中的 2022 年 1 月 31 日更新。

將機器人應用程式的特定版本部署到機群中的機器人。

為了一致性原因，機器人應用程式須有具編號的 applicationVersion。若要建立新版本，請使用 CreateRobotApplicationVersion或參閱建立機器人應用程式版本 。

注意

部署任務會在 90 天後過期並遭到刪除。他們不再可供存取。

請求語法

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

URI 請求參數

請求不會使用任何URI參數。

請求主體

請求接受下列JSON格式的資料。

clientRequestToken

您提供的唯一且區分大小寫的識別符，以確保請求的不明確性。

類型：字串

長度限制：長度下限為 1。長度上限為 64。

模式：[a-zA-Z0-9_\-=]*

必要：是

deploymentApplicationConfigs

部署應用程式組態。

類型：DeploymentApplicationConfig 物件陣列

陣列成員：固定項目數為 1。

必要：是

deploymentConfig

請求的部署組態。

類型：DeploymentConfig 物件

必要：否

fleet

要部署之機群的 Amazon Resource Name （ARN）。

類型：字串

長度限制：長度下限為 1。長度上限為 1224。

模式：arn:.*

必要：是

tags

包含附加至部署任務之標籤索引鍵和標籤值的地圖。

類型：字串到字串映射

映射項目：最少 0 個項目。項目數上限為 50。

索引鍵長度限制：長度下限為 1。長度上限為 128。

金鑰模式：[a-zA-Z0-9 _.\-\/+=:]*

值長度限制：最小長度為 0。長度上限為 256。

值模式：[a-zA-Z0-9 _.\-\/+=:]*

必要：否

回應語法

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

回應元素

如果動作成功，服務會傳回 200 HTTP 個回應。

服務會以 JSON 格式傳回下列資料。

arn

部署任務的 Amazon Resource Name （ARN）。

類型：字串

長度限制：長度下限為 1。長度上限為 1224。

模式：arn:.*

createdAt

建立機群時，自 Epoch 以來以毫秒為單位的時間。

類型：Timestamp

deploymentApplicationConfigs

部署應用程式組態。

類型：DeploymentApplicationConfig 物件陣列

陣列成員：固定項目數為 1。

deploymentConfig

部署組態。

類型：DeploymentConfig 物件

failureCode

模擬任務失敗時的失敗碼：

BadPermissionError

AWS Greengrass 需要服務層級角色許可才能存取其他 服務。角色必須包含 AWSGreengrassResourceAccessRolePolicy 受管政策 。

ExtractingBundleFailure

機器人應用程式無法從套件中擷取。

FailureThresholdBreached

無法更新的機器人百分比超過為部署設定的百分比。

GreengrassDeploymentFailed

機器人應用程式無法部署至機器人。

GreengrassGroupVersionDoesNotExist

與機器人相關聯的 AWS Greengrass 群組或版本遺失。

InternalServerError

發生內部錯誤。重試您的請求，但如果問題仍然存在，請聯絡我們並提供詳細資訊。

MissingRobotApplicationArchitecture

機器人應用程式沒有符合機器人架構的來源。

MissingRobotDeploymentResource

機器人應用程式指定的一或多個資源遺失。例如，機器人應用程式是否有正確的啟動套件和啟動檔案？

PostLaunchFileFailure

啟動後指令碼失敗。

PreLaunchFileFailure

啟動前指令碼失敗。

ResourceNotFound

缺少一或多個部署資源。例如，機器人應用程式來源套件是否仍然存在？

RobotDeploymentNoResponse

機器人沒有回應。它可能無法開機或連線至網際網路。

類型：字串

有效值: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

部署任務失敗的失敗原因。

類型：字串

長度限制：長度下限為 0。長度上限為 1024。

模式：.*

fleet

部署任務的目標機群。

類型：字串

長度限制：長度下限為 1。長度上限為 1224。

模式：arn:.*

status

部署任務的狀態。

類型：字串

有效值:Pending | Preparing | InProgress | Failed | Succeeded | Canceled

tags

新增至部署任務的所有標籤清單。

類型：字串到字串映射

映射項目：最少 0 個項目。項目數上限為 50。

索引鍵長度限制：長度下限為 1。長度上限為 128。

金鑰模式：[a-zA-Z0-9 _.\-\/+=:]*

值長度限制：最小長度為 0。長度上限為 256。

值模式：[a-zA-Z0-9 _.\-\/+=:]*

錯誤

如需所有動作常見錯誤的資訊，請參閱常見錯誤。

ConcurrentDeploymentException

已符合失敗百分比閾值百分比。

HTTP 狀態碼：400

IdempotentParameterMismatchException

請求使用了與先前請求 (但為非相同請求) 相同的用戶端字符。請勿以不同請求重複使用用戶端字符，除非請求相同。

HTTP 狀態碼：400

InternalServerException

AWS RoboMaker 發生服務問題。請再次嘗試呼叫。

HTTP 狀態碼：500

InvalidParameterException

在請求中指定的一個參數無效、未支援或無法使用。傳回之訊息會提供錯誤值的說明。

HTTP 狀態碼：400

LimitExceededException

請求的資源超過允許的最大數量，或並行串流請求的數量超過允許的最大數量。

HTTP 狀態碼：400

ResourceNotFoundException

指定的資源不存在。

HTTP 狀態碼：400

ThrottlingException

AWS RoboMaker 暫時無法處理請求。請再次嘗試呼叫。

HTTP 狀態碼：400

另請參閱

如需在其中一種語言特定 API中使用此功能的詳細資訊 AWS SDKs，請參閱下列內容：