Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Amazonka.Grafana.Lens
Contents
- Operations
- AssociateLicense
- CreateWorkspace
- CreateWorkspaceApiKey
- DeleteWorkspace
- DeleteWorkspaceApiKey
- DescribeWorkspace
- DescribeWorkspaceAuthentication
- DescribeWorkspaceConfiguration
- DisassociateLicense
- ListPermissions
- ListTagsForResource
- ListWorkspaces
- TagResource
- UntagResource
- UpdatePermissions
- UpdateWorkspace
- UpdateWorkspaceAuthentication
- UpdateWorkspaceConfiguration
- Types
Description
Synopsis
- associateLicense_licenseType :: Lens' AssociateLicense LicenseType
- associateLicense_workspaceId :: Lens' AssociateLicense Text
- associateLicenseResponse_httpStatus :: Lens' AssociateLicenseResponse Int
- associateLicenseResponse_workspace :: Lens' AssociateLicenseResponse WorkspaceDescription
- createWorkspace_clientToken :: Lens' CreateWorkspace (Maybe Text)
- createWorkspace_configuration :: Lens' CreateWorkspace (Maybe Text)
- createWorkspace_organizationRoleName :: Lens' CreateWorkspace (Maybe Text)
- createWorkspace_stackSetName :: Lens' CreateWorkspace (Maybe Text)
- createWorkspace_tags :: Lens' CreateWorkspace (Maybe (HashMap Text Text))
- createWorkspace_vpcConfiguration :: Lens' CreateWorkspace (Maybe VpcConfiguration)
- createWorkspace_workspaceDataSources :: Lens' CreateWorkspace (Maybe [DataSourceType])
- createWorkspace_workspaceDescription :: Lens' CreateWorkspace (Maybe Text)
- createWorkspace_workspaceName :: Lens' CreateWorkspace (Maybe Text)
- createWorkspace_workspaceNotificationDestinations :: Lens' CreateWorkspace (Maybe [NotificationDestinationType])
- createWorkspace_workspaceOrganizationalUnits :: Lens' CreateWorkspace (Maybe [Text])
- createWorkspace_workspaceRoleArn :: Lens' CreateWorkspace (Maybe Text)
- createWorkspace_accountAccessType :: Lens' CreateWorkspace AccountAccessType
- createWorkspace_authenticationProviders :: Lens' CreateWorkspace [AuthenticationProviderTypes]
- createWorkspace_permissionType :: Lens' CreateWorkspace PermissionType
- createWorkspaceResponse_httpStatus :: Lens' CreateWorkspaceResponse Int
- createWorkspaceResponse_workspace :: Lens' CreateWorkspaceResponse WorkspaceDescription
- createWorkspaceApiKey_keyName :: Lens' CreateWorkspaceApiKey Text
- createWorkspaceApiKey_keyRole :: Lens' CreateWorkspaceApiKey Text
- createWorkspaceApiKey_secondsToLive :: Lens' CreateWorkspaceApiKey Natural
- createWorkspaceApiKey_workspaceId :: Lens' CreateWorkspaceApiKey Text
- createWorkspaceApiKeyResponse_httpStatus :: Lens' CreateWorkspaceApiKeyResponse Int
- createWorkspaceApiKeyResponse_key :: Lens' CreateWorkspaceApiKeyResponse Text
- createWorkspaceApiKeyResponse_keyName :: Lens' CreateWorkspaceApiKeyResponse Text
- createWorkspaceApiKeyResponse_workspaceId :: Lens' CreateWorkspaceApiKeyResponse Text
- deleteWorkspace_workspaceId :: Lens' DeleteWorkspace Text
- deleteWorkspaceResponse_httpStatus :: Lens' DeleteWorkspaceResponse Int
- deleteWorkspaceResponse_workspace :: Lens' DeleteWorkspaceResponse WorkspaceDescription
- deleteWorkspaceApiKey_keyName :: Lens' DeleteWorkspaceApiKey Text
- deleteWorkspaceApiKey_workspaceId :: Lens' DeleteWorkspaceApiKey Text
- deleteWorkspaceApiKeyResponse_httpStatus :: Lens' DeleteWorkspaceApiKeyResponse Int
- deleteWorkspaceApiKeyResponse_keyName :: Lens' DeleteWorkspaceApiKeyResponse Text
- deleteWorkspaceApiKeyResponse_workspaceId :: Lens' DeleteWorkspaceApiKeyResponse Text
- describeWorkspace_workspaceId :: Lens' DescribeWorkspace Text
- describeWorkspaceResponse_httpStatus :: Lens' DescribeWorkspaceResponse Int
- describeWorkspaceResponse_workspace :: Lens' DescribeWorkspaceResponse WorkspaceDescription
- describeWorkspaceAuthentication_workspaceId :: Lens' DescribeWorkspaceAuthentication Text
- describeWorkspaceAuthenticationResponse_httpStatus :: Lens' DescribeWorkspaceAuthenticationResponse Int
- describeWorkspaceAuthenticationResponse_authentication :: Lens' DescribeWorkspaceAuthenticationResponse AuthenticationDescription
- describeWorkspaceConfiguration_workspaceId :: Lens' DescribeWorkspaceConfiguration Text
- describeWorkspaceConfigurationResponse_httpStatus :: Lens' DescribeWorkspaceConfigurationResponse Int
- describeWorkspaceConfigurationResponse_configuration :: Lens' DescribeWorkspaceConfigurationResponse Text
- disassociateLicense_licenseType :: Lens' DisassociateLicense LicenseType
- disassociateLicense_workspaceId :: Lens' DisassociateLicense Text
- disassociateLicenseResponse_httpStatus :: Lens' DisassociateLicenseResponse Int
- disassociateLicenseResponse_workspace :: Lens' DisassociateLicenseResponse WorkspaceDescription
- listPermissions_groupId :: Lens' ListPermissions (Maybe Text)
- listPermissions_maxResults :: Lens' ListPermissions (Maybe Natural)
- listPermissions_nextToken :: Lens' ListPermissions (Maybe Text)
- listPermissions_userId :: Lens' ListPermissions (Maybe Text)
- listPermissions_userType :: Lens' ListPermissions (Maybe UserType)
- listPermissions_workspaceId :: Lens' ListPermissions Text
- listPermissionsResponse_nextToken :: Lens' ListPermissionsResponse (Maybe Text)
- listPermissionsResponse_httpStatus :: Lens' ListPermissionsResponse Int
- listPermissionsResponse_permissions :: Lens' ListPermissionsResponse [PermissionEntry]
- listTagsForResource_resourceArn :: Lens' ListTagsForResource Text
- listTagsForResourceResponse_tags :: Lens' ListTagsForResourceResponse (Maybe (HashMap Text Text))
- listTagsForResourceResponse_httpStatus :: Lens' ListTagsForResourceResponse Int
- listWorkspaces_maxResults :: Lens' ListWorkspaces (Maybe Natural)
- listWorkspaces_nextToken :: Lens' ListWorkspaces (Maybe Text)
- listWorkspacesResponse_nextToken :: Lens' ListWorkspacesResponse (Maybe Text)
- listWorkspacesResponse_httpStatus :: Lens' ListWorkspacesResponse Int
- listWorkspacesResponse_workspaces :: Lens' ListWorkspacesResponse [WorkspaceSummary]
- tagResource_resourceArn :: Lens' TagResource Text
- tagResource_tags :: Lens' TagResource (HashMap Text Text)
- tagResourceResponse_httpStatus :: Lens' TagResourceResponse Int
- untagResource_resourceArn :: Lens' UntagResource Text
- untagResource_tagKeys :: Lens' UntagResource [Text]
- untagResourceResponse_httpStatus :: Lens' UntagResourceResponse Int
- updatePermissions_updateInstructionBatch :: Lens' UpdatePermissions [UpdateInstruction]
- updatePermissions_workspaceId :: Lens' UpdatePermissions Text
- updatePermissionsResponse_httpStatus :: Lens' UpdatePermissionsResponse Int
- updatePermissionsResponse_errors :: Lens' UpdatePermissionsResponse [UpdateError]
- updateWorkspace_accountAccessType :: Lens' UpdateWorkspace (Maybe AccountAccessType)
- updateWorkspace_organizationRoleName :: Lens' UpdateWorkspace (Maybe Text)
- updateWorkspace_permissionType :: Lens' UpdateWorkspace (Maybe PermissionType)
- updateWorkspace_removeVpcConfiguration :: Lens' UpdateWorkspace (Maybe Bool)
- updateWorkspace_stackSetName :: Lens' UpdateWorkspace (Maybe Text)
- updateWorkspace_vpcConfiguration :: Lens' UpdateWorkspace (Maybe VpcConfiguration)
- updateWorkspace_workspaceDataSources :: Lens' UpdateWorkspace (Maybe [DataSourceType])
- updateWorkspace_workspaceDescription :: Lens' UpdateWorkspace (Maybe Text)
- updateWorkspace_workspaceName :: Lens' UpdateWorkspace (Maybe Text)
- updateWorkspace_workspaceNotificationDestinations :: Lens' UpdateWorkspace (Maybe [NotificationDestinationType])
- updateWorkspace_workspaceOrganizationalUnits :: Lens' UpdateWorkspace (Maybe [Text])
- updateWorkspace_workspaceRoleArn :: Lens' UpdateWorkspace (Maybe Text)
- updateWorkspace_workspaceId :: Lens' UpdateWorkspace Text
- updateWorkspaceResponse_httpStatus :: Lens' UpdateWorkspaceResponse Int
- updateWorkspaceResponse_workspace :: Lens' UpdateWorkspaceResponse WorkspaceDescription
- updateWorkspaceAuthentication_samlConfiguration :: Lens' UpdateWorkspaceAuthentication (Maybe SamlConfiguration)
- updateWorkspaceAuthentication_authenticationProviders :: Lens' UpdateWorkspaceAuthentication [AuthenticationProviderTypes]
- updateWorkspaceAuthentication_workspaceId :: Lens' UpdateWorkspaceAuthentication Text
- updateWorkspaceAuthenticationResponse_httpStatus :: Lens' UpdateWorkspaceAuthenticationResponse Int
- updateWorkspaceAuthenticationResponse_authentication :: Lens' UpdateWorkspaceAuthenticationResponse AuthenticationDescription
- updateWorkspaceConfiguration_configuration :: Lens' UpdateWorkspaceConfiguration Text
- updateWorkspaceConfiguration_workspaceId :: Lens' UpdateWorkspaceConfiguration Text
- updateWorkspaceConfigurationResponse_httpStatus :: Lens' UpdateWorkspaceConfigurationResponse Int
- assertionAttributes_email :: Lens' AssertionAttributes (Maybe Text)
- assertionAttributes_groups :: Lens' AssertionAttributes (Maybe Text)
- assertionAttributes_login :: Lens' AssertionAttributes (Maybe Text)
- assertionAttributes_name :: Lens' AssertionAttributes (Maybe Text)
- assertionAttributes_org :: Lens' AssertionAttributes (Maybe Text)
- assertionAttributes_role :: Lens' AssertionAttributes (Maybe Text)
- authenticationDescription_awsSso :: Lens' AuthenticationDescription (Maybe AwsSsoAuthentication)
- authenticationDescription_saml :: Lens' AuthenticationDescription (Maybe SamlAuthentication)
- authenticationDescription_providers :: Lens' AuthenticationDescription [AuthenticationProviderTypes]
- authenticationSummary_samlConfigurationStatus :: Lens' AuthenticationSummary (Maybe SamlConfigurationStatus)
- authenticationSummary_providers :: Lens' AuthenticationSummary [AuthenticationProviderTypes]
- awsSsoAuthentication_ssoClientId :: Lens' AwsSsoAuthentication (Maybe Text)
- idpMetadata_url :: Lens' IdpMetadata (Maybe Text)
- idpMetadata_xml :: Lens' IdpMetadata (Maybe Text)
- permissionEntry_role :: Lens' PermissionEntry Role
- permissionEntry_user :: Lens' PermissionEntry User
- roleValues_admin :: Lens' RoleValues (Maybe [Text])
- roleValues_editor :: Lens' RoleValues (Maybe [Text])
- samlAuthentication_configuration :: Lens' SamlAuthentication (Maybe SamlConfiguration)
- samlAuthentication_status :: Lens' SamlAuthentication SamlConfigurationStatus
- samlConfiguration_allowedOrganizations :: Lens' SamlConfiguration (Maybe [Text])
- samlConfiguration_assertionAttributes :: Lens' SamlConfiguration (Maybe AssertionAttributes)
- samlConfiguration_loginValidityDuration :: Lens' SamlConfiguration (Maybe Int)
- samlConfiguration_roleValues :: Lens' SamlConfiguration (Maybe RoleValues)
- samlConfiguration_idpMetadata :: Lens' SamlConfiguration IdpMetadata
- updateError_causedBy :: Lens' UpdateError UpdateInstruction
- updateError_code :: Lens' UpdateError Natural
- updateError_message :: Lens' UpdateError Text
- updateInstruction_action :: Lens' UpdateInstruction UpdateAction
- updateInstruction_role :: Lens' UpdateInstruction Role
- updateInstruction_users :: Lens' UpdateInstruction [User]
- user_id :: Lens' User Text
- user_type :: Lens' User UserType
- vpcConfiguration_securityGroupIds :: Lens' VpcConfiguration (NonEmpty Text)
- vpcConfiguration_subnetIds :: Lens' VpcConfiguration (NonEmpty Text)
- workspaceDescription_accountAccessType :: Lens' WorkspaceDescription (Maybe AccountAccessType)
- workspaceDescription_description :: Lens' WorkspaceDescription (Maybe Text)
- workspaceDescription_freeTrialConsumed :: Lens' WorkspaceDescription (Maybe Bool)
- workspaceDescription_freeTrialExpiration :: Lens' WorkspaceDescription (Maybe UTCTime)
- workspaceDescription_licenseExpiration :: Lens' WorkspaceDescription (Maybe UTCTime)
- workspaceDescription_licenseType :: Lens' WorkspaceDescription (Maybe LicenseType)
- workspaceDescription_name :: Lens' WorkspaceDescription (Maybe Text)
- workspaceDescription_notificationDestinations :: Lens' WorkspaceDescription (Maybe [NotificationDestinationType])
- workspaceDescription_organizationRoleName :: Lens' WorkspaceDescription (Maybe Text)
- workspaceDescription_organizationalUnits :: Lens' WorkspaceDescription (Maybe [Text])
- workspaceDescription_permissionType :: Lens' WorkspaceDescription (Maybe PermissionType)
- workspaceDescription_stackSetName :: Lens' WorkspaceDescription (Maybe Text)
- workspaceDescription_tags :: Lens' WorkspaceDescription (Maybe (HashMap Text Text))
- workspaceDescription_vpcConfiguration :: Lens' WorkspaceDescription (Maybe VpcConfiguration)
- workspaceDescription_workspaceRoleArn :: Lens' WorkspaceDescription (Maybe Text)
- workspaceDescription_authentication :: Lens' WorkspaceDescription AuthenticationSummary
- workspaceDescription_created :: Lens' WorkspaceDescription UTCTime
- workspaceDescription_dataSources :: Lens' WorkspaceDescription [DataSourceType]
- workspaceDescription_endpoint :: Lens' WorkspaceDescription Text
- workspaceDescription_grafanaVersion :: Lens' WorkspaceDescription Text
- workspaceDescription_id :: Lens' WorkspaceDescription Text
- workspaceDescription_modified :: Lens' WorkspaceDescription UTCTime
- workspaceDescription_status :: Lens' WorkspaceDescription WorkspaceStatus
- workspaceSummary_description :: Lens' WorkspaceSummary (Maybe Text)
- workspaceSummary_name :: Lens' WorkspaceSummary (Maybe Text)
- workspaceSummary_notificationDestinations :: Lens' WorkspaceSummary (Maybe [NotificationDestinationType])
- workspaceSummary_tags :: Lens' WorkspaceSummary (Maybe (HashMap Text Text))
- workspaceSummary_authentication :: Lens' WorkspaceSummary AuthenticationSummary
- workspaceSummary_created :: Lens' WorkspaceSummary UTCTime
- workspaceSummary_endpoint :: Lens' WorkspaceSummary Text
- workspaceSummary_grafanaVersion :: Lens' WorkspaceSummary Text
- workspaceSummary_id :: Lens' WorkspaceSummary Text
- workspaceSummary_modified :: Lens' WorkspaceSummary UTCTime
- workspaceSummary_status :: Lens' WorkspaceSummary WorkspaceStatus
Operations
AssociateLicense
associateLicense_licenseType :: Lens' AssociateLicense LicenseType Source #
The type of license to associate with the workspace.
associateLicense_workspaceId :: Lens' AssociateLicense Text Source #
The ID of the workspace to associate the license with.
associateLicenseResponse_httpStatus :: Lens' AssociateLicenseResponse Int Source #
The response's http status code.
associateLicenseResponse_workspace :: Lens' AssociateLicenseResponse WorkspaceDescription Source #
A structure containing data about the workspace.
CreateWorkspace
createWorkspace_clientToken :: Lens' CreateWorkspace (Maybe Text) Source #
A unique, case-sensitive, user-provided identifier to ensure the idempotency of the request.
createWorkspace_configuration :: Lens' CreateWorkspace (Maybe Text) Source #
The configuration string for the workspace that you create. For more information about the format and configuration options available, see Working in your Grafana workspace.
createWorkspace_organizationRoleName :: Lens' CreateWorkspace (Maybe Text) Source #
The name of an IAM role that already exists to use with Organizations to access Amazon Web Services data sources and notification channels in other accounts in an organization.
createWorkspace_stackSetName :: Lens' CreateWorkspace (Maybe Text) Source #
The name of the CloudFormation stack set to use to generate IAM roles to be used for this workspace.
createWorkspace_tags :: Lens' CreateWorkspace (Maybe (HashMap Text Text)) Source #
The list of tags associated with the workspace.
createWorkspace_vpcConfiguration :: Lens' CreateWorkspace (Maybe VpcConfiguration) Source #
The configuration settings for an Amazon VPC that contains data sources for your Grafana workspace to connect to.
createWorkspace_workspaceDataSources :: Lens' CreateWorkspace (Maybe [DataSourceType]) Source #
Specify the Amazon Web Services data sources that you want to be queried in this workspace. Specifying these data sources here enables Amazon Managed Grafana to create IAM roles and permissions that allow Amazon Managed Grafana to read data from these sources. You must still add them as data sources in the Grafana console in the workspace.
If you don't specify a data source here, you can still add it as a data source in the workspace console later. However, you will then have to manually configure permissions for it.
createWorkspace_workspaceDescription :: Lens' CreateWorkspace (Maybe Text) Source #
A description for the workspace. This is used only to help you identify this workspace.
Pattern: ^[\\p{L}\\p{Z}\\p{N}\\p{P}]{0,2048}$
createWorkspace_workspaceName :: Lens' CreateWorkspace (Maybe Text) Source #
The name for the workspace. It does not have to be unique.
createWorkspace_workspaceNotificationDestinations :: Lens' CreateWorkspace (Maybe [NotificationDestinationType]) Source #
Specify the Amazon Web Services notification channels that you plan to use in this workspace. Specifying these data sources here enables Amazon Managed Grafana to create IAM roles and permissions that allow Amazon Managed Grafana to use these channels.
createWorkspace_workspaceOrganizationalUnits :: Lens' CreateWorkspace (Maybe [Text]) Source #
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.
createWorkspace_workspaceRoleArn :: Lens' CreateWorkspace (Maybe Text) Source #
The workspace needs an IAM role that grants permissions to the Amazon
Web Services resources that the workspace will view data from. If you
already have a role that you want to use, specify it here. The
permission type should be set to CUSTOMER_MANAGED
.
createWorkspace_accountAccessType :: Lens' CreateWorkspace AccountAccessType Source #
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 you specify ORGANIZATION
, you must specify which
organizational units the workspace can access in the
workspaceOrganizationalUnits
parameter.
createWorkspace_authenticationProviders :: Lens' CreateWorkspace [AuthenticationProviderTypes] Source #
Specifies whether this workspace uses SAML 2.0, IAM Identity Center (successor to Single Sign-On), or both to authenticate users for using the Grafana console within a workspace. For more information, see User authentication in Amazon Managed Grafana.
createWorkspace_permissionType :: Lens' CreateWorkspace PermissionType Source #
If you specify SERVICE_MANAGED
on AWS Grafana console, 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. In the CLI mode, the permissionType
SERVICE_MANAGED
will not create the IAM role for you. The ability for
the Amazon Managed Grafana to create the IAM role on behalf of the user
is supported only in the Amazon Managed Grafana AWS console. Use only
the CUSTOMER_MANAGED
permission type when creating a workspace in the
CLI.
If you specify CUSTOMER_MANAGED
, you will manage those roles and
permissions yourself. If you are creating this workspace in a member
account of an organization that is not a delegated administrator
account, and you want the workspace to access data sources in other
Amazon Web Services accounts in the organization, you must choose
CUSTOMER_MANAGED
.
For more information, see Amazon Managed Grafana permissions and policies for Amazon Web Services data sources and notification channels.
createWorkspaceResponse_httpStatus :: Lens' CreateWorkspaceResponse Int Source #
The response's http status code.
createWorkspaceResponse_workspace :: Lens' CreateWorkspaceResponse WorkspaceDescription Source #
A structure containing data about the workspace that was created.
CreateWorkspaceApiKey
createWorkspaceApiKey_keyName :: Lens' CreateWorkspaceApiKey Text Source #
Specifies the name of the key. Keynames must be unique to the workspace.
createWorkspaceApiKey_keyRole :: Lens' CreateWorkspaceApiKey Text Source #
Specifies the permission level of the key.
Valid values: VIEWER
|EDITOR
|ADMIN
createWorkspaceApiKey_secondsToLive :: Lens' CreateWorkspaceApiKey Natural Source #
Specifies the time in seconds until the key expires. Keys can be valid for up to 30 days.
createWorkspaceApiKey_workspaceId :: Lens' CreateWorkspaceApiKey Text Source #
The ID of the workspace to create an API key.
createWorkspaceApiKeyResponse_httpStatus :: Lens' CreateWorkspaceApiKeyResponse Int Source #
The response's http status code.
createWorkspaceApiKeyResponse_key :: Lens' CreateWorkspaceApiKeyResponse Text Source #
The key token. Use this value as a bearer token to authenticate HTTP requests to the workspace.
createWorkspaceApiKeyResponse_keyName :: Lens' CreateWorkspaceApiKeyResponse Text Source #
The name of the key that was created.
createWorkspaceApiKeyResponse_workspaceId :: Lens' CreateWorkspaceApiKeyResponse Text Source #
The ID of the workspace that the key is valid for.
DeleteWorkspace
deleteWorkspace_workspaceId :: Lens' DeleteWorkspace Text Source #
The ID of the workspace to delete.
deleteWorkspaceResponse_httpStatus :: Lens' DeleteWorkspaceResponse Int Source #
The response's http status code.
deleteWorkspaceResponse_workspace :: Lens' DeleteWorkspaceResponse WorkspaceDescription Source #
A structure containing information about the workspace that was deleted.
DeleteWorkspaceApiKey
deleteWorkspaceApiKey_keyName :: Lens' DeleteWorkspaceApiKey Text Source #
The name of the API key to delete.
deleteWorkspaceApiKey_workspaceId :: Lens' DeleteWorkspaceApiKey Text Source #
The ID of the workspace to delete.
deleteWorkspaceApiKeyResponse_httpStatus :: Lens' DeleteWorkspaceApiKeyResponse Int Source #
The response's http status code.
deleteWorkspaceApiKeyResponse_keyName :: Lens' DeleteWorkspaceApiKeyResponse Text Source #
The name of the key that was deleted.
deleteWorkspaceApiKeyResponse_workspaceId :: Lens' DeleteWorkspaceApiKeyResponse Text Source #
The ID of the workspace where the key was deleted.
DescribeWorkspace
describeWorkspace_workspaceId :: Lens' DescribeWorkspace Text Source #
The ID of the workspace to display information about.
describeWorkspaceResponse_httpStatus :: Lens' DescribeWorkspaceResponse Int Source #
The response's http status code.
describeWorkspaceResponse_workspace :: Lens' DescribeWorkspaceResponse WorkspaceDescription Source #
A structure containing information about the workspace.
DescribeWorkspaceAuthentication
describeWorkspaceAuthentication_workspaceId :: Lens' DescribeWorkspaceAuthentication Text Source #
The ID of the workspace to return authentication information about.
describeWorkspaceAuthenticationResponse_httpStatus :: Lens' DescribeWorkspaceAuthenticationResponse Int Source #
The response's http status code.
describeWorkspaceAuthenticationResponse_authentication :: Lens' DescribeWorkspaceAuthenticationResponse AuthenticationDescription Source #
A structure containing information about the authentication methods used in the workspace.
DescribeWorkspaceConfiguration
describeWorkspaceConfiguration_workspaceId :: Lens' DescribeWorkspaceConfiguration Text Source #
The ID of the workspace to get configuration information for.
describeWorkspaceConfigurationResponse_httpStatus :: Lens' DescribeWorkspaceConfigurationResponse Int Source #
The response's http status code.
describeWorkspaceConfigurationResponse_configuration :: Lens' DescribeWorkspaceConfigurationResponse Text Source #
The configuration string for the workspace that you requested. For more information about the format and configuration options available, see Working in your Grafana workspace.
DisassociateLicense
disassociateLicense_licenseType :: Lens' DisassociateLicense LicenseType Source #
The type of license to remove from the workspace.
disassociateLicense_workspaceId :: Lens' DisassociateLicense Text Source #
The ID of the workspace to remove the Grafana Enterprise license from.
disassociateLicenseResponse_httpStatus :: Lens' DisassociateLicenseResponse Int Source #
The response's http status code.
disassociateLicenseResponse_workspace :: Lens' DisassociateLicenseResponse WorkspaceDescription Source #
A structure containing information about the workspace.
ListPermissions
listPermissions_groupId :: Lens' ListPermissions (Maybe Text) Source #
(Optional) Limits the results to only the group that matches this ID.
listPermissions_maxResults :: Lens' ListPermissions (Maybe Natural) Source #
The maximum number of results to include in the response.
listPermissions_nextToken :: Lens' ListPermissions (Maybe Text) Source #
The token to use when requesting the next set of results. You received
this token from a previous ListPermissions
operation.
listPermissions_userId :: Lens' ListPermissions (Maybe Text) Source #
(Optional) Limits the results to only the user that matches this ID.
listPermissions_userType :: Lens' ListPermissions (Maybe UserType) Source #
(Optional) If you specify SSO_USER
, then only the permissions of IAM
Identity Center users are returned. If you specify SSO_GROUP
, only the
permissions of IAM Identity Center groups are returned.
listPermissions_workspaceId :: Lens' ListPermissions Text Source #
The ID of the workspace to list permissions for. This parameter is required.
listPermissionsResponse_nextToken :: Lens' ListPermissionsResponse (Maybe Text) Source #
The token to use in a subsequent ListPermissions
operation to return
the next set of results.
listPermissionsResponse_httpStatus :: Lens' ListPermissionsResponse Int Source #
The response's http status code.
listPermissionsResponse_permissions :: Lens' ListPermissionsResponse [PermissionEntry] Source #
The permissions returned by the operation.
ListTagsForResource
listTagsForResource_resourceArn :: Lens' ListTagsForResource Text Source #
The ARN of the resource the list of tags are associated with.
listTagsForResourceResponse_tags :: Lens' ListTagsForResourceResponse (Maybe (HashMap Text Text)) Source #
The list of tags that are associated with the resource.
listTagsForResourceResponse_httpStatus :: Lens' ListTagsForResourceResponse Int Source #
The response's http status code.
ListWorkspaces
listWorkspaces_maxResults :: Lens' ListWorkspaces (Maybe Natural) Source #
The maximum number of workspaces to include in the results.
listWorkspaces_nextToken :: Lens' ListWorkspaces (Maybe Text) Source #
The token for the next set of workspaces to return. (You receive this
token from a previous ListWorkspaces
operation.)
listWorkspacesResponse_nextToken :: Lens' ListWorkspacesResponse (Maybe Text) Source #
The token to use when requesting the next set of workspaces.
listWorkspacesResponse_httpStatus :: Lens' ListWorkspacesResponse Int Source #
The response's http status code.
listWorkspacesResponse_workspaces :: Lens' ListWorkspacesResponse [WorkspaceSummary] Source #
An array of structures that contain some information about the workspaces in the account.
TagResource
tagResource_resourceArn :: Lens' TagResource Text Source #
The ARN of the resource the tag is associated with.
tagResource_tags :: Lens' TagResource (HashMap Text Text) Source #
The list of tag keys and values to associate with the resource. You can associate tag keys only, tags (key and values) only or a combination of tag keys and tags.
tagResourceResponse_httpStatus :: Lens' TagResourceResponse Int Source #
The response's http status code.
UntagResource
untagResource_resourceArn :: Lens' UntagResource Text Source #
The ARN of the resource the tag association is removed from.
untagResource_tagKeys :: Lens' UntagResource [Text] Source #
The key values of the tag to be removed from the resource.
untagResourceResponse_httpStatus :: Lens' UntagResourceResponse Int Source #
The response's http status code.
UpdatePermissions
updatePermissions_updateInstructionBatch :: Lens' UpdatePermissions [UpdateInstruction] Source #
An array of structures that contain the permission updates to make.
updatePermissions_workspaceId :: Lens' UpdatePermissions Text Source #
The ID of the workspace to update.
updatePermissionsResponse_httpStatus :: Lens' UpdatePermissionsResponse Int Source #
The response's http status code.
updatePermissionsResponse_errors :: Lens' UpdatePermissionsResponse [UpdateError] Source #
An array of structures that contain the errors from the operation, if any.
UpdateWorkspace
updateWorkspace_accountAccessType :: Lens' UpdateWorkspace (Maybe AccountAccessType) Source #
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 you specify ORGANIZATION
, you must specify which
organizational units the workspace can access in the
workspaceOrganizationalUnits
parameter.
updateWorkspace_organizationRoleName :: Lens' UpdateWorkspace (Maybe Text) Source #
The name of an IAM role that already exists to use to access resources through Organizations.
updateWorkspace_permissionType :: Lens' UpdateWorkspace (Maybe PermissionType) Source #
If you specify Service Managed
, 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 you specify CUSTOMER_MANAGED
, you will manage those roles and
permissions yourself. If you are creating this 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, you must
choose CUSTOMER_MANAGED
.
For more information, see Amazon Managed Grafana permissions and policies for Amazon Web Services data sources and notification channels
updateWorkspace_removeVpcConfiguration :: Lens' UpdateWorkspace (Maybe Bool) Source #
Whether to remove the VPC configuration from the workspace.
Setting this to true
and providing a vpcConfiguration
to set will
return an error.
updateWorkspace_stackSetName :: Lens' UpdateWorkspace (Maybe Text) Source #
The name of the CloudFormation stack set to use to generate IAM roles to be used for this workspace.
updateWorkspace_vpcConfiguration :: Lens' UpdateWorkspace (Maybe VpcConfiguration) Source #
The configuration settings for an Amazon VPC that contains data sources for your Grafana workspace to connect to.
updateWorkspace_workspaceDataSources :: Lens' UpdateWorkspace (Maybe [DataSourceType]) Source #
Specify the Amazon Web Services data sources that you want to be queried in this workspace. Specifying these data sources here enables Amazon Managed Grafana to create IAM roles and permissions that allow Amazon Managed Grafana to read data from these sources. You must still add them as data sources in the Grafana console in the workspace.
If you don't specify a data source here, you can still add it as a data source later in the workspace console. However, you will then have to manually configure permissions for it.
updateWorkspace_workspaceDescription :: Lens' UpdateWorkspace (Maybe Text) Source #
A description for the workspace. This is used only to help you identify this workspace.
updateWorkspace_workspaceName :: Lens' UpdateWorkspace (Maybe Text) Source #
A new name for the workspace to update.
updateWorkspace_workspaceNotificationDestinations :: Lens' UpdateWorkspace (Maybe [NotificationDestinationType]) Source #
Specify the Amazon Web Services notification channels that you plan to use in this workspace. Specifying these data sources here enables Amazon Managed Grafana to create IAM roles and permissions that allow Amazon Managed Grafana to use these channels.
updateWorkspace_workspaceOrganizationalUnits :: Lens' UpdateWorkspace (Maybe [Text]) Source #
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.
updateWorkspace_workspaceRoleArn :: Lens' UpdateWorkspace (Maybe Text) Source #
The workspace needs an IAM role that grants permissions to the Amazon
Web Services resources that the workspace will view data from. If you
already have a role that you want to use, specify it here. If you omit
this field and you specify some Amazon Web Services resources in
workspaceDataSources
or workspaceNotificationDestinations
, a new IAM
role with the necessary permissions is automatically created.
updateWorkspace_workspaceId :: Lens' UpdateWorkspace Text Source #
The ID of the workspace to update.
updateWorkspaceResponse_httpStatus :: Lens' UpdateWorkspaceResponse Int Source #
The response's http status code.
updateWorkspaceResponse_workspace :: Lens' UpdateWorkspaceResponse WorkspaceDescription Source #
A structure containing data about the workspace that was created.
UpdateWorkspaceAuthentication
updateWorkspaceAuthentication_samlConfiguration :: Lens' UpdateWorkspaceAuthentication (Maybe SamlConfiguration) Source #
If the workspace uses SAML, use this structure to map SAML assertion
attributes to workspace user information and define which groups in the
assertion attribute are to have the Admin
and Editor
roles in the
workspace.
updateWorkspaceAuthentication_authenticationProviders :: Lens' UpdateWorkspaceAuthentication [AuthenticationProviderTypes] Source #
Specifies whether this workspace uses SAML 2.0, IAM Identity Center (successor to Single Sign-On), or both to authenticate users for using the Grafana console within a workspace. For more information, see User authentication in Amazon Managed Grafana.
updateWorkspaceAuthentication_workspaceId :: Lens' UpdateWorkspaceAuthentication Text Source #
The ID of the workspace to update the authentication for.
updateWorkspaceAuthenticationResponse_httpStatus :: Lens' UpdateWorkspaceAuthenticationResponse Int Source #
The response's http status code.
updateWorkspaceAuthenticationResponse_authentication :: Lens' UpdateWorkspaceAuthenticationResponse AuthenticationDescription Source #
A structure that describes the user authentication for this workspace after the update is made.
UpdateWorkspaceConfiguration
updateWorkspaceConfiguration_configuration :: Lens' UpdateWorkspaceConfiguration Text Source #
The new configuration string for the workspace. For more information about the format and configuration options available, see Working in your Grafana workspace.
updateWorkspaceConfiguration_workspaceId :: Lens' UpdateWorkspaceConfiguration Text Source #
The ID of the workspace to update.
updateWorkspaceConfigurationResponse_httpStatus :: Lens' UpdateWorkspaceConfigurationResponse Int Source #
The response's http status code.
Types
AssertionAttributes
assertionAttributes_email :: Lens' AssertionAttributes (Maybe Text) Source #
The name of the attribute within the SAML assertion to use as the email names for SAML users.
assertionAttributes_groups :: Lens' AssertionAttributes (Maybe Text) Source #
The name of the attribute within the SAML assertion to use as the user full "friendly" names for user groups.
assertionAttributes_login :: Lens' AssertionAttributes (Maybe Text) Source #
The name of the attribute within the SAML assertion to use as the login names for SAML users.
assertionAttributes_name :: Lens' AssertionAttributes (Maybe Text) Source #
The name of the attribute within the SAML assertion to use as the user full "friendly" names for SAML users.
assertionAttributes_org :: Lens' AssertionAttributes (Maybe Text) Source #
The name of the attribute within the SAML assertion to use as the user full "friendly" names for the users' organizations.
assertionAttributes_role :: Lens' AssertionAttributes (Maybe Text) Source #
The name of the attribute within the SAML assertion to use as the user roles.
AuthenticationDescription
authenticationDescription_awsSso :: Lens' AuthenticationDescription (Maybe AwsSsoAuthentication) Source #
A structure containing information about how this workspace works with IAM Identity Center.
authenticationDescription_saml :: Lens' AuthenticationDescription (Maybe SamlAuthentication) Source #
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.
authenticationDescription_providers :: Lens' AuthenticationDescription [AuthenticationProviderTypes] Source #
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.
AuthenticationSummary
authenticationSummary_samlConfigurationStatus :: Lens' AuthenticationSummary (Maybe SamlConfigurationStatus) Source #
Specifies whether the workplace's user authentication method is fully configured.
authenticationSummary_providers :: Lens' AuthenticationSummary [AuthenticationProviderTypes] Source #
Specifies whether the workspace uses SAML, IAM Identity Center, or both methods for user authentication.
AwsSsoAuthentication
awsSsoAuthentication_ssoClientId :: Lens' AwsSsoAuthentication (Maybe Text) Source #
The ID of the IAM Identity Center-managed application that is created by Amazon Managed Grafana.
IdpMetadata
idpMetadata_url :: Lens' IdpMetadata (Maybe Text) Source #
The URL of the location containing the IdP metadata.
idpMetadata_xml :: Lens' IdpMetadata (Maybe Text) Source #
The full IdP metadata, in XML format.
PermissionEntry
permissionEntry_role :: Lens' PermissionEntry Role Source #
Specifies whether the user or group has the Admin
, Editor
, or
Viewer
role.
permissionEntry_user :: Lens' PermissionEntry User Source #
A structure with the ID of the user or group with this role.
RoleValues
roleValues_admin :: Lens' RoleValues (Maybe [Text]) Source #
A list of groups from the SAML assertion attribute to grant the Grafana
Admin
role to.
roleValues_editor :: Lens' RoleValues (Maybe [Text]) Source #
A list of groups from the SAML assertion attribute to grant the Grafana
Editor
role to.
SamlAuthentication
samlAuthentication_configuration :: Lens' SamlAuthentication (Maybe SamlConfiguration) Source #
A structure containing details about how this workspace works with SAML.
samlAuthentication_status :: Lens' SamlAuthentication SamlConfigurationStatus Source #
Specifies whether the workspace's SAML configuration is complete.
SamlConfiguration
samlConfiguration_allowedOrganizations :: Lens' SamlConfiguration (Maybe [Text]) Source #
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.
samlConfiguration_assertionAttributes :: Lens' SamlConfiguration (Maybe AssertionAttributes) Source #
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.
samlConfiguration_loginValidityDuration :: Lens' SamlConfiguration (Maybe Int) Source #
How long a sign-on session by a SAML user is valid, before the user has to sign on again.
samlConfiguration_roleValues :: Lens' SamlConfiguration (Maybe RoleValues) Source #
A structure containing arrays that map group names in the SAML assertion
to the Grafana Admin
and Editor
roles in the workspace.
samlConfiguration_idpMetadata :: Lens' SamlConfiguration IdpMetadata Source #
A structure containing the identity provider (IdP) metadata used to integrate the identity provider with this workspace.
UpdateError
updateError_causedBy :: Lens' UpdateError UpdateInstruction Source #
Specifies which permission update caused the error.
updateError_code :: Lens' UpdateError Natural Source #
The error code.
updateError_message :: Lens' UpdateError Text Source #
The message for this error.
UpdateInstruction
updateInstruction_action :: Lens' UpdateInstruction UpdateAction Source #
Specifies whether this update is to add or revoke role permissions.
updateInstruction_role :: Lens' UpdateInstruction Role Source #
The role to add or revoke for the user or the group specified in
users
.
updateInstruction_users :: Lens' UpdateInstruction [User] Source #
A structure that specifies the user or group to add or revoke the role for.
User
user_id :: Lens' User Text Source #
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}$
VpcConfiguration
vpcConfiguration_securityGroupIds :: Lens' VpcConfiguration (NonEmpty Text) Source #
The list of Amazon EC2 security group IDs attached to the Amazon VPC for your Grafana workspace to connect.
vpcConfiguration_subnetIds :: Lens' VpcConfiguration (NonEmpty Text) Source #
The list of Amazon EC2 subnet IDs created in the Amazon VPC for your Grafana workspace to connect.
WorkspaceDescription
workspaceDescription_accountAccessType :: Lens' WorkspaceDescription (Maybe AccountAccessType) Source #
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.
workspaceDescription_description :: Lens' WorkspaceDescription (Maybe Text) Source #
The user-defined description of the workspace.
workspaceDescription_freeTrialConsumed :: Lens' WorkspaceDescription (Maybe Bool) Source #
Specifies whether this workspace has already fully used its free trial for Grafana Enterprise.
workspaceDescription_freeTrialExpiration :: Lens' WorkspaceDescription (Maybe UTCTime) Source #
If this workspace is currently in the free trial period for Grafana Enterprise, this value specifies when that free trial ends.
workspaceDescription_licenseExpiration :: Lens' WorkspaceDescription (Maybe UTCTime) Source #
If this workspace has a full Grafana Enterprise license, this specifies when the license ends and will need to be renewed.
workspaceDescription_licenseType :: Lens' WorkspaceDescription (Maybe LicenseType) Source #
Specifies whether this workspace has a full Grafana Enterprise license or a free trial license.
workspaceDescription_name :: Lens' WorkspaceDescription (Maybe Text) Source #
The name of the workspace.
workspaceDescription_notificationDestinations :: Lens' WorkspaceDescription (Maybe [NotificationDestinationType]) Source #
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.
workspaceDescription_organizationRoleName :: Lens' WorkspaceDescription (Maybe Text) Source #
The name of the IAM role that is used to access resources through Organizations.
workspaceDescription_organizationalUnits :: Lens' WorkspaceDescription (Maybe [Text]) Source #
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.
workspaceDescription_permissionType :: Lens' WorkspaceDescription (Maybe PermissionType) Source #
If this is Service Managed
, 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 manage those roles and permissions
yourself. If you are creating this 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, you must choose
CUSTOMER_MANAGED
.
For more information, see Amazon Managed Grafana permissions and policies for Amazon Web Services data sources and notification channels
workspaceDescription_stackSetName :: Lens' WorkspaceDescription (Maybe Text) Source #
The name of the CloudFormation stack set that is used to generate IAM roles to be used for this workspace.
workspaceDescription_tags :: Lens' WorkspaceDescription (Maybe (HashMap Text Text)) Source #
The list of tags associated with the workspace.
workspaceDescription_vpcConfiguration :: Lens' WorkspaceDescription (Maybe VpcConfiguration) Source #
The configuration for connecting to data sources in a private VPC (Amazon Virtual Private Cloud).
workspaceDescription_workspaceRoleArn :: Lens' WorkspaceDescription (Maybe Text) Source #
The IAM role that grants permissions to the Amazon Web Services resources that the workspace will view data from. This role must already exist.
workspaceDescription_authentication :: Lens' WorkspaceDescription AuthenticationSummary Source #
A structure that describes whether the workspace uses SAML, IAM Identity Center, or both methods for user authentication.
workspaceDescription_created :: Lens' WorkspaceDescription UTCTime Source #
The date that the workspace was created.
workspaceDescription_dataSources :: Lens' WorkspaceDescription [DataSourceType] Source #
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.
workspaceDescription_endpoint :: Lens' WorkspaceDescription Text Source #
The URL that users can use to access the Grafana console in the workspace.
workspaceDescription_grafanaVersion :: Lens' WorkspaceDescription Text Source #
The version of Grafana supported in this workspace.
workspaceDescription_id :: Lens' WorkspaceDescription Text Source #
The unique ID of this workspace.
workspaceDescription_modified :: Lens' WorkspaceDescription UTCTime Source #
The most recent date that the workspace was modified.
workspaceDescription_status :: Lens' WorkspaceDescription WorkspaceStatus Source #
The current status of the workspace.
WorkspaceSummary
workspaceSummary_description :: Lens' WorkspaceSummary (Maybe Text) Source #
The customer-entered description of the workspace.
workspaceSummary_name :: Lens' WorkspaceSummary (Maybe Text) Source #
The name of the workspace.
workspaceSummary_notificationDestinations :: Lens' WorkspaceSummary (Maybe [NotificationDestinationType]) Source #
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.
workspaceSummary_tags :: Lens' WorkspaceSummary (Maybe (HashMap Text Text)) Source #
The list of tags associated with the workspace.
workspaceSummary_authentication :: Lens' WorkspaceSummary AuthenticationSummary Source #
A structure containing information about the authentication methods used in the workspace.
workspaceSummary_created :: Lens' WorkspaceSummary UTCTime Source #
The date that the workspace was created.
workspaceSummary_endpoint :: Lens' WorkspaceSummary Text Source #
The URL endpoint to use to access the Grafana console in the workspace.
workspaceSummary_grafanaVersion :: Lens' WorkspaceSummary Text Source #
The Grafana version that the workspace is running.
workspaceSummary_id :: Lens' WorkspaceSummary Text Source #
The unique ID of the workspace.
workspaceSummary_modified :: Lens' WorkspaceSummary UTCTime Source #
The most recent date that the workspace was modified.
workspaceSummary_status :: Lens' WorkspaceSummary WorkspaceStatus Source #
The current status of the workspace.