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; overload; deprecated 'Use overloaded method instead';
function PutBlockBlob(const AContainerName, ABlobName, ALeaseID: string; const AContent: TArray<Byte>;
const AOptionalHeaders, AMetadata: array of TPair<string, string>;
const AResponseInfo: TCloudResponseInfo): Boolean; overload;
C++
bool __fastcall PutBlockBlob _DEPRECATED_ATTRIBUTE1("Use overloaded method instead") (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))/* overload */;
bool __fastcall PutBlockBlob(const System::UnicodeString AContainerName, const System::UnicodeString ABlobName, const System::UnicodeString ALeaseID, const System::DynamicArray<System::Byte> AContent, const System::Generics::Collections::TPair__2<System::UnicodeString,System::UnicodeString> *AOptionalHeaders, const System::NativeInt AOptionalHeaders_High, const System::Generics::Collections::TPair__2<System::UnicodeString,System::UnicodeString> *AMetadata, const System::NativeInt AMetadata_High, Data::Cloud::Cloudapi::TCloudResponseInfo* const AResponseInfo)/* overload */;
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
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 を返します。