Client
rekognition | R Documentation |
Amazon Rekognition¶
Description¶
This is the API Reference for Amazon Rekognition Image, Amazon Rekognition Custom Labels, Amazon Rekognition Stored Video, Amazon Rekognition Streaming Video. It provides descriptions of actions, data types, common parameters, and common errors.
Amazon Rekognition Image
-
associate_faces
-
compare_faces
-
create_collection
-
create_user
-
delete_collection
-
delete_faces
-
delete_user
-
describe_collection
-
detect_faces
-
detect_labels
-
detect_moderation_labels
-
detect_protective_equipment
-
detect_text
-
disassociate_faces
-
get_celebrity_info
-
get_media_analysis_job
-
index_faces
-
list_collections
-
list_faces
-
list_users
-
recognize_celebrities
-
search_faces
-
search_faces_by_image
-
search_users
-
search_users_by_image
-
start_media_analysis_job
Amazon Rekognition Custom Labels
-
copy_project_version
-
create_dataset
-
create_project
-
create_project_version
-
delete_dataset
-
delete_project
-
delete_project_policy
-
delete_project_version
-
describe_dataset
-
describe_projects
-
describe_project_versions
-
detect_custom_labels
-
distribute_dataset_entries
-
list_dataset_entries
-
list_dataset_labels
-
list_project_policies
-
put_project_policy
-
start_project_version
-
stop_project_version
-
update_dataset_entries
Amazon Rekognition Video Stored Video
-
get_celebrity_recognition
-
get_content_moderation
-
get_face_detection
-
get_face_search
-
get_label_detection
-
get_person_tracking
-
get_segment_detection
-
get_text_detection
-
start_celebrity_recognition
-
start_content_moderation
-
start_face_detection
-
start_face_search
-
start_label_detection
-
start_person_tracking
-
start_segment_detection
-
start_text_detection
Amazon Rekognition Video Streaming Video
-
create_stream_processor
-
delete_stream_processor
-
describe_stream_processor
-
list_stream_processors
-
start_stream_processor
-
stop_stream_processor
-
update_stream_processor
Usage¶
Arguments¶
config
Optional configuration of credentials, endpoint, and/or region.
credentials:
creds:
access_key_id: AWS access key ID
secret_access_key: AWS secret access key
session_token: AWS temporary session token
profile: The name of a profile to use. If not given, then the default profile is used.
anonymous: Set anonymous credentials.
endpoint: The complete URL to use for the constructed client.
region: The AWS Region used in instantiating the client.
close_connection: Immediately close all HTTP connections.
timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds.
s3_force_path_style: Set this to
true
to force the request to use path-style addressing, i.e.http://s3.amazonaws.com/BUCKET/KEY
.sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html
credentials
Optional credentials shorthand for the config parameter
creds:
access_key_id: AWS access key ID
secret_access_key: AWS secret access key
session_token: AWS temporary session token
profile: The name of a profile to use. If not given, then the default profile is used.
anonymous: Set anonymous credentials.
endpoint
Optional shorthand for complete URL to use for the constructed client.
region
Optional shorthand for AWS Region used in instantiating the client.
Value¶
A client for the service. You can call the service's operations using
syntax like svc$operation(...)
, where svc
is the name you've
assigned to the client. The available operations are listed in the
Operations section.
Service syntax¶
svc <- rekognition(
config = list(
credentials = list(
creds = list(
access_key_id = "string",
secret_access_key = "string",
session_token = "string"
),
profile = "string",
anonymous = "logical"
),
endpoint = "string",
region = "string",
close_connection = "logical",
timeout = "numeric",
s3_force_path_style = "logical",
sts_regional_endpoint = "string"
),
credentials = list(
creds = list(
access_key_id = "string",
secret_access_key = "string",
session_token = "string"
),
profile = "string",
anonymous = "logical"
),
endpoint = "string",
region = "string"
)
Operations¶
- associate_faces
- Associates one or more faces with an existing UserID
- compare_faces
- Compares a face in the source input image with each of the 100 largest faces detected in the target input image
- copy_project_version
- This operation applies only to Amazon Rekognition Custom Labels
- create_collection
- Creates a collection in an AWS Region
- create_dataset
- This operation applies only to Amazon Rekognition Custom Labels
- create_face_liveness_session
- This API operation initiates a Face Liveness session
- create_project
- Creates a new Amazon Rekognition project
- create_project_version
- Creates a new version of Amazon Rekognition project (like a Custom Labels model or a custom adapter) and begins training
- create_stream_processor
- Creates an Amazon Rekognition stream processor that you can use to detect and recognize faces or to detect labels in a streaming video
- create_user
- Creates a new User within a collection specified by CollectionId
- delete_collection
- Deletes the specified collection
- delete_dataset
- This operation applies only to Amazon Rekognition Custom Labels
- delete_faces
- Deletes faces from a collection
- delete_project
- Deletes a Amazon Rekognition project
- delete_project_policy
- This operation applies only to Amazon Rekognition Custom Labels
- delete_project_version
- Deletes a Rekognition project model or project version, like a Amazon Rekognition Custom Labels model or a custom adapter
- delete_stream_processor
- Deletes the stream processor identified by Name
- delete_user
- Deletes the specified UserID within the collection
- describe_collection
- Describes the specified collection
- describe_dataset
- This operation applies only to Amazon Rekognition Custom Labels
- describe_projects
- Gets information about your Rekognition projects
- describe_project_versions
- Lists and describes the versions of an Amazon Rekognition project
- describe_stream_processor
- Provides information about a stream processor created by CreateStreamProcessor
- detect_custom_labels
- This operation applies only to Amazon Rekognition Custom Labels
- detect_faces
- Detects faces within an image that is provided as input
- detect_labels
- Detects instances of real-world entities within an image (JPEG or PNG) provided as input
- detect_moderation_labels
- Detects unsafe content in a specified JPEG or PNG format image
- detect_protective_equipment
- Detects Personal Protective Equipment (PPE) worn by people detected in an image
- detect_text
- Detects text in the input image and converts it into machine-readable text
- disassociate_faces
- Removes the association between a Face supplied in an array of FaceIds and the User
- distribute_dataset_entries
- This operation applies only to Amazon Rekognition Custom Labels
- get_celebrity_info
- Gets the name and additional information about a celebrity based on their Amazon Rekognition ID
- get_celebrity_recognition
- Gets the celebrity recognition results for a Amazon Rekognition Video analysis started by StartCelebrityRecognition
- get_content_moderation
- Gets the inappropriate, unwanted, or offensive content analysis results for a Amazon Rekognition Video analysis started by StartContentModeration
- get_face_detection
- Gets face detection results for a Amazon Rekognition Video analysis started by StartFaceDetection
- get_face_liveness_session_results
- Retrieves the results of a specific Face Liveness session
- get_face_search
- Gets the face search results for Amazon Rekognition Video face search started by StartFaceSearch
- get_label_detection
- Gets the label detection results of a Amazon Rekognition Video analysis started by StartLabelDetection
- get_media_analysis_job
- Retrieves the results for a given media analysis job
- get_person_tracking
- Gets the path tracking results of a Amazon Rekognition Video analysis started by StartPersonTracking
- get_segment_detection
- Gets the segment detection results of a Amazon Rekognition Video analysis started by StartSegmentDetection
- get_text_detection
- Gets the text detection results of a Amazon Rekognition Video analysis started by StartTextDetection
- index_faces
- Detects faces in the input image and adds them to the specified collection
- list_collections
- Returns list of collection IDs in your account
- list_dataset_entries
- This operation applies only to Amazon Rekognition Custom Labels
- list_dataset_labels
- This operation applies only to Amazon Rekognition Custom Labels
- list_faces
- Returns metadata for faces in the specified collection
- list_media_analysis_jobs
- Returns a list of media analysis jobs
- list_project_policies
- This operation applies only to Amazon Rekognition Custom Labels
- list_stream_processors
- Gets a list of stream processors that you have created with CreateStreamProcessor
- list_tags_for_resource
- Returns a list of tags in an Amazon Rekognition collection, stream processor, or Custom Labels model
- list_users
- Returns metadata of the User such as UserID in the specified collection
- put_project_policy
- This operation applies only to Amazon Rekognition Custom Labels
- recognize_celebrities
- Returns an array of celebrities recognized in the input image
- search_faces
- For a given input face ID, searches for matching faces in the collection the face belongs to
- search_faces_by_image
- For a given input image, first detects the largest face in the image, and then searches the specified collection for matching faces
- search_users
- Searches for UserIDs within a collection based on a FaceId or UserId
- search_users_by_image
- Searches for UserIDs using a supplied image
- start_celebrity_recognition
- Starts asynchronous recognition of celebrities in a stored video
- start_content_moderation
- Starts asynchronous detection of inappropriate, unwanted, or offensive content in a stored video
- start_face_detection
- Starts asynchronous detection of faces in a stored video
- start_face_search
- Starts the asynchronous search for faces in a collection that match the faces of persons detected in a stored video
- start_label_detection
- Starts asynchronous detection of labels in a stored video
- start_media_analysis_job
- Initiates a new media analysis job
- start_person_tracking
- Starts the asynchronous tracking of a person's path in a stored video
- start_project_version
- This operation applies only to Amazon Rekognition Custom Labels
- start_segment_detection
- Starts asynchronous detection of segment detection in a stored video
- start_stream_processor
- Starts processing a stream processor
- start_text_detection
- Starts asynchronous detection of text in a stored video
- stop_project_version
- This operation applies only to Amazon Rekognition Custom Labels
- stop_stream_processor
- Stops a running stream processor that was created by CreateStreamProcessor
- tag_resource
- Adds one or more key-value tags to an Amazon Rekognition collection, stream processor, or Custom Labels model
- untag_resource
- Removes one or more tags from an Amazon Rekognition collection, stream processor, or Custom Labels model
- update_dataset_entries
- This operation applies only to Amazon Rekognition Custom Labels
- update_stream_processor
- Allows you to update a stream processor
Examples¶
## Not run:
svc <- rekognition()
# This operation associates one or more faces with an existing UserID.
svc$associate_faces(
ClientRequestToken = "550e8400-e29b-41d4-a716-446655440002",
CollectionId = "MyCollection",
FaceIds = list(
"f5817d37-94f6-4335-bfee-6cf79a3d806e",
"851cb847-dccc-4fea-9309-9f4805967855",
"35ebbb41-7f67-4263-908d-dd0ecba05ab9"
),
UserId = "DemoUser",
UserMatchThreshold = 70L
)
## End(Not run)