types

package
v1.21.3 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 8, 2024 License: Apache-2.0 Imports: 4 Imported by: 3

Documentation

Index

Examples

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type AccessDeniedException

type AccessDeniedException struct {
	Message *string

	ErrorCodeOverride *string
	// contains filtered or unexported fields
}

You do not have sufficient permissions to perform this action.

func (*AccessDeniedException) Error

func (e *AccessDeniedException) Error() string

func (*AccessDeniedException) ErrorCode

func (e *AccessDeniedException) ErrorCode() string

func (*AccessDeniedException) ErrorFault

func (e *AccessDeniedException) ErrorFault() smithy.ErrorFault

func (*AccessDeniedException) ErrorMessage

func (e *AccessDeniedException) ErrorMessage() string

type AccountAccessType

type AccountAccessType string
const (
	// Indicates that the customer is using Grafana to monitor resources in their
	// current account.
	AccountAccessTypeCurrentAccount AccountAccessType = "CURRENT_ACCOUNT"
	// Indicates that the customer is using Grafana to monitor resources in
	// organizational units.
	AccountAccessTypeOrganization AccountAccessType = "ORGANIZATION"
)

Enum values for AccountAccessType

func (AccountAccessType) Values

Values returns all known values for AccountAccessType. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type AssertionAttributes

type AssertionAttributes struct {

	// The name of the attribute within the SAML assertion to use as the email names
	// for SAML users.
	Email *string

	// The name of the attribute within the SAML assertion to use as the user full
	// "friendly" names for user groups.
	Groups *string

	// The name of the attribute within the SAML assertion to use as the login names
	// for SAML users.
	Login *string

	// The name of the attribute within the SAML assertion to use as the user full
	// "friendly" names for SAML users.
	Name *string

	// The name of the attribute within the SAML assertion to use as the user full
	// "friendly" names for the users' organizations.
	Org *string

	// The name of the attribute within the SAML assertion to use as the user roles.
	Role *string
	// contains filtered or unexported fields
}

A structure that defines which attributes in the IdP assertion are to be used to define information about the users authenticated by the IdP to use the workspace.

type AuthenticationDescription

type AuthenticationDescription struct {

	// Specifies whether this workspace uses IAM Identity Center, SAML, or both
	// methods to authenticate users to use the Grafana console in the Amazon Managed
	// Grafana workspace.
	//
	// This member is required.
	Providers []AuthenticationProviderTypes

	// A structure containing information about how this workspace works with IAM
	// Identity Center.
	AwsSso *AwsSsoAuthentication

	// A structure containing information about how this workspace works with SAML,
	// including what attributes within the assertion are to be mapped to user
	// information in the workspace.
	Saml *SamlAuthentication
	// contains filtered or unexported fields
}

A structure containing information about the user authentication methods used by the workspace.

type AuthenticationProviderTypes

type AuthenticationProviderTypes string
const (
	// Indicates that AMG workspace has AWS SSO enabled as its authentication provider.
	AuthenticationProviderTypesAwsSso AuthenticationProviderTypes = "AWS_SSO"
	// Indicates that the AMG workspace has SAML enabled as its authentication
	// provider.
	AuthenticationProviderTypesSaml AuthenticationProviderTypes = "SAML"
)

Enum values for AuthenticationProviderTypes

func (AuthenticationProviderTypes) Values

Values returns all known values for AuthenticationProviderTypes. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type AuthenticationSummary

type AuthenticationSummary struct {

	// Specifies whether the workspace uses SAML, IAM Identity Center, or both methods
	// for user authentication.
	//
	// This member is required.
	Providers []AuthenticationProviderTypes

	// Specifies whether the workplace's user authentication method is fully
	// configured.
	SamlConfigurationStatus SamlConfigurationStatus
	// contains filtered or unexported fields
}

A structure that describes whether the workspace uses SAML, IAM Identity Center, or both methods for user authentication, and whether that authentication is fully configured.

type AwsSsoAuthentication

