初始化OTSClient
本文中含有需要您注意的重要提示信息,忽略該信息可能對您的業(yè)務(wù)造成影響,請務(wù)必仔細(xì)閱讀。
Client是表格存儲服務(wù)的客戶端,它為調(diào)用者提供了一系列的方法,可以用來操作表、單行數(shù)據(jù)、多行數(shù)據(jù)等。使用.NET SDK發(fā)起請求,您需要初始化一個Client實例,并根據(jù)需要修改ClientConfig的默認(rèn)配置項。
準(zhǔn)備工作
初始化Client前,您需要完成獲取實例Endpoint、安裝表格存儲Node.js SDK和配置訪問憑證的準(zhǔn)備工作。
獲取實例Endpoint
創(chuàng)建實例后,您需要獲取實例域名地址(Endpoint)用于后續(xù)通過Endpoint訪問實例。
Endpoint是阿里云表格存儲服務(wù)各個實例的域名地址,例如https://sun.cn-hangzhou.ots.aliyuncs.com
,表示使用HTTPS協(xié)議通過公網(wǎng)網(wǎng)絡(luò)訪問華東1(杭州)地域的sun實例。更多信息,請參見服務(wù)地址。
如果未開通表格存儲服務(wù),請進(jìn)行開通。具體操作,請參見開通表格存儲服務(wù)。
創(chuàng)建實例。具體操作,請參見創(chuàng)建實例。
創(chuàng)建實例后獲取實例的Endpoint。
登錄表格存儲控制臺。
在概覽頁面,單擊實例名稱。
在實例詳情頁簽的實例訪問地址區(qū)域即可查看該實例的服務(wù)地址(Endpoint)。
安裝表格存儲Node.js SDK
具體操作,請參見安裝表格存儲Node.js SDK。
配置訪問憑證
要接入阿里云的表格存儲服務(wù),您需要擁有一個有效的訪問密鑰進(jìn)行簽名認(rèn)證。具體操作,請參見配置訪問憑證。
初始化OTSClient
使用表格存儲的SDK時,您必須首先構(gòu)造一個Client,通過調(diào)用該Client的接口來訪問表格存儲服務(wù)。
示例
阿里云賬號AccessKey擁有所有API的訪問權(quán)限,建議您使用RAM用戶進(jìn)行API訪問或日常運(yùn)維。強(qiáng)烈建議不要把AccessKey ID和AccessKey Secret保存到工程代碼里,否則可能導(dǎo)致AccessKey泄露,威脅您賬號下所有資源的安全。本示例以將AccessKey、SecurityToken保存在環(huán)境變量中來實現(xiàn)身份驗證為例介紹。
使用AK初始化
運(yùn)行本代碼示例之前,請確保已設(shè)置環(huán)境變量OTS_AK_ENV
和OTS_SK_ENV
。更多信息,請參見配置訪問憑證。
var accessKeyId = process.env.OTS_AK_ENV;
var secretAccessKey = process.env.OTS_SK_ENV;
var endpoint = 'yourEndpoint';
var instancename = 'yourInstance';
var client = new TableStore.Client({
accessKeyId: accessKeyId,
secretAccessKey: secretAccessKey,
endpoint: endpoint,
instancename: instancename,
maxRetries:20,//最大重試次數(shù),默認(rèn)值為20次,可以省略此參數(shù)。
});
配置參數(shù)說明請參見下表。
參數(shù) | 示例 | 說明 |
endpoint | https://myinstance.cn-hangzhou.ots.aliyuncs.com | 實例的訪問地址。具體操作,請參見獲取實例Endpoint。 |
accessKeyId | process.env.OTS_AK_ENV | 通過環(huán)境變量獲取AccessKey,請確保已配置相應(yīng)環(huán)境變量。 |
secretAccessKey | process.env.OTS_SK_ENV | |
instancename | myinstance | 實例名稱。更多信息,請參見實例。 |
maxRetries | 20 | 出錯時最大重試次數(shù)。 |
使用STS初始化
運(yùn)行本代碼示例之前,請確保已設(shè)置環(huán)境變量OTS_AK_ENV
、OTS_SK_ENV
和 OTS_SESSION_TOKEN
。更多信息,請參見配置訪問憑證。
var accessKeyId = process.env.OTS_AK_ENV;
var secretAccessKey = process.env.OTS_SK_ENV;
var stsToken = process.env.OTS_SESSION_TOKEN;
var endpoint = 'yourEndpoint';
var instancename = 'yourInstance';
var client = new TableStore.Client({
accessKeyId: accessKeyId,
secretAccessKey: secretAccessKey,
stsToken: stsToken,
endpoint: endpoint,
instancename: instancename,
});
配置參數(shù)說明請參見下表。
參數(shù) | 示例 | 說明 |
endpoint | https://myinstance.cn-hangzhou.ots.aliyuncs.com | 實例的訪問地址。具體操作,請參見獲取實例Endpoint。 |
accessKeyId | process.env.OTS_AK_ENV | 通過環(huán)境變量獲取AccessKey和STS Token,請確保已配置相應(yīng)環(huán)境變量。 |
accessKeySecret | process.env.OTS_SK_ENV | |
stsToken | process.env.OTS_SESSION_TOKEN | |
instancename | myinstance | 實例名稱。更多信息,請參見實例。 |