このトピックでは、Object Storage Service (OSS) SDK for Node.jsを初期化するときに設定できるパラメーターについて説明します。
次の表に、パラメーター (オプション) を示します。
パラメーター | Type | 説明 |
accessKeyId | String | Alibaba Cloud管理コンソールで作成されたAccessKey ID。 |
accessKeySecret | String | Alibaba Cloud管理コンソールで作成されるAccessKeyシークレット。 |
stsToken | String | OSSへのアクセスに使用される一時的なSecurity Token Service (STS) トークン。 詳細については、「一時的なアクセス許可にSTSを使用する」をご参照ください。 |
バケット | String | OSSコンソールを使用するか、PutBucket操作を呼び出して作成されたバケット。 |
endpoint | String | OSSバケットへのアクセスに使用されるエンドポイント。 |
region | String | バケットが配置されているリージョン。 デフォルト値: oss-cn-hangzhou |
内部 | Boolean | Alibaba Cloud内部ネットワークを使用してOSSにアクセスするかどうかを指定します。 デフォルト値:false たとえば、Elastic Compute Service (ECS) インスタンスを使用してOSSにアクセスする場合、このパラメーターをtrueに設定します。 ECSインスタンスからのアクセスは、内部エンドポイントを使用するため、コストが削減されます。 |
cname | Boolean | カスタムドメイン名を使用してOSSにアクセスできるかどうかを指定します。 デフォルト値:false cnameをtrueに設定した場合、カスタムドメイン名を使用してバケットにアクセスする前に、CNAMEレコードをバケットにマップする必要があります。 |
isRequestPay | Boolean | pay-by-requesterモードをバケットで有効にするかどうかを指定します。 デフォルト値:false 詳細については、「Pay-by-requester」をご参照ください。 |
secure | Boolean | OSSへのアクセスにHTTPSを使用するかどうかを指定します。 trueの値は、OSSへのアクセスにHTTPSが使用されていることを示します。 falseの値は、HTTPを使用してOSSにアクセスすることを示します。 詳細は、「よくある質問」をご参照ください。 |
timeout | 文字列 | 番号 | タイムアウト期間。 デフォルト値: 60000 単位:ミリ秒。 |
次のコードは、OSS SDK for Node.jsを使用するときにパラメーターを設定する方法の例を示しています。
const OSS = require('ali-OSS ');
const client = new OSS({
// バケットが配置されているリージョンを指定します。 たとえば、バケットが中国 (杭州) リージョンにある場合、リージョンをoss-cn-Hangzhouに設定します。
region: 'yourregion' 、
// 環境変数からアクセス資格情報を取得します。 サンプルコードを実行する前に、OSS_ACCESS_KEY_IDおよびOSS_ACCESS_KEY_SECRET環境変数が設定されていることを確認してください。
accessKeyId: process.env.OSS_ACCESS_KEY_ID、
accessKeySecret: process.env.OSS_ACCESS_KEY_SECRET、
// バケットの名前を指定します。
bucket: 'examplebucket'
});