Yandex Cloud
  • Сервисы
  • Решения
  • Почему Yandex Cloud
  • Сообщество
  • Тарифы
  • Документация
  • Связаться с нами
Подключиться
Language / Region
© 2022 ООО «Яндекс.Облако»
Yandex Cloud Functions
  • Сопоставление с другими сервисами Yandex Cloud
  • Начало работы
    • Обзор
    • Создание функции
      • Обзор
      • Node.js
      • Python
      • Go
      • PHP
      • Bash
      • Java
    • Создание триггера
      • Обзор
      • Таймер
      • Триггер для Message Queue
      • Триггер для Object Storage
      • Триггер для Container Registry
      • Триггер для Cloud Logs
      • Триггер для Cloud Logging
      • Триггер для Yandex IoT Core
      • Триггер для бюджетов
      • Триггер для Data Streams
  • Пошаговые инструкции
    • Все инструкции
    • Получение IAM-токена сервисного аккаунта с помощью функции
    • Подключение к управляемым БД из функции
    • Управление правами доступа к функции
    • Управление функцией
      • Создание функции
      • Управление версиями функции
      • Работа в редакторе кода
      • Вызов функции
      • Изменение функции
      • Масштабирование функции
      • Мониторинг функции
      • Просмотр журнала выполнения
      • Удаление функции
    • Управление триггером
      • Получение информации о триггере
      • Создание таймера
      • Создание триггера для Message Queue
      • Создание триггера для Object Storage
      • Создание триггера для Container Registry
      • Создание триггера для Cloud Logs
      • Создание триггера для Cloud Logging
      • Создание триггера для Yandex IoT Core
      • Создание триггера для бюджетов
      • Создание триггера для Data Streams
      • Изменение триггера
      • Мониторинг триггера
      • Удаление триггера
  • Концепции
    • Обзор
    • Функция
    • Вызов функции
    • Среда выполнения
      • Обзор
      • Окружение
      • Контекст выполнения
      • Предзагружаемая среда выполнения
    • Сборщик
    • Триггер
      • Обзор
      • Таймер
      • Триггер для Message Queue
      • Триггер для Object Storage
      • Триггер для Container Registry
      • Триггер для Cloud Logs
      • Триггер для Cloud Logging
      • Триггер для Yandex IoT Core
      • Триггер для бюджетов
      • Триггер для Data Streams
    • Dead Letter Queue
    • Лог-группа
    • Резервное копирование
    • Квоты и лимиты
  • Разработка на Node.js
    • Обзор
    • Управление зависимостями
    • Обработчик запросов
    • Контекст вызова
    • Журналирование
    • Обработка ошибок
    • Использование SDK
  • Разработка на Python
    • Обзор
    • Управление зависимостями
    • Обработчик запросов
    • Контекст вызова
    • Журналирование
    • Обработка ошибок
    • Использование SDK
  • Разработка на Go
    • Обзор
    • Управление зависимостями
    • Обработчик запросов
    • Контекст вызова
    • Журналирование
    • Обработка ошибок
    • Использование SDK
  • Разработка на PHP
    • Обзор
    • Управление зависимостями
    • Обработчик запросов
    • Контекст вызова
    • Журналирование
    • Обработка ошибок
  • Разработка на Bash
    • Обзор
    • Обработчик запросов
    • Журналирование
    • Обработка ошибок
    • Использование SDK
  • Разработка на Java
    • Обзор
    • Модель программирования
      • Обзор
      • Интерфейс Function
      • Интерфейс YcFunction
      • Класс HttpServlet
      • Spring Boot
    • Управление зависимостями
    • Обработчик запросов
    • Контекст вызова
    • Журналирование
    • Обработка ошибок
    • Использование SDK
  • Разработка на R
    • Обзор
    • Модель программирования
    • Управление зависимостями
    • Обработчик запросов
    • Контекст вызова
    • Журналирование
    • Обработка ошибок
  • Разработка на C#
    • Обзор
    • Модель программирования
      • Обзор
      • Интерфейс Function
      • Интерфейс YcFunction
    • Управление зависимостями
    • Обработчик запросов
    • Контекст вызова
    • Журналирование
    • Обработка ошибок
    • Использование SDK
  • Практические руководства
    • Создание навыка Алисы
    • Развертывание веб-приложения
    • Разработка навыка Алисы и сайта с авторизацией
    • Запись данных с устройства в Managed Service for PostgreSQL
    • Разработка Slack-бота
    • Разработка Telegram-бота
    • Подключение к базе данных YDB из функции на Python
    • Подключение к базе данных YDB из функции на Node.js
    • Конвертация видео в GIF на Python
    • Создание функции Node.js с помощью TypeScript
  • Правила тарификации
  • Управление доступом
  • Справочник API Functions
    • Аутентификация в API
    • gRPC (англ.)
      • Overview
      • FunctionService
      • OperationService
    • REST (англ.)
      • Overview
      • Function
        • Overview
        • create
        • createVersion
        • delete
        • get
        • getVersion
        • getVersionByTag
        • list
        • listAccessBindings
        • listOperations
        • listRuntimes
        • listScalingPolicies
        • listTagHistory
        • listVersions
        • removeScalingPolicy
        • removeTag
        • setAccessBindings
        • setScalingPolicy
        • setTag
        • update
        • updateAccessBindings
  • Справочник API Triggers
    • Аутентификация в API
    • gRPC (англ.)
      • Overview
      • TriggerService
      • OperationService
    • REST (англ.)
      • Overview
      • Trigger
        • Overview
        • create
        • delete
        • get
        • list
        • listOperations
        • pause
        • resume
        • update
  • Вопросы и ответы
  1. Разработка на Go
  2. Использование SDK

