SpaceONE APIs
Latest Version
Latest Version
  • README
  • Board
    • V1
      • Board
      • Post
  • Config
    • V1
      • Domain Config
      • User Config
  • Core
    • V1
      • Handler
      • Query
      • Server Info
  • Cost Analysis
    • Plugin
      • Cost
      • Data Source
      • Job
    • V1
      • Budget
      • Budget Usage
      • Cost
      • Cost Query Set
      • Custom Widget
      • Data Source
      • Data Source Rule
      • Exchange Rate
      • Job
      • Job Task
      • Public Dashboard
      • Schedule
      • User Dashboard
  • Identity
    • Plugin
      • Auth
    • V1
      • Api Key
      • Authorization
      • Domain
      • Domain Owner
      • Endpoint
      • Policy
      • Project
      • Project Group
      • Provider
      • Role
      • Role Binding
      • Service Account
      • Token
      • User
  • Inventory
    • Plugin
      • Collector
    • V1
      • Change History
      • Cloud Service
      • Cloud Service Type
      • Collector
      • Job
      • Job Task
      • Note
      • Region
      • Resource Group
      • Server
  • Monitoring
    • Plugin
      • Data Source
      • Event
      • Log
      • Metric
      • Webhook
    • V1
      • Alert
      • Data Source
      • Escalation Policy
      • Event
      • Event Rule
      • Log
      • Maintenance Window
      • Metric
      • Note
      • Project Alert Config
      • Webhook
  • Notification
    • Plugin
      • Notification
      • Protocol
    • V1
      • Notification
      • Notification Usage
      • Project Channel
      • Protocol
      • Quota
      • User Channel
  • Plugin
    • V1
      • Plugin
      • Supervisor
  • Repository
    • V1
      • Plugin
      • Policy
      • Repository
      • Schema
  • Sample
    • V1
      • Helloworld
  • Secret
    • V1
      • Secret
      • Secret Group
  • Statistics
    • Plugin
      • Storage
    • V1
      • History
      • Resource
      • Schedule
      • Storage
Powered by GitBook
On this page
  1. Notification
  2. V1

User Channel

PreviousQuotaNextPlugin

Last updated 3 years ago

Was this helpful?

CtrlK
  • UserChannel
  • create
  • update
  • set_schedule
  • set_subscription
  • enable
  • disable
  • delete
  • get
  • list
  • stat
  • Message
  • CreateUserChannelRequest
  • GetUserChannelRequest
  • UpdateUserChannelRequest
  • UpdateUserChannelScheduleRequest
  • UpdateUserChannelSubscriptionRequest
  • UserChannelInfo
  • UserChannelQuery
  • UserChannelRequest
  • UserChannelSchedule
  • UserChannelStatQuery
  • UserChannelsInfo

Was this helpful?

Package : spaceone.api.notification.v1

UserChannel

UserChannel Methods:

Method
Request
Response

create

POST /notification/v1/user-channels

Creates a new User Channel.User channel is the definition of the channel that delivers the notification to users when the notification is created.When creating a User Channel, one of the protocols must be selected, and an notification is dispatched through the selected protocol.

Type
Message

Request

Response

update

PUT /notification/v1/user-channel/{user_channel_id}

Updates a User Channel information.Protocol that has already been set cannot be changed. Instead, the data required to be dispatched notification for user channel is can be updated.

Type
Message

Request

Response

set_schedule

PUT /notification/v1/user-channel/{user_channel_id}/schedule

Schedule settings for user channels.When a notification is created, you can set the day and time you want to receive it through the schedule.When you set the day of the week in the schedule, you can receive a notification only on the set day of the week.If you also set the start time and end time with day of the week, you can receive a notification only at the set time on the set day of the week.If there is no schedule, notifications will be dispatched at all times through user channel.

Type
Message

Request

Response

set_subscription

PUT /notification/v1/user-channel/{user_channel_id}/subscription

Subscription settings for user channelsIf the user channel have subscriptions, notification is dispatched only if the topic of the notification is the same as the one set in the subscriptions.If no subscriptions in user channel, notifications will be dispatched all.