type AwsSsoAuthentication struct {

	// The ID of the IAM Identity Center-managed application that is created by Amazon
	// Managed Grafana.
	SsoClientId *string
	// contains filtered or unexported fields
}

A structure containing information about how this workspace works with IAM Identity Center.

type ConflictException

type ConflictException struct {
	Message *string

	ErrorCodeOverride *string

	ResourceId   *string
	ResourceType *string
	// contains filtered or unexported fields
}

A resource was in an inconsistent state during an update or a deletion.

func (*ConflictException) Error

func (e *ConflictException) Error() string

func (*ConflictException) ErrorCode

func (e *ConflictException) ErrorCode() string

func (*ConflictException) ErrorFault

func (e *ConflictException) ErrorFault() smithy.ErrorFault

func (*ConflictException) ErrorMessage

func (e *ConflictException) ErrorMessage() string

type DataSourceType

type DataSourceType string
const (
	// Amazon OpenSearch Service
	DataSourceTypeAmazonOpensearchService DataSourceType = "AMAZON_OPENSEARCH_SERVICE"
	// CloudWatch Logs
	DataSourceTypeCloudwatch DataSourceType = "CLOUDWATCH"
	// Managed Prometheus
	DataSourceTypePrometheus DataSourceType = "PROMETHEUS"
	// X-Ray
	DataSourceTypeXray DataSourceType = "XRAY"
	// Timestream
	DataSourceTypeTimestream DataSourceType = "TIMESTREAM"
	// IoT SiteWise
	DataSourceTypeSitewise DataSourceType = "SITEWISE"
	// Amazon Athena
	DataSourceTypeAthena DataSourceType = "ATHENA"
	// Redshift
	DataSourceTypeRedshift DataSourceType = "REDSHIFT"
	// IoT TwinMaker
	DataSourceTypeTwinmaker DataSourceType = "TWINMAKER"
)

Enum values for DataSourceType

func (DataSourceType) Values

func (DataSourceType) Values() []DataSourceType

Values returns all known values for DataSourceType. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type IdpMetadata

type IdpMetadata interface {
	// contains filtered or unexported methods
}

A structure containing the identity provider (IdP) metadata used to integrate the identity provider with this workspace. You can specify the metadata either by providing a URL to its location in the url parameter, or by specifying the full metadata in XML format in the xml parameter. Specifying both will cause an error.

The following types satisfy this interface:

IdpMetadataMemberUrl
IdpMetadataMemberXml
Example (OutputUsage)
// Code generated by smithy-go-codegen DO NOT EDIT.

package main

import (
	"fmt"
	"github.com/aws/aws-sdk-go-v2/service/grafana/types"
)

func main() {
	var union types.IdpMetadata
	// type switches can be used to check the union value
	switch v := union.(type) {
	case *types.IdpMetadataMemberUrl:
		_ = v.Value // Value is string

	case *types.IdpMetadataMemberXml:
		_ = v.Value // Value is string

	case *types.UnknownUnionMember:
		fmt.Println("unknown tag:", v.Tag)

	default:
		fmt.Println("union is nil or unknown type")

	}
}

var _ *string
var _ *string
Output:

type IdpMetadataMemberUrl

type IdpMetadataMemberUrl struct {
	Value string
	// contains filtered or unexported fields
}

The URL of the location containing the IdP metadata.

type IdpMetadataMemberXml

type IdpMetadataMemberXml struct {
	Value string
	// contains filtered or unexported fields
}

The full IdP metadata, in XML format.

type InternalServerException

type InternalServerException struct {
	Message *string

	ErrorCodeOverride *string

	RetryAfterSeconds *int32
	// contains filtered or unexported fields
}

Unexpected error while processing the request. Retry the request.

func (*InternalServerException) Error

func (e *InternalServerException) Error() string

func (*InternalServerException) ErrorCode

func (e *InternalServerException) ErrorCode() string

func (*InternalServerException) ErrorFault

func (e *InternalServerException) ErrorFault() smithy.ErrorFault

func (*InternalServerException) ErrorMessage

func (e *InternalServerException) ErrorMessage() string

type LicenseType

