PageBlobClient class

PageBlobClient のインスタンスを作成します。

new PageBlobClient(url: string, pipeline: PipelineLike)

パラメーター

PageBlobClient のインスタンスを作成します。 このメソッドは、BLOB を指すエンコードされた URL またはエンコードされていない URL を受け入れます。 エンコードされた URL 文字列は 2 回エスケープされず、URL パス内の特殊文字のみがエスケープされます。 BLOB 名に が含まれている場合は ? または %、BLOB 名は URL でエンコードする必要があります。

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

パラメーター

PageBlobClient のインスタンスを作成します。

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

パラメーター

accountName: string

プロパティ値

BLOB が関連付けられているストレージ コンテナーの名前。

string containerName

プロパティ値

AnonymousCredential、StorageSharedKeyCredential、またはサービスへの要求を @azure/identity 認証するためのパッケージからの資格情報など。 TokenCredential インターフェイスを実装する オブジェクトを指定することもできます。 指定しない場合は、AnonymousCredential が使用されます。

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

プロパティ値

BLOB の名前です。

string name

プロパティ値

エンコードされた URL 文字列値。

url: string

プロパティ値

保留中の非同期 BLOB のコピー操作を中止し、転送先 BLOB の長さと完全なメタデータを残します。 バージョン 2012-02-12 以降。

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

パラメーター

戻り値

ストレージ アカウント内の宛先に BLOB を非同期にコピーします。 このメソッドは、コピーが完了するまで無期限に待機できる実行時間の長い操作ポーリングャーを返します。 投票者で を呼び出 cancelOperation すことで、コピーが完了する前にコピーを取り消すこともできます。 最初の要求で操作が完了し、完了したコピーを取り消そうとすると、onProgress コールバックは呼び出されないことに注意してください。エラーがスローされます。 バージョン 2012-02-12 以降では、BLOB のコピー操作のソースは、任意の Azure ストレージ アカウントのコミット済み BLOB にすることができます。 バージョン 2015-02-21 以降では、BLOB のコピー操作のソースは、任意の Azure ストレージ アカウント内の Azure ファイルにすることができます。 2012 年 6 月 7 日以降に作成されたストレージ アカウントについてのみ、Copy Blob 操作による他のストレージ アカウントからのコピーが許可されています。

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

パラメーター

戻り値

指定したページをページ BLOB から解放します。

function clearPages(offset?: number, count?: number, options?: PageBlobClearPagesOptions)

パラメーター

戻り値

ページ BLOB クリア ページ操作の応答データ。

指定した長さのページ BLOB を作成します。 uploadPages を呼び出して、ページ BLOB にデータ データをアップロードします。

function create(size: number, options?: PageBlobCreateOptions)

パラメーター

戻り値

ページ BLOB 作成操作の応答データ。

指定した長さのページ BLOB を作成します。 uploadPages を呼び出して、ページ BLOB にデータ データをアップロードします。 同じ名前の BLOB が既に存在する場合、既存の BLOB の内容は変更されません。

function createIfNotExists(size: number, options?: PageBlobCreateIfNotExistsOptions)

パラメーター

戻り値

BLOB の読み取り専用のスナップショットを作成します。

function createSnapshot(options?: BlobCreateSnapshotOptions)

パラメーター

戻り値

指定した BLOB またはスナップショットに削除のマークを付けます。 BLOB は、後でガベージ コレクション中に削除されます。 BLOB を削除するには、そのスナップショットをすべて削除する必要があります。 BLOB の削除操作を使用して、両方を同時に削除できます。

function delete(options?: BlobDeleteOptions)

パラメーター

戻り値

指定した BLOB またはスナップショットが存在する場合は、削除対象としてマークします。 BLOB は、後でガベージ コレクション中に削除されます。 BLOB を削除するには、そのスナップショットをすべて削除する必要があります。 BLOB の削除操作を使用して、両方を同時に削除できます。

function deleteIfExists(options?: BlobDeleteOptions)

パラメーター

戻り値

BLOB の不変ポリシーを削除します。

function deleteImmutabilityPolicy(options?: BlobDeleteImmutabilityPolicyOptions)

パラメーター

戻り値

メタデータとプロパティを含め、システムから BLOB を読み取るかダウンロードします。 Get Blob を呼び出してスナップショットを読み取ることもできます。

• Node.jsでは、読み取り可能ストリーム readableStreamBody でデータが返されます
• ブラウザーでは、promise blobBody でデータが返されます

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

パラメーター

