cloudforet-apis
  • README
  • content
    • en
      • Cloudforet API Documentation
      • board
        • _index
        • v1
          • Board
          • Post
          • v1
      • config
        • _index
        • v1
          • DomainConfig
          • PublicConfig
          • UserConfig
          • WorkspaceConfig
          • v1
      • core
        • _index
        • v1
          • Handler
          • Query
          • ServerInfo
          • v1
        • v2
          • Handler
          • Plugin
          • Query
          • v2
      • cost_analysis
        • _index
        • plugin
          • Cost
          • DataSource
          • Job
          • plugin
        • v1
          • Budget
          • BudgetUsage
          • Cost
          • CostQuerySet
          • CostReport
          • CostReportConfig
          • CostReportData
          • CustomWidget
          • DataSource
          • DataSourceAccount
          • DataSourceRule
          • ExchangeRate
          • Job
          • JobTask
          • PublicDashboard
          • Schedule
          • UnifiedCost
          • UserDashboard
          • v1
      • dashboard
        • _index
        • v1
          • CustomWidget
          • Dashboard
          • DomainDashboard
          • PrivateDashboard
          • PrivateDataTable
          • PrivateFolder
          • PrivateWidget
          • ProjectDashboard
          • PublicDashboard
          • PublicDataTable
          • PublicFolder
          • PublicWidget
          • v1
      • file_manager
        • _index
        • v1
          • File
          • PublicFile
          • v1
      • identity
        • _index
        • plugin
          • AccountCollector
          • Auth
          • ExternalAuth
          • plugin
        • v1
          • ApiKey
          • Authorization
          • Domain
          • DomainOwner
          • Endpoint
          • Policy
          • Project
          • ProjectGroup
          • Provider
          • Role
          • RoleBinding
          • ServiceAccount
          • Token
          • User
          • v1
        • v2
          • Agent
          • ApiKey
          • App
          • Authorization
          • Domain
          • Endpoint
          • ExternalAuth
          • Job
          • Package
          • Policy
          • Project
          • ProjectGroup
          • Provider
          • Role
          • RoleBinding
          • Schema
          • ServiceAccount
          • System
          • Token
          • TrustedAccount
          • TrustedServiceAccount
          • User
          • UserGroup
          • UserProfile
          • Workspace
          • WorkspaceGroup
          • WorkspaceGroupDetails
          • WorkspaceGroupUser
          • WorkspaceUser
          • v2
      • inventory
        • _index
        • plugin
          • Collector
          • Job
          • plugin
        • v1
          • ChangeHistory
          • CloudService
          • CloudServiceQuerySet
          • CloudServiceReport
          • CloudServiceStats
          • CloudServiceType
          • Collector
          • CollectorRule
          • Job
          • JobTask
          • Metric
          • MetricData
          • MetricExample
          • Namespace
          • Note
          • Region
          • ResourceGroup
          • v1
        • v2
          • Region
          • v2
      • monitoring
        • _index
        • plugin
          • DataSource
          • Event
          • Log
          • Metric
          • Webhook
          • plugin
        • v1
          • Alert
          • DataSource
          • EscalationPolicy
          • Event
          • EventRule
          • Log
          • MaintenanceWindow
          • Metric
          • Note
          • ProjectAlertConfig
          • Webhook
          • v1
      • mzc_service_api
        • _index
        • v1
          • Contract
          • Offering
          • Organization
          • v1
      • notification
        • _index
        • plugin
          • Notification
          • Protocol
          • plugin
        • v1
          • Notification
          • NotificationUsage
          • ProjectChannel
          • Protocol
          • Quota
          • UserChannel
          • v1
      • opsflow
        • _index
        • v1
          • Comment
          • Event
          • Task
          • TaskCategory
          • TaskType
          • v1
      • plugin
        • _index
        • v1
          • Plugin
          • Supervisor
          • v1
      • repository
        • _index
        • v1
          • DashboardTemplate
          • Plugin
          • Policy
          • Repository
          • Schema
          • v1
        • v2
          • Common
          • Provider
          • RemoteRepository
          • Schema
          • v2
      • sample
        • _index
        • v1
          • Helloworld
          • v1
      • search
        • _index
        • v1
          • Resource
          • v1
      • secret
        • _index
        • v1
          • Secret
          • SecretGroup
          • TrustedSecret
          • UserSecret
          • v1
      • statistics
        • _index
        • plugin
          • Storage
          • plugin
        • v1
          • History
          • Resource
          • Schedule
          • Storage
          • v1
Powered by GitBook
On this page
  • Quota
  • create
  • update
  • delete
  • get
  • list
  • stat
  • Message
  • CreateQuotaRequest
  • QuotaInfo
  • QuotaQuery
  • QuotaRequest
  • QuotaStatQuery
  • QuotasInfo
  • UpdateQuotaRequest
  1. content
  2. en
  3. notification
  4. v1

Quota

A Quota is a limit on protocol usage for a day or a month. You can manage the use of the protocol with a Quota.

Package : spaceone.api.notification.v1

Quota

Quota Methods:

Method
Request
Response

create

Creates a new Quota limiting the use of a selected Protocol for a day or a month. If the parameter limit has no value, it will be deemed unlimited. If a Protocol has not set a Quota, the default Quota set in the Config will be applied.

POST /notification/v1/quota/create

{{< tabs " create " >}}

{{< tab "Request Example" >}}

  • protocol_id (string) Required

  • limit (Struct) Required

    The information about Quota limitation.

  • domain_id (string) Required

    The ID of domain.

{{< highlight json >}} { "protocol_id": "protocol-123456789012", "limit": { "day": 5.0, "month": 7.0 } } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

  • quota_id (string) Required

    The ID of Quota.

  • protocol_id (string) Required

    The ID of Protocol.

  • limit (Struct) Required

    The information about Quota limitation.

  • domain_id (string) Required

    The ID of domain

{{< highlight json >}} { "quota_id": "quota-123456789012", "protocol_id": "protocol-123456789012", "limit": { "day": 5.0, "month": 7.0 }, "domain_id": "domain-123456789012" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

update

Updates a specific Quota. You can make changes in Quota limit, managing the use of the Protocol.

POST /notification/v1/quota/update

{{< tabs " update " >}}

{{< tab "Request Example" >}}

  • quota_id (string) Required

    The ID of Quota.

  • limit (Struct) Required

    The information about Quota limitation.

  • domain_id (string) Required

{{< highlight json >}} { "quota_id": "quota-123456789012", "limit": { "day": 10.0, "month": 15.0 } } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

  • quota_id (string) Required

    The ID of Quota.

  • protocol_id (string) Required

    The ID of Protocol.

  • limit (Struct) Required

    The information about Quota limitation.

  • domain_id (string) Required

    The ID of domain

{{< highlight json >}} { "quota_id": "quota-123456789012", "protocol_id": "protocol-123456789012", "limit": { "day": 5.0, "month": 7.0 }, "domain_id": "domain-123456789012" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

delete

Deletes a specific Quota. The default Quota set in the Config will be applied to the Protocol you deleted the Quota of.

POST /notification/v1/quota/delete

{{< tabs " delete " >}}

{{< tab "Request Example" >}}

  • quota_id (string) Required

    The ID of Quota.

  • domain_id (string) Required

    The ID of domain.

{{< highlight json >}} { "quota_id": "quota-123456789012" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

get

Gets a specific Quota. Prints detailed information about the Quota, including the limit and the Protocol limited by the Quota.

POST /notification/v1/quota/get

{{< tabs " get " >}}

{{< tab "Request Example" >}}

  • quota_id (string) Required

    The ID of Quota.

  • domain_id (string) Required

    The ID of domain.

{{< highlight json >}} { "quota_id": "quota-123456789012" } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

  • quota_id (string) Required

    The ID of Quota.

  • protocol_id (string) Required

    The ID of Protocol.

  • limit (Struct) Required

    The information about Quota limitation.

  • domain_id (string) Required

    The ID of domain

{{< highlight json >}} { "quota_id": "quota-123456789012", "protocol_id": "protocol-123456789012", "limit": { "day": 5.0, "month": 7.0 }, "domain_id": "domain-123456789012" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

list

Gets a list of all Quotas. You can use a query to get a filtered list of Quotas.

POST /notification/v1/quota/list

{{< tabs " list " >}}

{{< tab "Request Example" >}}

  • domain_id (string) Required

    The ID of domain.

  • query (Query)

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

  • quota_id (string)

    The ID of Quota.

  • protocol_id (string)

    The ID of Protocol.

{{< highlight json >}} { "query": {} } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

  • results (QuotaInfo) Repeated Required

    List of queried Quota.

  • total_count (int32) Required

    Total counts of queried Quota.

{{< highlight json >}} { "results": [ { "quota_id": "quota-123456789012", "protocol_id": "protocol-123456789012", "limit": { "day": 10.0, "month": 15.0 }, "domain_id": "domain-123456789012" }, { "quota_id": "quota-987654321098", "protocol_id": "protocol-987654321098", "limit": { "day": 5.0, "month": 7.0 }, "domain_id": "domain-123456789012" } ], "total_count": 2 } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

stat

POST /notification/v1/quota/stat

Message

CreateQuotaRequest

  • protocol_id (string) Required

  • limit (Struct) Required

    The information about Quota limitation.

  • domain_id (string) Required

    The ID of domain.

QuotaInfo

  • quota_id (string) Required

    The ID of Quota.

  • protocol_id (string) Required

    The ID of Protocol.

  • limit (Struct) Required

    The information about Quota limitation.

  • domain_id (string) Required

    The ID of domain

QuotaQuery

  • domain_id (string) Required

    The ID of domain.

  • query (Query)

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

  • quota_id (string)

    The ID of Quota.

  • protocol_id (string)

    The ID of Protocol.

QuotaRequest

  • quota_id (string) Required

    The ID of Quota.

  • domain_id (string) Required

    The ID of domain.

QuotaStatQuery

  • query (StatisticsQuery) Required

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

  • domain_id (string) Required

    The ID of domain.

QuotasInfo

  • results (QuotaInfo) Repeated Required

    List of queried Quota.

  • total_count (int32) Required

    Total counts of queried Quota.

UpdateQuotaRequest

  • quota_id (string) Required

    The ID of Quota.

  • limit (Struct) Required

    The information about Quota limitation.

  • domain_id (string) Required

PreviousProtocolNextUserChannel

Last updated 1 year ago

CreateQuotaRequest
UpdateQuotaRequest
QuotaRequest
QuotaRequest
QuotaQuery
QuotaInfo
QuotaInfo
QuotaInfo
QuotasInfo
create
CreateQuotaRequest
QuotaInfo
update
UpdateQuotaRequest
QuotaInfo
delete
QuotaRequest
Empty
get
QuotaRequest
QuotaInfo
list
QuotaQuery
QuotasInfo
stat
QuotaStatQuery
Struct