10.4. 끝점 옵션


Azure Storage Blob 서비스 끝점은 URI 구문을 사용하여 구성됩니다.

azure-storage-blob:accountName/containerName
Copy to Clipboard Toggle word wrap

다음과 같은 경로 및 쿼리 매개변수 사용:

10.4.1. 경로 매개변수(2 매개변수)

Expand
이름설명Default유형

AccountName ( common)

Azure Blob 서비스를 사용한 인증에 사용할 Azure 계정 이름입니다.

 

문자열

컨테이너 이름 (공용)

Blob 컨테이너 이름입니다.

 

문자열

10.4.2. 쿼리 매개변수(48 매개변수)

Expand
이름설명Default유형

BlobName (common)

컨테이너에서 특정 Blob을 사용하려면 Blob 이름입니다. 그러나 생산자에서는 Blob 수준의 작업에만 필요합니다.

 

문자열

BlobOffset (common)

업로드 또는 다운로드 작업에 대한 Blob 오프셋을 설정합니다. 기본값은 0입니다.

0

long

BlobServiceClient (common)

스토리지 계정으로 클라이언트입니다. 이 클라이언트는 특정 스토리지 계정에 대한 상태를 유지하지 않지만 대신 서비스의 리소스에 적절한 요청을 보내는 편리한 방법입니다. Blob 및 컨테이너에 대한 URL을 구성하는 데도 사용할 수 있습니다. 이 클라이언트에는 서비스 계정에 대한 작업이 포함되어 있습니다. 컨테이너의 작업은 getBlobContainerClient(String)를 통해 BlobContainerClient에서 사용할 수 있으며 Blob의 작업은 getBlobContainerClient(String).getBlobClient(String)를 통해 BlobClient에서 사용할 수 있습니다.Operations on a container are available on BlobContainerClient through getBlobContainerClient(String), and operations on a blobClient are available on BlobClient through getBlobContainerClient(String).getBlobClient(String).getBlobClient(String).

 

BlobServiceClient

BlobType (common)

각 Blob 유형에 대한 적절한 설정을 시작하기 위해 Blob 유형입니다.

CloudEvent 값:

  • Blockblob
  • appendblob
  • pageblob

Blockblob

BlobType

CloseStreamAfterRead (common)

스트림을 읽은 후 종료하거나 열린 상태로 유지하며 기본값은 true입니다.

true

boolean

자격 증명 (공용)

StorageSharedKeyCredential를 삽입하여 azure 클라이언트를 만들 수 있습니다. 이에는 중요한 인증 정보가 들어 있습니다.

 

StorageSharedKeyCredential

dataCount (공용)

범위에 포함할 바이트 수입니다. 0을 지정하면 보다 크거나 같아야 합니다.

 

long

fileDir (공용)

다운로드한 Blob이 저장되는 파일 디렉터리이며, 생산자와 소비자 모두에 사용할 수 있습니다.

 

문자열

maxResultsPerPage (common)

모든 BlobPrefix 요소를 포함하여 반환할 Blob의 최대 수를 지정합니다. 요청이 maxResultsPerPage를 지정하지 않거나 5,000보다 큰 값을 지정하는 경우 서버는 최대 5,000개의 항목을 반환합니다.

 

정수

maxRetryRequests (common)

응답 본문에서 데이터를 읽는 동안 수행할 최대 추가 HTTP 가져오기 요청 수를 지정합니다.

0

int

접두사 (공용)

결과를 필터링하여 이름이 지정된 접두사로 시작하는 Blob만 반환합니다. 모든 Blob을 반환하려면 null일 수 있습니다.

 

문자열

regex (common)

결과를 필터링하여 이름이 지정된 정규식과 일치하는 Blob만 반환합니다. 접두사와 regex가 모두 설정된 경우 모두 반환하는 null일 수 있으며 regex는 우선 순위를 사용하고 접두사는 무시됩니다.

 

문자열

ServiceClient (공용)

Client 를 스토리지 계정으로 자동 연결합니다. 이 클라이언트는 특정 스토리지 계정에 대한 상태를 유지하지 않지만 대신 서비스의 리소스에 적절한 요청을 보내는 편리한 방법입니다. Blob 및 컨테이너에 대한 URL을 구성하는 데도 사용할 수 있습니다. 이 클라이언트에는 서비스 계정에 대한 작업이 포함되어 있습니다. 컨테이너의 작업은 BlobServiceClient#getBlobContainerClient(String)를 통해 BlobContainerClient에서 사용할 수 있으며 Blob의 작업은 BlobContainerClient#getBlobClient(String)를 통해 BlobClient에서 사용할 수 있습니다.Operations on a container are available on BlobContainerClient through BlobServiceClient#getBlobContainerClient(String), and operations on a BlobClient are available on BlobClient through BlobContainerClient#getBlobClient(String).

 

