Data.Cloud.AzureAPI.TAzureBlobService.PutBlockBlob
Delphi
function PutBlockBlob(ContainerName, BlobName: string; Content: TArray<Byte>; LeaseId: string = ''; OptionalHeaders: TStrings = nil; Metadata: TStrings = nil; ResponseInfo: TCloudResponseInfo = nil): Boolean;
C++
bool __fastcall PutBlockBlob(System::UnicodeString ContainerName, System::UnicodeString BlobName, System::DynamicArray<System::Byte> Content, System::UnicodeString LeaseId = System::UnicodeString(), System::Classes::TStrings* OptionalHeaders = (System::Classes::TStrings*)(0x0), System::Classes::TStrings* Metadata = (System::Classes::TStrings*)(0x0), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0));
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | Data.Cloud.AzureAPI.pas Data.Cloud.AzureAPI.hpp |
Data.Cloud.AzureAPI | TAzureBlobService |
説明
指定されたコンテナにおいて、新しいブロック blob を作成するか、既存のものを更新します。
PutBlockBlob は、指定されたコンテナにおいて、新しいブロック blob を作成するか、既存のものを置き換えるために使用されます。
次の表では、パラメータを説明しています:
パラメータ | 説明 |
---|---|
|
blob のコンテナの名前。 |
|
blob の名前。 |
|
blob に設定するコンテンツ。 |
|
リース ID(省略可能)。 |
|
任意のヘッダー。 |
|
blob に設定するメタデータ。 |
|
レスポンス情報を格納する任意のクラス。 |
指定された名前のブロック blob が(指定されたコンテナの中に)すでに存在する場合、そのコンテンツが、この呼び出しのデータに置き換わります。
LeaseId
は、空の文字列に設定されなければなりません(ただし、指定の名前の blob がすでに存在し、それが現在ロックされている場合を除く)。
OptionalHeaders
は、リクエストに設定することができます。そのような任意のヘッダーには次のものがあります:
- Content-Type(または x-ms-blob-content-type)
- Content-Encoding(または x-ms-blob-content-encoding)
- Content-Language(または x-ms-blob-content-language)
- Content-MD5(または x-ms-blob-content-md5)
- Cache-Control(または x-ms-blob-cache-control)
- If-Modified-Since
- If-Unmodified-Since
- If-Match(リソースのエンティティ タグ(Etag)値と、このヘッダーの値を比較する)
- If-None-Match(リソースの Etag 値と、このヘッダーの値を比較する)
任意のメタデータ名は、'x-ms-meta-' から始まらなければなりません。そうでない場合、この接頭辞が追加されます。
ブロック blob の Content-Length に使用可能な最大サイズは、64 MB です。それより大きい場合、それはブロックとしてアップロードする必要があります。
メソッドは、作成/置換が成功した場合に True を、そうでなければ False を返します。