# tGSBucketCreate

データを整理し、Google Cloud Storage内のデータへのアクセスを制御するために使える新しいバケットを作成します。

## tGSBucketCreateの標準プロパティ

これらのプロパティは、標準ジョブのフレームワークで実行されているtGSBucketCreateを設定するために使われます。

標準のtGSBucketCreateコンポーネントは、ビッグデータファミリーとCloudファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。

## 基本設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [Use an existing connection] (既存の接続を使用) | 定義済みの接続の詳細を再利用するには、このチェックボックスをオンにして、[Component List] (コンポーネントリスト)で該当する接続コンポーネントをクリックします。 |
| [Credential type] (認証情報のタイプ) | プロジェクトの認証に使用されるモードを選択します。<br><br><ul> <li><span>[Service account] (サービスアカウント)</span>: Google Cloud Platformプロジェクトに関連付けられているGoogleアカウントを使って認証します。このモードを選択すると、アクセスキーは<span>[Service account credentials file] (サービスアカウントキー)</span>フィールドに入力する必要があります。</li> <li><span>ワークロードIDフェデレーション</span>: サービスアカウントキーを使用することなく、AWS、Azure、OIDCなどの外部IDプロバイダーを使用して認証を行います。このモードを選択する場合、IDフェデレーションの設定は、[<span>クライアントライブラリ設定ファイル</span>]フィールドで指定する必要があります。</li> <li><span>[Application Default Credentials] (アプリケーションのデフォルト認証情報)</span>: アプリケーションのデフォルト認証情報を使って認証します。このモードを選択した場合、アプリケーション環境に基づいて認証情報が自動的に検索されるので、追加のパラメーターを定義する必要はありません。</li> <li> <span>[OAuth Access Token] (OAuth アクセストークン)</span>: OAuthアクセストークンを使用して認証します。このモードを選択する場合、トークンは[<span>OAuthアクセストークン</span>]フィールドに情報を提供する必要があります。 </li> </ul><br><br>Google Cloudの認証プロセスに関する詳細は、[Google Cloudのドキュメンテーション](https://cloud.google.com/docs/authentication/)をご参照ください。 |
| [Service account key] (サービスアカウントキー) | サービスアカウントキーフィールドの横にある[...]ボタンをクリックして、サービスアカウントキーを含むJSONファイルを参照します。<br><br>このプロパティは、サービスアカウントを使って認証する場合のみ利用できます。 |
| [OAuth Access Token] (OAuthアクセストークン) | アクセストークンを入力します。<br><br>トークンのライフタイムは1時間です。コンポーネントは、トークン更新操作を行いませんが、1時間という制限時間を超えても操作できるよう、新しいアクセストークンをフェッチします。<br><br><br>このプロパティは、[OAuth Access Token] (OAuthアクセストークン)を使って認証する場合のみ利用できます。 |
| [Bucket name] (バケット名) | 作成するバケットの名前を指定します。バケット名は、Google Cloud Storageシステム全体で一意である必要があります。<br><br>バケットの命名規則の詳細は、Google Cloudのドキュメンテーションで[Bucket names](https://cloud.google.com/storage/docs/buckets#naming)をご覧ください。 |
| [Special configure] (特別な設定) | 作成するバケットの追加設定を提供するには、このチェックボックスをオンにします。 |
| プロジェクトID | 認証情報タイプが[HMAC key] (HMACキー)に設定されている場合、新しいバケットが属しているプロジェクトのIDを指定します。 |
| [Location and access control] (ロケーションとアクセス制御) | 新しいバケットが作成される場所をリストから選択します。[Europe] (欧州)と[US] (米国)はすべての認証情報タイプに使えます。[ASIA] (アジア)は[Service account] (サービスアカウント)と[OAuth Access Token] (OAuthアクセストークン)にのみ使えます。デフォルトでは、バケットの場所は[US] (米国)です。<br><br>バケットを特定の場所に作成すると、別の場所に移動することはできません。 |
| Acl | 新しいバケットに必要なアクセス制御リスト(ACL)をリストから選択します。<br><br>バケットのACLによって、ユーザーからのアクセス要求が許可されたり拒否されたりします。新しいバケットに事前定義されたACLを指定しない場合は、事前定義されたプロジェクトプライベートACLが適用されます。<br><br>ACLの詳細は、Google Cloudのドキュメンテーションで[Overview of access control](https://cloud.google.com/storage/docs/access-control)をご覧ください。 |
| Die on error (エラー発生時に強制終了) | このチェックボックスはデフォルトでオフになっています。すなわち、エラーが発生した行をスキップし、エラーが発生していない行のプロセスを完了させます。 |

## 詳細設定

| [Properties] (プロパティ) | 説明 |
| --- | --- |
| [Use a custom endpoint] (カスタムエンドポイントを使用) | デフォルトのエンドポイントの代わりにプライベートエンドポイントを使う場合は、このチェックボックスをオンにします。<br><br>選択後は、https://storage.goggleapis.comという形式でGoogle Storage Private API URLプロパティにURLを入力します。<br><br>詳細は、Googleのドキュメンテーションで[Access Google APIs through endpoints](https://cloud.google.com/vpc/docs/configure-private-service-connect-apis)をご覧ください。<br><br>このプロパティは、[Service account] (サービスアカウント)と[Application Default Credentials] (アプリケーションのデフォルト認証情報)を使って認証する場合のみ利用できます。 |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスをオンにすると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |

## [Global Variables] (グローバル変数)

| 変数 | 説明 |
| --- | --- |
| グローバル変数 | ERROR\_MESSAGE: エラーが発生した時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。この変数はコンポーネントにこのチェックボックスが存在し、[Die on error] (エラー発生時に強制終了)がオフになっている場合のみ機能します。<br><br>Flow変数はコンポーネントの実行中に機能し、After変数はコンポーネントの実行後に機能します。<br><br>フィールドまたは式に変数を入力する場合は、Ctrl + スペースを押して変数リストにアクセスし、使用する変数を選択します。<br><br>変数の詳細は、[コンテキストと変数を使用](https://help.qlik.com/talend/r/ja-JP/8.0/studio-user-guide/contexts-and-variables)をご覧ください。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| **使用ルール** | このコンポーネントをtGSBucketListコンポーネントと共に使って、新しいバケットが正しく作成されたかどうかを確認できます。 |