翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 別の からカスタムモデルをインポートする AWS アカウント
Amazon Comprehend では、別の にあるカスタムモデルをインポートできます AWS アカウント。モデルをインポートすると、アカウントに新しいカスタムモデルが作成されます。新しいカスタムモデルは、インポートしたモデルと完全にトレーニングされたモデルの複製です。
**Topics**
+ [[開始する前に]](#custom-copy-importing-prerequisites)
+ [カスタムモデルのインポート](#custom-copy-importing-procedure)
## [開始する前に]
別の からカスタムモデルをインポートする前に AWS アカウント、モデルを共有したユーザーが以下を実行してください。
+ インポートを行う権限をユーザーに与える。この承認は、モデルバージョンに添付されているリソースベースのポリシーで付与されます。詳細については、「[カスタムモデル用のリソースベースのポリシー](custom-copy-sharing.md#custom-copy-sharing-example-policy)」を参照してください。
+ 以下に関する情報を提供します。
+ モデルバージョンの Amazon リソースネーム (ARN)。
+ モデルを含む AWS リージョン 。インポート AWS リージョン 時に同じ を使用する必要があります。
+ モデルが AWS KMS キーで暗号化されているかどうか、暗号化されている場合は、使用されるキーのタイプ。
モデルが暗号化されている場合、使用する KMS キーの種類によっては、追加の手順が必要になることがあります。
+ **AWS 所有のキー** — このタイプの KMS キーは AWSによって所有、管理されます。モデルが で暗号化されている場合 AWS 所有のキー、追加のステップは必要ありません。
+ **カスタマーマネージドキー** – このタイプの KMS キーは、 の AWS 顧客が作成、所有、管理します AWS アカウント。モデルがカスタマーマネージドキーで暗号化されている場合、モデルを共有したユーザーは次のことを行う必要があります。
+ あなたにモデルを復号することを許可する。この認可は、カスタマーマネージドキーの KMS キーポリシーで付与されます。詳細については、「[AWS KMS キーポリシーステートメント](custom-copy-sharing.md#custom-copy-sharing-prerequisites-permissions-kms)」を参照してください。
+ カスタマーマネージドキーの ARN を提供する。この ARN は、IAM サービスロールを作成するときに使用します。このロールは、モデルの暗号化に KMS キーを使用する許可を Amazon Comprehend に付与します。
### 必要なアクセス許可
カスタムモデルをインポートする前に、ユーザーまたは管理者が AWS Identity and Access Management (IAM) で必要なアクションを承認する必要があります。Amazon Comprehend ユーザーには、IAM ポリシーステートメントでのインポート権限が必要です。インポート中に暗号化または復号が必要な場合は、Amazon Comprehend に必要な AWS KMS キーを使用する権限が必要です。
### IAM ポリシーステートメント
次の例で示されているように、ユーザー、グループ、またはロールには `ImportModel` アクションを許可するポリシーが追加されている必要があります。
**Example カスタムモデルをインポートするための IAM ポリシー**
```
{
"Effect": "Allow",
"Action": [
"comprehend:ImportModel"
],
"Resource": "arn:aws:comprehend:us-west-2:111122223333:document-classifier/foo/version/*"
}
```
IAM ポリシーの作成については、「IAM ユーザーガイド」の「[IAM ポリシーの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)」を参照してください。IAM ポリシーのアタッチに関する詳細については、IAM ユーザーガイドの「[IAM アイデンティティのアクセス許可の追加および削除](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html)」を参照してください。
### AWS KMS 暗号化用の IAM サービスロール
カスタムモデルをインポートするときは、次のいずれかのケースで Amazon Comprehend に AWS KMS キーの使用を許可する必要があります。
+ カスタマーマネージドキーで暗号化されたカスタムモデルをインポートしています AWS KMS。この場合、Amazon Comprehend は KMS キーにアクセスして、インポート中にモデルを復号化する必要があります。
+ インポートによって作成された新しいカスタムモデルを暗号化し、カスタマーマネージドキーを使用する場合。この場合、できるように、インポート中にモデルを復号化Amazon Comprehend は KMS キーにアクセスする必要があります。
Amazon Comprehend にこれらの AWS KMS キーの使用を許可するには、*IAM サービスロール*を作成します。このタイプの IAM ロールにより、 AWS サービスはユーザーに代わって他の サービスのリソースにアクセスできます。サービスロールの詳細については、*IAM ユーザーガイド*の[「 AWS サービスにアクセス許可を委任するロールの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html)」を参照してください。
Amazon Comprehend コンソールを使用してインポートする場合は、Amazon Comprehend に自動的にサービスロールを作成させることができます。それ以外の場合は、インポートする前に IAM でサービスロールを作成する必要があります。
次の例で示されているように、IAM サービスロールにはアクセス許可ポリシーと信頼ポリシーが必要です。
**Example アクセス許可ポリシー**
次のアクセス許可ポリシーでは、Amazon Comprehend がカスタムモデルの暗号化と復号に使用する AWS KMS オペレーションを許可します。これにより 2 つの KMS キーへのアクセスが許可されます。
+ インポート AWS アカウント するモデルを含む に 1 つの KMS キーがあります。モデルの暗号化に使用され、Amazon Comprehend はインポート時にこれを使用してモデルを復号化します。
+ もう 1 つの KMS キーは、モデルをインポート AWS アカウント する にあります。Amazon Comprehend は、このキーを使用して、インポートによって作成された新しいカスタムモデルを暗号化します。
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kms:CreateGrant"
],
"Resource": [
"arn:aws:kms:us-west-2:111122223333:key/key-id",
"arn:aws:kms:us-west-2:444455556666:key/key-id"
]
},
{
"Effect": "Allow",
"Action": [
"kms:Decrypt",
"kms:GenerateDatakey"
],
"Resource": [
"arn:aws:kms:us-west-2:111122223333:key/key-id",
"arn:aws:kms:us-west-2:444455556666:key/key-id"
],
"Condition": {
"StringEquals": {
"kms:ViaService": [
"s3.us-west-2.amazonaws.com"
]
}
}
}
]
}
```
**Example 信頼ポリシー**
次の信頼ポリシーでは、ロールを引き受け、アクセス許可を取得することを Amazon Comprehend に許可します。`comprehend.amazonaws.com` サービスプリンシパルが `sts:AssumeRole` 操作を実行できることを許可します。[混乱した代理の防止](cross-service-confused-deputy-prevention.md)に役立つようにするには、1 つ以上のグローバル条件コンテキストキーを使用してアクセス許可の範囲を制限します。`aws:SourceAccount` には、モデルをインポートするユーザーのアカウント ID を指定します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "comprehend.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "444455556666"
}
}
}
]
}
```
------
## カスタムモデルのインポート
カスタムモデルは AWS マネジメントコンソール、、 AWS CLI、または Amazon Comprehend API を使用してインポートできます。
## AWS マネジメントコンソール
AWS マネジメントコンソールで Amazon Comprehend を使用できます。
**カスタムモデルをインポートするには**
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/comprehend/](https://console.aws.amazon.com/comprehend/) で Amazon Comprehend コンソールを開きます。
1. 左側のナビゲーションメニューの **[カスタマイズ]** で、インポートするモデルのタイプに対応するページを選択します。
1. カスタムドキュメント分類子を共有する場合は、**[カスタム分類]** を選択します。
1. カスタムエンティティレコグナイザーをインポートする場合は、**[カスタムエンティティ認識]** を選択します。
1. [**バージョンをインポート**] を選択します。
1. [**モデルバージョンをインポート**] ページに、以下のように入力します。
+ **[モデルバージョン ARN]** — インポートするモデルバージョンの ARN。
+ **[モデル名]** — インポートによって作成される新しいモデルのカスタム名。
+ **[バージョン名]** — インポートによって作成される新しいモデルのカスタム名。
1. **[モデル暗号化]** では、インポート時に作成する新しいカスタムモデルの暗号化に使用する KMS キーの種類を選択します。
+ ** AWS 所有キーの使用** – Amazon Comprehend は、ユーザーに代わって作成、管理、使用される AWS Key Management Service (AWS KMS) のキーを使用してモデルを暗号化します AWS。
+ **別の AWS KMS キーを選択する (アドバンスド)** – Amazon Comprehend は、ユーザーが管理するカスタマーマネージドキーを使用してモデルを暗号化します AWS KMS。
このオプションを選択した場合は、 にある KMS キーを選択するか AWS アカウント、キーの作成を選択して**新しい AWS KMS キー**を作成します。
1. **[サービスアクセス]** セクションで、Amazon Comprehend に必要なすべての AWS KMS キーへのアクセス権を付与します。
+ インポートしたカスタムモデルを復号化します。
+ インポートで作成した新しいカスタムモデルを暗号化します。
Amazon Comprehend が KMS キーを使用できるようにする IAM サービスロールを使用してアクセスを許可します。
[**サービスロール**] で、次のいずれかの操作を行います。
+ 使用する既存のサービスロールがある場合は、**[既存の IAM ロールを使用]** を選択します。次に、**[ロール名]** でそのロールを選択します。
+ Amazon Comprehend に自動的にロールを作成してもらいたい場合は、**[IAM ロール作成]** を選択してください。
1. ロールは Amazon Comprehend に作成するように選択した場合は、以下を実行します。
1. **[ロール名]** には、後でそのロールを認識しやすいようにロール名のサフィックスを入力します。
1. **[ソース KMS キー ARN]** には、インポートするモデルの暗号化に使用する KMS キーの ARN を入力します。Amazon Comprehend は、インポート時にこのキーを使用してモデルを復号化します。
1. (オプション) **[タグ]** セクションでは、インポートして作成した新しいカスタムモデルにタグを追加できます。カスタムモデルのタグ付けの詳細については、「[新しいリソースへのタグ付け](tagging-newtags.md)」を参照してください。
1. **[確認]** を選択します。
## AWS CLI
Amazon Comprehend を使用するには、 AWS CLIでコマンドを実行します。
**Example Import-model コマンド**
カスタムモデルをインポートするには、`import-model` コマンドを使用します。
```
$ aws comprehend import-model \
> --source-model arn:aws:comprehend:us-west-2:111122223333:document-classifier/foo/version/bar \
> --model-name importedDocumentClassifier \
> --version-name versionOne \
> --data-access-role-arn arn:aws:iam::444455556666:role/comprehendAccessRole \
> --model-kms-key-id kms-key-id
```
この例は以下のパラメータを使用します。
+ `source-model` — インポートするカスタムモデルの ARN。
+ `model-name` — インポートによって作成される新しいモデルのカスタム名。
+ `version-name` — インポートによって作成される新しいモデルバージョンのカスタム名。
+ `data-access-role-arn` – Amazon Comprehend がカスタムモデルの暗号化または復号に必要な AWS KMS キーを使用できるようにする IAM サービスロールの ARN。
+ `model-kms-key-id` — Amazon Comprehend がこのインポートで作成したカスタムモデルを暗号化するために使用する KMS キーの ARN または ID。このキーは、 AWS KMS の にある必要があります AWS アカウント。
## Amazon Comprehend API
Amazon Comprehend API を使用してカスタムモデルをインポートするには、[ImportModel](https://docs.aws.amazon.com/comprehend/latest/dg/API_ImportModel.html) API アクションを使用してください。