Alibaba Cloud SDK:Alibaba Cloud SDK for Node.js に関するよくある質問

AccessKey エラーの対処方法

問題：コードの実行後に次のエラーメッセージが返されます。このエラーメッセージは、AccessKey ペアが正しく構成されていないことを示しています。

• Alibaba Cloud SDK V2.0 for Node.js：Cannot read properties of undefined (reading 'getCredential')。

• Alibaba Cloud SDK V1.0 for Node.js：AssertionError [ERR_ASSERTION]: must pass "config.accessKeyId"。

解決策：

1. 次のコマンドを実行して、`ALIBABA_CLOUD_ACCESS_KEY_ID` および `ALIBABA_CLOUD_ACCESS_KEY_SECRET` 環境変数が構成されているかどうかを確認します。

   Linux/macOS

   echo $ALIBABA_CLOUD_ACCESS_KEY_ID
   echo $ALIBABA_CLOUD_ACCESS_KEY_SECRET

   Windows

   echo %ALIBABA_CLOUD_ACCESS_KEY_ID%
   echo %ALIBABA_CLOUD_ACCESS_KEY_SECRET%

   有効な AccessKey ペアが返された場合、環境変数は正しく構成されています。AccessKey ペアが返されないか、無効な AccessKey ペアが返された場合は、必要に応じて環境変数を構成してください。詳細については、「Linux、macOS、Windows で環境変数を構成する」をご参照ください。

2. コード内の AccessKey ペアに関連するエラーを確認します。

   リクエスト失敗のサンプル：

    let config = new OpenApi.Config({
         accessKeyId: process.env['yourAccessKeyID'],
         accessKeySecret: process.env['yourAccessKeySecret'],
       });

   リクエスト成功のサンプル：

   let config = new OpenApi.Config({
         accessKeyId: process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'],
         accessKeySecret: process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
       });

   説明

   process.env['ALIBABA_CLOUD_ACCESS_KEY_ID'] と process.env['ALIBABA_CLOUD_ACCESS_KEY_SECRET'] は、それぞれの環境変数から値を取得する式です。

   重要

   セキュリティリスクを防ぐため、オンラインコードに AccessKey ペアを書き込まないでください。

tsc コマンドを実行した後、「tsc: Fail to recognize the tsc command as the name of a cmdlet, a function, a script, or a executable program...」というエラーメッセージが返された場合の対処方法

