8.6. Spring Boot Auto-Configuration
Spring Boot で azure-storage-blob を使用する場合は、次の Maven 依存関係を使用して自動設定をサポートしてください。
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-azure-storage-blob-starter</artifactId>
<version>{CamelSBProjectVersion}</version>
<!-- Use your Camel Spring Boot version -->
</dependency>
コンポーネントは、以下に記載される 32 のオプションをサポートします。
| 名前 | 説明 | デフォルト | タイプ |
|---|---|---|---|
| camel.component.azure-storage-blob.access-key | Azure Blob サービスでの認証に使用される、関連付けられた Azure アカウント名のアクセスキー。 | String | |
| camel.component.azure-storage-blob.autowired-enabled | 自動ワイヤリングが有効になっているかどうか。これは、コンポーネントで設定される一致するタイプのインスタンスが 1 つあるかどうかを検出するためにレジストリーを検索することで、自動ワイアリングオプションに使用されます (オプションは自動ワイアとマーク付けされる必要があります)。これは、JDBC データソース、JMS 接続ファクトリー、AWS クライアントなどの自動設定に使用できます。 | true | ブール値 |
| camel.component.azure-storage-blob.blob-name | コンテナーから特定の BLOB を使用するための BLOB 名。ただし、producer では、BLOB レベルでの操作にのみ必要です。 | String | |
| camel.component.azure-storage-blob.blob-offset | アップロードまたはダウンロード操作の BLOB オフセットを設定します。デフォルトは 0 です。 | 0 | Long |
| camel.component.azure-storage-blob.blob-sequence-number | リクエストの追跡に使用できるユーザー制御の値。シーケンス番号の値は、0 から 263 - 1 の間でなければなりません。デフォルト値は 0 です。 | 0 | Long |
| camel.component.azure-storage-blob.blob-type | BLOB の種類ごとに適切な設定を開始するための BLOB の種類。 | BlobType | |
| camel.component.azure-storage-blob.block-list-type | 返すブロックのタイプを指定します。 | BlockListType | |
| camel.component.azure-storage-blob.bridge-error-handler | consumer の Camel ルーティングエラーハンドラーへのブリッジを許可します。よって、consumer が受信メッセージなどの取得を試行している間に発生した例外は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されます。デフォルトでは、consumer は org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | false | ブール値 |
| camel.component.azure-storage-blob.change-feed-context | getChangeFeed producer オペレーションを使用する場合は、これにより、サービス呼び出し中に Http パイプラインを介して渡される追加のコンテキストが提供されます。オプションは com.azure.core.util.Context 型です。 | コンテキスト | |
| camel.component.azure-storage-blob.change-feed-end-time | getChangeFeed producer オペレーションを使用する場合は、これにより結果がフィルター処理され、終了時刻のほぼ前にイベントが返されます。注意: 次の 1 時間に属するいくつかのイベントも返される可能性があります。この時間に属するいくつかのイベントが欠落している可能性があります。その時間のすべてのイベントが確実に返されるようにするには、終了時間を 1 時間単位で切り上げます。オプションは java.time.OffsetDateTime 型です。 | OffsetDateTime | |
| camel.component.azure-storage-blob.change-feed-start-time | getChangeFeed producer 操作を使用する場合は、これにより結果がフィルター処理され、開始時刻のほぼ後にイベントが返されます。注意: 前の時間に属するいくつかのイベントも返される可能性があります。この時間に属するいくつかのイベントが欠落している可能性があります。その時間のすべてのイベントが確実に返されるようにするには、開始時間を 1 時間単位で切り捨てます。オプションは java.time.OffsetDateTime 型です。 | OffsetDateTime | |
| camel.component.azure-storage-blob.close-stream-after-read | 読み取り後にストリームを閉じるか、開いたままにします。デフォルトは true です。 | true | ブール値 |
| camel.component.azure-storage-blob.close-stream-after-write | 書き込み後にストリームを閉じるか、開いたままにします。デフォルトは true です。 | true | ブール値 |
| camel.component.azure-storage-blob.commit-block-list-later | true に設定されていると、ステージングされたブロックは直接コミットされません。 | true | ブール値 |
| camel.component.azure-storage-blob.configuration | コンポーネントの設定。オプションは org.apache.camel.component.azure.storage.blob.BlobConfiguration タイプです。 | BlobConfiguration | |
| camel.component.azure-storage-blob.create-append-blob | true に設定されていると、追加ブロックのコミット時に追加ブロックが作成されます。 | true | ブール値 |
| camel.component.azure-storage-blob.create-page-blob | true に設定すると、ページブロブのアップロード時にページ Blob が作成されます。 | true | ブール値 |
| camel.component.azure-storage-blob.credentials | StorageSharedKeyCredential を挿入して Azure クライアントを作成できます。これには重要な認証情報が保持されます。オプションは com.azure.storage.common.StorageSharedKeyCredential 型です。 | StorageSharedKeyCredential | |
| camel.component.azure-storage-blob.data-count | 範囲に含めるバイト数。指定する場合は、0 以上である必要があります。 | Long | |
| camel.component.azure-storage-blob.download-link-expiration | URL ダウンロードリンクのデフォルトの有効期限 (ミリ秒) をオーバーライドします。 | Long | |
| camel.component.azure-storage-blob.enabled | azure-storage-blob コンポーネントの自動設定を有効にするかどうか。これはデフォルトで有効になっています。 | ブール値 | |
| camel.component.azure-storage-blob.file-dir | ダウンロードされた BLOB が保存されるファイルディレクトリー。これは producer と consumer の両方で使用できます。 | String | |
| camel.component.azure-storage-blob.lazy-start-producer | 最初のメッセージで producer をレイジーに起動すべきかどうか。レイジーに起動することで、起動時に producer が失敗し、それによりルートが失敗する可能性がある状況で、CamelContext およびルートの起動を許可します。レイジーな起動を延期すると、Camel のルーティングエラーハンドラー経由でメッセージのルーティング中に起動の失敗を処理できます。最初のメッセージが処理されるときに、producer の作成および起動に若干時間がかかり、合計処理時間が長くなる可能性があることに注意してください。 | false | ブール値 |
| camel.component.azure-storage-blob.max-results-per-page | すべての BlobPrefix 要素を含め、返される BLOB の最大数を指定します。要求で maxResultsPerPage が指定されていないか、5,000 を超える値が指定されている場合、サーバーは最大 5,000 項目を返します。 | Integer | |
| camel.component.azure-storage-blob.max-retry-requests | レスポンスのボディーからデータを読み取るときに作成される追加の HTTP Get 要求の最大数を指定します。 | 0 | Integer |
| camel.component.azure-storage-blob.operation | producer のこのコンポーネントで使用できる Blob 操作。 | BlobOperationsDefinition | |
| camel.component.azure-storage-blob.page-blob-size | ページ BLOB の最大サイズを 8 TB まで指定します。ページ BLOB のサイズは、512 バイトの境界に合わせる必要があります。 | 512 | Long |
| camel.component.azure-storage-blob.prefix | 結果をフィルター処理して、名前が指定された接頭辞で始まる BLOB のみを返します。すべての BLOB を返すには null の場合があります。 | String | |
| camel.component.azure-storage-blob.regex | 結果をフィルタリングして、指定された正規表現と名前が一致する BLOB のみを返します。接頭辞と正規表現の両方が設定されている場合は、すべてを返すために null になる場合があります。正規表現が優先され、接頭辞は無視されます。 | String | |
| camel.component.azure-storage-blob.service-client | ストレージアカウントへのクライアント。このクライアントは、特定のストレージアカウントに関する状態を保持しませんが、サービス上のリソースに適切な要求を送信する便利な方法です。また、BLOB およびコンテナーへの URL を作成するために使用することもできます。このクライアントには、サービスアカウントに対する操作が含まれています。コンテナーに対する操作は、BlobServiceClient#getBlobContainerClient(String) を介して BlobContainerClient で利用でき、ブロブに対する操作は、BlobContainerClient#getBlobClient(String) を介して BlobClient で利用できます。オプションは com.azure.storage.blob.BlobServiceClient 型です。 | BlobServiceClient | |
| camel.component.azure-storage-blob.source-blob-access-key | ソース Blob アクセスキー: copyblob 操作では、コピーするソース Blob の accessKey が必要です。accessKey をヘッダーとして渡すと、安全ではないため、キーとして設定できます。 | String | |
| camel.component.azure-storage-blob.timeout | それを超えると RuntimeException が発生する任意のタイムアウト値。オプションは java.time.Duration タイプです。 | 期間 |