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
  • PublicDashboard
  • create
  • update
  • delete
  • get
  • list
  • stat
  • Message
  • CreatePublicDashboardRequest
  • GetPublicDashboardRequest
  • PublicDashboardInfo
  • PublicDashboardPeriod
  • PublicDashboardQuery
  • PublicDashboardRequest
  • PublicDashboardStatQuery
  • PublicDashboardsInfo
  • UpdatePublicDashboardRequest
  1. content
  2. en
  3. cost_analysis
  4. v1

PublicDashboard

A PublicDashboard is a cost data dashboard provided to all users by default.

Package : spaceone.api.cost_analysis.v1

PublicDashboard

PublicDashboard Methods:

Method
Request
Response

create

Creates a new PublicDashboard. This method is used for creating the default dashboard . Admin type Users can use the method to add a new dashboard with customized widgets.

POST /cost-analysis/v1/public-dashboard/create

{{< tabs " create " >}}

{{< tab "Request Example" >}}

  • name (string) Required

  • domain_id (string) Required

  • default_layout_id (string)

  • custom_layouts (ListValue)

  • default_filter (Struct)

  • period_type (PeriodType)

  • period (PublicDashboardPeriod)

  • tags (Struct)

{{< highlight json >}} { "name": "Untitled Dashboard", "custom_layouts": [ [ { "name": "AWS Data-Transfer Cost Trend", "widget_id": "linegraph-lg-02", "options": { "chart_type": "LINE", "layout": 100.0, "chart_img": "AWS_Data-Transfer_Cost_Trend", "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_DATA_TRANSFER_COST_TREND_DESC" } } ], [ { "name": "AWS Data-Transfer by Region", "widget_id": "map-lg-02", "options": { "chart_type": "MAP", "layout": 100.0, "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_DATA_TRANSFER_BY_REGION_DESC", "chart_img": "AWS_Data-Transfer_By_Region" } } ], [ { "name": "AWS CloudFront Cost by Project", "widget_id": "stackedcol-lg-03", "options": { "group_by": "project_id", "chart_img": "AWS_CloudFront_Cost", "layout": 100.0, "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_CLOUDFRONT_COST_DESC", "chart_type": "STACKED_COLUMN" } } ] ], "default_filter": {}, "period_type": "AUTO" } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

  • public_dashboard_id (string) Required

  • name (string) Required

  • default_layout_id (string) Required

  • custom_layouts (ListValue) Required

  • default_filter (Struct) Required

  • period_type (PeriodType) Required

  • period (PublicDashboardPeriod) Required

  • tags (Struct) Required

  • domain_id (string) Required

  • created_at (string) Required

  • updated_at (string) Required

{{< highlight json >}} { "public_dashboard_id": "pub-dash-80092b5ef658", "name": "Untitled Dashboard", "custom_layouts": [ [ { "options": { "layout": 100.0, "chart_type": "LINE", "chart_img": "AWS_Data-Transfer_Cost_Trend", "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_DATA_TRANSFER_COST_TREND_DESC" }, "widget_id": "linegraph-lg-02", "name": "AWS Data-Transfer Cost Trend" } ], [ { "widget_id": "map-lg-02", "name": "AWS Data-Transfer by Region", "options": { "layout": 100.0, "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_DATA_TRANSFER_BY_REGION_DESC", "chart_img": "AWS_Data-Transfer_By_Region", "chart_type": "MAP" } } ], [ { "options": { "chart_type": "STACKED_COLUMN", "chart_img": "AWS_CloudFront_Cost", "layout": 100.0, "group_by": "project_id", "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_CLOUDFRONT_COST_DESC" }, "name": "AWS CloudFront Cost by Project", "widget_id": "stackedcol-lg-03" } ] ], "default_filter": {}, "period_type": "AUTO", "tags": {}, "domain_id": "domain-58010aa2e451", "created_at": "2022-07-19T05:42:01.412Z", "updated_at": "2022-07-19T05:42:01.412Z" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

update

Updates a specific PublicDashboard. Changes the widgets of the PublicDashboard with default widgets and customized widgets. Only Admin type Users can use the method.

POST /cost-analysis/v1/public-dashboard/update

{{< tabs " update " >}}

{{< tab "Request Example" >}}

  • public_dashboard_id (string) Required

  • domain_id (string) Required

  • name (string)

  • default_layout_id (string)

  • custom_layouts (ListValue)

  • default_filter (Struct)

  • period_type (PeriodType)

  • period (PublicDashboardPeriod)

  • tags (Struct)

{{< highlight json >}} { "public_dashboard_id": "pub-dash-80092b5ef658", "name": "Untitled Dashboard2", "custom_layouts": [ [ { "widget_id": "linegraph-lg-02", "name": "AWS Data-Transfer Cost Trend", "options": { "chart_type": "LINE", "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_DATA_TRANSFER_COST_TREND_DESC", "chart_img": "AWS_Data-Transfer_Cost_Trend", "layout": 100.0 } } ], [ { "name": "AWS Data-Transfer by Region", "widget_id": "map-lg-02", "options": { "chart_type": "MAP", "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_DATA_TRANSFER_BY_REGION_DESC", "layout": 100.0, "chart_img": "AWS_Data-Transfer_By_Region" } } ], [ { "name": "AWS CloudFront Cost by Project", "widget_id": "stackedcol-lg-03", "options": { "layout": 100.0, "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_CLOUDFRONT_COST_DESC", "group_by": "project_id", "chart_type": "STACKED_COLUMN", "chart_img": "AWS_CloudFront_Cost" } } ] ] } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

  • public_dashboard_id (string) Required

  • name (string) Required

  • default_layout_id (string) Required

  • custom_layouts (ListValue) Required

  • default_filter (Struct) Required

  • period_type (PeriodType) Required

  • period (PublicDashboardPeriod) Required

  • tags (Struct) Required

  • domain_id (string) Required

  • created_at (string) Required

  • updated_at (string) Required

{{< highlight json >}} { "public_dashboard_id": "pub-dash-80092b5ef658", "name": "Untitled Dashboard", "custom_layouts": [ [ { "options": { "layout": 100.0, "chart_type": "LINE", "chart_img": "AWS_Data-Transfer_Cost_Trend", "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_DATA_TRANSFER_COST_TREND_DESC" }, "widget_id": "linegraph-lg-02", "name": "AWS Data-Transfer Cost Trend" } ], [ { "widget_id": "map-lg-02", "name": "AWS Data-Transfer by Region", "options": { "layout": 100.0, "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_DATA_TRANSFER_BY_REGION_DESC", "chart_img": "AWS_Data-Transfer_By_Region", "chart_type": "MAP" } } ], [ { "options": { "chart_type": "STACKED_COLUMN", "chart_img": "AWS_CloudFront_Cost", "layout": 100.0, "group_by": "project_id", "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_CLOUDFRONT_COST_DESC" }, "name": "AWS CloudFront Cost by Project", "widget_id": "stackedcol-lg-03" } ] ], "default_filter": {}, "period_type": "AUTO", "tags": {}, "domain_id": "domain-58010aa2e451", "created_at": "2022-07-19T05:42:01.412Z", "updated_at": "2022-07-19T05:42:01.412Z" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

delete

Deletes a specific PublicDashboard. You must specify the public_dashboard_id of the PublicDashboard to delete.

POST /cost-analysis/v1/public-dashboard/delete

{{< tabs " delete " >}}

{{< tab "Request Example" >}}

  • public_dashboard_id (string) Required

  • domain_id (string) Required

{{< highlight json >}} { "public_dashboard_id": "pub-dash-579b38f00dcf" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

get

Gets a specific PublicDashboard. Prints detailed information about the PublicDashboard, including custom_layouts and period_type.

POST /cost-analysis/v1/public-dashboard/get

{{< tabs " get " >}}

{{< tab "Request Example" >}}

  • public_dashboard_id (string) Required

  • domain_id (string) Required

  • only (string) Repeated

{{< highlight json >}} { "public_dashboard_id": "pub-dash-579b38f00dcf" } {{< /highlight >}} {{< /tab >}}

{{< tab "Response Example" >}}

  • public_dashboard_id (string) Required

  • name (string) Required

  • default_layout_id (string) Required

  • custom_layouts (ListValue) Required

  • default_filter (Struct) Required

  • period_type (PeriodType) Required

  • period (PublicDashboardPeriod) Required

  • tags (Struct) Required

  • domain_id (string) Required

  • created_at (string) Required

  • updated_at (string) Required

{{< highlight json >}} { "public_dashboard_id": "pub-dash-80092b5ef658", "name": "Untitled Dashboard", "custom_layouts": [ [ { "options": { "layout": 100.0, "chart_type": "LINE", "chart_img": "AWS_Data-Transfer_Cost_Trend", "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_DATA_TRANSFER_COST_TREND_DESC" }, "widget_id": "linegraph-lg-02", "name": "AWS Data-Transfer Cost Trend" } ], [ { "widget_id": "map-lg-02", "name": "AWS Data-Transfer by Region", "options": { "layout": 100.0, "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_DATA_TRANSFER_BY_REGION_DESC", "chart_img": "AWS_Data-Transfer_By_Region", "chart_type": "MAP" } } ], [ { "options": { "chart_type": "STACKED_COLUMN", "chart_img": "AWS_CloudFront_Cost", "layout": 100.0, "group_by": "project_id", "chart_desc_translation_id": "BILLING.COST_MANAGEMENT.DASHBOARD.CUSTOMIZE.ADD_WIDGET_MODAL.AWS_CLOUDFRONT_COST_DESC" }, "name": "AWS CloudFront Cost by Project", "widget_id": "stackedcol-lg-03" } ] ], "default_filter": {}, "period_type": "AUTO", "tags": {}, "domain_id": "domain-58010aa2e451", "created_at": "2022-07-19T05:42:01.412Z", "updated_at": "2022-07-19T05:42:01.412Z" } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

list

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

POST /cost-analysis/v1/public-dashboard/list

{{< tabs " list " >}}

{{< tab "Request Example" >}}

  • domain_id (string) Required

  • query (Query)

  • public_dashboard_id (string)

  • name (string)

  • period_type (PeriodType)

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

{{< tab "Response Example" >}}

  • results (PublicDashboardInfo) Repeated Required

  • total_count (int32) Required

{{< highlight json >}} { "results": [ { "public_dashboard_id": "pub-dash-579b38f00dcf", "name": "CDN & Traffic Cost", "custom_layouts": [ [ { "widget_id": "linegraph-lg-02", "name": "AWS Data-Transfer Cost Trend", "options": { "chart_type": "LINE", "layout": 100.0 } } ], [ { "name": "AWS CloudFront Cost by Project", "options": { "group_by": "project_id", "chart_type": "STACKED_COLUMN", "layout": 100.0 }, "widget_id": "stackedcol-lg-03" } ], [ { "options": { "layout": 100.0, "chart_type": "MAP" }, "widget_id": "map-lg-02", "name": "AWS Data-Transfer by Region" } ] ], "default_filter": { "project_id": [], "service_account_id": [], "project_group_id": [], "provider": [ "google_cloud", "azure", "aws_china", "aws" ] }, "period_type": "AUTO", "tags": {}, "domain_id": "domain-58010aa2e451", "created_at": "2022-04-07T02:31:28.197Z", "updated_at": "2022-04-07T02:31:28.197Z" }, { "public_dashboard_id": "pub-dash-fc83ed9bc825", "name": "Monthly Cost Summary", "custom_layouts": [ [ { "options": { "layout": 33.0, "chart_type": "CARD" }, "widget_id": "card-sm-01", "name": "Month-to-Date Spend" }, { "name": "Last Month Total Spend", "widget_id": "card-sm-02", "options": { "layout": 33.0, "chart_type": "CARD" } }, { "widget_id": "card-sm-03", "name": "Budget Usage", "options": { "chart_type": "CARD", "layout": 33.0 } } ], [ { "name": "Cost By Project", "widget_id": "treemap-lg-01", "options": { "group_by": "project_id", "layout": 100.0, "chart_type": "TREEMAP" } } ], [ { "name": "Cost Trend By Project", "widget_id": "linegraph-lg-01", "options": { "layout": 100.0, "group_by": "provider", "chart_type": "LINE" } } ], [ { "options": { "layout": 100.0, "chart_type": "STACKED_COLUMN", "group_by": "product" }, "widget_id": "stackedcol-lg-01", "name": "Cost Trend By Product" } ], [ { "name": "Cost By Provider", "options": { "layout": 50.0, "group_by": "provider", "chart_type": "STACKED_COLUMN" }, "widget_id": "donut-md-01" }, { "widget_id": "waffle-md-01", "name": "Budget Status", "options": { "layout": 50.0, "chart_type": "WAFFLE" } } ], [ { "options": { "chart_type": "MAP", "layout": 100.0 }, "widget_id": "map-lg-01", "name": "Cost By Region" } ] ], "default_filter": { "provider": [] }, "period_type": "AUTO", "tags": {}, "domain_id": "domain-58010aa2e451", "created_at": "2022-03-29T05:22:41.283Z", "updated_at": "2022-03-29T05:22:41.283Z" } ], "total_count": 3 } {{< /highlight >}} {{< /tab >}}

{{< /tabs >}}

stat

POST /cost-analysis/v1/public-dashboard/stat

Message

CreatePublicDashboardRequest

  • name (string) Required

  • domain_id (string) Required

  • default_layout_id (string)

  • custom_layouts (ListValue)

  • default_filter (Struct)

  • period_type (PeriodType)

  • period (PublicDashboardPeriod)

  • tags (Struct)

GetPublicDashboardRequest

  • public_dashboard_id (string) Required

  • domain_id (string) Required

  • only (string) Repeated

PublicDashboardInfo

  • public_dashboard_id (string) Required

  • name (string) Required

  • default_layout_id (string) Required

  • custom_layouts (ListValue) Required

  • default_filter (Struct) Required

  • period_type (PeriodType) Required

  • period (PublicDashboardPeriod) Required

  • tags (Struct) Required

  • domain_id (string) Required

  • created_at (string) Required

  • updated_at (string) Required

PublicDashboardPeriod

  • start (string) Required

  • end (string) Required

PublicDashboardQuery

  • domain_id (string) Required

  • query (Query)

  • public_dashboard_id (string)

  • name (string)

  • period_type (PeriodType)

PublicDashboardRequest

  • public_dashboard_id (string) Required

  • domain_id (string) Required

PublicDashboardStatQuery

  • query (StatisticsQuery) Required

  • domain_id (string) Required

PublicDashboardsInfo

  • results (PublicDashboardInfo) Repeated Required

  • total_count (int32) Required

UpdatePublicDashboardRequest

  • public_dashboard_id (string) Required

  • domain_id (string) Required

  • name (string)

  • default_layout_id (string)

  • custom_layouts (ListValue)

  • default_filter (Struct)

  • period_type (PeriodType)

  • period (PublicDashboardPeriod)

  • tags (Struct)

PreviousJobTaskNextSchedule

Last updated 1 year ago

CreatePublicDashboardRequest
UpdatePublicDashboardRequest
PublicDashboardRequest
GetPublicDashboardRequest
PublicDashboardQuery
PublicDashboardInfo
PublicDashboardInfo
PublicDashboardInfo
PublicDashboardsInfo
create
CreatePublicDashboardRequest
PublicDashboardInfo
update
UpdatePublicDashboardRequest
PublicDashboardInfo
delete
PublicDashboardRequest
Empty
get
GetPublicDashboardRequest
PublicDashboardInfo
list
PublicDashboardQuery
PublicDashboardsInfo
stat
PublicDashboardStatQuery
Struct