Alibaba Cloud SDK:SDK の統合

1. SDK センターにログインし、SDK を使用するサービスを選択します。 この例では、Short Message Service (SMS) が選択されています。

2. [インストール] ページ、[すべての言語] で [Go] を選択します。 次に、[クイックスタート] タブで、Short Message Service (SMS) の SDK インストール方法を見つけることができます。

特殊なシナリオ: Advance 操作によるファイルのアップロード

Image Search または Visual Intelligence API (VIAPI) を使用してオンプレミスマシン上の画像を処理したり、画像をアップロードしたりする場合、ドキュメントに記載されている Image Search または VIAPI の API は、直接アップロードをサポートしていません。 画像をアップロードするには、ファイルストリームの送信をサポートする Advance 操作を使用する必要があります。 クラウドサービスは、アップロードされたファイルを Object Storage Service (OSS) に一時的に保存し、必要に応じて OSS から一時ファイルを読み取ります。 OSS のデフォルトリージョンは cn-shanghai です。 次の例は、VIAPI の DetectBodyCount 操作を呼び出す方法を示しています。

1. リクエストクライアントの初期化

   RegionId パラメーターとクラウドサービスの endpoint の両方が指定されていることを確認してください。 RegionId は、一時ファイルが保存される OSS リージョンを示します。 RegionId パラメーターを設定しない場合、クラウドサービスは OSS とは異なるリージョンを使用する可能性があり、API のタイムアウトが発生する可能性があります。

   import (
     "os"
   
     openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
     facebody20191230 "github.com/alibabacloud-go/facebody-20191230/v5/client"
     "github.com/alibabacloud-go/tea/tea"
   )
   
   func CreateClient() (_result *facebody20191230.Client, _err error) {
     config := &openapi.Config{
       // 必須。 ALIBABA_CLOUD_ACCESS_KEY_ID 環境変数が実行時環境に設定されていることを確認してください。
       AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
       // 必須。 ALIBABA_CLOUD_ACCESS_KEY_SECRET 環境変数が実行時環境に設定されていることを確認してください。
       AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
     }
     // エンドポイントと regionId は同じリージョンに設定する必要があります。
     config.RegionId = tea.String("cn-shanghai")
     config.Endpoint = tea.String("facebody.cn-shanghai.aliyuncs.com")
     _result, _err = facebody20191230.NewClient(config)
     return _result, _err
   }

2. AdvanceRequest 構造体インスタンスの作成

   ローカルファイルをアップロードする場合、ファイルストリームを渡すには SDK が提供する AdvanceRequest 構造体を使用する必要があります。 AdvanceRequest 構造体の命名形式は <OpenAPI 操作名>AdvanceRequest です。 ファイルストリームを渡すためのパラメーター名を見つけるには、対応する AdvanceRequest 構造体で io.Reader 型のパラメーターを探します。

   // ファイルパスに置き換えます。
   filePath := `<FILE_PATH>`
   // ファイルを開いてストリームを作成します。
   file, err := os.Open(filePath)
   if err != nil {
     return fmt.Errorf("Failed to open file: %v", err)
   }
   defer file.Close() // ファイルを閉じます。
   // AdvanceRequest 構造体のインスタンスを作成します。
   detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
     ImageURLObject: file,
   }

3. リクエストの開始

   <操作名>Advance 関数を呼び出してリクエストを開始します。 入力パラメーターは、AdvanceRequest 構造体へのポインターです。

   // import 文に 'util "github.com/alibabacloud-go/tea-utils/v2/service"' を追加する必要があります。
   
   func _main() (response *facebody20191230.DetectBodyCountResponse, _err error) {
     client, _err := CreateClient()
     if _err != nil {
       return nil, _err
     }
   
     // ファイルパスに置き換えます。
     filePath := `<FILE_PATH>`
     // ファイルを開いてストリームを作成します。
     file, err := os.Open(filePath)
     if err != nil {
       return nil, fmt.Errorf("Failed to open file: %v", err)
     }
     defer file.Close() // ファイルを閉じます。
     // リクエストオブジェクトを作成します。
     detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
       ImageURLObject: file,
     }
     runtime := &util.RuntimeOptions{}
     // リクエストを開始します。
     response, _err = client.DetectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime)
   
     if _err != nil {
       return nil, _err
     }
     return response, nil
   }