// 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);
  });
}

戻り値

NODE.JSランタイムでのみ使用できます。 Azure BLOB をバッファーに並列でダウンロードします。 オフセットとカウントは省略可能で、指定されていない場合は BLOB 全体をダウンロードします。

警告: バッファーは、32 ビット システムでは最大約 1 ギガバイト、64 ビット システムでは約 2 ギガバイトまでしかサポートできません。Node.js/V8 の制限があります。 このサイズより大きい BLOB の場合は、 を検討してください <xref:downloadToFile>。

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

パラメーター

戻り値

NODE.JSランタイムでのみ使用できます。 Azure BLOB をバッファーに並列でダウンロードします。 オフセットとカウントは省略可能で、指定されていない場合は BLOB 全体をダウンロードします。

警告: バッファーは、32 ビット システムでは最大約 1 ギガバイト、64 ビット システムでは約 2 ギガバイトまでしかサポートできません。Node.js/V8 の制限があります。 このサイズより大きい BLOB の場合は、 を検討してください <xref:downloadToFile>。

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

パラメーター

戻り値

NODE.JSランタイムでのみ使用できます。 Azure BLOB をローカル ファイルにダウンロードします。 指定されたファイル パスが既に終了している場合、失敗します。 オフセットとカウントは省略可能で、それぞれ 0 と undefined を渡して BLOB 全体をダウンロードします。

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

パラメーター

戻り値

BLOB ダウンロード操作の応答データ。ただし、readableStreamBody が undefined に設定されています。これは、そのコンテンツが既に読み取られ、指定されたパスにあるローカル ファイルに書き込まれるためです。

このクライアントによって表される Azure BLOB リソースが存在する場合は true を返します。それ以外の場合は false。 注: 既存の BLOB は他のクライアントまたはアプリケーションによって削除される可能性があるため、この関数は注意して使用してください。 その逆も同様に、この関数の完了後に他のクライアントまたはアプリケーションによって新しい BLOB が追加される場合があります。

function exists(options?: BlobExistsOptions)

パラメーター

戻り値

共有キー資格情報を使用して構築された BlobClient でのみ使用できます。 渡されたクライアント のプロパティとパラメーターに基づいて、BLOB サービス Shared Access Signature (SAS) URI を生成します。 SAS は、クライアントの共有キー資格情報によって署名されます。

function generateSasUrl(options: BlobGenerateSasUrlOptions)

パラメーター

戻り値

このクライアントによって表されるリソースへの URI と、生成された SAS トークンで構成される SAS URI。

AppendBlobClient オブジェクトを作成します。

function getAppendBlobClient()

戻り値

BLOB の <xref:BlobLeaseClient> リースを管理する を取得します。

function getBlobLeaseClient(proposeLeaseId?: string)

パラメーター

戻り値

BLOB のリースを管理するための新しい BlobLeaseClient オブジェクト。

BlockBlobClient オブジェクトを作成します。

function getBlockBlobClient()

戻り値

PageBlobClient オブジェクトを作成します。

function getPageBlobClient()

戻り値

ページ BLOB またはページ BLOB のスナップショットの有効なページ範囲の一覧を返します。

function getPageRanges(offset?: number, count?: number, options?: PageBlobGetPageRangesOptions)

パラメーター

戻り値

ページ BLOB の範囲の取得操作の応答データ。

指定したスナップショットとこのページ BLOB の間で異なるページ範囲のコレクションを取得します。

function getPageRangesDiff(offset: number, count: number, prevSnapshot: string, options?: PageBlobGetPageRangesDiffOptions)

パラメーター

戻り値

ページ BLOB のページ範囲の差分取得操作の応答データ。

指定したスナップショットとマネージド ディスクのこのページ BLOB の間で異なるページ範囲のコレクションを取得します。

function getPageRangesDiffForManagedDisks(offset: number, count: number, prevSnapshotUrl: string, options?: PageBlobGetPageRangesDiffOptions)

パラメーター

戻り値

ページ BLOB のページ範囲の差分取得操作の応答データ。

BLOB のすべてのユーザー定義メタデータ、標準 HTTP プロパティ、およびシステム プロパティを返します。 BLOB のコンテンツは返しません。

function getProperties(options?: BlobGetPropertiesOptions)

パラメーター

戻り値

基になる BLOB に関連付けられているタグを取得します。

function getTags(options?: BlobGetTagsOptions)

パラメーター

戻り値

ページ BLOB のサイズを指定したサイズに変更します (512 の倍数である必要があります)。