BlobServiceClient

시간 초과 (공용)

RuntimeException이 발생할 수 있는 선택적 시간 초과 값입니다.

 

기간

bridgeErrorHandler (consumer)

사용자가 Camel 라우팅 오류 핸들러로 브리징할 수 있습니다. 이는 소비자가 수신되는 메시지 또는 등을 선택하는 동안 예외가 발생한 것을 의미하며, 이제 라우팅 오류 처리기에 의해 처리되고 라우팅 오류 처리기에 의해 처리됩니다. 기본적으로 소비자는 org.apache.camel.spi.ExceptionHandler를 사용하여 WARN 또는 ERROR 수준에서 로깅되고 무시되는 예외를 처리합니다.

false

boolean

sendEmptyMessageWhenIdle (consumer)

폴링 소비자가 파일을 폴링하지 않은 경우 이 옵션을 활성화하여 대신 빈 메시지(체신 없음)를 보낼 수 있습니다.

false

boolean

exceptionHandler (consumer (advanced))

사용자가 사용자 정의 ExceptionHandler를 사용하도록 하려면 다음을 수행합니다. bridgeErrorHandler 옵션이 활성화되어 있으면 이 옵션을 사용하지 않습니다. 기본적으로 소비자는 예외를 처리하며 WARN 또는 ERROR 수준에서 로깅되고 무시됩니다.

 

ExceptionHandler

exchangePattern (consumer (advanced))

소비자가 교환을 만들 때 교환 패턴을 설정합니다.

CloudEvent 값:

  • InOnly
  • InOut
  • InOptionalOut
 

ExchangePattern

pollStrategy (consumer (advanced))

플러그형 org.apache.camel.PollingConsumerPollingStrategy를 사용하면 Exchange가 생성되고 Camel에서 라우팅되기 전에 일반적으로 폴링 작업 중에 발생한 오류 처리를 제어하기 위해 사용자 지정 구현을 제공할 수 있습니다.

 

PollingConsumerPollStrategy

BlobSequenceNumber (producer)

요청을 추적하는 데 사용할 수 있는 사용자 제어 값입니다. 순서 숫자의 값은 0에서 263~1 사이여야 합니다. 기본값은 0입니다.

0

long

blockListType (producer)

반환할 블록 유형을 지정합니다.

CloudEvent 값:

  • committed
  • uncommitted
  • all

COMMITTED

BlockListType

ChangeFeedContext (producer)

getChangeFeed 생산자 작업을 사용할 때 서비스 호출 중에 10.0.0.1 파이프라인을 통해 전달되는 추가 컨텍스트가 제공됩니다.

 

context

changeFeedEndTime (producer)

getChangeFeed 생산자 작업을 사용할 때 결과를 필터링하여 종료 시간 전 약으로 이벤트를 반환합니다. 참고: 다음 시간에 속하는 몇 개의 이벤트도 반환할 수 있습니다. 이 시간에 속하는 몇 가지 이벤트가 누락될 수 있습니다. 한 시간 동안의 모든 이벤트를 반환하려면 종료 시간을 1시간으로 반올림합니다.

 

OffsetDateTime

ChangeFeedStartTime (producer)

getChangeFeed 생산자 작업을 사용할 때 결과를 필터링하여 시작 시간 후 약으로 이벤트를 반환합니다. 참고: 이전 시간에 속한 몇 개의 이벤트도 반환할 수 있습니다. 이 시간에 속하는 몇 가지 이벤트가 누락될 수 있습니다. 한 시간 동안의 모든 이벤트를 반환하려면 시작 시간을 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 다운로드 링크의 기본 만료(millis)를 재정의합니다.

 

long

lazyStartProducer (producer)

첫 번째 메시지에서 생산자를 lazy로 시작해야 하는지 여부입니다. lazy를 시작하여 이를 사용하여 생산자가 시작되지 않고 생산자가 실패할 수 있는 상황에서 CamelContext 및 경로가 시작될 수 있도록 허용할 수 있습니다. 이 시작이 지연되도록 지연되면 Camel의 라우팅 오류 핸들러를 통해 메시지를 라우팅하는 동안 시작 실패를 처리할 수 있습니다. 첫 번째 메시지가 처리되면 프로듀서 생성 및 시작이 다소 시간이 걸릴 수 있으며 총 처리 시간이 길어질 수 있습니다.

false

boolean

작업 (producer)

생산자에서 이 구성 요소와 함께 사용할 수 있는 Blob 작업입니다.

CloudEvent 값:

  • listBlobContainers
  • createBlobContainer
  • deleteBlobContainer
  • listBlobs
  • getBlob
  • deleteBlob
  • downloadBlobToFile
  • downloadLink
  • uploadBlockBlob
  • stageBlockBlobList
  • commitBlobBlockList
  • getBlobBlockList
  • createAppendBlob
  • commitAppendBlob
  • createPageBlob
  • uploadPageBlob
  • resizePageBlob
  • clearPageBlob
  • getPageBlobRanges

