お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

Objectの取得

このSDKメソッドは、BucketからObjectを取得するために使用できます。レスポンスはblob形式で返されます。

Bucketでバージョニングが有効になっている場合:

  • versionIdを渡さない場合、最新のObjectのみが返されます。
  • 特定のバージョンを取得するには、有効なバージョンを値としてversionIdクエリパラメータを使用します。

使用するパラメータ

パラメータ名 定義
objectKey 必須パラメータです。Object名を含みます。
versionId オプションパラメータです。必要なObjectのバージョンの一意のバージョンIDを保持します。
copy
bucketInstance.getObject( objectKey : "{object_name}", versionId : "{version_id}" ) { result in
	switch result {
		case .success( let object ) :
			print( "File Name : \( object.fileName )" )
		case .error(let error) :
			print("Error : \( error )")
	}
}

必要なObjectが返されます。

発生する可能性のある例外

  • 404: ObjectまたはBucketが見つかりません

すべてのObjectの取得

このSDKメソッドは、ページネーション技術を使用してBucket内に存在するすべてのObjectを取得するために使用できます。

使用するパラメータ

パラメータ名 データ型 定義
prefix String オプションパラメータです。プレフィックス値に一致するObjectを取得します。
maxKeys Number オプションパラメータです。ページネーションで一覧表示できるObjectの最大数を含みます。
continuation_token String オプションパラメータです。レスポンスが切り捨てられた場合、次のObjectのセットを取得するために、このキーの値を同じメソッドにcontinuation_tokenとして渡す必要があります。
copy
var params = ZCatalystQuery.ObjectParams()
params.maxKeys = 10
params.continuationToken = "{continuation_token}"
parmas.prefix = "{prefix}"
bucketInstance.getObjects( withParams : params ) { result in
	switch result {
		case .success( let objects, let response ) :
			for object in objects {
				print("File Name : \( object.fileName  )")
			}
		case .error( let error ) :
			print("Error : \( error )")
	}
}

必要なObjectがBlob形式の配列として返されます。

発生する可能性のある例外

  • 404: ObjectまたはBucketが見つかりません

最終更新日 2026-02-23 18:09:41 +0530 IST