type LicenseType string
const (
	// Grafana Enterprise License.
	LicenseTypeEnterprise LicenseType = "ENTERPRISE"
	// Grafana Enterprise Free Trial License.
	LicenseTypeEnterpriseFreeTrial LicenseType = "ENTERPRISE_FREE_TRIAL"
)

Enum values for LicenseType

func (LicenseType) Values

func (LicenseType) Values() []LicenseType

Values returns all known values for LicenseType. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type NetworkAccessConfiguration added in v1.12.0

type NetworkAccessConfiguration struct {

	// An array of prefix list IDs. A prefix list is a list of CIDR ranges of IP
	// addresses. The IP addresses specified are allowed to access your workspace. If
	// the list is not included in the configuration (passed an empty array) then no IP
	// addresses are allowed to access the workspace. You create a prefix list using
	// the Amazon VPC console.
	//
	// Prefix list IDs have the format pl-1a2b3c4d .
	//
	// For more information about prefix lists, see [Group CIDR blocks using managed prefix lists]in the Amazon Virtual Private
	// Cloud User Guide.
	//
	// [Group CIDR blocks using managed prefix lists]: https://docs.aws.amazon.com/vpc/latest/userguide/managed-prefix-lists.html
	//
	// This member is required.
	PrefixListIds []string

	// An array of Amazon VPC endpoint IDs for the workspace. You can create VPC
	// endpoints to your Amazon Managed Grafana workspace for access from within a VPC.
	// If a NetworkAccessConfiguration is specified then only VPC endpoints specified
	// here are allowed to access the workspace. If you pass in an empty array of
	// strings, then no VPCs are allowed to access the workspace.
	//
	// VPC endpoint IDs have the format vpce-1a2b3c4d .
	//
	// For more information about creating an interface VPC endpoint, see [Interface VPC endpoints] in the
	// Amazon Managed Grafana User Guide.
	//
	// The only VPC endpoints that can be specified here are interface VPC endpoints
	// for Grafana workspaces (using the com.amazonaws.[region].grafana-workspace
	// service endpoint). Other VPC endpoints are ignored.
	//
	// [Interface VPC endpoints]: https://docs.aws.amazon.com/grafana/latest/userguide/VPC-endpoints
	//
	// This member is required.
	VpceIds []string
	// contains filtered or unexported fields
}

The configuration settings for in-bound network access to your workspace.

When this is configured, only listed IP addresses and VPC endpoints will be able to access your workspace. Standard Grafana authentication and authorization are still required.

Access is granted to a caller that is in either the IP address list or the VPC endpoint list - they do not need to be in both.

If this is not configured, or is removed, then all IP addresses and VPC endpoints are allowed. Standard Grafana authentication and authorization are still required.

While both prefixListIds and vpceIds are required, you can pass in an empty array of strings for either parameter if you do not want to allow any of that type.

If both are passed as empty arrays, no traffic is allowed to the workspace, because only explicitly allowed connections are accepted.

type NotificationDestinationType

type NotificationDestinationType string
const (
	// AWS Simple Notification Service
	NotificationDestinationTypeSns NotificationDestinationType = "SNS"
)

Enum values for NotificationDestinationType

func (NotificationDestinationType) Values

Values returns all known values for NotificationDestinationType. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type PermissionEntry

type PermissionEntry struct {

	// Specifies whether the user or group has the Admin , Editor , or Viewer role.
	//
	// This member is required.
	Role Role

	// A structure with the ID of the user or group with this role.
	//
	// This member is required.
	User *User
	// contains filtered or unexported fields
}

A structure containing the identity of one user or group and the Admin , Editor , or Viewer role that they have.

type PermissionType

type PermissionType string
const (
	// Customer Managed
	PermissionTypeCustomerManaged PermissionType = "CUSTOMER_MANAGED"
	// Service Managed
	PermissionTypeServiceManaged PermissionType = "SERVICE_MANAGED"
)

Enum values for PermissionType

func (PermissionType) Values

func (PermissionType) Values() []PermissionType

Values returns all known values for PermissionType. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type ResourceNotFoundException

