ダウンロードに対して 1 つ以上の条件を設定できます。 指定した条件が満たされると、オブジェクトをダウンロードできます。 指定された条件が満たされないと、エラーコードが返され、オブジェクトをダウンロードできません。 以下の条件を設定できます。

パラメーター 説明
If-Modified-Since 指定された時間がオブジェクトが変更された時間より早い場合は、オブジェクトをダウンロードできます。 そうでない場合は、エラー "304 Not modified" が返されます。
If-Unmodified-Since 指定された時間がオブジェクトが変更された時間以降である場合は、オブジェクトをダウンロードできます。 そうでない場合は、エラー "412 Precondition failed" が返されます。
If-Match 指定された ETag がオブジェクトのものと一致すれば、そのオブジェクトをダウンロードすることができます。 そうでない場合は、エラー "412 Precondition failed" が返されます。
If-None-Match 指定された ETag がオブジェクトのものと一致しない場合は、オブジェクトをダウンロードできます。 そうでない場合は、エラー "304 Not modified" が返されます。

"If-Modified-Since" と "If-Unmodified-Since" の両方が、オブジェクトのダウンロード条件と同時に存在することがあります。 "If-Match" と "If-None-Match" の両方が、オブジェクトのダウンロード条件と同時に存在することがあります。

ETag を取得するには、ossClient.getObjectMeta を使用します。

条件付きダウンロード用に次のコードを実行します。

//This example uses the endpoint China East 1 (Hangzhou). Specify the actual endpoint based on your requirements.
String endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// It is highly risky to log on with AccessKey of an Alibaba Cloud account because the account has permissions on all the APIs in OSS. We recommend that you log on as a RAM user to access APIs or perform routine operations and maintenance. To create a RAM account, log on to https://ram.console.aliyun.com.
String accessKeyId = "<yourAccessKeyId>";
String accessKeySecret = "<yourAccessKeySecret>";
String bucketName = "<yourBucketName>";
String objectName = "<yourObjectName>";

// Create an OSSClient instance.
OSSClient ossClient = new OSSClient(endpoint, accessKeyId, accessKeySecret);

GetObjectRequest request = new GetObjectRequest(bucketName, objectName);
// Configure conditions.
request.setModifiedSinceConstraint(new Date());

// Download an object to a local file.
ossClient.getObject(request, new File("<yourLocalFile>"));

//Close your OSSClient.
ossClient.shutdown();

条件付きダウンロードは、ossClient.getObject および ossClient.downloadFile をサポートします。