13.4. コンポーネントオプション
Azure Storage Blob Service コンポーネントは、以下に示す 35 のオプションをサポートしています。
| 名前 | 説明 | デフォルト | 型 |
|---|---|---|---|
| blobName (common) | コンテナーから特定の Blob を使用するための Blob 名。ただし、producer では、Blob レベルでの操作にのみ必要です。 | String | |
| blobOffset (common) | アップロードまたはダウンロード操作の Blob オフセットを設定します。デフォルトは 0 です。 | 0 | long |
| blobType (common) | Blob の種類ごとに適切な設定を開始するための Blob の種類。 列挙値:
| blockblob | BlobType |
| closeStreamAfterRead (common) | 読み取り後にストリームを閉じるか、開いたままにします。デフォルトは true です。 | true | boolean |
| configuration (common) | コンポーネントの設定。 | BlobConfiguration | |
| credentials (common) | StorageSharedKeyCredential を挿入して Azure クライアントを作成できます。これには重要な認証情報が保持されます。 | StorageSharedKeyCredential | |
| credentialType (common) | 採用する認証情報戦略を決定します。 列挙値:
| AZURE_IDENTITY | CredentialType |
| dataCount (common) | 範囲に含めるバイト数。指定する場合は、0 以上である必要があります。 | Long | |
| fileDir (common) | ダウンロードされた Blob が保存されるファイルディレクトリー。これは producer と consumer の両方で使用できます。 | String | |
| maxResultsPerPage (common) | すべての BlobPrefix 要素を含め、返される Blob の最大数を指定します。要求で maxResultsPerPage が指定されていないか、5,000 を超える値が指定されている場合、サーバーは最大 5,000 項目を返します。 | Integer | |
| maxRetryRequests (common) | レスポンスのボディーからデータを読み取るときに作成される追加の HTTP Get 要求の最大数を指定します。 | 0 | int |
| prefix (common) | 結果をフィルター処理して、名前が指定された接頭辞で始まる Blob のみを返します。すべての Blob を返すには null の場合があります。 | String | |
| regex (common) | 結果をフィルタリングして、指定された正規表現と名前が一致する Blob のみを返します。接頭辞と正規表現の両方が設定されている場合は、すべてを返すために null になる場合があります。正規表現が優先され、接頭辞は無視されます。 | String | |
| sasToken (common) | Shared Access Signature を使用する場合は SAS トークンを設定する | String | |
| serviceClient (common) | クライアントをストレージアカウントに Autowired します。このクライアントは、特定のストレージアカウントに関する状態を保持しませんが、サービス上のリソースに適切な要求を送信する便利な方法です。また、Blob およびコンテナーへの URL を作成するために使用することもできます。このクライアントには、サービスアカウントに対する操作が含まれています。コンテナーに対する操作は、BlobServiceClient#getBlobContainerClient(String) を介して BlobContainerClient で利用でき、ブロブに対する操作は、BlobContainerClient#getBlobClient(String) を介して BlobClient で利用できます。 | BlobServiceClient | |
| timeout (common) | それを超えると RuntimeException が発生する任意のタイムアウト値。 | 期間 | |
| bridgeErrorHandler (consumer) | consumer の Camel ルーティングエラーハンドラーへのブリッジを許可します。よって、consumer が受信メッセージなどの取得を試行している間に発生した例外は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されます。デフォルトでは、consumer は org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | false | boolean |
| blobSequenceNumber (producer) | リクエストの追跡に使用できるユーザー制御の値。シーケンス番号の値は、0 から 263 - 1 の間でなければなりません。デフォルト値は 0 です。 | 0 | Long |
| blockListType (producer) | 返すブロックのタイプを指定します。 列挙値:
| COMMITTED | BlockListType |
| changeFeedContext (producer) | getChangeFeed producer オペレーションを使用する場合は、これにより、サービス呼び出し中に Http パイプラインを介して渡される追加のコンテキストが提供されます。 | コンテキスト | |
| changeFeedEndTime (producer) | getChangeFeed producer オペレーションを使用する場合は、これにより結果がフィルター処理され、終了時刻のほぼ前にイベントが返されます。注意: 次の 1 時間に属するいくつかのイベントも返される可能性があります。この時間に属するいくつかのイベントが欠落している可能性があります。その時間のすべてのイベントが確実に返されるようにするには、終了時間を 1 時間単位で切り上げます。 | OffsetDateTime | |
| changeFeedStartTime (producer) | getChangeFeed producer 操作を使用する場合は、これにより結果がフィルター処理され、開始時刻のほぼ後にイベントが返されます。注意: 前の時間に属するいくつかのイベントも返される可能性があります。この時間に属するいくつかのイベントが欠落している可能性があります。その時間のすべてのイベントが確実に返されるようにするには、開始時間を 1 時間単位で切り捨てます。 | OffsetDateTime | |
| closeStreamAfterWrite (producer) | 書き込み後にストリームを閉じるか、開いたままにします。デフォルトは true です。 | true | boolean |
| commitBlockListLater (producer) | true に設定されていると、ステージングされたブロックは直接コミットされません。 | true | boolean |
| createAppendBlob (producer) | true に設定されていると、追加ブロックのコミット時に追加ブロックが作成されます。 | true | boolean |
| createPageBlob (producer) | true に設定すると、ページブロブのアップロード時にページ Blob が作成されます。 | true | boolean |
| downloadLinkExpiration (producer) | URL ダウンロードリンクのデフォルトの有効期限 (ミリ秒) をオーバーライドします。 | Long | |
| lazyStartProducer (producer) | 最初のメッセージで producer をレイジーに起動すべきかどうか。レイジーに起動することで、起動時に producer が失敗し、それによりルートが失敗する可能性がある状況で、CamelContext およびルートの起動を許可します。レイジーな起動を延期すると、Camel のルーティングエラーハンドラー経由でメッセージのルーティング中に起動の失敗を処理できます。最初のメッセージが処理されるときに、producer の作成および起動に若干時間がかかり、合計処理時間が長くなる可能性があることに注意してください。 | false | boolean |
| operation (producer) | producer のこのコンポーネントで使用できる Blob 操作。 列挙値:
| listBlobContainers | BlobOperationsDefinition |
| pageBlobSize (producer) | ページ Blob の最大サイズを 8 TB まで指定します。ページ Blob のサイズは、512 バイトの境界に合わせる必要があります。 | 512 | Long |
| autowiredEnabled (advanced) | 自動ワイヤリングが有効になっているかどうか。これは、コンポーネントで設定される一致するタイプのインスタンスが 1 つあるかどうかを検出するためにレジストリーを検索することで、自動ワイアリングオプションに使用されます (オプションは自動ワイアとマーク付けされる必要があります)。これは、JDBC データソース、JMS 接続ファクトリー、AWS クライアントなどの自動設定に使用できます。 | true | boolean |
| healthCheckConsumerEnabled (health) | このコンポーネントからのすべてのコンシューマーベースのヘルスチェックを有効または無効にするために使用します。 | true | boolean |
| healthCheckProducerEnabled (health) | このコンポーネントからのすべてのプロデューサーベースのヘルスチェックを有効または無効にするために使用します。注記: Camel はデフォルトで、すべてのプロデューサーベースのヘルスチェックを無効にしています。camel.health.producersEnabled=true を設定することで、プロデューサーチェックをグローバルに有効にできます。 | true | boolean |
| accessKey (security) | Azure Blob サービスでの認証に使用される、関連付けられた Azure アカウント名のアクセスキー。 | String | |
| sourceBlobAccessKey (security) | ソース Blob アクセスキー: copyblob 操作では、コピーするソース Blob の accessKey が必要です。accessKey をヘッダーとして渡すと、安全ではないため、キーとして設定できます。 | String |