BlockBlobClient class

참조

패키지:: @azure/storage-blob

BlockBlobClient는 블록 Blob에 적용할 수 있는 작업 집합을 정의합니다.

Extends: BlobClient

생성자

BlockBlobClient(string, PipelineLike)	BlockBlobClient의 인스턴스를 만듭니다. 이 메서드는 블록 Blob을 가리키는 인코딩된 URL 또는 인코딩하지 않은 URL을 허용합니다. 인코딩된 URL 문자열은 두 번 이스케이프되지 않으며 URL 경로의 특수 문자만 이스케이프됩니다. Blob 이름에 ? 또는 %, Blob 이름은 URL에 인코딩되어야 합니다.
BlockBlobClient(string, StorageSharedKeyCredential \| AnonymousCredential \| TokenCredential, StoragePipelineOptions)	BlockBlobClient의 인스턴스를 만듭니다. 이 메서드는 블록 Blob을 가리키는 인코딩된 URL 또는 인코딩하지 않은 URL을 허용합니다. 인코딩된 URL 문자열은 두 번 이스케이프되지 않으며 URL 경로의 특수 문자만 이스케이프됩니다. Blob 이름에 ? 또는 %, Blob 이름은 URL에 인코딩되어야 합니다.
BlockBlobClient(string, string, string, StoragePipelineOptions)	BlockBlobClient의 인스턴스를 만듭니다.

속성

accountName
containerName	Blob이 연결된 스토리지 컨테이너의 이름입니다.
credential	AnonymousCredential, StorageSharedKeyCredential 또는 패키지의 `@azure/identity` 자격 증명과 같이 서비스에 대한 요청을 인증합니다. TokenCredential 인터페이스를 구현하는 개체를 제공할 수도 있습니다. 지정하지 않으면 AnonymousCredential이 사용됩니다.
name	blob의 이름입니다.
url	인코딩된 URL 문자열 값입니다.

