Detailed deployment error codes

You might get this error when an Amazon service operation returns a 403 error because permissions are not set up correctly. Check the more specific error code for details.

You might get this error when the Amazon IoT policy doesn't allow permission to call the GetDeploymentConfiguration operation. Add the greengrass::GetDeploymentConfiguration permission to the core device's policy.

You might get this error when the core device Amazon IoT policy doesn't allow the greengrass:GetComponentVersionArtifact permission. Add the permission to the core device's policy.

You might get this error when the core device Amazon IoT policy doesn't allow the greengrass:ResolveComponentCandidates permission. Add the permission to the core device's policy.

You might get this error when the deployment couldn't authenticate with a private registry in ECR. Check the log for a specific error and then try the deployment again.

You might get this error when the Greengrass user is not authorized to use Docker. Make sure that you are running Greengrass as root or that the user is added to the docker group. Then try the deployment again.

You might get this error when an Amazon S3 operation returns a 403 error. Check any additional error codes or logs for details.

You might get this error either when the device's token exchange role doesn't allow the Amazon IoT Greengrass Core software to download the component artifact from the S3 object URL that you specify in the component's recipe or that the component artifact isn't available. Check that the token exchange role allows s3:GetObject for the S3 object URL where the artifact is available and that the artifact is present.

You might get this error when the device's token exchange role doesn't allow the s3:GetBucketLocation permission for the Amazon S3 bucket where the artifact is available. Check that the device's allows the permission then try the deployment again.

You might get this error either when the device's token exchange role doesn't allow the Amazon IoT Greengrass Core software to download the component artifact from the S3 object URL that you specify in the component's recipe or that the component artifact isn't available. Check that the token exchange role allows s3:GetObject for the S3 object URL where the artifact is available and that the artifact is present.

You might get this error when the nucleus version in the deployment isn't capable a requested operation, such as downloading a large configuration or setting Linux resource limits. Retry the deployment with a nucleus version that supports the operation.

You might get this error when a deployment attempts to deploy multiple nucleus components. Check the log to see what caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.

You might get this error when two components in your deployment depend on each other. Revise the component setup so that the components in your deployment don't rely on each other.

You might get this error when a component in your deployment requires a nucleus minor version update, but that version isn't specified in the deployment. This helps to reduce accidental minor version updates for components that depend on a different version. Include the new minor nucleus version in the deployment.

You might get this error when you deploy a Docker component without deploying the Docker application manager. Make sure that your deployment includes the Docker application manager.

You might get this error when the deployment wants to download a Docker image artifact from a private ECR registry without deploying the token exchange service. Make sure that your deployment includes the token exchange service.

You might get this error when there is a version constraint conflict or a component version does not exist. For more information, see Error: com.aws.greengrass.componentmanager.exceptions.NoAvailableComponentVersionException: Failed to negotiate component <name> version with cloud and no local applicable version satisfying requirement <requirements>.

You might get this error when an Amazon service operation exceeded a rate quota. Retry the deployment.

You might get this error when an Amazon service operation returns a 409 error because you deployment is trying to perform more than one operation at a time. Retry the deployment.

You might get this error when an Amazon service operation returns a 404 error because a resource couldn't be found. Check the log for the missing resource.

You might get this error when the posixUser, posixGroup, or windowsUser information specified to run the component isn't valid. Check that the user is valid and then retry the deployment.

You might get this error when the Region specified for the deployment isn't supported by Amazon IoT Greengrass. Check the Region and try the deployment again.

You might get this error when the Amazon IoT credential endpoint specified in the configuration isn't valid. Check the endpoint and try your request again.

You might get this error when the Amazon IoT data endpoint specified in the configuration isn't valid. Check the endpoint and try your request again.

You might get this error when the component artifact isn't available at the S3 object URL that you specify in the component's recipe. Check that you uploaded the artifact to the S3 bucket and that the artifact URI matches the S3 object URL of the artifact in the bucket.

You might get this error when the Amazon S3 bucket isn't found. Check that the bucket exists and try the deployment again.

You might get this error when the component artifact isn't available at the S3 object URL that you specify in the component's recipe. Check that you uploaded the artifact to the S3 bucket and that the artifact URI matches the S3 object URL of the artifact in the bucket.

