Учетные данные Yandex Object Storage
Настройка учетных данных для работы с Yandex Object Storage
Введение
Учетные данные Yandex Object Storage необходимы для работы функций, которые работают с файлами в облачном хранилище. Для создания учетных данных вам понадобятся ключи доступа и информация о bucket из Yandex Cloud.
Учетные данные создаются в разделе Учетные данные.
Начало работы с Yandex Object Storage
Если у вас еще нет аккаунта Yandex Cloud и bucket:
- Зарегистрируйтесь в Yandex Cloud
- Создайте облако и каталог
- Создайте сервисный аккаунт с ролью
storage.editor - Создайте статический ключ доступа для сервисного аккаунта
- Создайте bucket в Object Storage
Подробная документация по работе с Yandex Object Storage доступна в официальной документации Yandex Cloud.
Access Key ID
Access Key ID — это публичный идентификатор ключа доступа. Он используется вместе с Secret Access Key для аутентификации в Yandex Object Storage.
Чтобы получить Access Key ID:
- Войдите в консоль Yandex Cloud
- Перейдите в раздел "Сервисные аккаунты"
- Выберите нужный сервисный аккаунт (или создайте новый)
- Перейдите на вкладку "Ключи"
- Создайте статический ключ доступа
- Скопируйте Access Key ID
Access Key ID выглядит примерно так: YCAJxxxxxxxxxxxxxxxxxxxxx
Secret Access Key
Secret Access Key — это секретный ключ, который используется вместе с Access Key ID для аутентификации. Это критически важная информация, которую необходимо хранить в секрете.
Secret Access Key предоставляется только один раз при создании статического ключа доступа. Если вы потеряли ключ, необходимо создать новый.
Важно:
- Никогда не делитесь Secret Access Key публично
- Не коммитьте ключ в репозитории
- Храните ключ в безопасном месте
- Если ключ скомпрометирован, немедленно создайте новый и обновите учетные данные
Bucket
Bucket — это контейнер для хранения объектов (файлов) в Yandex Object Storage. Каждый bucket имеет уникальное имя в рамках региона.
Чтобы создать bucket:
- Войдите в консоль Yandex Cloud
- Перейдите в раздел "Object Storage"
- Нажмите "Создать bucket"
- Укажите имя bucket (должно быть уникальным в регионе)
- Выберите регион
- Настройте параметры доступа
- Создайте bucket
Имя bucket используется в учетных данных для указания, в каком bucket будут храниться файлы.
Регион
Регион определяет географическое расположение bucket. Выберите регион, который ближе всего к вашим пользователям или соответствует требованиям к хранению данных.
Доступные регионы Yandex Object Storage:
ru-central1— Центральная Россия (по умолчанию)- Другие регионы в зависимости от вашего тарифа
По умолчанию используется регион ru-central1. Если ваш bucket находится в другом регионе, укажите соответствующий регион при настройке учетных данных.
Настройка в системе
Чтобы создать учетные данные Yandex Object Storage в системе:
- Откройте раздел Учетные данные
- Нажмите "Создать учетные данные"
- Выберите тип "Yandex Object Storage"
- Заполните поля:
- Название — удобное имя для идентификации (например, "Хранилище документов")
- Access Key ID — публичный идентификатор ключа доступа
- Secret Access Key — секретный ключ доступа
- Bucket — имя bucket в Object Storage
- Регион — регион bucket (по умолчанию: ru-central1)
- Сохраните учетные данные
После сохранения учетные данные будут доступны для использования в функциях ботов.
Решение проблем
Ошибка аутентификации
Если возникает ошибка аутентификации:
- Проверьте правильность Access Key ID и Secret Access Key
- Убедитесь, что ключи не истекли и не были отозваны
- Проверьте, что сервисный аккаунт имеет необходимые права доступа
- Убедитесь, что ключи скопированы полностью, без лишних пробелов
Bucket не найден
Если bucket не найден:
- Проверьте правильность имени bucket
- Убедитесь, что bucket существует в указанном регионе
- Проверьте, что сервисный аккаунт имеет доступ к bucket
- Убедитесь, что указан правильный регион
Ошибка доступа
Если возникает ошибка доступа:
- Проверьте права доступа сервисного аккаунта (должна быть роль
storage.editorили выше) - Убедитесь, что bucket доступен для сервисного аккаунта
- Проверьте настройки доступа bucket в консоли Yandex Cloud
Ошибка при сохранении
Если не удается сохранить учетные данные:
- Проверьте, что все обязательные поля заполнены
- Убедитесь, что Access Key ID и Secret Access Key введены правильно
- Проверьте, что имя bucket указано корректно
- Убедитесь, что регион соответствует региону bucket
Связанные темы
- Учетные данные — обзор системы учетных данных
- Функции ботов — использование учетных данных в функциях
- Документация Yandex Object Storage — официальная документация