메서드

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)	보류 중인 비동기 Blob 복사 작업을 중단하고 길이가 0이고 전체 메타데이터가 있는 대상 Blob을 남깁니다. 버전 2012-02-12 이상.
beginCopyFromURL(string, BlobBeginCopyFromURLOptions)	스토리지 계정 내의 대상에 Blob을 비동기적으로 복사합니다. 이 메서드는 복사가 완료될 때까지 무기한 대기할 수 있는 장기 실행 작업 폴러를 반환합니다. 또한 폴러에서 를 호출 `cancelOperation` 하여 복사본을 완료하기 전에 취소할 수도 있습니다. 첫 번째 요청에서 작업이 완료되고 완료된 복사본을 취소하려고 하면 오류가 throw되는 경우 onProgress 콜백이 호출되지 않습니다. 버전 2012-02-12 이상에서는 Blob 복사 작업의 원본이 모든 Azure Storage 계정에서 커밋된 Blob일 수 있습니다. 버전 2015-02-21부터 Blob 복사 작업의 원본은 모든 Azure Storage 계정의 Azure 파일일 수 있습니다. 다른 저장소 계정으로부터의 Blob 복사 작업은 2012년 6월 7일 이후 생성된 저장소 계정에서만 허용됩니다.
commitBlockList(string[], BlockBlobCommitBlockListOptions)	blob를 구성하는 블록 ID 목록을 지정하여 blob에 기록합니다. blob 일부로 기록하기 위해서는 이전 <xref:stageBlock> 작업에서 서버에 블록이 성공적으로 기록되어 있어야 합니다. <xref:commitBlockList>를 호출하면 변경된 블록만 업데이트하고 신규 및 기존 블록을 함께 커밋하여 blob를 업데이트할 수 있습니다. 블록 목록에 지정되지 않고 영구적으로 삭제된 모든 블록입니다.
createSnapshot(BlobCreateSnapshotOptions)	Blob의 읽기 전용 스냅숏을 만듭니다.
delete(BlobDeleteOptions)	삭제할 지정된 Blob 또는 스냅샷을 표시합니다. 이 blob는 나중에 가비지 수집 중에 삭제됩니다. Blob을 삭제하려면 해당 스냅숏을 모두 삭제해야 합니다. Blob 삭제 작업과 동시에 둘 다 삭제할 수 있습니다.
deleteIfExists(BlobDeleteOptions)	삭제할 지정된 Blob 또는 스냅샷(있는 경우)을 표시합니다. 이 blob는 나중에 가비지 수집 중에 삭제됩니다. Blob을 삭제하려면 해당 스냅숏을 모두 삭제해야 합니다. Blob 삭제 작업과 동시에 둘 다 삭제할 수 있습니다.
deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)	Blob에서 immutablility 정책을 삭제합니다.
download(number, number, BlobDownloadOptions)	메타데이터 및 속성을 포함하여 시스템에서 Blob을 읽거나 다운로드합니다. Blob 가져오기를 호출하여 스냅샷을 읽을 수도 있습니다. Node.js 데이터는 읽기 가능한 스트림 readableStreamBody에서 반환됩니다. 브라우저에서 데이터는 promise blobBody로 반환됩니다.
downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)	NODE.JS 런타임에서만 사용할 수 있습니다. 버퍼에 병렬로 Azure Blob을 다운로드합니다. 오프셋 및 개수는 선택 사항이며, 제공되지 않은 경우 전체 Blob을 다운로드합니다. 경고: 버퍼는 Node.js/V8의 제한으로 인해 32비트 시스템에서 최대 1GB 또는 64비트 시스템에서 약 2GB의 파일만 지원할 수 있습니다. 이 크기보다 큰 Blob의 경우 를 고려합니다 <xref:downloadToFile>.
downloadToBuffer(number, number, BlobDownloadToBufferOptions)	NODE.JS 런타임에서만 사용할 수 있습니다. 버퍼에 병렬로 Azure Blob을 다운로드합니다. 오프셋 및 개수는 선택 사항이며, 제공되지 않은 경우 전체 Blob을 다운로드합니다. 경고: 버퍼는 Node.js/V8의 제한으로 인해 32비트 시스템에서 최대 1GB 또는 64비트 시스템에서 약 2GB의 파일만 지원할 수 있습니다. 이 크기보다 큰 Blob의 경우 를 고려합니다 <xref:downloadToFile>.
downloadToFile(string, number, number, BlobDownloadOptions)	NODE.JS 런타임에서만 사용할 수 있습니다. 로컬 파일에 Azure Blob을 다운로드합니다. 지정된 파일 경로가 이미 종료되면 실패합니다. 오프셋 및 개수는 선택 사항이며, 전체 Blob을 다운로드하기 위해 각각 0 및 undefined를 전달합니다.
exists(BlobExistsOptions)	이 클라이언트가 나타내는 Azure Blob 리소스가 있으면 true를 반환합니다. false이면 이고, 그렇지 않으면 입니다. 참고: 기존 Blob이 다른 클라이언트 또는 애플리케이션에서 삭제될 수 있기 때문에 이 함수를 주의해서 사용합니다. 그 반대의 경우 이 함수가 완료된 후 다른 클라이언트 또는 애플리케이션에서 새 Blob을 추가할 수 있습니다.
generateSasUrl(BlobGenerateSasUrlOptions)	공유 키 자격 증명을 사용하여 생성된 BlobClient에만 사용할 수 있습니다. 전달된 클라이언트 속성 및 매개 변수를 기반으로 Blob Service SAS(공유 액세스 서명) URI를 생성합니다. SAS는 클라이언트의 공유 키 자격 증명으로 서명됩니다.
getAppendBlobClient()	AppendBlobClient 개체를 만듭니다.
getBlobLeaseClient(string)	<xref:BlobLeaseClient> Blob에서 임대를 관리하는 를 가져옵니다.
getBlockBlobClient()	BlockBlobClient 개체를 만듭니다.
getBlockList(BlockListType, BlockBlobGetBlockListOptions)	지정된 블록 목록 필터를 사용하여 블록 Blob의 일부로 업로드된 블록 목록을 반환합니다.
getPageBlobClient()	PageBlobClient 개체를 만듭니다.
getProperties(BlobGetPropertiesOptions)	blob에 대한 모든 사용자 정의 메타데이터, 표준 HTTP 속성 및 시스템 속성을 반환합니다. blob의 콘텐츠는 반환하지 않습니다.
getTags(BlobGetTagsOptions)	기본 Blob과 연결된 태그를 가져옵니다.
query(string, BlockBlobQueryOptions)	NODE.JS 런타임에서만 사용할 수 있습니다. JSON 또는 CSV 형식 Blob에 대한 빠른 쿼리입니다. 예제 사용량(Node.js): // Query and convert a blob to a string const queryBlockBlobResponse = await blockBlobClient.query("select * from BlobStorage"); const downloaded = (await streamToBuffer(queryBlockBlobResponse.readableStreamBody)).toString(); console.log("Query blob content:", downloaded); async function streamToBuffer(readableStream) { return new Promise((resolve, reject) => { const chunks = []; readableStream.on("data", (data) => { chunks.push(data instanceof Buffer ? data : Buffer.from(data)); }); readableStream.on("end", () => { resolve(Buffer.concat(chunks)); }); readableStream.on("error", reject); }); }
setAccessTier(BlockBlobTier \| PremiumPageBlobTier \| string, BlobSetTierOptions)	Blob에서 계층을 설정합니다. 작업은 Premium Storage 계정의 페이지 Blob 및 Blob Storage 계정의 블록 Blob에서 허용됩니다(로컬 중복 스토리지에만 해당). 프리미엄 페이지 Blob 계층은 Blob의 허용되는 크기, IOPS 및 대역폭을 결정합니다. 블록 Blob의 계층은 핫/쿨/보관 스토리지 유형을 결정합니다. 이 작업은 Blob의 ETag를 업데이트하지 않습니다.
setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)	Blob의 시스템 속성을 설정합니다. 값이 제공되지 않거나 지정된 Blob HTTP 헤더에 대해 제공된 값이 없는 경우 값이 없는 이러한 Blob HTTP 헤더는 지워질 것입니다.
setImmutabilityPolicy(BlobImmutabilityPolicy, BlobSetImmutabilityPolicyOptions)	Blob에서 immutablility 정책을 설정합니다.
setLegalHold(boolean, BlobSetLegalHoldOptions)	Blob에 대한 법적 보존을 설정합니다.
setMetadata(Metadata, BlobSetMetadataOptions)	하나 이상의 이름 값 쌍으로 지정된 Blob에 대한 사용자 정의 메타데이터를 설정합니다. 옵션이 제공되지 않거나 매개 변수에 정의된 메타데이터가 없는 경우 Blob 메타데이터가 제거됩니다.
setTags(Tags, BlobSetTagsOptions)	기본 Blob에 태그를 설정합니다. Blob에는 최대 10개의 태그가 있을 수 있습니다. 태그 키는 1~128자 사이여야 합니다. 태그 값은 0~256자 사이여야 합니다. 유효한 태그 키 및 값 문자에는 소문자 및 대문자, 숫자(0-9), 공백(''), 더하기('+'), 빼기('-'), 마침표('.'), 슬래시('/'), 콜론(':'), 등호('=') 및 밑줄('_')이 포함됩니다.
stageBlock(string, HttpRequestBody, number, BlockBlobStageBlockOptions)	지정된 블록을 블록 Blob의 "준비 영역"에 업로드하여 나중에 commitBlockList를 호출하여 커밋합니다.
stageBlockFromURL(string, string, number, number, BlockBlobStageBlockFromURLOptions)	URL에서 차단 단계 작업은 URL에서 콘텐츠를 읽는 Blob의 일부로 커밋할 새 블록을 만듭니다. 이 API는 버전 2018-03-28부터 사용할 수 있습니다.
syncCopyFromURL(string, BlobSyncCopyFromURLOptions)	동기 URL에서 복사 작업은 Blob 또는 인터넷 리소스를 새 Blob에 복사합니다. 복사가 완료될 때까지 응답을 반환하지 않습니다.
syncUploadFromURL(string, BlockBlobSyncUploadFromURLOptions)	지정된 URL에서 Blob의 내용을 읽는 새 블록 Blob을 만듭니다. 이 API는 2020-04-08 버전부터 지원됩니다. URL에서 Blob 배치에서는 부분 업데이트가 지원되지 않습니다. 기존 Blob의 콘텐츠는 새 Blob의 콘텐츠로 덮어씁니다. 원본 URL을 사용하여 블록 Blob의 콘텐츠에 대한 부분 업데이트를 수행하려면 및 <xref:commitBlockList>를 사용합니다<xref:stageBlockFromURL>.
undelete(BlobUndeleteOptions)	일시 삭제된 Blob 및 연결된 일시 삭제된 스냅샷의 내용과 메타데이터를 복원합니다. 삭제 취소 Blob은 버전 2017-07-29 이상에서만 지원됩니다.
upload(HttpRequestBody, number, BlockBlobUploadOptions)	새 블록 Blob을 만들거나 기존 블록 Blob의 콘텐츠를 업데이트합니다. 기존 블록 Blob을 업데이트하면 blob에 있는 기존 메타데이터를 덮어씁니다. 부분 업데이트는 지원되지 않습니다. 기존 Blob의 콘텐츠를 새 콘텐츠로 덮어씁니다. 블록 Blob의 부분 업데이트를 수행하려면 및 <xref:commitBlockList>를 사용합니다<xref:stageBlock>. 병렬이 아닌 업로드 방법입니다. 동시성 업로드를 통해 성능을 향상시키려면 를 <xref:uploadStream> 사용<xref:uploadFile>하세요<xref:uploadBrowserData>.
uploadBrowserData(Blob \| ArrayBuffer \| ArrayBufferView, BlockBlobParallelUploadOptions)	브라우저에서만 사용할 수 있습니다. Blob/File/ArrayBuffer/ArrayBufferView 브라우저를 업로드하여 Blob을 차단합니다. 버퍼 길이가 256MB보다 작거나 같은 경우 이 메서드는 1개 업로드 호출을 사용하여 업로드를 완료합니다. 그렇지 않으면 이 메서드는 를 호출 <xref:stageBlock> 하여 블록을 업로드하고 마지막으로 를 호출 <xref:commitBlockList> 하여 블록 목록을 커밋합니다. 설정하는 일반적인 <xref:BlockBlobParallelUploadOptions.blobHTTPHeaders> 옵션은 이며 `blobContentType`, 브라우저가 파일 형식에 따라 기능을 제공할 수 있도록 합니다.
uploadData(Buffer \| Blob \| ArrayBuffer \| ArrayBufferView, BlockBlobParallelUploadOptions)	Buffer(Node.js)/Blob(browsers)/ArrayBuffer/ArrayBufferView 개체를 BlockBlob에 업로드합니다. 데이터 길이가 지정된 <xref:BlockBlobParallelUploadOptions.maxSingleShotSize> 값(기본값)보다 작으면 이 메서드는 <xref:BLOCK_BLOB_MAX_UPLOAD_BLOB_BYTES>1 <xref:upload> 개 호출을 사용하여 업로드를 완료합니다. 그렇지 않으면 이 메서드는 를 호출 <xref:stageBlock> 하여 블록을 업로드하고 마지막으로 를 호출 <xref:commitBlockList> 하여 블록 목록을 커밋합니다. 설정하는 일반적인 <xref:BlockBlobParallelUploadOptions.blobHTTPHeaders> 옵션은 이며 `blobContentType`, 브라우저가 파일 형식에 따라 기능을 제공할 수 있도록 합니다.
uploadFile(string, BlockBlobParallelUploadOptions)	NODE.JS 런타임에서만 사용할 수 있습니다. 블록의 로컬 파일을 블록 Blob에 업로드합니다. 파일 크기가 256MB보다 작거나 같은 경우 이 메서드는 1개 업로드 호출을 사용하여 업로드를 완료합니다. 그렇지 않으면 이 메서드는 stageBlock을 호출하여 블록을 업로드하고 마지막으로 commitBlockList를 호출하여 블록 목록을 커밋합니다.
uploadStream(Readable, number, number, BlockBlobUploadStreamOptions)	NODE.JS 런타임에서만 사용할 수 있습니다. Node.js 읽기 가능한 스트림을 블록 Blob에 업로드합니다. 성능 향상 팁: 입력 스트림 highWaterMark는 buffer.concat() 작업을 방지하는 bufferSize 매개 변수를 사용하여 동일한 값을 설정하는 것이 좋습니다.
withSnapshot(string)	원본과 동일하지만 지정된 스냅샷 타임스탬프를 사용하여 새 BlockBlobClient 개체를 만듭니다. ""을 입력하면 스냅샷이 제거되고 URL이 기본 Blob으로 반환됩니다.
withVersion(string)	이 Blob의 버전을 가리키는 새 BlobClient 개체를 만듭니다. ""을 입력하면 versionId가 제거되고 클라이언트가 기본 Blob으로 반환됩니다.

