Yandex Cloud
Поиск
Связаться с намиПодключиться
  • Истории успеха
  • Документация
  • Блог
  • Все сервисы
  • Статус работы сервисов
    • Популярные
    • Инфраструктура и сеть
    • Платформа данных
    • Контейнеры
    • Инструменты разработчика
    • Бессерверные вычисления
    • Безопасность
    • Мониторинг и управление ресурсами
    • AI Studio
    • Бизнес-инструменты
  • Все решения
    • По отраслям
    • По типу задач
    • Экономика платформы
    • Безопасность
    • Техническая поддержка
    • Каталог партнёров
    • Обучение и сертификация
    • Облако для стартапов
    • Облако для крупного бизнеса
    • Центр технологий для общества
    • Облако для интеграторов
    • Поддержка IT-бизнеса
    • Облако для фрилансеров
    • Обучение и сертификация
    • Блог
    • Документация
    • Контент-программа
    • Мероприятия и вебинары
    • Контакты, чаты и сообщества
    • Идеи
    • Тарифы Yandex Cloud
    • Промоакции и free tier
    • Правила тарификации
  • Истории успеха
  • Документация
  • Блог
Проект Яндекса
© 2025 ООО «Яндекс.Облако»
Страница сервиса
Yandex Cloud Notification Service
Документация
Yandex Cloud Notification Service
    • Обзор
    • Начало работы с мобильными Push-уведомлениями
    • Начало работы с Push-уведомлениями в браузере
    • Начало работы с SMS
    • Начало работы с топиками
    • Обзор
    • Мобильные Push-уведомления
    • Push-уведомления в браузере
    • SMS
    • Топики
    • Квоты и лимиты
    • Все инструменты
    • AWS CLI
    • AWS SDK для С++
    • AWS SDK для Go
    • AWS SDK для Java
    • AWS SDK для JavaScript
    • AWS SDK для Kotlin
    • AWS SDK для .NET
    • AWS SDK для PHP
    • AWS SDK для Python (boto3)
  • Правила тарификации
  • Метрики Monitoring
  • Логи Cloud Logging
  • История изменений

В этой статье:

  • Подготовьте облако к работе
  • Получите статический ключ доступа
  • Настройте AWS SDK
  • Создайте канал уведомлений
  • Получите список каналов уведомлений
  • Создайте эндпоинт
  • Отправьте уведомление
  • Явные уведомления (Bright Push)
  • Тихие уведомления (Silent Push)
  • См. также
  1. Инструменты
  2. AWS SDK для Python (boto3)

Как начать работать с AWS SDK для Python (boto3) в Yandex Cloud Notification Service

Статья создана
Yandex Cloud
Обновлена 13 марта 2025 г.
  • Подготовьте облако к работе
  • Получите статический ключ доступа
  • Настройте AWS SDK
  • Создайте канал уведомлений
  • Получите список каналов уведомлений
  • Создайте эндпоинт
  • Отправьте уведомление
    • Явные уведомления (Bright Push)
    • Тихие уведомления (Silent Push)
  • См. также

Примечание

Сервис находится на стадии Preview.

boto3 — это комплект средств разработки (SDK) для языка программирования Python 3.x. SDK предназначен для работы с сервисами, совместимыми с Amazon SNS API.

Чтобы начать работу с AWS SDK для Python (boto3):

  1. Подготовьте облако к работе.
  2. Получите статический ключ доступа.
  3. Настройте AWS SDK.
  4. Создайте канал уведомлений.
  5. Получите список каналов.
  6. Создайте эндпоинт.
  7. Отправьте уведомление.

Подготовьте облако к работеПодготовьте облако к работе

Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:

  1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
  2. На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.

Если у вас есть активный платежный аккаунт, вы можете создать или выбрать каталог, в котором будет работать ваша инфраструктура, на странице облака.

Подробнее об облаках и каталогах.

Получите статический ключ доступаПолучите статический ключ доступа

Для аутентификации в Cloud Notification Service используется статический ключ доступа. Этот ключ выпускается на сервисный аккаунт, и все действия выполняются от имени этого сервисного аккаунта.

Чтобы получить статический ключ доступа:

  1. Создайте сервисный аккаунт.

  2. Назначьте сервисному аккаунту роль editor на каталог.

  3. Для сервисного аккаунта создайте статический ключ доступа.

    Сохраните идентификатор и секретный ключ.

Настройте AWS SDKНастройте AWS SDK

  1. Установите Python.

  2. Установите AWS SDK для Python (boto3) с помощью команды:

    pip install boto3
    
  3. Создайте клиент:

    import boto3
    
    client = boto3.client(
        "sns",
        endpoint_url="https://notifications.yandexcloud.net/",
        region_name="ru-central1",
        aws_access_key_id="<идентификатор_статического_ключа>",
        aws_secret_access_key="<секретный_ключ>",
        verify=False # Disable SSL verification for notifications.yandexcloud.net
    )
    

    Где:

    • aws_access_key_id — идентификатор статического ключа.
    • aws_secret_access_key — секретный ключ.

Создайте канал уведомленийСоздайте канал уведомлений

response = client.create_platform_application(
    Name="<имя_канала>",
    Platform="<тип_платформы>",
    Attributes= {
         "<параметр1>": "<значение1>",
         ...
         "<параметрN>": "<значениеN>"
    }
)
print ("Platform application ARN:", response['PlatformApplicationArn'])

