AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Removes the association between a Face supplied in an array of FaceIds
and the User. If the User is not present already, then a ResourceNotFound exception
is thrown. If successful, an array of faces that are disassociated from the User is
returned. If a given face is already disassociated from the given UserID, it will
be ignored and not be returned in the response. If a given face is already associated
with a different User or not found in the collection it will be returned as part of
UnsuccessfulDisassociations. You can remove 1 - 100 face IDs from a user at
one time.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginDisassociateFaces and EndDisassociateFaces.
Namespace: Amazon.Rekognition
Assembly: AWSSDK.Rekognition.dll
Version: 3.x.y.z
public virtual Task<DisassociateFacesResponse> DisassociateFacesAsync( DisassociateFacesRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the DisassociateFaces service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| Exception | Condition |
|---|---|
| AccessDeniedException | You are not authorized to perform the action. |
| ConflictException | A User with the same Id already exists within the collection, or the update or deletion of the User caused an inconsistent state. ** |
| IdempotentParameterMismatchException | A ClientRequestToken input parameter was reused with an operation, but at least one of the other input parameters is different from the previous call to the operation. |
| InternalServerErrorException | Amazon Rekognition experienced a service issue. Try your call again. |
| InvalidParameterException | Input parameter violated a constraint. Validate your parameter before calling the API operation again. |
| ProvisionedThroughputExceededException | The number of requests exceeded your throughput limit. If you want to increase this limit, contact Amazon Rekognition. |
| ResourceNotFoundException | The resource specified in the request cannot be found. |
| ThrottlingException | Amazon Rekognition is temporarily unable to process the request. Try your call again. |
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5 and newer