/AWS1/CL_GRFWORKSPACEDESC¶
A structure containing information about an Amazon Managed Grafana workspace in your account.
CONSTRUCTOR¶
IMPORTING¶
Required arguments:¶
iv_created TYPE /AWS1/GRFTIMESTAMP /AWS1/GRFTIMESTAMP¶
The date that the workspace was created.
it_datasources TYPE /AWS1/CL_GRFDATASRCTYPESLIST_W=>TT_DATASOURCETYPESLIST TT_DATASOURCETYPESLIST¶
Specifies the Amazon Web Services data sources that have been configured to have IAM roles and permissions created to allow Amazon Managed Grafana to read data from these sources.
This list is only used when the workspace was created through the Amazon Web Services console, and the
permissionTypeisSERVICE_MANAGED.
iv_endpoint TYPE /AWS1/GRFENDPOINT /AWS1/GRFENDPOINT¶
The URL that users can use to access the Grafana console in the workspace.
iv_grafanaversion TYPE /AWS1/GRFGRAFANAVERSION /AWS1/GRFGRAFANAVERSION¶
The version of Grafana supported in this workspace.
iv_id TYPE /AWS1/GRFWORKSPACEID /AWS1/GRFWORKSPACEID¶
The unique ID of this workspace.
iv_modified TYPE /AWS1/GRFTIMESTAMP /AWS1/GRFTIMESTAMP¶
The most recent date that the workspace was modified.
iv_status TYPE /AWS1/GRFWORKSPACESTATUS /AWS1/GRFWORKSPACESTATUS¶
The current status of the workspace.
io_authentication TYPE REF TO /AWS1/CL_GRFAUTHNTCTNSUMMARY /AWS1/CL_GRFAUTHNTCTNSUMMARY¶
A structure that describes whether the workspace uses SAML, IAM Identity Center, or both methods for user authentication.
Optional arguments:¶
iv_accountaccesstype TYPE /AWS1/GRFACCOUNTACCESSTYPE /AWS1/GRFACCOUNTACCESSTYPE¶
Specifies whether the workspace can access Amazon Web Services resources in this Amazon Web Services account only, or whether it can also access Amazon Web Services resources in other accounts in the same organization. If this is
ORGANIZATION, theworkspaceOrganizationalUnitsparameter specifies which organizational units the workspace can access.
iv_description TYPE /AWS1/GRFDESCRIPTION /AWS1/GRFDESCRIPTION¶
The user-defined description of the workspace.
iv_name TYPE /AWS1/GRFWORKSPACENAME /AWS1/GRFWORKSPACENAME¶
The name of the workspace.
iv_organizationrolename TYPE /AWS1/GRFORGANIZATIONROLENAME /AWS1/GRFORGANIZATIONROLENAME¶
The name of the IAM role that is used to access resources through Organizations.
it_notificationdestinations TYPE /AWS1/CL_GRFNOTIFDSTSLIST_W=>TT_NOTIFDESTINATIONSLIST TT_NOTIFDESTINATIONSLIST¶
The Amazon Web Services notification channels that Amazon Managed Grafana can automatically create IAM roles and permissions for, to allow Amazon Managed Grafana to use these channels.
it_organizationalunits TYPE /AWS1/CL_GRFORGALUNITLIST_W=>TT_ORGANIZATIONALUNITLIST TT_ORGANIZATIONALUNITLIST¶
Specifies the organizational units that this workspace is allowed to use data sources from, if this workspace is in an account that is part of an organization.
iv_permissiontype TYPE /AWS1/GRFPERMISSIONTYPE /AWS1/GRFPERMISSIONTYPE¶
If this is
SERVICE_MANAGED, and the workplace was created through the Amazon Managed Grafana console, then Amazon Managed Grafana automatically creates the IAM roles and provisions the permissions that the workspace needs to use Amazon Web Services data sources and notification channels.If this is
CUSTOMER_MANAGED, you must manage those roles and permissions yourself.If you are working with a workspace in a member account of an organization and that account is not a delegated administrator account, and you want the workspace to access data sources in other Amazon Web Services accounts in the organization, this parameter must be set to
CUSTOMER_MANAGED.For more information about converting between customer and service managed, see Managing permissions for data sources and notification channels. For more information about the roles and permissions that must be managed for customer managed workspaces, see Amazon Managed Grafana permissions and policies for Amazon Web Services data sources and notification channels
iv_stacksetname TYPE /AWS1/GRFSTACKSETNAME /AWS1/GRFSTACKSETNAME¶
The name of the CloudFormation stack set that is used to generate IAM roles to be used for this workspace.
iv_workspacerolearn TYPE /AWS1/GRFIAMROLEARN /AWS1/GRFIAMROLEARN¶
The IAM role that grants permissions to the Amazon Web Services resources that the workspace will view data from. This role must already exist.
iv_licensetype TYPE /AWS1/GRFLICENSETYPE /AWS1/GRFLICENSETYPE¶
Specifies whether this workspace has a full Grafana Enterprise license.
Amazon Managed Grafana workspaces no longer support Grafana Enterprise free trials.
iv_freetrialconsumed TYPE /AWS1/GRFBOOLEAN /AWS1/GRFBOOLEAN¶
Specifies whether this workspace has already fully used its free trial for Grafana Enterprise.
Amazon Managed Grafana workspaces no longer support Grafana Enterprise free trials.
iv_licenseexpiration TYPE /AWS1/GRFTIMESTAMP /AWS1/GRFTIMESTAMP¶
If this workspace has a full Grafana Enterprise license purchased through Amazon Web Services Marketplace, this specifies when the license ends and will need to be renewed. Purchasing the Enterprise plugins option through Amazon Managed Grafana does not have an expiration. It is valid until the license is removed.
iv_freetrialexpiration TYPE /AWS1/GRFTIMESTAMP /AWS1/GRFTIMESTAMP¶
If this workspace is currently in the free trial period for Grafana Enterprise, this value specifies when that free trial ends.
Amazon Managed Grafana workspaces no longer support Grafana Enterprise free trials.
it_tags TYPE /AWS1/CL_GRFTAGMAP_W=>TT_TAGMAP TT_TAGMAP¶
The list of tags associated with the workspace.
io_vpcconfiguration TYPE REF TO /AWS1/CL_GRFVPCCONFIGURATION /AWS1/CL_GRFVPCCONFIGURATION¶
The configuration for connecting to data sources in a private VPC (Amazon Virtual Private Cloud).
io_networkaccesscontrol TYPE REF TO /AWS1/CL_GRFNETWORKACCESSCONF /AWS1/CL_GRFNETWORKACCESSCONF¶
The configuration settings for network access to your workspace.
iv_grafanatoken TYPE /AWS1/GRFGRAFANATOKEN /AWS1/GRFGRAFANATOKEN¶
The token that ties this workspace to a Grafana Labs account. For more information, see Link your account with Grafana Labs.
Queryable Attributes¶
accountAccessType¶
Specifies whether the workspace can access Amazon Web Services resources in this Amazon Web Services account only, or whether it can also access Amazon Web Services resources in other accounts in the same organization. If this is
ORGANIZATION, theworkspaceOrganizationalUnitsparameter specifies which organizational units the workspace can access.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ACCOUNTACCESSTYPE() |
Getter for ACCOUNTACCESSTYPE, with configurable default |
ASK_ACCOUNTACCESSTYPE() |
Getter for ACCOUNTACCESSTYPE w/ exceptions if field has no v |
HAS_ACCOUNTACCESSTYPE() |
Determine if ACCOUNTACCESSTYPE has a value |
created¶
The date that the workspace was created.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_CREATED() |
Getter for CREATED, with configurable default |
ASK_CREATED() |
Getter for CREATED w/ exceptions if field has no value |
HAS_CREATED() |
Determine if CREATED has a value |
dataSources¶
Specifies the Amazon Web Services data sources that have been configured to have IAM roles and permissions created to allow Amazon Managed Grafana to read data from these sources.
This list is only used when the workspace was created through the Amazon Web Services console, and the
permissionTypeisSERVICE_MANAGED.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_DATASOURCES() |
Getter for DATASOURCES, with configurable default |
ASK_DATASOURCES() |
Getter for DATASOURCES w/ exceptions if field has no value |
HAS_DATASOURCES() |
Determine if DATASOURCES has a value |
description¶
The user-defined description of the workspace.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_DESCRIPTION() |
Getter for DESCRIPTION, with configurable default |
ASK_DESCRIPTION() |
Getter for DESCRIPTION w/ exceptions if field has no value |
HAS_DESCRIPTION() |
Determine if DESCRIPTION has a value |
endpoint¶
The URL that users can use to access the Grafana console in the workspace.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ENDPOINT() |
Getter for ENDPOINT, with configurable default |
ASK_ENDPOINT() |
Getter for ENDPOINT w/ exceptions if field has no value |
HAS_ENDPOINT() |
Determine if ENDPOINT has a value |
grafanaVersion¶
The version of Grafana supported in this workspace.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_GRAFANAVERSION() |
Getter for GRAFANAVERSION, with configurable default |
ASK_GRAFANAVERSION() |
Getter for GRAFANAVERSION w/ exceptions if field has no valu |
HAS_GRAFANAVERSION() |
Determine if GRAFANAVERSION has a value |
id¶
The unique ID of this workspace.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ID() |
Getter for ID, with configurable default |
ASK_ID() |
Getter for ID w/ exceptions if field has no value |
HAS_ID() |
Determine if ID has a value |
modified¶
The most recent date that the workspace was modified.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_MODIFIED() |
Getter for MODIFIED, with configurable default |
ASK_MODIFIED() |
Getter for MODIFIED w/ exceptions if field has no value |
HAS_MODIFIED() |
Determine if MODIFIED has a value |
name¶
The name of the workspace.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_NAME() |
Getter for NAME, with configurable default |
ASK_NAME() |
Getter for NAME w/ exceptions if field has no value |
HAS_NAME() |
Determine if NAME has a value |
organizationRoleName¶
The name of the IAM role that is used to access resources through Organizations.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ORGANIZATIONROLENAME() |
Getter for ORGANIZATIONROLENAME, with configurable default |
ASK_ORGANIZATIONROLENAME() |
Getter for ORGANIZATIONROLENAME w/ exceptions if field has n |
HAS_ORGANIZATIONROLENAME() |
Determine if ORGANIZATIONROLENAME has a value |
notificationDestinations¶
The Amazon Web Services notification channels that Amazon Managed Grafana can automatically create IAM roles and permissions for, to allow Amazon Managed Grafana to use these channels.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_NOTIFICATIONDESTINATIONS() |
Getter for NOTIFICATIONDESTINATIONS, with configurable defau |
ASK_NOTIFICATIONDESTINATIONS() |
Getter for NOTIFICATIONDESTINATIONS w/ exceptions if field h |
HAS_NOTIFICATIONDESTINATIONS() |
Determine if NOTIFICATIONDESTINATIONS has a value |
organizationalUnits¶
Specifies the organizational units that this workspace is allowed to use data sources from, if this workspace is in an account that is part of an organization.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ORGANIZATIONALUNITS() |
Getter for ORGANIZATIONALUNITS, with configurable default |
ASK_ORGANIZATIONALUNITS() |
Getter for ORGANIZATIONALUNITS w/ exceptions if field has no |
HAS_ORGANIZATIONALUNITS() |
Determine if ORGANIZATIONALUNITS has a value |
permissionType¶
If this is
SERVICE_MANAGED, and the workplace was created through the Amazon Managed Grafana console, then Amazon Managed Grafana automatically creates the IAM roles and provisions the permissions that the workspace needs to use Amazon Web Services data sources and notification channels.If this is
CUSTOMER_MANAGED, you must manage those roles and permissions yourself.If you are working with a workspace in a member account of an organization and that account is not a delegated administrator account, and you want the workspace to access data sources in other Amazon Web Services accounts in the organization, this parameter must be set to
CUSTOMER_MANAGED.For more information about converting between customer and service managed, see Managing permissions for data sources and notification channels. For more information about the roles and permissions that must be managed for customer managed workspaces, see Amazon Managed Grafana permissions and policies for Amazon Web Services data sources and notification channels
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_PERMISSIONTYPE() |
Getter for PERMISSIONTYPE, with configurable default |
ASK_PERMISSIONTYPE() |
Getter for PERMISSIONTYPE w/ exceptions if field has no valu |
HAS_PERMISSIONTYPE() |
Determine if PERMISSIONTYPE has a value |
stackSetName¶
The name of the CloudFormation stack set that is used to generate IAM roles to be used for this workspace.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_STACKSETNAME() |
Getter for STACKSETNAME, with configurable default |
ASK_STACKSETNAME() |
Getter for STACKSETNAME w/ exceptions if field has no value |
HAS_STACKSETNAME() |
Determine if STACKSETNAME has a value |
status¶
The current status of the workspace.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_STATUS() |
Getter for STATUS, with configurable default |
ASK_STATUS() |
Getter for STATUS w/ exceptions if field has no value |
HAS_STATUS() |
Determine if STATUS has a value |
workspaceRoleArn¶
The IAM role that grants permissions to the Amazon Web Services resources that the workspace will view data from. This role must already exist.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_WORKSPACEROLEARN() |
Getter for WORKSPACEROLEARN, with configurable default |
ASK_WORKSPACEROLEARN() |
Getter for WORKSPACEROLEARN w/ exceptions if field has no va |
HAS_WORKSPACEROLEARN() |
Determine if WORKSPACEROLEARN has a value |
licenseType¶
Specifies whether this workspace has a full Grafana Enterprise license.
Amazon Managed Grafana workspaces no longer support Grafana Enterprise free trials.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_LICENSETYPE() |
Getter for LICENSETYPE, with configurable default |
ASK_LICENSETYPE() |
Getter for LICENSETYPE w/ exceptions if field has no value |
HAS_LICENSETYPE() |
Determine if LICENSETYPE has a value |
freeTrialConsumed¶
Specifies whether this workspace has already fully used its free trial for Grafana Enterprise.
Amazon Managed Grafana workspaces no longer support Grafana Enterprise free trials.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_FREETRIALCONSUMED() |
Getter for FREETRIALCONSUMED, with configurable default |
ASK_FREETRIALCONSUMED() |
Getter for FREETRIALCONSUMED w/ exceptions if field has no v |
HAS_FREETRIALCONSUMED() |
Determine if FREETRIALCONSUMED has a value |
licenseExpiration¶
If this workspace has a full Grafana Enterprise license purchased through Amazon Web Services Marketplace, this specifies when the license ends and will need to be renewed. Purchasing the Enterprise plugins option through Amazon Managed Grafana does not have an expiration. It is valid until the license is removed.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_LICENSEEXPIRATION() |
Getter for LICENSEEXPIRATION, with configurable default |
ASK_LICENSEEXPIRATION() |
Getter for LICENSEEXPIRATION w/ exceptions if field has no v |
HAS_LICENSEEXPIRATION() |
Determine if LICENSEEXPIRATION has a value |
freeTrialExpiration¶
If this workspace is currently in the free trial period for Grafana Enterprise, this value specifies when that free trial ends.
Amazon Managed Grafana workspaces no longer support Grafana Enterprise free trials.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_FREETRIALEXPIRATION() |
Getter for FREETRIALEXPIRATION, with configurable default |
ASK_FREETRIALEXPIRATION() |
Getter for FREETRIALEXPIRATION w/ exceptions if field has no |
HAS_FREETRIALEXPIRATION() |
Determine if FREETRIALEXPIRATION has a value |
authentication¶
A structure that describes whether the workspace uses SAML, IAM Identity Center, or both methods for user authentication.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_AUTHENTICATION() |
Getter for AUTHENTICATION |
tags¶
The list of tags associated with the workspace.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_TAGS() |
Getter for TAGS, with configurable default |
ASK_TAGS() |
Getter for TAGS w/ exceptions if field has no value |
HAS_TAGS() |
Determine if TAGS has a value |
vpcConfiguration¶
The configuration for connecting to data sources in a private VPC (Amazon Virtual Private Cloud).
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_VPCCONFIGURATION() |
Getter for VPCCONFIGURATION |
networkAccessControl¶
The configuration settings for network access to your workspace.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_NETWORKACCESSCONTROL() |
Getter for NETWORKACCESSCONTROL |
grafanaToken¶
The token that ties this workspace to a Grafana Labs account. For more information, see Link your account with Grafana Labs.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_GRAFANATOKEN() |
Getter for GRAFANATOKEN, with configurable default |
ASK_GRAFANATOKEN() |
Getter for GRAFANATOKEN w/ exceptions if field has no value |
HAS_GRAFANATOKEN() |
Determine if GRAFANATOKEN has a value |