생성자 세부 정보

BlockBlobClient(string, PipelineLike)

BlockBlobClient의 인스턴스를 만듭니다. 이 메서드는 블록 Blob을 가리키는 인코딩된 URL 또는 인코딩하지 않은 URL을 허용합니다. 인코딩된 URL 문자열은 두 번 이스케이프되지 않으며 URL 경로의 특수 문자만 이스케이프됩니다. Blob 이름에 ? 또는 %, Blob 이름은 URL에 인코딩되어야 합니다.

new BlockBlobClient(url: string, pipeline: PipelineLike)

매개 변수

url: string

Azure Storage 블록 Blob(예: "https://myaccount.blob.core.windows.net/mycontainer/blockblob")을 가리키는 URL 문자열입니다. AnonymousCredential(예: "https://myaccount.blob.core.windows.net/mycontainer/blockblob?sasString")을 사용하는 경우 SAS를 추가할 수 있습니다. 이 메서드는 Blob을 가리키는 인코딩된 URL 또는 인코딩하지 않은 URL을 허용합니다. 인코딩된 URL 문자열은 두 번 이스케이프되지 않으며 URL 경로의 특수 문자만 이스케이프됩니다. 그러나 Blob 이름에 ? 또는 %, Blob 이름은 URL에 인코딩되어야 합니다. "my?blob%"이라는 Blob과 같이 URL은 "https://myaccount.blob.core.windows.net/mycontainer/my%3Fblob%25"이어야 합니다.

pipeline: PipelineLike

newPipeline()을 호출하여 기본 파이프라인을 만들거나 사용자 지정된 파이프라인을 제공합니다.

BlockBlobClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

new BlockBlobClient(url: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)

매개 변수

url: string

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

AnonymousCredential, StorageSharedKeyCredential 또는 패키지의 @azure/identity 자격 증명과 같이 서비스에 대한 요청을 인증합니다. TokenCredential 인터페이스를 구현하는 개체를 제공할 수도 있습니다. 지정하지 않으면 AnonymousCredential이 사용됩니다.

options: StoragePipelineOptions

(선택 사항) HTTP 파이프라인을 구성하는 옵션입니다.

BlockBlobClient(string, string, string, StoragePipelineOptions)

BlockBlobClient의 인스턴스를 만듭니다.

new BlockBlobClient(connectionString: string, containerName: string, blobName: string, options?: StoragePipelineOptions)

매개 변수

connectionString: string

계정 연결 문자열 또는 Azure Storage 계정의 SAS 연결 문자열입니다. [ 참고 - 계정 연결 문자열은 NODE.JS 런타임에서만 사용할 수 있습니다. ] 계정 연결 문자열 예제 -DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net SAS 연결 문자열 예제 - BlobEndpoint=https://myaccount.blob.core.windows.net/;QueueEndpoint=https://myaccount.queue.core.windows.net/;FileEndpoint=https://myaccount.file.core.windows.net/;TableEndpoint=https://myaccount.table.core.windows.net/;SharedAccessSignature=sasString

containerName: string

컨테이너 이름

blobName: string

Blob 이름입니다.