type ResourceNotFoundException struct {
	Message *string

	ErrorCodeOverride *string

	ResourceId   *string
	ResourceType *string
	// contains filtered or unexported fields
}

The request references a resource that does not exist.

func (*ResourceNotFoundException) Error

func (e *ResourceNotFoundException) Error() string

func (*ResourceNotFoundException) ErrorCode

func (e *ResourceNotFoundException) ErrorCode() string

func (*ResourceNotFoundException) ErrorFault

func (*ResourceNotFoundException) ErrorMessage

func (e *ResourceNotFoundException) ErrorMessage() string

type Role

type Role string
const (
	// Role Admin.
	RoleAdmin Role = "ADMIN"
	// Role Editor.
	RoleEditor Role = "EDITOR"
	// Role Viewer.
	RoleViewer Role = "VIEWER"
)

Enum values for Role

func (Role) Values

func (Role) Values() []Role

Values returns all known values for Role. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type RoleValues

type RoleValues struct {

	// A list of groups from the SAML assertion attribute to grant the Grafana Admin
	// role to.
	Admin []string

	// A list of groups from the SAML assertion attribute to grant the Grafana Editor
	// role to.
	Editor []string
	// contains filtered or unexported fields
}

This structure defines which groups defined in the SAML assertion attribute are to be mapped to the Grafana Admin and Editor roles in the workspace. SAML authenticated users not part of Admin or Editor role groups have Viewer permission over the workspace.

type SamlAuthentication

type SamlAuthentication struct {

	// Specifies whether the workspace's SAML configuration is complete.
	//
	// This member is required.
	Status SamlConfigurationStatus

	// A structure containing details about how this workspace works with SAML.
	Configuration *SamlConfiguration
	// contains filtered or unexported fields
}

A structure containing information about how this workspace works with SAML.

type SamlConfiguration

type SamlConfiguration struct {

	// A structure containing the identity provider (IdP) metadata used to integrate
	// the identity provider with this workspace.
	//
	// This member is required.
	IdpMetadata IdpMetadata

	// Lists which organizations defined in the SAML assertion are allowed to use the
	// Amazon Managed Grafana workspace. If this is empty, all organizations in the
	// assertion attribute have access.
	AllowedOrganizations []string

	// A structure that defines which attributes in the SAML assertion are to be used
	// to define information about the users authenticated by that IdP to use the
	// workspace.
	AssertionAttributes *AssertionAttributes

	// How long a sign-on session by a SAML user is valid, before the user has to sign
	// on again.
	LoginValidityDuration int32

	// A structure containing arrays that map group names in the SAML assertion to the
	// Grafana Admin and Editor roles in the workspace.
	RoleValues *RoleValues
	// contains filtered or unexported fields
}

A structure containing information about how this workspace works with SAML.

type SamlConfigurationStatus

type SamlConfigurationStatus string
const (
	// Indicates that SAML on an AMG workspace is enabled and has been configured.
	SamlConfigurationStatusConfigured SamlConfigurationStatus = "CONFIGURED"
	// Indicates that SAML on an AMG workspace is enabled but has not been configured.
	SamlConfigurationStatusNotConfigured SamlConfigurationStatus = "NOT_CONFIGURED"
)

Enum values for SamlConfigurationStatus

func (SamlConfigurationStatus) Values

Values returns all known values for SamlConfigurationStatus. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type ServiceQuotaExceededException

type ServiceQuotaExceededException struct {
	Message *string

	ErrorCodeOverride *string

	ResourceId   *string
	ResourceType *string
	ServiceCode  *string
	QuotaCode    *string
	// contains filtered or unexported fields
}

The request would cause a service quota to be exceeded.

func (*ServiceQuotaExceededException) Error

func (*ServiceQuotaExceededException) ErrorCode

func (e *ServiceQuotaExceededException) ErrorCode() string

func (*ServiceQuotaExceededException) ErrorFault

func (*ServiceQuotaExceededException) ErrorMessage

func (e *ServiceQuotaExceededException) ErrorMessage() string

type ThrottlingException

