Amazon Rekognition
開発者ガイド

コレクションの作成

コレクションは、CreateCollection オペレーションで作成できます。

詳細については、「コレクションの管理」を参照してください。

コレクションを作成するには (SDK)

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

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

    2. AWS CLI と AWS SDK をインストールして設定します。詳細については、「ステップ 2: AWS CLI と AWS SDK をセットアップする」を参照してください。

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

    JavaAWS CLIPython.NET
    Java

    次の例では、コレクションを作成して、その Amazon リソースネーム (ARN) を表示します。

    collectionId の値は、作成するコレクションの名前に変更します。

    //Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved. //PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.) package aws.example.rekognition.image; import com.amazonaws.services.rekognition.AmazonRekognition; import com.amazonaws.services.rekognition.AmazonRekognitionClientBuilder; import com.amazonaws.services.rekognition.model.CreateCollectionRequest; import com.amazonaws.services.rekognition.model.CreateCollectionResult; public class CreateCollection { public static void main(String[] args) throws Exception { AmazonRekognition rekognitionClient = AmazonRekognitionClientBuilder.defaultClient(); String collectionId = "MyCollection"; System.out.println("Creating collection: " + collectionId ); CreateCollectionRequest request = new CreateCollectionRequest() .withCollectionId(collectionId); CreateCollectionResult createCollectionResult = rekognitionClient.createCollection(request); System.out.println("CollectionArn : " + createCollectionResult.getCollectionArn()); System.out.println("Status code : " + createCollectionResult.getStatusCode().toString()); } }
    AWS CLI

    この AWS CLI コマンドでは、create-collection CLI オペレーションの JSON 出力を表示します。

    collection-id の値は、作成するコレクションの名前に置き換えます。

    aws rekognition create-collection \ --collection-id "collectionname"
    Python

    次の例では、コレクションを作成して、その Amazon リソースネーム (ARN) を表示します。

    collectionId の値は、作成するコレクションの名前に変更します。

    #Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved. #PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.) import boto3 if __name__ == "__main__": maxResults=2 collectionId='MyCollection' client=boto3.client('rekognition') #Create a collection print('Creating collection:' + collectionId) response=client.create_collection(CollectionId=collectionId) print('Collection ARN: ' + response['CollectionArn']) print('Status code: ' + str(response['StatusCode'])) print('Done...')
    .NET

    次の例では、コレクションを作成して、その Amazon リソースネーム (ARN) を表示します。

    collectionId の値は、作成するコレクションの名前に変更します。

    //Copyright 2018 Amazon.com, Inc. or its affiliates. All Rights Reserved. //PDX-License-Identifier: MIT-0 (For details, see https://github.com/awsdocs/amazon-rekognition-developer-guide/blob/master/LICENSE-SAMPLECODE.) using System; using Amazon.Rekognition; using Amazon.Rekognition.Model; public class CreateCollection { public static void Example() { AmazonRekognitionClient rekognitionClient = new AmazonRekognitionClient(); String collectionId = "MyCollection"; Console.WriteLine("Creating collection: " + collectionId); CreateCollectionRequest createCollectionRequest = new CreateCollectionRequest() { CollectionId = collectionId }; CreateCollectionResponse createCollectionResponse = rekognitionClient.CreateCollection(createCollectionRequest); Console.WriteLine("CollectionArn : " + createCollectionResponse.CollectionArn); Console.WriteLine("Status code : " + createCollectionResponse.StatusCode); } }

CreateCollection オペレーションのリクエスト

CreationCollection への入力は、作成するコレクションの名前です。

{ "CollectionId": "MyCollection" }

CreateCollection オペレーションのレスポンス

Amazon Rekognition はコレクションを作成し、新しく作成したコレクションの Amazon リソースネーム (ARN) を返します。

{ "CollectionArn": "aws:rekognition:us-east-1:acct-id:collection/examplecollection", "StatusCode": 200 }