options: StoragePipelineOptions

(선택 사항) HTTP 파이프라인을 구성하는 옵션입니다.

속성 세부 정보

accountName

accountName: string

속성 값

string

containerName

Blob이 연결된 스토리지 컨테이너의 이름입니다.

string containerName

속성 값

string

credential

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

속성 값

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

name

blob의 이름입니다.

string name

속성 값

string

url

인코딩된 URL 문자열 값입니다.

url: string

속성 값

string

메서드 세부 정보

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)

보류 중인 비동기 Blob 복사 작업을 중단하고 길이가 0이고 전체 메타데이터가 있는 대상 Blob을 남깁니다. 버전 2012-02-12 이상.

function abortCopyFromURL(copyId: string, options?: BlobAbortCopyFromURLOptions)

매개 변수

copyId: string

URL에서 복사 작업의 ID입니다.

options: BlobAbortCopyFromURLOptions

Blob URL에서 복사 중단 작업에 대한 선택적 옵션입니다.

반환

Promise<BlobAbortCopyFromURLResponse>

beginCopyFromURL(string, BlobBeginCopyFromURLOptions)

스토리지 계정 내의 대상에 Blob을 비동기적으로 복사합니다. 이 메서드는 복사가 완료될 때까지 무기한 대기할 수 있는 장기 실행 작업 폴러를 반환합니다. 또한 폴러에서 를 호출 cancelOperation 하여 복사본을 완료하기 전에 취소할 수도 있습니다. 첫 번째 요청에서 작업이 완료되고 완료된 복사본을 취소하려고 하면 오류가 throw되는 경우 onProgress 콜백이 호출되지 않습니다. 버전 2012-02-12 이상에서는 Blob 복사 작업의 원본이 모든 Azure Storage 계정에서 커밋된 Blob일 수 있습니다. 버전 2015-02-21부터 Blob 복사 작업의 원본은 모든 Azure Storage 계정의 Azure 파일일 수 있습니다. 다른 저장소 계정으로부터의 Blob 복사 작업은 2012년 6월 7일 이후 생성된 저장소 계정에서만 허용됩니다.

function beginCopyFromURL(copySource: string, options?: BlobBeginCopyFromURLOptions)

매개 변수

copySource: string

원본 Azure Blob/File에 대한 URL입니다.

options: BlobBeginCopyFromURLOptions

Blob URL에서 복사 시작 작업에 대한 선택적 옵션입니다.

반환

Promise<PollerLike<PollOperationState<BlobBeginCopyFromURLResponse>, BlobBeginCopyFromURLResponse>>

commitBlockList(string[], BlockBlobCommitBlockListOptions)

blob를 구성하는 블록 ID 목록을 지정하여 blob에 기록합니다. blob 일부로 기록하기 위해서는 이전 <xref:stageBlock> 작업에서 서버에 블록이 성공적으로 기록되어 있어야 합니다. <xref:commitBlockList>를 호출하면 변경된 블록만 업데이트하고 신규 및 기존 블록을 함께 커밋하여 blob를 업데이트할 수 있습니다. 블록 목록에 지정되지 않고 영구적으로 삭제된 모든 블록입니다.

function commitBlockList(blocks: string[], options?: BlockBlobCommitBlockListOptions)

매개 변수

blocks: string[]

base64로 인코딩된 64비트 값의 배열

options: BlockBlobCommitBlockListOptions

블록 Blob 커밋 블록 목록 작업에 대한 옵션입니다.

반환

Promise<BlockBlobCommitBlockListResponse>

블록 Blob 커밋 블록 목록 작업에 대한 응답 데이터입니다.

createSnapshot(BlobCreateSnapshotOptions)

Blob의 읽기 전용 스냅숏을 만듭니다.

function createSnapshot(options?: BlobCreateSnapshotOptions)

매개 변수

options: BlobCreateSnapshotOptions

Blob 스냅샷 만들기 작업에 대한 선택적 옵션입니다.

반환

Promise<BlobCreateSnapshotResponse>

delete(BlobDeleteOptions)

삭제할 지정된 Blob 또는 스냅샷을 표시합니다. 이 blob는 나중에 가비지 수집 중에 삭제됩니다. Blob을 삭제하려면 해당 스냅숏을 모두 삭제해야 합니다. Blob 삭제 작업과 동시에 둘 다 삭제할 수 있습니다.

function delete(options?: BlobDeleteOptions)

매개 변수

options: BlobDeleteOptions

Blob 삭제 작업에 대한 선택적 옵션입니다.

반환

Promise<BlobDeleteResponse>

deleteIfExists(BlobDeleteOptions)

삭제할 지정된 Blob 또는 스냅샷(있는 경우)을 표시합니다. 이 blob는 나중에 가비지 수집 중에 삭제됩니다. Blob을 삭제하려면 해당 스냅숏을 모두 삭제해야 합니다. Blob 삭제 작업과 동시에 둘 다 삭제할 수 있습니다.

function deleteIfExists(options?: BlobDeleteOptions)

매개 변수

options: BlobDeleteOptions

Blob 삭제 작업에 대한 선택적 옵션입니다.

반환

Promise<BlobDeleteIfExistsResponse>

deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)

Blob에서 immutablility 정책을 삭제합니다.

function deleteImmutabilityPolicy(options?: BlobDeleteImmutabilityPolicyOptions)

매개 변수

options: BlobDeleteImmutabilityPolicyOptions

Blob에서 불변성 정책을 삭제하는 선택적 옵션입니다.

반환

Promise<BlobDeleteImmutabilityPolicyResponse>

download(number, number, BlobDownloadOptions)

메타데이터 및 속성을 포함하여 시스템에서 Blob을 읽거나 다운로드합니다. Blob 가져오기를 호출하여 스냅샷을 읽을 수도 있습니다.

Node.js 데이터는 읽기 가능한 스트림 readableStreamBody에서 반환됩니다.
브라우저에서 데이터는 promise blobBody로 반환됩니다.

function download(offset?: number, count?: number, options?: BlobDownloadOptions)

매개 변수

offset: number

다운로드할 Blob의 위치(0보다 크거나 같음)

count: number

다운로드할 데이터의 양(0보다 큼)입니다. 정의되지 않은 경우 끝까지 다운로드됩니다.

options: BlobDownloadOptions

Blob 다운로드 작업에 대한 선택적 옵션입니다.

예제 사용량(Node.js):

// Download and convert a blob to a string
const downloadBlockBlobResponse = await blobClient.download();
const downloaded = await streamToBuffer(downloadBlockBlobResponse.readableStreamBody);
console.log("Downloaded blob content:", downloaded.toString());

