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
Yes
No
Send your feedback to us
Skip
Submit