再開可能アップロードを使用してオブジェクトをobject Storage Service (OSS) にアップロードする前に、再開可能アップロードレコードを格納するチェックポイントファイルのディレクトリを指定できます。 ネットワーク例外またはプログラムエラーのためにオブジェクトのアップロードに失敗した場合、チェックポイントファイルに記録された位置からアップロードタスクが再開され、残りのデータがアップロードされます。
使用状況ノート
WebpackやBrowserifyなどのパッケージングツールを使用する場合は、npm install ali-OSSコマンドを実行して、oss SDK for Browser.jsをインストールします。
ブラウザからOSSバケットにアクセスしたいが、バケットにCORSルールが設定されていない場合、ブラウザはリクエストを拒否します。 したがって、ブラウザからバケットにアクセスする場合は、バケットのCORSルールを設定する必要があります。 詳細については、「インストール」をご参照ください。
ほとんどの場合、ブラウザではOSS SDK for Browser.jsが使用されます。 AccessKeyペアが公開されないようにするには、Security Token Service (STS) から取得した一時的なアクセス資格情報を使用してOSSにアクセスすることを推奨します。
一時的なアクセス資格情報は、AccessKeyペアとセキュリティトークンで構成されます。 AccessKeyペアは、AccessKey IDとAccessKeyシークレットで構成されます。 一時的なアクセス資格情報を取得する方法の詳細については、「一時的なアクセス権限付与にSTSを使用する」をご参照ください。
サンプルコード
次のサンプルコードは、再開可能アップロードを使用してオブジェクトをアップロードする方法の例を示しています。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<title> ドキュメント </title>
</head>
<body>
<button id="submit"> アップロード </button>
<button id="pause"> アップロードの一時停止 </button>
<button id="resume"> アップロードの再開 </button>
<!-- SDKファイルのインポート->
<スクリプト
type="text/javascript"
src="https://gosspublic.alicdn.com/aliyun-oss-sdk-6.18.0.min.js"
></script>
<script type="text/javascript">
const client = new OSS({
// バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンをoss-cn-Hangzhouに設定します。
リージョン: 'yourRegion' 、
// STSから取得した一時的なAccessKeyペアを指定します。 AccessKeyペアは、AccessKey IDとAccessKeyシークレットで構成されます。
accessKeyId: 'yourAccessKeyId' 、
accessKeySecret: 'yourAccessKeySecret' 、
// STSから取得したセキュリティトークンを指定します。
stsToken: 'yourSecurityToken' 、
// バケットの名前を指定します。 例: examplebucket.
bucket: "examplebucket" 、
});
// 再開可能アップロードを使用してアップロードするオブジェクトを作成します。 オブジェクトのサイズは100 MBです。
const fileContent=配列 (1024*1024*100)
. fill("a")
. join("");
const file = new File([fileContent], "multipart-upload-file");
// バケットにアップロードされるオブジェクトのフルパスを指定します。 例: exampledir/exampleobject.txt。
const name = "test.txt";
// オブジェクトのアップロードが一時停止するチェックポイントを定義します。
abortCheckpointを聞かせてください。
// アップロードとチェックポイントのDOM要素を取得します。
const submit = document.getElementById("submit");
const pause = document.getElementById("pause");
// 再開可能アップロードタスクのDOM要素を取得します。
const resume = document.getElementById("resume");
// オブジェクトのアップロードに使用するボタンを作成します。
submit.addEventListener("click", () => {
client
. multipartUpload(name, file, {)
progress :( p, cpt, res) => {
// チェックポイントに値を割り当てます。
abortCheckpoint = cpt;
console.log(abortCheckpoint);
// マルチパートアップロードタスクの進行状況を照会します。
console.log(p * 100);
},
})
. then((r) => console.log(r));
});
// オブジェクトのアップロードを一時停止するためのボタンを作成します。
pause.addEventListener("click", () => {
// アップロードを一時停止します。
client.ca ncel();
});
const resumeUpload = async () => {
// アップロードの再試行回数を5回に設定します。
try {
const result = await client.multipartUpload(name, file, {)
checkpoint: abortCheckpoint、
progress :( p, cpt, res) => {
// 再開可能なアップロードを実装するには、アップロード中にチェックポイント情報を保存します。 この方法では、アップロード例外が発生した後、チェックポイントがパラメーターとしてmultipartUploadに渡されます。 その後、アップロードは、最後のアップロードが一時停止されたバイトから再開される。
abortCheckpoint = cpt;
// マルチパートアップロードタスクの進行状況を照会します。
console.log(p);
},
});
console.log (結果);
} catch (e) {
console.log(e);
}
};
// アップロードを再開するためのボタンを作成します。
resume.addEventListener("click", async () => {
await resumeUpload();
});
</script>
</body>
</html>
参考資料
再開可能アップロードの実行に使用される完全なサンプルコードについては、『GitHub』をご参照ください。