Type
Message

Request

Response

enable

PUT /notification/v1/user-channel/{user_channel_id}/enable

Enables a User Channel.If the disabled user channel is enabled, the user channel can be used again and the notification can be dispatched.Even if the user channel is enabled, if the protocol being used in the user channel is disabled, the notification is not dispatched.

Type
Message

Request

Response

disable

PUT /notification/v1/user-channel/{user_channel_id}/disable

Disables a User Channel.If you disable the user channel, the notification will not be dispatched, even if they are created.

Type
Message

Request

Response

delete

DELETE /notification/v1/user-channel/{user_channel_id}

Delete the User Channel.

Type
Message

Request

Response

get

GET /notification/v1/user-channel/{user_channel_id}

Gets a single User Channel.

Type
Message

Request

Response

list

GET /notification/v1/user-channels

POST /notification/v1/user-channels/search

Lists the specified User Channel.Can search information using the query format provided by SpaceONE.Detailed information about Query format can be checked in the Search Query pages.

Type
Message

Request

Response

stat

POST /notification/v1/user-channels/stat

Type
Message

Request

Response

Message

CreateUserChannelRequest

Field
Type
Required
Description

protocol_id

string

✔

The ID of protocol that will be set in user channel.

name

string

✔

The name of User Channel. It can have a maximum of 255 characters.

data

GetUserChannelRequest

Field
Type
Required
Description

user_channel_id

string

✔

The ID of user channel.

domain_id

string

✔

The ID of domain.

only

UpdateUserChannelRequest

Field
Type
Required
Description

user_channel_id

string

✔

The ID of user channel.

name

string

✘

The name of user channel. It can have a maximum of 255 characters.

data

UpdateUserChannelScheduleRequest

Field
Type
Required
Description

user_channel_id

string

✔

The ID of user channel.

is_scheduled

bool

✔

Indicates whether schedule will be used.

schedule

UpdateUserChannelSubscriptionRequest

Field
Type
Required
Description

user_channel_id

string

✔

The ID of user channel.

is_subscribe

bool

✔

Indicates whether subscriptions will be used.

subscriptions

UserChannelInfo

Field
Type
Description

user_channel_id

string

The ID of user channel.

name

string

The name of user channel

state

  • NONE

  • ENABLED

  • DISABLED

The state of user channel. ENABLED or DISABLED only.

UserChannelQuery

Field
Type
Required
Description

query

✘

Query format provided by SpaceONE. Please check the link for more information.

user_channel_id

string

✘

The ID of user channel.

name

UserChannelRequest

Field
Type
Required
Description

user_channel_id

string

✔

The ID of user channel.

domain_id

string

✔

The ID of domain.

UserChannelSchedule

Field
Type
Description

day_of_week

  • NONE

  • MON

  • TUE

  • WED

Day of the week to be notified.As a list type, only types that can be specified from MON to SUN can be set.

start_hour

Start time to receive notifications.Only integer type can be set, and 0 to 23 can be.

end_hour

End time to receive notifications.Only integer type can be set, and 1 to 24 can be.

UserChannelStatQuery

Field
Type
Required
Description

query

✔

Statistics Query format provided by SpaceONE. Please check the link for more information.

domain_id

string

✔

The ID of domain.

UserChannelsInfo

Field
Type
Description

results

List of queried user channels.

total_count

Total counts of queried user channels.

