Current Directory:
/usr/lib/fence-agents/bundled/botocore/data/sagemaker-a2i-runtime/2019-11-07
Upload
Create File
File Name
Size
Actions
paginators-1.json
199 bytes
Edit
|
Delete
|
Rename
|
Download
service-2.json
18686 bytes
Edit
|
Delete
|
Rename
|
Download
{ "version":"2.0", "metadata":{ "apiVersion":"2019-11-07", "endpointPrefix":"a2i-runtime.sagemaker", "jsonVersion":"1.1", "protocol":"rest-json", "serviceFullName":"Amazon Augmented AI Runtime", "serviceId":"SageMaker A2I Runtime", "signatureVersion":"v4", "signingName":"sagemaker", "uid":"sagemaker-a2i-runtime-2019-11-07" }, "operations":{ "DeleteHumanLoop":{ "name":"DeleteHumanLoop", "http":{ "method":"DELETE", "requestUri":"/human-loops/{HumanLoopName}" }, "input":{"shape":"DeleteHumanLoopRequest"}, "output":{"shape":"DeleteHumanLoopResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InternalServerException"} ], "documentation":"<p>Deletes the specified human loop for a flow definition.</p> <p>If the human loop was deleted, this operation will return a <code>ResourceNotFoundException</code>. </p>" }, "DescribeHumanLoop":{ "name":"DescribeHumanLoop", "http":{ "method":"GET", "requestUri":"/human-loops/{HumanLoopName}" }, "input":{"shape":"DescribeHumanLoopRequest"}, "output":{"shape":"DescribeHumanLoopResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InternalServerException"} ], "documentation":"<p>Returns information about the specified human loop. If the human loop was deleted, this operation will return a <code>ResourceNotFoundException</code> error. </p>" }, "ListHumanLoops":{ "name":"ListHumanLoops", "http":{ "method":"GET", "requestUri":"/human-loops" }, "input":{"shape":"ListHumanLoopsRequest"}, "output":{"shape":"ListHumanLoopsResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InternalServerException"} ], "documentation":"<p>Returns information about human loops, given the specified parameters. If a human loop was deleted, it will not be included.</p>" }, "StartHumanLoop":{ "name":"StartHumanLoop", "http":{ "method":"POST", "requestUri":"/human-loops" }, "input":{"shape":"StartHumanLoopRequest"}, "output":{"shape":"StartHumanLoopResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ThrottlingException"}, {"shape":"ServiceQuotaExceededException"}, {"shape":"InternalServerException"}, {"shape":"ConflictException"} ], "documentation":"<p>Starts a human loop, provided that at least one activation condition is met.</p>" }, "StopHumanLoop":{ "name":"StopHumanLoop", "http":{ "method":"POST", "requestUri":"/human-loops/stop" }, "input":{"shape":"StopHumanLoopRequest"}, "output":{"shape":"StopHumanLoopResponse"}, "errors":[ {"shape":"ValidationException"}, {"shape":"ResourceNotFoundException"}, {"shape":"ThrottlingException"}, {"shape":"InternalServerException"} ], "documentation":"<p>Stops the specified human loop.</p>" } }, "shapes":{ "ConflictException":{ "type":"structure", "members":{ "Message":{"shape":"FailureReason"} }, "documentation":"<p>Your request has the same name as another active human loop but has different input data. You cannot start two human loops with the same name and different input data.</p>", "error":{"httpStatusCode":409}, "exception":true }, "ContentClassifier":{ "type":"string", "enum":[ "FreeOfPersonallyIdentifiableInformation", "FreeOfAdultContent" ] }, "ContentClassifiers":{ "type":"list", "member":{"shape":"ContentClassifier"}, "max":256 }, "DeleteHumanLoopRequest":{ "type":"structure", "required":["HumanLoopName"], "members":{ "HumanLoopName":{ "shape":"HumanLoopName", "documentation":"<p>The name of the human loop that you want to delete.</p>", "location":"uri", "locationName":"HumanLoopName" } } }, "DeleteHumanLoopResponse":{ "type":"structure", "members":{ } }, "DescribeHumanLoopRequest":{ "type":"structure", "required":["HumanLoopName"], "members":{ "HumanLoopName":{ "shape":"HumanLoopName", "documentation":"<p>The name of the human loop that you want information about.</p>", "location":"uri", "locationName":"HumanLoopName" } } }, "DescribeHumanLoopResponse":{ "type":"structure", "required":[ "CreationTime", "HumanLoopStatus", "HumanLoopName", "HumanLoopArn", "FlowDefinitionArn" ], "members":{ "CreationTime":{ "shape":"Timestamp", "documentation":"<p>The creation time when Amazon Augmented AI created the human loop.</p>" }, "FailureReason":{ "shape":"String", "documentation":"<p>The reason why a human loop failed. The failure reason is returned when the status of the human loop is <code>Failed</code>.</p>" }, "FailureCode":{ "shape":"String", "documentation":"<p>A failure code that identifies the type of failure.</p> <p>Possible values: <code>ValidationError</code>, <code>Expired</code>, <code>InternalError</code> </p>" }, "HumanLoopStatus":{ "shape":"HumanLoopStatus", "documentation":"<p>The status of the human loop. </p>" }, "HumanLoopName":{ "shape":"HumanLoopName", "documentation":"<p>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).</p>" }, "HumanLoopArn":{ "shape":"HumanLoopArn", "documentation":"<p>The Amazon Resource Name (ARN) of the human loop.</p>" }, "FlowDefinitionArn":{ "shape":"FlowDefinitionArn", "documentation":"<p>The Amazon Resource Name (ARN) of the flow definition.</p>" }, "HumanLoopOutput":{ "shape":"HumanLoopOutput", "documentation":"<p>An object that contains information about the output of the human loop.</p>" } } }, "FailureReason":{ "type":"string", "max":1024 }, "FlowDefinitionArn":{ "type":"string", "max":1024, "pattern":"arn:aws[a-z\\-]*:sagemaker:[a-z0-9\\-]*:[0-9]{12}:flow-definition/.*" }, "HumanLoopArn":{ "type":"string", "max":1024, "pattern":"arn:aws[a-z\\-]*:sagemaker:[a-z0-9\\-]*:[0-9]{12}:human-loop/.*" }, "HumanLoopDataAttributes":{ "type":"structure", "required":["ContentClassifiers"], "members":{ "ContentClassifiers":{ "shape":"ContentClassifiers", "documentation":"<p>Declares that your content is free of personally identifiable information or adult content.</p> <p>Amazon SageMaker can restrict the Amazon Mechanical Turk workers who can view your task based on this information.</p>" } }, "documentation":"<p>Attributes of the data specified by the customer. Use these to describe the data to be labeled.</p>" }, "HumanLoopInput":{ "type":"structure", "required":["InputContent"], "members":{ "InputContent":{ "shape":"InputContent", "documentation":"<p>Serialized input from the human loop. The input must be a string representation of a file in JSON format.</p>" } }, "documentation":"<p>An object containing the human loop input in JSON format.</p>" }, "HumanLoopName":{ "type":"string", "max":63, "min":1, "pattern":"^[a-z0-9](-*[a-z0-9])*$" }, "HumanLoopOutput":{ "type":"structure", "required":["OutputS3Uri"], "members":{ "OutputS3Uri":{ "shape":"String", "documentation":"<p>The location of the Amazon S3 object where Amazon Augmented AI stores your human loop output.</p>" } }, "documentation":"<p>Information about where the human output will be stored.</p>" }, "HumanLoopStatus":{ "type":"string", "enum":[ "InProgress", "Failed", "Completed", "Stopped", "Stopping" ] }, "HumanLoopSummaries":{ "type":"list", "member":{"shape":"HumanLoopSummary"} }, "HumanLoopSummary":{ "type":"structure", "members":{ "HumanLoopName":{ "shape":"HumanLoopName", "documentation":"<p>The name of the human loop.</p>" }, "HumanLoopStatus":{ "shape":"HumanLoopStatus", "documentation":"<p>The status of the human loop. </p>" }, "CreationTime":{ "shape":"Timestamp", "documentation":"<p>When Amazon Augmented AI created the human loop.</p>" }, "FailureReason":{ "shape":"FailureReason", "documentation":"<p>The reason why the human loop failed. A failure reason is returned when the status of the human loop is <code>Failed</code>.</p>" }, "FlowDefinitionArn":{ "shape":"FlowDefinitionArn", "documentation":"<p>The Amazon Resource Name (ARN) of the flow definition used to configure the human loop.</p>" } }, "documentation":"<p>Summary information about the human loop.</p>" }, "InputContent":{ "type":"string", "max":3145728 }, "InternalServerException":{ "type":"structure", "members":{ "Message":{"shape":"FailureReason"} }, "documentation":"<p>We couldn't process your request because of an issue with the server. Try again later.</p>", "error":{"httpStatusCode":500}, "exception":true }, "ListHumanLoopsRequest":{ "type":"structure", "required":["FlowDefinitionArn"], "members":{ "CreationTimeAfter":{ "shape":"Timestamp", "documentation":"<p>(Optional) The timestamp of the date when you want the human loops to begin in ISO 8601 format. For example, <code>2020-02-24</code>.</p>", "location":"querystring", "locationName":"CreationTimeAfter" }, "CreationTimeBefore":{ "shape":"Timestamp", "documentation":"<p>(Optional) The timestamp of the date before which you want the human loops to begin in ISO 8601 format. For example, <code>2020-02-24</code>.</p>", "location":"querystring", "locationName":"CreationTimeBefore" }, "FlowDefinitionArn":{ "shape":"FlowDefinitionArn", "documentation":"<p>The Amazon Resource Name (ARN) of a flow definition.</p>", "location":"querystring", "locationName":"FlowDefinitionArn" }, "SortOrder":{ "shape":"SortOrder", "documentation":"<p>Optional. The order for displaying results. Valid values: <code>Ascending</code> and <code>Descending</code>.</p>", "location":"querystring", "locationName":"SortOrder" }, "NextToken":{ "shape":"NextToken", "documentation":"<p>A token to display the next page of results.</p>", "location":"querystring", "locationName":"NextToken" }, "MaxResults":{ "shape":"MaxResults", "documentation":"<p>The total number of items to return. If the total number of available items is more than the value specified in <code>MaxResults</code>, then a <code>NextToken</code> is returned in the output. You can use this token to display the next page of results. </p>", "box":true, "location":"querystring", "locationName":"MaxResults" } } }, "ListHumanLoopsResponse":{ "type":"structure", "required":["HumanLoopSummaries"], "members":{ "HumanLoopSummaries":{ "shape":"HumanLoopSummaries", "documentation":"<p>An array of objects that contain information about the human loops.</p>" }, "NextToken":{ "shape":"NextToken", "documentation":"<p>A token to display the next page of results.</p>" } } }, "MaxResults":{ "type":"integer", "max":100, "min":1 }, "NextToken":{ "type":"string", "max":8192, "pattern":".*" }, "ResourceNotFoundException":{ "type":"structure", "members":{ "Message":{"shape":"FailureReason"} }, "documentation":"<p>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. </p>", "error":{"httpStatusCode":404}, "exception":true }, "ServiceQuotaExceededException":{ "type":"structure", "members":{ "Message":{"shape":"FailureReason"} }, "documentation":"<p>You exceeded your service quota. Service quotas, also referred to as limits, are the maximum number of service resources or operations for your AWS account. For a list of Amazon A2I service quotes, see <a href=\"https://docs.aws.amazon.com/general/latest/gr/a2i.html\">Amazon Augmented AI Service Quotes</a>. Delete some resources or request an increase in your service quota. You can request a quota increase using Service Quotas or the AWS Support Center. To request an increase, see <a href=\"https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html\">AWS Service Quotas</a> in the <i>AWS General Reference</i>.</p>", "error":{"httpStatusCode":402}, "exception":true }, "SortOrder":{ "type":"string", "enum":[ "Ascending", "Descending" ] }, "StartHumanLoopRequest":{ "type":"structure", "required":[ "HumanLoopName", "FlowDefinitionArn", "HumanLoopInput" ], "members":{ "HumanLoopName":{ "shape":"HumanLoopName", "documentation":"<p>The name of the human loop.</p>" }, "FlowDefinitionArn":{ "shape":"FlowDefinitionArn", "documentation":"<p>The Amazon Resource Name (ARN) of the flow definition associated with this human loop.</p>" }, "HumanLoopInput":{ "shape":"HumanLoopInput", "documentation":"<p>An object that contains information about the human loop.</p>" }, "DataAttributes":{ "shape":"HumanLoopDataAttributes", "documentation":"<p>Attributes of the specified data. Use <code>DataAttributes</code> to specify if your data is free of personally identifiable information and/or free of adult content.</p>" } } }, "StartHumanLoopResponse":{ "type":"structure", "members":{ "HumanLoopArn":{ "shape":"HumanLoopArn", "documentation":"<p>The Amazon Resource Name (ARN) of the human loop.</p>" } } }, "StopHumanLoopRequest":{ "type":"structure", "required":["HumanLoopName"], "members":{ "HumanLoopName":{ "shape":"HumanLoopName", "documentation":"<p>The name of the human loop that you want to stop.</p>" } } }, "StopHumanLoopResponse":{ "type":"structure", "members":{ } }, "String":{"type":"string"}, "ThrottlingException":{ "type":"structure", "members":{ "Message":{"shape":"FailureReason"} }, "documentation":"<p>You exceeded the maximum number of requests.</p>", "error":{"httpStatusCode":429}, "exception":true }, "Timestamp":{"type":"timestamp"}, "ValidationException":{ "type":"structure", "members":{ "Message":{"shape":"FailureReason"} }, "documentation":"<p>The request isn't valid. Check the syntax and try again.</p>", "error":{"httpStatusCode":400}, "exception":true } }, "documentation":"<p>Amazon Augmented AI (Amazon A2I) adds the benefit of human judgment to any machine learning application. When an AI application can't evaluate data with a high degree of confidence, human reviewers can take over. This human review is called a human review workflow. To create and start a human review workflow, you need three resources: a <i>worker task template</i>, a <i>flow definition</i>, and a <i>human loop</i>.</p> <p>For information about these resources and prerequisites for using Amazon A2I, see <a href=\"https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-getting-started.html\">Get Started with Amazon Augmented AI</a> in the Amazon SageMaker Developer Guide.</p> <p>This API reference includes information about API actions and data types that you can use to interact with Amazon A2I programmatically. Use this guide to:</p> <ul> <li> <p>Start a human loop with the <code>StartHumanLoop</code> operation when using Amazon A2I with a <i>custom task type</i>. To learn more about the difference between custom and built-in task types, see <a href=\"https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-task-types-general.html\">Use Task Types </a>. To learn how to start a human loop using this API, see <a href=\"https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-start-human-loop.html#a2i-instructions-starthumanloop\">Create and Start a Human Loop for a Custom Task Type </a> in the Amazon SageMaker Developer Guide.</p> </li> <li> <p>Manage your human loops. You can list all human loops that you have created, describe individual human loops, and stop and delete human loops. To learn more, see <a href=\"https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-monitor-humanloop-results.html\">Monitor and Manage Your Human Loop </a> in the Amazon SageMaker Developer Guide.</p> </li> </ul> <p>Amazon A2I integrates APIs from various AWS services to create and start human review workflows for those services. To learn how Amazon A2I uses these APIs, see <a href=\"https://docs.aws.amazon.com/sagemaker/latest/dg/a2i-api-references.html\">Use APIs in Amazon A2I</a> in the Amazon SageMaker Developer Guide.</p>" }
Save Changes