function resize(size: number, options?: PageBlobResizeOptions)

パラメーター

戻り値

ページ BLOB のサイズ変更操作の応答データ。

BLOB の層を設定します。 操作は、Premium Storage アカウントのページ BLOB と BLOB ストレージ アカウント内のブロック BLOB (ローカル冗長ストレージのみ) で許可されます。 Premium ページ BLOB の層によって、BLOB の許容サイズ、IOPS、帯域幅が決まります。 ブロック BLOB の層によって、ホット/クール/アーカイブ ストレージの種類が決まります。 この操作では、BLOB の ETag は更新されません。

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

パラメーター

戻り値

BLOB のシステム プロパティを設定します。 値が指定されていない場合、または指定された BLOB HTTP ヘッダーに値が指定されていない場合は、値のないこれらの BLOB HTTP ヘッダーがクリアされます。

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

パラメーター

戻り値

BLOB に不変ポリシーを設定します。

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

パラメーター

戻り値

BLOB に訴訟ホールドを設定します。

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

パラメーター

戻り値

1 つまたは複数の名前と値のペアとして指定された BLOB のユーザー定義メタデータを設定します。 オプションが指定されていない場合、または パラメーターにメタデータが定義されていない場合は、BLOB メタデータが削除されます。

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

パラメーター

戻り値

基になる BLOB にタグを設定します。 BLOB には、最大 10 個のタグを含めることができます。 タグ キーは 1 ~ 128 文字にする必要があります。 タグ値は 0 ~ 256 文字にする必要があります。 有効なタグ キーと値の文字には、小文字と大文字、数字 (0 から 9)、スペース (' ')、プラス ('+')、マイナス ('-')、ピリオド ('.')、スラッシュ ('/')、コロン (':')、等しい ('=')、アンダースコア ('_') が含まれます。

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

パラメーター

戻り値

1 つのページ BLOB のスナップショットからこのページ BLOB への増分コピーを開始する操作を開始します。 スナップショットがコピーされ、前にコピーしたスナップショット間の差分変更のみが転送先に転送されます。 コピーされたスナップショットは、元のスナップショットの完全なコピーであり、通常どおりの読み取りまたはコピーが可能です。

function startCopyIncremental(copySource: string, options?: PageBlobStartCopyIncrementalOptions)

パラメーター

戻り値

ページ BLOB コピー増分操作の応答データ。

同期コピー元 URL 操作は、BLOB またはインターネット リソースを新しい BLOB にコピーします。 コピーが完了するまで応答は返されません。

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

パラメーター

戻り値

論理的に削除された BLOB と、関連付けられている論理的に削除されたスナップショットの内容とメタデータを復元します。 BLOB の削除の取り消しは、バージョン 2017-07-29 以降でのみサポートされています。

function undelete(options?: BlobUndeleteOptions)

パラメーター

戻り値

ページ BLOB のシーケンス番号を設定します。

function updateSequenceNumber(sequenceNumberAction: SequenceNumberActionType, sequenceNumber?: number, options?: PageBlobUpdateSequenceNumberOptions)

パラメーター

戻り値

ページ BLOB 更新シーケンス番号操作の応答データ。

ページ BLOB に 1 つ以上のページを書き込みます。 開始オフセットと終了オフセットは、512 の倍数である必要があります。

function uploadPages(body: HttpRequestBody, offset: number, count: number, options?: PageBlobUploadPagesOptions)

パラメーター

戻り値

ページ BLOB アップロード ページ操作の応答データ。

ページのアップロード操作では、URL からコンテンツが読み取られたページ BLOB にページの範囲が書き込まれます。

function uploadPagesFromURL(sourceURL: string, sourceOffset: number, destOffset: number, count: number, options?: PageBlobUploadPagesFromURLOptions)

パラメーター

戻り値

ソースと同じで、指定されたスナップショット タイムスタンプを持つ新しい PageBlobClient オブジェクトを作成します。 "" を指定すると、スナップショットが削除され、クライアントがベース BLOB に返されます。

function withSnapshot(snapshot: string)

パラメーター

戻り値

ソースと同じが、指定されたスナップショット タイムスタンプを持つ新しい PageBlobClient オブジェクト。

この BLOB のバージョンを指す新しい BlobClient オブジェクトを作成します。 "" を指定すると、versionId が削除され、クライアントがベース BLOB に返されます。

function withVersion(versionId: string)

パラメーター

戻り値

この BLOB のバージョンを指す新しい BlobClient オブジェクト。