type ThrottlingException struct {
	Message *string

	ErrorCodeOverride *string

	ServiceCode       *string
	QuotaCode         *string
	RetryAfterSeconds *int32
	// contains filtered or unexported fields
}

The request was denied because of request throttling. Retry the request.

func (*ThrottlingException) Error

func (e *ThrottlingException) Error() string

func (*ThrottlingException) ErrorCode

func (e *ThrottlingException) ErrorCode() string

func (*ThrottlingException) ErrorFault

func (e *ThrottlingException) ErrorFault() smithy.ErrorFault

func (*ThrottlingException) ErrorMessage

func (e *ThrottlingException) ErrorMessage() string

type UnknownUnionMember

type UnknownUnionMember struct {
	Tag   string
	Value []byte
	// contains filtered or unexported fields
}

UnknownUnionMember is returned when a union member is returned over the wire, but has an unknown tag.

type UpdateAction

type UpdateAction string
const (
	// Add permissions.
	UpdateActionAdd UpdateAction = "ADD"
	// Revoke permissions.
	UpdateActionRevoke UpdateAction = "REVOKE"
)

Enum values for UpdateAction

func (UpdateAction) Values

func (UpdateAction) Values() []UpdateAction

Values returns all known values for UpdateAction. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type UpdateError

type UpdateError struct {

	// Specifies which permission update caused the error.
	//
	// This member is required.
	CausedBy *UpdateInstruction

	// The error code.
	//
	// This member is required.
	Code *int32

	// The message for this error.
	//
	// This member is required.
	Message *string
	// contains filtered or unexported fields
}

A structure containing information about one error encountered while performing an UpdatePermissionsoperation.

type UpdateInstruction

type UpdateInstruction struct {

	// Specifies whether this update is to add or revoke role permissions.
	//
	// This member is required.
	Action UpdateAction

	// The role to add or revoke for the user or the group specified in users .
	//
	// This member is required.
	Role Role

	// A structure that specifies the user or group to add or revoke the role for.
	//
	// This member is required.
	Users []User
	// contains filtered or unexported fields
}

Contains the instructions for one Grafana role permission update in a UpdatePermissions operation.

type User

type User struct {

	// The ID of the user or group.
	//
	// Pattern:
	// ^([0-9a-fA-F]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}$
	//
	// This member is required.
	Id *string

	// Specifies whether this is a single user or a group.
	//
	// This member is required.
	Type UserType
	// contains filtered or unexported fields
}

A structure that specifies one user or group in the workspace.

type UserType

type UserType string
const (
	// SSO user.
	UserTypeSsoUser UserType = "SSO_USER"
	// SSO group.
	UserTypeSsoGroup UserType = "SSO_GROUP"
)

Enum values for UserType

func (UserType) Values

func (UserType) Values() []UserType

Values returns all known values for UserType. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type ValidationException

type ValidationException struct {
	Message *string

	ErrorCodeOverride *string

	Reason    ValidationExceptionReason
	FieldList []ValidationExceptionField
	// contains filtered or unexported fields
}

The value of a parameter in the request caused an error.

func (*ValidationException) Error

func (e *ValidationException) Error() string

func (*ValidationException) ErrorCode

func (e *ValidationException) ErrorCode() string

func (*ValidationException) ErrorFault

func (e *ValidationException) ErrorFault() smithy.ErrorFault

func (*ValidationException) ErrorMessage

func (e *ValidationException) ErrorMessage() string

type ValidationExceptionField

type ValidationExceptionField struct {

	// A message describing why this field couldn't be validated.
	//
	// This member is required.
	Message *string

	// The name of the field that caused the validation error.
	//
	// This member is required.
	Name *string
	// contains filtered or unexported fields
}

A structure that contains information about a request parameter that caused an error.

type ValidationExceptionReason

type ValidationExceptionReason string
const (
	ValidationExceptionReasonUnknownOperation      ValidationExceptionReason = "UNKNOWN_OPERATION"
	ValidationExceptionReasonCannotParse           ValidationExceptionReason = "CANNOT_PARSE"
	ValidationExceptionReasonFieldValidationFailed ValidationExceptionReason = "FIELD_VALIDATION_FAILED"
	ValidationExceptionReasonOther                 ValidationExceptionReason = "OTHER"
)

