Data.Cloud.AzureAPI.TAzureBlobService.ListBlobs
Delphi
function ListBlobs(ContainerName: string; OptionalParams: TStrings = nil; ResponseInfo: TCloudResponseInfo = nil): TList<TAzureBlob>; overload;
function ListBlobs(ContainerName: string; out NextMarker: string; OptionalParams: TStrings = nil; ResponseInfo: TCloudResponseInfo = nil): TList<TAzureBlob>; overload;
C++
System::Generics::Collections::TList__1<TAzureBlob*>* __fastcall ListBlobs(System::UnicodeString ContainerName, System::Classes::TStrings* OptionalParams = (System::Classes::TStrings*)(0x0), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
System::Generics::Collections::TList__1<TAzureBlob*>* __fastcall ListBlobs(System::UnicodeString ContainerName, /* out */ System::UnicodeString &NextMarker, System::Classes::TStrings* OptionalParams = (System::Classes::TStrings*)(0x0), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | Data.Cloud.AzureAPI.pas Data.Cloud.AzureAPI.hpp |
Data.Cloud.AzureAPI | TAzureBlobService |
説明
指定されたコンテナの blob のリストを返します。
ListBlobs は、コンテナの blob のリストを返すために使用されます。
ListBlobs にはオーバーロード メソッドが 2 つあります。 次の表では、パラメータを説明しています:
パラメータ | 説明 |
---|---|
|
blob を取得するコンテナ、またはルート コンテナの場合には $root。 |
|
blob がすべて返されなかった場合の継続トークン。 |
|
省略可能パラメータの名前/値ペア。 |
|
レスポンス情報を格納する任意のクラス。 |
次の省略可能パラメータがサポートされています: prefix
、delimiter
、marker
、maxresults
、include={snapshots,metadata,uncommittedblobs}
。
prefix
が指定されている場合、指定された接頭辞から始まる名前の blob のみが表示されます。
delimiter
が指定されている場合、区切り文字列が含まれた(接頭辞文字列の後に)名前の blob が、適宜、'BlobPrefix' ノードにグループ化されます。このグループ化によって、blob を、仮想のディレクトリ構造で表示させることができ、そこから、返された 'BlobPrefix' 名前ノードの値を取得したり、続く呼び出しで、それらを接頭辞の値として使用することができます。
marker
が指定されている場合、すべての blob が返されなかった際に、前の呼び出しで残してしまった blob をさらに取得するための継続トークンとしてこれを使用することができます。
maxresults
が指定されている場合、これを、返す blob の最大数を表す整数として扱うことができます。デフォルト(そして最大値)は、5000 です。maxresults
が許容する数より多くの blob がある場合、XML 内の NextMarker
が設定され、これを続く呼び出しでの marker
の値として使用することができます。
include
が指定されている場合、これは、次の 1 つまたは複数のカンマ区切りの値(CSV)の文字列を保持することができます。
snapshots
— レスポンスに blob スナップショットを含む(古い~新しいの順)。metadata
— レスポンスに各 blob のメタデータを含む。uncommittedblobs
— レスポンスに未コミットのセクションを持つ blob を含む。
警告: $root コンテナ下の blob は、名前にスラッシュ(/)をいれられない点に注意してください。