Data.Cloud.AzureAPI.TAzureBlobService.PutBlock

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

function PutBlock(ContainerName, BlobName: string; const BlockId: string; Content: TArray<Byte>;
const ContentMD5: string = ''; const LeaseId: string = '';
ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated 'Use overloaded method instead';
function PutBlock(const AContainerName, ABlobName, ALeaseId, ABlockId: string; AContent: TArray<Byte>;
const AContentMD5: string; const AResponseInfo: TCloudResponseInfo): Boolean; overload;

C++

bool __fastcall PutBlock _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (System::UnicodeString ContainerName, System::UnicodeString BlobName, const System::UnicodeString BlockId, System::DynamicArray<System::Byte> Content, const System::UnicodeString ContentMD5 = System::UnicodeString(), const System::UnicodeString LeaseId = System::UnicodeString(), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall PutBlock(const System::UnicodeString AContainerName, const System::UnicodeString ABlobName, const System::UnicodeString ALeaseId, const System::UnicodeString ABlockId, System::DynamicArray<System::Byte> AContent, const System::UnicodeString AContentMD5, Data::Cloud::Cloudapi::TCloudResponseInfo* const AResponseInfo)/* overload */;

プロパティ

種類 可視性 ソース ユニット
function public
Data.Cloud.AzureAPI.pas
Data.Cloud.AzureAPI.hpp
Data.Cloud.AzureAPI TAzureBlobService


説明

blob の一部としてコミットされる新しいブロックを作成します。

PutBlock は、blob の一部としてコミットされる新しいブロックを作成します。

ブロックのサイズは 4 MB までです。BlockId は、base 64-encoded 文字列でなければならず、エンコード前の段階で、サイズは 64 バイト以下でなければなりません。

指定された blob に対して、すべてのブロック ID は同じ長さでなければなりません。ブロックのセットをアップロードしたら、サーバー上の blob を、PutBlockList を呼び出して、このセットから作成または更新することができます。それまでは、blob はこのブロックをコンテンツの一部として含んでいません。まだない blob に対して PutBlock を呼び出すと、新しい、コミットされていないブロック blob が、コンテンツ長 0 で作成されます。

PutBlock を、既存のコミットされていないブロックの BlockId を使用して呼び出すと、コンテンツは置き換わります。

PutBlockList が一週間以内に呼び出されないと、コミットされていないすべてのブロックが削除されます。PutBlockList の呼び出しの後、リストに含まれていない未コミットのブロックは削除されます。

次の表では、パラメータを説明しています:

パラメータ 説明

ContainerName

blob があるコンテナの名前。

BlobName

ブロックを更新する blob の名前。

BlockId

ブロックを一意に識別する ID。

Content

blob のコンテンツ(バイト単位)。

ContentMD5

検証のための、コンテンツの MD5 ハッシュ(省略可能)。

LeaseId

リース ID、blob がロックされている場合には必須。

ResponseInfo

レスポンス情報を格納する任意のクラス。


メソッドは、オペレーションが成功した場合に True を、そうでなければ False を返します。

関連項目