tencentcloud-sdk-nodejs-common

constructor

constructor(
    endpoint: string,
    version: string,
    { credential, region, profile }: ClientConfig
);

• Constructs a new AbstractClient instance

  Parameter endpoint

  The service endpoint URL (e.g. "cvm.tencentcloudapi.com")

  Parameter version

  The API version of the service (e.g. "2017-03-12")

  Parameter config

  Configuration object containing:

  Parameter

  {Credential|DynamicCredential} config.credential - Credentials for authentication

  Parameter

  {string} [config.region] - The region of the service (e.g. "ap-shanghai")

  Parameter

  {ClientProfile} [config.profile={}] - Optional client configuration profile

  Throws

  {TencentCloudSDKHttpException} If invalid language is specified in profile

  Example 1

  const client = new AbstractClient( "cvm.tencentcloudapi.com", "2017-03-12", { credential: { secretId: process.env.secretId, secretKey: process.env.secretKey, }, region: "ap-shanghai", profile: {} } );

property apiVersion

apiVersion: string;

• The API version of the service (e.g. "2017-03-12")

property credential

credential: Credential | DynamicCredential;

• User's security credentials (SecretId, SecretKey, Token)

property endpoint

endpoint: string;

• The service endpoint URL (e.g. "cvm.tencentcloudapi.com")

property path

path: string;

• API request path (usually "/")

property profile

profile: ClientProfile;

• Optional configuration instance

property region

region: string;

• The region of the service (e.g. "ap-shanghai")

property sdkVersion

sdkVersion: string;

• SDK version string

method getCredential

getCredential: () => Promise<Credential>;

• Get credential information

  Returns

  {Promise} Promise that resolves with credential information

method request

request: (
    action: string,
    req: any,
    options?: ResponseCallback | RequestOptions,
    cb?: ResponseCallback
) => Promise<ResponseData>;

• Make an API request to Tencent Cloud service

  Parameter action

  The API action name to call

  Parameter req

  The request payload/parameters

  Parameter options

  Either request options or callback function

  Parameter cb

  Optional callback function for async operation

  Returns

  {Promise} Promise that resolves with the API response data

  Example 1

  // Using promise client.request('DescribeInstances', {Limit: 10}) .then(data => console.log(data)) .catch(err => console.error(err));

  // Using callback client.request('DescribeInstances', {Limit: 10}, (err, data) => { if (err) console.error(err); else console.log(data); });

  // With options client.request('DescribeInstances', {Limit: 10}, {signal: abortController.signal}) .then(data => console.log(data)) .catch(err => console.error(err));

method requestOctetStream

requestOctetStream: (
    action: string,
    req: any,
    options?: ResponseCallback | RequestOptions,
    cb?: ResponseCallback
) => Promise<any>;

• Make a request with octet-stream content type

  Parameter action

  API action name

  Parameter req

  Request data

  Parameter options

  Request options or callback

  Parameter cb

  Callback function

  Returns

  {Promise} Promise that resolves with response data

property credential

credential: Credential | DynamicCredential;

• Parameter credential

  Authentication information

property profile

profile?: ClientProfile;

• Parameter profile

  Optional configuration instance Optional, can be skipped if no special requirements

property region

region?: string;

• Parameter region

  Product region Required for region-specific products (e.g. CVM), optional for non-region products (e.g. SMS)

property httpProfile

httpProfile?: HttpProfile;

• HTTP related options instance {HttpProfile} Optional

property language

language?: 'zh-CN' | 'en-US';

• Language field attached to API requests {"zh-CN" | "en-US"} Optional

property signMethod

signMethod?: 'TC3-HMAC-SHA256' | 'HmacSHA256' | 'HmacSHA1';

• Signature method (TC3-HMAC-SHA256 HmacSHA1 HmacSHA256) {string} Optional

property secretId

secretId?: string;

• Tencent Cloud account secretId and secretKey Optional, mutually exclusive with token

property secretKey

secretKey?: string;

• Tencent Cloud account secretKey Optional, mutually exclusive with token

property token

token?: string;

• Tencent Cloud account token Optional, mutually exclusive with secretId

method getCredential

getCredential: () => Promise<Credential>;

property agent

agent?: Agent;

• Advanced request agent, e.g. new HttpsProxyAgent("http://127.0.0.1:8899")

  Higher priority than proxy configuration

property endpoint

endpoint?: string;

• The service endpoint URL (e.g. "cvm.tencentcloudapi.com") {string} Optional

property headers

headers?: Record<string, string>;

• Custom headers, e.g. { "X-TC-TraceId": "ffe0c072-8a5d-4e17-8887-a8a60252abca" } {Record<string, string>} Optional

property protocol

protocol?: string;

• Protocol, currently supports "https://" {string} Optional

property proxy

proxy?: string;

• HTTP request proxy, e.g. "http://127.0.0.1:8899"

property reqMethod

reqMethod?: 'POST' | 'GET';

• Request method {"POST" | "GET"} Optional

property reqTimeout

reqTimeout?: number;

• Request timeout in seconds, default 60s {number} Optional

property multipart

multipart?: boolean;

• Whether the request is multipart

property signal

signal?: AbortSignal;

• Abort request signal