THU

  • FRI

  • SAT

  • SUN

  • UserChannelInfo

    disable

    UserChannelRequest

    UserChannelInfo

    delete

    UserChannelRequest

    google.protobuf.Empty

    get

    GetUserChannelRequest

    UserChannelInfo

    list

    UserChannelQuery

    UserChannelsInfo

    stat

    UserChannelStatQuery

    google.protobuf.Struct

    google.protobuf.Struct

    ✔

    The data for using user channel.This data is encrypted and stored in the Secret service if JSON schema in the protocol's metadata is set to SECRET type.In this case, the secret ID that is stored in the security service will be returned and the data value will be empty.if JSON schema in the protocol's metadata is set to PLAIN_TEXT type, This data is not encrypted and stored directly in the DB.

    is_subscribe

    bool

    ✘

    Indicates whether subscriptions will be used.

    subscriptions

    list of string

    ✔

    When using subscriptions, it indicates the topic list to subscription.If is_subscribe is set to false, this value is ignored.

    is_scheduled

    bool

    ✘

    Indicates whether schedule will be used.

    schedule

    UserChannelSchedule

    ✘

    Schedule for which you want to receive notifications through the user channel.

    tags

    google.protobuf.Struct

    ✘

    The tags for user channel.

    user_id

    string

    ✔

    The ID of user

    domain_id

    string

    ✔

    The ID of domain.

    list of string

    ✘

    The list of the user channel information column you want to be returned. It must be specified in the UserChannelInfo.

    google.protobuf.Struct

    ✔

    The data for using user channel.This data is encrypted and stored in the Secret service if JSON schema in the protocol's metadata is set to SECRET type.In this case, the secret ID that is stored in the security service will be returned and the data value will be empty.if JSON schema in the protocol's metadata is set to PLAIN_TEXT type, This data is not encrypted and stored directly in the DB.

    schedule

    UserChannelSchedule

    ✔

    Set the level of notification.If a notification has a level and a notification level that this channel can receive is set, a notification is dispatched only if the notification level is the same.

    tags

    google.protobuf.Struct

    ✘

    The tags for user channel.

    domain_id

    string

    ✔

    The ID of domain.

    UserChannelSchedule

    ✘

    Schedule for which you want to receive notifications through the user channel.

    domain_id

    string

    ✔

    The ID of domain.

    list of string

    ✔

    domain_id

    string

    ✔

    The ID of domain.

    data

    google.protobuf.Struct

    The data for using user channel.

    secret_id

    string

    The ID of secret encrypted data in the security service

    is_subscribe

    bool

    Indicates whether subscriptions will be used.

    subscriptions

    list of string

    The topic list to subscription.

    is_scheduled

    bool

    Indicates whether schedule will be used.

    schedule

    UserChannelSchedule

    Schedule for which you want to receive notifications through the user channel.

    tags

    google.protobuf.Struct

    The tags for user channel.

    protocol_id

    string

    The ID of protocol set in the user channel.

    user_id

    string

    The ID of user using the user channel.

    domain_id

    string

    The ID of domain.

    created_at

    string

    User channel creation time.

    string

    ✘

    The name of user channel. It can have a maximum of 255 characters.

    state

    • NONE

    • ENABLED

    • DISABLED

    ✘

    The state of user channel. ENABLED or DISABLED only.

    secret_id

    string

    ✔

    protocol_id

    string

    ✘

    The ID of protocol set in the user channel.

    user_id

    string

    ✘

    The ID of user using the user channel.

    domain_id

    string

    ✔

    The ID of domain.

    create
    CreateUserChannelRequest
    UserChannelInfo
    update
    UpdateUserChannelRequest
    UserChannelInfo
    set_schedule
    UpdateUserChannelScheduleRequest
    UserChannelInfo
    set_subscription
    UpdateUserChannelSubscriptionRequest
    UserChannelInfo
    enable
    UserChannelRequest
    CreateUserChannelRequest
    UserChannelInfo
    UpdateUserChannelRequest
    UserChannelInfo
    UpdateUserChannelScheduleRequest
    UserChannelInfo
    UpdateUserChannelSubscriptionRequest
    UserChannelInfo
    UserChannelRequest
    UserChannelInfo
    UserChannelRequest
    UserChannelInfo
    UserChannelRequest
    google.protobuf.Empty
    GetUserChannelRequest
    UserChannelInfo
    UserChannelQuery
    UserChannelsInfo
    UserChannelStatQuery
    google.protobuf.Struct
    spaceone.api.core.v1.Query
    int32
    int32
    spaceone.api.core.v1.StatisticsQuery
    list of UserChannelInfo
    int32