You might get this error when an I/O error occurs when parsing deployment document or recipe. Check any additional error codes or logs for details.

You might get this error when the deployment recipe couldn't be parsed because there is an error in the structure of the recipe. Check that the recipe is correctly formatted and try the deployment again.

You might get this error when the deployment recipe metadata downloaded from the cloud couldn't be parsed. Contact Amazon Web Services Support.

You might get this error when an artifact URI in a recipe isn't formatted correctly. Check the log for the URI that isn't valid, update the URI in the recipe, then try the deployment again.

You might get this error when the Amazon S3 URI of an artifact in a recipe isn't valid. Check the log for the URI that isn't valid, update the URI in the recipe, then try the deployment again.

You might get this error when the Docker URI of an artifact in a recipe isn't valid. Check the log for the URI that isn't valid, update the URI in the recipe, then try the deployment again.

You might get this error when the URI of an artifact is not specified in a recipe. Check the log for the artifact that is missing a URI, update the URI in the recipe, then try the deployment again.

You might get this error when a URI scheme is not defined for an artifact. Check the log for the URI that isn't valid, update the URI in the recipe, then try the deployment again.

You might get this error when a URI scheme isn't supported by the running nucleus version. Either a URI isn't valid or you need to update the nucleus version. If the URI isn't valid, check the log for the URI that isn't valid, update the URI in the recipe, then try the deployment again.

You might get this error when the manifest section isn't included in the recipe. Add the manifest to the recipe and try the deployment again.

You might get this error when an artifact that is not local is specified inside a recipe without a hash algorithm. Add the algorithm to the artifact and then try the request again.

You might get this error when a downloaded artifact has a different digest than the one specified in the recipe. Make sure that the recipe contains the correct digest and then try the deployment again. For more information see Error: com.aws.greengrass.componentmanager.exceptions.ArtifactChecksumMismatchException: Integrity check for downloaded artifact failed. Probably due to file corruption..

You might get this error when the dependency type specified in a deployment recipe isn't valid. Check the recipe and then try your request again.

You might get this error when interpolating a recipe variable. Check the log for details.

You might get this error when an I/O error occurs when parsing deployment document or recipe. Check any additional error codes or logs for details.

You might get this error when a component doesn't update during a deployment. Check any additional error codes or check the log to see what caused the error.

You might get this error when a component is broken during a deployment. Check the component log for error details and then try the deployment again.

You might get this error when the nucleus can't remove a component during a deployment. Check the log for error details and then try the deployment again.

You might get this error when a component's bootstrap task took longer than the configured timeout. Increase the timeout or reduce the execution time of the bootstrap task, then try the deployment again.

You might get this error when a component's bootstrap task has an error. Check the log for error details, then try the deployment again.

You might get this error when the nucleus can't validate the deployed configuration for the component. Check the log for error details, then try the deployment again.

You might get this error when writing to a file. Check the log for details.

You might get this error when reading from a file. Check the log for details.

You might get this error when there is not enough disk space to complete a deployment request. You must have at least 20 Mb of available space, or enough to hold a larger artifact. Free up some disk space and then retry the deployment.

You might get this error when the existing file size can't be retrieved from the file system. Check the log for details.

You might get this error when the permissions can't be set on a downloaded artifact or artifact directory. Check the log for details.

You might get this error when an artifact can't be unzipped. Check the log for details.

You might get this error when the local copy of a recipe file couldn't be found. Try the deployment again.

You might get this error when the local copy of the recipe has changed since it was downloaded. Delete the existing copy of the recipe and try the deployment again.

You might get this error when the local copy of the recipe metadata file couldn't be found. Try the deployment again.

You might get this error when the directory used to launch the Greengrass nucleus (/greengrass/v2/alts/current) has been modified since the last time the nucleus was started. Restart the nucleus and then retry the deployment.

You might get this error when the device's Java distribution doesn't support the required hashing algorithm or when the hash algorithm specified in a component recipe isn't valid.

You might get this error when there is an error in the device configuration that prevented the deployment from downloading the artifact from Amazon S3 or the Greengrass cloud. Check the log for a specific configuration error and then retry the deployment.

You might get this error when pulling a Docker image. Check any additional error codes or logs for details.

You might get this error when Greengrass couldn't log into the Docker registry. Check the log for a specific error and then try the deployment again.

