@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AbstractAmazonManagedGrafana extends Object implements AmazonManagedGrafana
AmazonManagedGrafana
. Convenient method forms pass through to the corresponding
overload that takes a request object, which throws an UnsupportedOperationException
.ENDPOINT_PREFIX
Modifier and Type | Method and Description |
---|---|
AssociateLicenseResult |
associateLicense(AssociateLicenseRequest request)
Assigns a Grafana Enterprise license to a workspace.
|
CreateWorkspaceResult |
createWorkspace(CreateWorkspaceRequest request)
Creates a workspace.
|
CreateWorkspaceApiKeyResult |
createWorkspaceApiKey(CreateWorkspaceApiKeyRequest request)
Creates a Grafana API key for the workspace.
|
CreateWorkspaceServiceAccountResult |
createWorkspaceServiceAccount(CreateWorkspaceServiceAccountRequest request)
Creates a service account for the workspace.
|
CreateWorkspaceServiceAccountTokenResult |
createWorkspaceServiceAccountToken(CreateWorkspaceServiceAccountTokenRequest request)
Creates a token that can be used to authenticate and authorize Grafana HTTP API operations for the given workspace service account.
|
DeleteWorkspaceResult |
deleteWorkspace(DeleteWorkspaceRequest request)
Deletes an Amazon Managed Grafana workspace.
|
DeleteWorkspaceApiKeyResult |
deleteWorkspaceApiKey(DeleteWorkspaceApiKeyRequest request)
Deletes a Grafana API key for the workspace.
|
DeleteWorkspaceServiceAccountResult |
deleteWorkspaceServiceAccount(DeleteWorkspaceServiceAccountRequest request)
Deletes a workspace service account from the workspace.
|
DeleteWorkspaceServiceAccountTokenResult |
deleteWorkspaceServiceAccountToken(DeleteWorkspaceServiceAccountTokenRequest request)
Deletes a token for the workspace service account.
|
DescribeWorkspaceResult |
describeWorkspace(DescribeWorkspaceRequest request)
Displays information about one Amazon Managed Grafana workspace.
|
DescribeWorkspaceAuthenticationResult |
describeWorkspaceAuthentication(DescribeWorkspaceAuthenticationRequest request)
Displays information about the authentication methods used in one Amazon Managed Grafana workspace.
|
DescribeWorkspaceConfigurationResult |
describeWorkspaceConfiguration(DescribeWorkspaceConfigurationRequest request)
Gets the current configuration string for the given workspace.
|
DisassociateLicenseResult |
disassociateLicense(DisassociateLicenseRequest request)
Removes the Grafana Enterprise license from a workspace.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
ListPermissionsResult |
listPermissions(ListPermissionsRequest request)
Lists the users and groups who have the Grafana
Admin and Editor roles in this
workspace. |
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest request)
The
ListTagsForResource operation returns the tags that are associated with the Amazon Managed
Service for Grafana resource specified by the resourceArn . |
ListVersionsResult |
listVersions(ListVersionsRequest request)
Lists available versions of Grafana.
|
ListWorkspacesResult |
listWorkspaces(ListWorkspacesRequest request)
Returns a list of Amazon Managed Grafana workspaces in the account, with some information about each workspace.
|
ListWorkspaceServiceAccountsResult |
listWorkspaceServiceAccounts(ListWorkspaceServiceAccountsRequest request)
Returns a list of service accounts for a workspace.
|
ListWorkspaceServiceAccountTokensResult |
listWorkspaceServiceAccountTokens(ListWorkspaceServiceAccountTokensRequest request)
Returns a list of tokens for a workspace service account.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
TagResourceResult |
tagResource(TagResourceRequest request)
The
TagResource operation associates tags with an Amazon Managed Grafana resource. |
UntagResourceResult |
untagResource(UntagResourceRequest request)
The
UntagResource operation removes the association of the tag with the Amazon Managed Grafana
resource. |
UpdatePermissionsResult |
updatePermissions(UpdatePermissionsRequest request)
Updates which users in a workspace have the Grafana
Admin or Editor roles. |
UpdateWorkspaceResult |
updateWorkspace(UpdateWorkspaceRequest request)
Modifies an existing Amazon Managed Grafana workspace.
|
UpdateWorkspaceAuthenticationResult |
updateWorkspaceAuthentication(UpdateWorkspaceAuthenticationRequest request)
Use this operation to define the identity provider (IdP) that this workspace authenticates users from, using
SAML.
|
UpdateWorkspaceConfigurationResult |
updateWorkspaceConfiguration(UpdateWorkspaceConfigurationRequest request)
Updates the configuration string for the given workspace
|
public AssociateLicenseResult associateLicense(AssociateLicenseRequest request)
AmazonManagedGrafana
Assigns a Grafana Enterprise license to a workspace. To upgrade, you must use ENTERPRISE
for the
licenseType
, and pass in a valid Grafana Labs token for the grafanaToken
. Upgrading to
Grafana Enterprise incurs additional fees. For more information, see Upgrade a
workspace to Grafana Enterprise.
associateLicense
in interface AmazonManagedGrafana
public CreateWorkspaceResult createWorkspace(CreateWorkspaceRequest request)
AmazonManagedGrafana
Creates a workspace. In a workspace, you can create Grafana dashboards and visualizations to analyze your metrics, logs, and traces. You don't have to build, package, or deploy any hardware to run the Grafana server.
Don't use CreateWorkspace
to modify an existing workspace. Instead, use UpdateWorkspace.
createWorkspace
in interface AmazonManagedGrafana
public CreateWorkspaceApiKeyResult createWorkspaceApiKey(CreateWorkspaceApiKeyRequest request)
AmazonManagedGrafana
Creates a Grafana API key for the workspace. This key can be used to authenticate requests sent to the workspace's HTTP API. See https ://docs.aws.amazon.com/grafana/latest/userguide/Using-Grafana-APIs.html for available APIs and example requests.
In workspaces compatible with Grafana version 9 or above, use workspace service accounts instead of API keys. API keys will be removed in a future release.
createWorkspaceApiKey
in interface AmazonManagedGrafana
public CreateWorkspaceServiceAccountResult createWorkspaceServiceAccount(CreateWorkspaceServiceAccountRequest request)
AmazonManagedGrafana
Creates a service account for the workspace. A service account can be used to call Grafana HTTP APIs, and run
automated workloads. After creating the service account with the correct GrafanaRole
for your use
case, use CreateWorkspaceServiceAccountToken
to create a token that can be used to authenticate and
authorize Grafana HTTP API calls.
You can only create service accounts for workspaces that are compatible with Grafana version 9 and above.
For more information about service accounts, see Service accounts in the Amazon Managed Grafana User Guide.
For more information about the Grafana HTTP APIs, see Using Grafana HTTP APIs in the Amazon Managed Grafana User Guide.
createWorkspaceServiceAccount
in interface AmazonManagedGrafana
public CreateWorkspaceServiceAccountTokenResult createWorkspaceServiceAccountToken(CreateWorkspaceServiceAccountTokenRequest request)
AmazonManagedGrafana
Creates a token that can be used to authenticate and authorize Grafana HTTP API operations for the given workspace service account. The service account acts as a user for the API operations, and defines the permissions that are used by the API.
When you create the service account token, you will receive a key that is used when calling Grafana APIs. Do not lose this key, as it will not be retrievable again.
If you do lose the key, you can delete the token and recreate it to receive a new key. This will disable the initial key.
Service accounts are only available for workspaces that are compatible with Grafana version 9 and above.
createWorkspaceServiceAccountToken
in interface AmazonManagedGrafana
public DeleteWorkspaceResult deleteWorkspace(DeleteWorkspaceRequest request)
AmazonManagedGrafana
Deletes an Amazon Managed Grafana workspace.
deleteWorkspace
in interface AmazonManagedGrafana
public DeleteWorkspaceApiKeyResult deleteWorkspaceApiKey(DeleteWorkspaceApiKeyRequest request)
AmazonManagedGrafana
Deletes a Grafana API key for the workspace.
In workspaces compatible with Grafana version 9 or above, use workspace service accounts instead of API keys. API keys will be removed in a future release.
deleteWorkspaceApiKey
in interface AmazonManagedGrafana
public DeleteWorkspaceServiceAccountResult deleteWorkspaceServiceAccount(DeleteWorkspaceServiceAccountRequest request)
AmazonManagedGrafana
Deletes a workspace service account from the workspace.
This will delete any tokens created for the service account, as well. If the tokens are currently in use, the will fail to authenticate / authorize after they are deleted.
Service accounts are only available for workspaces that are compatible with Grafana version 9 and above.
deleteWorkspaceServiceAccount
in interface AmazonManagedGrafana
public DeleteWorkspaceServiceAccountTokenResult deleteWorkspaceServiceAccountToken(DeleteWorkspaceServiceAccountTokenRequest request)
AmazonManagedGrafana
Deletes a token for the workspace service account.
This will disable the key associated with the token. If any automation is currently using the key, it will no longer be authenticated or authorized to perform actions with the Grafana HTTP APIs.
Service accounts are only available for workspaces that are compatible with Grafana version 9 and above.
deleteWorkspaceServiceAccountToken
in interface AmazonManagedGrafana
public DescribeWorkspaceResult describeWorkspace(DescribeWorkspaceRequest request)
AmazonManagedGrafana
Displays information about one Amazon Managed Grafana workspace.
describeWorkspace
in interface AmazonManagedGrafana
public DescribeWorkspaceAuthenticationResult describeWorkspaceAuthentication(DescribeWorkspaceAuthenticationRequest request)
AmazonManagedGrafana
Displays information about the authentication methods used in one Amazon Managed Grafana workspace.
describeWorkspaceAuthentication
in interface AmazonManagedGrafana
public DescribeWorkspaceConfigurationResult describeWorkspaceConfiguration(DescribeWorkspaceConfigurationRequest request)
AmazonManagedGrafana
Gets the current configuration string for the given workspace.
describeWorkspaceConfiguration
in interface AmazonManagedGrafana
public DisassociateLicenseResult disassociateLicense(DisassociateLicenseRequest request)
AmazonManagedGrafana
Removes the Grafana Enterprise license from a workspace.
disassociateLicense
in interface AmazonManagedGrafana
public ListPermissionsResult listPermissions(ListPermissionsRequest request)
AmazonManagedGrafana
Lists the users and groups who have the Grafana Admin
and Editor
roles in this
workspace. If you use this operation without specifying userId
or groupId
, the
operation returns the roles of all users and groups. If you specify a userId
or a
groupId
, only the roles for that user or group are returned. If you do this, you can specify only
one userId
or one groupId
.
listPermissions
in interface AmazonManagedGrafana
public ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest request)
AmazonManagedGrafana
The ListTagsForResource
operation returns the tags that are associated with the Amazon Managed
Service for Grafana resource specified by the resourceArn
. Currently, the only resource that can be
tagged is a workspace.
listTagsForResource
in interface AmazonManagedGrafana
public ListVersionsResult listVersions(ListVersionsRequest request)
AmazonManagedGrafana
Lists available versions of Grafana. These are available when calling CreateWorkspace
. Optionally,
include a workspace to list the versions to which it can be upgraded.
listVersions
in interface AmazonManagedGrafana
public ListWorkspaceServiceAccountTokensResult listWorkspaceServiceAccountTokens(ListWorkspaceServiceAccountTokensRequest request)
AmazonManagedGrafana
Returns a list of tokens for a workspace service account.
This does not return the key for each token. You cannot access keys after they are created. To create a new key, delete the token and recreate it.
Service accounts are only available for workspaces that are compatible with Grafana version 9 and above.
listWorkspaceServiceAccountTokens
in interface AmazonManagedGrafana
public ListWorkspaceServiceAccountsResult listWorkspaceServiceAccounts(ListWorkspaceServiceAccountsRequest request)
AmazonManagedGrafana
Returns a list of service accounts for a workspace.
Service accounts are only available for workspaces that are compatible with Grafana version 9 and above.
listWorkspaceServiceAccounts
in interface AmazonManagedGrafana
public ListWorkspacesResult listWorkspaces(ListWorkspacesRequest request)
AmazonManagedGrafana
Returns a list of Amazon Managed Grafana workspaces in the account, with some information about each workspace. For more complete information about one workspace, use DescribeWorkspace.
listWorkspaces
in interface AmazonManagedGrafana
public TagResourceResult tagResource(TagResourceRequest request)
AmazonManagedGrafana
The TagResource
operation associates tags with an Amazon Managed Grafana resource. Currently, the
only resource that can be tagged is workspaces.
If you specify a new tag key for the resource, this tag is appended to the list of tags associated with the resource. If you specify a tag key that is already associated with the resource, the new tag value that you specify replaces the previous value for that tag.
tagResource
in interface AmazonManagedGrafana
public UntagResourceResult untagResource(UntagResourceRequest request)
AmazonManagedGrafana
The UntagResource
operation removes the association of the tag with the Amazon Managed Grafana
resource.
untagResource
in interface AmazonManagedGrafana
public UpdatePermissionsResult updatePermissions(UpdatePermissionsRequest request)
AmazonManagedGrafana
Updates which users in a workspace have the Grafana Admin
or Editor
roles.
updatePermissions
in interface AmazonManagedGrafana
public UpdateWorkspaceResult updateWorkspace(UpdateWorkspaceRequest request)
AmazonManagedGrafana
Modifies an existing Amazon Managed Grafana workspace. If you use this operation and omit any optional parameters, the existing values of those parameters are not changed.
To modify the user authentication methods that the workspace uses, such as SAML or IAM Identity Center, use UpdateWorkspaceAuthentication.
To modify which users in the workspace have the Admin
and Editor
Grafana roles, use UpdatePermissions.
updateWorkspace
in interface AmazonManagedGrafana
public UpdateWorkspaceAuthenticationResult updateWorkspaceAuthentication(UpdateWorkspaceAuthenticationRequest request)
AmazonManagedGrafana
Use this operation to define the identity provider (IdP) that this workspace authenticates users from, using
SAML. You can also 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.
Changes to the authentication method for a workspace may take a few minutes to take effect.
updateWorkspaceAuthentication
in interface AmazonManagedGrafana
public UpdateWorkspaceConfigurationResult updateWorkspaceConfiguration(UpdateWorkspaceConfigurationRequest request)
AmazonManagedGrafana
Updates the configuration string for the given workspace
updateWorkspaceConfiguration
in interface AmazonManagedGrafana
public void shutdown()
AmazonManagedGrafana
shutdown
in interface AmazonManagedGrafana
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
AmazonManagedGrafana
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
getCachedResponseMetadata
in interface AmazonManagedGrafana
request
- The originally executed request.