async function streamToBuffer(readableStream) {
return new Promise((resolve, reject) => {
const chunks = [];
readableStream.on("data", (data) => {
chunks.push(data instanceof Buffer ? data : Buffer.from(data));
});
readableStream.on("end", () => {
resolve(Buffer.concat(chunks));
});
readableStream.on("error", reject);
});
}

사용 예(브라우저):

// Download and convert a blob to a string
const downloadBlockBlobResponse = await blobClient.download();
const downloaded = await blobToString(await downloadBlockBlobResponse.blobBody);
console.log(
  "Downloaded blob content",
  downloaded
);

async function blobToString(blob: Blob): Promise<string> {
  const fileReader = new FileReader();
  return new Promise<string>((resolve, reject) => {
    fileReader.onloadend = (ev: any) => {
      resolve(ev.target!.result);
    };
    fileReader.onerror = reject;
    fileReader.readAsText(blob);
  });
}

반환

Promise<BlobDownloadResponseParsed>

downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)

NODE.JS 런타임에서만 사용할 수 있습니다. 버퍼에 병렬로 Azure Blob을 다운로드합니다. 오프셋 및 개수는 선택 사항이며, 제공되지 않은 경우 전체 Blob을 다운로드합니다.

경고: 버퍼는 Node.js/V8의 제한으로 인해 32비트 시스템에서 최대 1GB 또는 64비트 시스템에서 약 2GB의 파일만 지원할 수 있습니다. 이 크기보다 큰 Blob의 경우 를 고려합니다 <xref:downloadToFile>.

function downloadToBuffer(buffer: Buffer, offset?: number, count?: number, options?: BlobDownloadToBufferOptions)

매개 변수

buffer: Buffer

채울 버퍼, 개수보다 큰 길이가 있어야 합니다.

offset: number

다운로드할 블록 Blob의 위치(바이트)

count: number

다운로드할 데이터 양(바이트)입니다. 정의되지 않은 전달 시 끝까지 다운로드됩니다.

options: BlobDownloadToBufferOptions

BlobDownloadToBufferOptions

반환

Promise<Buffer>

downloadToBuffer(number, number, BlobDownloadToBufferOptions)

function downloadToBuffer(offset?: number, count?: number, options?: BlobDownloadToBufferOptions)

매개 변수

offset: number

다운로드할 블록 Blob의 위치(바이트)

count: number

다운로드할 데이터 양(바이트)입니다. 정의되지 않은 전달 시 끝까지 다운로드됩니다.

options: BlobDownloadToBufferOptions

BlobDownloadToBufferOptions

반환

Promise<Buffer>

downloadToFile(string, number, number, BlobDownloadOptions)

NODE.JS 런타임에서만 사용할 수 있습니다. 로컬 파일에 Azure Blob을 다운로드합니다. 지정된 파일 경로가 이미 종료되면 실패합니다. 오프셋 및 개수는 선택 사항이며, 전체 Blob을 다운로드하기 위해 각각 0 및 undefined를 전달합니다.

function downloadToFile(filePath: string, offset?: number, count?: number, options?: BlobDownloadOptions)

매개 변수

filePath: string

offset: number

다운로드할 블록 Blob의 위치입니다.

count: number

다운로드할 데이터의 양입니다. 정의되지 않은 을 전달할 때 끝까지 다운로드됩니다.

options: BlobDownloadOptions

Blob 다운로드 옵션에 대한 옵션입니다.

반환

Promise<BlobDownloadResponseParsed>

Blob 다운로드 작업에 대한 응답 데이터이지만 해당 콘텐츠가 이미 읽고 지정된 경로의 로컬 파일에 기록되어 있으므로 readableStreamBody가 정의되지 않음으로 설정됩니다.

exists(BlobExistsOptions)

이 클라이언트가 나타내는 Azure Blob 리소스가 있으면 true를 반환합니다. false이면 이고, 그렇지 않으면 입니다. 참고: 기존 Blob이 다른 클라이언트 또는 애플리케이션에서 삭제될 수 있기 때문에 이 함수를 주의해서 사용합니다. 그 반대의 경우 이 함수가 완료된 후 다른 클라이언트 또는 애플리케이션에서 새 Blob을 추가할 수 있습니다.

function exists(options?: BlobExistsOptions)

매개 변수

options: BlobExistsOptions

옵션은 Exists 작업입니다.

반환

Promise<boolean>

generateSasUrl(BlobGenerateSasUrlOptions)

공유 키 자격 증명을 사용하여 생성된 BlobClient에만 사용할 수 있습니다. 전달된 클라이언트 속성 및 매개 변수를 기반으로 Blob Service SAS(공유 액세스 서명) URI를 생성합니다. SAS는 클라이언트의 공유 키 자격 증명으로 서명됩니다.

function generateSasUrl(options: BlobGenerateSasUrlOptions)

매개 변수

options: BlobGenerateSasUrlOptions

선택적 매개 변수입니다.

반환

Promise<string>

이 클라이언트가 나타내는 리소스에 대한 URI와 생성된 SAS 토큰으로 구성된 SAS URI입니다.

getAppendBlobClient()

AppendBlobClient 개체를 만듭니다.

function getAppendBlobClient()

반환

AppendBlobClient

getBlobLeaseClient(string)

<xref:BlobLeaseClient> Blob에서 임대를 관리하는 를 가져옵니다.

function getBlobLeaseClient(proposeLeaseId?: string)

매개 변수

proposeLeaseId: string

처음 제안된 임대 ID입니다.

반환

BlobLeaseClient

Blob에서 임대를 관리하기 위한 새 BlobLeaseClient 개체입니다.

getBlockBlobClient()

BlockBlobClient 개체를 만듭니다.

function getBlockBlobClient()

반환

BlockBlobClient

getBlockList(BlockListType, BlockBlobGetBlockListOptions)

지정된 블록 목록 필터를 사용하여 블록 Blob의 일부로 업로드된 블록 목록을 반환합니다.

function getBlockList(listType: BlockListType, options?: BlockBlobGetBlockListOptions)

매개 변수

listType: BlockListType

커밋된 블록 목록, 커밋되지 않은 블록 목록 또는 두 목록을 함께 반환할지 여부를 지정합니다.

options: BlockBlobGetBlockListOptions

블록 Blob 블록 목록 가져오기 작업에 대한 옵션입니다.

반환

Promise<BlockBlobGetBlockListResponse>

블록 Blob 블록 목록 가져오기 작업에 대한 응답 데이터입니다.

getPageBlobClient()

PageBlobClient 개체를 만듭니다.

function getPageBlobClient()

반환

PageBlobClient

getProperties(BlobGetPropertiesOptions)

blob에 대한 모든 사용자 정의 메타데이터, 표준 HTTP 속성 및 시스템 속성을 반환합니다. blob의 콘텐츠는 반환하지 않습니다.