You might get this error when an unexpected error occurs when logging in to Docker. Check the log for a specific error and then try the deployment again.

You might get this error when an unexpected error occurs when pulling a Docker image from the registry. Check the log for a specific error and then try the deployment again.

You might get this error when the requested Docker image doesn't exist. Check the log for a specific error and try the deployment again.

You might get this error when an unexpected failure occurs when querying Docker for available images. Check the log for the specific error and try the deployment again.

You might get this error when downloading an Amazon S3 artifact. Check any additional error codes or logs for details.

You might get this error when an Amazon S3 operation returns a 404 error. Check any additional error codes or logs for details.

You might get this error when an Amazon S3 operation returns a 400 error. Check the log for a specific error and try the request again.

You might get this error when an error occurred when making an HTTP request. Check the log for the specific error.

You might get this error when an HTTP error occurred when downloading the deployment document. Check the log for the specific HTTP error.

You might get this error when an HTTP error occurred when getting the size of a public component artifact. Check the log for the specific HTTP error.

You might get this error when an HTTP error occurred when downloading a public component artifact. Check the log for the specific HTTP error.

You might get this error when there is a connection issue during a deployment. Check the connection of the device to the Internet and try the deployment again.

You might get this error when an Amazon cloud operation returns a 400 error. Check the log to see which API caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.

You might get this error when a core device can't find the version of the active nucleus. Check the log to see what caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.

You might get this error when the nucleus doesn't restart during any deployment that requires a nucleus restart. Check the loader log to see what caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.

You might get this error when the nucleus can't locate an installed component. Check the log to see what caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.

You might get this error when the device receives deployment document that isn't valid. Check any additional error codes or check the log to see what caused the error.

You might get this error when a device receives an empty deployment request. Check the log to see what caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.

You might get this error when the deployment request format doesn't match the expected format. Check the log to see what caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.

You might get this error when the deployment request contains component metadata that isn't valid. Check the log to see what caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.

You might get this error when you move a Greengrass device from one thing group to another, and then back to the original group with deployments that require Greengrass to restart. To resolve the error, recreate the launch directory for Greengrass on the device.

For more information, see Error: com.aws.greengrass.deployment.exceptions.DeploymentException: Unable to process deployment. Greengrass launch directory is not set up or Greengrass is not set up as a system service.

You might get this error when an Amazon service operation returns a 500 error because the service can't process the request right now. Retry the deployment later.

You might get this error when an Amazon S3 operation returns a 500 error. Check any additional error codes or logs for details.

You might get this error when the Greengrass cloud service sends an incompatible response to the ResolveComponentCandidates operation. Check the log to see what caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.

You might get this error when the requested deployment document exceeded the maximum size quota. Reduce the size of the deployment document and try the deployment again.

You might get this error when Greengrass can't get the size of a public component artifact. Check the log to see what caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.

You might get this error when the device receives deployment document that isn't valid. Check any additional error codes or check the log to see what caused the error.

You might get this error when a device receives an empty deployment request. Check the log to see what caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.

You might get this error when the deployment request format doesn't match the expected format. Check the log to see what caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.

You might get this error when the deployment request contains component metadata that isn't valid. Check the log to see what caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.

You might get this error when a deployment can't be completed because of a nucleus shutdown or other external event. Check any additional error codes or logs for details.

You might get this error when there is a problem downloading an artifact. Check any additional error codes or logs for details.

You might get this error when a component version doesn't exist in the cloud or locally, or if there is a dependency resolution conflict. Check any additional error codes or logs for details.

You might get this error when an error processing the downloaded artifacts. Check any additional error codes or logs for details.

You might get this error when an error occurred calling an Amazon service API. Check any additional error codes or logs for details.

You might get this error when an I/O error occurs during a deployment. Check any additional error codes or logs for details.

You might get this error when a component doesn't update during a deployment. Check any additional error codes or check the log to see what caused the error.

You might get this error when a deployment fails because an unchecked exception was thrown. Check the log to see what caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.

You might get this error when the deployment type isn't valid. Check the log to see what caused the error, then check the nucleus software update page to see if the issue has been corrected in a later version of the nucleus, or contact Amazon Web Services Support.