AWS Import/Export - 開発者ガイド

AWS Import/Export
開発者ガイド
AWS Import/Export: 開発者ガイド
Copyright © 2017 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.
AWS Import/Export 開発者ガイド
Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's, in any manner
that is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks not
owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by
Amazon.
AWS Import/Export 開発者ガイド
Table of Contents
AWS Import/Export Disk とは ............................................................................................................... 1
AWS Import/Export Disk の概要 .................................................................................................... 1
Disk の機能 ............................................................................................................................... 2
Disk を初めてお使いになる方向けの情報 ........................................................................................ 2
使用できるツール、ライブラリ、およびインターフェイス ................................................................ 2
AWS Import/Export Disk ジョブ .................................................................................................... 2
ジョブの概要 ..................................................................................................................... 3
暗号化 ............................................................................................................................... 3
ジョブタイプ ..................................................................................................................... 4
関連する概念 ..................................................................................................................... 5
料金表 ....................................................................................................................................... 5
返品 .................................................................................................................................. 5
ご利用開始にあたって ................................................................................................................. 6
AWS Import/Export を使用する前に ....................................................................................... 6
AWS にサインアップする .................................................................................................... 6
AWS Import/Export ウェブサービスツールのダウンロード ........................................................ 6
認証情報のファイルへの保存 ................................................................................................ 7
インポートジョブの作成 ...................................................................................................... 8
エクスポートジョブの作成 ................................................................................................. 20
次のステップ .................................................................................................................... 24
AWS Import/Export Disk での IAM の使用 .................................................................................... 25
ジョブへのアクセスの制御 ................................................................................................. 25
AWS リソースに対するアクセス権限の付与 .......................................................................... 27
インポートジョブの使用 ............................................................................................................ 28
Amazon S3 インポートジョブの作成 ................................................................................... 28
Amazon EBS インポートジョブの作成 ................................................................................. 30
Amazon Glacier インポートジョブの作成 ............................................................................. 33
インポートマニフェストの作成 ........................................................................................... 34
CreateJob リクエストの送信 .............................................................................................. 42
インポートログの表示 ....................................................................................................... 47
エクスポートジョブの使用 ......................................................................................................... 50
Amazon S3 エクスポートジョブの作成 ................................................................................ 50
エクスポートマニフェストの作成 ........................................................................................ 52
Import/Export ログの表示 ................................................................................................... 57
ストレージデバイスの配送 ......................................................................................................... 57
ストレージデバイスの要件 ................................................................................................. 58
Amazon S3 インポートジョブおよびエクスポートジョブ用のストレージデバイスの準備 ............. 58
Amazon EBS および Amazon Glacier インポートジョブ用のストレージデバイスの準備 ............... 59
データの暗号化 ................................................................................................................. 60
ストレージデバイスの梱包 ................................................................................................. 62
前払い配送ラベルの生成 .................................................................................................... 63
複数デバイスの配送 .......................................................................................................... 64
ストレージデバイスの送付 ................................................................................................. 65
ジョブの管理 ............................................................................................................................ 66
ジョブのリスト ................................................................................................................. 66
ジョブの更新 .................................................................................................................... 66
配送情報の取得 ................................................................................................................. 67
ジョブのステータスの取得 ................................................................................................. 68
ジョブのキャンセル .......................................................................................................... 68
失敗したジョブ ................................................................................................................. 69
マニフェストファイルオプションのリファレンス ........................................................................... 69
マニフェストファイルの共通オプション ............................................................................... 70
マニフェストファイルの関税オプション ............................................................................... 73
Amazon S3 へのインポートのマニフェストファイルオプション ............................................... 77
iii
AWS Import/Export 開発者ガイド
Amazon EBS へのインポートのマニフェストファイルオプション ............................................ 85
Amazon Glacier へのインポートのマニフェストファイルオプション ......................................... 88
Amazon S3 からのエクスポートにおけるマニフェストファイルオプション ............................... 90
API リファレンス ...................................................................................................................... 96
クエリリクエストを行う .................................................................................................... 96
アクション ..................................................................................................................... 100
共通のクエリパラメーター ................................................................................................ 121
エラーとステータスコード ................................................................................................ 122
ガイドラインおよび制限 ........................................................................................................... 125
AWS Import/Export Disk 機能付録 ............................................................................................. 127
付録 A: その他のツールとサービス .................................................................................... 127
付録 B: 例 ...................................................................................................................... 127
付録 C: MIME タイプのファイル拡張子 .............................................................................. 135
付録 D: Disk リソース ..................................................................................................... 135
ドキュメント履歴 ............................................................................................................................ 136
iv
AWS Import/Export 開発者ガイド
AWS Import/Export Disk の概要
AWS Import/Export Disk とは
AWS Import/Export は、物理ストレージアプライアンスを使用し、インターネットを迂回して AWS との
大容量データ転送を高速化するサービスです。AWS Import/Export には、2 つの異なる方法でこの機能を
サポートする 2 つの機能、AWS Snowball と AWS Import/Export Disk (Disk) があります。
AWS Import/Export Disk は、元は AWS が提供する唯一のメールによるデータ転送サービスでした。Disk
では、Amazon の高速内部ネットワークを駆使し、直接お客様所有のストレージデバイスとのデータ転送
をサポートします。
AWS Import/Export Disk の概要
AWS Import/Export Disk (Disk) は、AWS クラウドとお客様が当社にお送りいただくポータブルストレー
ジデバイス間で、データの転送を高速化します。Disk は、Amazon Simple Storage Service (Amazon
S3)、Amazon Glacier、または Amazon Elastic Block Store (Amazon EBS) にインポートするデータが 16
テラバイト (TB) 以下である場合に適切です。Disk を使用して Amazon S3 からデータをエクスポートする
こともできます。
通常、データの読み込みは、お客様のストレージデバイスが AWS に到着後、翌営業日から開始されま
す。データのエクスポートまたはインポートの完了後、ストレージデバイスはお返しします。ほとんどの
データセットの場合、Disk はインターネット転送の場合よりもかなり高速であり、お客様の接続性をアッ
プグレードする場合よりも費用効率が高くなります。>Disk では、Amazon EBS または Amazon Glacier
からのエクスポートはサポートされません。
Important
このガイドでは、お客様が Amazon S3 ユーザー、Amazon Glacier ユーザー、または Amazon
EBS データを扱う Amazon Elastic Compute Cloud (EC2) ユーザーであることを前提としていま
す。上記に当てはまらない場合は、Amazon S3 入門ガイド、Amazon Glacier 開発者ガイド、ま
たは Amazon EC2 入門ガイドの Amazon EBS データを参照してください。
代わりに、AWS Import/Export の新機能である AWS Snowball (Snowball) が、Amazon Simple Storage
Service (Amazon S3) にデータをインポートする場合は一般的に Disk を使用するよりも高速で安価で
す。Snowball の詳細については、『AWS Snowball User's Guide』を参照してください。
1
AWS Import/Export 開発者ガイド
Disk の機能
Disk の機能
Disk を使用すると、次の機能が提供されます。
• ジョブあたり最大 16 TB のデータを AWS Cloud に移行する。—データを保存した 1 つ以上のストレー
ジデバイスを当社に送付する。当社でお客さまのデータを AWS クラウドにロードし、ストレージデバ
イスを返送します。
• コンテンツ配信—お客様のストレージデバイスに Amazon S3 からデータをエクスポートして顧客に配
送します。
• ダイレクトデータ交換—ビジネス上のパートナーから定期的にポータブルストレージデバイスでデータ
を受け取るなら、それを AWS に直接送付してもらって、Amazon EBS、Amazon S3、または Amazon
Glacier にインポートできます。
• オフサイトのバックアップ—完全または増分バックアップを Amazon S3 に送付して、信頼性の高い、
冗長なオフサイトストレージを構築できます。
• 災害対策—Amazon S3 に保存されている大きなバックアップをすぐに取り出す必要がある場合、AWS
Import/Export を使用してポータブルストレージデバイスへデータを転送し、お客様のサイトへ配信でき
ます。
Disk を初めてお使いになる方向けの情報
Disk を使用するのが初めての場合は、以下のリンクがすぐに始める役に立ちます。
• Amazon S3 インポートジョブの作成 (p. 28)
• Amazon EBS インポートジョブの作成 (p. 30)
• Amazon Glacier インポートジョブの作成 (p. 33)
• Amazon S3 エクスポートジョブの作成 (p. 50)
使用できるツール、ライブラリ、およびインター
フェイス
AWS Import/Export は、コードを書かないでインポートジョブやエクスポートジョブを作成できるコマン
ドラインツールを提供しています。プログラミングインターフェイスを必要とするアプリケーションで
は、AWS SDK の Java、.NET、および PHP ライブラリを使用してインポートジョブやエクスポートジョ
ブを作成、管理できます。また、任意で REST インターフェイスを AWS Import/Export で使用することも
できます。
AWS Import/Export をサポートするサードパーティーのツールもあります。詳細については、http://
aws.amazon.com/importexport/disk/tools を参照してください。
AWS Import/Export Disk ジョブ
トピック
• ジョブの概要 (p. 3)
• 暗号化 (p. 3)
2
AWS Import/Export 開発者ガイド
ジョブの概要
• ジョブタイプ (p. 4)
• 関連する概念 (p. 5)
このセクションでは、AWS Import/Export Disk ジョブおよびジョブタイプについて説明します。
ジョブの概要
AWS Import/Export ジョブは 2 つのステップで作成します。最初に、AWS にジョブリクエストを送信しま
す。各 AWS Import/Export ジョブは、1 つのストレージデバイスに正確に対応しています。ジョブリクエ
ストは AWS Import/Export のコマンドラインツールを使用して送信します。プログラミングの必要はあり
ません。アプリケーションでプログラミングインターフェイスが必要な場合は、AWS SDK または REST
API を使用できます。次に、AWS にストレージデバイスを送信します。当社の高帯域幅ネットワークを
使用して、お客様のデータを AWS にインポートまたは AWS からストレージデバイスにデータをエクス
ポートしたのち、デバイスを返送します。
デバイスごとに個別のジョブリクエストを送信する必要があります。
Note
複数のデバイスを同じ発送で配送できます。ただし、配送できるデバイスやデバイスの梱包方法
に関して、特定のガイドラインおよび制限があります。配送品が正しく準備され梱包されていな
い場合は、AWS Import/Export でジョブを処理できません。一度に配送するデバイスの数に関係
なく、デバイスごとに個別のジョブリクエストを送信する必要があります。複数のデバイスを発
送する際の梱包要件に関する詳細は、「複数デバイスの配送 (p. 64)」を参照してください。
暗号化
高度なセキュリティでは、AWS Import/Export では次のデータ暗号方式をサポートしています。
PIN コード暗号化
データへのアクセスに物理 PIN パッドを使用するハードウェアベースのデバイス暗号化です。
TrueCrypt ソフトウェア暗号化
オープンソース暗号化アプリケーションである TrueCrypt を使用したディスク暗号化です。
AWS Import/Export のすべてのエクスポートジョブでは暗号化が必須です。エクスポートジョブの場合、
ハードウェア暗号化またはソフトウェア暗号化のいずれかを使用できます。必要に応じて、両方の方式を
使用することもできます。
すべてのインポートジョブで、データの暗号化を強くお勧めします。
Amazon S3 へのインポートの場合、AWS では、PIN コード暗号化または TrueCrypt ソフトウェア暗号
化、または両方とも使用したデバイスレベルの暗号化がサポートされています。必要に応じて、任意のソ
フトウェア暗号化を使用してデバイスのファイルオブジェクトを暗号化できます。AWS でデバイスを復号
化せずにデバイスのオブジェクトをリストできる必要がありますが、オブジェクトの復号は行いません。
Amazon Glacier または Amazon EBS へのインポートの場合は、PIN コード暗号化または任意のソフト
ウェア暗号化、または両方とも使用したデバイスレベルの暗号化がサポートされています。AWS では
Amazon Glacier または Amazon EBS へのインポートの際にソフトウェア暗号化されたデバイスを復号化
しません。デバイス全体を直接コピーしてインポートします。
インポートジョブやエクスポートのジョブの作成時に、選択した暗号化手段の PIN コードやパスワードを
指定する必要があります。詳細については、「データの暗号化 (p. 60)」を参照してください。
3
AWS Import/Export 開発者ガイド
ジョブタイプ
ジョブタイプ
各ジョブタイプについて、次の表にデータのソース (デバイスまたは Amazon S3 バケット)、データの移
動先、ジョブ完了時に予想される結果を示します。
Amazon S3 へインポート
送信元
ターゲット
結果
• デバイスのファイルシス
テム上のファイル。
• 既存の Amazon S3 バ
ケット内のオブジェク
ト。
• インポートジョブごとに
1 つのバケット。
• データを暗号化した場合
は、インポートを実行す
る前に復号化されます。
• ファイルごとに 1 つのオブジェ
クト
• インポートジョブごとに
1 つのデバイス。
• データを暗号化すること
をお勧めします。「デー
タの暗号化 (p. 60)」
を参照してください。
• マニフェストファイルオプショ
ンを使用して、ファイルやディ
レクトリを除外したり名前変更
したりできます。
• AWS はすべてのジョブが完了
した後、返送前にデバイスを消
去。
Amazon S3 からのエクスポート
送信元
ターゲット
結果
• 1 つ以上の Amazon S3
バケット内のオブジェク
ト。
• 各エクスポートジョブで
複数のバケットからエク
スポートできます。
• ストレージデバイス上の
ファイル。
• オブジェクトごとに 1 つのファ
イル。
• エクスポートジョブごと
に 1 つのデバイス。
• AWS のすべてのエク
スポートジョブでは
デバイス暗号化が必須
です。「データの暗号
化 (p. 60)」を参照し
てください。
• AWS はデータを暗号化
されたデバイスまたはデ
バイス内の暗号化された
ファイルコンテナ、また
はその両方にコピーしま
す。
• 複数のバケットを指定できま
す。また、マニフェストファイ
ルオプションを使用してエクス
ポートするファイルを指定でき
ます。
• AWS がデバイスを
フォーマット。
• 暗号化されたファイルにアクセ
スするには、サポートされてい
る暗号化機能のいずれかを使用
する必要があります。
Amazon Glacier へのインポート
送信元
ターゲット
結果
• デバイス全体。
• 既存の Amazon Glacier
ボールト内にアーカイブ
1 つ。
• インポートジョブごとに
1 つのアーカイブ。
• PIN コードで保護された
デバイスを送付する場
合、AWS は指定された
PIN コードを使用してデ
バイスにアクセスしま
す。
• 単一のアーカイブとして保存さ
れたデバイスイメージ。
• インポートジョブごとに
1 つのデバイス。
• デバイスを暗号化するこ
とをお勧めします。
• PIN コードで保護された
デバイスを送付する場
合、ジョブリクエストと
ともに PIN コードを提
供する必要があります。
• データがソフトウェア暗
号化を使用して暗号化さ
れている場合、AWS で
はデータを復号化しませ
ん。
4
• デバイスのファイルシステムが
マウントされることはありませ
ん。
• AWS はすべてのジョブが完了
した後、返送前にデバイスを消
去。
AWS Import/Export 開発者ガイド
関連する概念
Amazon EBS へインポート
Important
Disk では、16 TB の Amazon EBS へのインポートをサポートしています。これま
では、1 TB のインポートのみがサポートされていました。
Amazon EBS インポートにより、デバイス仮想コピーが単一イメージとして作成さ
れます。Amazon EBS ボリュームの最大サイズは 16 TB です。デバイスの最大容量
は、デバイスに保存されたデータ量とは別であることに注意してください。
送信元
ターゲット
結果
• デバイス全体。
• 1 つの Amazon EBS ス
ナップショット。
• 単一のスナップショットとして
保存されたデバイスイメージ。
• インポートジョブごとに
1 つのデバイス。
• デバイスを暗号化するこ
とをお勧めします。
• インポートジョブごと
• デバイスのファイルシステムは
に 1 つのスナップショッ
自動的に Amazon EC2 インス
ト。
タンスにマウントされません。
• PIN コードで保護された • デバイスが暗号化されていた場
デバイスを送付する場
合、デバイスイメージも暗号化
合、AWS は指定された
されます。
PIN コードを使用してデ • AWS はすべてのジョブが完了
バイスにアクセスしま
した後、返送前にデバイスを消
す。
去。
• データがソフトウェア暗
号化を使用して暗号化さ
れている場合、AWS で
はデータを復号化しませ
ん。
関連する概念
• Amazon S3 の詳細については、「Amazon S3 の概要」を参照してください。
• Amazon EBS の詳細については、「Amazon Elastic Block Store」を参照してください。
• Amazon Glacier の詳細については、「Amazon Glacier」を参照してください。
• AWS Import/Export ジョブでサポートが必要な場合は、AWS サポートセンターにお問い合わせくださ
い。
料金表
インポート後にデバイスを消去するために必要な時間は課金されません。また、デバイスを復号化または
暗号化するための時間も課金されることはありません。AWS Import/Export Disk Calculator を使用して、
コストを見積もることができます。
返品
返送料金は、お客様の AWS ストレージの場所と返送先に応じて決まります。一旦お客様のパッケージが
返品お届け先住所への発送準備ができると、適用可能な返品発送料金が課金されます。返送料金は、AWS
Import/Export Calculator を使用して見積ることができます。
5
AWS Import/Export 開発者ガイド
ご利用開始にあたって
ご利用開始にあたって
「ご利用開始にあたって」セクションでは、AWS Import/Export ジョブを設定して作成する詳しい手順を
示します。
AWS Import/Export を使用する前に
AWS Import/Export は Amazon Simple Storage Service (Amazon S3) バケットとのデータのアップロード
とダウンロード、および Amazon Elastic Block Store (Amazon EBS) スナップショットと Amazon Glacier
ボールトへのデータのアップロードをサポートします。AWS Import/Export の「ご利用開始にあたって」
のステップでは、Amazon S3、Amazon EBS、または Amazon Glacier をすでに使用していることを前提
としています。
Amazon S3 との間でデータをアップロードまたはダウンロードするには、既存の Amazon S3 アカウント
が必要であるとともに、Amazon S3 に精通している必要があります。詳細については、「Amazon S3 入
門ガイド」を参照してください。
Amazon EC2 用の Amazon EBS スナップショットにデータをアップロードするには、既存の Amazon
EC2 インスタンスをデータに関連付け、Amazon S3 バケットで AWS Import/Export ログファイルを保
存する必要があります。Amazon EC2 および Amazon EBS の詳細については、「Amazon Elastic Block
Store」を参照してください。
Amazon Glacier ボールトにデータをアップロードするには、Amazon Glacier ボールトをデータに関連
付け、Amazon S3 バケットで AWS Import/Export ログファイルを保存する必要があります。Amazon
Glacier の詳細については、「Amazon Glacier」を参照してください。
次 AWS にサインアップする (p. 6).
AWS にサインアップする
AWS Import/Export を使用するには、AWS アカウントが必要です。すでに AWS アカウントをお持ちの場
合は、自動的に AWS Import/Export サービスにサインアップされます。AWS アカウントをお持ちでない
場合は、アマゾン ウェブ サービスのホームページにアクセスしてサインアップしてください。
次: AWS Import/Export ウェブサービスツールのダウンロード (p. 6).
AWS Import/Export ウェブサービスツールのダウン
ロード
プログラミングが不要なコマンドラインツールを使用して、AWS Import/Export ジョブを作成できます。
アプリケーションでプログラムによるアクセスが必要な場合は、AWS SDK for Java または REST API を
使用して AWS にリクエストを送信できます。この「ご利用開始にあたって」では、インポートジョブ
やエクスポートジョブを作成および管理するためのオープンソースのコマンドラインツールである AWS
Import/Export ウェブサービスツールを使用します。
Important
AWS Import/Export ウェブサービスツールでは Java SE 8 を実行する必要があります。
AWS Import/Export ウェブサービスツールをダウンロードするには
1.
[http://awsimportexport.s3.amazonaws.com/importexport-webservice-tool.zip] をクリックします。
6
AWS Import/Export 開発者ガイド
認証情報のファイルへの保存
2.
コンピューター上のディレクトリに、圧縮されたコンテンツを展開します。
AWS Command Line Interface (AWS CLI) を使用して AWS Import/Export ジョブを作成および管理するオ
プションもあります。AWS CLI のインストールと使用については、『AWS コマンドラインインターフェ
イスユーザーガイド』の「AWS コマンドラインインターフェイスの設定」を参照してください。AWS
Import/Export コマンド用の AWS CLI リファレンスと、役に立つ例が、『AWS CLI リファレンス』の
「importexport」コマンドのセクションに記載されています。
次のタスクでは、AWSCredentials.properties ファイルに AWS 認証情報を追加します。
次: 認証情報のファイルへの保存 (p. 7).
認証情報のファイルへの保存
AWS Import/Export では、AWS Identity and Access Management (IAM) を使用して、AWS Import/Export
ジョブを作成、変更、表示、またはキャンセルできる AWS アカウントのユーザーを管理します。IAM
ユーザーを作成し、それらの IAM ユーザーに認証情報を使用して AWS Import/Export ジョブを作成およ
び管理することを強くお勧めします。詳細については、「AWS Import/Export Disk ジョブへのアクセス制
御 (p. 25)」を参照してください。
Important
AWS Import/Export ジョブを作成する IAM ユーザーには、ジョブに関連付けられた Amazon S3
バケットへの読み取りおよび書き込みアクセスも必要です。さらに、Amazon Glacier へのイン
ポートには Amazon Glacier ボールトが必要です。そのユーザーには、AWS Import/Export ジョブ
が完了するまで、必要なリソースへのアクセス権が必要です。必要な特定のアクセス権限のリス
トについては、「関連する AWS リソースに対するアクセス権限の付与 (p. 27)」を参照してく
ださい。
このステップでは、AWS Import/Export ウェブサービスツールが提供する AWSCredentials.properties
ファイルに AWS IAM ユーザー認証情報を追加します。以下では、必要なステップについて詳しく説明し
ます。
アクセス認証情報をファイルに保存するには
1.
IAM アクセス認証情報を見つけます。IAM アクセス認証情報を持っていない場合、それを自分で作成
するか、IAM を管理する権限を持っているユーザーに作成してもらう必要があります。詳細について
は、「IAM ユーザーのアクセスキーの管理」を参照してください。
Note
アクセスキーを作成するときが、そのユーザーのシークレットアクセスキーを表示して保存
する唯一の機会です。必ずアクセスキーをダウンロードし、安全な場所に保存します。AWS
マネジメントコンソールを使用してシークレットアクセスキーを後で再び表示することはで
きません。それが使用できなくなった場合、新しいアクセスキーを作成する必要がありま
す。
2.
3.
AWS Import/Export ウェブサービスツールをインストールしたディレクトリに移動します。
任意のテキストエディタを使用して、このディレクトリから AWSCredentials.properties ファイルを
開きます。
4.
accessKeyId および secretKey を指定してファイルを更新します。認証情報ファイルの例は次のよう
になります。
# Fill in your AWS Access Key ID and Secret Access Key
# http://aws.amazon.com/security-credentials
accessKeyId:<###### ID>
secretKey:<########>
7
AWS Import/Export 開発者ガイド
インポートジョブの作成
5.
ファイルを保存します。
Important
認証情報を保護するため、ファイルは必ず安全な場所に保存してください。ここで
は、Import/Export ウェブサービスツールと同じディレクトリに認証情報を保存し、このディ
レクトリが安全な場所であることを前提としています。認証情報ファイルが別の場所にある
場合は、コマンドラインを変更してその場所を参照できます。
これで、インポートまたはエクスポートのサンプルジョブを作成する準備が整いました。
次:
インポートジョブの作成 (p. 8)。
最初の Amazon S3 エクスポートジョブの作成 (p. 20)。
インポートジョブの作成
ハードウェアストレージデバイスから Amazon S3 バケット、Amazon EBS スナップショット、または
Amazon Glacier ボールトにデータを移動するインポートジョブを作成できます。
以下のセクションでは、インポートの種類ごとにタスクを完了するステップを示します。
• Amazon S3 バケットにデータをアップロードするには: 「最初の Amazon S3 インポートジョブの作
成 (p. 8)」
• Amazon EBS スナップショットにデータをアップロードするには: 「最初の Amazon EBS インポート
ジョブの作成 (p. 12)」
• Amazon Glacier ボールトにデータをアップロードするには: 「最初の Amazon Glacier インポートジョブ
の作成 (p. 16)」
最初の Amazon S3 インポートジョブの作成
Amazon S3 インポートを使用して、AWS はお客様のデバイスから個々のファイルを Amazon S3 バケッ
トのオブジェクトにアップロードします。
当社に送信する前に、データを暗号化することをお勧めします。Amazon S3 へのインポートでは、PIN
コードで保護されたデバイスを提供するか、TrueCrypt ソフトウェアの暗号化を使用してデータを暗号化
する (またはその両方) ことができます。インポートジョブの作成時に、マニフェストで PIN コードまたは
パスワードを指定する必要があります。詳細については、「データの暗号化 (p. 60)」を参照してくださ
い。
データを暗号化する場合、そのデータはユーザーが提供する PIN コードまたは TrueCrypt パスワードを使
用して復号されます。お客様のデバイスのファイルシステムは、AWS Import/Export データロードステー
ションにマウントされ、各ファイルは Amazon S3 内のオブジェクトとしてアップロードされます。ロー
ドプロセスの一部として任意でディレクトリおよびファイル名を管理できます。
インポートオペレーションが完了すると、送付する前に AWS Import/Export によってデバイスが消去され
ます。
デバイスごとに個別のジョブリクエストを送信する必要があります。
Note
複数のデバイスを同じ発送で配送できます。ただし、配送できるデバイスやデバイスの梱包方法
に関して、特定のガイドラインおよび制限があります。配送品が正しく準備され梱包されていな
8
AWS Import/Export 開発者ガイド
インポートジョブの作成
い場合は、AWS Import/Export でジョブを処理できません。一度に配送するデバイスの数に関係
なく、デバイスごとに個別のジョブリクエストを送信する必要があります。複数のデバイスを発
送する際の梱包要件に関する詳細は、「複数デバイスの配送 (p. 64)」を参照してください。
詳細については、「ガイドラインおよび制限 (p. 125)」を参照してください。
デバイスごとに個別のジョブリクエストを送信する必要があります。
Amazon S3 インポートジョブを作成するには
1.
マニフェストファイルを作成する.
2.
送付するデバイスを準備します。
3.
CreateJob リクエストを送信します。
AWS Import/Export は、SIGNATURE ファイルおよびジョブ情報を含むレスポンスを送信します。
4.
SIGNATURE ファイルをデバイスにコピーします。
5.
GetShippingLabel (p. 119) リクエストを送信します。
6.
デバイスを送付します。
Tip
Amazon S3 バケットは、AWS マネジメントコンソールを使用して作成できます。詳細について
は、http://docs.aws.amazon.com/AmazonS3/latest/UG/CreatingaBucket.html を参照してくださ
い。
これらのステップでは、前のタスクで説明しているように、AWS アカウントにサインアップ
し、AWScredentials.properties ファイルを作成済みであることを前提としています。
マニフェストファイルの作成
マニフェストファイルは、ジョブの処理方法を AWS に伝える YAML 形式のテキストファイルです。デバ
イス ID、TrueCrypt パスワードなどの必要情報を指定する一連の名前と値のペアで構成されます。YAML
の詳細については、http://yaml.org を参照してください。
AWS Import/Export ウェブサービスツールでは、インポートおよびエクスポートジョブに対して変更でき
るマニフェストファイルの例が 3 つ提供されます。
1. AWS Import/Export ウェブサービスツールをインストールしたフォルダの Examples フォルダに移動し
ます。
2. テキストエディタで S3-import-manifest.txt ファイルを開きます。
manifestVersion:2.0
generator:Text editor
bucket:[Enter import bucket]
deviceId:[Enter device serial number]
eraseDevice:yes
notificationEmail: [Email addresses, semicolon separated]
pinCode: [Optional – PIN code]
trueCryptPassword: [Optional – password]
acl:private
serviceLevel:standard
returnAddress:
name:[Your name]
company:[Optional - your company]
street1:[Your street]
street2:[Optional - additional street info]
street3:[Optional - additional street info]
city:[Your city]
9
AWS Import/Export 開発者ガイド
インポートジョブの作成
stateOrProvince:[Required for USA and Canada. Your state or province.]
postalCode:[Your postal code]
country:[Your country]
phoneNumber: [Contact number]
Important
欧州連合内を除くデバイスの国際配送では、マニフェストに関税オプションを含める必要があ
ります。関税関係のマニフェストオプションの詳細については、「マニフェストファイルの関
税オプション (p. 73)」を参照してください。
3. ファイルで、括弧で囲まれたすべてのテキストを適切な値で置き換えます。使用しないオプション行は
削除します。
4. データのアップロード先となる既存の Amazon S3 バケットの名前を指定します。AWS Import/Export
により、データが 1 つのバケットにロードされます。[bucket] オプションで、バケットの名前のみ (た
とえば、s3examplebucket) を指定します。
5. [eraseDevice] フィールドで [yes] を指定し、送付する前に AWS によってインポートオペレーションの
後でデバイスが消去されることを了承します。eraseDevice フィールドがないか、値が yes ではない場
合、ジョブリクエストは失敗します。
6. notificationEmail フィールドで、問題がある場合は当社からお客様に連絡できるよう、1 つ以上の E
メールアドレスをセミコロンで区切って入力します。notificationEmail フィールドがないか空の場
合、ジョブリクエストは失敗します。
7. AWSCredentials.properties ファイルと同じフォルダに、MyS3ImportManifest.txt という名前でファ
イルを保存します。
マニフェストファイルのオプションの詳細については、「インポートマニフェストの作成 (p. 34)」を参
照してください。
インポート用のデバイスの準備
次に、インポート用にデバイスを準備します。
1. オプションで、AWS によってサポートされるいずれかの暗号化メカニズムを使用してデータを暗号化
します。
セキュリティを高めるため、データを暗号化することを強くお勧めします。ドライブを暗号化する
か、デバイスで暗号化されたファイルコンテナを作成できます。詳細については、「データの暗号
化 (p. 60)」を参照してください。
2. すべてのファイル名が有効であることを確認します。ファイル名は、標準の ASCII または UTF-8 文字
エンコードを使用する必要があります。有効な ASCII または UTF-8 文字列以外の名前がついたファイ
ルはインポートされません。
3. デバイスにデータをコピーします。データのコピーのみを送付しないでください。インポートを実行で
きなくても、AWS によりデバイスは消去されます。
デバイスが正しくインポートに備えて正しく準備されていない場合、AWS はデバイスを消去し、リクエス
トを処理せずに返却することがあります。デバイス上のデータを消去できない場合、破棄がスケジュール
され、サポートチームがマニフェストファイルで指定された E メールアドレスに連絡します。詳細につい
ては、「the section called “ストレージデバイスの配送” (p. 57)」を参照してください。
CreateJob リクエストの送信
これで認証情報ファイルとマニフェストファイルを準備したので、AWS Import/Export に CreateJob リク
エストを送信します。各デバイスに個別の CreateJob リクエストを送信します。
1. コマンドプロンプト (または Mac の場合はターミナルアプリケーション) を開き、AWS Import/Export
ツールを解凍したディレクトリに移動します。
10
AWS Import/Export 開発者ガイド
インポートジョブの作成
2. コマンドラインで次の CreateJob リクエストを入力します。
CmdPrompt>java -jar lib/AWSImportExportWebServiceTool-1.0.jar CreateJob Import
MyS3ImportManifest.txt .
CreateJob リクエストには、SIGNATURE ファイルを保存する場所のディレクトリ名が含まれます。この
例で、コマンドの最後にあるピリオド (.) は、現在のディレクトリを示します。上記のようにピリオド
を含めるか、ディレクトリパスで置き換えます。
エラーがある場合、AWS Import/Export はエラーメッセージを返します。
リクエストにエラーがない場合、AWS Import/Export は JOB CREATED レスポンスを返します。レスポン
スの例を次に示します。
JOB CREATED
JobId: ABCDE
JobType: Import
****************************************
* AwsShippingAddress *
****************************************
Please call GetShippingLabel API to retrieve shipping address
****************************************
* SignatureFileContents *
****************************************
version:2.0
signingMethod:HmacSHA1
jobId:ABCDE-VALIDATE-ONLY
signature:cbfdUuhhmauYS+ABCl5R9heDK/V=
Writing SignatureFileContents to cmdPrompt\.\SIGNATURE
ジョブは 30 日後に失効します。デバイスを送付しないかぎり、料金はかかりません。
SIGNATURE ファイルのコピー
CreateJob リクエストに応じて、AWS は SIGNATURE という名前のファイルをコンピュータに書き込みま
す。SIGNATURE ファイルには、デバイスを認証し、ジョブリクエストに一致させることができる暗号化文
字列である署名が含まれます。
ジョブリクエストで指定したディレクトリで SIGNATURE ファイルを見つけ、ストレージデバイスのルート
ディレクトリにコピーします。ファイル名は SIGNATURE であり、デバイスのルートディレクトリにある必
要があります。
送付する各デバイスには、そのデバイスとその JOBID ごとに一意の SIGNATURE ファイルが必要で
す。AWS Import/Export は、データのロードを開始する前に、ストレージデバイスにある SIGNATURE ファ
イルを検証します。SIGNATURE ファイルが見つからない場合や無効の場合 (たとえば、別のジョブリクエス
トに関連付けられているなど)、AWS Import/Export でデータロードは行わずにストレージデバイスはお客
様に返却されます。
GetShippingLabel リクエストの送信
AWS Import/Export ウェブサービスツールの GetShippingLabel アクションを通じて前払い配送ラベルを
生成、印刷、添付します。詳細な手順については、「前払い配送ラベルの生成 (p. 63)」を参照してくだ
さい。
デバイスの発送
発送前にデバイスを正しく準備することが重要です。
11
AWS Import/Export 開発者ガイド
インポートジョブの作成
Note
複数のデバイスを同じ発送で配送できます。ただし、配送できるデバイスやデバイスの梱包方法
に関して、特定のガイドラインおよび制限があります。配送品が正しく準備され梱包されていな
い場合は、AWS Import/Export でジョブを処理できません。一度に配送するデバイスの数に関係
なく、デバイスごとに個別のジョブリクエストを送信する必要があります。複数のデバイスを発
送する際の梱包要件に関する詳細は、「複数デバイスの配送 (p. 64)」を参照してください。
1. 電源、電源ケーブル、インターフェイスケーブルをストレージデバイスに同梱します。これらがない場
合、データを転送できないため、デバイスを返送します。
2. 前払い配送ラベルを生成、印刷、添付します。
デバイスの準備と発送方法の詳しい手順については、「ストレージデバイスの配送 (p. 57)」を参照
してください。
3. 直接 UPS に集荷を依頼するか、UPS の集荷施設にパッケージを持ち込んで AWS に発送してくださ
い。UPS に配送料金を支払う必要はありませんが、AWS はデバイスの処理費用にこれらの料金を追加
します。海外へ発送する場合は、「ストレージデバイスを国際配送する場合の考慮事項 (p. 65)」を
参照してください。
Important
ジョブは 30 日後に失効します。デバイスを送付しないかぎり、料金はかかりません。請求
は、AWS Import/Export でデバイスを受け取った後でのみ行われます。ジョブの有効期限が切れ
た後にパッケージを受領した場合は、デバイスを返却します。配送料金 (ある場合) に対してのみ
課金されます。
ここまで、AWS Import/Export のご利用開始にあたってのステップを説明しました。製品の詳細について
は、「次のステップ (p. 24)」を参照してください。
最初の Amazon EBS インポートジョブの作成
Amazon EBS インポートにより、デバイス仮想コピーが単一イメージとして作成されます。このようなイ
ンポートジョブの場合、デバイスのファイルシステムは Amazon EC2 インスタンスに自動的にマウントさ
れません。Amazon EBS ボリュームの最大サイズは 16 TB です。デバイスの最大容量は、デバイスに保存
されたデータ量とは別であることに注意してください。
デバイスが暗号化されている場合、デバイスイメージも暗号化されます。AWS は、デバイスイメージをイ
ンポートする前にデバイスを復号しません。
インポートオペレーションが完了すると、送付する前に AWS Import/Export によってデバイスが消去され
ます。
デバイスごとに個別のジョブリクエストを送信する必要があります。
Note
複数のデバイスを同じ発送で配送できます。ただし、配送できるデバイスやデバイスの梱包方法
に関して、特定のガイドラインおよび制限があります。配送品が正しく準備され梱包されていな
い場合は、AWS Import/Export でジョブを処理できません。一度に配送するデバイスの数に関係
なく、デバイスごとに個別のジョブリクエストを送信する必要があります。複数のデバイスを発
送する際の梱包要件に関する詳細は、「複数デバイスの配送 (p. 64)」を参照してください。
詳細については、「ガイドラインおよび制限 (p. 125)」を参照してください。
Amazon EBS インポートジョブを作成するには
1.
マニフェストファイルを作成する.
12
AWS Import/Export 開発者ガイド
インポートジョブの作成
2.
送付するデバイスを準備します。
3.
CreateJob リクエストを送信します。
AWS Import/Export はバーコードおよびジョブ情報とともにレスポンスと PDF ファイルを送信しま
す。
4.
デバイスに署名バーコードを添付します。
5.
GetShippingLabel (p. 119) リクエストを送信します。
6.
デバイスを送付します。
リクエストで、ログ記録用に既存の Amazon S3 バケットを識別する必要があります。バケットに対する
書き込みアクセス権限が必要です。
Tip
バケットは、AWS S3 コンソールを使用して作成できます。詳細については、http://
docs.aws.amazon.com/AmazonS3/latest/UG/CreatingaBucket.html を参照してください。
これらのステップでは、前のタスクで説明しているように、AWS アカウントにサインアップ
し、AWSCredentials.properties ファイルを作成済みであることを前提としています。
マニフェストファイルの作成
マニフェストファイルは、ジョブの処理方法を AWS に伝える YAML 形式のテキストファイルです。デ
バイス ID、ログバケット、返送先住所などの必要情報を指定する一連の名前と値のペアで構成されま
す。YAML の詳細については、http://yaml.org を参照してください。
AWS Import/Export ウェブサービスツールでは、インポートおよびエクスポートジョブに対して変更でき
るマニフェストファイルの例が 3 つ提供されます。
1. AWS Import/Export ウェブサービスツールをインストールしたフォルダの Examples フォルダに移動し
ます。
2. テキストエディタで ebs-import-manifest.txt ファイルを開きます。
manifestVersion: 3.0
deviceId:[Enter device serial number]
pinCode: [Optional – PIN code]
logPrefix: [Optional - a prefix for your log bucket]
logBucket:[Your log bucket]
generator: AWS Import/Export Command Line Tool
eraseDevice:yes
notificationEmail: [Email addresses, semicolon separated]
returnAddress:
name:[Your name]
company:[Optional - your company]
street1:[Your street]
street2:[Optional - additional street info]
street3:[Optional - additional street info]
city:[Your city]
stateOrProvince:[Required for USA and Canada. Your state or province.]
postalCode:[Your postal code]
country:[Your country]
phoneNumber:[Contact number]
operations:
- destination: ebs-snapshot
source: device
region: us-east-1 | us-west-1 | us-west-2 | eu-west-1 | ap-southeast-1
deviceCapacityGreaterThan1TB: [yes|no]
13
AWS Import/Export 開発者ガイド
インポートジョブの作成
Important
欧州連合内を除くデバイスの国際配送では、マニフェストに関税オプションを含める必要があ
ります。関税関連のマニフェストオプションの詳細については、「マニフェストファイルの関
税オプション (p. 73)」を参照してください。
3. ファイルで、括弧で囲まれたすべてのテキストを適切な値で置き換えます。使用しないオプション行は
削除します。
4. ログ記録用の既存の Amazon S3 バケットの名前を指定します。[logBucket] オプションで、バケットの
名前のみ (たとえば、s3examplebucket) を指定します。
5. [eraseDevice] フィールドで [yes] を指定し、送付する前に AWS によってインポートオペレーションの
後でデバイスが消去されることを了承します。eraseDevice フィールドがないか、値が yes ではない場
合、ジョブリクエストは失敗します。
6. notificationEmail フィールドで、問題がある場合は当社からお客様に連絡できるよう、1 つ以上の E
メールアドレスをセミコロンで区切って入力します。notificationEmail フィールドがないか空の場
合、ジョブリクエストは失敗します。
7. operations オプションの destination サブフィールドは、データが Amazon EBS スナップショットに
インポートされることを指定します。region パラメーターを変更して正しいリージョンを指定します。
リージョンの詳細については、「AWS Import/Export Disk Calculator」を参照してください。その他の
operations オプションの詳細については、「インポートマニフェストの作成 (p. 34)」を参照してく
ださい。
8. [deviceCapacityGreaterThan1TB] サブフィールドは、デバイス容量が 1 TB より大きい場合に指定しま
す。Disk では、16 TB の Amazon EBS へのインポートをサポートしています。
9. AWSCredentials.properties ファイルと同じフォルダに、MyEBSImportManifest.txt という名前で
ファイルを保存します。
マニフェストファイルのオプションの詳細については、「マニフェストファイルオプションのリファレン
ス (p. 69)」を参照してください。
インポート用のデバイスの準備
次に、インポート用にデバイスを準備する必要があります。
1. オプションでデータを暗号化します。セキュリティを高めるため、データを暗号化することを強くお勧
めします。デバイスでアクセス用に PIN コードが必要な場合は、AWS でデバイスへのアクセスを許可
するには PIN コードを提供する必要があります。デバイスイメージ全体がインポートされます。AWS
はデバイスを復号しません。
2. デバイスにデータをコピーします。データのコピーのみを送付しないでください。インポートを実行で
きなくても、AWS によりデバイスは消去されます。
CreateJob リクエストの送信
これで認証情報ファイルとマニフェストファイルを準備したので、AWS Import/Export に CreateJob リク
エストを送信します。
各デバイスに個別の CreateJob リクエストを送信します。
1. コマンドプロンプト (または Mac の場合はターミナルアプリケーション) を開き、AWS Import/Export
ツールを解凍したディレクトリに移動します。
2. コマンドラインで次の CreateJob リクエストを入力します。
CmdPrompt>java -jar lib/AWSImportExportWebServiceTool-1.0.jar CreateJob Import
MyEBSImportManifest.txt .
14
AWS Import/Export 開発者ガイド
インポートジョブの作成
CreateJob リクエストには、送付手順の PDF ファイルを保存するディレクトリ名が含まれます。この
例で、コマンドの最後にあるピリオド (.) は、現在のディレクトリを示します。上記のようにピリオド
を含めるか、ディレクトリパスで置き換えます。
エラーがある場合、AWS Import/Export はエラーメッセージを返します。
リクエストにエラーがない場合、AWS Import/Export は JOB CREATED レスポンスを返します。レスポン
スの例を次に示します。
JOB CREATED
JobId: ABCDE
JobType: Import
Shipping instructions saved to C:\DirectoryName\.\shipping-instructions-ABCDE.pdf
SHIPPING INSTRUCTIONS:
1. Open the Shipping Instructions file with a PDF reader.
2. Print out the Shipping Instructions which includes the AWS Shipping Address
and Signature barcode.
3. Follow the directions in the PDF file, which includes cutting out and securely
attaching the Signature barcode to your device.
*IMPORTANT* - Failure to attach the Signature barcode to your device will prevent
AWS from loading your data. This barcode can only be used with 1 device.
ジョブは 30 日後に失効します。デバイスを送付しないかぎり、料金はかかりません。
署名バーコードの添付
CreateJob リクエストが正常に完了すると、AWS Import/Export により、CreateJob リクエストで指定し
たディレクトリに、送付手順とバーコードが PDF ファイルとして配置されます。また、logBucket マニ
フェストオプションで指定した Amazon S3 バケットに、PDF ファイルのコピーが配置されます。PDF
ファイルの名前は shipping-instructions-YOURJOBID.pdf で、YOURJOBID はリクエストのジョブの名前
です。
PDF を印刷し、デバイスに署名バーコードを確実に添付します。
デバイスごとに個別のジョブリクエストを送信し、各ジョブリクエストは固有のバーコードを生成する必
要があります。AWS Import/Export は、データのロードを開始する前に、ストレージデバイスにあるバー
コードを検証します。バーコードが無効 (デバイスに一致しないなど)、存在しない、または読み取れない
場合、AWS Import/Export はデータのロードを実行せず、ストレージデバイスは返送されます。
Important
署名バーコードを、デバイスの四面すべてにテープでしっかりと貼付します。署名バーコードは
削除や交換したり、もので覆ったりしないでください。署名バーコードがデバイスから分離して
いる場合、検証ができず、データのロードを行わないでデバイスを返却します。
GetShippingLabel リクエストの送信
AWS Import/Export ウェブサービスツールの GetShippingLabel アクションを通じて前払い配送ラベルを
生成、印刷、添付します。詳細な手順については、「前払い配送ラベルの生成 (p. 63)」を参照してくだ
さい。
デバイスの発送
発送前にデバイスを正しく準備することが重要です。
15
AWS Import/Export 開発者ガイド
インポートジョブの作成
Note
CreateJob の処理中にエラーが発生した場合、エラーメッセージに原因が示されます。この場合
は、Amazon S3 バケットから送付手順を取得するか、GetShipInfo オペレーションを使用してダ
ウンロードを再試行できます。詳細については、「配送情報の取得 (p. 67)」を参照してくださ
い。
1. デバイスに署名バーコードを確実に添付します。
2. 電源、電源ケーブル、インターフェイスケーブルをストレージデバイスに同梱します。これらがない場
合、データを転送できないため、デバイスを返送します。
3. 前払い配送ラベルを生成、印刷、添付します。
デバイスの準備と発送方法の詳しい手順については、「ストレージデバイスの配送 (p. 57)」を参照
してください。
4. 直接 UPS に集荷を依頼するか、UPS の集荷施設にパッケージを持ち込んで AWS に発送してくださ
い。UPS に配送料金を支払う必要はありませんが、AWS はデバイスの処理費用にこれらの料金を追加
します。海外へ発送する場合は、「ストレージデバイスを国際配送する場合の考慮事項 (p. 65)」を
参照してください。
Important
ジョブは 30 日後に失効します。デバイスを送付しないかぎり、料金はかかりません。請求
は、AWS Import/Export でデバイスを受け取った後でのみ行われます。ジョブの有効期限が切れ
た後にパッケージを受領した場合は、デバイスを返却します。配送料金 (ある場合) に対してのみ
課金されます。
デバイスが送付とインポートに備えて正しく準備されていない場合、AWS はデバイスを消去し、リクエス
トを処理せずに返却しなければならないことがあります。デバイス上のデータを消去できない場合、破棄
がスケジュールされ、サポートチームがマニフェストファイルで指定された E メールアドレスに連絡しま
す。詳細については、「the section called “ストレージデバイスの配送” (p. 57)」を参照してください。
ここまで、AWS Import/Export のご利用開始にあたってのステップを説明しました。製品の詳細について
は、「次のステップ (p. 24)」を参照してください。
最初の Amazon Glacier インポートジョブの作成
Amazon Glacier インポートジョブにより、AWS ではデバイスの仮想コピーが単一イメージとして作成さ
れます。デバイスのファイルシステムがマウントされることはありません。1 つのデバイスのイメージ全
体が、既存の Amazon Glacier ボールトの 1 つの Amazon Glacier アーカイブにアップロードされます。デ
バイスが暗号化されている場合、デバイスイメージも暗号化されます。AWS は、デバイスイメージをイン
ポートする前にデバイスを復号しません。
インポートオペレーションが完了すると、送付する前に AWS Import/Export によってデバイスが消去され
ます。
デバイスごとに個別のジョブリクエストを送信する必要があります。
Note
複数のデバイスを同じ発送で配送できます。ただし、配送できるデバイスやデバイスの梱包方法
に関して、特定のガイドラインおよび制限があります。配送品が正しく準備され梱包されていな
い場合は、AWS Import/Export でジョブを処理できません。一度に配送するデバイスの数に関係
なく、デバイスごとに個別のジョブリクエストを送信する必要があります。複数のデバイスを発
送する際の梱包要件に関する詳細は、「複数デバイスの配送 (p. 64)」を参照してください。
詳細については、「ガイドラインおよび制限 (p. 125)」を参照してください。
16
AWS Import/Export 開発者ガイド
インポートジョブの作成
Amazon Glacier インポートジョブを作成するには
1.
マニフェストファイルを作成する.
2.
送付するデバイスを準備します。
3.
CreateJob リクエストを送信します。
AWS Import/Export はバーコードおよびジョブ情報とともにレスポンスと PDF ファイルを送信しま
す。
4.
デバイスに署名バーコードを添付します。
5.
GetShippingLabel (p. 119) リクエストを送信します。
6.
デバイスを送付します。
リクエストで、ログ記録用に既存の Amazon S3 バケットを識別する必要があります。バケットに対する
書き込みアクセス権限が必要です。
Tip
バケットは、AWS S3 コンソールを使用して作成できます。詳細については、http://
docs.aws.amazon.com/AmazonS3/latest/UG/CreatingaBucket.html を参照してください。
これらのステップでは、前のタスクで説明しているように、AWS アカウントにサインアップ
し、AWScredentials.properties ファイルを作成済みであることを前提としています。
マニフェストファイルの作成
マニフェストファイルは、ジョブの処理方法を AWS に指示する YAML 形式のテキストファイルです。
デバイス ID、ログバケット、返送先住所などの必要情報を指定する一連の名前と値のペアで構成されま
す。YAML の詳細については、http://yaml.org を参照してください。
AWS Import/Export ウェブサービスツールでは、インポートおよびエクスポートジョブに対して変更でき
るマニフェストファイル例が提供されます。
1. AWS Import/Export ウェブサービスツールをインストールしたフォルダの Examples フォルダに移動し
ます。
2. テキストエディタで glacier-import-manifest.txt ファイルを開きます。
manifestVersion: 3.0
deviceId:[Enter device serial number]
pinCode: [Optional – PIN code]
logPrefix: [Optional - a prefix for your log bucket]
logBucket:[Your log bucket]
generator: AWS Import/Export Command Line Tool
eraseDevice: yes
notificationEmail: [Email addresses, semicolon separated]
returnAddress:
name:[Your name]
company:[Optional - your company]
street1:[Your street]
street2:[Optional - additional street info]
street3:[Optional - additional street info]
city:[Your city]
stateOrProvince:[Required for USA and Canada. Your state or province.]
postalCode:[Your postal code]
country:[Your country]
phoneNumber:[Contact number]
operations:
- destination: glacier
17
AWS Import/Export 開発者ガイド
インポートジョブの作成
source: device
region: [us-east-1|us-west-1|us-west-2|eu-west-1]
vaultName: [Your Amazon Glacier vault]
archiveComment: [Your description for the new Amazon Glacier archive]
Important
欧州連合内を除くデバイスの国際配送では、マニフェストに関税オプションを含める必要があ
ります。関税関連のマニフェストオプションの詳細については、「マニフェストファイルの関
税オプション (p. 73)」を参照してください。
3. ファイルで、括弧で囲まれたすべてのテキストを適切な値で置き換えます。使用しないオプション行は
削除します。
4. ログ記録用の既存の Amazon S3 バケットの名前を指定します。[logBucket] オプションで、バケットの
名前のみ (たとえば、s3examplebucket) を指定します。
5. [eraseDevice] フィールドで [yes] を指定し、送付する前に AWS によってインポートオペレーションの
後でデバイスが消去されることを了承します。eraseDevice フィールドがないか、値が yes ではない場
合、ジョブリクエストは失敗します。
6. notificationEmail フィールドで、問題がある場合は当社からお客様に連絡できるよう、1 つ以上の E
メールアドレスをセミコロンで区切って入力します。notificationEmail フィールドがないか空の場
合、ジョブリクエストは失敗します。
7. operations オプションの destination サブフィールドは、データが Amazon Glacier ボールトにイン
ポートされることを指定します。region パラメーターを変更して正しいリージョンを指定します。リー
ジョンの詳細については、「AWS Import/Export Disk Calculator」を参照してください。operations オ
プション設定の変更方法の詳細については、「インポートマニフェストの作成 (p. 34)」を参照して
ください。
8. AWSCredentials.properties ファイルと同じフォルダに、MyGlacierImportManifest.txt という名前
でファイルを保存します。
マニフェストファイルのオプションの詳細については、「マニフェストファイルオプションのリファレン
ス (p. 69)」を参照してください。
インポート用のデバイスの準備
次に、インポート用にデバイスを準備する必要があります。
1. オプションでデータを暗号化します。セキュリティを高めるため、データを暗号化することを強くお勧
めします。デバイスでアクセス用に PIN コードが必要な場合は、AWS でデバイスへのアクセスを許可
するには PIN コードを提供する必要があります。デバイスイメージ全体がインポートされます。AWS
はデバイスを復号しません。
2. デバイスにデータをコピーします。データのコピーのみを送付しないでください。インポートを実行で
きなくても、AWS によりデバイスは消去されます。
デバイスが送付とインポートに備えて正しく準備されていない場合、AWS はデバイスを消去し、リクエス
トを処理せずに返却することがあります。デバイス上のデータを消去できない場合、破棄がスケジュール
され、サポートチームがマニフェストファイルで指定された E メールアドレスに連絡します。詳細につい
ては、「the section called “ストレージデバイスの配送” (p. 57)」を参照してください。
CreateJob リクエストの送信
これで認証情報ファイルとマニフェストファイルを準備したので、AWS Import/Export に CreateJob リク
エストを送信します。
1. コマンドプロンプト (または Mac の場合はターミナルアプリケーション) を開き、AWS Import/Export
ツールを解凍したディレクトリに移動します。
18
AWS Import/Export 開発者ガイド
インポートジョブの作成
2. コマンドラインで次の CreateJob リクエストを入力します。
CmdPrompt>java -jar lib/AWSImportExportWebServiceTool-1.0.jar CreateJob Import
MyGlacierImportManifest.txt .
CreateJob リクエストには、送付手順の PDF ファイルを保存するディレクトリ名が含まれます。この
例で、コマンドの最後にあるピリオド (.) は、現在のディレクトリを示します。上記のようにピリオド
を含めるか、ディレクトリパスで置き換えます。
エラーがある場合、AWS Import/Export はエラーメッセージを返します。
リクエストにエラーがない場合、AWS Import/Export は JOB CREATED レスポンスを返します。レスポン
スの例を次に示します。
JOB CREATED
JobId: ABCDE
JobType: Import
Shipping instructions saved to C:\DirectoryName\.\shipping-instructions-ABCDE.pdf
SHIPPING INSTRUCTIONS:
1. Open the Shipping Instructions file with a PDF reader.
2. Print out the Shipping Instructions which includes the AWS Shipping Address
and Signature barcode.
3. Follow the directions in the PDF file, which includes cutting out and securely
attaching the Signature barcode to your device.
*IMPORTANT* - Failure to attach the Signature barcode to your device will prevent
AWS from loading your data. This barcode can only be used with 1 device.
署名バーコードの添付
CreateJob リクエストが正常に完了すると、AWS Import/Export により、CreateJob リクエストで指定し
たディレクトリに、送付手順とバーコードが PDF ファイルとして配置されます。また、logBucket マニ
フェストオプションで指定した Amazon S3 バケットに、PDF ファイルのコピーが配置されます。PDF
ファイルの名前は shipping-instructions-YOURJOBID.pdf で、YOURJOBID はリクエストのジョブの名前
です。
shipping-instructions-YOURJOBID PDF を印刷し、デバイスに署名バーコードを確実に添付します。
デバイスごとに個別のジョブリクエストを送信し、各ジョブリクエストは固有のバーコードを生成する必
要があります。AWS Import/Export は、データのロードを開始する前に、ストレージデバイスにあるバー
コードを検証します。バーコードが無効 (デバイスに一致しないなど)、存在しない、または読み取れない
場合、AWS Import/Export はデータのロードを実行せず、ストレージデバイスは返送されます。
Important
署名バーコードを、デバイスの四面すべてにテープでしっかりと貼付します。署名バーコードは
削除や交換したり、もので覆ったりしないでください。署名バーコードがデバイスから分離して
いる場合、検証ができず、データのロードを行わないでデバイスを返却します。
GetShippingLabel リクエストの送信
AWS Import/Export ウェブサービスツールの GetShippingLabel アクションを通じて前払い配送ラベルを
生成、印刷、添付します。詳細な手順については、「前払い配送ラベルの生成 (p. 63)」を参照してくだ
さい。
19
AWS Import/Export 開発者ガイド
エクスポートジョブの作成
デバイスの発送
発送前にデバイスを正しく準備することが重要です。
Note
CreateJob の処理中にエラーが発生した場合、エラーメッセージに原因が示されます。この場合
は、Amazon S3 バケットから送付手順を取得するか、GetShipInfo オペレーションを使用してダ
ウンロードを再試行できます。詳細については、「配送情報の取得 (p. 67)」を参照してくださ
い。
1. デバイスに署名バーコードを確実に添付します。
2. 電源、電源ケーブル、インターフェイスケーブルをストレージデバイスに同梱します。これらがない場
合、データを転送できないため、デバイスを返送します。
3. GetShippingLabel (p. 119) リクエストを送信します。
4. 前払い配送ラベルを生成、印刷、添付します。
デバイスの準備と発送方法の詳しい手順については、「ストレージデバイスの配送 (p. 57)」を参照
してください。
5. 直接 UPS に集荷を依頼するか、UPS の集荷施設にパッケージを持ち込んで AWS に発送してくださ
い。UPS に配送料金を支払う必要はありませんが、AWS はデバイスの処理費用にこれらの料金を追加
します。海外へ発送する場合は、「ストレージデバイスを国際配送する場合の考慮事項 (p. 65)」を
参照してください。
Important
ジョブは 30 日後に失効します。デバイスを送付しないかぎり、料金はかかりません。請求
は、AWS Import/Export でデバイスを受け取った後でのみ行われます。ジョブの有効期限が切れ
た後にパッケージを受領した場合は、デバイスを返却します。配送料金 (ある場合) に対してのみ
課金されます。
ここまで、AWS Import/Export のご利用開始にあたってのステップを説明しました。製品の詳細について
は、「次のステップ (p. 24)」を参照してください。
エクスポートジョブの作成
これで AWS Import/Export ウェブサービスツールにサインアップし、ダウンロードしたので、エクスポー
トジョブを作成して Amazon S3 バケットからデータをストレージデバイスにダウンロードできます。
Important
ストレージデバイスをダウンロード用に送付する前に、ジョブを作成し、AWS からレスポンスを
取得する必要があります。
これで、エクスポートジョブの作成リクエストを送信する準備ができました。
最初の Amazon S3 エクスポートジョブの作成 (p. 20)。
最初の Amazon S3 エクスポートジョブの作成
Amazon S3 エクスポートは、個々のオブジェクトを Amazon S3 バケットからデバイスに転送します。
この際、各オブジェクトつき 1 つのファイルを作成します。複数のバケットを指定できます。また、マニ
フェストファイルオプションを使用してエクスポートするファイルを指定できます。
AWS Import/Export のすべてのエクスポートジョブでは暗号化が必須です。ハードウェアの暗号化機能を
使用して PIN コードで保護されたデバイスを提供するか、指定するパスワードと TrueCrypt ソフトウェア
の暗号化を使用してデバイスを暗号化するよう AWS に指示する必要があります。PIN コードで保護され
たデバイスを提供する場合、オプションで、さらに TrueCrypt の暗号化を指定できます。
20
AWS Import/Export 開発者ガイド
エクスポートジョブの作成
デバイスの送付中のデータのセキュリティをさらに高めるため、AWS Import/Export では、データのロー
ドを開始する前にデバイスをフォーマットします。デバイスを AWS に送付したときに保存されている
データは失われます。AWS はデバイス上の暗号化ファイルコンテナにデータをコピーします。ソフトウェ
アの暗号化を指定する場合は、TrueCrypt 暗号化ソフトウェアを使用してデータを復号する必要がありま
す。詳細については、「データの暗号化 (p. 60)」を参照してください。
Important
パスワードまたはデバイスの PIN コードをなくした場合、デバイスを復号できなくなりま
す。AWS は、なくしたパスワードや PIN コードを提供することはできません。
デバイスごとに個別のジョブリクエストを送信する必要があります。
Note
複数のデバイスを同じ発送で配送できます。ただし、配送できるデバイスやデバイスの梱包方法
に関して、特定のガイドラインおよび制限があります。配送品が正しく準備され梱包されていな
い場合は、AWS Import/Export でジョブを処理できません。一度に配送するデバイスの数に関係
なく、デバイスごとに個別のジョブリクエストを送信する必要があります。複数のデバイスを発
送する際の梱包要件に関する詳細は、「複数デバイスの配送 (p. 64)」を参照してください。
詳細については、「ガイドラインおよび制限 (p. 125)」を参照してください。
Note
Amazon EBS または Amazon Glacier からストレージデバイスへのエクスポートは、現在サポー
トされていません。
Tip
バケットは、AWS マネジメントコンソールを使用して作成できます。詳細については、「バケッ
トの作成」を参照してください。
Amazon S3 エクスポートジョブを作成するには
1.
マニフェストファイルを作成する.
2.
3.
送付するデバイスを準備します。
CreateJob リクエストを送信します。
AWS Import/Export は、SIGNATURE ファイルおよびジョブ情報を含むレスポンスを送信します。
4.
5.
SIGNATURE ファイルをデバイスにコピーします。
デバイスを送付します。
これらのステップでは、前のタスクで説明しているように、AWS アカウントにサインアップ
し、AWScredentials.properties ファイルを作成済みであることを前提としています。
マニフェストファイルの作成
マニフェストファイルは、ジョブの処理方法を AWS に指示する YAML 形式のテキストファイルです。
デバイス ID、ログバケット、返送先住所などの必要情報を指定する一連の名前と値のペアで構成されま
す。YAML の詳細については、http://yaml.org を参照してください。
AWS Import/Export ウェブサービスツールでは、インポートおよびエクスポートジョブに対して変更でき
るマニフェストファイルの例が 3 つ提供されます。
1. AWS Import/Export ウェブサービスツールをインストールしたフォルダの Examples フォルダに移動し
ます。
2. テキストエディタで S3-export-manifest.txt ファイルを開きます。
21
AWS Import/Export 開発者ガイド
エクスポートジョブの作成
manifestVersion:2.0
generator:text editor
deviceId:[Enter device serial number]
fileSystem:[NTFS| EXT4]
pinCode: [PIN code]
trueCryptPassword: [password]
serviceLevel:expeditedShipping
targetDirectory:/
recoveryDirectory:EXPORT-RECOVERY
logBucket:[Your log bucket]
notificationEmail: [Email addresses, semicolon separated]
operations:
- exportBucket:[Your bucket]
returnAddress:
name:[Your name]
company:[Optional - your company]
street1:[Your street]
street2:[Optional - additional street info]
street3:[Optional - additional street info]
city:[Your city]
stateOrProvince:[Required for USA and Canada. Your state or province.]
postalCode:[Your postal code]
country:[Your country]
phoneNumber:[Contact number]
Important
欧州連合内を除くデバイスの国際配送では、マニフェストに関税オプションを含める必要があ
ります。関税関連のマニフェストオプションの詳細については、「マニフェストファイルの関
税オプション (p. 73)」を参照してください。
3. ファイルで、括弧で囲まれたすべてのテキストを適切な値で置き換えます。使用しないオプション行は
削除します。
4. デバイスの PIN コードまたは暗号化パスワードを入力します。AWS はデータを暗号化するために、お
客様が提供する PIN コードまたはパスワードを使用します。AWS からデータを受信したら、同じ PIN
コードまたはパスワードを使用してデータを復号する必要があります。マニフェストで PIN コードまた
はパスワードを指定しない場合、CreateJob リクエストは失敗します。
5. エクスポートするデータ、ログデータを保存するバケット名を含む、既存の Amazon S3 バケッ
トの名前を指定します。logBucket および exportBucket オプションで、バケット名のみ (たとえ
ば、s3examplebucket) を指定します。
Note
エクスポートの場合、Amazon S3 ログバケットと Amazon S3 エクスポートバケットは同じ
リージョンにある必要があります。バケットが異なるリージョンにある場合、ジョブのリクエ
ストは失敗します。
6. AWSCredentials.properties ファイルと同じフォルダに、MyS3ExportManifest.txt という名前でファ
イルを保存します。
マニフェストファイルのオプションの詳細については、「エクスポートマニフェストの作成 (p. 52)」
を参照してください。
CreateJob リクエストの送信
これで認証情報ファイルとマニフェストファイルを準備したので、AWS Import/Export に CreateJob リク
エストを送信します。各デバイスに個別の CreateJob リクエストを送信します。
1. コマンドプロンプト (または Mac の場合はターミナルアプリケーション) を開き、AWS Import/Export
ツールを解凍したディレクトリに移動します。
2. コマンドラインで次の CreateJob リクエストを入力します。
22
AWS Import/Export 開発者ガイド
エクスポートジョブの作成
cmdPrompt>java -jar lib/AWSImportExportWebServiceTool-1.0.jar CreateJob Export
MyS3ExportManifest.txt .
CreateJob リクエストには、SIGNATURE ファイルを保存する場所のディレクトリ名が含まれます。この
例で、コマンドの最後にあるピリオド (.) は、現在のディレクトリを示します。上記のようにピリオド
を含めるか、ディレクトリパスで置き換えます。
エラーがある場合、AWS Import/Export はエラーメッセージを返します。
リクエストにエラーがない場合、AWS Import/Export は JOB CREATED レスポンスを返します。レスポン
スの例を次に示します。
JOB CREATED
JobId:
TC44P
JobType: Export
****************************************
* AwsShippingAddress
*
****************************************
Please call GetShippingLabel API to retrieve shipping address
****************************************
* SignatureFileContents
*
****************************************
version:2.0
signingMethod:HmacSHA1
jobId:TC44P
signature:BBAqQ/E+R7bdXRVR1s9vTi5t7Aps=
Writing SignatureFileContents to C:\ImportExportWebServiceTool\.\SIGNATURE
ジョブは 30 日後に失効します。デバイスを送付しないかぎり、料金はかかりません。
SIGNATURE ファイルのコピー
CreateJob リクエストに応じて、AWS は SIGNATURE という名前のファイルをコンピュータに書き込みま
す。SIGNATURE ファイルには、デバイスを認証し、ジョブリクエストに一致させることができる暗号化文
字列である署名が含まれます。
ジョブリクエストで指定したディレクトリで SIGNATURE ファイルを見つけ、ストレージデバイスのルート
ディレクトリにコピーします。ファイル名は SIGNATURE であり、デバイスのルートディレクトリにある必
要があります。
送付する各デバイスには、そのデバイスとその JOBID ごとに一意の SIGNATURE ファイルが必要で
す。AWS Import/Export は、データのロードを開始する前に、ストレージデバイスにある SIGNATURE ファ
イルを検証します。SIGNATURE ファイルが見つからない場合や無効の場合 (たとえば、別のジョブリクエス
トに関連付けられているなど)、AWS Import/Export でデータロードは行わずにストレージデバイスはお客
様に返却されます。
GetShippingLabel リクエストの送信
AWS Import/Export ウェブサービスツールの GetShippingLabel アクションを通じて前払い配送ラベルを
生成、印刷、添付します。詳細な手順については、「前払い配送ラベルの生成 (p. 63)」を参照してくだ
さい。
デバイスの発送
発送前にデバイスを正しく準備することが重要です。デバイスが送付とエクスポートに備えて正しく準備
されていない場合、AWS はデバイスを消去し、リクエストを処理せずに返却しなければならないことがあ
ります。デバイス上のデータを消去できない場合、破棄がスケジュールされ、サポートチームがマニフェ
23
AWS Import/Export 開発者ガイド
次のステップ
ストファイルで指定された E メールアドレスに連絡します。詳細については、「the section called “スト
レージデバイスの配送” (p. 57)」を参照してください。
1. 電源、電源ケーブル、インターフェイスケーブルをストレージデバイスに同梱します。これらがない場
合、データを転送できないため、デバイスを返送します。
2. 前払い配送ラベルを生成、印刷、添付します。
デバイスの準備と発送方法の詳しい手順については、「ストレージデバイスの配送 (p. 57)」を参照
してください。
3. 直接 UPS に集荷を依頼するか、UPS の集荷施設にパッケージを持ち込んで AWS に発送してくださ
い。UPS に配送料金を支払う必要はありませんが、AWS はデバイスの処理費用にこれらの料金を追加
します。海外へ発送する場合は、「ストレージデバイスを国際配送する場合の考慮事項 (p. 65)」を
参照してください。
Important
ジョブは 30 日後に失効します。デバイスを送付しないかぎり、料金はかかりません。請求
は、AWS Import/Export でデバイスを受け取った後でのみ行われます。ジョブの有効期限が切れ
た後にパッケージを受領した場合は、デバイスを返却します。配送料金 (ある場合) に対してのみ
課金されます。
ここまで、AWS Import/Export のご利用開始にあたってのステップを説明しました。製品の詳細について
は、「次のステップ (p. 24)」を参照してください。
次のステップ
トピック
• インポートジョブの使用 (p. 24)
• エクスポートジョブの使用 (p. 24)
• ジョブの管理 (p. 24)
• 料金表 情報 (p. 25)
「ご利用開始にあたって」セクションでは、ジョブを作成するための詳しいステップを示しました。次
に、サービスの詳細について説明します。
インポートジョブの使用
このセクションでは、AWS にデータをインポートするプロセスについて説明します。Amazon Simple
Storage Service (Amazon S3) バケット、Amazon Elastic Block Store (Amazon EBS) スナップショッ
ト、および Amazon Glacier ボールトにデータをインポートできます。Amazon EBS スナップショットは
Amazon Elastic Compute Cloud (EC2) で使用するボリュームに変換できます。詳細については、「イン
ポートジョブの使用 (p. 28)」を参照してください。
エクスポートジョブの使用
このセクションでは、AWS からデータをエクスポートするプロセスについて説明します。AWS Import/
Export では、Amazon EBS または Amazon Glacier からのエクスポートジョブはサポートしていません。
詳細については、「エクスポートジョブの使用 (p. 50)」を参照してください。
ジョブの管理
AWS Import/Export ツールおよび API には、ジョブを簡単に管理する方法が用意されています。たとえ
ば、作成したジョブは、更新またはキャンセルすることができます。また、すべてのジョブのリストや、
特定のジョブのステータスを取得したりできます。詳細については、「ジョブの管理 (p. 66)」を参照し
てください。
24
AWS Import/Export 開発者ガイド
AWS Import/Export Disk での IAM の使用
料金表 情報
すべての AWS サービスと同様に、お客様が使用したリソース分に対してのみ支払いいただきます。AWS
Import/Export 料金モデルの詳細については、「AWS Import/Export の詳細」ページを参照してください。
AWS Import/Export Disk での IAM の使用
トピック
• AWS Import/Export Disk ジョブへのアクセス制御 (p. 25)
• 関連する AWS リソースに対するアクセス権限の付与 (p. 27)
AWS Identity and Access Management(IAM)は、アマゾン ウェブ サービス(AWS)のお客様が AWS
でユーザーとユーザー許可を管理できるようにするウェブサービスです。AWS Import/Export Disk のユー
ザーには、CreateJob や GetStatus などの AWS Import/Export アクションにアクセスする特定のアクセス
権限が必要です。また、インポートやエクスポートを作成する IAM ユーザーには、Amazon S3 バケット
や Amazon Glacier ボールトなど、インポートやエクスポートのオペレーションで使用する AWS リソース
へのアクセス権限も必要です。
Note
IAM ユーザーのみが AWS Import/Export Disk ジョブを作成できます。割り当てられたロールは
ジョブの作成に使用できません。
AWS Import/Export Disk ジョブへのアクセス制御
AWS Import/Export Disk は AWS Identity and Access Management (IAM)と統合され、ユーザーが実行でき
るアクションを制御できます。
デフォルトでは、IAM ユーザーは AWS Import/Export アクションにアクセスできません。IAM ユーザー
に AWS Import/Export Disk での作業を許可する場合は、そのためのアクセス権限を付与する必要がありま
す。これを行うには、IAM ユーザーに実行を許可する Import/Export アクション定義した IAM ポリシーを
作成します。その後、ポリシーを IAM ユーザーまたはユーザーが属する IAM グループに添付します。
すべての AWS Import/Export Disk アクションまたはそれらのサブセットへのアクセスを、AWS アカウン
トの IAM ユーザーに許可できます。以下は、AWS Import/Export アクションの全リストです。
importexport:CancelJob
importexport:CreateJob
importexport:GetStatus
importexport:ListJobs
importexport:UpdateJob
importexport:GetShippingLabel
ポリシーを作成しグループ、ユーザー、ロールに添付する方法については、AWS Identity and Access
Management ドキュメントの「IAM ポリシーの管理」を参照してください。
IAM の一般情報については、以下のサイトをご覧ください。
• AWS Identity and Access Management (IAM) 詳細ページ
• IAM とは (AWS Identity and Access Management ドキュメント)
AWS Import/Export Disk 用 IAM ユーザーポリシーの例
このセクションでは、AWS Import/Export Disk へのユーザーアクセスをコントロールするための簡単なポ
リシーを 3 つ紹介します。AWS Import/Export Disk は、リソースレベルのアクセス許可をサポートしてい
25
AWS Import/Export 開発者ガイド
ジョブへのアクセスの制御
ません。従って、Import/Export 用ポリシーで "Resource" エレメントは常にすべてのリソースを意味する
"*" になります。
AWS アカウントで作成したジョブに対して読み取り専用アクセスを許可する
次のポリシーでは、読み取り専用アクションである ListJobs アクションおよび GetStatus アクションへ
のアクセスのみを許可します。
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"importexport:ListJobs",
"importexport:GetStatus"
],
"Resource": "*"
}
]
}
AWS アカウントで作成されるすべての AWS Import/Export Disk ジョブへのフル
アクセスを許可する
次のポリシーは、すべての AWS Import/Export Disk アクションへのアクセスを許可します。
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": "importexport:*",
"Resource": "*"
}
]
}
IAM ユーザーからの一連のアクションを拒否する
デフォルトでは、すべてのアクセス権が拒否されます。Import/Export Disk アクションへのアクセス権を明
示的にユーザーが付与しない限り、これらのアクションを実行できません。明示的に特定のアクションへ
のアクセスを拒否することもできます。これは、1 つのポリシー (またはポリシーのステートメント) で一
連のアクションへのアクセス権が付与されているが、個々のアクションを除外する場合に便利です。
以下のポリシーには、2 つのステートメントが含まれています。最初のステートメントでは、すべての
AWS Import/Export Disk アクションへのアクセスを許可します。2 番目のステートメントは、UpdateJob
へのアクセスを明示的に拒否します。新しいアクションが AWS Import/Export Disk に追加されると、この
ポリシーは、最初のステートメントに従って自動的にこれらの新アクションに対するアクセス権限を付与
します。しかし、別のポリシーで UpdateJob アクションが明示的に許可されていても、ユーザーはこのア
クションへのアクセスを拒否されます。
{
"Version": "2012-10-17",
"Statement": [
{
"Effect":"Allow",
"Action":"importexport:*"
},
{
26
AWS Import/Export 開発者ガイド
AWS リソースに対するアクセス権限の付与
"Effect":"Deny",
"Action":"importexport:UpdateJob",
"Resource": "*"
}
]
}
関連する AWS リソースに対するアクセス権限の付与
AWS Import/Export Disk ジョブを作成する IAM ユーザーには、Amazon S3 バケットに対するアクセス
権限が必要です。Amazon Glacier へのインポートでは、インポートまたはエクスポートオペレーション
に使用する Amazon Glacier ボールトに対するアクセス権限が必要です。ユーザーに必要な権限がない場
合、CreateJob リクエストは失敗します。
すべてのインポートとエクスポートのジョブで、IAM ユーザーには、Amazon S3 ログバケットに対する以
下のアクセス権限が必要です。
s3:GetBucketLocation
s3:PutObject
s3:AbortMultipartUpload
s3:ListMultipartUploadParts
s3:ListBucketMultipartUploads
Amazon S3 へのインポートジョブの場合、IAM ユーザーには、Amazon S3 インポートバケットに対する
以下のアクセス権限が必要です。
s3:GetBucketLocation
s3:PutObject
s3:AbortMultipartUpload
s3:ListMultipartUploadParts
s3:ListBucketMultipartUploads
Amazon S3 へのインポートのマニフェストにアクセスコントロールリスト (ACL) が含まれている場
合、IAM ユーザーには Amazon S3 インポートバケットに対する以下のアクセス権限が追加で必要です。
s3:PutObjectAcl
詳細については、「Amazon S3 へのインポートのマニフェストファイルオプション (p. 77)」を参照し
てください。
Amazon S3 からのエクスポートの場合、IAM ユーザーには、Amazon S3 エクスポートバケットに対する
以下のアクセス権限が必要です。
s3:GetBucketLocation
s3:GetObject
s3:ListBucket
Amazon Glacier へのインポートジョブの場合、IAM ユーザーには、Amazon Glacier ボールトに対する以
下のアクセス権限が必要です。
glacier:AbortMultipartUpload
glacier:CompleteMultipartUpload
glacier:DescribeVault
glacier:InitiateMultipartUpload
glacier:ListMultipartUploads
glacier:ListParts,
glacier:UploadArchive
glacier:UploadMultipartPart
27
AWS Import/Export 開発者ガイド
インポートジョブの使用
Amazon EBS へのインポートに必要なアクセス権限は、前述の Amazon S3 ログバケットに対するアクセ
ス権限だけです。
詳細については、以下を参照してください。
• Amazon S3: IAM ポリシーの使用
• Amazon Glacier: AWS Identity and Access Management (IAM) によるアクセスコントロール
インポートジョブの使用
トピック
• Amazon S3 インポートジョブの作成 (p. 28)
• Amazon EBS インポートジョブの作成 (p. 30)
• Amazon Glacier インポートジョブの作成 (p. 33)
• インポートマニフェストの作成 (p. 34)
• CreateJob リクエストの送信 (p. 42)
• インポートログの表示 (p. 47)
このセクションでは、ストレージデバイスから Amazon S3 バケット、Amazon Elastic Block Store
(Amazon EBS) スナップショット、または Amazon Glacier ボールトにデータをインポートするプロセスの
概要を示します。
ご利用開始にあたって (p. 6) で説明する AWS Import/Export ウェブサービスツールが、インポート
ジョブを作成するもっとも簡単な方法です。これはコマンドラインツールであり、プログラミングを必要
としません。ただし、アプリケーションでプログラミングインターフェイスが必要な場合は、AWS SDK
for Java または REST API を使用してジョブを作成できます。
Amazon S3 インポートジョブの作成
Amazon S3 インポートを使用して、AWS はお客様のデバイスから個々のファイルを Amazon S3 バケッ
トのオブジェクトにアップロードします。1 つのデバイスは 1 つのバケットにロードされます。お客様の
デバイスのファイルシステムは、AWS Import/Export データロードステーションにマウントされ、各ファ
イルは Amazon S3 内のオブジェクトとしてアップロードされます。ロードプロセスの一部として任意で
ディレクトリおよびファイル名を管理できます。
デバイスごとに個別のジョブリクエストを送信する必要があります。
詳細については、「ガイドラインおよび制限 (p. 125)」を参照してください。
Amazon S3 へのインポートプロセス
インポートジョブのプロセス
1
AWS アカウントに関連付けられる accessKeyId および secretKey を含む
AWSCredentials.properties ファイルを作成します。詳細については、「Save Your Credentials
to a File (p. 7)」を参照してください。
2
ストレージデバイスから単一の Amazon S3 バケットへのデータ転送方法を指定するイン
ポートマニフェストファイルを作成します。詳細については、「Creating an Import Manifest
File (p. 34)」を参照してください。
3
マニフェストファイルを含む CreateJob リクエストを送信してインポートジョブを開始します。
各デバイスに個別の CreateJob リクエストを送信します。ジョブは 30 日後に失効します。デバ
イスを送付しないかぎり、料金はかかりません。AWS Import/Export ツール、AWS コマンドライ
28
AWS Import/Export 開発者ガイド
Amazon S3 インポートジョブの作成
ンインターフェース (CLI)、AWS SDK for Java、または AWS REST API を使用して CreateJob リ
クエストを送信できます。最も簡単な方法は、AWS Import/Export ツールです。詳細については、
を参照してください。
AWS Import/Export ウェブサービスツールを使用した CreateJob リクエストの送信 (p. 43)
AWS SDK for Java を使用した CreateJob リクエストの送信 (p. 44)
REST API を使用した CreateJob リクエストの送信 (p. 47)
4
AWS Import/Export は、ジョブ ID と署名値を含むレスポンスを送信し、SIGNATURE ファイルをコ
ンピューターに保存します。
この情報は次のステップで必要になります。
5
オプションで、デバイスを暗号化するか、TrueCrypt を使用して暗号化ファイルコンテナを作成し
ます。暗号化コンテナを使用する場合、CreateJob リクエストで取得したジョブ ID を使用してコ
ンテナに <JOBID>.tc と名前をつけます。("KSVDJ.tc" など)。詳細については、「データの暗号
化 (p. 60)」を参照してください。
6
SIGNATURE ファイルをストレージデバイスのルートディレクトリにコピーします。AWS が送信し
たファイルを使用することも、レスポンスから SignatureFileContents 値を SIGNATURE という名
前の新規テキストファイルにコピーすることもできます。ファイル名は、SIGNATURE とし、デバイ
スのルートディレクトリに置く必要があります。
送付する各デバイスには、そのデバイスとその JOBID ごとに一意の SIGNATURE ファイルが必
要です。AWS Import/Export は、データのロードを開始する前に、ストレージデバイスにある
SIGNATURE ファイルを検証します。SIGNATURE ファイルが見つからない場合や無効の場合 (たとえ
ば、別のジョブリクエストに関連付けられているなど)、AWS Import/Export でデータロードは行
わずにストレージデバイスはお客様に返却されます。
Example
****************************************
* SignatureFileContents
*
****************************************
version:2.0
signingMethod:HmacSHA1
jobId:QTEST
signature:cbfdUuhhmauYS+ABCl5R9heDK/V=
7
ストレージデバイスにデータをコピーします。AWS Import/Export は、デバイスから単一の
Amazon S3 バケットにデータをロードします。データを Amazon S3 にアップロードするとき
に、ストレージデバイスのファイルパスは対応するオブジェクトキーで決まることにご注意くだ
さい。たとえば、ストレージデバイスのトップレベルに images フォルダがありその中にファイル
sample.jpg がある場合、アップロードされたファイル/オブジェクトキーは images/sample.jpg に
なります。ファイル名には UTF-8 文字エンコードを使用する必要があります。有効な UTF-8 文字
列以外の名前がついたファイルはインポートされません。ストレージデバイスの要件の詳細につい
ては、「ストレージデバイスの要件 (p. 58)」を参照してください。
29
AWS Import/Export 開発者ガイド
Amazon EBS インポートジョブの作成
8
デバイスとケーブルを UPS を通じて AWS に送付します。配送するデバイスにジョブ ID を含め、
前払い配送ラベルを使用してください。ラベルの印刷方法については、「ストレージデバイスの配
送 (p. 57)」を参照してください。そうしないと、ダウンロードが遅れる場合があります。
Note
複数のデバイスを同じ発送で配送できます。ただし、配送できるデバイスやデバイスの梱
包方法に関して、特定のガイドラインおよび制限があります。配送品が正しく準備され梱
包されていない場合は、AWS Import/Export でジョブを処理できません。一度に配送する
デバイスの数に関係なく、デバイスごとに個別のジョブリクエストを送信する必要があ
ります。複数のデバイスを発送する際の梱包要件に関する詳細は、「複数デバイスの配
送 (p. 64)」を参照してください。
ジョブは 30 日後に失効します。ジョブの有効期限が切れた後にパッケージを受領した場合は、デ
バイスを返却します。配送料金 (ある場合) に対してのみ課金されます。
9
Disk はストレージデバイスのルートドライブにある SIGNATURE ファイルを検証しま
す。SIGNATURE ファイルが CreateJob レスポンスと一致しない場合は、AWS ではデータのロード
ができず、デバイスをお客様に返却します。
お客様のストレージデバイスが AWS に到着後、データのロードは、通常、翌営業日から開始され
ます。データのロードに要する時間は、復号化、インポートステーションの空き具合、ロードする
データ量、お客様のデバイスの転送速度など多数の要素によって決まります。
データはすべて単一の Amazon S3 バケットにインポートされます。
10
データが暗号化されている場合、AWS はマニフェストファイル内で提供される PIN コードまたは
パスワードを使用して復号化します。データを復号化できない場合は、デバイスを消去して、指定
された住所に返送します。
11
データはすべて単一の Amazon S3 バケットにインポートされます。
12
インポートオペレーション後、インポートが成功していなくても、デバイスは消去されます。デバ
イスのデータを消去できない場合は、廃棄予定にします。この場合、当社のサポートチームからマ
ニフェストファイルに指定されたメールアドレスにご連絡します。
13
AWS は、ストレージデバイスを再梱包し、マニフェストファイルで提供された返送先住所に発送
します。私書箱宛の発送は取り扱っていません。
Amazon EBS インポートジョブの作成
AWS Import/Export はデバイスを Amazon Elastic Block Store (Amazon EBS) スナップショットにアップ
ロードします。Amazon EBS スナップショットは Amazon Elastic Compute Cloud (Amazon EC2) で使用
するボリュームに変換できます。
AWS Import/Export を使用して Amazon EBS にデータをアップロードしている場合、お客様は Amazon
Elastic Compute Cloud (Amazon EC2) ユーザーであり、ボリュームとスナップショットに関する Amazon
EBS の概念に精通していると想定されます。Amazon EBS の詳細については、「Amazon Elastic Block
Store」を参照してください。
Amazon EBS インポートにより、デバイス仮想コピーが単一イメージとして作成されます。デバイスの
ファイルシステムは自動的に Amazon EC2 インスタンスにマウントされません。Amazon EBS ボリュー
ムの最大サイズは 16 TB です。デバイスの最大容量は、デバイスに保存されたデータ量とは別であること
に注意してください。
デバイスごとに個別のジョブリクエストを送信する必要があります。
詳細については、「ガイドラインおよび制限 (p. 125)」を参照してください。
30
AWS Import/Export 開発者ガイド
Amazon EBS インポートジョブの作成
Amazon EBS へのインポートプロセス
Amazon EBS へのインポートプロセス
1
ストレージデバイスにデータをコピーします。データの唯一のコピーを送信しないでくださ
い。AWS はデバイスを消去します。セキュリティを高めるため、暗号化を使用することを強くお
勧めします。AWS はデータを復号しません。
2
AWS アカウントに関連付けられる accessKeyId および secretKey を含む
AWSCredentials.properties を作成します。詳細については、「Save Your Credentials to a
File (p. 7)」を参照してください。
3
オペレーション、Amazon EBS、リージョン、および返送先住所を指定するインポートマニフェ
ストファイルを作成します。詳細については、「Amazon EBS へのインポートのマニフェスト
ファイルオプション (p. 85)」を参照してください。
4
マニフェストファイルを含む CreateJob リクエストを送信してインポートジョブを開始します。
デバイスごとに個別のジョブリクエストを送信する必要があります。
ジョブは 30 日後に失効します。デバイスを送付しないかぎり、料金はかかりません。
AWS Import/Export ツール、AWS コマンドラインインターフェース (CLI)、AWS SDK for Java、
または AWS REST API を使用して CreateJob リクエストを送信できます。最も簡単な方法
は、AWS Import/Export ツールです。詳細については、 を参照してください。
AWS Import/Export ウェブサービスツールを使用した CreateJob リクエストの送信 (p. 43)
AWS SDK for Java を使用した CreateJob リクエストの送信 (p. 44)
REST API を使用した CreateJob リクエストの送信 (p. 47)
5
AWS Import/Export は、ジョブ ID、送付手順、PDF ファイル、および前払い配送ラベルを生成す
るリンクを含むレスポンスを送信します。
PDF ファイルには、ジョブ情報、送付手順、およびバーコードが含まれています。
デバイスごとに個別のジョブリクエストを送信し、各ジョブリクエストは固有のバーコードを生
成する必要があります。
AWS Import/Export は、データのロードを開始する前に、ストレージデバイスにあるバーコードを
検証します。バーコードが無効 (デバイスに一致しないなど)、存在しない、または読み取れない
場合、AWS Import/Export はデータのロードを実行せず、ストレージデバイスは返送されます。
6
PDF を印刷します。PDF の例については、「インポート PDF ファイル (p. 32)」を参照してく
ださい。
印刷された PDF のバーコード部分を切り取り、デバイスにテープで張り付けます。前払い配送
ラベルを使用して、デバイスを送付する必要があります。ラベルを印刷する方法の詳細について
は、「ストレージデバイスの配送 (p. 57)」を参照してください。
Important
署名バーコードを、デバイスの四面すべてにテープでしっかりと貼付します。署名バー
コードは削除や交換したり、もので覆ったりしないでください。署名バーコードがデバ
イスから分離している場合、検証ができず、データのロードを行わないでデバイスを返
却します。
7
デバイス、ケーブル、および印刷されたバーコードを AWS に送付します。そうしない場合、デバ
イスは処理されずに返送されることがあります。
31
AWS Import/Export 開発者ガイド
Amazon EBS インポートジョブの作成
Note
複数のデバイスを同じ発送で配送できます。ただし、配送できるデバイスやデバイスの
梱包方法に関して、特定のガイドラインおよび制限があります。配送品が正しく準備さ
れ梱包されていない場合は、AWS Import/Export でジョブを処理できません。一度に配送
するデバイスの数に関係なく、デバイスごとに個別のジョブリクエストを送信する必要
があります。複数のデバイスを発送する際の梱包要件に関する詳細は、「複数デバイス
の配送 (p. 64)」を参照してください。
Important
ジョブは 30 日後に失効します。デバイスを送付しないかぎり、料金はかかりません。請
求は、AWS Import/Export でデバイスを受け取った後でのみ行われます。ジョブの有効期
限が切れた後にパッケージを受領した場合は、デバイスを返却します。配送料金 (ある場
合) に対してのみ課金されます。
8
Disk はバーコードを使用して、データのロードを識別し、認証します。
お客様のストレージデバイスが AWS に到着後、データのロードは、通常、翌営業日から開始され
ます。データのロードに要する時間は、インポートステーションの空き具合、ロードするデータ
量、お客様のデバイスの転送速度など多数の要素によって決まります。
Amazon EC2 用の AWS マネジメントコンソール内で、アカウントの EBS スナップショットの
リストに Amazon EBS スナップショットが表示されます。Amazon EC2 コンソールでスナップ
ショットを検索する方法については、「AWS マネジメントコンソールの Amazon EBS スナップ
ショット (p. 32)」を参照してください。
9
インポートオペレーション後、インポートが成功していなくても、デバイスは消去されます。デ
バイスのデータを消去できない場合は、廃棄予定にします。この場合、当社のサポートチームか
らマニフェストファイルに指定されたメールアドレスにご連絡します。
10
AWS は、ストレージデバイスを再梱包し、マニフェストファイルで提供された返送先住所に発送
します。私書箱宛の発送は取り扱っていません。
インポート PDF ファイル
CreateJob リクエストへの AWS レスポンスには、ジョブ ID、AWS の送付先住所が含まれ、PDF ファイ
ルがコンピューターに保存されます。PDF ファイルには、デバイスを識別、認証するための一意のバー
コードとともに、送付手順が含まれています。この PDF ファイルの例を次に示します。
「Amazon EBS へのインポートプロセス (p. 31)」で説明したように、PDF を印刷し、デバイスにバー
コードをテープで張り付け、ページの送付手順に従う必要があります。
AWS マネジメントコンソールの Amazon EBS スナップショット
AWS マネジメントコンソールで、Amazon EBS インポートジョブのステータスをモニタリングできま
す。Amazon EBS スナップショットへのデータのインポートが開始されたら、Amazon EC2 用の AWS マ
ネジメントコンソールで、スナップショット ID とそのステータスを確認できます。
Amazon EBS スナップショットを見つけるには
1.
https://console.aws.amazon.com/ec2/) にある Amazon EC2 コンソールを開きます。
2.
左側のナビゲーションペインで [Snapshots] を選択します。
[EBS Snapshots] ペインが表示されます。
32
AWS Import/Export 開発者ガイド
Amazon Glacier インポートジョブの作成
説明フィールドには、CreateJob リクエストへのレスポンスとして AWS Import/Export によって提供され
るジョブ ID が含まれます。
Amazon Glacier インポートジョブの作成
Amazon Glacier インポートジョブにより、デバイスの仮想コピーが単一イメージとして作成されます。1
つのデバイスのイメージ全体が、既存の Amazon Glacier ボールトの 1 つの Amazon Glacier アーカイブに
アップロードされます。1 つのアーカイブは 1 つのデバイスのコンテンツを保持します。デバイスのファ
イルシステムがマウントされることはありません。各デバイスに個別の CreateJob リクエストを送信しま
す。
Amazon Glacier によって提供されるストレージのコストを抑えつつ、個別のファイルを別々のオブジェ
クトとして保存する場合は、まずファイルを Amazon S3 にインポートしてから、Amazon S3 オブジェ
クトライフサイクル管理を使用してファイルを GLACIER ストレージクラスに移行します。オブジェクト
を GLACIER ストレージクラスに移行させると、Amazon S3 は内部的に Amazon Glacier を使用して、堅牢
なストレージをより低コストで実現します。GLACIER オブジェクトスと関連付けられた Amazon S3 オブ
ジェクトは、Amazon S3 内でのみ表示および利用できます。詳細については、「オブジェクトのライフサ
イクル管理」を参照してください。
Disk を使用してデータを Amazon Glacier にアップロードしている場合、お客様はボールトとアーカイ
ブに関する Amazon Glacier の概念に精通していると想定されます。Amazon Glacier の詳細については、
「Amazon Glacier」を参照してください。
Amazon Glacier では、デバイスへのデータの完全なイメージがインポートされます。各ファイルは個別に
インポートされません。この機能は、Amazon Glacier からの任意のデータの取得では、完全なデバイスイ
メージを復元する必要があることを意味します。これには費用がかかる場合があります。
ファイル単位でデータにアクセスし、データを Amazon Glacier に保存する場合は、代わりに Amazon S3
インポートを実行し、ライフサイクルポリシーをバケットに追加して、個別のオブジェクトを Amazon
Glacier にアーカイブすることを検討してください。ライフサイクルポリシーの作成方法については、
「バージョニングを使用しないバケットのライフサイクル設定」を参照してください。
Note
サイズが 4 TB 以下のデバイスからのみ、Amazon Glacier のインポートを実行できます。
詳細については、「ガイドラインおよび制限 (p. 125)」を参照してください。
Amazon Glacier へのインポートのプロセス
インポートジョブのプロセス
1
ストレージデバイスにデータをコピーします。データの唯一のコピーを送信しないでくださ
い。AWS はデバイスを消去します。セキュリティを高めるため、暗号化を使用することを強くお
勧めします。AWS はデータを復号しません。
2
AWS アカウントに関連付けられる accessKeyId および secretKey を含む
AWSCredentials.properties ファイルを作成します。詳細については、「Save Your Credentials
to a File (p. 7)」を参照してください。
3
Amazon Glacier リージョンと送付先住所を指定するインポートマニフェストファイルを作成
します。詳細については、「Amazon Glacier へのインポートのマニフェストファイルオプショ
ン (p. 88)」を参照してください。
4
マニフェストファイルを含む CreateJob リクエストを送信してインポートジョブを開始します。
デバイスごとに個別のジョブリクエストを送信する必要があります。
ジョブは 30 日後に失効します。デバイスを送付しないかぎり、料金はかかりません。
33
AWS Import/Export 開発者ガイド
インポートマニフェストの作成
AWS Import/Export ツール、AWS コマンドラインインターフェース (CLI)、AWS SDK for Java、
または AWS REST API を使用して CreateJob リクエストを送信できます。最も簡単な方法
は、AWS Import/Export ウェブサービスツールです。詳細については、 を参照してください。
AWS Import/Export ウェブサービスツールを使用した CreateJob リクエストの送信 (p. 43)
AWS SDK for Java を使用した CreateJob リクエストの送信 (p. 44)
REST API を使用した CreateJob リクエストの送信 (p. 47)
5
AWS Import/Export は、ジョブ ID、送付手順、および PDF ファイルを含むレスポンスを送信しま
す。
PDF ファイルには、ジョブ情報、送付手順、およびバーコードが含まれています。
デバイスごとに個別のジョブリクエストを送信し、各ジョブリクエストは固有のバーコードを生成
する必要があります。
AWS Import/Export は、データのロードを開始する前に、ストレージデバイスにあるバーコードを
検証します。バーコードが無効 (デバイスに一致しないなど)、存在しない、または読み取れない場
合、AWS Import/Export はデータのロードを実行せず、ストレージデバイスは返送されます。
6
PDF を印刷します。PDF の例については、「インポート PDF ファイル (p. 32)」を参照してく
ださい。
印刷された PDF のバーコード部分を切り取り、デバイスにテープで張り付けます。デバイスは、
送付手順に示された住所に送付する必要があります。
Important
署名バーコードを、デバイスの四面すべてにテープでしっかりと貼付します。署名バー
コードは削除や交換したり、もので覆ったりしないでください。署名バーコードがデバイ
スから分離している場合、検証ができず、データのロードを行わないでデバイスを返却し
ます。
7
Disk はバーコードを使用して、データのロードを識別し、認証します。
お客様のストレージデバイスが AWS に到着後、データのロードは、通常、翌営業日から開始され
ます。データのロードに要する時間は、インポートステーションの空き具合、ロードするデータ
量、お客様のデバイスの転送速度など多数の要素によって決まります。
8
インポートオペレーション後、インポートが成功していなくても、デバイスは消去されます。デバ
イスのデータを消去できない場合は、廃棄予定にします。この場合、当社のサポートチームからマ
ニフェストファイルに指定されたメールアドレスにご連絡します。
9
AWS は、ストレージデバイスを再梱包し、マニフェストファイルで提供された返送先住所に発送
します。私書箱宛の発送は取り扱っていません。
インポートマニフェストの作成
トピック
• インポートマニフェストの例 (p. 35)
• 共通のインポートマニフェストオプションの設定 (p. 36)
• Amazon S3 インポートマニフェストの使用 (p. 37)
マニフェストファイルを作成することで、ジョブ情報を提供し、ストレージデバイスと AWS 間のデータ
の転送方法を指定します。マニフェストファイルは、ジョブの処理方法を AWS に指示する YAML 形式の
34
AWS Import/Export 開発者ガイド
インポートマニフェストの作成
テキストファイルです。デバイス ID、ログバケット、返送先住所などの必要情報を指定する一連の名前と
値のペアで構成されます。YAML の詳細については、http://yaml.org を参照してください。
インポートマニフェストの例
インポートジョブのタイプごとにそれぞれ一連の必須オプションがあります。
この Amazon S3 インポートマニフェストファイルの例には、必須オプションのみが含まれます。
manifestVersion: 2.0;
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
deviceId: 49382
eraseDevice: yes
notificationEmail: [email protected];[email protected]
bucket: myBucket
この Amazon EBS インポートマニフェストファイルの例には、必須オプションのみが含まれます。
manifestVersion: 3.0
deviceId: 49382
logBucket: myBucket
eraseDevice: yes
notificationEmail: [email protected];[email protected]
generator: AWS Import/Export Command Line Tool
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
operations:
- destination: ebs-snapshot
source: device
region: us-east-1
deviceCapacityGreaterThan1TB: yes
この Amazon Glacier インポートマニフェストファイルの例には、必須オプションのみが含まれます。
manifestVersion: 3.0
deviceId: 49382
logBucket: myBucket
generator: AWS Import/Export Command Line Tool
notificationEmail: [email protected];[email protected]
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
35
AWS Import/Export 開発者ガイド
インポートマニフェストの作成
operations:
- destination: glacier
source: device
region: us-east-1
vaultName: MyGlacierVault
archiveComment: July 24, 2012 daily archive
マニフェストオプションの完全なリストについては、「マニフェストファイルオプションのリファレン
ス (p. 69)」を参照してください。インポートマニフェストオプションの例については、「共通のイン
ポートマニフェストオプションの設定 (p. 36)」を参照してください。
共通のインポートマニフェストオプションの設定
これらのオプションは、Amazon S3、Amazon EBS、および Amazon Glacier に共通です。
トピック
• デバイスの国際配送 (p. 36)
• ストレージデバイスの至急返送 (p. 36)
• インポート後のデバイス消去の指定 (p. 36)
• ログファイル名の競合回避 (p. 36)
マニフェストオプションの完全なリストについては、「マニフェストファイルオプションのリファレン
ス (p. 69)」を参照してください。インポートマニフェストオプションの例については、「共通のイン
ポートマニフェストオプションの設定 (p. 36)」を参照してください。
デバイスの国際配送
欧州連合内を除くデバイスの国際配送では、マニフェストに関税オプションを含める必要がありま
す。関税関連のマニフェストオプションの詳細については、「マニフェストファイルの関税オプショ
ン (p. 73)」を参照してください。
ストレージデバイスの至急返送
デバイスを米国リージョンのバケットから米国の住所に返送する場合は、serviceLevel マニフェストオ
プションを使用して発送をアップグレードできます。デフォルトの serviceLevel オプションは、国内の
陸路による無料配送を含む標準配送です。expeditedShipping を指定すると、追加料金を支払って 2 日配
送でデバイスを配達できます。返送料金およびサービスに関する情報については、「AWS Import/Export
Calculator」を参照してください。
インポート後のデバイス消去の指定
各インポートオペレーション後、インポートが正常に完了していなくても、返送中のデータの安全をはか
るために、AWS Import/Export ではストレージデバイスのコンテンツを消去します。AWS は、デバイス
のすべての書き込み可能なブロックをゼロで上書きします。返送品がお手元に届いた後に、デバイスの再
パーティション化とフォーマットを行う必要があります。eraseDevice: Yes をインポートマニフェスト
に含めて、デバイスの消去を承認する必要があります。デバイス上のデータを消去できない場合、破棄が
スケジュールされ、サポートチームがマニフェストファイルの notificationEmail フィールドで指定され
た E メールアドレスに連絡します。
eraseDevice: yes
notificationEmail: [email protected]
ログファイル名の競合回避
AWS Import/Export プロセスはログファイルが生成されます。ログファイル名の末尾は常に importlog-JobId という形式です。同じ名前を持つオブジェクトが既に存在することがまれにあります。キーの
36
AWS Import/Export 開発者ガイド
インポートマニフェストの作成
衝突を回避するために、logPrefix オプションをマニフェストに追加して、任意指定のプレフィックスを
ログファイルに追加できます。AWS Import/Export Disk はこのプションに指定された文字列値を、バケッ
ト名とログレポート名の間に挿入します。次のマニフェストオプションでログキーのプレフィックスを設
定します。
logPrefix: logs/
たとえば、ジョブ ID が 53TX4 の場合、ログファイルは http://s3.amazonaws.com/mybucket/logs/
import-log-53TX4 に保存されます。
Note
フォワードスラッシュ (/) は自動的には含まれません。logPrefix の値の末尾にスラッシュを含め
ない場合、値はログファイル名に統合されます。たとえば、logPrefix がlogs である場合、ログ
ファイルキーは logs/import-log-JobId ではなくlogsimport-log-jobId になります。
logPrefix + import-log-JOBID で 1024 バイト長を超えてはいけません。超過した場合、Disk は
CreateJob アクションで InvalidManifestField エラーを返します。
Amazon S3 インポートマニフェストの使用
これらのオプションは、Amazon S3 インポートジョブで使用されます。
トピック
• Gzip ファイルの処理 (p. 37)
• インポートされた Amazon S3 オブジェクトの ACL の設定 (p. 38)
• ファイルとディレクトリの除外 (p. 38)
• Disk での Amazon S3 オブジェクトキー名の処理 (p. 39)
Gzip ファイルの処理
Gzip 圧縮ファイルをインポートする場合、setContentEncodingForGzFiles をyes に設定できます。これ
により、Gzip 圧縮ファイルをアップロードする際に Content-Type ヘッダーに加えて Content-Encoding
ヘッダーを追加できます。Content-Encoding ヘッダーにより、ほとんどのブラウザでファイルが正しくレ
ンダリングされます。
setContentEncodingForGzFiles: yes
さらに、拡張子、.gz および gzip は、ファイルが Gzip で圧縮されている場合 Content-Type ヘッダーの
設定では無視されます。
たとえば、setContentEncodingForGzFiles が yes に設定されている場合、Gzip を使用して圧縮された圧
縮ファイル text1.html.gz は次の HTTP ヘッダーとともにアップロードされます。
• Content-Encoding: gzip
• Content-Type: text/html
gzip 圧縮ファイル text2.html は、次の HTTP ヘッダーとともにアップロードされます。
• Content-Encoding: gzip
• Content-Type: text/html
非圧縮ファイル text3.html は、次の HTTP ヘッダーとともにアップロードされます。
37
AWS Import/Export 開発者ガイド
インポートマニフェストの作成
• Content-Type: text/html
Note
setContentEncodingForGzFiles が yes に設定されている場合、gzip で圧縮されたファイルにの
み Content-Encoding ヘッダーが含まれます。当社では、インポートされたすべてのファイルの最
初の数バイトを調べて、Gzip を使用して圧縮されているかどうかを確認します。圧縮されている
場合は、ファイルの拡張子にかかわらず Content-Encoding ヘッダーが付けられます。
gzip 圧縮ファイル text.gzip は、マニフェストファイルに指定された defaultContentType を使用した次
の HTTP ヘッダーとともにアップロードされます。
• Content-Encoding: gzip
• Content-Type: binary/octet-stream
インポートされた Amazon S3 オブジェクトの ACL の設定
データを Amazon S3 にインポートする場合、インポートされたオブジェクトに対するアクセス権限はプ
ライベートに設定されます。acl マニフェストオプションを指定して、インポートされたオブジェクトの
アクセスコントロールリスト (ACL) を指定できます。次のマニフェストオプションは、アップロードされ
たオブジェクトの ACL 値を public-read に設定します。
acl: public-read
ファイルとディレクトリの除外
トピック
• ファイルの除外 (p. 38)
• ディレクトリの除外 (p. 39)
• ごみ箱の除外 (p. 39)
• Lost+Found の除外 (p. 39)
ストレージデバイスの一部のディレクトリとファイルをインポートしないように AWS Import/Export に指
示できます。これは、ディレクトリ構造を保持しながら不要なファイルやディレクトリのアップロードを
避ける場合に便利な機能です。ignore オプションを使用して、ストレージデバイス内で無視するディレク
トリ、ファイル、ファイルタイプを指定します。命名パターンを指定するには、Java の標準的な正規表現
を使用します。Java の正規表現については、http://download.oracle.com/javase/tutorial/essential/regex/ を
参照してください。次の例は、マニフェストでよく使用される Java の正規表現を示します。
ファイルの除外
次の例は、2 つの Java 正規表現を使用した ignore オプションを使用して、サフィックスの末尾がチルダ
および .swp で終わるファイルを除外します。
ignore:
- .*~$
- .*\.swp$
以下の ignore オプションは、ストレージデバイス内で.psd 拡張子が付いたすべてのファイルが除外され
ます。
ignore:
- \.psd$
- \.PSD$
38
AWS Import/Export 開発者ガイド
インポートマニフェストの作成
ログレポートには、ストレージデバイスのルートに追加された SIGNATURE ファイルを含む、無視されたす
べてのファイルが含まれます。
ディレクトリの除外
以下の ignore オプションは、ストレージデバイスのルートにある backup ディレクトリをインポートから
除外するように指定します。
ignore:
- ^backup/
Important
たとえば images/myImages/sampleImage.jpg のようなファイル区切りを含むパスを指定する場
合は、必ずバックスラッシュではなくフォワードスラッシュ「/」を使用してください。
以下の ignore オプションは、images/myImages ディレクトリのすべてのコンテンツを無視します。
ignore:
- ^images/myImages/
ごみ箱の除外
多くのストレージデバイスにはごみ箱が含まれます。インポートプロセスでごみ箱をアップロードする必
要がない場合があります。Windows コンピューターのごみ箱をスキップするには、次の ignore オプショ
ンを指定します。1 行目の正規表現は、Windows Vista および Windows 7 用にフォーマットされた NTFS
ファイルシステムに適用されます。2 行目の正規表現は、Windows 2000、Windows XP、Windows NT の
NTFS ファイルシステムに適用されます。3 行目の正規表現は、FAT ファイルシステムに適用されます。
ignore:
- ^\$Recycle\.bin/
- ^RECYCLER/
- ^RECYCLED/
Lost+Found の除外
次の ignore ステートメントの Java 正規表現は、lost+found ディレクトリのアップロードを防止しま
す。
ignore:
- ^lost\+found/
Disk での Amazon S3 オブジェクトキー名の処理
トピック
• キープレフィックスの指定 (p. 40)
• Amazon S3 代替の使用 (p. 40)
Disk ストレージデバイスのファイルパスは、AWS がデータを Amazon S3 バケットにインポートする際に
対応するオブジェクトキーが決まります。たとえば、ストレージデバイスのトップレベルに images フォ
ルダがありその中にファイル sample.jpg がある場合、アップロードされたファイル/オブジェクトキーは
images/sample.jpg になります。
substitutions オプションを使用して、Amazon S3 へのインポート時にオブジェクトキー名を変更でき
ます。たとえば、ファイル名にプレフィックスまたはサフィックスを追加できます。詳細については、
「Amazon S3 代替の使用 (p. 40)」を参照してください。
39
AWS Import/Export 開発者ガイド
インポートマニフェストの作成
キープレフィックスの指定
AWS Import/Export のプレフィックスメカニズムにより、バケット内にオブジェクトの論理グループを作
成できます。prefix 値は、バケット内の同じディレクトリに同様のデータを保存するためのディレクトリ
名に似ています。たとえば、Amazon S3 バケット名が my-bucket であり、prefix が my-prefix/ に設定
されていて、ストレージデバイス内のファイルが /jpgs/sample.jpg である場合、sample.jpg が http://
s3.amazonaws.com/my-bucket/my-prefix/jpgs/sample.jpg にロードされます。プレフィックスが指定さ
れていない場合、sample.jpg は http://s3.amazonaws.com/my-bucket/jpgs/sample.jpg にロードされ
ます。マニフェストに prefix オプションを追加してプレフィックスを指定できます。
Important
フォワードスラッシュ (/) は自動的には含まれません。prefix の値の末尾にスラッシュを含めな
い場合、値はファイル名に統合されます。たとえば、プレフィックスが images であり、ファイル
sample.jpg をインポートする場合、キーは images/sample.jpg ではなく imagessample.jpg に
なります。
prefix: my-prefix/
Amazon S3 代替の使用
substitutions オプションは、Amazon S3 のインポートジョブまたはエクスポートジョブ中のファイル
名の変更や、ファイル名へのプレフィックスまたはサフィックスの追加などの名前変更に便利です。イン
ポートジョブの場合は、substitutions オプションを使用してオブジェクトキー名を変更します。エクス
ポートジョブの場合は、substitutions オプションを使用してファイルシステムに書き込む名前を変更し
ます。たとえば、以下のエントリを使用して、Amazon S3 バケットにデータをアップロードする前に、
ファイル名とディレクトリのすべての大文字「A」「B」「C」をオブジェクトキー名で小文字に置換でき
ます。
substitutions オプションは、manifestVersion が 2.0 に設定されている場合にのみ使用できます。ま
た、Amazon EBS または Amazon Glacier のインポートジョブでは使用できません。
substitutions:
"A" : "a"
"B" : "b"
"C" : "c"
Important
値全体を空の文字列に置換しないでください。インポートジョブでは、空の文字列を使用すると
インポートが失敗し、ログに「400 InvalidSubstitution」エラーがレポートされます。また、複数
のファイルが同じファイル名にマッピングされるような代替は避けてください。インポートジョ
ブでは、複数ファイルが同じファイル名にマッピングされた場合の動作は未定義です。エクス
ポートジョブでは、複数ファイルが同じファイル名にマッピングされると、オブジェクトが復旧
プロセスに振り分けられます。復旧プロセスの詳細については、「命名エラーがあるファイルの
収集 (p. 56)」を参照してください。
substitutions オプションは、prefix オプションがすべて適用された後に適用されます。最初に、prefix
オプションがコピーする Amazon S3 データを決定し、その後 substitutions オプションが書き込む値を
決定します。エクスポートジョブの場合、targetDirectory オプションが指定されていれば、デバイスへ
の書き込み中に targetDirectory 値に substitutions オプションが適用されます。
例: Prefix オプションと Substitutions オプションを両方使用
prefix: myprefix$COLON$
substitutions:
"$COLON$" : ":"
"$QUOTE$" : "\""
40
AWS Import/Export 開発者ガイド
インポートマニフェストの作成
上記のオプションを使用する場合、以下のようなデバイスの完全修飾ファイル名などを入力できます。
/backup/$COLON$/$QUOTE$computer1$QUOTE$/c$COLON$/image.dat
AWS Import/Export で置換が実行され、ファイル名は以下のような Amazon S3 オブジェクト名になりま
す。
myprefix:backup/:/"computer1"/c:/image.dat
例: Substitutions、Prefix、targetDirectory オプションを使用
substitutions:
":" : "$COLON$"
"," : "$COMMA$"
operations:
- exportBucket: mybucket
prefix: myprefix,
targetDirectory: data,
上記のオプションを使用する場合、以下のような Amazon S3 オブジェクト名などを入力できます。
mybucket/myprefix,/backup/:/computer1/c:/image.dat
AWS Import/Export で置換が実行され、オブジェクト名はデバイスでは以下のような完全修飾ファイル名
になります。
/data$COMMA$/myprefix$COMMA$/backup/$COLON$/computer1/c$COLON$/image.dat
例: 名前空間エンコードの変更
ほとんどの場合、ファイルシステムの名前空間の要件は Amazon S3 の名前空間の要件よりも制限が厳し
く、有効なファイルシステム名と Amazon S3 キー名空間の間でマッピングする必要がある場合がありま
す。インポートジョブでは、アップロード前にデコードされたファイル名を情報とともにエンコードする
ことで、Amazon S3 でサポートされているより多く表記できる名前空間の利点を活かすことができます。
次の例では、コロンの文字エンコードが、Amazon S3 名前空間のコロンに変換されます。
substitutions:
$COLON$ : ":"
エクスポートジョブでは、ファイルシステムにマッピングされない文字を処理できます。
substitutions:
":" : "$COLON$"
大文字を小文字にマッピングする
インポートジョブで、ファイル名のすべての大文字をオブジェクト名で対応する小文字に置換するルール
を定義できます。たとえば、次のエントリを使用して、英文字全体でファイル名の大文字をすべて小文字
に置き換えます。オプションパラメーターの左側に大文字の英字をすべてリストし (一文字ずつ指定する
必要があります)、オプションパラメーターの右側に小文字をリストします (ここで「…」は C から Y まで
のすべての文字を表します)。
substitutions:
"A" : "a"
41
AWS Import/Export 開発者ガイド
CreateJob リクエストの送信
"B" : "b"
"C" : "c"
...
"Y" : "y"
"Z" : "z"
詳細については、「マニフェストファイルの共通オプション (p. 70)」の「substitutions」を参照して
ください。
Amazon S3 ルートへのファイルディレクトリのマッピング
Amazon S3 は、同じバケットに数百万件のファイルがある場合にも適切に実行します。AWS Import/
Export を使用して Amazon S3 にデータを効率的にインポートするには、サブディレクトリを削除する必
要がある場合があります。ディレクトリの名前がファイル名のサブ文字列ではないなど、ディレクトリを
慎重に命名している場合は、substitutions マニフェストオプションを使用してキー名からディレクトリ
を削除できます。次の例では、ファイルシステム内に ZZ1、ZZ2、ZZ3 という 3 つのサブディレクトリにま
たがってファイルを分割しているディレクトリ構造になっていると仮定しています。
ZZ1/
ZZ2/
ZZ3/
ディレクトリ名を Amazon S3 キー名から削除するには、マニフェストファイルで次の substitutions オ
プションを定義します。
substitutions:
"ZZ1/" : ""
"ZZ2/" : ""
"ZZ3/" : ""
すべてのファイルは Amazon S3 バケットのルートに保存されます。
Important
サブディレクトリ内のファイルのファイル名には substitutions の文字列が含まれていてはいけ
ません ("ZZ1/"、"ZZ2/"、"ZZ3/" など)。
同じ名前のファイルが 2 つある場合、どちらのファイルも Amazon S3 にアップロードされます
が、最後に転送されたファイルのバイトだけが保持されます。
ファイル区切り記号にはフォワードスラッシュ (/) を使用します。バックスラッシュ (\) または二
重バックスラッシュ (\\) は使用しないでください。
CreateJob リクエストの送信
トピック
• AWS Import/Export ウェブサービスツールを使用した CreateJob リクエストの送信 (p. 43)
• AWS SDK for Java を使用した CreateJob リクエストの送信 (p. 44)
• REST API を使用した CreateJob リクエストの送信 (p. 47)
このセクションでは、AWS Import/Export に CreateJob リクエストを送信するツールの概要を示します。
AWSCredentials.properties ファイルとマニフェストファイルを作成したら、ジョブのタイプ、インポー
トまたはエクスポート、マニフェストファイルを指定する CreateJob リクエストを送信して、インポート
ジョブまたはエクスポートジョブを開始します。
AWS Import/Export ウェブサービスツール、AWS SDK for Java、または AWS REST API を使用して
CreateJob リクエストを送信できます。最も簡単な方法は、AWS Import/Export ウェブサービスツールを
使用することです。
42
AWS Import/Export 開発者ガイド
CreateJob リクエストの送信
AWS Import/Export ウェブサービスツールを使用した CreateJob
リクエストの送信
CreateJob リクエストを送信する最も簡単な方法は、AWS Import/Export ツールを使用することです。
AWS Import/Export ウェブサービスツールを使用して CreateJob リクエストを送信するには
1. 次のリンクをクリックして、AWS Import/Export ウェブサービスツールをダウンロードします。
[http://awsimportexport.s3.amazonaws.com/importexport-webservice-tool.zip] をクリックします。
コンピューター上のディレクトリに、圧縮されたコンテンツを展開します。
2. コマンドプロンプト (またはターミナルアプリケーション) を開き、AWS Import/Export ウェブサービス
ツールを展開したディレクトリに移動します。
3. コマンドラインに CreateJob リクエストを入力し、インポートまたはエクスポート、およびマニフェス
トファイル名を指定します。
インポートジョブの場合、コマンドラインに次の CreateJob リクエストを入力します。
CmdPrompt>java -jar lib/AWSImportExportWebServiceTool-1.0.jar CreateJob Import
MyImportManifest.txt .
エクスポートジョブの場合、コマンドラインに次の CreateJob リクエストを入力します。
CmdPrompt>java -jar lib/AWSImportExportWebServiceTool-1.0.jar CreateJob Export
MyExportManifest.txt .
CreateJob リクエストには、SIGNATURE ファイルを保存する場所のディレクトリ名が含まれます。この
例で、コマンドの最後にあるピリオド (.) は、現在のディレクトリを示します。上記のようにピリオド
を含めるか、ディレクトリパスで置き換えます。
エラーがある場合、AWS Import/Export はエラーメッセージを返します。
リクエストにエラーがない場合、AWS Import/Export は JOB CREATED レスポンスを返します。
Note
エクスポートの場合、Amazon S3 ログバケットと Amazon S3 エクスポートバケットは同じリー
ジョンにある必要があります。バケットが異なるリージョンにある場合、ジョブのリクエストは
失敗します。
Amazon S3 インポートまたはエクスポートジョブの場合、レスポンスにはジョブ ID と署名値が含ま
れ、SIGNATURE ファイルがコンピューターに保存されます。
Amazon EBS または Amazon Glacier インポートジョブの場合、レスポンスにはジョブ ID と送付手順が含
まれます。また、コンピューターと、マニフェストで識別した Amazon S3 バケットに PDF ファイルが配
置されます。PDF ファイルには、ジョブ情報、送付手順、およびバーコードが含まれています。
次の例に、インポートジョブのレスポンスとエクスポートジョブのレスポンスを示します。
Example インポートジョブのレスポンス
JOB CREATED
JobId: ABCDE
JobType: Import
****************************************
* AwsShippingAddress *
****************************************
43
AWS Import/Export 開発者ガイド
CreateJob リクエストの送信
Please call GetShippingLabel API to retrieve shipping address
****************************************
* SignatureFileContents *
****************************************
version:2.0
signingMethod:HmacSHA1
jobId:ABCDE-VALIDATE-ONLY
signature:cbfdUuhhmauYS+ABCl5R9heDK/V=
Writing SignatureFileContents to cmdPrompt\.\SIGNATURE
Please use GetShippingLabel API endpoint to print your shipping label.
Example エクスポートジョブのレスポンス
JOB CREATED
********************************
* RECEIVED SUCCESSFUL RESPONSE *
********************************
jobId: ETU5V
signature: f7+7Dabe30tqvZkFFjlIOK5KUHg=
jobType: Export
*******************************************************
* signatureFileContents - write this to a file called *
* SIGNATURE in the root of your disk
*
*******************************************************
version:2.0
signingMethod:HmacSHA1
jobId:ETU5V
signature:f7+7Dabe30tqvZkFFjlIOK5KUHg=
Please use GetShippingLabel API endpoint to print your shipping label.
「ご利用開始にあたって (p. 6)」セクションでは、AWS Import/Export ウェブサービスツールを使用し
たインポートおよびエクスポートジョブを作成する詳しいステップの例を示します。
AWS SDK for Java を使用した CreateJob リクエストの送信
AWS SDK for Java はインポートジョブやエクスポートジョブを作成する API を公開しています。このレ
スポンスの情報を使用して、ストレージデバイスを AWS に送付できます。
ジョブプロセスの作成
1
AWS 認証情報を指定して、AmazonImportExportClient クラスのインスタンスを作成しま
す。
2
ジョブのタイプ、マニフェストなどのジョブ情報を指定して、CreateJobRequest クラスの
インスタンスを作成します。
3
AmazonImportExportClient.createRequest メソッドを呼び出してジョブ作成リクエストを
送信します。
次の Java コード例は、前述のステップを使用してインポートジョブを作成する方法を説明しています。
Example
AmazonImportExportClient client =
new AmazonImportExportClient(
new PropertiesCredentials(
ImportCreateJobSample.class.getResourceAsStream("AWSCredentials.properties")));
44
AWS Import/Export 開発者ガイド
CreateJob リクエストの送信
String manifest = readManifestFile(manifestFilePath);
CreateJobRequest createRequest = new
CreateJobRequest().withManifest(manifest).withJobType("Import");
CreateJobResult createResult = client.createJob(createRequest);
次の Java コード例は、前述のステップを使用してエクスポートジョブを作成する方法を説明していま
す。
Example
AmazonImportExportClient client =
new AmazonImportExportClient(
new PropertiesCredentials(
ImportCreateJobSample.class.getResourceAsStream("AWSCredentials.properties")));
String manifest = readManifestFile(manifestFilePath);
CreateJobRequest createRequest = new
CreateJobRequest().withManifest(manifest).withJobType("Export");
CreateJobResult createResult = client.createJob(createRequest);
Java を使用して CreateJob リクエストを送信し、レスポンスを印刷するには
1.
プロパティファイル AWSCredentials.properties を作成し、IAM ユーザー用のアクセスキー ID と
シークレットキーの値を提供します。詳細については、「AWS Import/Export Disk での IAM の使
用 (p. 25)」を参照してください。
認証情報ファイルの例を次に示します。
accessKey:<###### ID>
secretKey:<########>
Note
AWS Import/Export ウェブサービスツールで使用するのと同じ AWSCredentials.properties
ファイルを使用することはできません。これらのフィールドは同じではありません。
AWSCredentials.properties ファイルは、生成された .class ファイルと同じディレクトリに保存され
る必要があります。したがって、クラスがパッケージにある場合、または IDE が .class ファイルを別
の場所に配置する場合、プロパティファイルを保存する適切なディレクトリを決定する必要がありま
す。したがって、マニフェストファイルへのパスは、ファイルへの完全パスを含み、明示的である必
要があります (たとえば、C:\\Users\\UserName\\MyManifest.txt)。
2.
ジョブについて説明するマニフェストファイルを作成します。
3.
マニフェストの例については、「最初の Amazon S3 インポートジョブの作成 (p. 8)」または「最
初の Amazon S3 エクスポートジョブの作成 (p. 20)」を参照してください。
プロジェクトのファイルに次の Java クラスをコピーします。
import
import
import
import
import
import
import
java.io.BufferedReader;
java.io.FileReader;
java.io.IOException;
com.amazonaws.auth.PropertiesCredentials;
com.amazonaws.services.importexport.AmazonImportExportClient;
com.amazonaws.services.importexport.model.CreateJobRequest;
com.amazonaws.services.importexport.model.CreateJobResult;
public class ImportExportCreateJobSample {
private static String manifestFilePath = "[Provide-Explicit-Manifest-File-Path]";
public static void main(String args[]) throws IOException {
AmazonImportExportClient client =
45
AWS Import/Export 開発者ガイド
CreateJob リクエストの送信
new AmazonImportExportClient(
new PropertiesCredentials(
ImportExportCreateJobSample.class.getResourceAsStream("AWSCredentials.properties")));
String manifest = readManifestFile(manifestFilePath);
CreateJobRequest createRequest = new
CreateJobRequest().withManifest(manifest).withJobType("[Import|Export]");
// Call service.
CreateJobResult createResult = client.createJob(createRequest);
// Process result.
System.out.println();
System.out.println();
System.out.println("********************************");
System.out.println("* RECEIVED SUCCESSFUL RESPONSE *");
System.out.println("********************************");
System.out.println("jobId: " + createResult.getJobId());
System.out.println("signature: " + createResult.getSignature());
System.out.println("jobType: " + createResult.getJobType());
System.out.println();
System.out.println("*******************************************************");
System.out.println("* signatureFileContents - write this to a file called *");
System.out.println("* SIGNATURE in the root of your disk
*");
System.out.println("*******************************************************");
System.out.println(createResult.getSignatureFileContents());
System.out.println();
System.out.println("*******************************");
System.out.println("* Obtain shipping information *");
System.out.println("*******************************");
System.out.println(createResult.getAwsShippingAddress());
}
public static String readManifestFile(String filename) throws IOException {
StringBuilder manifest = new StringBuilder();
BufferedReader input = new BufferedReader(new FileReader(filename));
try {
String line = null;
while ((line = input.readLine()) != null) {
manifest.append(line);
manifest.append(System.getProperty("line.separator"));
}
} finally {
input.close();
}
return manifest.toString();
}
}
4.
マニフェストファイルのパスと、ジョブのタイプ用のインポートまたはエクスポートを指定してコー
ドを更新します。
5.
コードを実行します。
Amazon S3 インポートまたはエクスポートジョブの場合、AWS Import/Export から、ジョブ ID、署名
値、前払い配送ラベルの印刷方法を含むレスポンスが送信されます。レスポンスはコンピューターの
SIGNATURE ファイルにも保存されます。
AWS EBS または Amazon Glacier インポートジョブの場合、AWS Import/Export から、ジョブ ID と
送付手順を含むレスポンスが送信されます。また、マニフェストに指定された Amazon S3 ログバ
ケットに PDF ファイルが配置されます。PDF ファイルには、ジョブ情報、送付手順、およびバー
コードが含まれています。
46
AWS Import/Export 開発者ガイド
インポートログの表示
REST API を使用した CreateJob リクエストの送信
アプリケーションで AWS Import/Export へのプログラムによるアクセスが必要で、AWS SDK が要件に合
わない場合は、REST API を使用して直接プログラムできます。
REST API を使用してジョブを作成するには
1. ジョブについて説明するマニフェストファイルを作成します。
マニフェストの例については、「最初の Amazon S3 インポートジョブの作成 (p. 8)」または「最初
の Amazon S3 エクスポートジョブの作成 (p. 20)」を参照してください。
2. マニフェストファイルを URL エンコードします。
3. リクエストに署名します。
詳細については、「クエリリクエストを行う (p. 96)」を参照してください。
4. CreateJob リクエストを送信し、JobType=Import または JobType=Export を指定します。
インポートジョブのサンプル CreateJob リクエストを次に示します。リクエストには、Manifest オ
プション値としてリクエストの本文に URL エンコードされたマニフェストファイルが含まれます。ま
た、リクエストにはその他の必須の文字列パラメーターも示されます。
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:579
Action=CreateJob&Manifest=manifestVersion%3A%202.0%0Abucket%3A%20myBucket%0eraseDevice
%3A%20yes%0AreturnAddress%3A%0A%20%20%20%20name%3A%20Amazon.com%20ATTN%20Joe%20Random
%20%0A%20%20%20%20street1%3A%201200%2012th%20Ave%20S.%0A%20%20%20%20city%3A%20Seattle
%0A%20%20%20%20stateOrProvince%3A%20WA%0A%20%20%20%20postalCode%3A%2098114%0A
%20%20%20%20phoneNumber%3A%20206-266-0000%0A%20%20%20%20country%3A%20USAJobType=Import
SignatureVersion=2&SignatureMethod=HmacSHA256&Version=2010-06-01&Signature=
%2FVfkltRBOoSUi1sWxRzN8rw%3D
Amazon S3 インポートまたはエクスポートジョブの場合、AWS Import/Export から、ジョブ ID、署名
値、前払い配送ラベルの印刷方法を含むレスポンスが送信されます。
AWS EBS または Amazon Glacier インポートジョブの場合、AWS Import/Export から、ジョブ ID と送
付手順を含むレスポンスが送信されます。また、マニフェストに指定された Amazon S3 ログバケット
に PDF ファイルが配置されます。PDF ファイルには、ジョブ情報、送付手順、およびバーコードが含
まれています。
REST API を使用したジョブ作成の詳細については、「CreateJob (p. 103)」を参照してくださ
い。ValidateOnly パラメーターを true に設定することで、ジョブを作成することなくマニフェストおよび
パラメーターの値を検証できます。
インポートログの表示
AWS とポータブルストレージデバイスの間でデータが正常に転送されると、AWS Import/Export によって
ログが生成され、Amazon S3 にオブジェクトとして保存されます。
トピック
• ログファイル (p. 48)
• Amazon S3 および Amazon EBS ログファイルのフィールド (p. 48)
• Amazon Glacier ログファイル (p. 50)
47
AWS Import/Export 開発者ガイド
インポートログの表示
• ステータスコード (p. 50)
ログファイル
ログファイルは、ストレージデバイスへ/からロードする各ファイルに関する情報などを含む UTF-8 でエ
ンコードされた CSV ファイルです。
Amazon S3 インポートジョブでは、AWS Import/Export はデータと同じ Amazon S3 バケットにログファ
イルを保存します。
Amazon EBS および Amazon Glacier のジョブの場合は、AWS Import/Export はマニフェストファイルの
logBucket オプションで指定されたバケットにログを保管します。
インポートジョブでは、ログ名の末尾は常に import-log-JOBID という形式です。エクスポートジョブ
では、ログ名の末尾は常に export-log-JOBID という形式です。たとえば、インポート JOBID が 53TX4
であれば、ログファイル名は import-log-53TX4 で終わります。デフォルトでは、マニフェストファイ
ルに logPrefix が設定されていない場合、JOBID が53TX4 で mybucket にロードされたジョブは、ログ
をhttp://mybucket.s3.amazonaws.com/import-log-53TX4 にロードします。logPrefix を logs/ に設定
した場合、ログの場所は http://s3.amazonaws.com/mybucket/logs/import-log-53TX4 です。
エクスポートジョブでは、ログ名の末尾は常に export-log-JOBID という形式です。たとえば、JOBID が
53TX4 の場合は、ログファイル名は http://s3.amazonaws.com/mybucket/logs/export-log-53TX4 で終
わります。
Note
既存の Amazon S3 オブジェクトと同じキー名のログオブジェクトがある場合、既存のオブジェ
クトは新しいログで上書きされます。logPrefix オプションを使用することでオブジェクトの競
合を防止できます。
ログファイルの表示
AWS マネジメントコンソールを使用してログをダウンロードできます。詳細については、http://
aws.amazon.com/console/ を参照してください。
Amazon S3 および Amazon EBS ログファイルのフィールド
以下の表では、Amazon S3 または Amazon EBS ログファイルのフィールドについて説明します。
フィールド
説明
DateTime
ファイルが処理された日時。例: Wed Nov 12 11:07:34 PST 2008
ファイル
ストレージデバイスのルートディレクトリのファイル名。例: /images/
image.jpg
ステータス
Disk のステータスまたは標準的な Amazon S3 REST ウェブサーバーの HTTP ス
テータスコードの 1 つを指定します。例: 200. 詳細については、「エラーとス
テータスコード (p. 122)」を参照してください。
コード
Disk コード (例: Status が 103 の場合の Ignored)、または Amazon S3 の標準的
な REST エラーコード (例: OK) を指定します。
キー
Disk が Amazon S3 内のどこにファイルをロードするかを指定します。キーに
は、バケット名とマニフェストファイルで設定されたプレフィックス設定が含ま
れます。例: /mybucket/myprefix/images/image.jpg。
48
AWS Import/Export 開発者ガイド
インポートログの表示
フィールド
説明
MD5
Key によって識別される Amazon S3 内に保存されたオブジェクトのチェックサ
ム。例: d2a22fcab097sample32c544
Note
Amazon S3 にインポートされたオブジェクトは、パブリック Amazon
S3 API アクションを使用します。より小さなオブジェクトは PUT
Object を使用して Import/Export によってアップロードされ、より大
きなオブジェクトはマルチパートアップロードを使用してアップロー
ドされます。PUT Object によって作成されたオブジェクトには、オ
ブジェクトデータが MD5 ダイジェストである ETags があります。た
だし、マルチパートアップロードによって作成されたオブジェクトに
は、MD5 ダイジェストではない ETags があります。したがって、S3
からの ETags は、ローカル MD5 の合計に一致しない可能性がありま
す。
AWS Import/Export Disk インポートジョブでは、各パートをアップロー
ドする前に MD5 の合計を計算し、UploadPart の入力として提供しま
す。次に、ファイル全体の MD5 の合計が、内部ログの 1 つに書き込ま
れます。アップロードが完了すると、ディスクのすべてのデータが自
動的に再度読み取れられて MD5 の合計が計算され、インポートされた
オブジェクトの MD5 の合計と比較されます。何らかの理由で、一致し
ない MD5 の合計をソフトウェアが読み取った場合、ワークフロー全体
がthe section called “失敗したジョブ” (p. 69)します。
Amazon S3 での ETags と MD5 の合計の計算方法については、
『Amazon Simple Storage Service API Reference』の「共通の応答ヘッ
ダー」を参照してください。
Bytes
Key によって識別されるオブジェクトの、Amazon S3 に保存されたバイト数。
例: 57344
Content-Type
Amazon S3 に保存される Content-Type ヘッダーの値。例: image/jpeg
ETag
Amazon S3 のオブジェクトの ETag 値。
サンプル Amazon S3 ログファイル
以下は Amazon S3 インポートログファイルのサンプルです。
DateTime
ファイル
ステー
タス
Tue 03 Feb
200921:57:43
GMT
SIGNATURE 103
Tue 03 Feb
200921:57:43
GMT
Notice.txt
Tue 03 Feb
200921:57:43
GMT
README.
txt
Tue 03 Feb
200921:57:43
GMT
コー
ド
キー
MD5
Bytes
ContentType
Ignore 90
application/
octetstream
200
OK
MyBucket/
images/
Notice.txt
f60fe317bc4
97b1204b327
490959eb64
13
text/plain
200
OK
MyBucket/
images/
README.txt
d5a46fa2259
6d2464effba
bb19000e
13
text/plain
images/
200
wookie1.jpg
OK
MyBucket/
images/imageswookie1.jpg
ccac0d0316
03ff1c299770
3a64845
497
image/
jpeg
49
AWS Import/Export 開発者ガイド
エクスポートジョブの使用
DateTime
ファイル
ステー
タス
コー
ド
キー
MD5
Bytes
ContentType
Tue 03 Feb
200921:57:43
GMT
images/
chewie.GIF
200
OK
MyBucket/
images/imageschewie.GIF
5fc22dc5
94e0c5929c0
b9585ba9e70
878
image/gif
Tue 03 Feb
200921:57:43
GMT
images/
resources/
chewie.psd
200
OK
MyBucket/
images/imagesresourceschewie.psd
130b64d1
71e9bbc2be11
7f189796c
524
application/
octetstream
Tue 03 Feb
200921:57:43
GMT
images/
chewie.TIF
200
OK
MyBucket/
images/imageschewie.TIF
823d17b
05321b96f91
74e3dcace7
458
image/tiff
Amazon Glacier ログファイル
Amazon Glacier ログファイルは、インポートが完了するとマニフェストで指定された logBucket にアップ
ロードされます。
Amazon Glacier ログファイルは次の形式の 2 行のテキストファイルです。
DATE,VAULT,ARCHIVE ID,SIZE,TREE HASH,ARCHIVE COMMENT
<Date>,<Vault Name>,/<AWS Account ID>/vaults/<Vault Name>/archives/<Archive ID>,<Archive
Comment>
ステータスコード
Amazon ログファイルのステータスコードについては、「エラーとステータスコード (p. 122)」を参照し
てください。
エクスポートジョブの使用
トピック
• Amazon S3 エクスポートジョブの作成 (p. 50)
• エクスポートマニフェストの作成 (p. 52)
• Import/Export ログの表示 (p. 57)
このセクションでは、Amazon S3 バケットからストレージデバイスへデータをエクスポートするプロセス
を要約します。
Note
AWS Import/Export では、Amazon Elastic Block Store または Amazon Glacier からのエクスポー
トジョブはサポートしていません。
Amazon S3 エクスポートジョブの作成
Amazon S3 エクスポートは、個々のオブジェクトを Amazon S3 バケットからデバイスに転送します。
この際、各オブジェクトつき 1 つのファイルを作成します。複数のバケットを指定できます。また、マニ
フェストファイルオプションを使用してエクスポートするファイルを指定できます。
50
AWS Import/Export 開発者ガイド
Amazon S3 エクスポートジョブの作成
Note
Amazon S3 オブジェクトのライフサイクル管理を使用して既に Amazon Glacier ストレージクラ
スに移行された Amazon S3 オブジェクトはエクスポートできません。Amazon S3 エクスポート
ジョブを送信する前に、ライフサイクル設定ルールをチェックして、エクスポートが完了するま
でオブジェクトが Amazon S3 スタンダードクラスで使用できることを確認してください。詳細
については、Amazon S3 開発者ガイドの「オブジェクトのライフサイクル管理」を参照してくだ
さい。
デバイスごとに個別のジョブリクエストを送信する必要があります。
詳細については、「ガイドラインおよび制限 (p. 125)」を参照してください。
Amazon S3 エクスポートプロセス
エクスポートジョブのプロセス
1
デバイスへのデータのロード方法を指定するエクスポートマニフェストファイルを作成しま
す。これには、暗号化 PIN コードまたはパスワードや、エクスポートするデータを含むバ
ケットの名前などの詳細が含まれます。詳細については、「エクスポートマニフェストファイ
ル (p. 52)」してください。複数のストレージデバイスを送付する場合は、各ストレージデ
バイスごとにマニフェストファイルを作成する必要があります。
2
マニフェストファイルを含む CreateJob リクエストを送信してエクスポートジョブを開始しま
す。デバイスごとに個別のジョブリクエストを送信する必要があります。ジョブは 30 日後に
失効します。デバイスを送付しないかぎり、料金はかかりません。
AWS Import/Export ツール、AWS コマンドラインインターフェース (CLI)、AWS SDK for
Java、または AWS REST API を使用して CreateJob リクエストを送信できます。最も簡単な
方法は、AWS Import/Export ツールです。詳細については、 を参照してください。
AWS Import/Export ウェブサービスツールを使用した CreateJob リクエストの送信 (p. 43)
AWS SDK for Java を使用した CreateJob リクエストの送信 (p. 44)
REST API を使用した CreateJob リクエストの送信 (p. 47)
3
AWS Import/Export から、ジョブ ID、署名値、前払い配送ラベルの印刷方法を含むレスポンス
が送信されます。レスポンスはコンピューターの SIGNATURE ファイルにも保存されます。
この情報は次のステップで必要になります。
4
SIGNATURE ファイルをストレージデバイスのルートディレクトリにコピーします。AWS が送
信したファイルを使用することも、レスポンスから SignatureFileContents 値を SIGNATURE
という名前の新規テキストファイルにコピーすることもできます。ファイル名は、SIGNATURE
とし、デバイスのルートディレクトリに置く必要があります。
送付する各デバイスには、そのデバイスとその JOBID ごとに一意の SIGNATURE ファイルが必
要です。AWS Import/Export は、データのロードを開始する前に、ストレージデバイスにある
SIGNATURE ファイルを検証します。SIGNATURE ファイルが見つからない場合や無効の場合 (た
とえば、別のジョブリクエストに関連付けられている場合など)、AWS Import/Export でデータ
ロードは行わずにストレージデバイスはお客様に返却されます。
Example
****************************************
* SignatureFileContents
*
****************************************
51
AWS Import/Export 開発者ガイド
エクスポートマニフェストの作成
version:2.0
signingMethod:HmacSHA1
jobId:QTEST
signature:cbfdUuhhmauYS+ABCl5R9heDK/V=
5
前払い配送ラベルを生成、印刷して、パッケージの外側に貼ります。前払い配送ラベルの取得
方法については、「ストレージデバイスの配送 (p. 57)」を参照してください。
6
デバイスとケーブルを UPS を通じて AWS に送付します。配送ラベルと発送するデバイスに
は、必ずジョブ ID を記載してください。そうしないと、ジョブが遅れる場合があります。
ジョブは 30 日後に失効します。ジョブの有効期限が切れた後にパッケージを受領した場合
は、デバイスを返却します。配送料金 (ある場合) に対してのみ課金されます。
デバイスごとに個別のジョブリクエストを送信する必要があります。
Note
複数のデバイスを同じ発送で配送できます。ただし、配送できるデバイスやデバイス
の梱包方法に関して、特定のガイドラインおよび制限があります。配送品が正しく
準備され梱包されていない場合は、AWS Import/Export でジョブを処理できません。
一度に配送するデバイスの数に関係なく、デバイスごとに個別のジョブリクエストを
送信する必要があります。複数のデバイスを発送する際の梱包要件に関する詳細は、
「複数デバイスの配送 (p. 64)」を参照してください。
7
Disk はストレージデバイスのルートドライブにある署名を検証します。署名が CreateJob レ
スポンスの署名と一致しない場合、Disk はデータをロードできません。
お客様のストレージデバイスが AWS に到着後、データの転送は、通常、翌営業日から開始さ
れます。データのエクスポートに要する時間は、復号化、エクスポートステーションの空き具
合、エクスポートするデータ量、お客様のデバイスの転送速度など多数の要素によって決まり
ます。
8
AWS はデバイスを再フォーマットし、マニフェストで提供された PIN コードまたはパスワー
ドを使用してデータを暗号化します。
9
当社がストレージデバイスを再梱包し、マニフェストファイルにリストされている返送先住所
へ発送します。私書箱宛の発送は取り扱っていません。
10
PIN コードまたは TrueCrypt パスワードを使用してデバイスを復号化します。詳細について
は、「データの暗号化 (p. 60)」を参照してください。
エクスポートマニフェストの作成
マニフェストファイルを作成することで、ジョブ情報を提供し、ストレージデバイスと AWS 間のデータ
の転送方法を指定します。マニフェストファイルは、YAML 形式のテキストファイルです。デバイス ID、
ログバケット、返送先住所などの必要情報を指定する一連の名前と値のペアで構成されます。YAML の詳
細については、以下のサイトをご覧ください http://yaml.org.
インポートやエクスポートのマニフェストファイルは、共通オプション各種や各タイプ独自のオプション
を使用します。
一連の関税マニフェストファイルオプションは、国をまたいで配送されるすべてのストレージデバイスに
必要です。
マニフェストオプションの完全なリストについては、「マニフェストファイルオプションのリファレン
ス (p. 69)」を参照してください。
52
AWS Import/Export 開発者ガイド
エクスポートマニフェストの作成
エクスポートマニフェストの例
S3 エクスポートジョブには、一連の必須オプションがあります。
この Amazon S3 エクスポートマニフェストファイルの例には、必須オプションのみが含まれます。
manifestVersion:2.0
generator:text editor
deviceId:ABCDE
pinCode:4321
trueCryptPassword:SimpleButEasi1yCrackedEXAMPLE
fileSystem:NTFS
serviceLevel:expeditedShipping
targetDirectory:/
recoveryDirectory:EXPORT-RECOVERY
logBucket:ImportExportBucket
notificationEmail: [email protected]
operations:
- exportBucket: ImportExportBucket
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
マニフェストオプションの完全なリストについては、「マニフェストファイルオプションのリファレン
ス (p. 69)」を参照してください。よく使われるマニフェストオプションの例については、「Amazon
S3 エクスポートマニフェストの使用 (p. 53)」を参照してください。
Amazon S3 エクスポートマニフェストの使用
トピック
• 国際配送 (p. 53)
• ストレージデバイスの至急返送 (p. 53)
• ログファイル名の競合回避 (p. 54)
このセクションは、エクスポートマニフェストオプション使用例です。
国際配送
欧州連合内を除くデバイスの国際配送では、マニフェストに関税オプションを含める必要がありま
す。関税関連のマニフェストオプションの詳細については、「マニフェストファイルの関税オプショ
ン (p. 73)」を参照してください。
ストレージデバイスの至急返送
デバイスを米国リージョンのバケットから米国の住所に返送する場合は、serviceLevel マニフェストオ
プションを使用して発送をアップグレードできます。デフォルトの serviceLevel オプションは、国内の
陸路による無料配送を含む標準配送です。expeditedShipping を指定すると、追加料金を支払って 2 日配
送でデバイスを配達できます。返送料金およびサービスに関する情報については、「AWS Import/Export
Calculator」を参照してください。
53
AWS Import/Export 開発者ガイド
エクスポートマニフェストの作成
ログファイル名の競合回避
logPrefix オプションは、名前の競合を防ぐために AWS Import/Export Disk でバケット名とログレポー
ト名の間の挿入する文字列を定義します。ログファイル名の末尾は常に export-log-JobId という形式で
す。
logPrefix を指定しないパスとファイル名の例:
http://mybucket.s3.amazonaws.com/export-log-53TX4.
logPrefix を logs/ に設定したパスとファイル名の例:
http://mybucket.s3.amazonaws.com/logs/export-log-53TX4
Note
スラッシュ (/) は自動的には含まれません。logPrefix の値の末尾にスラッシュを含めない
場合、値はログファイル名に統合されます。たとえば、logPrefix がtaxonomy であり、ルー
トディレクトリにファイル phylum.jpg がある場合、キーは taxonomy/phylum.jpg ではなく
taxonomyphylum.jpg になります。
logPrefix + export-log-JOBID で 1024 バイト長を超えてはいけません。超過した場合、Disk は
CreateJob アクションで InvalidManifestField エラーを返します。
ファイルのエクスポートの管理
トピック
• オペレーションエクスポートマニフェストのオプション (p. 54)
• エクスポートデータの制限 (p. 55)
• 複数のバケットからのデータのエクスポート (p. 55)
• ターゲットディレクトリの指定 (p. 56)
バケットからエクスポートするファイルを制限する必要がある場合があります。たとえば、バケット内の
すべてのファイルは必要としない場合や、単一デバイスに対してファイル数が多すぎるため複数のデバイ
スにエクスポートする必要がある場合などです。
このセクションでは、operations マニフェストファイルオプションを設定してタスクを管理する方法を説
明します。
複数のバケットからファイルをエクスポートする必要がある場合、同一のマニフェストファイルに複数の
exportBucket オプションを指定できます。
オペレーションエクスポートマニフェストのオプション
operations マニフェストオプションは、1 つ以上のエクスポートオペレーションのリストを指定しま
す。AWS Import/Export Disk はアルファベット順にキーをエクスポートします。つまり、まずリストされ
た順、次に各エクスポートオペレーションによってキーのアルファベット順に処理します。エクスポート
するデータがストレージデバイスの容量を超過しても、ストレージデバイスのファイルは厳密なアルファ
ベット順を維持します。たとえば、ストレージデバイスに余裕があるからといって、Disk が順序を無視し
てファイルを詰め込むことはありません。このアルファベット順により、最後にエクスポートされたキー
を新しいエクスポートジョブの beginMarker として使用して新しいエクスポートジョブを作成すること
で、エクスポートの継続が簡単になります。
operations のサブフィールド prefix, beginMarker、および endMarker は、バケットからエクスポートさ
れるデータを制限します。
prefix
エクスポートされるキーを prefix で指定されたパスにあるキーに制限します。
54
AWS Import/Export 開発者ガイド
エクスポートマニフェストの作成
beginMarker
endMarker
エクスポートされるキーをこのオプション値の後にアルファベット順に並ぶキーに
制限します。
エクスポートされるキーを endMarker に一致するキーおよびその前にアルファ
ベット順に並ぶキーに制限する operations のサブフィールドです。endMarker に
よってプレフィックスが付けられたキーは含まれません。
AWS Import/Export Disk はストレージデバイスにエクスポートされるオブジェクトを命名するとき
にキー全体を使用します。たとえば、AWS Import/Export Disk はキー starwars.s3.amazonaws.com/
images/jedi.jpg をストレージデバイスの次のファイル /starwars/images/jedi.jpg にマッピングしま
す。Microsoft Windows の場合、AWS Import/Export Disk は同じキーを \starwars\images\jedi.jpgに
マッピングします。
以下のセクションで、operations で使用するエクスポートフィールドをいくつか詳しく説明します。
エクスポートデータの制限
beginMarker と endMarker を使用してエクスポートするキーの開始位置と終了位置を指定します。
エクスポートジョブは、beginMarker の次のキーから開始されます。つまり、beginMarker はエクス
ポートジョブに含まれません。ただし、endMarker は含まれます。たとえば、以下のオプションはhtml/
index.html とimages/kate.jpg の間にアルファベット順に並ぶすべてのキーをエクスポートします。
エクスポートには html/index.html は含まれませんが、images/kate.jpg は含まれます。また、
images/kate.png は含まれません。
operations:
- exportBucket: mybucket
beginMarker: html/index.html
endMarker: images/kate.jpg
Note
キーを含まないエクスポートオペレーションを構築できます。たとえば、prefix に image を指定
し、endMarker に foo を指定すると、foo がアルファベット順で image の前に来るため、一致す
るキーがありません。
複数のバケットからのデータのエクスポート
1 つ以上のバケットから複数のデータのサブセットをエクスポートするには、該当するエクスポート
オペレーションの後に続けて複数の exportBucket オプションを指定します。operations の後にそ
れぞれダッシュ (-) をつけて、エクスポートするデータの新しいセットを指定します。各エントリに
exportBucket マニフェストオプションが必要です。以下は、異なる 3 つのバケット mybucket、lost、お
よび threescompany から 4 つデータセットをエクスポートする例です。
すべてのバケットは、同じ Amazon S3 リージョンにある必要があります。また、各バケットとオブジェ
クトごとに読み取りアクセス権限が必要です。
データを複数のバケットからエクスポートするには
exportBucket を使用してデータをエクスポートする各バケットを指定します。
次の例では、AWS Import/Export は mybucket の /images 内にあるすべてのキーを、ストレージデバイス
の starwars/image-backup にエクスポートします。
operations:
- exportBucket: mybucket
prefix: images
beginMarker: images/starwars/jedi.jpg
55
AWS Import/Export 開発者ガイド
エクスポートマニフェストの作成
endMarker: images/starwars/masterwindoo.jpg
- exportBucket: lost
- exportBucket: threescompany
prefix: images
endMarker: images/characters/mrfurley.jpg
AWS Import/Export がキーをエクスポートする順序は、まず operations マニフェストオプションで指定し
たオペレーションの順序、次に各オペレーション内でエクスポートするキーのアルファベット順です。た
とえば前の手順では、AWS Import/Export は mybucket のすべてのキーをアルファベット順にエクスポート
してから、lost でアルファベット順にエクスポートします。
Note
AWS Import/Export はキーを平行してエクスポートしますが、ストレージデバイスのファイルの
終了順はまずオペレーション順、次にアルファベット順です。この機能は、エクスポートする必
要があるデータ全体に対してストレージデバイスの容量が不十分な場合に重要になります。この
順序により、最後にエクスポートされたキーを新しいエクスポートジョブの beginMarker として
使用することで、新しいエクスポートジョブを使用したエクスポートを簡単に続行できます。
ターゲットディレクトリの指定
AWS Import/Export では、エクスポートマニフェストオプション operations および targetDirectory を
使用して、ストレージデバイス内でエクスポートされたファイルのロケーションを指定できます。
データを特定のディレクトリにエクスポートするには
targetDirectory を使用してファイルをエクスポートするストレージデバイスのディレクトリを指定しま
す。
次の例では、AWS Import/Export は bucket-data-comes-from という名前のバケットのコンテンツをスト
レージデバイスの myexport/stuff というディレクトリにエクスポートします。
デフォルトの targetDirectory はバケット名です。
operations:
- exportBucket: bucket-data-comes-from
targetDirectory: myexport/stuff
命名エラーがあるファイルの収集
Amazon S3 オブジェクトキーに、マニフェストで指定したファイルシステムに対応していない文字が含ま
れる場合があります。AWS Import/Export では、ファイルをデバイスにエクスポートする際に不正な文字
を削除し、ファイルシステムで許可されるファイル名の可能な限り近くに Amazon S3 キーをマッピング
します。ファイル名をマッピングできない場合は、ファイルは EXPORT-RECOVERY という名前のディ
レクトリにコピーされます。エクスポートマニフェストの recoveryDirectory オプションを指定すること
で、別のディレクトリ名を指定することもできます。
ファイルはリカバリーディレクトリの 0000 という名前のサブディレクトリから順に書き込まれます。
ファイルは 0000 から 9999 まで連番で命名され、次にサブディレクトリ 0001 が作成されて同様に続きま
す。このプロセスは、次の条件のいずれか 1 つが発生するまで続行されます。
• すべてのファイルが保存された
• ファイルシステムがいっぱいになった
• 1 億個のファイルがディレクトリ recoveryDirectory に書き込まれた
• recoveryDirectory ディレクトリがファイルシステムの最大ファイルサイズ制限を超過した
たとえば、リカバリーディレクトリの名前が EXPORT-RECOVERY である場合、ファイルとディレクトリ
の階層は次のようになります。
56
AWS Import/Export 開発者ガイド
Import/Export ログの表示
EXPORT-RECOVERY/
0000/
0000
0001
…
9999
0001/
…
9999/
Import/Export ログの表示
ポータブルストレージデバイスと AWS の間でデータを転送すると、AWS Import/Export はログファイル
を生成します。ログファイルは、ストレージデバイスへ/からロードする各ファイルに関する情報などを含
む CSV ファイルです。エクスポートジョブでは、AWS Import/Export は、logBucket マニフェストオプ
ションで指定するバケットにログファイルを保存します。
Note
エクスポートの場合、Amazon S3 ログバケットと Amazon S3 エクスポートバケットは同じリー
ジョンにある必要があります。バケットが異なるリージョンにある場合、ジョブのリクエストは
失敗します。
エクスポートジョブのログファイル名の末尾は常に export-log-JOBID という形式です。たとえば、JOBID
が 53TX4 であれば、ログファイルの末尾は export-log-53TX4 になります。
Note
既存の Amazon S3 オブジェクトと同名のログファイル名がある場合、既存のオブジェクトは新
しいログファイルで上書きされます。logPrefix フィールドを使用することでオブジェクトの競
合を防止できます。logPrefix の詳細については、「ログファイル名の競合回避 (p. 54)」を参
照してください。
サンプルログファイル
AWS Import/Export では、インポートのログとエクスポートのログに同じフィールドのセットを使用しま
す。ログファイルおよびログファイルフィールドの説明については、「Amazon S3 および Amazon EBS
ログファイルのフィールド (p. 48)」を参照してください。
ストレージデバイスの配送
トピック
• ストレージデバイスの要件 (p. 58)
• Amazon S3 インポートジョブおよびエクスポートジョブ用のストレージデバイスの準備 (p. 58)
• Amazon EBS および Amazon Glacier インポートジョブ用のストレージデバイスの準備 (p. 59)
• データの暗号化 (p. 60)
• ストレージデバイスの梱包 (p. 62)
• 前払い配送ラベルの生成 (p. 63)
• 複数デバイスの配送 (p. 64)
• ストレージデバイスの送付 (p. 65)
以下のセクションでは、ストレージデバイスを準備して AWS に配送する方法を説明します。
57
AWS Import/Export 開発者ガイド
ストレージデバイスの要件
AWS にパッケージを送付する配送業者は UPS を使用する必要があります。また、AWS Import/Export
ウェブサービスツールで生成された前払い配送ラベルを使用する必要があります。AWS は UPS または
DHL を使用してパッケージを返送します。
デバイスは AWS の仕分け施設に配送され、それから Amazon によって AWS データセンターに送られま
す。UPS の追跡情報は、仕分け施設までです。AWS データセンターでパッケージが受領されると、AWS
がジョブステータスを更新します。GetStatus コマンドを送信する場合、発送品が AWS データセンター
で受領されてはじめてジョブのステータスに At AWS が表示されます。
Important
AWS の仕分け施設に到着したパッケージで前払い配送ラベルが貼付されていないものは、ジョブ
リクエストが実行されずに返送され、返送運賃とデバイス処理手数料が課金されます。前払い配
送ラベルを使用できない場合は、デバイスを発送する前に AWS サポートセンター にお問い合わ
せください。
ストレージデバイスの要件
AWS Import/Export ステーションの 1 つにストレージデバイスを接続するには、デバイスが次の条件を満
たす必要があります。
• Red Hat Linux と互換性があり、製造元によって Linux の eSATA、USB 3.0、または USB 2.0 インター
フェイスをサポートすることが保証されている。
• 最大デバイスサイズは、高さ 14 インチ/35 cm x 幅 19 インチ/48 cm x 奥行 36 インチ/91 cm (標準 19 イ
ンチ/48 cm ラックで 8U) です。
• 最大重量は 50 ポンド / 22.5 キログラムです。
• デバイスの最大容量は Amazon Simple Storage Service (Amazon S3) および Amazon EBS ジョブの場合
は 16 TB です。
• デバイスの最大容量は Amazon Glacier ジョブの場合は 4 TB です。
• 能力要件はリージョンによって異なります。詳細については、「AWS Import/Export 製品の詳細」ペー
ジの「ストレージデバイスの選択」セクションを参照してください。
Important
内蔵ドライブを使用しない場合は、ストレージデバイスに電源、電源ケーブル、インターフェイ
スケーブルを添えて発送する必要があります。これらのコンポーネントがない場合、データを転
送できず、デバイスを返送します。内蔵ドライブの場合は、エンクロージャー、電源、電源ケー
ブル、インターフェイスケーブルは必要ありません。
Amazon S3 インポートジョブおよびエクスポート
ジョブ用のストレージデバイスの準備
ストレージデバイスを準備する手順を以下に示します。個々のステップは次のトピックで詳しく説明しま
す。
1
ストレージデバイスが AWS の要件を満たしていることを確認します。詳細については、「ス
トレージデバイスの要件 (p. 58)」を参照してください。
2
Amazon S3 にインポートする場合は、デバイスを発送する前にデータを暗号化できま
す。Amazon S3 にエクスポートする場合は、当社がデータを暗号化するために使用する PIN
コードまたはパスワードを指定します。詳細については、「データの暗号化 (p. 60)」を参
照してください。
3
デバイスとパッケージの両方に、CreateJob レスポンスから取得した JobId 値を記載したラベ
ルを貼ります。
58
AWS Import/Export 開発者ガイド
Amazon EBS および Amazon Glacier イン
ポートジョブ用のストレージデバイスの準備
4
SIGNATURE 値をストレージデバイスのルートディレクトリにある SIGNATURE という名前のファ
5
前払い配送ラベルを生成、印刷して、パッケージの外側に貼ります。前払い配送ラベルの取得
方法については、「ストレージデバイスの配送 (p. 57)」を参照してください。
6
電源、電源ケーブル、インターフェイスケーブルをデバイスに同梱します。
イルにコピーします。
Important
デバイスが輸送中に梱包内で動かないように固定してください。たとえば、デバイス
を気泡緩衝材で包装すると、動きを抑え損傷も防ぐことができます。
署名値のコピー
Amazon S3 インポートジョブまたはエクスポートジョブの場合は、デバイスのルートディレクトリに
SIGNATUREという名前のファイルが必要です。CreateJob の応答に SignatureFileContents テキストおよ
び SIGNATURE という名前のファイルが含まれています。ファイル名は、すべて大文字の SIGNATURE であ
り、デバイスのルートディレクトリにある必要があります。
署名値をストレージデバイスにコピーするには
1. コンピューター内の SIGNATURE を見つけるか、SIGNATURE という名前のファイルを作成してそこに
SignatureFileContents テキストをコピーします。
GetStatus リクエストを送信して SignatureFileContents 値を取得することもできます。
ファイル名 SIGNATURE はすべて大文字です。
2. SIGNATURE ファイルをストレージデバイスのルートディレクトリにコピーします。
送付する各デバイスには、そのデバイスとその JOBID ごとに一意の SIGNATURE ファイルが必要で
す。AWS Import/Export は、データのロードを開始する前に、ストレージデバイスにある SIGNATURE
ファイルを検証します。SIGNATURE ファイルが見つからない場合や無効の場合 (たとえば、別のジョブ
リクエストに関連付けられている場合など)、AWS Import/Export でデータロードは行わずにストレージ
デバイスはお客様に返却されます。
Amazon EBS および Amazon Glacier インポートジョ
ブ用のストレージデバイスの準備
ストレージデバイスを準備する手順を以下に示します。個々のステップは次のトピックで詳しく説明しま
す。
1
ストレージデバイスが AWS の要件を満たしていることを確認します。詳細については、「ス
トレージデバイスの要件 (p. 58)」を参照してください。
2
CreateJob レスポンスから PDF ファイルを印刷して、バーコード部分をデバイスにテープで
貼ります。バーコードとデバイスの組み合わせを間違えないように特に注意してください。デ
バイスごとに個別のジョブリクエストを送信し、各ジョブリクエストは固有のバーコードを生
成します。
Important
署名バーコードを、デバイスの四面すべてにテープでしっかりと貼付します。署名
バーコードは削除や交換したり、もので覆ったりしないでください。AWS Import/
Export はデータロードを開始する前に、署名バーコードを使用してストレージデバイ
59
AWS Import/Export 開発者ガイド
データの暗号化
スを検証します。署名バーコードがデバイスから分離している場合、検証ができず、
データのロードを行わないでデバイスを返却します。
3
前払い配送ラベルを生成、印刷して、パッケージの外側に貼ります。前払い配送ラベルの取得
方法については、「ストレージデバイスの配送 (p. 57)」を参照してください。
4
電源、電源ケーブル、インターフェイスケーブルをデバイスに同梱します。
Important
デバイスが輸送中に梱包内で動かないように固定してください。たとえば、デバイス
を気泡緩衝材で包装すると、動きを抑え損傷も防ぐことができます。
データの暗号化
高度なセキュリティでは、AWS Import/Export では次のデータ暗号方式をサポートしています。
PIN コード暗号化
データへのアクセスに物理 PIN パッドを使用するハードウェアベースのデバイス暗号化です。
TrueCrypt ソフトウェア暗号化
オープンソース暗号化アプリケーションである TrueCrypt を使用したディスク暗号化です。
Amazon S3 からのエクスポートの場合は、AWS では常に、ハードウェアベースの暗号化機能を備えた
PIN コードデバイスを使用するか、TrueCrypt ソフトウェア暗号化を使用した、データの暗号化を必須と
しています。高度なセキュリティでは、両方の方式を使用できます。マニフェストファイルで PIN または
パスワード、またはその両方を提供する必要があります。
インポートジョブの場合は、データの暗号化を強くお勧めします。Amazon S3 へのインポートの場
合、AWS Import/Export に送付する前に、PIN コードデバイスを利用したハードウェアベースの暗号化ま
たは TrueCrypt ソフトウェアを使用してデータを暗号化できます。PIN コードや TrueCrypt パスワード
をインポートマニフェストに、TrueCrypt パスワードをエクスポートマニフェストに含める必要がありま
す。
Amazon EBS または Amazon Glacier へのインポートの場合、PIN コードデバイスを利用したハードウェ
アベースの暗号化または任意のソフトウェア暗号化方式、またはその両方を使用できます。AWS は、お客
様の PIN を使用して PIN コードデバイスにアクセスしますが、Amazon EBS または Amazon Glacier にイ
ンポートするためにソフトウェアで暗号化されたデータを復号しません。インポートマニフェストに PIN
を含める必要があります。
PIN コードデバイス暗号化の使用
すべてのインポートジョブまたはエクスポートジョブで、物理 PIN パッドを使用したハードウェアベース
のデバイス暗号化を使用するストレージデバイスを使用できます。この場合、マニフェストで PIN コード
を提供する必要があります。
Amazon S3 へのインポートでの TrueCrypt 暗号化の使用
TrueCrypt は、オープンソースのディスク暗号化アプリケーションです。TrueCrypt は、AWS Import/
Export でサポートされる唯一のデバイスの暗号化アプリケーションです。また、AWS ではハードウェア
ベースの暗号化もサポートしています。詳細については、「データの暗号化 (p. 60)」を参照してくださ
い。
TrueCrypt 7.1a をインストールしていない場合は、まずインストールする必要があります。
60
AWS Import/Export 開発者ガイド
データの暗号化
Note
開発者は既に TrueCrypt 7.1a をサポートしていません。ただし、TrueCrypt 7.1a をダウンロード
して、そのアプリケーションを無料でデバイス復号化に使用することはできます。
デバイスを確実に復号化するために、TrueCrypt ボリュームを作成する際に、以下のオプションを選択し
てください。
• 新しい TrueCrypt ボリュームを作成します。AWS Import/Export では、システムパーティションまたは
暗号化ファイルコンテナではないボリュームとして作成された TrueCrypt ボリュームのみをサポートし
ます。
Encrypt the system partition or the entire system drive オプションは使用しないでください。
• Create an encrypted file container オプションまたは [Encrypt a non-system partition/drive] オプションの
いずれかを選択します。
• [Volume Type] では、Standard TrueCrypt volume を選択します。隠しボリュームは作成しないでくださ
い。
• 暗号化されたファイルコンテナを作成する場合は、Volume Location でデバイスのホームディレクトリ
にファイルを作成し、そのファイルを <JOBID>.tc と命名します。ここでの <JOBID> はデバイスに関連
付けられるジョブ ID です。たとえば、1B23C.tc と指定します。
• システムパーティション以外を暗号化する場合は、Volume Location で暗号化するパーティションを
選択します。[Volume Creation Mode] では、ボリュームに既にファイルが存在する場合は、Encrypt
partition in place を選択します。TrueCrypt はパーティションをフォーマットしたり、ファイルを消去し
ません。Encrypt partition in place では空のボリュームの暗号化よりも時間がかかります。パーティショ
ンが空の場合は、Create encrypted volume and format it を選択します。
• [Encryption Options] では、[Encryption Algorithm] に AES を使用し、[Hash Algorithm] には
RIPEMD-160 を使用します。
• TrueCrypt ボリュームのパスワードを作成します。このパスワードは、AWS Import/Export ツールを使用
して作成したジョブマニフェストに含めます。このパスワードがないと、暗号化されたパーティション
のデータにアクセスできません。パスワードを作成するときは、以下の点を常に考慮する必要がありま
す。
• パスワードにカンマを含めないでください。
• パスワードはなくさないでください。デバイスを復号できなくなります。AWS Import/Export は、パ
スワードを暗号化されたデバイスとともに送付しません。
• ボリューム形式の選択を求められたら、NTFS を選択します。
TrueCrypt ボリュームの作成後、TrueCrypt を使用してボリュームをマウントし、ボリュームにファイルを
コピーします。デバイスには 1 つのパーティションまたはコンテナのみが存在し、他のファイルが存在し
てはいけません。ファイルコンテナを使用する場合は、コンテナ名はデバイスに関連付けられたジョブ ID
を使用して <JOBID>.tc とする必要があります。SIGNATURE ファイルを暗号化されたボリュームのルー
トディレクトリにコピーします。
ジョブリクエストの送信準備でマニフェストファイルが完成したら、trueCryptPassword オプションのパ
スワードを含めます。AWS では、受領したデバイスをマウントします。ボリュームが暗号化されている場
合は、お客様が用意したパスワードを使用して復号化します。ボリュームが暗号化されていない場合は、
デバイスに関連付けられたジョブ ID を使用して、<JOBID>.tc というコンテナを検索します。お客様が用
意したパスワードを使用してコンテナを復号化します。
インポートが正常に完了すると、デバイスを消去しマニフェストで指定された住所に配送します。
次の状況のいずれかが発生した場合、AWS ではインポートを実行せずにデバイスを消去し、マニフェスト
で指定された住所に配送します。
• マニフェストで TrueCrypt パスワードが指定されているが、パーティションが暗号化されていない、ま
たは <JOBID>.tc という名前の暗号化されたコンテナがデバイスに存在しない。
61
AWS Import/Export 開発者ガイド
ストレージデバイスの梱包
• デバイスにコンテナが複数存在する。
• デバイスにパーティションが複数存在する。
• AWS でパーティションまたはコンテナを復号化できない。
デバイス上のデータを消去できない場合、破棄がスケジュールされ、サポートチームがマニフェストファ
イルで指定された E メールアドレスに連絡します。
Amazon S3 からのエクスポートでの TrueCrypt 暗号化の使用
Amazon S3 へのエクスポートジョブを作成する場合、エクスポートマニフェストに PIN コードまたは
TrueCrypt パスワードを指定します。TrueCrypt パスワードが指定されている場合、AWS は指定され
たパスワードを使用してデバイスのファイルコンテナに TrueCrypt で暗号化されたボリュームを作成
し、そのコンテナにデータをコピーします。コンテナはデバイスに関連付けられたジョブ ID を使用し
て、JOBID.tc と命名されます。
Important
パスワードはなくさないでください。デバイスを復号化できなくなります。AWS Import/Export
は、パスワードを暗号化されたデバイスとともに送付しません。
TrueCrypt コンテナの復号化
デバイスがお手元に届いたら、エクスポートマニフェストで指定したパスワードを使用し TrueCrypt でコ
ンテナを復号化してボリュームをマウントします。
TrueCrypt コンテナを復号化するには
1.
TrueCrypt 7.1a をインストールしていない場合は、まずインストールする必要があります。
Note
開発者は既に TrueCrypt 7.1a をサポートしていません。ただし、TrueCrypt 7.1a をダウン
ロードして、そのアプリケーションを無料でデバイス復号化に使用することはできます。
2.
TrueCrypt を開きます。
3.
[Volume]、[Select File] をクリックします。
4.
デバイスにある TrueCrypt コンテナファイルの名前をクリックして、[Open] をクリックします。
5.
[Volume]、[Mount Volume] をクリックします。
6.
エクスポートマニフェストに記載されたパスワードを [Password] ボックスに入力して、[OK] をク
リックします。
暗号化されたコンテナがコンピューターのボリュームとしてマウントされます。
ストレージデバイスの梱包
このセクションでは、メディアの梱包方法を説明します。
ストレージデバイスを梱包するには
1. 機器は適切に梱包してください。UPS に梱包のガイドラインが用意されています。
Important
紛失、損傷、またはデータ開示を防止するため、AWS はいくつかの社内コントロール手段お
よび手順を備えていますが、AWS は、データの紛失または不注意な開示による損害、または
62
AWS Import/Export 開発者ガイド
前払い配送ラベルの生成
物理ハードウェアの紛失、損傷、または破損には責任を負いません。お客様は常に、データの
バックアップコピーを保持しておく必要があります。ジョブ失敗の詳細については、「失敗し
たジョブ (p. 69)」を参照してください。
2. デバイスと、デバイスの電源、電源ケーブル、インターフェイスケーブルを同梱します。
3. 前払い配送ラベルを生成、印刷して、パッケージの外側に貼ります。前払い配送ラベルの取得方法につ
いては、「ストレージデバイスの配送 (p. 57)」を参照してください。
前払い配送ラベルの生成
このセクションでは、AWS に送付するパッケージの前払い配送ラベルを生成する方法を説明します。
前払い配送ラベルを生成するには
1. デバイスの送付に必ず使用する必要がある前払い配送ラベルは AWS から提供されます。このラベルを
生成するには、ジョブの作成後、AWS Import/Export ウェブサービスツールを以下の例のように使用し
ます。
Example
CmdPrompt> java -jar lib\AWSImportExportWebServiceTool-1.0.jar GetShippingLabel
Note
例では、lib が AWS Import/Export ウェブサービスツールがあるディレクトリです。AWS
Import/Export ウェブサービスツールをインストールしたディレクトリから実行します。
システムから、ジョブ ID、名前、会社、住所、電話番号を入力するよう求められます。住所に郵便番号
がない場合は、プレースホルダー値 00000 を使用します。入力指示と架空の値の例を次に示します。
Version: 2012-01-14
Please enter the job ids each separated by comma: 796CK
---Please specify your address--Enter name (Required):
Joe Random
Enter company (Required):
ACME Anything
Enter street1 (Required):
1234 Main St
Enter street2 (Optional):
Suite 101
Enter street3 (Optional):
Enter city (Required):
Seattle
Enter state or province (Required in US and Canada):
WA
Enter country (Required):
USA
Enter postal code (Required):
98101
Enter phone number (Required):
206-100-0000
A prepaid shipping label has been uploaded to https://s3.amazonaws.com/
MyImportExportBucket/shipping-label-796CK.pdf
配送ラベルは次の例のようになります。
2. ストレージデバイスをパッケージに詰めます。
63
AWS Import/Export 開発者ガイド
複数デバイスの配送
Note
外付けハードドライブの場合は、電源および、USB または eSATA コネクターを同梱してくだ
さい。
3. JobId がはっきり読めるようにデバイスにラベルを貼ります。
4. 前払い配送ラベルを切り取り、パッケージにしっかりと貼付します。
Note
前払い配送ラベルの使用に問題がある場合、またはシンガポール国内の配送の場合は、AWS サ
ポートセンターにお問い合わせください。
複数デバイスの配送
一般的なルールとして、各デバイスは別パッケージで発送する必要があります。ただし AWS Import/
Export では、このトピックで説明されているガイドラインと制限に従っている場合、単一配送で複数デバ
イスを受け付けます。
Note
この要件は、パッケージ 1 個で複数のデバイスを配送する場合のみです。各デバイスを別々に配
送する場合は、「ストレージデバイスの梱包 (p. 62)」を参照してください。
単一配送で複数のデバイスを配送する場合は、以下の条件をすべて満たす必要があります。
• 各デバイスについて、一意のジョブ ID を持つ別々の Import/Export ジョブを作成します。
• コンテナごとの 8 つまでデバイスを配送できます。
• デバイスは、デバイスを安全に配送できるように設計され、各デバイス用に別々のスロットまたはコン
パートメントがあるハードケースで梱包されている必要があります。
• 各スロットおよび各ハードドライブに対応するジョブ ID のラベルを貼ります。
• デバイスに別々の電源、電源ケーブル、インターフェイスケーブルが必要な場合は、必要なコンポーネ
ントがすべて各デバイスに同梱されていることを確認してください。対応するジョブ ID のラベルを各コ
ンポーネントに貼付します。
• ラベルはすべてしっかりと貼り付けてください。
• 前払い配送ラベルを生成するときは、含まれる各デバイスについて、ジョブ ID をカンマで区切っ
て入力してください。前払い配送ラベルの生成に関する詳細については、「前払い配送ラベルの生
成 (p. 63)」を参照してください。
次のタイプのデバイスには、追加の特定要件があります。
• ベア SATA ドライブ — ベアドライブには特別な配慮が必要です。ベア SATA ドライブは、デバイスご
とに別々のスロットまたはコンポーネントがある専用のハードケースで配送してください。
• シングルスピンドル外付けハードディスク — デバイスがコンテナ内で動かないように、気泡緩衝材また
は同様の素材でデバイスを固定してください。すべてのケーブル、コード、電源を同梱することが特に
重要です。
• RAID デバイス — これらのデバイスはたいてい、すでにマウントされたドライブとともに配送するよう
には設計されていません。デバイスの配送準備については、製造元の推奨を参照してください。デバイ
スがコンテナ内で動かないように、気泡緩衝材または同様の素材でデバイスを固定してください。すべ
てのケーブル、コード、電源を同梱することが特に重要です。
• マルチ RAID デバイス — マルチ RAID デバイスは、梱包について特別な問題があります。これらのデバ
イスについては、特に予防措置をとってしっかりと梱包することをお勧めします。1 回の発送で複数の
デバイスを配送すると、返送コストが高くなる可能性があります。
64
AWS Import/Export 開発者ガイド
ストレージデバイスの送付
Note
1 回の発送で複数のデバイスを配送すると、返送コストが高くなる可能性があります。
ストレージデバイスの送付
このセクションは、ストレージデバイスを梱包して AWS に送付する際の全般的なガイダンスです。スト
レージデバイスをお客様に返送する際に料金がかかる場合があります。返送料金は、AWS Import/Export
Calculator を使用して見積ることができます。
ストレージデバイスを送付する際の一般的な考慮事項
前払い配送ラベルに、ストレージデバイスの送付先の正しい住所が記載されていること。デバイスは AWS
の仕分け施設に配送され、それから Amazon によって AWS データセンターに送られます。直接 UPS に
集荷を依頼するか、UPS の集荷施設にパッケージを持ち込んで AWS に発送してください。UPS に配送料
金を支払う必要はありませんが、AWS はデバイスの処理費用にこれらの料金を追加します。
UPS の追跡情報は、仕分け施設までです。AWS データセンターでパッケージが受領されると、AWS が
ジョブステータスを更新します。GetStatus コマンドを送信する場合、発送品が AWS データセンターで
受領されてはじめてジョブのステータスに At AWS が表示されます。
Important
前払い配送ラベルを使用しないでストレージデバイスを配送した場合、AWS Import/Export は
ジョブを実行せずにストレージデバイスを返送し、返送運賃とデバイス処理手数料が課金されま
す。
ストレージデバイスを国際配送する場合の考慮事項
国際配送の場合は、関税フォームに正しく入力し、配送にかかるすべての関税および税金を支払う必要が
あります。
• パッケージに適切な関税フォームを確認するには、UPS ウェブサイトの UPS カスタマーサービス に
お問い合わせください。正しいフォームを入手したら、UPS の指示に従って記入してから AWS にパッ
ケージを発送してください。
Important
米国またはシンガポールとの間でストレージデバイスを国際配送する場合は、関税マニフェス
トオプションを含める必要があります。関税マニフェストは EU 内の配送品には不要です。詳
細については、「マニフェストファイルの関税オプション (p. 73)」を参照してください。
• 国際配送では、関税および税を支払う必要がある場合があります。お客様には、配送品のすべての関税
および税金を支払う責任があります。これらの関税および税金は、前払い配送ラベルのコストには含ま
れません。関税または税、またはその両方が未払いのパッケージは到着時に拒否されます。
• 同様に、Amazon S3 バケットが 米国西部 (北カリフォルニア) リージョンまたは アジアパシフィック
(シンガポール) リージョンにある場合、米国外またはシンガポール国外の住所に国際返送する際に該当
するすべての関税および税金を支払う必要があります。これらの関税および税は、パッケージの配送時
に返送品配送業者により直接課金されます。
Important
欧州 (アイルランド) リージョン内の Amazon S3 バケット、Amazon EBS スナップショッ
ト、Amazon Glacier ボールトにアクセスするには、配送デバイスの発送元および返送先が欧州連
合内である必要があります。
65
AWS Import/Export 開発者ガイド
ジョブの管理
ジョブの管理
トピック
• ジョブのリスト (p. 66)
• ジョブの更新 (p. 66)
• 配送情報の取得 (p. 67)
• ジョブのステータスの取得 (p. 68)
• ジョブのキャンセル (p. 68)
• 失敗したジョブ (p. 69)
AWS Import/Export サービスでは、インポートジョブやエクスポートジョブの管理手段を提供していま
す。ジョブのステータスを取得したり、AWS アカウントのユーザーによって作成されたジョブをリストし
たりできます。また、ジョブの変更や削除もできます。ジョブが失敗した場合は、AWS からご連絡いたし
ます。
ジョブのリスト
ListJobs を使用してジョブをリストします。お客様の AWS アカウントのユーザーによって作成された
ジョブのみをリストできます。ジョブをリストすると、そのステータスを取得できます。
コマンドラインクライアントを使用してジョブをリストするには
ListJobs コマンドを実行します。
> java -jar lib\AWSImportExportWebServiceTool-1.0.jar ListJobs
REST を使用してジョブをリストするには
ListJobs リクエストを送信します。
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:155
Action=ListJobs&SignatureVersion=2
&SignatureMethod=HmacSHA256&Version=2010-06-01&Signature=%2FVfkltRBOoSUi1sWxRzN8rw%3D
MaxJobs パラメーターを使用して取得するレスポンスを制限できます。次の例は、25 個インポートジョブ
をリストする方法を示しています。ジョブは最も新しいものから新しい順に表示されます。
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:163
Action=ListJobs&MaxJobs=25&SignatureVersion=2
&SignatureMethod=HmacSHA256&Version=2010-06-01&Signature=%2FVfkltRBOoSUi1sWxRzN8rw%3D
ジョブの更新
UpdateJob を使用して、ジョブの完了方法の詳細を更新します。CreateJob のレスポンスとして返される
ジョブ ID を使用してジョブを指定します。元のマニフェストを、このリクエストに含めるマニフェストと
置き換えることで、ジョブリクエストを更新します。送信した元のマニフェストを変更するか、最初から
66
AWS Import/Export 開発者ガイド
配送情報の取得
やり直して新しいマニフェストファイルを作成できます。どちらの場合も、元のマニフェストは破棄され
ます。
UpdateJobこのアクションは CreateJob リクエストの送信後、データ転送が開始される前にのみ使用でき
ます。また、自分が所有するジョブのみに使用できます。
コマンドラインクライアントを使用してジョブを更新するには
新しいマニフェストまたは更新されたマニフェストとともに UpdateJob コマンドを使用します。
> java -jar lib\AWSImportExportWebServiceTool-1.0.jar UpdateJob JOBID Export C:
\DIRECTORY\updatedmanifest.txt
REST を使用してジョブを更新するには
1. 送信した元のマニフェストを変更するか、最初からやり直して新しいマニフェストファイルを作成しま
す。
2. マニフェストファイルを URL エンコードします。
3. Update リクエストを送信します。
次の例では、前述のマニフェストファイルを送信して、JOBID で識別されたジョブを更新します。
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:741
Action=UpdateJob&JobId=JOBID&Manifest=manifestVersion
%3A%201.0%0Abucket%3A%20XMSAGE
AreturnAddress%3A%0A%20%20%20%20name%3A%20Amazon.com%20ATTN%20
Joe%20Random%20%0A%20%20%20%20street1%3A%201200%111%20Nosuch%20Ave%20
S.%0A%20%20%20%20city%3A%20Seattle%0A%20%20%20%20
stateOrProvince%3A%20WA%0A%20%20%20%20postalCode%3A%2098114%0A%20%20%20%20
phoneNumber%3A%20206-266-0000%0A%20%20%20%20country%3A%20USA%0
AsetContentEncodingForGzFiles%3A%20yes%0Aexpires%3A%20tomorrow%0
AcontentLanguage%3A%20Spanish%0Aacl%3A%20public-read%0AcacheControl%3A%20
max-age%3D3600&JobType=Import
&SignatureVersion=2&SignatureMethod=HmacSHA256&Version=2010-06-01
&Signature=%2FVfkltRBOoSUi1sWxRzN8rw%3D
Amazon Import/Export は、ジョブを更新できたかどうかを通知するレスポンスを返します。
配送情報の取得
GetShipInfo を使用してジョブの配送情報を取得します。manifestVersion 3.0 ジョブでは、配送指示およ
びデバイスを識別して認証するための一意のバーコードが記載された PDF を取得します。
GetShipInfo アクションは、REST リクエストではサポートされていません。コマンドラインクライア
ントを使用した場合のみ出力できます。コマンドラインクライアントでは、manifestVersion 2.0 および
manifestVersion 3.0 のジョブの両方で GetShipInfo がサポートされています。
コマンドラインクライアントを使用して配送情報を取得するには
GetShipInfo コマンドを実行します。
次のコマンドは、ジョブ JOBID の配送情報を取得します。
>java -jar lib\AWSImportExportWebServiceTool-1.0.jar GetShipInfo JOBID
67
AWS Import/Export 開発者ガイド
ジョブのステータスの取得
元のオーダーのマニフェストファイルで manifestVersion:2.0 が指定されている場合、配送情報は現在
のウィンドウに返ります。マニフェストファイルで manifestVersion:3.0 が指定されている場合、現在の
ウィンドウに配送情報と PDF ファイルの取り扱い方が記載された PDF ファイルのパスが表示されます。
ジョブのステータスの取得
ジョブが起動待機中なのか、進行中なのか、完了したのか、確認が必要な場合があります。CancelJob や
UpdateJob などの一部のオペレーションでは、ステータスが completed の場合はジョブのキャンセルや更
新ができないため、最初に GetStatus を使用することがあります。
デバイスを発送すると、デバイスは選別を行う施設に配送され、それから AWS データセンターに送られ
ます。GetStatus コマンドを送信する場合、発送品が AWS データセンターで受領されてはじめてジョブ
のステータスに At AWS が表示されます。
Note
AWS Import/Export ジョブでサポートが必要な場合は、AWS サポートセンターにお問い合わせく
ださい。
GetStatus は指定ジョブのステータスを返します。CreateJob のレスポンスとして返されるジョブ ID を使
用してジョブを指定します。例のジョブのステータスは保留中、完了、進行中、エラー、期限切れです。
ステータスの詳細については、「GetStatus (p. 107)」を参照してください。自分が所有するジョブのス
テータスのみを取得できます。
コマンドラインツールを使用してジョブのステータスを取得するには
GetStatus コマンドを実行します。
次のコマンドは、JOBID で特定されたジョブのステータスを返します。
> java -jar lib\AWSImportExportWebServiceTool-1.0.jar GetStatus JOBID
REST を使用してジョブのステータスを取得するには
GetStatus リクエストを送信します。
次のリクエストは、JOBID で特定されたジョブのステータスを返します。
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:189
Action=GetStatus&JobId=JOBID&JobType=Import
&SignatureVersion=2&SignatureMethod=HmacSHA256&Version=2010-06-01
&Signature=%2FVfkltRBOoSUi1sWxRzN8rw%3D
Amazon Import/Export はジョブのステータスとマニフェストの一部のフィールドを返します。API オペ
レーションの詳細については、「GetStatus (p. 107)」を参照してください。
ジョブのキャンセル
ジョブのキャンセルには、CancelJob を使用します。CreateJob レスポンスで返されるジョブ ID を使用し
て、キャンセルするジョブを指定します。ジョブがすでに完了している場合は、このオペレーションは失
敗します。進行中のジョブはキャンセルできます。お客様の AWS アカウントのユーザーによって作成さ
れたジョブのみをキャンセルできます。
コマンドラインクライアントを使用してジョブをキャンセルするには
CancelJob コマンドを実行します。
68
AWS Import/Export 開発者ガイド
失敗したジョブ
次のコマンドでジョブ JOBID をキャンセルします。
> java -jar lib\AWSImportExportWebServiceTool-1.0.jar CancelJob JOBID
REST を使用してジョブをキャンセルするには
CancelJob リクエストを送信します。
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:189
Action=CancelJob&JobId=JOBID&JobType=Import
&SignatureVersion=2&SignatureMethod=HmacSHA256&Version=2010-06-01
&SignatureMethod=%2FVfkltRBOoSUi1sWxRzN8rw%3D
Amazon Import/Export は、ジョブをキャンセルできるかどうかを通知するレスポンスを返します。API オ
ペレーションの詳細については、「CancelJob (p. 101)」を参照してください。
失敗したジョブ
Import/Export ジョブは、不良セクター、サポート外のファイルシステム、エンクロージャーの損傷、配送
時の損傷、ハードウェアの経年劣化など、さまざまな理由で失敗することがあります。ジョブが失敗した
場合、AWS はマニフェストファイルに指定された E メールアドレスに通知します。
AWS の方針により、AWS の施設から送付されるすべてのデバイスは必ず、完全に消去されるか、AWS
によって暗号化されたデータのみが含まれます。失敗した Import/Export ジョブはこの方針に従って扱われ
ます。
インポートジョブが失敗した場合は、デバイスの内容を消去してお客様に返送します。デバイスの消去を
実行できない場合は、当社サポートチームから詳細な情報をご案内します。ジョブのキャンセル前に、一
部のファイルが既に AWS にインポートされている場合があります。
エクスポートジョブが失敗した場合は、エクスポートジョブを停止してデバイスをお客様に返送します。
このジョブがキャンセルされる前に、一部のファイルがデバイスに既にエクスポートされている場合があ
ります。これらのファイルは指定された暗号化 PIN コードまたはパスワードで暗号化されます。エクス
ポートジョブを開始できない場合は、サポートチームから詳細な情報をご案内します。
マニフェストファイルオプションのリファレンス
以下のセクションでは、マニフェストファイルのオプションについて説明します。
共通マニフェストファイルオプションは、Amazon S3 のインポートジョブおよびエクスポートジョブ
と、Amazon EBS および Amazon Glacier のインポートジョブを含むすべてのマニフェストファイルに該
当します。
デバイスを国際配送する場合は、カスタムのマニフェストファイルオプションを含めます。
トピック
• マニフェストファイルの共通オプション (p. 70)
• マニフェストファイルの関税オプション (p. 73)
• Amazon S3 へのインポートのマニフェストファイルオプション (p. 77)
• Amazon EBS へのインポートのマニフェストファイルオプション (p. 85)
• Amazon Glacier へのインポートのマニフェストファイルオプション (p. 88)
69
AWS Import/Export 開発者ガイド
マニフェストファイルの共通オプション
• Amazon S3 からのエクスポートにおけるマニフェストファイルオプション (p. 90)
マニフェストファイルの共通オプション
マニフェストファイルには、データの処理とストレージデバイスの返却に関する情報が含まれています。
次の表で、すべてのマニフェストファイルに共通するオプションを説明します。
オプション
説明
必須
accessKeyId
accessKeyId オプションは廃止されました。下位互換性のため
にのみ保持されています。accessKeyId を新しい AWS Import/
いいえ
ストレージデバイスのシリアル番号など一意な識別子です。デ
バイスに一意の番号がない場合は、独自の識別子を記載した
シールをデバイスに貼り、その識別子を deviceId として入力
します。デバイス ID の例を次に示します。
はい
Export ジョブで使用しないでください。
deviceId
deviceId: MyCompany489732
型: 文字列
デフォルト: なし
generator
マニフェストファイルと送信された CreateJob または
UpdateJob リクエストをまとめたアプリケーションを説明する
フィールドです。generator の例を次に示します。
いいえ
generator: AWS Import/Export Sample App 1.0
型: 文字列
デフォルト: なし
logBucket
AWS Import/Export がログを保存する Amazon S3 バケット。
ログデータを保存する前にバケットを作成する必要がありま
す。当社ではお客様のバケットを作成しません。ジョブを作成
する IAM ユーザーには、このバケットへの書き込み権限が必要
です。logBucket 値の例を次に示します。
logBucket: logging-bucket
型: 文字列
デフォルト: Amazon S3 へのインポートの場合は bucket、その
他の場合はなし。
制限: 既存の Amazon S3 バケット名であること。
Note
エクスポートの場合、Amazon S3 ログバケットと
Amazon S3 エクスポートバケットは同じリージョンに
ある必要があります。バケットが異なるリージョンに
ある場合、ジョブのリクエストは失敗します。
70
はい
(Amazon
S3 へのイ
ンポートを
除く)。
AWS Import/Export 開発者ガイド
マニフェストファイルの共通オプション
オプション
説明
必須
logPrefix
名前の競合を防ぐためにバケット名とログレポート名の間に挿
入する文字列です。詳細については、「ログファイル名の競合
回避 (p. 54)」を参照してください。logPrefix の例を次に
示します。
いいえ
logPrefix: logs/
型: 文字列
デフォルト: なし
manifestVersion
マニフェストファイルの作成に使用されるマニフェスト仕様の
バージョン。マニフェストのバージョンは、Amazon S3 への
インポートやエクスポートの場合は 2.0、Amazon EBS および
Amazon Glacier へのインポートの場合は 3.0 である必要があり
ます。
はい
型: 文字列
デフォルト: なし
有効な値: 2.0 | 3.0
notificationEmail
ジョブ完了通知の E メールの宛先となる E メールアドレスのセ はい
ミコロン区切りのリストです。
notificationEmail: [email protected]
型: 文字列
デフォルト: なし
71
AWS Import/Export 開発者ガイド
マニフェストファイルの共通オプション
オプション
説明
必須
returnAddress
ジョブ完了後にストレージデバイスを返送する住所です。
はい
returnAddress オプションは、次の例に示すサブフィールドが
含まれます。
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
stateOrProvince サブフィールドは、米国およびカナダで必須
です。サブフィールド street2 および street3 はオプションで
す。
型: 文字列
デフォルト: なし
制限: 返送先は私書箱ではなく実在の場所である必要がありま
す。
serviceLevel
ジョブのサービスレベル。ジョブのサービスレベルの指定につ
いて詳しくは、「ストレージデバイスの至急返送 (p. 36)」
を参照してください。
いいえ
serviceLevel: expeditedShipping
型: 文字列
デフォルト: standard
有効な値: standard | expeditedShipping
Example 共通オプションを使用した Amazon S3 へのインポートマニフェスト
次の例は、緊急配送を含むマニフェストファイルの共通オプションのほとんどが示されたインポートの
ジョブ用のマニフェストファイルコンテンツです。また、Amazon S3 マニフェストファイルに必要な
bucketオプション、eraseDevice オプション、および notificationEmail オプションも含まれます。
manifestVersion: 2.0
bucket: data-load-bucket
deviceId: ABCDE
generator: AWS ImportExport Web Service Tool 1.0
logPrefix: logs
logBucket: iemanifest-log-bucket
prefix: imported/
eraseDevice: yes
notificationEmail: [email protected];[email protected]
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
72
AWS Import/Export 開発者ガイド
マニフェストファイルの関税オプション
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
serviceLevel: expeditedShipping
マニフェストファイルの関税オプション
デバイスを国をまたいで配送する場合、customs マニフェストファイルオプションと必要なサブフィール
ドをマニフェストファイルに含める必要があります。AWS Import/Export は、届いた送付品を検証し、送
付に関する関税書類を準備するためにこれらの値を使用します。これらのフィールドをマニフェストから
除外し、デバイスの送付先国がデータをロードする施設がある国の外だった場合、ジョブのリクエストは
失敗します。
Note
この要件は、欧州連合内の配送には適用されません。欧州 (アイルランド) リージョンのデータ
ロード施設と欧州連合加盟国の間でデバイスを配送する場合は、customs オプションを含める必
要はありません。
欧州 (アイルランド) リージョン内の Amazon S3 バケットにアクセスするには、配送するデバイ
スの発送元と返送先は欧州連合国内である必要があります。
次の表のオプションはすべて、customs オプションのサブフィールドです。例:
customs:
dataDescription: This device contains medical test results.
encryptedData: yes
encryptionClassification: 5D992
exportCertifierName: John Doe
requiresExportLicense: yes
deviceValue: 250.00
deviceCountryOfOrigin: Ghana
deviceType: externalStorageDevice
オプション
説明
必須
customs
ストレージデバイスを米国またはシンガポールからその国外に返送す
る場合に必要な関税関連書類を AWS Import/Export で作成するための
情報を提供するには、このオプションを指定します。
はい
Note
関税オプションは、欧州連合内でデバイスを配送する場合は
不要です。
このテーブルで説明する他のオプションは、このオプションのサブ
フィールドです。以下に、必要なサブフィールドを含めた customs オ
プションを示します。
customs:
dataDescription: Medical test results.
encryptedData: yes
encryptionClassification: 5D992
exportCertifierName: John Doe
requiresExportLicense: yes
deviceValue: 250.00
deviceCountryOfOrigin: Ghana
deviceType: externalStorageDevice
73
AWS Import/Export 開発者ガイド
マニフェストファイルの関税オプション
オプション
説明
必須
typeOfExport: return
型: 文字列
デフォルト: なし
dataDescription
AWS Import/Export からインポートまたはエクスポートするデータの
簡単な説明を記載します。
はい
dataDescription: This device contains medical test results.
型: 文字列
デフォルト: なし
deviceCountry
OfOrigin
デバイスの製造国。これは通常、デバイスのどこかに「made in」ま
たは「assembled in」というラベルで表示されています。任意で ISO
国コードを使用できます。詳細については、「http://www.iso.org/iso/
home/standards/country_codes/iso-3166-1_decoding_table.htm」を参
照してください。
はい
deviceCountryOfOrigin: Japan
型: 文字列
デフォルト: なし
deviceHTS
deviceType オプションを使用して提供された指定のデバイスタイプに
関連付けられたデフォルトの Harmonized Tariff Schedule (HTS) を上
書きできます。このオプションの値は有効な 10 桁の HTS コードであ
る必要があります。
はい
deviceHTS: 8471.70.4000
型: 文字列
制限: 10 桁 HTS コード。
deviceValue
ストレージデバイスの金銭価値 (米国ドル)。国際配送の場合、デバイ
スの価格は 2,500.00 USD 未満である必要があります。次の例は、ス
トレージデバイスの価格を $250.00 と指定しています。
storageDeviceValue: 250.00
タイプ: 浮動小数点
デフォルト: なし
74
はい
AWS Import/Export 開発者ガイド
マニフェストファイルの関税オプション
オプション
説明
必須
deviceType
お客様が発送するデバイスのタイプを指定します。各デバイスのタイ
プはコマーシャルインボイスで使用する HTS コードになります。デバ
イスタイプと HTS コード間では、以下のデフォルトマッピングを使用
します。
はい
• externalStorageDevice : 8471.70.4065
• usbFlashDrive : 8471.70.9000
• sataDrive : 8471.70.2000
deviceHTS オプションを指定して、これらのデフォルトマッピングを
上書きできます。
deviceType: usbFlashDrive
タイプ: Enum
デフォルト: なし
有効な値: externalStorageDevice | usbFlashDrive | sataDrive
encryptedData
デバイス内のデータが暗号化されているかどうかを指定します。yes
の場合は、encryptionClassification オプションを含める必要があ
ります。次の例では、データが暗号化されていると指定しています。
はい
encryptedData: yes
型: 文字列
デフォルト: なし
有効な値: yes | no
encryptionClassification
デバイスに暗号化されたデータが含まれる場合、このフィールドでソ
フトウェアの分類を指定できます。暗号化されたデータの送付先また
は送付元が米国である場合、暗号化アプリケーションは米国輸出規制
の 5D992 に分類されることが必要です。
はい
encryptionClassification: 5D992
型: 文字列
デフォルト: なし
条件: encryptedData 値が yes の場合に必須です。
exportCertifierNameストレージデバイスの配送責任者である人物名または会社名を指定し
ます。次の例では、承認者の名前を指定しています。
exportCertifierName: John Doe
型: 文字列
デフォルト: なし
75
はい
AWS Import/Export 開発者ガイド
マニフェストファイルの関税オプション
オプション
説明
必須
requiresExportLicense
デバイスまたはデータのインポートとエクスポートが、米国輸出管理
はい
規制または国際武器取引規制などの、該当国の規制に基づくライセン
スを必要とするものであるかどうかを指定します。ライセンスが必要
なく、米国輸出規制の EAR99 に分類され、武器規制国際交渉規則に該
当しないデータやデバイスのみが、AWS Import/Export での取扱対象
になることに注意してください。
requiresExportLicense: no
型: 文字列
デフォルト: なし
有効な値: yes | no
typeOfExport
輸出のタイプを指定します。
オプション
値 return は、発送品が発送国に返送中であることを示します。
値 temporary は、発送品が宛先国から AWS のデータロード施設があ
る国に返送中であることを示します。
値 permanent は、発送品発送先国に留め置かれ、またその国から発送
されたものではないことを意味します。
typeOfExport: permanent
型: 文字列
デフォルト: return
有効な値: return | permanent | temporary
Example 関税オプションをともなう Amazon S3 へのインポートマニフェスト
以下は、関税オプションを含む Amazon S3 へのインポートジョブ用のマニフェストファイルの例です。
manifestVersion: 2.0
deviceId: ABCDE
eraseDevice: yes
bucket: my-amz-bucket
acl: authenticated-read
cacheControl: max-age=3600
contentDisposition: attachment
contentLanguage: en
contentTypes:
csv: application/vnd.ms-excel
customs:
dataDescription: This device contains medical test results.
encryptedData: yes
encryptionClassification: 5D992
exportCertifierName: John Doe
requiresExportLicense: yes
deviceValue: 250.00
deviceCountryOfOrigin: Brazil
deviceType: externalStorageDevice
diskTimestampMetadataKey: disk-timestamp
76
AWS Import/Export 開発者ガイド
Amazon S3 へのインポートのマ
ニフェストファイルオプション
generator: AWS Import Export Docs
ignore:
- \.psd$
- \.PSD$
logPrefix: logs
logBucket: iemanifest-bucket
notificationEmail: [email protected];[email protected]
prefix: imported/
setContentEncodingForGzFiles: yes
staticMetadata:
import-timestamp: Wed, 23 Feb 2011 01:55:59 GMT
application: AppImportedData
returnAddress:
name: John Doe
company: Example Corp
street1: UG 8 Golf Course Road
city: Anycity
stateOrProvince: Haryana
postalCode: 122002
phoneNumber: +91 431 555 1000
country: India
serviceLevel: standard
Amazon S3 へのインポートのマニフェストファイル
オプション
Amazon S3 インポートマニフェストファイルには、Amazon S3 へのデータのインポートとストレージデ
バイスの返却に関する情報が含まれています。このセクションでは、Amazon S3 インポートマニフェス
トファイル独自のオプションを説明します。すべてのマニフェストファイルに共通のオプションについて
は、「マニフェストファイルの共通オプション (p. 70)」を参照してください。
Amazon S3 のインポートおよびエクスポートでは、マニフェストファイルのバージョン 2.0 を使
用します。すべての Amazon Amazon S3 インポートおよびエクスポートのマニフェストファイル
で、manifestVersion を 2.0 に設定してください。
オプション
説明
必須
acl
Amazon S3 にロードされる各オブジェクトに適用する
アクセスコントロールリスト (ACL) (例: acl: publicread) を指定します。デフォルト値では、バケットにオ
ブジェクトをアップロードした人物にのみ完全なアクセ
ス権限を付与します。有効な ACL 値の説明については、
「既定 ACL」を参照してください。次の例では、アップ
ロードされたオブジェクトの ACL を設定します。
いいえ
acl: public-read
Note
ACL を指定する場合、インポートジョブを作成
する IAM ユーザーには、s3:PutObjectAcl 権限
が必要です。
型: 文字列
デフォルト: プライベート
77
AWS Import/Export 開発者ガイド
Amazon S3 へのインポートのマ
ニフェストファイルオプション
オプション
説明
必須
有効な値: private | public-read | public-read-write |
authenticated-read
bucket
Disk がデータをロードする Amazon S3 バケットを指定
します。データをロードする前に、バケットを作成する
必要があります。当社ではお客様のバケットを作成しま
せん。ロードを実行するアカウントには、このバケット
での書き込み権限が必要です。バケット名の例は次のよ
うになります。
はい
bucket: data-load-bucket
型: 文字列
デフォルト: なし
制限: 既存の Amazon S3 バケット名であること。
cacheControl
すべてのインポートされたファイルの Cache-Control
HTTP ヘッダーフィールドの値を指定します。当社で
はこの値を検証しません。cacheControl の詳細につ
いては、http://www.w3.org/Protocols/rfc2616/rfc2616sec14.html#sec14.9 を参照してください。
いいえ
cacheControl: max-age=3600
型: 文字列
デフォルト: なし
contentDisposition
Content-Disposition HTTP ヘッダーを指定してすべ
てのロードされたファイルに適用します。詳細につ
いては、「RFC 2616 section 19」を参照してくださ
い。contentDisposition 値の例を次に示します。
contentDisposition: attachment
Note
この例では、ブラウザが Amazon S3 オブジェ
クトを直接表示するよりも、オブジェクトの保
存を求めるメッセージを表示します。
型: 文字列
デフォルト: なし
78
いいえ
AWS Import/Export 開発者ガイド
Amazon S3 へのインポートのマ
ニフェストファイルオプション
オプション
説明
必須
contentLanguage
すべてのインポートされたファイルの HTTP ContentLanguage ヘッダーフィールドの値を指定します。当
社ではこの値を検証しません。Content-Language ヘッ
ダーの詳細については、「http://www.w3.org/Protocols/
rfc2616/rfc2616-sec14.html#sec14.12 」を参照してくだ
さい。
いいえ
contentLanguage: es
型: 文字列
デフォルト: なし
contentTypes
Content-Type ヘッダーを設定するキーと値のペアで、大
文字小文字を区別しない文字列のマッピングが含まれて
います。各キーと値のペアは、ファイル拡張子 (例: jpg)
であるキーと、Content-Type の対応する値 (例: image/
jpeg) が含まれています。これらの値は、Content-Type
マッピングのデフォルトのファイル拡張子に優先しま
す。デフォルトのマッピングの詳細については、以下を
参照してください。 付録 C: MIME タイプのファイル拡
張子 (p. 135)。
キーと値のペアの例を次に示します。
contentTypes:
jpg: image/jpeg
JPG: image/jpeg
gif: image/gif
GIF: image/gif
mp3: audio/mpeg
txt: text/plain
zip: application/zip
タイプ: 文字列から文字列へのマッピング
デフォルト: なし
79
いいえ
AWS Import/Export 開発者ガイド
Amazon S3 へのインポートのマ
ニフェストファイルオプション
オプション
説明
必須
diskTimestampMetadataKey
Amazon S3 にインポートされたコンテンツのメタデー
タに、ストレージデバイスの最終更新日のタイムスタン
プを追加するユーザー定義のキーです。このキーの値は
Amazon S3 の Date ヘッダー [ DAY "," ] DD-MON-YYY
HH:MM:SS zone time (例: Wed, 23 Feb 2011 01:55:59
GMT) と同じ RFC 1123 形式です。キー名には x-amzmeta- が前に付けられます。
たとえば、
いいえ
diskTimestampMetadataKey: disk-timestamp
と指定したとします。
以下は、Amazon S3 コンテンツの GET オペレーションの
結果です。
x-amz-meta-disk-timestamp: Wed, 23 Feb 2011
01:55:59 GMT
型: 文字列
デフォルト: なし
制限: ユーザー定義キーが、有効な HTTP ヘッダーキー
であること (ASCII のみ、コロンなし、スペースなし)。
ここで選択されるキー名は、staticMetadata 関数で使用
されるキー名と同じである必要はありません。
eraseDevice
AWS がデータをインポート後、ストレージデバイスのコ はい
ンテンツ消去することを了承します。ストレージデバイ
スのすべての書き込み可能なブロックはゼロで上書きさ
れます。初期化後に、デバイスの再パーティション化と
フォーマットを行う必要があります。
エントリの例を次に示します。
eraseDevice: yes
型: 文字列
デフォルト: なし
有効な値: yes | true
80
AWS Import/Export 開発者ガイド
Amazon S3 へのインポートのマ
ニフェストファイルオプション
オプション
説明
必須
expires
すべてのインポートされたファイルの HTTP Expires
ヘッダーフィールドの値を指定します。Expire の
値は RFC 1123 日付形式を使用した日付にする必
要があります。Expires ヘッダーの詳細について
は、http://www.w3.org/Protocols/rfc2616/rfc2616sec14.html#sec14.21 を参照してください。
いいえ
expires: Thu, 07 Jan 2010 16:00:00 GMT
タイプ: 文字列 (24 バイト)
デフォルト: なし
制限: RFC 1123 日時形式、[ DAY "," ] DD-MON-YYY
HH:MM:SS zone time に従っていること。たとえば
"Mon , 12 Apr 2010 23:20:00 UT" です。詳細について
は、「RFC 1123」および「RFC 822」を参照してくださ
い。
ignore
ストレージデバイスからロードしないディレクトリ、
ファイル、またはファイルタイプを指定します。ignore
の詳細については、「」を参照してください ファイルと
ディレクトリの除外 (p. 38).
いいえ
タイプ: 文字列の配列
デフォルト: SIGNATURE ファイル以外のすべてのファイル
がロードされます。
制限: 後ろにスペースが続くダッシュ、“- “ は YAML 構文
であり、各フィルタに優先します。
pinCode
ハードウェアベースで暗号化されているストレージデバ
イスが提供される場合、そのデバイスの PIN コードで
す。詳細については、「データの暗号化 (p. 60)」を参
照してください。
pinCode: 1234
Important
PIN コードはなくさないでください。データを
復号化できなくなります。AWS Import/Export
では、暗号化されたデバイスと一緒に PIN コー
ドを送信しません。
タイプ: 整数
デフォルト: なし
81
いいえ
AWS Import/Export 開発者ガイド
Amazon S3 へのインポートのマ
ニフェストファイルオプション
オプション
説明
必須
プレフィックス
バケット名とストレージデバイスにある各ファイルの完
全パスの間に挿入する文字列を指定します。詳細につい
ては、「キープレフィックスの指定 (p. 40)」を参照し
てください。
いいえ
型: 文字列
デフォルト: なし
制限: キーは一続きの Unicode 文字で、UTF-8 に
エンコードすると最大で 1,024 バイト長になりま
す。logPrefix + import-log-JOBID が 1024 バイト
長を超える場合、Disk は CreateJob のレスポンスで
InvalidmanifestField エラーを返します。
setContentEncodingForGzFiles
gzip で圧縮されたファイルが gzip に設定された
Content-Encoding ヘッダーを取り、Content-Type ヘッ
ダーがファイルタイプを検証する際に ..gz および .gzip
で終わるファイルを無視するように指定します。詳細に
ついては、「Gzip ファイルの処理 (p. 37)」を参照し
てください。当社ではこの値を検証しません。
setContentEncodingForGzFiles: Yes
型: 文字列
デフォルト: なし
82
いいえ
AWS Import/Export 開発者ガイド
Amazon S3 へのインポートのマ
ニフェストファイルオプション
オプション
説明
必須
staticMetadata
このオプションは、Amazon S3 にインポートされるすべ
てのファイルに適用するユーザー定義のキーと値のペア
を定義します。キーと値のペアは、x-amz-meta- ととも
に前に付けられます。たとえば、
いいえ
staticMetadata:
import-timestamp: Wed, 23 Feb 2011 01:55:59
GMT
application: MyBackupApp
と指定したとします。
以下は、Amazon S3 コンテンツの GET オペレーションの
結果です。
x-amz-meta-import-timestamp: Wed, 23 Feb 2011
01:55:59 GMT
x-amz-meta-application: MyBackupApp
タイプ: 文字列から文字列へのマッピング
デフォルト: なし
制限: ユーザー定義キーが、有効な HTTP ヘッダーキー
であること (ASCII のみ、コロンなし、スペースなし)。
値が ASCII のみであること。ここで選択されるキー名
は、diskTimestampMetadataKey 関数で使用されるキー
名と同じである必要はありません。
storageClass
インポートジョブを実行する Amazon S3 のストレージ
クラスを指定します。Amazon S3 ストレージクラスの詳
細については、 Amazon S3 開発者ガイドを参照してく
ださい。
storageClass: REDUCED_REDUNDANCY
タイプ: Enum
デフォルト: STANDARD
有効な値: STANDARD | REDUCED_REDUNDANCY
83
いいえ
AWS Import/Export 開発者ガイド
Amazon S3 へのインポートのマ
ニフェストファイルオプション
オプション
説明
必須
substitutions
このオプションを使用して、インポートまたはエクス
ポート中に Amazon S3 バケットと指定デバイス間で既
存の値 (オブジェクトキーやファイル名など) と置き換え
る文字列を指定できます。インポートまたはエクスポー
トオペレーションの前に、指定された値に一致する値
が置き換えられます。コロンの左側で指定された値が、
右側にある値に置き換えられます。置き換えは、長さ順
に適用されます。もっとも長い一致オプションが最初に
適用されます。substitutions の使用方法の詳細について
は、「Amazon S3 代替の使用 (p. 40)」を参照してく
ださい。
いいえ
substitutions:
"," : "$COMMA$"
型: 文字列
デフォルト: なし
trueCryptPassword
データが TrueCrypt を使用して暗号化されている場合
の、デバイスが暗号化された際に入力されたパスワー
ドです。TrueCrypt を使用したデータの暗号化について
は、「データの暗号化 (p. 60)」を参照してください。
いいえ
パスワードには、アスタリスク (*) または引用符 ( ' " ) は
使用できません。パスワードにそのほかの特殊文字が含
まれる場合、二重引用符でその文字列を囲んでくださ
い。
trueCryptPassword の例を次に示します。
trueCryptPassword: SimpleButEasi1yCrackedEXAMPLE
型: 文字列
デフォルト: なし
Example Amazon S3 へのインポートのマニフェスト
次の例では、Amazon S3 へのインポートジョブ用のマニフェストファイル内容を示します。緊急配送およ
び必須の eraseDevice および notificationEmail オプションが含まれています。
manifestVersion: 2.0
deviceId: ABCDE
eraseDevice: yes
notificationEmail: [email protected];[email protected]
bucket: my-amz-bucket
acl: authenticated-read
cacheControl: max-age=3600
contentDisposition: attachment
contentLanguage: en
contentTypes:
csv: application/vnd.ms-excel
diskTimestampMetadataKey: disk-timestamp
generator: AWS Import Export Docs
84
AWS Import/Export 開発者ガイド
Amazon EBS へのインポートの
マニフェストファイルオプション
ignore:
- \.psd$
- \.PSD$
logPrefix: logs
logBucket: iemanifest-bucket
prefix: imported/
setContentEncodingForGzFiles: yes
staticMetadata:
import-timestamp: Wed, 23 Feb 2011 01:55:59 GMT
application: AppImportedData
pinCode:4321
trueCryptPassword: SimpleButEasi1yCrackedEXAMPLE
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
serviceLevel: expeditedShipping
Amazon EBS へのインポートのマニフェストファイル
オプション
Amazon EBS インポートマニフェストファイルには、Amazon EBS へのデータのインポートとストレージ
デバイスの返却に関する情報が含まれています。このセクションでは、Amazon EBS インポートマニフェ
ストファイル独自のオプションを説明します。すべてのマニフェストファイルに共通のオプションについ
ては、「マニフェストファイルの共通オプション (p. 70)」を参照してください。
Note
Amazon EBS および Amazon Glacier では、マニフェストファイルのバージョン 3.0 の
みを使用します。すべての Amazon EBS および Amazon Glacier マニフェストファイル
で、manifestVersion を 3.0 に設定してください。
Amazon EBS インポートにより、デバイス仮想コピーが単一イメージとして作成されます。デバイスの
ファイルシステムは自動的に Amazon EC2 インスタンスにマウントされません。Amazon EBS ボリュー
ムの最大サイズは 16 TB です。デバイスの最大容量は、デバイスに保存されたデータ量とは別であること
に注意してください。
オプション
説明
必須
eraseDevice
AWS がデータをインポート後、ストレージデバイスのコ はい
ンテンツ消去することを了承する値です。ストレージデ
バイスのすべての書き込み可能なブロックはゼロで上書
きされます。初期化後に、デバイスの再パーティション
化とフォーマットを行う必要があります。
例
eraseDevice: yes
型: 文字列
デフォルト: なし
85
AWS Import/Export 開発者ガイド
Amazon EBS へのインポートの
マニフェストファイルオプション
オプション
説明
必須
有効な値: yes | true
オペレーション
operations オプションは 1 つ以上のサブフィールドの
コンテナです。オペレーションパラメーターの後にダッ
シュと一連のサブフィールドを続けて指定します。
はい
以下は、operations オプションと必要な Amazon EBS
サブフィールドの例です。
operations:
- destination: ebs-snapshot
source: device
region: us-east-1
deviceCapacityGreaterThan1TB: no
各サブフィールドの詳細については、「オペレーション
のサブフィールド (p. 86)」を参照してください。
型: 文字列
デフォルト: なし
pinCode
ハードウェアベースで暗号化されているストレージデバ
イスが提供される場合、そのデバイスの PIN コードで
す。詳細については、「データの暗号化 (p. 60)」を参
照してください。
いいえ
pinCode: 1234
Important
PIN コードはなくさないでください。データを
復号化できなくなります。AWS Import/Export
では、暗号化されたデバイスと一緒に PIN コー
ドを送信しません。
タイプ: 整数
デフォルト: なし
オペレーションのサブフィールド
次の表は、オペレーションのパラメーターのサブフィールドについて説明します。
オペレーションのサブフィールド
説明
必須
送信先
データの送信先です。
はい
Amazon EBS インポートオペレーションでは、送信先は
ebs-snapshot です。
型: 文字列
デフォルト: なし
86
AWS Import/Export 開発者ガイド
Amazon EBS へのインポートの
マニフェストファイルオプション
オペレーションのサブフィールド
説明
必須
有効な値: ebs-snapshot
deviceCapacityGreaterThan1TB
デバイス容量が 1 TB より大きい場合に指定する値で
す。Disk では、16 TB の Amazon EBS へのインポート
をサポートしています。
はい
型: 文字列
デフォルト: なし
有効な値: yes | no
リージョン
インポートオペレーションの対象となるリージョンで
す。
はい
型: 文字列
デフォルト: なし
有効な値: us-east-1 | us-west-1 | us-west-2 | eu-west-1 |
ap-southeast-1
リージョンの詳細については、「AWS Import/Export
Disk Calculator」を参照してください。
source
データの送信元です。インポートジョブの場合、送信元
はデバイスです。
はい
型: 文字列
デフォルト: なし
有効な値: device
Example Amazon EBS へのインポートのマニフェスト
以下は、緊急配送を含む Amazon EBS へのインポートジョブ用のマニフェストファイルの例です。
manifestVersion: 3.0
deviceId: ABCDE
eraseDevice: yes
generator: AWS Import Export Docs
logPrefix: logs
logBucket: iemanifest-bucket
notificationEmail: [email protected];[email protected]
operations:
- destination: ebs-snapshot
source: device
region: us-east-1
deviceCapacityGreaterThan1TB: no
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
87
AWS Import/Export 開発者ガイド
Amazon Glacier へのインポートの
マニフェストファイルオプション
serviceLevel: expeditedShipping
Amazon Glacier へのインポートのマニフェストファ
イルオプション
Amazon Glacier インポートマニフェストファイルには、Amazon Glacier へのデータのインポートとスト
レージデバイスの返却に関する情報が含まれています。このセクションでは、Amazon Glacier インポー
トマニフェストファイル独自のオプションを説明します。AWS Import/Export では、Amazon EBS または
Amazon Glacier からのエクスポートはサポートしていません。インポートおよびエクスポートのマニフェ
ストファイルに共通のオプションについては、「マニフェストファイルの共通オプション (p. 70)」を参
照してください。
Note
Amazon EBS および Amazon Glacier では、マニフェストファイルのバージョン 3.0 の
みを使用します。すべての Amazon EBS および Amazon Glacier マニフェストファイル
で、manifestVersion を 3.0 に設定してください。
オプション
説明
必須
eraseDevice
AWS がデータをインポート後、ストレージデバイスのコ はい
ンテンツ消去することを了承します。ストレージデバイ
スのすべての書き込み可能なブロックはゼロで上書きさ
れます。初期化後に、デバイスの再パーティション化と
フォーマットを行う必要があります。
エントリの例を次に示します。
eraseDevice: yes
型: 文字列
デフォルト: なし
有効な値: yes | true
オペレーション
operations オプションは 1 つ以上のサブフィールドの
コンテナです。オペレーションパラメーターの後にダッ
シュと一連のサブフィールドを続けて指定します。
以下は、operations と必要な Amazon Glacier サブ
フィールドの例です。
operations:
- destination: glacier
source: device
region: us-east-1
vaultName: 2012-07_archive
archiveComment: daily_2012-07-24
各サブフィールドの詳細については、「オペレーション
のサブフィールド (p. 89)」を参照してください。
型: 文字列
デフォルト: なし
88
はい
AWS Import/Export 開発者ガイド
Amazon Glacier へのインポートの
マニフェストファイルオプション
オプション
説明
必須
pinCode
ハードウェアベースで暗号化されているストレージデバ
イスが提供される場合、そのデバイスの PIN コードで
す。詳細については、「データの暗号化 (p. 60)」を参
照してください。
いいえ
pinCode: 1234
Important
PIN コードはなくさないでください。データを
復号化できなくなります。AWS Import/Export
では、暗号化されたデバイスと一緒に PIN コー
ドを送信しません。
タイプ: 整数
デフォルト: なし
オペレーションのサブフィールド
次の表は、オペレーションのパラメーターのサブフィールドについて説明します。
オペレーションのサブフィールド
説明
必須
archiveComment
アーカイブの説明。Amazon Glacier は、アーカイブの説
明としてこのテキストを使用して、指定ボールトにアー
カイブを作成します。
はい
エントリの例を次に示します。
archiveComment: daily archive 2012-07-2
制限: 最大長は 997 文字です。
型: 文字列
デフォルト: なし
送信先
データの送信先です。
はい
Amazon Glacier インポートオペレーションの場合、送信
先は glacier です。
型: 文字列
デフォルト: なし
有効な値: glacier
リージョン
インポートオペレーションの対象となるリージョンで
す。
型: 文字列
デフォルト: なし
89
はい
AWS Import/Export 開発者ガイド
Amazon S3 からのエクスポートにお
けるマニフェストファイルオプション
オペレーションのサブフィールド
説明
必須
有効な値: us-east-1 | us-west-1 | us-west-2 | eu-west-1
リージョンの詳細については、「AWS Import/Export
Disk Calculator」を参照してください。
source
データの送信元です。インポートジョブの場合、送信元
はデバイスです。
はい
型: 文字列
デフォルト: なし
有効な値: device
vaultName
Disk がデータをロードする Amazon Glacier ボールトを
指定します。データをロードする前に、ボールトを作成
する必要があります。当社ではお客様のボールトを作成
しません。ロードを実行するアカウントには、このボー
ルトでの書き込み権限が必要です。
はい
型: 文字列
デフォルト: なし
制限: 既存の Amazon Glacier ボールト名であること
Example Amazon Glacier へのインポートのマニフェスト
以下は、緊急配送を含む Amazon Glacier へのインポートジョブ用のマニフェストファイルの例です。
manifestVersion: 3.0
deviceId: 49382
eraseDevice: yes
logBucket: myBucket
logPrefix: logs
generator: AWS Import/Export Command Line Tool
notificationEmail: [email protected];[email protected]
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
operations:
- destination: glacier
source: device
region: us-east-1
vaultName: MyGlacierVault
archiveComment: July 24, 2012 daily archive
serviceLevel: expeditedShipping
Amazon S3 からのエクスポートにおけるマニフェス
トファイルオプション
90
AWS Import/Export 開発者ガイド
Amazon S3 からのエクスポートにお
けるマニフェストファイルオプション
エクスポートマニフェストファイルには、Amazon S3 からお客様のストレージデバイスへのデータのエク
スポートに関連する情報が含まれます。このセクションでは、エクスポートマニフェストファイルのみで
使用できるオプションについて説明します。インポートおよびエクスポートのマニフェストファイルに共
通のオプションについては、「マニフェストファイルの共通オプション (p. 70)」を参照してください。
Amazon S3 のインポートおよびエクスポートでは、マニフェストファイルのバージョン 2.0 のみを使用し
ます。すべての Amazon S3 インポートおよびエクスポートのマニフェストファイルで、manifestVersion
を 2.0 に設定してください。
オプション
説明
必須
fileSystem
ストレージデバイスのファイルシステムを指定しま
す。fileSystem エントリの例を次に示します。
はい
fileSystem: NTFS
型: 文字列
デフォルト: なし
有効な値: NTFS | EXT4
オペレーション
このジョブの各バケットで実行するオペレーションを指定
するサブフィールドをとるコンテナ。サブフィールドは名
前と値のペアです。たとえば、exportBucket はデータを
エクスポートするバケットを指定します。詳細について
は、「オペレーションエクスポートマニフェストのオプ
ション (p. 54)」を参照してください。次の例は 2 つの
サブフィールド exportBucket および endMarker を持つ
operations です。
はい
operations:
- exportBucket: bucket-data-comes-from
targetDirectory: myexport/stuff
beginMarker: images/starwars
endMarker: images/xena
prefix: exported/
各サブフィールドについては、「オペレーションのサブ
フィールド (p. 93)」を参照してください。
型: 文字列
デフォルト: なし
pinCode
ハードウェアベースで暗号化されているストレージデバイス
が提供される場合、そのデバイスの PIN コードです。
*すべてのエクスポートジョブには pinCode または
trueCryptPassword が必要です。詳細については、「データ
の暗号化 (p. 60)」を参照してください。
pinCode: 1234
Important
PIN コードはなくさないでください。データを復号
化できなくなります。AWS Import/Export では、暗号
91
はい*
AWS Import/Export 開発者ガイド
Amazon S3 からのエクスポートにお
けるマニフェストファイルオプション
オプション
説明
必須
化されたデバイスと一緒に PIN コードを送信しませ
ん。
タイプ: 整数
デフォルト: なし
recoveryDirectory
これは、ファイル名 Disk をキーから変更する必要があるファ
イルを保存するストレージデバイスのディレクトリです。
キーに有効な文字が常にファイル名にも有効とは限らないた
め、頻繁に発生します。次の例では、復旧ディレクトリを
LostAndFound としています。
いいえ
recoveryDirectory: LostAndFound
型: 文字列
デフォルト: EXPORT-RECOVERY
substitutions
このオプションを使用して、インポートまたはエクスポート
いいえ
中に Amazon S3 バケットと指定デバイス間で既存の値 (オブ
ジェクトキーやファイル名など) と置き換える文字列を指定
できます。インポートまたはエクスポートオペレーションの
前に、指定された値に一致する値が置き換えられます。コロ
ンの左側で指定された値が、右側にある値に置き換えられま
す。置き換えは、長さ順に適用されます。もっとも長い一致
オプションが最初に適用されます。substitutions の使用方法の
詳細については、「Amazon S3 代替の使用 (p. 40)」を参
照してください。
substitutions:
"," : "$COMMA$"
型: 文字列
デフォルト: なし
92
AWS Import/Export 開発者ガイド
Amazon S3 からのエクスポートにお
けるマニフェストファイルオプション
オプション
説明
必須
trueCryptPassword
AWS Import/Export では、エクスポート中に TrueCrypt を使用 はい*
したデータの暗号化にパスワードを使用します。
パスワードには、アスタリスク (*) または引用符 ( ' " ) は使用
できません。パスワードにそのほかの特殊文字が含まれる場
合、二重引用符でその文字列を囲んでください。
*すべてのエクスポートジョブには pinCode または
trueCryptPassword が必要です。詳細については、「データ
の暗号化 (p. 60)」を参照してください。
Important
パスワードはなくさないでください。データを復号
化できなくなります。AWS Import/Export は、パス
ワードを暗号化されたデバイスとともに送付しませ
ん。
TrueCrypt を使用したデータの暗号化については、「データの
暗号化 (p. 60)」を参照してください。
trueCryptPassword の例を次に示します。
trueCryptPassword: SimpleButEasi1yCrackedEXAMPLE
型: 文字列
デフォルト: なし
オペレーションのサブフィールド
次の表は、オペレーションのパラメーターのサブフィールドについて説明します。
オペレーションのサブフィールド
説明
必須
beginMarker
データのエクスポートを開始するバケットの位置を示
します。エクスポートジョブには、beginMarker を
含まずその後に続くアルファベット順のキーのみが
含まれます。たとえば、beginMarker が alpha であ
り、endMarker が omega である場合、キー alpha-1 お
よび omega はエクスポートされますが、alpha および
omega-1 はエクスポートされません。このオプション
は、エクスポートするファイル数を制限し、大量エクス
ポートジョブを複数のデバイス間で分割する場合に便利
です。beginMarker 値の例を次に示します。
いいえ
operations:
- exportBucket: bucket-data-comes-from
beginMarker: images/alpha
endMarker: images/omega
型: 文字列
デフォルト: なし
93
AWS Import/Export 開発者ガイド
Amazon S3 からのエクスポートにお
けるマニフェストファイルオプション
オペレーションのサブフィールド
説明
必須
endMarker
データのエクスポートを停止するバケットの位置を示し
ます。エクスポートジョブには、endMarker に一致する
キーを含まずその前までアルファベット順のキーのみ
が含まれます。たとえば、beginMarker が alpha であ
り、endMarker が omega である場合、キー alpha-1 お
よび omega はエクスポートされますが、alpha および
omega-1 はエクスポートされません。このオプション
は、エクスポートするファイル数を制限し、大量エクス
ポートジョブを複数のデバイス間で分割する場合に便利
です。endMarker 値の例を次に示します。
いいえ
operations:
- exportBucket: bucket-data-comes-from
beginMarker: images/alpha
endMarker: images/omega
型: 文字列
デフォルト: なし
exportBucket
AWS Import/Export がデータを取得する Amazon S3
はい
バケットを指定します。operations の各リストには
exportBucket オプションが必要です。ジョブを作成した
AWS IAM ユーザーには、バケットとオブジェクトの読み
取り権限が必要です。リストに他のオプションが指定さ
れていない場合、AWS Import/Export によってバケット
のすべてのファイルがストレージデバイスにエクスポー
トされます。exportBucket 名の例を次に示します。
operations:
- exportBucket: bucket-data-comes-from
型: 文字列
デフォルト: なし
制限: 既存の Amazon S3 バケット名であること
Note
エクスポートの場合、Amazon S3 ログバケッ
トと Amazon S3 エクスポートバケットは同じ
リージョンにある必要があります。バケットが
異なるリージョンにある場合、ジョブのリクエ
ストは失敗します。
94
AWS Import/Export 開発者ガイド
Amazon S3 からのエクスポートにお
けるマニフェストファイルオプション
オペレーションのサブフィールド
説明
必須
プレフィックス
AWS Import/Export がエクスポートするデータを検出す
る exportBucket 内のパスを指定します。プレフィック
スを含むキーはすべて、ストレージデバイスに保存さ
れます。詳細については、「ファイルのエクスポートの
管理 (p. 54)」を参照してください。prefix は、イン
ポートマニフェストファイルで使用する場合は、別の意
味があることに注意してください。
いいえ
logPrefix + import-log-JOBID が 1024 バイト
を超える場合、Disk は CREATE JOB コマンドから
InvalidManifestField エラーを返します。
次の例では、ディレクトリ images のすべてのファイル
をエクスポートします。
operations:
- prefix: images
型: 文字列
デフォルト: なし
制限: キーは一続きの Unicode 文字で、UTF-8 にエン
コードすると最大で 1,024 バイト長になります。
targetDirectory
データをエクスポートするストレージデバイス内の場所
を示します。次の例では、AWS Import/Export はバケッ
ト bucket-data-comes-from のコンテンツをストレージ
デバイスの myexport/stuff にエクスポートします。
いいえ
operations:
- exportBucket: bucket-data-comes-from
targetDirectory: myexport/stuff
型: 文字列
デフォルト : 指定された exportBucket
Example Amazon S3 マニフェストからのエクスポート
以下は、緊急配送を含む Amazon S3 からのエクスポートジョブ用のマニフェストファイルの例です。
manifestVersion: 2.0
deviceId: ABCDE
fileSystem: NTFS
generator: AWS Import Export Docs
logPrefix: logs
logBucket: iemanifest-bucket
notificationEmail: [email protected];[email protected]
trueCryptPassword: SimpleButEasi1yCrackedEXAMPLE
operations:
- exportBucket: my-amz-bucket
targetDirectory: myexport/stuff
beginMarker: images/starwars
endMarker: images/xena
prefix: exported/
95
AWS Import/Export 開発者ガイド
API リファレンス
recoveryDirectory: LostAndFound
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
serviceLevel: expeditedShipping
API リファレンス
以下のセクションでは、AWS Import/Export Disk アプリケーションプログラミングインターフェイス (API)
を説明します。Disk API は Disk 機能専用です。AWS Snowball 機能または Snowball アプライアンス との
互換性はありません。Snowball および Disk は互いに独立しており、片方での操作は、もう片方には影響
しません。
トピック
• クエリリクエストを行う (p. 96)
• アクション (p. 100)
• 共通のクエリパラメーター (p. 121)
• エラーとステータスコード (p. 122)
クエリリクエストを行う
AWS Import/Export Disk では、クエリリクエストは HTTP 動詞 POST と Action という名前のクエリパラ
メーターで記述する HTTPS リクエストです。
トピック
• エンドポイント (p. 96)
• AWS Import/Export Disk POST リクエストの構造 (p. 96)
• Query 認証 (p. 98)
エンドポイント
サービスエンドポイントを使用して AWS Import/Export Disk にリクエストを送信するには
https://importexport.amazonaws.com
Note
AWS Import/Export は、HTTP 経由のリクエストをサポートしていません。HTTPS リクエストの
みがサポートされています。
AWS Import/Export Disk POST リクエストの構造
このセクションでは、以下で構成される AWS Import/Export Disk POST リクエストを概説します。
96
AWS Import/Export 開発者ガイド
クエリリクエストを行う
• エンドポイント - 次のような AWS Import/Export のエントリポイントです。
https://importexport.amazonaws.com
• アクション - 既存ジョブのステータスの取得 (GetStatus) など、エンドポイントで実行するアクションで
す。詳細な一覧については、「アクション (p. 100)」を参照してください。
• パラメーター - すべての AWS Import/Export アクションに共通の一連のパラメーター、および AWS
Import/Export API でサポートされているリクエストパラメーターです。詳細については、「共通のクエ
リパラメーター (p. 121)」を参照してください。
例
Example AWS Import Export Disk POST リクエスト
以下は AWS Import/Export Disk でジョブのステータスを取得する POST リクエスト例です。
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:207
Action=GetStatus&SignatureMethod=HmacSHA256&JobId=JOBID&SignatureVersion=2&Version=2014-12-18&Signature
%2FVfkltRBOoSUi1sWxRzN8rw%3D&Timestamp=2014-12-20T22%3A30%3A59.556Z
リクエストの本文は、1 行ですべて記述します。ただし、例では読みやすくするために改行が追加されて
います。
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:207
Action=GetStatus
&JobId=JOBID
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Version=2014-12-18
&Signature=lBP67vCvGlDMBQ1dofZxg8E8SUEXAMPLE
&Timestamp=2014-12-20T22%3A30%3A59.556Z
最初の行は、http リクエストのタイプを表しています。
行 2 ~ 4 には、リクエストのエンドポイントを含む HTTP ヘッダーが含まれます。
HTTP ヘッダーの後ろに、パラメーターのリストが含まれたリクエストの本文が続きます。各パラメー
ターは、隣同士アンパーサンド (&) で区切られています。Action パラメータは実行するアクションを示し
ます。可能なアクションの一覧については、アクション (p. 100) を参照してください。
Example AWS Import Export Disk POST レスポンス
以下に、AWS Import/Export Disk の応答の例を示します。
<CreateJobResponse xmlns="http://importexport.amazonaws.com/">
<CreateJobResult>
<JobId>TEST1</JobId>
<SignatureFileContents>version:2.0
signingMethod:HmacSHA1
97
AWS Import/Export 開発者ガイド
クエリリクエストを行う
jobId:WXSPP
signature:jLbLVp54vBa/vuh/XW1MOMdZUxw=
</SignatureFileContents>
<AwsShippingAddress>Please use the GetShippingLabel command to print your pre-paid
shipping label</AwsShippingAddress>
<Signature>O3qG7xnI46ZEm9gi+eOy9dnSS9k=</Signature>
</CreateJobResult>
<ResponseMetadata>
<RequestId>ace8cb5b-0ada-11df-a381-155bec6f7c93</RequestId>
</ResponseMetadata>
</CreateJobResponse>
Query 認証
HTTPS 経由で AWS Import/Export Disk のリクエストを送信できます。これを行うには、すべてのリクエ
ストに署名を含める必要があります。このセクションでは、署名を作成する方法について説明します。次
に説明する方法は、署名バージョン 2 と呼ばれます。
Warning
現在、署名バージョン 1 を使用している場合: バージョン 1 は非推奨となっているため、できる
だけ早く署名バージョン 2 に移行してください。非推奨スケジュールおよび署名バージョン 2 と
バージョン 1 の違いについては、「Making Secure Requests to Amazon Web Services」を参照
してください。
署名を作成するには
1.
本手順で後に必要となる、正規化されたクエリ文字列を作成します。
a.
自然なバイト順のパラメータ名で、UTF-8 のクエリ文字列コンポーネントを並び替えます。
パラメータは GET URI または POST ボディから取得される場合があります(Content-Type が
application/x-www-form-urlencoded の場合)。
b.
URL は、以下の規則に応じてパラメータ名と値をエンコードします。
• RFC 3986 が定義する非予約文字を、URL がエンコードすることはありません。
非予約文字とは、A-Z, a-z, 0-9, ハイフン(-)、アンダーバー(_)、ピリオド(.)、およびチ
ルダ(~)です。
• 他のすべての文字についても、%XY (X および Y には HEX 文字の 0-9 および大文字の A-F が
入る) によるパーセントエンコードが必要です。
• パーセントは、拡張 UTF-8 文字を %XY%ZA.... 形式でエンコードします。
• パーセントは、スペース文字を %20(通常エンコードスキーマが行なうような + ではありませ
ん)としてエンコードします。
Note
c.
d.
2.
現在、すべての AWS サービスのパラメータの名称は非予約文字を使用しているので、
これらをエンコードする必要はありません。しかし、将来必要な場合に備えて、予約文
字を含むパラメータを処理できるコードを含めていただいた方がよいかもしれません。
パラメータの値が空値の場合でも、エンコードされるパラメータ名とエンコードされる値の間に
等号(=)(ASCII コード 61)を入れます。
それぞれのパラメータ名と値のペアをアンド(&)(ASCII コード 38)で分割します。
署名用の文字列を以下の擬似文法に基づいて作成します("\n" は ASCII コードの改行を示します)。
StringToSign = HTTPVerb + "\n" +
ValueOfHostHeaderInLowercase + "\n" +
98
AWS Import/Export 開発者ガイド
クエリリクエストを行う
HTTPRequestURI + "\n" +
CanonicalizedQueryString <from the preceding step>
HTTPRequestURI 要素は URI の HTTP 絶対パス要素ですが、クエリ文字列は含みませ
ん。HTTPRequestURI が空値の場合は、スラッシュ(/)を使用してください。
3.
作成したばかりの文字列を使い、シークレットアクセスキーをキーとして、また SHA256 または
SHA1 をハッシュアルゴリズムとして、RFC 2104 に準拠した HMAC を計算します。
詳細は、http://www.rfc.net/rfc2104.html を参照してください。
4.
結果の値を base64 に変換します。
5.
結果として得られた値をリクエスト内のSignatureパラメータに含めて使用します。
Important
最終的にリクエストに含める署名は、RFC 3986 にて規定された方法で URL エンコードされてい
る必要があります (詳細については、http://www.rfc.net/rfc3986.html を参照してください)。最終
的なリクエストがツールキットによって URL エンコードされる場合は、必須である署名の URL
エンコーディングもツールキットによって処理されます。もしご利用のツールキットが最終的な
リクエストの URL エンコード処理を行わない場合は、リクエストに署名を含めて送信する前に、
必ず URL エンコードを行うようにしてください。最も重要なのは、署名の URL エンコードは1
度だけ行うということです。よくある失敗の 1 つに、署名を作成するときに手動で URL エンコー
ドした後で、リクエスト全体をツールキットで URL エンコードするというものがあります。
GetStatus リクエストのサンプル
次のリクエストはインポートジョブの現在の状態を取得します (リクエスト内部の Signature を無効にす
るように変更しています)。
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:639
Action=GetStatus&SignatureMethod=HmacSHA256&JobId=JOBID&SignatureVersion=2&Version=2010-06-01&Signature
%2FVfkltRBOoSUi1sWxRzN8rw%3D&Timestamp=2011-06-20T22%3A30%3A59.556Z
以下は、署名対象の文字列です。
リクエストの本文は、1 行ですべて記述します。ただし、例では読みやすくするために改行が追加されて
います。
POST\n
importexport.amazonaws.com\n
/\n
&Action=GetStatus
&JobId=JOBID
&SignatureMethod=HmacSHA256
&SignatureVersion=2
Version=2010-06-01&
以下は、署名リクエストです。
POST\n
importexport.amazonaws.com\n
/\n
&Action=GetStatus
99
AWS Import/Export 開発者ガイド
アクション
&JobId=JOBID
&SignatureMethod=HmacSHA256
&SignatureVersion=2
&Version=2010-06-01
&Signature=%2FVfkltRBOoSUi1sWxRzN8rw%3D
&Timestamp=2011-06-20T22%3A30%3A59.556Z
アクション
このセクションでは、Query API のリクエストパラメーターを使用した AWS Import/Export Disk のウェブ
サービスのアクションを説明します。
トピック
• CancelJob (p. 101)
• CreateJob (p. 103)
• GetStatus (p. 107)
• ListJobs (p. 112)
• UpdateJob (p. 116)
• GetShippingLabel (p. 119)
Note
Disk では SOAP はサポートされません。
100
AWS Import/Export 開発者ガイド
アクション
CancelJob
説明
このアクションは指定されたジョブをキャンセルします。ジョブの所有者のみがキャンセルできます。
ジョブがすでに開始されている場合や完了している場合は、アクションは失敗します。
リクエストパラメータ
すべてのアクションに共通のパラメーターの詳細については、「共通のクエリパラメーター (p. 121)」を
参照してください。
名前
説明
必須
アクション
実行するアクションを指定します。
はい
型: 文字列
デフォルト: なし
有効な値: CancelJob
JobId
キャンセルするジョブを指定する、CreateJob によって返される識別
子。
型: 文字列
デフォルト: なし
レスポンス要素
名前
説明
CancelJobResponse
レスポンスのコンテナ。
タイプ: なし
先祖: なし
子: CancelJobResult (p. 101)、ResponseMetadata (p. 101)
CancelJobResult
結果のコンテナ。
タイプ: なし
先祖: CancelJobResponse (p. 101)
子: Success (p. 102)
RequestId
リクエストを一意に識別する識別子。
型: 文字列
先祖: CancelJobResponse (p. 101)ResponseMetadata (p. 101)
子: なし
ResponseMetadata
レスポンスメタデータのコンテナ。
型: 文字列
101
はい
AWS Import/Export 開発者ガイド
アクション
名前
説明
先祖: CancelJobResponse
子: RequestId (p. 101)
Success
AWS Import/Export がジョブをキャンセルしたか (true) しなかったか (false)
を指定します。
タイプ: ブール値
有効な値: true | false
先祖: CancelJobResponse (p. 101)CancelJobResult (p. 101)
子: なし
エラー
一般的なエラーのリストは、エラーとステータスコード (p. 122)を参照してください。
例
リクエスト例
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:188
Action=CancelJob&SignatureMethod=HmacSHA256&JobId=JOBID&
&SignatureVersion=2&
Signature=%2FVfkltRBOoSUi1sWxRzN8rw%3D&Timestamp=2011-06-20T23%3A53%3A37.232Z
レスポンス例
<CancelJobResponse xmlns="http://importexport.amazonaws.com/">
<CancelJobResult>
<Success>true</Success>
</CancelJobResult>
<ResponseMetadata>
<RequestId>a4f704fc-0ad8-11df-b085-4384d3e37ae5</RequestId>
</ResponseMetadata>
</CancelJobResponse>
関連アクション
以下のアクションは CancelJob に関連しています。
• CreateJob (p. 103)
102
AWS Import/Export 開発者ガイド
アクション
CreateJob
説明
このアクションは、データのアップロードまたはダウンロードをスケジュールするプロセスを開始しま
す。リクエスト内にはデータ転送の仕様を記述したマニフェストを含めます。このリクエストへのレスポ
ンスにはジョブ ID が含まれており、他のアクションで使用できます。また、ストレージデバイスの識別に
使用する署名が含まれます。前払い配送ラベルを取得するには、GetShippingLabel (p. 119) コマンドを
使用します。
リクエストパラメータ
すべてのアクションに共通のパラメーターの詳細については、「共通のクエリパラメーター (p. 121)」を
参照してください。
名前
説明
必須
アクション
実行するアクションを指定します。
はい
型: 文字列
デフォルト: なし
有効な値: CreateJob
JobType
開始するジョブがインポートジョブであるかエクスポートジョブであ
るかを指定します。
はい
タイプ: Enum
デフォルト: なし
有効な値: Import | Export
マニフェスト
UTF-8 でエンコードされたテキストのマニフェストファイルです。マ
ニフェストのパラメーターの詳細については、「マニフェストファイ
ルオプションのリファレンス (p. 69)」を参照してください。
はい
型: 文字列
デフォルト: なし
ValidateOnly
リクエストのマニフェストとパラメーター値を検証しますが、実際の
ジョブは作成しません。
タイプ: ブール値
デフォルト: false
有効な値: true | false
レスポンス要素
名前
説明
CreateJobResponse
レスポンスのコンテナ。
タイプ: なし
103
いいえ
AWS Import/Export 開発者ガイド
アクション
名前
説明
先祖: なし
子: CreateJobResult (p. 104)、ResponseMetadata (p. 104)
CreateJobResult
コンテナ.
タイプ: なし
先祖: CreateJobResponse
子: JobId (p. 104) 署名 (p. 104)
JobId
AWS Import/Export ジョブを一意に識別する、AWS によって作成され
る ID。
型: 文字列
先祖: CreateJobResponse (p. 103)CreateJobResult (p. 104)
JobType
ジョブがインポートジョブであるかエクスポートジョブであるかを指定
します。
型: 文字列
先祖: GetStatusResponse.GetStatusResult
子: なし
RequestId
リクエストを一意に識別する ID。
型: 文字列
先祖: CreateJobResponse (p. 103)ResponseMetadata (p. 104)
ResponseMetadata
コンテナ.
タイプ: なし
先祖: CreateJobResponse
子: RequestId (p. 101)
署名
リクエストとレスポンスを認証するために使用される暗号化されたコー
ド。例: DV+TpDfx1/TdSE9ktyK9k/bDTVI=。独自に署名ファイルを作成
する場合にのみ、この値を使用します。
型: 文字列
先祖: CreateJobResponse (p. 103)CreateJobResult (p. 104)
104
AWS Import/Export 開発者ガイド
アクション
名前
説明
SignatureFileContents
ディスクに書き込まれる SIGNATURE ファイルの実際のテキスト。例:
version:2.0
signingMethod:HmacSHA1
jobId:<the customer's job id>
signature:DV+TpDfx1/TdSE9ktyK9k/bDTVI=
型: 文字列
先祖: CreateJobResponse (p. 103)CreateJobResult (p. 104)
WarningMessage
互換性のない Amazon S3 バケット名の使用など、ジョブの致命的では
ない問題を通知する任意のメッセージ。
型: 文字列
先祖: CreateJobResponse (p. 103)CreateJobResult (p. 104)
エラー
一般的なエラーのリストは、エラーとステータスコード (p. 122)を参照してください。
例
リクエスト例
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:639
Manifest=manifestVersion%3A%202.0%0Abucket%3A%20myawsbucket
%0AreturnAddress%3A%0A%20%20%20%20name%3A%20
Amazon.com%20ATTN%20Joe%20Random%20%0A%20%20%20%20street1%3A%201200%20AAAA%20Ave%20
S.%0A%20%20%20%20city%3A%20Seattle%0A%20%20%20%20stateOrProvince%3A%20WA%0A%20%20%20%20
postalCode%3A%2098114%0A%20%20%20%20phoneNumber%3A%20206-266-0000%0A%20%20%20%20
country%3A%20USA&JobType=Import&Action=CreateJob&SignatureMethod=HmacSHA256
&SignatureVersion=2&Version=2010-06-01
&Signature=%2F5UvjcJOE1PqUa%2BcmnzadQYs2frTAt8LSo3M5o%2BEH0%3D&Timestamp=
2011-06-20T18%3A49%3A14.981Z
レスポンス例
<CreateJobResponse xmlns="http://importexport.amazonaws.com/">
<CreateJobResult>
<JobId>TEST1</JobId>
<Signature>O3qG7xnI46ZEm9gi+eOy9dnSS9k=</Signature>
</CreateJobResult>
<ResponseMetadata>
<RequestId>ace8cb5b-0ada-11df-a381-155bec6f7c93</RequestId>
</ResponseMetadata>
</CreateJobResponse>
関連アクション
以下のアクションは CreateJob に関連しています。
105
AWS Import/Export 開発者ガイド
アクション
• CancelJob (p. 101)
• GetShippingLabel (p. 119)
106
AWS Import/Export 開発者ガイド
アクション
GetStatus
説明
このアクションは、ジョブが一連のプロセスのどの段階にあるか、結果のステータス、ジョブに関連付け
られた署名値を含む、ジョブに関する情報を返します。自身が所有するジョブに関する情報のみを返すこ
とができます。
リクエストパラメータ
すべてのアクションに共通のパラメーターの詳細については、「共通のクエリパラメーター (p. 121)」を
参照してください。
名前
説明
必須
アクション
実行するアクションを指定します。
はい
型: 文字列
デフォルト: なし
有効な値: GetStatus
JobId
情報を返す対象のジョブを指定します。
はい
型: 文字列
デフォルト値:
制限: 所有するジョブの有効なジョブ ID であること。
レスポンス要素
名前
説明
AwsShippingAddress
AWS Import/Export ウェブサービスツールの GetShippingLabel アクショ
ンを使用して、前払い配送ラベルを忘れずに生成してください。
型: 文字列
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
Carrier
運送会社の名前。この値は、LocationCode が Returned の場合に含まれ
ます。
型: 文字列
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
子: なし
CreationDate
ISO8601 日付形式の CreateJob リクエストのタイムスタンプ。例:
2010-03-28T20:27:35Z。詳細については、「ISO 8601」を参照してくだ
さい。
型: 文字列
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
107
AWS Import/Export 開発者ガイド
アクション
名前
説明
子: なし
GetStatusResponse
コンテナ.
型: 文字列
先祖: なし
子: GetStatusResult (p. 108)
GetStatusResult
コンテナ.
型: 文字列
先祖: GetStatusResponse (p. 108)
子: Carrier (p. 107) | CreationDate (p. 107) | ErrorCount (p. 108)
| JobId (p. 104) | JobType (p. 108) | LocationCode (p. 109) |
LocationMessage (p. 109) | LogBucket (p. 109) | LogKey (p. 109)
| ProgressCode (p. 109) | ProgressMessage (p. 109) |
Signature (p. 104) | TrackingNumber (p. 110)
ErrorCount
エラーの数。この値は、ProgressCode が Success または
SuccessWithErrors の場合に返されます。
タイプ: 整数
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
子: なし
JobId
AWS Import/Export によって作成された、ステータスを取得するジョブの
一意な識別子。
型: 文字列
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
子: なし
JobType
ジョブがインポートジョブであるかエクスポートジョブであるかを指定し
ます。
型: 文字列
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
子: なし
108
AWS Import/Export 開発者ガイド
アクション
名前
説明
LocationCode
ストレージデバイスの場所を表すトークン。例: AtAWS。詳細について
は、「デバイス所在地のステータスコード (p. 124)」を参照してくださ
い。
タイプ: Enum
有効な値: AtAWS | NotReceived | Returned
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
子: なし
LocationMessage
ストレージデバイスの物理的な場所について説明する、人が読み取り可能
なメッセージ。
型: 文字列
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
子: なし
LogBucket
ユーザーログ用の Amazon S3 バケット。
タイプ: 文字列 (63 バイト)
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
子: なし
LogKey
ユーザーログが保存されたキー。
タイプ: 文字列 (1024 バイト)
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
子: なし
ProgressCode
ジョブの状態を表すトークン。例: Started。詳細については、「ジョブ
進行のステータスコード (p. 124)」を参照してください。
タイプ: Enum
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
子: なし
ProgressMessage
より人が読んで理解しやすいジョブのステータス。
型: 文字列
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
子: なし
109
AWS Import/Export 開発者ガイド
アクション
名前
説明
RequestId
リクエストを一意に識別する文字列。
型: 文字列
先祖: GetStatusResponse (p. 108)
子: なし
ResponseMetadata
コンテナ.
型: 文字列
先祖: GetStatusResponse (p. 108)
子: RequestId (p. 101)
署名
リクエストとレスポンスを認証するために使用される暗号化されたコー
ド。例: DV+TpDfx1/TdSE9ktyK9k/bDTVI=。独自に署名を作成する場合に
のみ、この値を使用します。
型: 文字列
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
子: なし
SignatureFileContents
ディスクに書き込まれる SIGNATURE ファイルの実際のテキスト。例:
version:2.0
signingMethod:HmacSHA1
jobId:<the customer's job ID>
signature:DV+TpDfx1/TdSE9ktyK9k/bDTVI=
型: 文字列
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
TrackingNumber
返送時に AWS Import/Export によってストレージデバイスに割り当てら
れた配送追跡番号。この値は、LocationCode が Returned の場合に返さ
れます。
タイプ: 文字列 (32 バイト)
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
子: なし
WarningMessage
互換性のない Amazon S3 バケット名の使用など、ジョブの致命的ではな
い問題を通知する任意のメッセージ。
型: 文字列
先祖: GetStatusResponse (p. 108).GetStatusResult (p. 108)
エラー
一般的なエラーのリストは、エラーとステータスコード (p. 122)を参照してください。
110
AWS Import/Export 開発者ガイド
アクション
例
リクエスト例
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:207
Action=GetStatus&SignatureMethod=HmacSHA256&JobId=JOBID&SignatureVersion=2&Version=2010-06-01&Signature
%2FVfkltRBOoSUi1sWxRzN8rw%3D&Timestamp=2011-06-20T22%3A30%3A59.556Z
レスポンス例
<GetStatusResponse xmlns="http://importexport.amazonaws.com/">
<GetStatusResult>
<JobType>Import</JobType>
<CurrentManifest>manifestVersion: 2.0
deviceId: TestDevice1
bucket: myawsbucket
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
eraseDevice: yes<
/CurrentManifest>
<JobId>A36BC</JobId>
<LocationMessage>AWS has not received your device.</LocationDescription>
<ProgressCode>Pending</ProgressCode>
<SignatureFileContents>version:2.0
signingMethod:HmacSHA1
jobId:A36BC
signature:O8WnNGMfs6cwbpQHvJ0qXLrUdqI=
</SignatureFileContents>
<ErrorCount>0</ErrorCount>
<ProgressMessage>The specified job has not started.</ProgressDescription>
<LocationCode>NotReceived</LocationCode>
<CreationDate>2010-04-17T00:09:02Z</CreationDate>
<AwsShippingAddress>AWS Import/Export
JOBID A36BC
1111 Nosuch Ave South
Seattle, WA 92222</AwsShippingAddress>
<Signature>O8WnNGMfs6cwbpQHvJ0qXLrUdqI=</Signature>
</GetStatusResult>
<ResponseMetadata>
<RequestId>a5f302fa-4bd8-11df-b17e-6b34e254a573</RequestId>
</ResponseMetadata>
</GetStatusResponse>
関連アクション
以下のアクションは GetStatus に関連しています。
• ListJobs
111
AWS Import/Export 開発者ガイド
アクション
ListJobs
説明
このアクションは、リクエスタに関連付けられたジョブを返します。AWS Import/Export によって、作成
日に基づいて日付が新しい順にジョブが一覧表示されます。たとえば、ジョブ Test1 が 2009 年 12 月 30
日に作成され、Test2 が 2010 年 2 月 05 日に作成された場合、ListJobs アクションでは Test2 の次に
Test1 を返します。
リクエストパラメータ
すべてのアクションに共通のパラメーターの詳細については、「共通のクエリパラメーター (p. 121)」を
参照してください。
名前
説明
必須
アクション
実行するアクションを指定します。
はい
型: 文字列
デフォルト: なし
有効な値: ListJobs
Marker
JOBID を指定してアカウントで作成したジョブを一覧表示する際の開
始位置を指定します。「MaxJobs」を参照してください。
いいえ
型: 文字列
デフォルト: なし
制限: 有効なジョブ ID であること
MaxJobs
レスポンスで返されるジョブの最大数を設定します。MaxJobs
を超過したため返されないジョブがある場合は、レスポンスに
<IsTruncated>true</IsTruncated> が含まれます。さらにジョブを返す
には、Marker を参照してください。
いいえ
型: 文字列
デフォルト: なし
制限: 0 ~ 1000 の間の整数であること
レスポンス要素
名前
説明
CreationDate
ISO8601 日付形式の CreateJob リクエストのタイムスタンプ。たとえ
ば、2010-03-28T20:27:35Z のように指定します。詳細については、「ISO
8601」を参照してください。
型: 文字列
先祖: ListJobsResponse.ListJobsResult.Jobs.member
IsCanceled
ジョブがキャンセルされたかどうかを示します。
型: 文字列
112
AWS Import/Export 開発者ガイド
アクション
名前
説明
有効な値: true | false
先祖: ListJobsResponse.ListJobsResult.Jobs.member
IsTruncated
ジョブのリストが切り捨てられたかどうかを示します。true の場合は、最
後の JobId エレメントをマーカーとして使用してもう一度 ListJobs を呼
び出します。
型: 文字列
有効な値: true | false
先祖: ListJobsResponse.ListJobsResult.Jobs.member
JobId
AWS Import/Export ジョブを一意に識別する、AWS によって生成される
ID。
型: 文字列
先祖: ListJobsResponse.ListJobsResult.Jobs.member
ジョブ
すべてのジョブのコンテナ。
タイプ: なし
先祖: ListJobsResponse.ListJobsResult
Children: member、IsTruncated
JobType
ジョブがインポートジョブであるかエクスポートジョブであるかを指定し
ます。
型: 文字列
先祖: ListJobsResponse.ListJobsResult.Jobs.member
ListJobsResponse
レスポンスのコンテナ。
タイプ: なし
先祖: なし
子: ListJobsResult、応答メタデータ
ListJobsResult
ジョブのコンテナ。
タイプ: なし
先祖: ListJobsResponse
子: ジョブ
member
ジョブ情報のコンテナ。
タイプ: なし
先祖: ListJobsResponse.ListJobsResult.Jobs
子: creationDate、JobId、IsCanceled
113
AWS Import/Export 開発者ガイド
アクション
名前
説明
RequestId
ListJobs リクエストを一意に識別する、AWS によって生成される ID。
型: 文字列
先祖: ListJobsResponse.ListJobsResult.ResponseMetadata
ResponseMetadata
RequestId のコンテナ。
タイプ: なし
先祖: ListJobsResponse.ListJobsResult
子: RequestId
エラー
一般的なエラーのリストは、エラーとステータスコード (p. 122)を参照してください。
例
リクエスト例
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:206
Action=ListJobs&MaxJobs=25&SignatureMethod=HmacSHA256
&SignatureVersion=2&Version=2010-06-01&Signature=%2FVfkltRBOoSUi1sWxRzN8rw%3D
&Timestamp=2011-06-18T02%3A29%3A39.202Z
レスポンス例
<ListJobsResponse xmlns="http://importexport.amazonaws.com/">
<ListJobsResult>
<Jobs>
<member>
<JobType>Import</JobType>
<CreationDate>2010-04-21T22:21:51Z</CreationDate>
<IsCanceled>false</IsCanceled>
<JobId>ADP7B</JobId>
</member>
<member>
<JobType>Import</JobType>
<CreationDate>2010-04-21T22:19:05Z</CreationDate>
<IsCanceled>false</IsCanceled>
<JobId>AVEYF</JobId>
</member>
</Jobs>
<IsTruncated>true</IsTruncated>
</ListJobsResult>
<ResponseMetadata>
<RequestId>cc6ea8c0-4da9-11df-81c3-e94d3ca214a8</RequestId>
</ResponseMetadata>
</ListJobsResponse>
114
AWS Import/Export 開発者ガイド
アクション
関連アクション
以下のアクションは ListJobs に関連しています。
• GetStatus (p. 107)
115
AWS Import/Export 開発者ガイド
アクション
UpdateJob
説明
このアクションを使用して、新しいマニフェストファイルを提供し元のマニフェストファイルで指定さ
れているパラメーターを変更できます。このリクエストに添付されたマニフェストファイルは、元のマニ
フェストファイルを置き換えます。このアクションは CreateJob リクエストの後、データ転送が開始され
る前にのみ使用できます。また、自分が所有するジョブのみに使用できます。
リクエストパラメータ
すべてのアクションに共通のパラメーターの詳細については、「共通のクエリパラメーター (p. 121)」を
参照してください。
名前
説明
必須
アクション
実行するアクションを指定します。
はい
型: 文字列
デフォルト: なし
有効な値: UpdateJob
JobId
更新するジョブを指定する識別子。
はい
型: 文字列
デフォルト: なし
制限: 作成したジョブの有効なジョブ ID であること。
JobType
インポートジョブまたはエクスポートジョブを指定します。
はい
型: 文字列
デフォルト: なし
有効な値: Import | Export
マニフェスト
マニフェストファイルの UTF-8 でエンコードされたテキスト。詳細に
ついては、「マニフェストファイルのパラメーター (p. 69)」を参照し
てください。
型: 文字列
デフォルト: なし
レスポンス要素
名前
説明
RequestId
リクエストを一意に識別する ID。
型: 文字列
先祖: UpdateJobResponse (p. 117).ResponseMetadata (p. 117)
子: なし
116
はい
AWS Import/Export 開発者ガイド
アクション
名前
説明
ResponseMetadata
コンテナ.
タイプ: なし
先祖: UpdateJobResponse (p. 117)
子: RequestId (p. 101)
Success
AWS Import/Export によるジョブの更新が (true) か否 (false) かを指定し
ます。
タイプ: ブール値
有効な値: true | false
先祖: UpdateJobResponse (p. 117).UpdateJobResult (p. 117)
UpdateJobResponse
レスポンスのコンテナ。
タイプ: なし
先祖: なし
子: UpdateJobResult (p. 117)、ResponseMetadata (p. 117)
UpdateJobResult
コンテナ.
タイプ: なし
先祖: UpdateJobResponse (p. 117)
子: Success (p. 102)
WarningMessage
互換性のない Amazon S3 バケット名の使用など、ジョブの致命的ではな
い問題を通知する任意のメッセージ。
型: 文字列
先祖: UpdateJobResponse (p. 117)
エラー
一般的なエラーのリストは、エラーとステータスコード (p. 122)を参照してください。
例
リクエスト例
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:625
JobType=Import&Manifest=manifestVersion%3A%201.0%0Abucket%
3A%20XYZ%0AreturnAddress%3A%0A%20%20%20%20name
%3A%20Amazon.com%20ATTN%20Joe%20Random%20%0A%20%20%20%20street1%3A%201200%11111%20Nosuch
%20Ave
%20S.%0A%20%20%20%20city%3A%20Seattle%0A%20%20%20%20stateOrProvince%3A%20WA%0A%20%20%20%20
117
AWS Import/Export 開発者ガイド
アクション
postalCode%3A%2098114%0A%20%20%20%20phoneNumber%3A%20206-266-0000%0A%20%20%20%20country%3A
%20USA
%0AsetContentEncodingForGzFiles%3A%20yes%0Aexpires%3A%20tomorrow%0AcontentLanguage%3A
%20Spanish
%0Aacl%3A%20public-read%0AcacheControl%3A%20max-age
%3D3600&Action=UpdateJob&SignatureMethod=HmacSHA256
&JobId=JOBID&SignatureVersion=2
&Version=2010-06-01Signature=%2FVfkltRBOoSUi1sWxRzN8rw
%3D&Timestamp=2011-06-21T00%3A28%3A12.023Z
レスポンス例
<UpdateJobResponse xmlns="http://importexport.amazonaws.com/">
<UpdateJobResult>
<Success>true</Success>
</UpdateJobResult>
<ResponseMetadata>
<RequestId>12144cd2-0adb-11df-a381-155bec6f7c93</RequestId>
</ResponseMetadata>
</UpdateJobResponse>
関連アクション
以下のアクションは UpdateJob に関連しています。
• CreateJob (p. 103)
118
AWS Import/Export 開発者ガイド
アクション
GetShippingLabel
説明
この操作は、処理のために AWS にデバイスを発送する際に使用する前払い配送ラベルを生成します。
リクエストパラメータ
すべてのアクションに共通のパラメーターの詳細については、「共通のクエリパラメーター (p. 121)」を
参照してください。
名前
説明
必須
アクション
実行するアクションを指定します。
はい
型: 文字列
デフォルト: なし
有効な値: GetShippingLabel
JobID
同じパッケージで配送されるジョブを指定します。1 つの
GetShippingLabel アクションに 8 を超えるジョブを指定することはで
きません。
はい
タイプ: カンマ区切り文字列
デフォルト: なし
有効な値: 有効なジョブ ID
name
パッケージを送付するユーザーの名前。
はい
型: 文字列
デフォルト: なし
company
パッケージを送付する企業の名前。
はい
型: 文字列
デフォルト: None
phoneNumber
有効な連絡先電話番号。
はい
型: 文字列
デフォルト: None
stateOrProvince
パッケージの発送元の州または地域の名前。米国とカナダで必須で
す。
はい
型: 文字列
デフォルト: None
city
発送元の市の名前。
はい
型: 文字列
デフォルト: None
119
AWS Import/Export 開発者ガイド
アクション
名前
説明
必須
postalCode
パッケージの発送元の郵便番号。
はい
型: 文字列
デフォルト: None
street1
パッケージの発送元の住所。
はい
型: 文字列
デフォルト: None
street2
パッケージの発送元の住所の続き。
いいえ
型: 文字列
デフォルト: None
street3
パッケージの発送元の住所の続き。
いいえ
型: 文字列
デフォルト: None
レスポンス要素
名前
説明
ShippingLabelURL
あらかじめ印刷されたラベルの URL。返された URL のリンク先 PDF
ファイルをダウンロード、印刷して、配送するデバイスのパッケージに
添付してください。
型: 文字列
エラー
一般的なエラーのリストは、エラーとステータスコード (p. 122)を参照してください。
例
リクエスト例
POST / HTTP/1.1
content-type:application/x-www-form-urlencoded;charset=utf-8
host: https://importexport.amazonaws.com
content-length:639
JobIDs=ABC12%2CBCD23%2CCDE34&name=Joe%20User&company=MyCo%20Incorporated&phoneNumber=
%28123%29%20456%2D7890&country=USA&stateOrProvince=WA&city=Seattle&postalCode=98123&street1=1234%20Main
%20St%2E&street2=Suite%20101&Action=GetShippingLabel&SignatureMethod=HmacSHA256
&SignatureVersion=2&Version=2010-06-01
&Signature=%2F5UvjcJOE1PqUa%2BcmnzadQYs2frTAt8LSo3M5o%2BEH0%3D&Timestamp=
2011-06-20T18%3A49%3A14.981Z
120
AWS Import/Export 開発者ガイド
共通のクエリパラメーター
レスポンス例
<GetShippingLabelResponse xmlns="http://importexport.amazonaws.com/">
<GetShippingLabelResult>
<ShippingLabelURL>https://s3.amazonaws.com/logbucket/shippinglabel.ABC12.BCD23.CDE34.pdf</ShippingLabelURL>
<Signature>O3qG7xnI46ZEm9gi+eOy9dnSS9k=</Signature>
</GetShippingLabelResult>
<ResponseMetadata>
<RequestId>ace8cb5b-0ada-11df-a381-155bec6f7c93</RequestId>
</ResponseMetadata>
</GetShippingLabelResponse>
関連アクション
以下のアクションは GetShippingLabel に関連しています。
• CreateJob (p. 103)
共通のクエリパラメーター
このセクションでは、すべての AWS Import/Export Disk アクションが使用するリクエストパラメーターを
列挙します。アクション固有のパラメータは、そのアクションのトピックで示されています。
名前
説明
必須
アクション
実行すべきアクション詳細な一覧については、「アクション (p. 100)」 はい
を参照してください。
型: 文字列
デフォルト: なし
有効な値: CancelJob | CreateJob | GetStatus | ListJobs | UpdateJob
AWSAccessKeyId
accessKeyId オプションは廃止されました。下位互換性のためにのみ
保持されています。accessKeyId を新しい AWS Import/Export ジョブ
いいえ
で使用しないでください。
署名
リクエストのために作成したデジタル署名。詳細については、「Query はい
認証 (p. 98)」を参照してください。
デフォルト: なし
型: 文字列
SignatureMethod
リクエストの署名を作成するのに使用したハッシュアルゴリズム。
はい
デフォルト: なし
型: 文字列
有効な値: HmacSHA256 | HmacSHA1
SignatureVersion
リクエストに署名するときに使用する署名バージョン。この値を 2 ま
たは 3 に設定します。
デフォルト: なし
タイプ: 文字列
121
はい
AWS Import/Export 開発者ガイド
エラーとステータスコード
名前
説明
必須
有効な値: 2|3
タイムスタンプ
リクエストが署名された日付と時刻。ISO 8601 標準で指定されている
YYYY-MM-DDThh:mm:ss.SSSZ 形式です。
はい
デフォルト: なし
型: 文字列
バージョン
使用する API バージョン。YYYY-MM-DD 形式です。
はい
デフォルト: なし
型: 文字列
エラーとステータスコード
このセクションでは、AWS Import/Export Disk のすべてのエラー、ジョブ、およびデバイスのステータス
コード、およびログファイルに含まれる可能性があるステータスコードについて説明します。
トピック
• エラーレスポンス (p. 122)
• エラーコード (p. 122)
• ジョブとデバイスのステータスコード (p. 123)
• Disk ログステータスコード (p. 125)
エラーレスポンス
以下は、ウェブサービスオペレーションを使用する場合のエラーレスポンスの形式です。
<ErrorResponse xmlns="http://importexport.amazonaws.com/">
<Error>
<Type>Sender</Type>
<Code>ExceptionCode</Code>
<Message>ExceptionMessage</Message>
</Error>
<RequestId>a1f5a4c6-0adb-11df-a381-155bec6f7c93</RequestId>
</ErrorResponse>
エラーコード
ウェブサービスオペレーションを使用する際に発生する可能性があるエラーには、さまざまなものがあり
ます。次の表で、これらのエラーコードについて説明します。
コード
説明
HTTP
コード
BucketPermissionException
指定されたアカウントにバケットへの適切なアクセス
権限がありません。
400
CanceledJobIdException
指定されたジョブ ID はキャンセルされ、すでに有効
ではありません。
400
122
AWS Import/Export 開発者ガイド
エラーとステータスコード
コード
説明
HTTP
コード
ExpiredJobIdException
指定されたジョブ ID の有効期限が切れています。
400
InvalidAddressException
マニフェストに指定された住所が無効です。
400
InvalidClientTokenIdException
AWS アクセスキーが存在しません。
403
InvalidCustomsException
1 つ以上のカスタムパラメーターが無効です。修正し
て再送信してください。
400
InvalidFileSystemException
エクスポートマニフェストで指定されたファイルシス
テムが無効です。
400
InvalidJobIdException
JOBID が欠落しているか、見つからないか、または
400
InvalidManifestFieldException
1 つ以上のマニフェストフィールドが無効です。修正
して再送信してください。
400
InvalidParameterException
無効なパラメーターの記述です。
400
MalformedManifestException
マニフェストの形式が正しくありません。
400
MissingCustomsException
1 つ以上の必須カスタムパラメーターがマニフェスト
から欠落しています。
400
MissingManifestFieldException
1 つ以上のフィールドがマニフェストファイルから欠
落しています。修正して再送信してください。
400
MissingParameterException
1 つ以上の必須パラメーターがリクエストから欠落し
ています。
400
MultipleRegionsException
マニフェストファイルに複数のリージョンからのバ
ケットが含まれています。ジョブは 1 つのリージョン
のバケットに限定されます。修正して再送信してくだ
さい。
400
NoSuchBucketException
指定されたバケットが存在しません。指定さ
れたバケットを作成するか、マニフェストの
bucket、exportBucket または logBucket フィールド
を、認証情報ファイルで指定されたアカウントが書き
込み権限を持っているバケットに変更します。
400
OptInRequired
AWS アカウントに AWS Import/Export サービスに対
するサブスクリプションが必要です。
403
UnableToCancelJobIdException
Disk がジョブをキャンセルできません。
409
UnknownOperationException
指定されたオペレーションは無効です。
403
AWS アカウントに関連付けられていません。
ジョブとデバイスのステータスコード
トピック
• デバイス所在地のステータスコード (p. 124)
• ジョブの進行状況のステータスコード (p. 124)
123
AWS Import/Export 開発者ガイド
エラーとステータスコード
各 Disk ジョブには、デバイスの場所のステータスとジョブの進行状況のステータスの両方があります。デ
バイスの場所のステータスは、AWS に郵送したストレージデバイスの場所に関する詳細を提供します。
ジョブの進行状況コードでは、データ転送の状態を反映しています。たとえば、ストレージデバイスが到
着したときは、ステータスは Pending です。データ転送時のステータスは InProgress、データ転送が正
常に完了するとステータスは Success になります。
デバイス所在地のステータスコード
次の表は、デバイス所在地のステータスコードについての説明です。
コード
説明
AtAWS
デバイスは AWS にあります。
NotReceived
AWS はデバイスを受領していません。
Returned
デバイスは返送されました。SHIPPER 追跡番号は、TRACKING_NUMBER です。
ジョブの進行状況のステータスコード
次の表は、ジョブの進行状況のステータスコードについての説明です。
コード
説明
キャンセル済み
ジョブがキャンセルされました。
完了
データは正常にロードされました。ログは、バケット LOG_BUCKET の
LOG_KEY に保存されています。
DeviceError
ジョブは中止されました。デバイスが正常に機能しませんでした。
Expired
ジョブが期限切れになりました。
InProgress
デバイスのデータは現在ロードされています。
InvalidSignature
ジョブは中止されました。SIGNATURE ファイルが無効です。
MissingDevice
ジョブは中止されました。デバイス、電源、またはデバイスコネク
ターが見つかりませんでした。
MissingSignature
ジョブは中止されました。SIGNATURE ファイルが見つかりません
でした。
Pending
指定されたジョブは開始されていません。
SuccessWithErrors
データのロードはエラー NUMBER 個で完了しました。詳細は、バケッ
ト LOG_BUCKET の LOG_KEY を参照してください。
UnsupportedDeviceType
ジョブは中止されました。Disk では、USB2 または eSATA コネク
タータイプ、または 2.5" または 3.5" SATA ハードドライブが必要で
す。
UnsupportedFileFormat
ジョブは中止されました。サポートされるファイルタイプの詳細に
ついては、「ガイドラインおよび制限 (p. 125)」を参照してくださ
い。
UnsupportedPowerSupply
ジョブは中止されました。米国東部(バージニア北部) バケットで
の AWS Import/Export には、120 V 60 Hz 対応の電源が必要です。
欧州のバケットには、ユーロプラグ (C コネクターまたは D コネク
124
AWS Import/Export 開発者ガイド
ガイドラインおよび制限
コード
説明
ター) または英国式プラグ (BS1363) の 230 V、50 Hz 対応の電源が
必要です。シンガポールのバケットには、230 V、50 Hz 対応の電源
が必要です。
Disk ログステータスコード
次の表は、Disk ステータスコードの説明です。
コード
ステータス
説明
AccessDenied
403 Forbidden
アクセスが拒否されました. IAM アカウントにオブジェクトの読
み取りアクセス権限がありません。
DiskFull
499
ディスクがいっぱいです。これ以上このディスクにファイルを書
き込むことができません。
DirectoryFull
301
Remapped
現在のディレクトリがいっぱいです。これ以上このロケーション
にファイルを書き込むことができません。ファイルは復旧ディレ
クトリに保存されました。
FilenameTooLong
301
Remapped
リクエストされたバケット + プレフィックス + キーのパスが、
ターゲットのファイルシステムのファイル名の最大長を超えてい
ます。
FileTooLarge
413 Request
Entity Too
Large
リクエストされたオブジェクトは、ターゲットのファイルシステ
ムの最大ファイルサイズよりも大きいサイズです。
Ignored
103
ファイルがマニフェストの無視フィルタに一致しました。
InvalidFilename
301
Remapped
リクエストされたキー名はターゲットのファイルシステムで無効
です。ファイルは復旧ディレクトリに保存されました。
InvalidSubstitution
400
指定された substitutions マニフェストオプションにより、無
効なオブジェクト名が発生しました。
MovedPermanently
301
Remapped
名前の競合のため、オブジェクトが別のロケーションに移動され
ました。変更がログに記録されました。
OK
200
Success.
ReadError
508 Device
Error
ディスクから指定ファイルを読み取ることができません。
UnableToWrite
508 Device
Error
ストレージデバイスにデータを書き込むことができません。
ガイドラインおよび制限
以下のセクションでは、AWS Import/Export サービスを使用する際のガイドラインを提供し、制限につい
て説明します。これらの制限がお客様のユースケースに大きく関わる場合は、AWS サポートセンターまで
詳細をお問い合わせください。
• AWS Import/Export はデータをインポートする場合のサーバー側の暗号化 (SSE) をサポートしていませ
ん。
125
AWS Import/Export 開発者ガイド
ガイドラインおよび制限
• AWS Import/Export ステーションの 1 つにストレージデバイスを接続するには、デバイスが次の条件を
満たす必要があります。
• デバイスが Red Hat Linux と互換性があり、製造元によって Linux の eSATA、USB 3.0、または USB
2.0 インターフェイスをサポートすることが保証されている。
• 最大デバイスサイズは、高さ 14 インチ/35 cm x 幅 19 インチ/48 cm x 奥行 36 インチ/91 cm (標準 19
インチ/48 cm ラックで 8U) です。
• 最大重量は 50 ポンド / 22.5 キログラムです。
• インポートする単一のファイルまたはオブジェクトのファイルサイズが最大 5 TB である。5 TB を超
えるファイルおよびオブジェクトはインポートされません。サイズが大きすぎるファイルはインポー
トジョブログファイルにリストされます。
• デバイスの最大容量は Amazon Simple Storage Service (Amazon S3) および Amazon EBS ジョブの場
合は 16 TB です。
• デバイスの最大容量は Amazon Glacier ジョブの場合は 4 TB です。
• 能力要件はリージョンによって異なります。詳細については、「AWS Import/Export 製品の詳細」
ページの「ストレージデバイスの選択」セクションを参照してください。
• 1 日につき最大 50 個のジョブを作成できます。ジョブを 50 個以上の作成する必要がある場合は、アカ
ウントマネージャーまたは AWS サポートセンターにお問い合わせください。
• 配送するデバイスはパッケージごとに 1 つのみにしてください。AWS Import/Export では、特別な梱包
要件を満たす特定のデバイスの場合のみ、1 回の配送で複数のデバイスを受け付けます。詳細について
は、「複数デバイスの配送 (p. 64)」を参照してください。
• AWS Import/Export サービスでは私書箱への配送は行っていません。
• 緊急配送は、米国のデータ読み込み施設から米国内の住所への返送の場合のみ可能です。
• AWS Import/Export は、バージョニングがオンになっている Amazon S3 バケットから最新のバージョン
のみをエクスポートします。
• Amazon DevPay バケットおよびアカウントはサポートされていません。AWS Import/Export を使用する
ときは、AWS アカウント認証情報および DevPay ではないバケットを使用する必要があります。
• デバイスは正常である必要があります。不良セクターが含まれていたり、電源が不安定なデバイスを使
用すると、インポートやエクスポートが一部のみになる可能性があります。極端なケースでは、イン
ポートやエクスポートが実行できず、AWS Import/Export によってデバイスが破壊される恐れがありま
す。詳細については、「失敗したジョブ (p. 69)」を参照してください。
• Amazon S3 インポートジョブは、以下のファイルシステムをサポートします。
• NTFS
• EXT2
• EXT3
• EXT4
• FAT32
• HFSPlus
• exFAT
• Amazon S3 へのインポートジョブファイル名には UTF-8 文字エンコーディングを使用する必要があり
ます。有効な UTF-8 文字列以外の名前がついたファイルはインポートされません。
• サイズが 4TB 以下のデバイスからのみ、Amazon Glacier のインポートを実行できます。4TB を超
えるものを Amazon Glacier にインポートする必要がある場合は、Amazon S3 インポートを使用
し、Amazon S3 ライフサイクルポリシーを使用してオブジェクトを Amazon Glacier にアーカイブする
方法を検討してください。
• Amazon S3 エクスポートジョブは、以下のファイルシステムをサポートします。
• NTFS
• EXT4
• Amazon S3 エクスポートを使用する場合、ファイルシステムの制限により、異なるファイル名にエクス
ポートする際にオブジェクトが再マッピングされる場合があります。ファイル名が再マップされる理由
には以下のようなものがあります。
126
AWS Import/Export 開発者ガイド
AWS Import/Export Disk 機能付録
• ソース Amazon S3 オブジェクトのキー名が UTF-8 ではない。
• Amazon S3 ソースに同じファイル名を指す複数のオブジェクトキー名がある (例: folder1/file1 と
folder1/folder2/../file1)
• 1 つのディレクトリに存在するファイルが多すぎる。
ジョブでファイルが再マップされたかどうかを確認するには、ログバケットにアップロードされたエク
スポートログを調べます。
• インポートジョブが失敗した場合、デバイスは消去されお客様に返却されます。エクスポートジョブが
失敗した場合、デバイスはお客様に返却されます。詳細については、「失敗したジョブ (p. 69)」を参照
してください。
AWS Import/Export Disk 機能付録
この AWS Import/Export ガイドの付録には以下のセクションがあります。
トピック
• 付録 A: その他のツールとサービス (p. 127)
• 付録 B: 例 (p. 127)
• 付録 C: MIME タイプのファイル拡張子 (p. 135)
• 付録 D: Disk リソース (p. 135)
付録 A: その他のツールとサービス
AWS Import/Export ウェブサービスツールや AWS SDK の他にも、AWS Import/Export の実行に使用で
きるサードパーティーツールやサービスが数多くあります。詳細については、http://aws.amazon.com/
importexport/tools/ を参照してください。
付録 B: 例
トピック
• インポートの例 (p. 127)
• エクスポートの例 (p. 132)
インポートの例
このセクションでは、3 つのサンプル Disk ジョブについて解説し、マニフェストファイルの対応する署名
およびログファイルを示します。これらの例では、以下のファイルがストレージデバイスのルートディレ
クトリにあります。生成されたログファイルで、マニフェストのフィールドがデータのロードにどのよう
に影響するかが判ります。
Note
これらの例は Amazon Glacier には適用されません。Amazon Glacier では、デバイスのコンテン
ツ全体を 1 つのアーカイブにインポートします。
• /README
• /NOTICE.txt
127
AWS Import/Export 開発者ガイド
付録 B: 例
• /images/wookie1.jpg
• /images/chewie.gif
• /images/chewie.tif
• /images/resources/chewie.psd
以下のセクションでは、Disk ジョブを作成するいくつかの方法を示します。
例 – TSTD1
TSTD1 の例では、最小限の構成オプションのマニフェストファイルを使用したデフォルトの動作を示しま
す。ジョブ TSTD1 に関連付けられるサンプルファイルは次のとおりです。
• manifest-TSTD1.txt
• import-log-TSTD1.csv
以下は、manifest-TSTD1.txt ファイルの内容です。
manifestVersion: 2.0
bucket: myawsbucket
deviceId: 3QD0T87T
pinCode:4321
eraseDevice: Yes
notificationEmail: [email protected];[email protected]
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
Important
返送先住所は、UPS が配達可能な実在の場所である必要があります。
TSTD1 ログファイル
Disk でこのジョブを処理した後、サービスによって結果ログファイルが http://s3.amazonaws.com/
myawsbucket/import-log-TSTD1 に保存されます。ログファイルの内容を次の表に示します。
DateTime ファイル
ステー
タス
コード
Tue 03
SIGNATURE
Feb
2009
21:57:43
GMT
103
Tue 03
Notice.txt
Feb
2009
21:57:43
GMT
200
キー
MD5
Bytes ContentType
Ignored 90
text/plain
OK
f60fe317bc4
97b1204b327094
959eb64
13
text/plain
myawsbucket/
Notice.txt
128
AWS Import/Export 開発者ガイド
付録 B: 例
DateTime ファイル
ステー
タス
コード
キー
MD5
Bytes ContentType
Tue 03
README.txt
Feb
2009
21:57:43
GMT
200
OK
myawsbucket/
README.txt
d5a46fa2259
6d2464eff10bab
b19000e
13
text/plain
Tue 03
images/
Feb
wookie1.jpg
2009
21:57:43
GMT
200
OK
myawsbucket/
images/
wookie1.jpb
ccac0d031603
ff1c2994e07703
a64845
447
image/
jpeg
Tue 03
images/
Feb
chewie.GIF
2009
21:57:43
GMT
200
OK
myawsbucket/
images/
chewie.GIF
5fc22dc594e
0c5929c090b958
5ba9e70
848
image/gif
Tue 03
images/
Feb
resources/
2009
chewie.psd
21:57:43
GMT
200
OK
myawsbucket/
images/resources/
chewie.psd
130b64d171
e9bbc2a8dbe117
f189796c
524
application/
octetstream
Tue 03
images/
Feb
chewie.TIF
2009
21:57:43
GMT
200
OK
myawsbucket/
823d17b0
images/chewie.TIF 5321b968e01f917
4e3dcace7
738
image/tiff
例 – TSTD2
TSTD2 の例では、次のマニフェストフィールドの追加に関連した動作を示しています。
acl、prefix、logPrefix を TSTD1 で使用したマニフェストファイルに追加。ジョブ TSTD2 に関連付け
られるサンプルファイルは次のとおりです。
• manifest-TSTD2.txt
• import-log-TSTD2.csv
次のテキストは、manifest-TSTD2.txt の内容です。
manifestVersion: 2.0
bucket: myawsbucket
deviceId: eQD0T87T
pinCode:4321
eraseDevice: Yes
notificationEmail: [email protected];[email protected]
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
129
AWS Import/Export 開発者ガイド
付録 B: 例
country: USA
acl: public-read
prefix: images/
logPrefix: loadlogs-
TSTD2 ログファイル
Disk でこのジョブを処理した後、サービスによって結果ログファイルが http://s3.amazonaws.com/
myawsbucket/import-log-TSTD2 に保存されます。ログファイルの内容を次の表に示します。
DateTime
ファイル
ステー コー
タス
ド
Tue 03 Feb
200921:57:43
GMT
SIGNATURE 103
Tue 03 Feb
200921:57:43
GMT
Notice.txt
キー
MD5
Bytes ContentType
Ignored 90
200
OK
myawsbucket/
images/
Notice.txt
f60fe317bc497
b12004b3270
94959eb64
13
text/plain
Tue 03 Feb
200921:57:43
GMT
README.txt 200
OK
myawsbucket/
images/
README.txt
d5a46fa22
13
596d2464eff10ba
bb19000e
text/plain
Tue 03 Feb
200921:57:43
GMT
images/
wookie1.jpg
200
OK
myawsbucket/
images/images/
wookie1.jpg
ccac0d031603
ff1c94e0770
3a64845
image/
jpeg
Tue 03 Feb
200921:57:43
GMT
images/
chewie.GIF
200
OK
myawsbucket/
images/images/
chewie.GIF
5f22dc594
846
e0c592929c090b9
585ba9e70
image/gif
Tue 03 Feb
200921:57:43
GMT
images/
resources/
chewie.psd
200
OK
myawsbucket/
images/images/
resourceschewie.psd
130b64d17
1e9bbc28dbe11
7f189796c
590
application/
octetstream
Tue 03 Feb
200921:57:43
GMT
images/
chewie.TIF
200
OK
myawsbucket/
images/images/
chewie.TIF
823d17b0
5321b968e01f91
74e3dcace7
734
image/tiff
444
例 – TSTD3
TSTD3 のロード例では、次のマニフェストフィールドの動作を示します。 acl, contentTypes, prefix,
および ignore。ジョブ TSTD3 に関連付けられるサンプルファイルは次のとおりです。
• manifest-TSTD3.txt
• import-log-TSTD3.csv
次のテキストは、manifest-TSTD3.txt ファイルの内容です。
manifestVersion: 2.0
bucket: myawsbucket
deviceId: 3QD0T87T
pinCode:4321
eraseDevice: Yes
130
AWS Import/Export 開発者ガイド
付録 B: 例
notificationEmail: [email protected];[email protected]
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
acl: public-read
prefix: dropoff
contentTypes:
jpg: application/octet-stream
gif: application/octet-stream
tif: application/octet-stream
txt: text/html
ignore:
- \.psd$
TSTD3 ログファイル
Disk でこのジョブを処理した後、サービスによって結果ログファイルが http://s3.amazonaws.com/
myawsbucket/import-log-TSTD3 に保存されます。ログファイルの内容を次の表に示します。
DateTime
ファイル
ステー コー
タス
ド
Tue 03 Feb
200921:57:43
GMT
SIGNATURE 103
Tue 03 Feb
200921:57:43
GMT
Notice.txt
キー
MD5
Bytes ContentType
Ignored 90
200
OK
myawsbucket/
dropoffNotice.txt
386317bc4
97b1202709
4959eb64
13
text/html
Tue 03 Feb
200921:57:43
GMT
README.txt 200
OK
myawsbucket/
4686fa225
dropoffREADME. 96d2464e0b
txt
abb19000e
13
text/html
Tue 03 Feb
200921:57:43
GMT
images/
wookie1.jpg
200
OK
myawsbucket/
dropoffimages/
wookie1.jpg
586d0316
03ff1c299770
3a64845
449
application/
octetstream
Tue 03 Feb
200921:57:43
GMT
images/
chewie.GIF
200
OK
myawsbucket/
dropoffimages/
chewie.GIF
89022dc5
94e0c5c090b
585ba9e70
846
image/gif
Tue 03 Feb
200921:57:43
GMT
images/
resources/
chewie.psd
108
Ignored 590
Tue 03 Feb
200921:57:43
GMT
images/
chewie.TIF
200
OK
8237897-21
b968e0174
e3dcace7
734
image/tiff
myawsbucket/
dropoffimages/
chewie.TIF
Note
contentTypes フィールドでは大文字と小文字が区別されるため、chewie.TIF と chewie.GIF は
gif や tif contentTypes フィルタでは抽出されませんでした。
131
AWS Import/Export 開発者ガイド
付録 B: 例
prefix フィールドの dropoff に末尾のフォワードスラッシュ (/) がなかったため、キー名にも
dropoff とロードされたファイルパスの間の区切り記号がありません。
エクスポートの例
トピック
• ファイルのエクスポート (p. 132)
• 例 – TSTDA (p. 132)
• 例 – TSTDB (p. 133)
このセクションでは、AWS Import/Export ジョブの例を解説し、マニフェストファイルの対応す
るSIGNATURE およびログファイルを示します。
ファイルのエクスポート
次のキーは各エクスポートジョブの一部とみなされます。
• /myawsbucket/README
• /myawsbucket /NOTICE.txt
• /myawsbucket /images/wookie1.jpg
• /myawsbucket /images/chewie.gif
• /myawsbucket /images/chewie.tif
• /myawsbucket /images/resources/chewie.psd
• /myawsbucket//backup/images/chewie.gif
• /lostbucket/bin/lost.rhtml
• /lostbucket/html/directory.html
• /lostbucket/images/hurley.jpg
• /lostbucket/images/john.jpg
• /lostbucket/images/kate.jpg
• /lostbucket/images/sawyer.jpg
• /lostbucket/index.html
例 – TSTDA
TSTDA のアップロード例では、最小限の構成オプションのマニフェストファイルを使用したデフォルトの
動作を示します。ジョブ TSTDA に関連付けられるサンプルファイルは次のとおりです。
• manifest-TSTDA.txt
• export-log-TSTDA.csv
以下は、manifest-TSTDA.txt ファイルの内容です。
manifestVersion: 1.2
deviceId: 532404500021
logBucket: myawsbucket
fileSystem: FAT32
operations:
- exportBucket: myawsbucket
returnAddress:
name: Jane Roe
132
AWS Import/Export 開発者ガイド
付録 B: 例
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
TSTDA ログファイル
Disk でこのジョブを処理した後、サービスによって結果ログファイルが http://s3.amazonaws.com/
myawsbucket/export-log-TSTDA に保存されます。ログファイルの内容を次の表に示します。
DateTime
ファイル
ステー コー
タス
ド
キー
MD5
Bytes ContentType
Tue 03 Feb
200921:57:43
GMT
myawsbucket/ 200
README.txt
OK
myawsbucket/
README.txt
d5a46fa2259
6d2464eff10
babb19000e
13
text/html
Tue 03 Feb
200921:57:43
GMT
myawsbucket/ 200
NOTICE.txt
OK
myawsbucket/
NOTICE.txt
f60fe317bc4
97b1204b327
094959eb64
13
text/html
Tue 03 Feb
200921:57:43
GMT
myawsbucket/ 200
images/
wookie1.jpg
OK
myawsbucket/
images/
wookie1.jpg
ccac0d031603
ff1c2994e07
703a64845
447
image/
jpeg
Tue 03 Feb
200921:57:43
GMT
myawsbucket/ 200
images/
chewie.gif
OK
myawsbucket/
images/
chewie.gif
5fc22dc594e
0c5929c090
b9585ba9e70
848
image/gif
Tue 03 Feb
200921:57:43
GMT
myawsbucket/ 200
images/
resources/
chewie.psd
OK
myawsbucket /
images/
resources/
chewie.psd
130b64d171
e9bbc2a8dbe1
17f189796c
524
application/
octetstream
Tue 03 Feb
200921:57:43
GMT
EXPORT302
RECOVERY
/0000/0000
Rema myawsbucket//
pped backup/images/
chewie.gif
823d17b0
5321b968e01f9
174e3dcace7
738
image/gif
例 – TSTDB
TSTDB のアップロード例では、以下の構成オプションのマニフェストファイルを使用したデフォルトの動
作を示します。複数のバケット、targetDirectory、prefix、beginMarker、および endMarker。ジョブ
TSTDB に関連付けられるサンプルファイルは次のとおりです。
• manifest-TSTDB.txt
• export-log-TSTDB.csv
以下は、manifest-TSTDB.txt ファイルの内容です。
manifestVersion: 2.0
deviceId: 532404500021
logBucket: myawsbucket
logPrefix: logs/
fileSystem: NTFS
operations:
133
AWS Import/Export 開発者ガイド
付録 B: 例
- exportBucket: myawsbucket
prefix: images
targetDirectory: starwars/image-backup
- exportBucket: lostbucket
beginMarker: html/
endMarker: images/kate.jpg
returnAddress:
name: Jane Roe
company: Example Corp.
street1: 123 Any Street
city: Anytown
stateOrProvince: WA
postalCode: 91011-1111
phoneNumber: 206-555-1111
country: USA
TSTDB ログファイル
Disk でこのジョブを処理した後、サービスによって結果ログファイルが http://s3.amazonaws.com/
myawsbucket/export-log-TSTDB に保存されます。ログファイルの内容を次の表に示します。
DateTime
ファイル
ステー コー
タス
ド
キー
MD5
Bytes ContentType
Tue 03 Feb
200921:57:43
GMT
starwars/
imagebackup/
images/
wookie1.jpg
200
OK
myawsbucket /
images/
wookie1.jpg
d5a46fa2259
6d246f10bab
b19000e
13
image/
jpeg
Tue 03 Feb
200921:57:43
GMT
starwars/
imagebackup/
images/
chewie.gif
200
OK
myawsbucket
/images/
chewie.gif
f60fe317bc4
97b12047094
959eb64
13
image/gif
Tue 03 Feb
200921:57:43
GMT
starwars/
imagebackup/
images/
chewie.tif
200
OK
myawsbucket
/images/
chewie.tif
ccac0d031603
ff1c4e07703
a64845
447
image/tiff
Tue 03 Feb
200921:57:43
GMT
starwars/
imagebackup/
images/
resources/
chewie.psd
200
OK
myawsbucket
/images/
resources/
chewie.psd
5fc22dc594e
0c5929cb958
5ba9e70
848
appli
cation/
octetstream
Tue 03 Feb
200921:57:43
GMT
lostbucket/
200
html/
directory.html
OK
lostbucket/html/
directory.html
130b64d171
e9bbc2ae117
f189796c
524
text/html
Tue 03 Feb
200921:57:43
GMT
lostbucket/
images/
hurley.jpg
200
OK
lostbucket/
images/
hurley.jpg
823d17b0
5321b968f917
4e3dcace7
738
image/
jpeg
Tue 03 Feb
200921:57:43
GMT
lostbucket/
images/
john.jpg
200
OK
lostbucket/
images/john.jpg
823d17b0
5321b968e91
74e3dcace7
615
image/
jpeg
134
AWS Import/Export 開発者ガイド
付録 C: MIME タイプのファイル拡張子
DateTime
ファイル
ステー コー
タス
ド
キー
MD5
Bytes ContentType
Tue 03 Feb
200921:57:43
GMT
lostbucket/
images/
kate.jpg
200
lostbucket/
images/kate.jpg
5fc22dc594
e0c5929c90b
9585ba9e70
345
OK
image/
jpeg
付録 C: MIME タイプのファイル拡張子
AWS Import/Export は、Internet Assigned Numbers Authorities (IANA) によって定義されている MIME タ
イプを使用します。MIME タイプを判別するために、AWS Import/Export は IANA ウェブサイトの MIME
タイプのテーブルに対して大文字小文字を区別しないルックアップを行います。このテーブルを確認する
には、http://www.iana.org/assignments/media-types を参照してください。
認識されないファイルタイプは Amazon S3 のデフォルトのコンテンツタイプである application/octetstream を使用します。
付録 D: Disk リソース
以下の表は、本サービスを利用する際に役立つ関連リソースをまとめたものです。
リソース
説明
API リファレンス (p. 96)
API オペレーションについて説明します。
よくある質問
AWS Import/Export についてのよくある質問と回答を示し
ます。
Amazon S3 ディスカッションフォーラム
開発者が Amazon S3 および Disk に関連する技術的な質問
についてディスカッションできる、コミュニティベースの
フォーラムです。
AWS サポートセンター
当社の開発者フォーラム、技術上のよくある質問、サービ
スステータスページ、AWS Premium Support へのアクセ
スを含む、AWS テクニカルサポートのホームページです。
お問い合わせ
AWS の支払い、アカウント設定その他に関する問い合わせ
先です。
法務
使用条件、プライバシーポリシー、その他トピックについ
ての詳細情報。
135
AWS Import/Export 開発者ガイド
ドキュメント履歴
以下の表に、AWS Import/Export の前回のリリース以後に行われた、ドキュメントの重要な変更を示しま
す。
• API バージョン: 2014-12-18
• 最新のドキュメントの更新: 2015 年 1 月 29 日
変更
説明
変更日
AWS Import/Export
Disk API バージョ
ン更新
AWS Import/Export Disk API の現在のバージョンは
2014-12-18 です。
2015 年 1 月 29 日
前払い UPS 配送ラ
ベル
Amazon Import/Export では、受領したすべての Import/
Export ジョブリクエストで UPS をワールドワイドなキャ
リアとして使用しています。AWS にパッケージを送付する
配送業者は UPS を使用する必要があります。また、AWS
Import/Export ウェブサービスツールで生成された前払い配送
ラベルを使用する必要があります。料金がデバイスの処理費
用に含まれるようになるため、お客様が UPS 配送料金を支
払う必要がなくなります。詳細については、「ストレージデ
バイスの配送 (p. 57)」を参照してください。
2015 年 1 月 16 日
PIN コードデバイ
スのサポート
AWS Import/Export では、データへのアクセスに物理 PIN
パッドを使用するストレージデバイスでのハードウェアベー
スの暗号化をサポートします。詳細については、「データの
暗号化 (p. 60)」を参照してください。
2014 年 8 月 11 日
エクスポートする
ファイルシステム
のサポート
今後、EXT2、EXT3、exFAT、および FAT32 は、Amazon
S3 からのエクスポートではサポートされません。詳細につ
いては、「ガイドラインおよび制限 (p. 125)」を参照してく
ださい。
2014 年 5 月 6 日
AWS IAM のサポー
ト
AWS Import/Export は AWS Identity and Access Management 2014 年 2 月 17 日
(IAM) と統合され、ユーザーが実行できるオペレーションを
制御できるようなります。詳細については、「AWS Import/
Export Disk での IAM の使用 (p. 25)」を参照してください。
デバイス消去と
TrueCrypt 暗号化
AWS Import/Export では、Amazon S3、Amazon EBS、およ
び Amazon Glacier へのインポート後にすべてのデバイスを
消去します。AWS では、Amazon S3 からのエクスポートを
136
2014 年 1 月 31 日
2014 年 1 月 3 日
AWS Import/Export 開発者ガイド
変更
説明
変更日
実行する前に、TrueCrypt を使用しているすべてのデバイス
を暗号化します。「データの暗号化 (p. 60)」を参照してくだ
さい。
notificationEmail フィールドがジョブタイプで必須になり
ました。
失敗したジョブに関する情報を追加しました。詳細について
は、「失敗したジョブ (p. 69)」を参照してください。
インポートでの
exFAT ファイルシ
ステムのサポート
インポートジョブで exFAT ファイルシステムがサポー
トされます。詳細については、「ガイドラインおよび制
限 (p. 125)」を参照してください。
2013 年 7 月 24 日
GLACIER ストレー
Amazon Glacier によって提供されるストレージのコストを
抑えつつ、個別のファイルを別々のオブジェクトとして保存
する場合は、まずファイルを Amazon S3 にインポートして
から、Amazon S3 オブジェクトライフサイクル管理を使用
してファイルを GLACIER ストレージクラスに移行します。
詳細については、「Amazon Glacier インポートジョブの作
成 (p. 33)」を参照してください。
2013 年 7 月 24 日
デバイスの暗号化
Amazon S3 のインポートやエクスポートに TrueCrypt を使用 2013 年 5 月 22 日
したデバイスの暗号化のサポートを追加しました。「データ
の暗号化 (p. 60)」を参照してください。
複数デバイスの配
送
1 つのパッケージで複数のデバイスを配送する場合の説明を
追加しました。「複数デバイスの配送 (p. 64)」を参照してく
ださい。
2013 年 1 月 1 日
EBS へのインポー
トにリージョンを
追加しました
AWS Import/Export では、Amazon Elastic Block Store
(Amazon EBS) へのデータのインポートのサポートを拡大し
ました。欧州 (アイルランド) および アジアパシフィック (シ
ンガポール) リージョンが含まれます。
2012 年 12 月 31
日
Import/Export タイ
プの要約の形式の
変更
Import/Export のタイプの要約の形式が変更され、Kindle デバ
イスで読みやすくなりました。
2012 年 8 月 20 日
Import/Export の要
約を追加しました
「AWS Import/Export の概念」セクションに、AWS Import/
Export ジョブタイプごとのソース、ターゲット、結果がまと
められたテーブルを含めました。
2012 年 8 月 20 日
ジクラス
詳細については、「ジョブの概要 (p. 3)」を参照してくださ
い。
Amazon Glacier の
サポートを追加し
ました
AWS Import/Export で、Amazon Glacier ボールトへのデータ
のインポートがサポートされるようになりました。
2012 年 8 月 20 日
ガイドを統合しま
す。
AWS Import/Export API リファレンスが AWS Import/Export
開発者ガイドの一部になりました。
2011 年 7 月 7 日
API バージョンを
修正します。
正しい API の現在のバージョンは 2010-06-03 です。
2011 年 7 月 7 日
詳細については、「最初の Amazon Glacier インポートジョ
ブの作成 (p. 16)」を参照してください。
137
AWS Import/Export 開発者ガイド
変更
説明
変更日
Amazon EBS ス
ナップショットを
見つけるための新
しい説明を追加し
ました。
Amazon EBS スナップショットへのデータのアップロードが
正常に完了すると、Amazon EC2 の AWS マネジメントコン
ソールでデータを確認できます。「AWS マネジメントコン
ソールの Amazon EBS スナップショット (p. 32)」を参照し
てください。
2011 年 7 月 7 日
Amazon Elastic
Block Store
(Amazon EBS) に
データをインポー
トするための新し
い入門ガイド
AWS Import/Export で、Amazon EBS スナップショット
へのデータのインポートがサポートされるようになりま
した。Amazon EBS スナップショットは Amazon Elastic
Compute Cloud (EC2) で使用するボリュームに変換できま
す。
2011 年 7 月 7 日
Amazon EBS への
インポートジョブ
の準備のための新
しい説明
Amazon EBS へのインポートジョブは、Amazon S3 へのイ
ンポートジョブとは別のプロセスに従います。
Amazon EBS への
インポートジョブ
の新しいマニフェ
ストファイルオプ
ション
Amazon EBS へのインポートジョブには、独自のマニフェス
トファイルオプションがあります。
メタデータを追加
する新しいイン
ポートマニフェス
トオプション
AWS Import/Export に、Amazon S3 へのデータロード管理を
向上させる新しいユーザー用マニフェストプションが追加さ
れました。
オブジェクトキー
およびファイル名
を変更する新しい
共通マニフェスト
オプション
アップロードしたオブジェクトキーおよびダウンロードし
たファイル名を substitutions オプションで変更します。
このオプションを使用して、Amazon S3 にデータをイン
ポートする場合のキーの名前付けの規則や、データをデバ
イスにエクスポートする場合のファイル名の規則を指定で
きます。マニフェストファイルの共通オプション (p. 70) の
substitutions オプションを参照してください。
2011 年 3 月 22 日
AWS Import/Export
での 米国西部 (北
カリフォルニア)
リージョンのサ
ポート
AWS Import/Export で、米国西部 (北カリフォルニア) リー
ジョンでの Amazon S3 バケットへのデータのインポートと
エクスポートがサポートされるようになりました。
2011 年 2 月 1 日
詳細については、「最初の Amazon EBS インポートジョブ
の作成 (p. 12)」を参照してください。
2011 年 7 月 7 日
詳細については、「Amazon EBS インポートジョブの作
成 (p. 30)」を参照してください。
2011 年 7 月 7 日
詳細については、「Amazon EBS へのインポートのマニフェ
ストファイルオプション (p. 85)」を参照してください。
2011 年 3 月 22 日
インポートジョブでは、ユーザー定義のメタデータをすべ
てのオブジェクトに割り当て、インポートされた各ファイル
の最終更新日のタイムスタンプをメタデータ値に保存できま
す。「Amazon S3 へのインポートのマニフェストファイルオ
プション (p. 77)」の diskTimestampMetadataKey オプション
および staticMetadata オプションを参照してください。
138
AWS Import/Export 開発者ガイド
変更
説明
変更日
AWS Import/Export
での アジアパシ
フィック (シンガ
ポール) リージョン
のサポート
AWS Import/Export で、アジアパシフィック (シンガポール)
リージョンでの Amazon S3 バケットへのデータのインポー
トとエクスポートがサポートされるようになりました。
2010 年 12 月 28
日
大きなオブジェク
トのサポート
AWS Import/Export で、サイズが 5 TB までのオブジェクト
のインポートおよびエクスポートがサポートされるようにな
りました。
2010 年 12 月 9 日
AWS Import/Export
が、ウェブサービ
スになります
AWS Import/Export がウェブサービスになりました。この製
品の以前のバージョンでは、ジョブの作成や管理には E メー
ルが必要でした。このようなメールコマンドと手順は廃止さ
れ、2010 年 12 月 31 日に機能も停止します。このガイドに
は、これらのコマンドは掲載されていません。
2010 年 6 月 9 日
AWS Import/Export
コマンドラインイ
ンターフェース
新しいウェブサービス API に加え、AWS Import/Export にコ
マンドラインインターフェースが登場しました。詳細につい
ては、AWS Import/Export コマンドラインクイックリファレ
ンスカードを参照してください。
2010 年 6 月 9 日
内蔵 SATA および
4 TB デバイスの
容量制限の新規サ
ポート
AWS Import/Export で、Amazon S3 標準および 欧州 (アイル
ランド) リージョンへのデータロードで、内蔵 SATA ハード
ドライブがサポートされるようになりました。さらに、容量
が最大 4 TB までのポータブルストレージデバイスを送付で
きるようになりました。大きいデータのロードに必要なデバ
イス数を削減できます。
2010 年 3 月 5 日
AWS Import/Export
の国際サポート
米国東部(バージニア北部) リージョンのバケットから、ま
たはバケットにデータをロードする場合に、ほとんどの国際
ロケーションでストレージデバイスを送付および受領できる
ようになりました。詳細については、「ストレージデバイス
の配送 (p. 57)」を参照してください。
2009 年 12 月 9 日
欧州 (アイルラン
ド) バケットのサ
ポート
欧州 (アイルランド) バケットへのデータのインポート、また
はバケットからのエクスポートができるようになりました。
詳細については、「ストレージデバイスの郵送 (p. 65)」を参
照してください。
2009 年 12 月 9 日
139