function getProperties(options?: BlobGetPropertiesOptions)

매개 변수

options: BlobGetPropertiesOptions

속성 가져오기 작업에 대한 선택적 옵션입니다.

반환

Promise<BlobGetPropertiesResponse>

getTags(BlobGetTagsOptions)

기본 Blob과 연결된 태그를 가져옵니다.

function getTags(options?: BlobGetTagsOptions)

매개 변수

options: BlobGetTagsOptions

반환

Promise<BlobGetTagsResponse>

query(string, BlockBlobQueryOptions)

NODE.JS 런타임에서만 사용할 수 있습니다. JSON 또는 CSV 형식 Blob에 대한 빠른 쿼리입니다.

예제 사용량(Node.js):

// Query and convert a blob to a string
const queryBlockBlobResponse = await blockBlobClient.query("select * from BlobStorage");
const downloaded = (await streamToBuffer(queryBlockBlobResponse.readableStreamBody)).toString();
console.log("Query blob content:", downloaded);

async function streamToBuffer(readableStream) {
  return new Promise((resolve, reject) => {
    const chunks = [];
    readableStream.on("data", (data) => {
      chunks.push(data instanceof Buffer ? data : Buffer.from(data));
    });
    readableStream.on("end", () => {
      resolve(Buffer.concat(chunks));
    });
    readableStream.on("error", reject);
  });
}

function query(query: string, options?: BlockBlobQueryOptions)

매개 변수

query: string

options: BlockBlobQueryOptions

반환

Promise<BlobDownloadResponseModel>

setAccessTier(BlockBlobTier | PremiumPageBlobTier | string, BlobSetTierOptions)

Blob에서 계층을 설정합니다. 작업은 Premium Storage 계정의 페이지 Blob 및 Blob Storage 계정의 블록 Blob에서 허용됩니다(로컬 중복 스토리지에만 해당). 프리미엄 페이지 Blob 계층은 Blob의 허용되는 크기, IOPS 및 대역폭을 결정합니다. 블록 Blob의 계층은 핫/쿨/보관 스토리지 유형을 결정합니다. 이 작업은 Blob의 ETag를 업데이트하지 않습니다.

function setAccessTier(tier: BlockBlobTier | PremiumPageBlobTier | string, options?: BlobSetTierOptions)

매개 변수

tier: BlockBlobTier | PremiumPageBlobTier | string

Blob에 설정할 계층입니다. 유효한 값은 핫, 쿨 또는 보관입니다.

options: BlobSetTierOptions

Blob 계층 설정 작업에 대한 선택적 옵션입니다.

반환

Promise<BlobSetTierResponse>

setHTTPHeaders(BlobHTTPHeaders, BlobSetHTTPHeadersOptions)

Blob의 시스템 속성을 설정합니다. 값이 제공되지 않거나 지정된 Blob HTTP 헤더에 대해 제공된 값이 없는 경우 값이 없는 이러한 Blob HTTP 헤더는 지워질 것입니다.

function setHTTPHeaders(blobHTTPHeaders?: BlobHTTPHeaders, options?: BlobSetHTTPHeadersOptions)

매개 변수

blobHTTPHeaders: BlobHTTPHeaders

값이 제공되지 않거나 지정된 Blob HTTP 헤더에 대해 제공된 값이 없는 경우 값이 없는 이러한 Blob HTTP 헤더는 지워질 것입니다. 설정하는 일반적인 헤더는 blobContentType 브라우저가 파일 형식에 따라 기능을 제공할 수 있도록 하는 것입니다.

options: BlobSetHTTPHeadersOptions

Blob HTTP 헤더 설정 작업에 대한 선택적 옵션입니다.

반환

Promise<BlobSetHTTPHeadersResponse>

setImmutabilityPolicy(BlobImmutabilityPolicy, BlobSetImmutabilityPolicyOptions)

Blob에서 immutablility 정책을 설정합니다.

function setImmutabilityPolicy(immutabilityPolicy: BlobImmutabilityPolicy, options?: BlobSetImmutabilityPolicyOptions)

매개 변수

immutabilityPolicy: BlobImmutabilityPolicy

options: BlobSetImmutabilityPolicyOptions

Blob에서 불변성 정책을 설정하는 옵션입니다.

반환

Promise<BlobSetImmutabilityPolicyResponse>

setLegalHold(boolean, BlobSetLegalHoldOptions)

Blob에 대한 법적 보존을 설정합니다.

function setLegalHold(legalHoldEnabled: boolean, options?: BlobSetLegalHoldOptions)

매개 변수

legalHoldEnabled: boolean

options: BlobSetLegalHoldOptions

Blob에 대한 법적 보존을 설정하는 선택적 옵션입니다.

반환

Promise<BlobSetLegalHoldResponse>

setMetadata(Metadata, BlobSetMetadataOptions)

하나 이상의 이름 값 쌍으로 지정된 Blob에 대한 사용자 정의 메타데이터를 설정합니다. 옵션이 제공되지 않거나 매개 변수에 정의된 메타데이터가 없는 경우 Blob 메타데이터가 제거됩니다.

function setMetadata(metadata?: Metadata, options?: BlobSetMetadataOptions)

매개 변수

metadata: Metadata

기존 메타데이터를 이 값으로 대체합니다. 제공된 값이 없으면 기존 메타데이터가 제거됩니다.

options: BlobSetMetadataOptions

메타데이터 설정 작업에 대한 선택적 옵션입니다.

반환

Promise<BlobSetMetadataResponse>

setTags(Tags, BlobSetTagsOptions)

기본 Blob에 태그를 설정합니다. Blob에는 최대 10개의 태그가 있을 수 있습니다. 태그 키는 1~128자 사이여야 합니다. 태그 값은 0~256자 사이여야 합니다. 유효한 태그 키 및 값 문자에는 소문자 및 대문자, 숫자(0-9), 공백(''), 더하기('+'), 빼기('-'), 마침표('.'), 슬래시('/'), 콜론(':'), 등호('=') 및 밑줄('_')이 포함됩니다.

function setTags(tags: Tags, options?: BlobSetTagsOptions)

매개 변수

tags: Tags

options: BlobSetTagsOptions

반환

Promise<BlobSetTagsResponse>

stageBlock(string, HttpRequestBody, number, BlockBlobStageBlockOptions)

지정된 블록을 블록 Blob의 "준비 영역"에 업로드하여 나중에 commitBlockList를 호출하여 커밋합니다.

function stageBlock(blockId: string, body: HttpRequestBody, contentLength: number, options?: BlockBlobStageBlockOptions)

매개 변수

blockId: string

base64로 인코딩된 64비트 값

body: HttpRequestBody

준비 영역에 업로드할 데이터입니다.

contentLength: number

업로드할 바이트 수입니다.

