このトピックでは、指定されたファイル (オブジェクト) が存在するかどうかを確認する方法について説明します。
注意事項
Webpack や Browserify などのパッケージングツールを使用する場合は、npm install ali-oss コマンドを実行して OSS Browser.js SDK をインストールします。
ブラウザから OSS バケットにアクセスする際に、そのバケットに CORS ルールが設定されていない場合、ブラウザはリクエストを拒否します。したがって、ブラウザからバケットにアクセスするには、バケットに CORS ルールを設定する必要があります。詳細については、「インストール」をご参照ください。
ほとんどの場合、OSS Browser.js SDK はブラウザで使用されます。AccessKey ペアの漏洩を防ぐため、Security Token Service (STS) から取得した一時的なアクセス認証情報を使用して OSS にアクセスすることを推奨します。
一時的なアクセス認証情報は、AccessKey ペアとセキュリティトークンで構成されます。AccessKey ペアは、AccessKey ID と AccessKey Secret で構成されます。一時的なアクセス認証情報を取得する方法の詳細については、「STS を使用した一時的なアクセス権限付与」をご参照ください。
サンプルコード
次のコードは、examplebucket バケット内に exampleobject.txt ファイルが存在するかどうかを確認する方法の例を示しています。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>Document</title>
<script src="https://gosspublic.alicdn.com/aliyun-oss-sdk-6.17.1.min.js"></script>
</head>
<body>
<script>
const client = new OSS({
// yourRegion を、バケットが所在するリージョンに設定します。たとえば、バケットが中国 (杭州) リージョンにある場合、yourRegion を oss-cn-hangzhou に設定します。
region: 'yourRegion',
authorizationV4: true,
// STS から取得した一時的な AccessKey ペア (AccessKey ID と AccessKey Secret)。
accessKeyId: 'yourAccessKeyId',
accessKeySecret: 'yourAccessKeySecret',
// STS から取得したセキュリティトークン (SecurityToken)。
stsToken: 'yourSecurityToken',
// バケット名を指定します。
bucket: 'examplebucket'
});
async function isExistObject(name, options = {}) {
try {
await client.head(name, options);
console.log("ファイルは存在します。");
} catch (error) {
if (error.code === "NoSuchKey") {
console.log("ファイルは存在しません。");
}
}
}
// 指定されたオブジェクトが存在するかどうかを確認します。
// オブジェクトの完全なパスを指定します。バケット名は含めないでください。例：exampleobject.txt。
const name = "exampleobject.txt";
isExistObject(name);
</script>
</body>
</html>