Request Syntax URI Request Parameters Request Body Response Syntax Response Elements Errors See Also

DescribeHumanLoop

Returns information about the specified human loop. If the human loop was deleted, this operation will return a ResourceNotFoundException error.

Request Syntax


GET /human-loops/HumanLoopName HTTP/1.1

URI Request Parameters

The request uses the following URI parameters.

HumanLoopName

The name of the human loop that you want information about.

Length Constraints: Minimum length of 1. Maximum length of 63.

Pattern: ^[a-z0-9](-*[a-z0-9])*$

Required: Yes

Request Body

The request does not have a request body.

Response Syntax


HTTP/1.1 200
Content-type: application/json

{
   "CreationTime": number,
   "FailureCode": "string",
   "FailureReason": "string",
   "FlowDefinitionArn": "string",
   "HumanLoopArn": "string",
   "HumanLoopName": "string",
   "HumanLoopOutput": { 
      "OutputS3Uri": "string"
   },
   "HumanLoopStatus": "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.

CreationTime

The creation time when Amazon Augmented AI created the human loop.

Type: Timestamp

FailureCode

A failure code that identifies the type of failure.

Possible values: ValidationError, Expired, InternalError

Type: String

FailureReason

The reason why a human loop failed. The failure reason is returned when the status of the human loop is Failed.

Type: String

FlowDefinitionArn

The Amazon Resource Name (ARN) of the flow definition.

Type: String

Length Constraints: Maximum length of 1024.

Pattern: arn:aws[a-z\-]*:sagemaker:[a-z0-9\-]*:[0-9]{12}:flow-definition/.*

HumanLoopArn

The Amazon Resource Name (ARN) of the human loop.

Type: String

Length Constraints: Maximum length of 1024.

Pattern: arn:aws[a-z\-]*:sagemaker:[a-z0-9\-]*:[0-9]{12}:human-loop/.*

HumanLoopName

The name of the human loop. The name must be lowercase, unique within the Region in your account, and can have up to 63 characters. Valid characters: a-z, 0-9, and - (hyphen).

Type: String

Length Constraints: Minimum length of 1. Maximum length of 63.

Pattern: ^[a-z0-9](-*[a-z0-9])*$

HumanLoopOutput

An object that contains information about the output of the human loop.

Type: HumanLoopOutput object

HumanLoopStatus

The status of the human loop.

Type: String

Valid Values: InProgress | Failed | Completed | Stopped | Stopping

Errors

For information about the errors that are common to all actions, see Common Errors.

InternalServerException

We couldn't process your request because of an issue with the server. Try again later.

HTTP Status Code: 500

ResourceNotFoundException

We couldn't find the requested resource. Check that your resources exists and were created in the same AWS Region as your request, and try your request again.

HTTP Status Code: 404

ThrottlingException

You exceeded the maximum number of requests.

HTTP Status Code: 429

ValidationException

The request isn't valid. Check the syntax and try again.

HTTP Status Code: 400