options: BlockBlobStageBlockOptions

블록 Blob 단계 블록 작업에 대한 옵션입니다.

반환

Promise<BlockBlobStageBlockResponse>

블록 Blob 단계 블록 작업에 대한 응답 데이터입니다.

stageBlockFromURL(string, string, number, number, BlockBlobStageBlockFromURLOptions)

URL에서 차단 단계 작업은 URL에서 콘텐츠를 읽는 Blob의 일부로 커밋할 새 블록을 만듭니다. 이 API는 버전 2018-03-28부터 사용할 수 있습니다.

function stageBlockFromURL(blockId: string, sourceURL: string, offset?: number, count?: number, options?: BlockBlobStageBlockFromURLOptions)

매개 변수

blockId: string

base64로 인코딩된 64비트 값

sourceURL: string

Blob의 URL을 지정합니다. 값은 Blob을 지정하는 길이가 최대 2KB인 URL일 수 있습니다. 값은 요청 URI에 표시되므로 URL 인코딩해야 합니다. 원본 Blob은 공용이거나 공유 액세스 서명을 통해 인증되어야 합니다. 원본 Blob이 공용인 경우 작업을 수행하기 위해 인증이 필요하지 않습니다. 다음은 원본 개체 URL의 몇 가지 예입니다. - https://myaccount.blob.core.windows.net/mycontainer/myblob - https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

offset: number

다운로드할 Blob의 위치(0보다 크거나 같음)

count: number

다운로드할 데이터의 양(0보다 큼)입니다. 정의되지 않은 경우 끝까지 다운로드됩니다.

options: BlockBlobStageBlockFromURLOptions

블록 Blob 단계 URL에서 블록 작업에 대한 옵션입니다.

반환

Promise<BlockBlobStageBlockFromURLResponse>

블록 Blob 단계 URL에서 블록 작업에 대한 응답 데이터입니다.

syncCopyFromURL(string, BlobSyncCopyFromURLOptions)

동기 URL에서 복사 작업은 Blob 또는 인터넷 리소스를 새 Blob에 복사합니다. 복사가 완료될 때까지 응답을 반환하지 않습니다.

function syncCopyFromURL(copySource: string, options?: BlobSyncCopyFromURLOptions)

매개 변수

copySource: string

복사할 원본 URL, 인증에 SAS(공유 액세스 서명)가 필요할 수 있습니다.

options: BlobSyncCopyFromURLOptions

반환

Promise<BlobCopyFromURLResponse>

syncUploadFromURL(string, BlockBlobSyncUploadFromURLOptions)

지정된 URL에서 Blob의 내용을 읽는 새 블록 Blob을 만듭니다. 이 API는 2020-04-08 버전부터 지원됩니다. URL에서 Blob 배치에서는 부분 업데이트가 지원되지 않습니다. 기존 Blob의 콘텐츠는 새 Blob의 콘텐츠로 덮어씁니다. 원본 URL을 사용하여 블록 Blob의 콘텐츠에 대한 부분 업데이트를 수행하려면 및 <xref:commitBlockList>를 사용합니다<xref:stageBlockFromURL>.

function syncUploadFromURL(sourceURL: string, options?: BlockBlobSyncUploadFromURLOptions)

매개 변수

sourceURL: string

options: BlockBlobSyncUploadFromURLOptions

선택적 매개 변수입니다.

반환

Promise<BlockBlobPutBlobFromUrlResponse>

undelete(BlobUndeleteOptions)

일시 삭제된 Blob 및 연결된 일시 삭제된 스냅샷의 내용과 메타데이터를 복원합니다. 삭제 취소 Blob은 버전 2017-07-29 이상에서만 지원됩니다.

function undelete(options?: BlobUndeleteOptions)

매개 변수

options: BlobUndeleteOptions

Blob 삭제 취소 작업에 대한 선택적 옵션입니다.

반환

Promise<BlobUndeleteResponse>

upload(HttpRequestBody, number, BlockBlobUploadOptions)

새 블록 Blob을 만들거나 기존 블록 Blob의 콘텐츠를 업데이트합니다. 기존 블록 Blob을 업데이트하면 blob에 있는 기존 메타데이터를 덮어씁니다. 부분 업데이트는 지원되지 않습니다. 기존 Blob의 콘텐츠를 새 콘텐츠로 덮어씁니다. 블록 Blob의 부분 업데이트를 수행하려면 및 <xref:commitBlockList>를 사용합니다<xref:stageBlock>. 병렬이 아닌 업로드 방법입니다. 동시성 업로드를 통해 성능을 향상시키려면 를 <xref:uploadStream> 사용<xref:uploadFile>하세요<xref:uploadBrowserData>.

function upload(body: HttpRequestBody, contentLength: number, options?: BlockBlobUploadOptions)

매개 변수

body: HttpRequestBody

Blob, 문자열, ArrayBuffer, ArrayBufferView 또는 오프셋이 데이터 원본에서 시작하는 새 읽기 가능한 스트림을 반환하는 함수입니다.

contentLength: number

본문의 길이(바이트)입니다. Buffer.byteLength()를 사용하여 Base64/Hex로 인코딩된 문자가 아닌 문자열의 본문 길이를 계산합니다.

options: BlockBlobUploadOptions

블록 Blob 업로드 작업에 대한 옵션입니다.

반환

Promise<BlockBlobUploadResponse>

블록 Blob 업로드 작업에 대한 응답 데이터입니다.

예제 사용법:

const content = "Hello world!";
const uploadBlobResponse = await blockBlobClient.upload(content, content.length);

uploadBrowserData(Blob | ArrayBuffer | ArrayBufferView, BlockBlobParallelUploadOptions)

경고

이 API는 이제 사용되지 않습니다.

Use <xref:uploadData> instead.

브라우저에서만 사용할 수 있습니다. Blob/File/ArrayBuffer/ArrayBufferView 브라우저를 업로드하여 Blob을 차단합니다.

버퍼 길이가 256MB보다 작거나 같은 경우 이 메서드는 1개 업로드 호출을 사용하여 업로드를 완료합니다. 그렇지 않으면 이 메서드는 를 호출 <xref:stageBlock> 하여 블록을 업로드하고 마지막으로 를 호출 <xref:commitBlockList> 하여 블록 목록을 커밋합니다.

설정하는 일반적인 <xref:BlockBlobParallelUploadOptions.blobHTTPHeaders> 옵션은 이며 blobContentType, 브라우저가 파일 형식에 따라 기능을 제공할 수 있도록 합니다.

function uploadBrowserData(browserData: Blob | ArrayBuffer | ArrayBufferView, options?: BlockBlobParallelUploadOptions)

매개 변수

browserData: Blob | ArrayBuffer | ArrayBufferView

Blob, File, ArrayBuffer 또는 ArrayBufferView

options: BlockBlobParallelUploadOptions

브라우저 데이터를 업로드하는 옵션입니다.

반환

Promise<BlobUploadCommonResponse>

Blob 업로드 작업에 대한 응답 데이터입니다.

uploadData(Buffer | Blob | ArrayBuffer | ArrayBufferView, BlockBlobParallelUploadOptions)

Buffer(Node.js)/Blob(browsers)/ArrayBuffer/ArrayBufferView 개체를 BlockBlob에 업로드합니다. 데이터 길이가 지정된 <xref:BlockBlobParallelUploadOptions.maxSingleShotSize> 값(기본값)보다 작으면 이 메서드는 <xref:BLOCK_BLOB_MAX_UPLOAD_BLOB_BYTES>1 <xref:upload> 개 호출을 사용하여 업로드를 완료합니다. 그렇지 않으면 이 메서드는 를 호출 <xref:stageBlock> 하여 블록을 업로드하고 마지막으로 를 호출 <xref:commitBlockList> 하여 블록 목록을 커밋합니다.

설정하는 일반적인 <xref:BlockBlobParallelUploadOptions.blobHTTPHeaders> 옵션은 이며 blobContentType, 브라우저가 파일 형식에 따라 기능을 제공할 수 있도록 합니다.

function uploadData(data: Buffer | Blob | ArrayBuffer | ArrayBufferView, options?: BlockBlobParallelUploadOptions)

매개 변수

data: Buffer | Blob | ArrayBuffer | ArrayBufferView

Buffer(Node.js), Blob, ArrayBuffer 또는 ArrayBufferView

options: BlockBlobParallelUploadOptions

반환

Promise<BlobUploadCommonResponse>

uploadFile(string, BlockBlobParallelUploadOptions)

NODE.JS 런타임에서만 사용할 수 있습니다. 블록의 로컬 파일을 블록 Blob에 업로드합니다.

파일 크기가 256MB보다 작거나 같은 경우 이 메서드는 1개 업로드 호출을 사용하여 업로드를 완료합니다. 그렇지 않으면 이 메서드는 stageBlock을 호출하여 블록을 업로드하고 마지막으로 commitBlockList를 호출하여 블록 목록을 커밋합니다.

function uploadFile(filePath: string, options?: BlockBlobParallelUploadOptions)

매개 변수

filePath: string

로컬 파일의 전체 경로

options: BlockBlobParallelUploadOptions

블록 Blob 작업에 업로드하는 옵션입니다.

반환

Promise<BlobUploadCommonResponse>

Blob 업로드 작업에 대한 응답 데이터입니다.

uploadStream(Readable, number, number, BlockBlobUploadStreamOptions)

NODE.JS 런타임에서만 사용할 수 있습니다. Node.js 읽기 가능한 스트림을 블록 Blob에 업로드합니다.

성능 향상 팁:

입력 스트림 highWaterMark는 buffer.concat() 작업을 방지하는 bufferSize 매개 변수를 사용하여 동일한 값을 설정하는 것이 좋습니다.

function uploadStream(stream: Readable, bufferSize?: number, maxConcurrency?: number, options?: BlockBlobUploadStreamOptions)

매개 변수

stream: Readable

Node.js 읽기 가능한 스트림

bufferSize: number

할당된 모든 버퍼의 크기이며 업로드된 블록 Blob의 블록 크기이기도 합니다. 기본값은 8MB입니다.

maxConcurrency: number

최대 동시성은 할당할 수 있는 최대 버퍼 수, 최대 업로드 동시성과의 양수 상관 관계를 나타냅니다. 기본값은 5입니다.

options: BlockBlobUploadStreamOptions

블록 Blob 작업에 스트림을 업로드하는 옵션입니다.

반환

Promise<BlobUploadCommonResponse>

Blob 업로드 작업에 대한 응답 데이터입니다.

withSnapshot(string)

원본과 동일하지만 지정된 스냅샷 타임스탬프를 사용하여 새 BlockBlobClient 개체를 만듭니다. ""을 입력하면 스냅샷이 제거되고 URL이 기본 Blob으로 반환됩니다.

function withSnapshot(snapshot: string)

매개 변수

snapshot: string

스냅샷 타임스탬프입니다.

반환

BlockBlobClient

원본과 동일하지만 지정된 스냅샷 타임스탬프가 있는 새 BlockBlobClient 개체입니다.

withVersion(string)

이 Blob의 버전을 가리키는 새 BlobClient 개체를 만듭니다. ""을 입력하면 versionId가 제거되고 클라이언트가 기본 Blob으로 반환됩니다.

function withVersion(versionId: string)

매개 변수

versionId: string

versionId입니다.

반환

BlobClient

이 Blob의 버전을 가리키는 새 BlobClient 개체입니다.

다음을 통해 공유

BlockBlobClient class

생성자

속성

메서드

생성자 세부 정보

BlockBlobClient(string, PipelineLike)

매개 변수

BlockBlobClient(string, StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

매개 변수

BlockBlobClient(string, string, string, StoragePipelineOptions)

매개 변수

속성 세부 정보

accountName

속성 값

containerName

속성 값

credential

속성 값

name

속성 값

url

속성 값

메서드 세부 정보

abortCopyFromURL(string, BlobAbortCopyFromURLOptions)

매개 변수

반환

beginCopyFromURL(string, BlobBeginCopyFromURLOptions)

매개 변수

반환

commitBlockList(string[], BlockBlobCommitBlockListOptions)

매개 변수

반환

createSnapshot(BlobCreateSnapshotOptions)

매개 변수

반환

delete(BlobDeleteOptions)

매개 변수

반환

deleteIfExists(BlobDeleteOptions)

매개 변수

반환

deleteImmutabilityPolicy(BlobDeleteImmutabilityPolicyOptions)

매개 변수

반환

download(number, number, BlobDownloadOptions)

매개 변수

반환

downloadToBuffer(Buffer, number, number, BlobDownloadToBufferOptions)

매개 변수

반환

downloadToBuffer(number, number, BlobDownloadToBufferOptions)

매개 변수

반환

downloadToFile(string, number, number, BlobDownloadOptions)

매개 변수

반환

exists(BlobExistsOptions)

매개 변수

반환

generateSasUrl(BlobGenerateSasUrlOptions)

매개 변수

반환

getAppendBlobClient()

반환

getBlobLeaseClient(string)

매개 변수

반환

getBlockBlobClient()

반환

getBlockList(BlockListType, BlockBlobGetBlockListOptions)

매개 변수

반환

getPageBlobClient()

반환

getProperties(BlobGetPropertiesOptions)

매개 변수

반환

getTags(BlobGetTagsOptions)

매개 변수