Removes the association between a Face supplied in an array of FaceIds and the User¶

Description¶

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.

Usage¶

rekognition_disassociate_faces(CollectionId, UserId, ClientRequestToken,
  FaceIds)

Arguments¶

• CollectionId

  [required] The ID of an existing collection containing the UserID.

• UserId

  [required] ID for the existing UserID.

• ClientRequestToken

  Idempotent token used to identify the request to disassociate_faces. If you use the same token with multiple disassociate_faces requests, the same response is returned. Use ClientRequestToken to prevent the same request from being processed more than once.

• FaceIds

  [required] An array of face IDs to disassociate from the UserID.

Value¶

A list with the following syntax:

list(
  DisassociatedFaces = list(
    list(
      FaceId = "string"
    )
  ),
  UnsuccessfulFaceDisassociations = list(
    list(
      FaceId = "string",
      UserId = "string",
      Reasons = list(
        "FACE_NOT_FOUND"|"ASSOCIATED_TO_A_DIFFERENT_USER"
      )
    )
  ),
  UserStatus = "ACTIVE"|"UPDATING"|"CREATING"|"CREATED"
)

Request syntax¶

svc$disassociate_faces(
  CollectionId = "string",
  UserId = "string",
  ClientRequestToken = "string",
  FaceIds = list(
    "string"
  )
)