Использование SDK для функции на Go

Статья создана
Yandex Cloud

    Среда выполнения не содержит предустановленной библиотеки для работы с API Yandex Cloud. Для её использования требуется добавить зависимость в приложение на Go. С исходным кодом библиотеки можно ознакомиться на GitHub.

    SDK (Software Development Kit) позволяет взаимодействовать с сервисами Yandex Cloud с помощью сервисного аккаунта, указанного в функции.

    Пример:

    Следующая функция получает на вход запрос с двумя полями: ID папки (FolderId) и тег (Tag), авторизуется в SDK, получает список всех виртуальных машин Compute Cloud в заданной папке, фильтрует их по заданному тегу, и запускает остановленные машины. В качестве результата возвращает сообщение-отчёт с количеством запущенных машин.

    Важно

    Функцию необходимо вызывать с помощью YC CLI или с помощью HTTP-запроса с параметром integration=raw.

    package main
    
    import (
      "context"
      "fmt"
      "github.com/yandex-cloud/go-genproto/yandex/cloud/compute/v1"
      "github.com/yandex-cloud/go-genproto/yandex/cloud/operation"
      "github.com/yandex-cloud/go-sdk"
    )
    
    func startComputeInstance(ctx context.Context, sdk *ycsdk.SDK, id string) (*operation.Operation, error) {
      // Операция запуска Compute Instance с указанным ID
      return sdk.Compute().Instance().Start(ctx, &compute.StartInstanceRequest{
        InstanceId: id,
      })
    }
    
    type Request struct {
      FolderId string `json:"folderId"`
      Tag      string `json:"tag"`
    }
    
    type Response struct {
      StatusCode int         `json:"statusCode"`
      Body       interface{} `json:"body"`
    }
    
    func StartComputeInstances(ctx context.Context, request *Request) (*Response, error) {
      // Авторизация в SDK при помощи сервисного аккаунта
      sdk, err := ycsdk.Build(ctx, ycsdk.Config{
        // Вызов InstanceServiceAccount автоматически запрашивает IAM-токен и формирует
        // при помощи него данные для авторизации в SDK
        Credentials: ycsdk.InstanceServiceAccount(),
      })
      if err != nil {
        return nil, err
      }
      // Получение списка Compute Instance по заданному запросом FolderId
      listInstancesResponse, err := sdk.Compute().Instance().List(ctx, &compute.ListInstancesRequest{
        FolderId: request.FolderId,
      })
      if err != nil {
        return nil, err
      }
      instances := listInstancesResponse.GetInstances()
      count := 0
      // Фильтрация списка Compute Instance, фильтр: выключена, в тегах содержится тег, заданный запросом
      for _, i := range instances {
        labels := i.Labels
        if _, ok := labels[request.Tag]; ok && i.Status != compute.Instance_RUNNING {
          // Запуск удовлетворяющих фильтру Compute Instance
          _, err := startComputeInstance(ctx, sdk, i.GetId())
          if err != nil {
            return nil, err
          }
          count++
        }
      }
      return &Response{
        StatusCode: 200,
        Body:       fmt.Sprintf("Started %d instances", count),
      }, nil
    }
    

    Файл go.mod:

    module example
    
    go 1.14
    

    Была ли статья полезна?

    Language / Region
    © 2022 ООО «Яндекс.Облако»