Gets the unsafe content analysis results for a Amazon Rekognition Video analysis started by StartContentModeration
Gets the unsafe content analysis results for a Amazon Rekognition Video
analysis started by
start_content_moderation.
Unsafe content analysis of a video is an asynchronous operation. You
start analysis by calling
start_content_moderation which
returns a job identifier (JobId). When analysis finishes, Amazon
Rekognition Video publishes a completion status to the Amazon Simple
Notification Service topic registered in the initial call to
start_content_moderation. To
get the results of the unsafe content analysis, first check that the
status value published to the Amazon SNS topic is SUCCEEDED. If so,
call get_content_moderation and
pass the job identifier (JobId) from the initial call to
start_content_moderation.
For more information, see Working with Stored Videos in the Amazon Rekognition Devlopers Guide.
get_content_moderation returns
detected unsafe content labels, and the time they are detected, in an
array, ModerationLabels, of ContentModerationDetection objects.
By default, the moderated labels are returned sorted by time, in
milliseconds from the start of the video. You can also sort them by
moderated label by specifying NAME for the SortBy input parameter.
Since video analysis can return a large number of results, use the
MaxResults parameter to limit the number of labels returned in a
single call to
get_content_moderation. If there
are more results than specified in MaxResults, the value of
NextToken in the operation response contains a pagination token for
getting the next set of results. To get the next page of results, call
get_content_moderation and
populate the NextToken request parameter with the value of NextToken
returned from the previous call to
get_content_moderation.
For more information, see Detecting Unsafe Content in the Amazon Rekognition Developer Guide.
rekognition_get_content_moderation(JobId, MaxResults, NextToken, SortBy)
JobId |
[required] The identifier for the unsafe content job. Use |
MaxResults |
Maximum number of results to return per paginated call. The largest value you can specify is 1000. If you specify a value greater than 1000, a maximum of 1000 results is returned. The default value is 1000. |
NextToken |
If the previous response was incomplete (because there is more data to retrieve), Amazon Rekognition returns a pagination token in the response. You can use this pagination token to retrieve the next set of unsafe content labels. |
SortBy |
Sort to use for elements in the |
A list with the following syntax:
list(
JobStatus = "IN_PROGRESS"|"SUCCEEDED"|"FAILED",
StatusMessage = "string",
VideoMetadata = list(
Codec = "string",
DurationMillis = 123,
Format = "string",
FrameRate = 123.0,
FrameHeight = 123,
FrameWidth = 123
),
ModerationLabels = list(
list(
Timestamp = 123,
ModerationLabel = list(
Confidence = 123.0,
Name = "string",
ParentName = "string"
)
)
),
NextToken = "string",
ModerationModelVersion = "string"
)svc$get_content_moderation( JobId = "string", MaxResults = 123, NextToken = "string", SortBy = "NAME"|"TIMESTAMP" )
Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.