ストレージ認証情報の項目一覧

Amazon S3のストレージ認証情報の入出力ファイルの項目は以下のとおりです。

項目一覧

表7.6 ストレージ認証情報の項目

項目名

キー

値の形式

備考

ストレージ認証情報の配列

auth_info

array

 

ID

id

string

3～63バイト以内

AWSアクセスキー

access_key

string

1～255バイト以内

AWSシークレットアクセスキー

secret_access_key

string

1～255バイト以内

セッショントークン

session_token

string

1～2048バイト以内

IAMロール有効化

enable_iam_role

boolean

 

スイッチロールARN

switch_role_arn

string

2～2048バイト以内

外部ID

external_id

string

2～2048バイト以内

ロールセッション名

role_session_name

string

2～255バイト以内

各項目の説明

注意

  • 管理情報のインポートを行う場合、「IAMロール有効化」を指定すると、「AWSアクセスキー」、「AWSシークレットアクセスキー」および「セッショントークン」は指定できません。

    AWSアクセスキーおよびAWSシークレットアクセスキーを使用する認証の「IAMユーザー認証」と「IAMロール有効化」の使用優先順位については、「ストレージ認証情報の設定」を参照してください。

    AWSアクセスキー、AWSシークレットアクセスキーおよびセッショントークンを使用する認証の「一時的なセキュリティ認証」と「IAMロール有効化」の使用優先順位については、「ストレージ認証情報の設定」を参照してください。

  • 管理情報のインポートを行う場合、「スイッチロールARN」、「外部ID」および「ロールセッション名」は必ず同時に指定してください。

    それぞれの値を個別に指定することはできません。

  • 管理情報のインポートを行う場合、「セッショントークン」を指定した際は、以下の値も必ず同時に指定してください。

    • AWSアクセスキー

    • AWSシークレットアクセスキー

ストレージ認証情報の配列（auth_info）

ストレージ認証情報の配列（省略不可）

ストレージ認証情報の配列です。

ストレージ認証情報の各項目については、この配列の中にIDごとに情報を記載します。

ID（id）

ID（省略不可）

ストレージ認証情報IDです。

3バイトから63バイトまでのASCII印字可能文字で指定します。

半角スペース、「/」、「*」の文字が含まれていた場合はエラーとなります。

AWSアクセスキー（access_key）

AWSアクセスキー（省略可）

Amazon Web Serviceに接続するために、アップロードまたはダウンロードするAWSユーザーに関連付けられたアクセスキーです。

管理情報のインポートを行う場合、1バイトから255バイトまでのASCII印字可能文字で指定します。

省略すると、未設定（Use the default value.）となります。未設定の場合、転送時にはデフォルト情報の設定値が使用されます。

管理情報のエクスポートを行う場合、値が登録されていると出力されます。

登録されていない場合、何も出力されません。

AWSシークレットアクセスキー（secret_access_key）

AWSシークレットアクセスキー（省略可）

Amazon Web Serviceに接続するために、アクセスキーに関連付けられたシークレットキー（パスワード）です。

管理情報のインポートを行う場合、1バイトから255バイトまでのASCII印字可能文字で指定します。

省略すると、未設定（Use the default value.）となります。未設定の場合、転送時にはデフォルト情報の設定値が使用されます。

管理情報のエクスポートを行う場合、値が登録されていると出力されます。

登録されていない場合、何も出力されません。

セッショントークン（session_token）

セッショントークン（省略可）

Amazon Web Serviceに接続するために、一時的セキュリティ認証情報を使用して接続を行うセッショントークンを指定します。

管理情報のインポートを行う場合、1バイトから2048バイトまでのASCII印字可能文字を指定します。

なお、“none”を設定した場合、セッショントークンは無効となります。

省略すると、未設定（Use the default value.）となります。未設定の場合、転送時にはデフォルト情報の設定値が使用されます。

管理情報のエクスポートを行う場合、値が登録されていると出力されます。

登録されていない場合、何も出力されません。

IAMロール有効化（enable_iam_role）

IAMロール有効化（省略可）

Amazon EC2上にHULFTおよびHULFT クラウドストレージオプションがインストールされている場合、Amazon EC2に紐づけられたIAMロールを使用した認証を、有効にするかどうかです。

管理情報のインポートを行う場合、IAMロールを有効化する場合は“true”を指定してください。この場合、Amazon EC2に紐づけられているIAMロールの認証情報を使用します。

省略すると、未設定（Use the default value.）となります。未設定の場合、転送時にはデフォルト情報の設定値が使用されます。

管理情報のエクスポートを行う場合、値が登録されていると出力されます。

登録されていない場合、何も出力されません。

= 備考 =

HULFTおよびHULFT クラウドストレージオプションがAmazon EC2以外の環境にインストールされている場合、IAMロールを有効にすると転送時にエラーとなります。

スイッチロールARN（switch_role_arn）

スイッチロールARN（省略可）

IAMロールの切り替えの切り替え先のAmazon Resource Name（ARN）です。

管理情報のインポートを行う場合、2バイトから2048バイトまでのASCII印字可能文字で指定します。

なお、“none”を設定した場合、スイッチロールARNは無効となり、IAMロールの切り替えは行いません。

省略すると、未設定（Use the default value.）となります。未設定の場合、転送時にはデフォルト情報の設定値が使用されます。

管理情報のエクスポートを行う場合、値が登録されていると出力されます。

登録されていない場合、何も出力されません。

外部ID（external_id）

外部ID（省略可）

IAMロールの切り替え時に使用する外部IDです。

管理情報のインポートを行う場合、2バイトから2048バイトまでのASCII印字可能文字で指定します。

なお、“none”を設定した場合、外部IDは無効となります。

省略すると、未設定（Use the default value.）となります。未設定の場合、転送時にはデフォルト情報の設定値が使用されます。

管理情報のエクスポートを行う場合、値が登録されていると出力されます。

登録されていない場合、何も出力されません。

ロールセッション名（role_session_name）

ロールセッション名（省略可）

IAMロールの切り替え時に使用するロールセッション名です。

管理情報のインポートを行う場合、2バイトから255バイトまでのASCII印字可能文字で指定します。

なお、“none”を設定した場合、ロールセッション名は無効となり、転送時には以下の固定値が使用されます。

  • アップロードの場合：HULFT-S3-Upload

  • ダウンロードの場合：HULFT-S3-Download

省略すると、未設定（Use the default value.）となります。未設定の場合、転送時にはデフォルト情報の設定値が使用されます。

管理情報のエクスポートを行う場合、値が登録されていると出力されます。

登録されていない場合、何も出力されません。