Начало работы

Перед началом работы выберите подходящий способ авторизации и подготовьте учетные данные, необходимые для выбранного способа.

Чтобы начать работу с MWS SDK для Go:

1. Установите SDK.
2. Авторизуйтесь в MWS Cloud Platform.
3. Выполните проверочный запрос.

1. Создайте новую локальную директорию для кода (например, my-project) и инициализируйте Go-модуль:

   1
   mkdir my-project
   2
   cd my-project
   3
   go mod init my-project

2. Добавьте зависимость в Go-проект:

   1
   go get go.mws.cloud/go-sdk

В этом примере для авторизации используется IAM-токен.

Задайте переменные окружения:

1
export MWS_TOKEN="$(mws iam create-token)" # Команда автоматически получит и сохранит IAM-токен
2
export MWS_PROJECT="<имя проекта в MWS Cloud Platform>"

1. В директории проекта создайте файл main.go.

2. В созданный файл добавьте код:

   Пример кода

   1
   package main
   2
   
   3
   import (
   4
       "context"
   5
       "fmt"
   6
       "log"
   7
   
   8
       "go.mws.cloud/util-toolset/pkg/utils/ptr"
   9
   
   10
       computeclient "go.mws.cloud/go-sdk/service/compute/client"
   11
       computesdk "go.mws.cloud/go-sdk/service/compute/sdk"
   12
       "go.mws.cloud/go-sdk/mws"
   13
   )
   14
   
   15
   func main() {
   16
       ctx := context.Background()
   17
   
   18
       // Загрузка конфигурации SDK из переменных окружения (MWS_PROJECT и MWS_TOKEN).
   19
       // Вы можете переопределить настройки с помощью функциональных опций mws.LoadSDKOption.
   20
       sdk, err := mws.Load(ctx)
   21
       if err != nil {
   22
           log.Fatalln("Ошибка загрузки SDK:", err)
   23
       }
   24
       defer sdk.Close(ctx)
   25
   
   26
       // Создание клиента для работы с сервисом виртуальных машин
   27
       client, err := computesdk.NewVirtualMachine(ctx, sdk)
   28
       if err != nil {
   29
           log.Panicln("Ошибка создания клиента:", err)
   30
       }
   31
   
   32
       // Получение списка ВМ с ограничением страницы до 10 штук
   33
       virtualMachines, err := client.ListVirtualMachines(ctx, computeclient.ListVirtualMachinesRequest{
   34
           PageSize: ptr.Get(10),
   35
       })
   36
       if err != nil {
   37
           log.Panicln("Ошибка получения списка виртуальных машин:", err)
   38
       }
   39
   
   40
       // Вывод идентификаторов найденных виртуальных машин
   41
       fmt.Println("Виртуальные машины:")
   42
       for _, vm := range virtualMachines.GetItems() {
   43
           fmt.Println(vm.GetMetadata().GetId())
   44
       }
   45
   }

   Код в примере инициализирует клиент SDK с использованием IAM-токена и получает список виртуальных машин в вашем проекте.

3. Выполните команду для запуска кода:

   1
   go run main.go

   Если аутентификация прошла успешно, вы увидите список идентификаторов виртуальных машин в проекте.

   Если в проекте нет виртуальных машин, список будет пустым.

Вы можете настроить конфигурацию Go-проекта с помощью переменных окружения или функциональных опций.