Enum values for ValidationExceptionReason

func (ValidationExceptionReason) Values

Values returns all known values for ValidationExceptionReason. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type VpcConfiguration added in v1.10.0

type VpcConfiguration struct {

	// The list of Amazon EC2 security group IDs attached to the Amazon VPC for your
	// Grafana workspace to connect. Duplicates not allowed.
	//
	// This member is required.
	SecurityGroupIds []string

	// The list of Amazon EC2 subnet IDs created in the Amazon VPC for your Grafana
	// workspace to connect. Duplicates not allowed.
	//
	// This member is required.
	SubnetIds []string
	// contains filtered or unexported fields
}

The configuration settings for an Amazon VPC that contains data sources for your Grafana workspace to connect to.

Provided securityGroupIds and subnetIds must be part of the same VPC.

Connecting to a private VPC is not yet available in the Asia Pacific (Seoul) Region (ap-northeast-2).

type WorkspaceDescription

type WorkspaceDescription struct {

	// A structure that describes whether the workspace uses SAML, IAM Identity
	// Center, or both methods for user authentication.
	//
	// This member is required.
	Authentication *AuthenticationSummary

	// The date that the workspace was created.
	//
	// This member is required.
	Created *time.Time

	// 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 permissionType is SERVICE_MANAGED .
	//
	// This member is required.
	DataSources []DataSourceType

	// The URL that users can use to access the Grafana console in the workspace.
	//
	// This member is required.
	Endpoint *string

	// The version of Grafana supported in this workspace.
	//
	// This member is required.
	GrafanaVersion *string

	// The unique ID of this workspace.
	//
	// This member is required.
	Id *string

	// The most recent date that the workspace was modified.
	//
	// This member is required.
	Modified *time.Time

	// The current status of the workspace.
	//
	// This member is required.
	Status WorkspaceStatus

	// 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 , the workspaceOrganizationalUnits parameter specifies which
	// organizational units the workspace can access.
	AccountAccessType AccountAccessType

	// The user-defined description of the workspace.
	Description *string

	// 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.
	FreeTrialConsumed *bool

	// 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.
	FreeTrialExpiration *time.Time

	// The token that ties this workspace to a Grafana Labs account. For more
	// information, see [Register with Grafana Labs].
	//
	// [Register with Grafana Labs]: https://docs.aws.amazon.com/grafana/latest/userguide/upgrade-to-Grafana-Enterprise.html#AMG-workspace-register-enterprise
	GrafanaToken *string

	// 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.
	LicenseExpiration *time.Time

	// Specifies whether this workspace has a full Grafana Enterprise license.
	//
	// Amazon Managed Grafana workspaces no longer support Grafana Enterprise free
	// trials.
	LicenseType LicenseType

	// The name of the workspace.
	Name *string

	// The configuration settings for network access to your workspace.
	NetworkAccessControl *NetworkAccessConfiguration

	// 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.
	NotificationDestinations []NotificationDestinationType

	// The name of the IAM role that is used to access resources through Organizations.
	OrganizationRoleName *string

	// 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.
	OrganizationalUnits []string

	// 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]
	//
	// [Amazon Managed Grafana permissions and policies for Amazon Web Services data sources and notification channels]: https://docs.aws.amazon.com/grafana/latest/userguide/AMG-manage-permissions.html
	// [Managing permissions for data sources and notification channels]: https://docs.aws.amazon.com/grafana/latest/userguide/AMG-datasource-and-notification.html
	PermissionType PermissionType

	// The name of the CloudFormation stack set that is used to generate IAM roles to
	// be used for this workspace.
	StackSetName *string

	// The list of tags associated with the workspace.
	Tags map[string]string

	// The configuration for connecting to data sources in a private VPC (Amazon
	// Virtual Private Cloud).
	VpcConfiguration *VpcConfiguration

	// The IAM role that grants permissions to the Amazon Web Services resources that
	// the workspace will view data from. This role must already exist.
	WorkspaceRoleArn *string
	// contains filtered or unexported fields
}

