Amazon Rekognition向けのAWS CLIコマンドでカスタムモデレーションのリソースを操作するときのオプション

--featureや--featuresオプションがある場合は、CONTENT_MODERATIONを指定することでカスタムモデレーション向けのリソースの操作ができます

#AWS

#Amazon Rekognition

#AWS CLI

nayu.t.s

2024.11.05

データ事業本部 機械学習チームの鈴木です。
先日Amazon Rekognitionのカスタムモデレーションの機能を検証しましたが、作成したプロジェクトやアダプターをAWS CLIで確認する際にオプションの指定が必要なことを学んだので、簡単にですがご紹介します。
 カスタムモデレーション向けのAWS CLIの操作について以下のガイドから、AWS CLI v2のAmazon Rekognition向けの機能を確認できます。
https://awscli.amazonaws.com/v2/documentation/api/latest/reference/rekognition/index.html
カスタムモデレーションに関する機能だと、例えば以下のコマンドが利用できます。
describe-projects: プロジェクトの情報を取得する
describe-project-versions: アダプターなどの情報を取得する
detect-moderation-labels: コンテンツモデレーションを実行する
このうち、一番上のdescribe-projectsはデフォルトオプションだとカスタムラベルのプロジェクトを表示するようになっているため、初めての方は機能を指定するオプションを覚えておくとよいでしょう。
 オプション指定してカスタムモデレーションの情報を取得するdescribe-projectsコマンドの場合、--featuresオプションでCONTENT_MODERATIONを指定することで、カスタムモデレーションの情報を取得することができます。
$ aws rekognition describe-projects --features CONTENT_MODERATION                                                                                                                                                                                              
{
    "ProjectDescriptions": [
        {
            "ProjectArn": "arn:aws:rekognition:ap-northeast-1:アカウントID:project/alcohol_raisin_moderation/1730081100686",
            "CreationTimestamp": "2024-10-28T02:05:00.686000+00:00",
            "Status": "CREATED",
            "Datasets": [],
            "Feature": "CONTENT_MODERATION",
            "AutoUpdate": "DISABLED"
        },
        {
            "ProjectArn": "arn:aws:rekognition:ap-northeast-1:アカウントID:project/alcohol_raisin/1730074582182",
            "CreationTimestamp": "2024-10-28T00:16:22.182000+00:00",
            "Status": "CREATED",
            "Datasets": [],
            "Feature": "CONTENT_MODERATION",
            "AutoUpdate": "DISABLED"
        }
    ]
}
※上記は、以下のブログの検証で作ったカスタムモデレーションのプロジェクトでした。
https://dev.classmethod.jp/articles/try-amazon-rekognition-custom-moderation/
一方、アダプターの情報を取得する際に使うdescribe-project-versionsはそのままプロジェクトARNを--project-arnで指定するだけで、カスタムモデレーション向けのプロジェクトのバージョン情報を取得できます。
$ aws rekognition describe-project-versions --project-arn プロジェクトARN
 最後にAmazon Rekognitionのカスタムモデレーションの機能をAWS CLIから利用する際、カスタムモデレーション向けの操作であることをオプションで指定することが必要な場合があるため、簡単にですがご紹介しました。
「カスタムモデレーションの操作ができないな」と思った時は、ガイドを参考に機能を指定するオプションがないか確認してみましょう。