package main

import (
  "fmt"
  "os"

  openapi "github.com/alibabacloud-go/darabonba-openapi/v2/client"
  facebody20191230 "github.com/alibabacloud-go/facebody-20191230/v5/client"
  util "github.com/alibabacloud-go/tea-utils/v2/service"
  "github.com/alibabacloud-go/tea/tea"
)

func CreateClient() (_result *facebody20191230.Client, _err error) {

  config := &openapi.Config{
    // 必須。 ALIBABA_CLOUD_ACCESS_KEY_ID 環境変数が実行時環境に設定されていることを確認してください。
    AccessKeyId: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_ID")),
    // 必須。 ALIBABA_CLOUD_ACCESS_KEY_SECRET 環境変数が実行時環境に設定されていることを確認してください。
    AccessKeySecret: tea.String(os.Getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")),
  }
  config.RegionId = tea.String("cn-shanghai")
  config.Endpoint = tea.String("facebody.cn-shanghai.aliyuncs.com")
  _result, _err = facebody20191230.NewClient(config)
  return _result, _err
}

func _main() (response *facebody20191230.DetectBodyCountResponse, _err error) {
  client, _err := CreateClient()
  if _err != nil {
    return nil, _err
  }

  // ファイルパスに置き換えます。
  filePath := `<FILE_PATH>`
  // ファイルを開いてストリームを作成します。
  file, err := os.Open(filePath)
  if err != nil {
    return nil, fmt.Errorf("Failed to open file: %v", err)
  }
  defer file.Close() // ファイルを閉じます。
  // リクエストオブジェクトを作成します。
  detectBodyCountAdvanceRequest := &facebody20191230.DetectBodyCountAdvanceRequest{
    ImageURLObject: file,
  }
  runtime := &util.RuntimeOptions{}
  // リクエストを開始します。
  response, _err = client.DetectBodyCountAdvance(detectBodyCountAdvanceRequest, runtime)

  if _err != nil {
    return nil, _err
  }
  return response, nil
}
func main() {
  response, err := _main()
  if err != nil {
    panic(err)
  }
  fmt.Println(response)
}

よくある質問

1. API 操作によってスローされた "You are not authorized to perform this operation" エラーを処理するにはどうすればよいですか？

   考えられる原因と解決策

   考えられる原因: Resource Access Management (RAM) ユーザーの AccessKey ペアに、API 操作を呼び出す権限がありません。

   解決策: RAM ユーザーに必要な権限を付与します。 詳細については、「RAM ユーザーへの権限付与」をご参照ください。

   たとえば、SendMessageToGlobe API 操作によって "You are not authorized to perform this operation" エラーがスローされた場合は、次のカスタムポリシーを作成して、RAM ユーザーに必要な権限を付与します。

   {
     "Version": "1",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": "dysms:SendMessageToGlobe",
         "Resource": "*"
       }
     ]
   }

2. API 操作によってスローされた "SDKError: Message: Post "https://ecs-cn-XX.aliyuncs.com": dial tcp: lookup ecs-cn-XX.aliyuncs.com: no such host" エラーを処理するにはどうすればよいですか？

   考えられる原因と解決策

   考えられる原因: リクエストクライアントを初期化するときに指定したエンドポイントを API 操作がサポートしていません。

   解決策: サポートされているエンドポイントを指定して、再試行してください。 詳細については、「エンドポイントの設定」をご参照ください。

3. API 操作によってスローされた "SDKError: StatusCode: 404 Code: InvalidAccessKeyId.NotFound Message: code: 404, Specified access key is not found" エラーを処理するにはどうすればよいですか？

   考えられる原因と解決策

   考えられる原因: AccessKey ペアがリクエストに正しく渡されていません。

   解決策: リクエストクライアントを初期化するときに、AccessKey ペアが正しく渡されていることを確認してください。 os.Getenv("XXX") の XXX 値は環境変数から取得されます。

SDK エラーの処理方法の詳細については、「よくある質問」をご参照ください。