A structure containing information about an Amazon Managed Grafana workspace in your account.

type WorkspaceStatus

type WorkspaceStatus string
const (
	// Workspace is active.
	WorkspaceStatusActive WorkspaceStatus = "ACTIVE"
	// Workspace is being created.
	WorkspaceStatusCreating WorkspaceStatus = "CREATING"
	// Workspace is being deleted.
	WorkspaceStatusDeleting WorkspaceStatus = "DELETING"
	// Workspace is in an invalid state, it can only and should be deleted.
	WorkspaceStatusFailed WorkspaceStatus = "FAILED"
	// Workspace is being updated.
	WorkspaceStatusUpdating WorkspaceStatus = "UPDATING"
	// Workspace is being upgraded to enterprise.
	WorkspaceStatusUpgrading WorkspaceStatus = "UPGRADING"
	// Workspace deletion failed.
	WorkspaceStatusDeletionFailed WorkspaceStatus = "DELETION_FAILED"
	// Workspace creation failed.
	WorkspaceStatusCreationFailed WorkspaceStatus = "CREATION_FAILED"
	// Workspace update failed.
	WorkspaceStatusUpdateFailed WorkspaceStatus = "UPDATE_FAILED"
	// Workspace upgrade failed.
	WorkspaceStatusUpgradeFailed WorkspaceStatus = "UPGRADE_FAILED"
	// Failed to remove enterprise license from workspace.
	WorkspaceStatusLicenseRemovalFailed WorkspaceStatus = "LICENSE_REMOVAL_FAILED"
	// Workspace version is being updated.
	WorkspaceStatusVersionUpdating WorkspaceStatus = "VERSION_UPDATING"
	// Workspace version update failed.
	WorkspaceStatusVersionUpdateFailed WorkspaceStatus = "VERSION_UPDATE_FAILED"
)

Enum values for WorkspaceStatus

func (WorkspaceStatus) Values

func (WorkspaceStatus) Values() []WorkspaceStatus

Values returns all known values for WorkspaceStatus. Note that this can be expanded in the future, and so it is only as up to date as the client.

The ordering of this slice is not guaranteed to be stable across updates.

type WorkspaceSummary

type WorkspaceSummary struct {

	// A structure containing information about the authentication methods used in the
	// workspace.
	//
	// This member is required.
	Authentication *AuthenticationSummary

	// The date that the workspace was created.
	//
	// This member is required.
	Created *time.Time

	// The URL endpoint to use to access the Grafana console in the workspace.
	//
	// This member is required.
	Endpoint *string

	// The Grafana version that the workspace is running.
	//
	// This member is required.
	GrafanaVersion *string

	// The unique ID of the workspace.
	//
	// This member is required.
	Id *string

	// The most recent date that the workspace was modified.
	//
	// This member is required.
	Modified *time.Time

	// The current status of the workspace.
	//
	// This member is required.
	Status WorkspaceStatus

	// The customer-entered description of the workspace.
	Description *string

	// The token that ties this workspace to a Grafana Labs account. For more
	// information, see [Register with Grafana Labs].
	//
	// [Register with Grafana Labs]: https://docs.aws.amazon.com/grafana/latest/userguide/upgrade-to-Grafana-Enterprise.html#AMG-workspace-register-enterprise
	GrafanaToken *string

	// Specifies whether this workspace has a full Grafana Enterprise license.
	//
	// Amazon Managed Grafana workspaces no longer support Grafana Enterprise free
	// trials.
	LicenseType LicenseType

	// The name of the workspace.
	Name *string

	// The Amazon Web Services notification channels that Amazon Managed Grafana can
	// automatically create IAM roles and permissions for, which allows Amazon Managed
	// Grafana to use these channels.
	NotificationDestinations []NotificationDestinationType

	// The list of tags associated with the workspace.
	Tags map[string]string
	// contains filtered or unexported fields
}

A structure that contains some information about one workspace in the account.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL