Data.Cloud.AzureAPI.TAzureBlobService.PutBlockBlob

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

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 を作成するか、既存のものを置き換えるために使用されます。

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

パラメータ 説明

ContainerName

blob のコンテナの名前。

BlobName

blob の名前。

Content

blob に設定するコンテンツ。

LeaseId

リース ID(省略可能)。

OptionalHeaders

任意のヘッダー。

Metadata

blob に設定するメタデータ。

ResponseInfo

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

指定された名前のブロック 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 を返します。

関連項目