PS C:\Users\issuser\Downloads\69351a7d-c9ef-417c-8986-a371cd208ece-TypeScript> tsc
tsc : The term 'tsc' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1
+ tsc
+ ~~~
    + CategoryInfo          : ObjectNotFound: (tsc:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

API リクエストがタイムアウトし、「Error: connect ETIMEDOUT」というメッセージが返された場合の対処方法

一般的な原因と解決策：

API 呼び出しのタイムアウトは、複数の要因によって引き起こされる可能性があります。以下に、一般的な原因とそれに対応する解決策を説明します。

原因 1：ネットワーク接続の問題

原因：クライアントとサーバー間のネットワーク接続の失敗やネットワークの不安定さにより、リクエストがサーバーに到達できません。

解決策：

オンプレミスホストとクラウドサービスのエンドポイント間の接続性をテストするには、ping または curl コマンドを実行します。たとえば、お使いのオンプレミスホストと Short Message Service (SMS) API のエンドポイント間の接続性をテストするには、ping dysmsapi.aliyuncs.com または curl -v https://dysmsapi.aliyuncs.com コマンドを実行します。

• コマンドがタイムアウトするか、応答を受信しない場合は、オンプレミスのファイアウォールまたはルーターのブロッキングポリシーを確認してください。

• 応答が返された場合は、不適切なタイムアウト構成によるリクエストの失敗を防ぐために、適切なタイムアウト期間を指定することを推奨します。詳細については、「タイムアウト期間の設定」をご参照ください。サンプルコード：

  JavaScript

  // Create a RuntimeOptions instance and specify runtime parameters. 
      const runtime = new RuntimeOptions({
          // Configure a timeout period for connection requests.
          connectTimeout: 10000,
      });

  TypeScript

  // Create a RuntimeOptions instance and specify runtime parameters. 
          const runtime = new $Util.RuntimeOptions({
              // Configure a timeout period for connection requests.
              connectTimeout: 10000,
          });

原因 2：リクエストの処理に時間がかかる

説明：API リクエストの処理時間が、指定された読み取りタイムアウト期間を超えています。

解決策：API の応答時間が長くなることに対応するため、タイムアウト期間を設定します。詳細については、「タイムアウト期間の設定」をご参照ください。たとえば、読み取りタイムアウトパラメーターを設定して、読み取りタイムアウト期間を延長できます。サンプルコード：

// Create a RuntimeOptions instance and specify runtime parameters. 
    const runtime = new RuntimeOptions({
        // Configure a timeout period for read requests.
        readTimeout: 10000,
    });

// Create a RuntimeOptions instance and specify runtime parameters. 
        const runtime = new $Util.RuntimeOptions({
            // Configure a timeout period for read requests.
            readTimeout: 10000,
        });

API オペレーションの呼び出し時に「MissingRequiredParameter」エラーが報告された場合の対処方法

この例では、Short Message Service (SMS) サービスの SendSms オペレーションが呼び出されます。

• OpenAPI Explorer の API デバッグ ページに移動し、プロダクトと API を選択します。

• 作成されたリクエストオブジェクトに、phoneNumbers や signName などのすべての必須パラメーターが指定されているかを確認します。この例では、SendSmsRequest オブジェクトを使用します。

• API リファレンスに基づいて、すべての必須パラメーターが指定されていることを確認します。

• 必須パラメーターの値が有効であることを確認します。たとえば、携帯電話番号が有効なフォーマットで指定されているかを確認します。

• SDKは、API リクエストを送信する前に、パラメーターを自動的に検証します。必須パラメーターが1つ以上指定されていない場合、MissingRequiredParameter などのエラーが報告されます。たとえば、phoneNumbers パラメーターが指定されていない場合、「MissingPhoneNumbers: code: 400」というエラーが報告されます。この場合、エラーメッセージに基づいてパラメーターを指定してください。

let sendSmsRequest = new Dysmsapi20170525.SendSmsRequest({
      phoneNumbers: '<YOUR_VALUE>',
      signName: '<YOUR_VALUE>',
      templateCode: '<YOUR_VALUE>',
    });

let sendSmsRequest = new $Dysmsapi20170525.SendSmsRequest({
      phoneNumbers: "<YOUR_VALUE>",
      signName: "<YOUR_VALUE>",
      templateCode: "<YOUR_VALUE>",
    });

指定されたリージョンでオペレーションがサポートされていないために API オペレーションの呼び出しに失敗し、「getaddrinfo ENOTFOUND」というメッセージが返された場合の対処方法

呼び出しているサービスが選択したリージョンで利用可能であることを確認してください。OpenAPI Explorer で正しいサービスエンドポイントを見つけることができます。正しいエンドポイントを使用していることを確認してください。

OpenAPI Explorer の上部ナビゲーションバーで、Short Message Service を選択します。プロダクトのホームページで、[サービスエリアリスト] タブに移動します。エンドポイントのフォーマットは [product_code].[region_id].aliyuncs.com です。この表には、各リージョン ID (cn-beijing、cn-hangzhou、cn-shanghai など) とそれに対応するサービスエンドポイント (dysmsapi.aliyuncs.com など) がリストされています。

npm install コマンドが報告するエラーには、どのように対処すればよいですか？

Node.js と npm が正しくインストールされていることを確認してください。詳細については、「Windows に Node.js をインストールする」をご参照ください。

依存パッケージのバージョン競合の解決方法

• npm ls コマンドを実行して依存関係ツリーを表示し、バージョンの競合が発生しないことを確認します。

• node_modules ディレクトリと package-lock.json ファイルを削除し、依存関係を再インストールします。

 rm -rf node_modules package-lock.json
 npm install