SubmitContainerStateChange
Note
This action is only used by the Amazon ECS agent, and it is not intended for use outside of the agent.
Sent to acknowledge that a container changed states.
Request Syntax
{
"cluster": "string
",
"containerName": "string
",
"exitCode": number
,
"networkBindings": [
{
"bindIP": "string
",
"containerPort": number
,
"containerPortRange": "string
",
"hostPort": number
,
"hostPortRange": "string
",
"protocol": "string
"
}
],
"reason": "string
",
"runtimeId": "string
",
"status": "string
",
"task": "string
"
}
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
The request accepts the following data in JSON format.
- cluster
-
The short name or full ARN of the cluster that hosts the container.
Type: String
Required: No
- containerName
-
The name of the container.
Type: String
Required: No
- exitCode
-
The exit code that's returned for the state change request.
Type: Integer
Required: No
- networkBindings
-
The network bindings of the container.
Type: Array of NetworkBinding objects
Required: No
- reason
-
The reason for the state change request.
Type: String
Required: No
- runtimeId
-
The ID of the Docker container.
Type: String
Required: No
- status
-
The status of the state change request.
Type: String
Required: No
- task
-
The task ID or full Amazon Resource Name (ARN) of the task that hosts the container.
Type: String
Required: No
Response Syntax
{
"acknowledgment": "string"
}
Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- acknowledgment
-
Acknowledgement of the state change.
Type: String
Errors
For information about the errors that are common to all actions, see Common Errors.
- AccessDeniedException
-
You don't have authorization to perform the requested action.
HTTP Status Code: 400
- ClientException
-
These errors are usually caused by a client action. This client action might be using an action or resource on behalf of a user that doesn't have permissions to use the action or resource. Or, it might be specifying an identifier that isn't valid.
The following list includes additional causes for the error:
-
The
RunTask
could not be processed because you use managed scaling and there is a capacity error because the quota of tasks in thePROVISIONING
per cluster has been reached. For information about the service quotas, see Amazon ECS service quotas.
HTTP Status Code: 400
-
- ServerException
-
These errors are usually caused by a server issue.
HTTP Status Code: 500
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: