翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# 顔とユーザーとの関連付けの解除
<a name="disassociate-faces"></a>

[DisassociateFaces](https://docs.aws.amazon.com/rekognition/latest/APIReference/API_DisassociateFaces.html) オペレーションを使用すると、ユーザー ID と顔 ID の関連付けを削除できます。

**顔の関連付けを解除するには (SDK)**

1. まだ実行していない場合:

   1. `AmazonRekognitionFullAccess` アクセス権限を持つユーザーを作成または更新します。詳細については、「[ステップ 1: AWS アカウントを設定してユーザーを作成する](setting-up.md#setting-up-iam)」を参照してください。

   1. と AWS SDKs をインストール AWS CLI して設定します。詳細については、「[ステップ 2: AWS CLI と AWS SDKsを設定する](setup-awscli-sdk.md)」を参照してください。

1. 以下の例を使用して、`DisassociateFaces` オペレーションを呼び出します。

------
#### [ Java ]

   この Java の例では、`DisassociateFaces` オペレーションを使って FaceID と UserID の関連付けを削除します。

   ```
   import java.util.Arrays;
   import java.util.List;
   
   import com.amazonaws.services.rekognition.AmazonRekognition;
   import com.amazonaws.services.rekognition.AmazonRekognitionClientBuilder;
   import com.amazonaws.services.rekognition.model.DisassociateFacesRequest;
   import com.amazonaws.services.rekognition.model.DisassociateFacesResult;
   
   
   public class DisassociateFaces {
   
       public static void main(String[] args) throws Exception {
   
   
           AmazonRekognition rekognitionClient = AmazonRekognitionClientBuilder.defaultClient();
   
           /* Replace the below configurations to allow you successfully run the example
   
              @collectionId: The collection where user and faces are stored
              @userId: The user which faces will get disassociated from
              @faceIds: The list of face IDs that will get disassociated from the given user
            */
   
           String collectionId = "MyCollection";
           String userId = "demoUser";
           String faceId1 = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
           String faceId2 = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx";
           List<String> faceIds = Arrays.asList(faceid1,faceid2);
   
           System.out.println("Disassociating faces from existing user: " +
                   userId);
   
           DisassociateFacesRequest request = new DisassociateFacesRequest()
                   .withCollectionId(collectionId)
                   .withUserId(userId)
                   .withFaceIds(faceIds)
   
           DisassociateFacesResult result = rekognitionClient.disassociateFaces(request);
   
           System.out.println("Successful face disassociations: " + result.getDisassociatedFaces().size());
           System.out.println("Unsuccessful face disassociations: " + result.getUnsuccessfulFaceDisassociations().size());
       }
   
   }
   ```

------
#### [ AWS CLI ]

   この AWS CLI コマンドは、FaceID と UserID と `DisassociateFaces`オペレーションとの関連付けを削除します。

   ```
   aws rekognition disassociate-faces --face-ids {{list-of-face-ids}}
   --user-id {{user-id}} --collection-id {{collection-name}} --region {{region-name}}
   ```

------
#### [ Python ]

   この例では、`DisassociateFaces` オペレーションを使って FaceID と UserID の関連付けを削除します。

   ```
   from botocore.exceptions import ClientError
   import boto3
   import logging
   
   logger = logging.getLogger(__name__)
   session = boto3.Session(profile_name='profile-name')
   client = session.client('rekognition')
   
   def disassociate_faces(collection_id, user_id, face_ids):
       """
       Disassociate stored faces within collection to the given user
   
       :param collection_id: The ID of the collection where user and faces are stored.
       :param user_id: The ID of the user that we want to disassociate faces from
       :param face_ids: The list of face IDs to be disassociated from the given user
   
       :return: response of AssociateFaces API
       """
       logger.info(f'Disssociating faces from user: {user_id}, {face_ids}')
       try:
           response = client.disassociate_faces(
               CollectionId=collection_id,
               UserId=user_id,
               FaceIds=face_ids
           )
           print(f'- disassociated {len(response["DisassociatedFaces"])} faces')
       except ClientError:
           logger.exception("Failed to disassociate faces from the given user")
           raise
       else:
           print(response)
           return response
   
   def main():
       face_ids = ["faceId1", "faceId2"]
       collection_id = "collection-id"
       user_id = "user-id"
       disassociate_faces(collection_id, user_id, face_ids)
   
   if __name__ == "__main__":
       main()
   ```

------

## DisassociateFaces オペレーションのレスポンス
<a name="disassociate-faces-response"></a>

`DisassociateFaces` のレスポンスには、関連付け解除のリクエストのステータスである `UserStatus` と、関連付けを解除される `FaceIds` のリストが含まれています。`UnsuccessfulFaceDisassociations` のリストも返されます。DisassociateFaces にリクエストを送信した後、オペレーションが完了するまでに 1 分ほどかかる場合があります。UserStatus が返されるのはそのためです。ステータスには以下のいずれかの値が表示されます。
+ CREATED - 「ユーザー」が正常に作成され、現時点でそれに関連付けられている顔がないことを示します。「ユーザー」は、「AssociateFaces」の呼び出しが成功するまではこのステータスを維持します。
+ UPDATING -「ユーザー」は、新たに関連付けられた/関連付けを解除された顔を反映するように更新中であり、数秒後に ACTIVE になることを示します。検索結果にこのステータスの「ユーザー」が含まれる場合、お客様は、返される結果からそのユーザーを無視することを選択できます。
+ ACTIVE - **「**ユーザー**」**が更新され、関連付けられた/関連付けを解除されたすべての顔が反映され、検索可能な状態であることを示します。

```
{
    "UserStatus": "UPDATING", 
    "DisassociatedFaces": [
        {
            "FaceId": "c92265d4-5f9c-43af-a58e-12be0ce02bc3"
        }
    ], 
    "UnsuccessfulFaceDisassociations": [
        {
            "Reasons": [
                "ASSOCIATED_TO_A_DIFFERENT_IDENTITY"
            ], 
            "FaceId": "f5817d37-94f6-4335-bfee-6cf79a3d806e", 
            "UserId": "demoUser1"
        }
    ]
}
```