listBlobContainers

BlobOperationsDefinition

pageBlobSize (producer)

최대 8TB 페이지 Blob의 최대 크기를 지정합니다. 페이지 Blob 크기는 512바이트 경계에 맞게 조정되어야 합니다.

512

long

backoffErrorThreshold (scheduler)

backoffMultipler가 시작하기 전에 발생해야 하는 후속 오류 폴링 수(일부 오류가 발생하여 발생함)입니다.

 

int

backoffIdleThreshold (scheduler)

backoffMultipler가 시작되기 전에 발생할 수 있는 후속 유휴 폴링 수입니다.

 

int

backoffMultiplier (scheduler)

예약된 폴링 소비자가 행에 후속 유휴/errors 수가 있는 경우 백오프하도록 합니다. 그런 다음 multiplier는 다음 실제 시도가 다시 발생하기 전에 건너뛸 폴링 수입니다. 이 옵션을 사용하는 경우 backoffIdleThreshold 및/또는 backoffErrorThreshold도 구성해야 합니다.

 

int

delay (scheduler)

다음 폴링 전의 밀리초입니다.

500

long

greedy (scheduler)

greedy가 활성화되면 이전 실행이 1개 이상의 메시지를 폴링한 경우 ScheduledPollConsumer가 즉시 다시 실행됩니다.

false

boolean

initialDelay (scheduler)

첫 번째 폴링이 시작되기 전의 밀리초입니다.

1000

long

repeatCount (scheduler)

최대 스레드 수 제한을 지정합니다. 따라서 1로 설정하면 스케줄러는 한 번만 실행됩니다. 이 값을 5로 설정하면 5번만 실행됩니다. 값이 0 또는 음수이면 영구적으로 발생합니다.

0

long

runLoggingLevel (scheduler)

소비자는 폴링할 때 시작/완전 로그 행을 기록합니다. 이 옵션을 사용하면 이에 대한 로깅 수준을 구성할 수 있습니다.

CloudEvent 값:

  • TRACE
  • DEBUG
  • INFO
  • WARN
  • ERROR
  • OFF

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

소비자에게 사용할 사용자 지정/공유 스레드 풀을 구성할 수 있습니다. 기본적으로 각 소비자는 자체 단일 스레드 스레드 풀이 있습니다.

 

ScheduledExecutorService

스케줄러 (scheduler)

cron 스케줄러를 사용하여 camel-spring 또는 camel-quartz 구성 요소를 사용합니다. 스케줄러로 빌드된 경우 value spring 또는 quartz를 사용합니다.

none

개체

schedulerProperties (scheduler)

사용자 지정 스케줄러 또는 Quartz, Spring 기반 스케줄러를 사용할 때 추가 속성을 구성하려면 다음을 수행합니다.

 

map

startScheduler (scheduler)

스케줄러를 자동으로 시작할지 여부입니다.

true

boolean

timeUnit (scheduler)

initialDelay 및 delay 옵션의 시간 단위입니다.

CloudEvent 값:

  • NANOSECONDS
  • MICROSECONDS
  • MILLISECONDS
  • SECONDS
  • 몇 분
  • 몇 시간
  • DAYS

MILLISECONDS

TimeUnit

UseFixedDelay (scheduler)

고정 지연 또는 고정 비율이 사용되는지 여부를 제어합니다. 자세한 내용은 ScheduledExecutorService in JDK를 참조하십시오.

true

boolean

AccessKey ( 보안)

Azure Blob 서비스의 인증에 사용할 연결된 azure 계정 이름에 대한 액세스 키입니다.

 

문자열

sourceBlobAccessKey (보안)

소스 Blob 액세스 키: copyblob 작업의 경우, 슬프게도 소스 Blob에 대한 accessKey가 있어야 헤더로 accessKey를 복사해야 하며, 키로 설정할 수 있도록 안전하지 않습니다.

 

문자열

필수 정보 옵션

이 구성 요소를 사용하려면 필요한 Azure 인증 정보를 제공하기 위해 세 가지 옵션이 있습니다.

  • Azure 계정에 accountNameaccessKey 를 제공하는 것이 가장 간단한 방법입니다. Azure Portal을 통해 accessKey를 생성할 수 있습니다.
  • 인증 정보 옵션에 제공할 수 있는 StorageSharedKeyCredential 인스턴스를 제공합니다.
  • BlobServiceClient 에 제공할 수 있는 BlobServiceClient 인스턴스를 제공합니다. 참고: BlockBlobClient와 같이 특정 클라이언트를 생성할 필요는 없으며 BlobServiceClient는 하위 수준의 클라이언트를 검색하는 데 사용할 수 있는 상위 수준을 나타냅니다.
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat