NSX-T Data Center REST API

ContainerConfiguration (schema)

Container that holds widgets

Represents a container to group widgets that belong to a common category or have a common purpose.

Name Description Type Notes
_create_time Timestamp of resource creation EpochMsTimestamp Readonly
Sortable
_create_user ID of the user who created this resource string Readonly
_last_modified_time Timestamp of last modification EpochMsTimestamp Readonly
Sortable
_last_modified_user ID of the user who last modified this resource string Readonly
_links References related to this resource

The server will populate this field when returing the resource. Ignored on PUT and POST.
array of ResourceLink Readonly
_protection Indicates protection status of this resource

Protection status is one of the following:
PROTECTED - the client who retrieved the entity is not allowed
to modify it.
NOT_PROTECTED - the client who retrieved the entity is allowed
to modify it
REQUIRE_OVERRIDE - the client who retrieved the entity is a super
user and can modify it, but only when providing
the request header X-Allow-Overwrite=true.
UNKNOWN - the _protection field could not be determined for this
entity.
string Readonly
_revision Generation of this resource config

The _revision property describes the current revision of the resource. To prevent clients from overwriting each other's changes, PUT operations must include the current _revision of the resource, which clients should obtain by issuing a GET operation. If the _revision provided in a PUT request is missing or stale, the operation will be rejected.
int
_schema Schema for this resource string Readonly
_self Link to this resource SelfResourceLink Readonly
_system_owned Indicates system owned resource boolean Readonly
condition Expression for evaluating condition

If the condition is met then the widget will be displayed to UI. If no condition is provided, then the widget will be displayed unconditionally.
string Maximum length: 1024
datasources Array of Datasource Instances with their relative urls

The 'datasources' represent the sources from which data will be fetched. Currently, only NSX-API is supported as a 'default' datasource. An example of specifying 'default' datasource along with the urls to fetch data from is given at 'example_request' section of 'CreateWidgetConfiguration' API.
array of Datasource Minimum items: 0
default_filter_value Default filter value to be passed to datasources

Default filter values to be passed to datasources. This will be used when the report is requested without filter values.
array of DefaultFilterValue
description Description of this resource string Maximum length: 1024
Sortable
display_name Widget Title

Title of the widget. If display_name is omitted, the widget will be shown without a title.
string Maximum length: 255
drilldown_id Id of drilldown widget

Id of drilldown widget, if any. Id should be a valid id of an existing widget. A widget is considered as drilldown widget when it is associated with any other widget and provides more detailed information about any data item from the parent widget.
string Maximum length: 255
feature_set Features required to view the widget

Features required to view the widget.
FeatureSet
filter Id of filter widget for subscription

Id of filter widget for subscription, if any. Id should be a valid id of an existing filter widget. Filter widget should be from the same view. Datasource URLs should have placeholder values equal to filter alias to accept the filter value on filter change. This field is deprecated instead use 'filters' property.
string Deprecated
filter_value_required Flag to indicate if filter value is necessary

Flag to indicate that widget will continue to work without filter value. If this flag is set to false then default_filter_value is manadatory.
boolean Default: "True"
filters A List of filter ids applied to this widget configuration

A List of filter applied to this widget configuration. This will be used to identify the filters applied to this widget.
array of string
footer Footer
header Header
icons Icons

Icons to be applied at dashboard for widgets and UI elements.
array of Icon
id Unique identifier of this resource string Sortable
is_drilldown Set as a drilldown widget

Set to true if this widget should be used as a drilldown.
boolean Default: "False"
labels Labels

Labels for the container.
array of Label Minimum items: 0
layout Layout of widgets inside container

Layout of widgets can be either vertical or horizontal. If layout is not specified a default horizontal layout is applied. This property is deprecated. Now the layout inside the container can be taken care with the help of 'rowspan' and 'colspan' property.
Layout Deprecated
legend Legend for the widget

Legend to be displayed. If legend is not needed, do not include it.
Legend
navigation Navigation to a specified UI page

Hyperlink of the specified UI page that provides details.
string Maximum length: 1024
plot_configs List of plotting configuration for a given widget.

List of plotting configuration for a given widget. Widget plotting configurations which are common across all the widgets types should be define here.
array of WidgetPlotConfiguration
resource_type Must be set to the value ContainerConfiguration string Required
Readonly
Enum: LabelValueConfiguration, DonutConfiguration, MultiWidgetConfiguration, ContainerConfiguration, StatsConfiguration, GridConfiguration, GraphConfiguration, CustomWidgetConfiguration, CustomFilterWidgetConfiguration, TimeRangeDropdownFilterWidgetConfiguration, DropdownFilterWidgetConfiguration, SpacerWidgetConfiguration, LegendWidgetConfiguration
Maximum length: 255
rowspan Vertical span

Represents the vertical span of the widget / container. 1 Row span is equal to 20px.
int Minimum: 1
shared Visiblity of widgets to other users

Please use the property 'shared' of View instead of this. The widgets of a shared view are visible to other users.
boolean Deprecated
show_header This decides to show the container header or not.

If the value of this field is set to true then card header will be displayed otherwise only card will be displayed without header.
boolean
span Horizontal span

Represents the horizontal span of the widget / container.
int Minimum: 1
Maximum: 12
tags Opaque identifiers meaningful to the API user array of Tag Maximum items: 30
weight Weightage or placement of the widget or container

Specify relavite weight in WidgetItem for placement in a view. Please see WidgetItem for details.
int Deprecated
widgets Widgets held by the container

If not specified, creates an empty container.
array of WidgetItem Minimum items: 0