Где:

  • Name — имя канала уведомлений, задается пользователем.

    Имя должно быть уникальным для всего CNS. После создания канала изменить имя нельзя. Имя может содержать строчные и заглавные буквы латинского алфавита, цифры, подчеркивания, дефисы и точки. Длина — от 1 до 256 символов. Рекомендуется для каналов APNs указывать в имени идентификатор приложения (Bundle ID), для FCM и HMS — полное название пакета приложения (Package name), для RuStore — значение packageName.

  • Platform — тип мобильной платформы:

    • APNS и APNS_SANDBOX — Apple Push Notification service (APNs). Для тестирования приложения используйте APNS_SANDBOX.
    • GCM — Firebase Cloud Messaging (FCM).
    • HMS — Huawei Mobile Services (HMS).
    • RUSTORE — RuStore Android.
  • Attributes — параметры аутентификации на мобильной платформе в формате "<параметр>": "<значение>" через запятую. Значения зависят от типа платформы:

    • APNs:

      • Аутентификация с токеном:

        • PlatformPrincipal — путь к файлу с ключом подписи токена, полученный в Apple.
        • PlatformCredential — идентификатор ключа подписи (Key ID).
        • ApplePlatformTeamID — идентификатор разработчика (Team ID).
        • ApplePlatformBundleID — идентификатор приложения (Bundle ID).
      • Аутентификация с сертификатом:

        • PlatformPrincipal — SSL-сертификат в формате .pem.

        • PlatformCredential — закрытый ключ сертификата в формате .pem.

          Чтобы сохранить сертификат и закрытый ключ в отдельных файлах формата .pem, вы можете воспользоваться утилитой openssl в Linux:

          openssl pkcs12 -in Certificates.p12 -nokeys -nodes -out certificate.pem
          openssl pkcs12 -in Certificates.p12 -nocerts -nodes -out privatekey.pem
          

      Аутентификация с токеном является предпочтительной, как более современная.

    • FCM: PlatformCredential — ключ сервисного аккаунта Google Cloud в формате JSON для аутентификации с помощью HTTP v1 API или API-ключ (server key) для аутентификации с помощью Legacy API.

      Версия HTTP v1 API является предпочтительной, так как с июня 2024 года Legacy API не будет поддерживаться FCM.

    • HMS:

      • PlatformPrincipal — идентификатор ключа.
      • PlatformCredential — API-ключ.
    • RuStore:

      • PlatformPrincipal — идентификатор проекта (ProjectID).
      • PlatformCredential — сервисный токен (ServiceToken).

В результате вы получите идентификатор (ARN) канала уведомлений.

Получите список каналов уведомленийПолучите список каналов уведомлений

response = client.list_platform_applications()
for app in response["PlatformApplications"]:
    print("Application ARN:", app["PlatformApplicationArn"])

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

Создайте эндпоинтСоздайте эндпоинт

response = client.create_platform_endpoint(
    PlatformApplicationArn="<ARN_канала_уведомлений>",
    Token="<Push-токен>",
)
print ("Endpoint ARN:", response["EndpointArn"])

Где:

  • PlatformApplicationArn — идентификатор (ARN) канала уведомлений.
  • Token — уникальный Push-токен приложения на устройстве пользователя.

В результате вы получите идентификатор (ARN) мобильного эндпоинта.

Отправьте уведомлениеОтправьте уведомление

Явные уведомления (Bright Push)Явные уведомления (Bright Push)

Apple iOS (APNs)
Google Android (FCM)
RuStore Android
response = client.publish(
    TargetArn="<идентификатор_эндпоинта>",
    Message=json.dumps({
        "default": "<текст_уведомления>",
        "APNS": json.dumps({
            "aps": {
                "alert": "<текст_уведомления>"
            }
        })
    }),
    MessageStructure="json"
)
print ("Message id:", response["MessageId"])
response = client.publish(
    TargetArn="<идентификатор_эндпоинта>",
    Message=json.dumps({
        "default": "<текст_уведомления>",
        "GCM": json.dumps({
            "notification": {
                "body": "<текст_уведомления>"
            }
        })
    }),
    MessageStructure="json"
)
print ("Message id:", response["MessageId"])
response = client.publish(
    TargetArn="<идентификатор_эндпоинта>",
    Message=json.dumps({
        "default": "<текст_уведомления_по_умолчанию>",
        "RUSTORE": json.dumps({
            "notification": {
                "title": "<заголовок уведомления>",
                "body": "<текст_уведомления>",
            }
        })
    }),
    MessageStructure="json"
)
message_id = response["MessageId"]
print(f"Message id is: {message_id}")

Где:

  • TargetArn — идентификатор (ARN) мобильного эндпоинта.
  • MessageStructure — формат сообщения.
  • Message — сообщение.

Тихие уведомления (Silent Push)Тихие уведомления (Silent Push)

response = client.publish(
    TargetArn="<endpoint ARN>",
    Message='{"data": { "key": "value" } }')
print ("Message id:", response["MessageId"])

Где:

  • TargetArn — идентификатор (ARN) мобильного эндпоинта.
  • Message — сообщение.

См. такжеСм. также

  • Начало работы
  • AWS CLI
  • Концепции

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

Предыдущая
AWS SDK для PHP
Следующая
Правила тарификации
Проект Яндекса
© 2025 ООО «Яндекс.Облако»