# AWS Glue でブループリントを登録する
<a name="registering-blueprints"></a>

AWS Glue デベロッパーが設計図をコーディングして、Amazon Simple Storage Service (Amazon S3) に ZIP アーカイブをアップロードした後、AWS Glue 管理者はその設計図を登録する必要があります。設計図は、登録されることで使用が可能になります。

ブループリントを登録すると、AWS Glue はブループリントアーカイブを予約済みの Amazon S3 ロケーションにコピーします。その後、アーカイブは、アップロードした場所から削除できます。

設計図を登録するには、アップロードされたアーカイブが保存される Amazon S3 ロケーションに対する、読み取りアクセス許可が必要です。また、AWS Identity and Access Management (IAM) のアクセス許可 `glue:CreateBlueprint` も必要です。ブループリントの登録、表示、および保守を行う必要がある AWS Glue 管理者のために、提案されているアクセス許可については、[ブループリントのための AWS Glue 管理者のアクセス許可](blueprints-personas-permissions.md#bp-persona-admin) を参照してください。

ブループリントは AWS Glue コンソール、AWS Glue API、または AWS Command Line Interface (AWS CLI) を使用して登録できます。

**設計図を登録するには (コンソール)**

1. Amazon S3 にある設計図の ZIP アーカイブに対する、読み取りアクセス許可 (`s3:GetObject`) が付与されていることを確認します。

1. [https://console.aws.amazon.com/glue/](https://console.aws.amazon.com/glue/) で AWS Glue コンソール を開きます。

   設計図を登録するための、アクセス許可が付与されたユーザーとしてサインインします。設計図の ZIP アーカイブを含む Amazon S3 バケットと同じ、AWS リージョンに切り替えます。

1. ナビゲーションペインで **[Blueprints]** (ブループリント) を選択します。次に、[**Blueprints**] (設計図) ページで [**Add blueprint**] (設計図を追加) をクリックします。

1. 設計図の名前と、必要に応じて説明を入力します。

1. [**ZIP archive location (S3)**] (ZIP アーカイブの場所 (S3))に、アップロードされた設計図の ZIP アーカイブがある Amazon S3 パスを入力します。パスの先頭は `s3://` で開始し、またアーカイブのファイル名を含めます。

1. (オプション) 1 つ以上のタグを追加します。

1. [**Add blueprint**] (設計図を追加) をクリックします。

   [**Blueprints**] (設計図) ページが再び開き、設計図のステータスが「`CREATING`」となっていることを表示します。ステータスが「`ACTIVE`」または「`FAILED`」に変わるまで、[Refresh] (更新) ボタンをクリックします。

1. ステータスが「`FAILED`」となった場合は、設計図を選択した上で、[**Actions**] (アクション) メニューで [**View**] (表示) をクリックします。

   詳細ページに、失敗の理由が表示されます。エラーメッセージが、「Unable to access object at location...」または「Access denied on object at location...」となっている場合は、以下の要件を確認してください。
   + サインインしているユーザーには、Amazon S3 内にある設計図の ZIP アーカイブに対する読み取りアクセス許可が必要です。
   + ZIP アーカイブを含む Amazon S3 バケットには、オブジェクトに対する読み取りアクセス許可を AWS アカウント ID に付与するためのバケットポリシーが必要です。(詳細については、[AWS Glue のブループリントの開発](developing-blueprints.md) を参照してください)。
   + 使用している Amazon S3 バケットは、コンソールでサインインしているリージョンと同じリージョンにあることが必要です。

1. データアナリストに、設計図へのアクセス許可が付与されていることを確認します。

   データアナリストのために提案された IAM ポリシーは、「[設計図のためのデータアナリストの権限](blueprints-personas-permissions.md#bp-persona-analyst)」で確認できます。このポリシーでは、任意のリソースに `glue:GetBlueprint` を付与します。リソースレベルでポリシーをより細かく設定している場合には、その新しく作成したリソースに対するアクセス許可をデータアナリストに付与します。

**設計図を登録するには (AWS CLI)**

1. 次のコマンドを入力します。

   ```
   aws glue create-blueprint --name <blueprint-name> [--description <description>] --blueprint-location s3://<s3-path>/<archive-filename>
   ```

1. 設計図のステータスを確認するには、次のコマンドを入力します。ステータスが `ACTIVE` または `FAILED` に変化するまで、このコマンドを繰り返します。

   ```
   aws glue get-blueprint --name <blueprint-name>
   ```

   ステータスが `FAILED` となり、エラーメッセージに「Unable to access object at location...」または「Access denied on object at location...」が出力された場合は、以下の要件を確認してください。
   + サインインしているユーザーには、Amazon S3 内にある設計図の ZIP アーカイブに対する読み取りアクセス許可が必要です。
   + ZIP アーカイブを含む Amazon S3 バケットには、オブジェクトに対する読み取りアクセス許可を AWS アカウント ID に付与するためのバケットポリシーが必要です。詳細については、[設計図を公開する](developing-blueprints-publishing.md) を参照してください。
   + 使用している Amazon S3 バケットは、コンソールでサインインしているリージョンと同じリージョンにあることが必要です。

**以下も参照してください。**  
[AWS Glue のブループリント概要](blueprints-overview.md)