Package software.amazon.awssdk.services.grafana

Interface GrafanaAsyncClient

All Superinterfaces:
AutoCloseable, AwsClient, SdkAutoCloseable, SdkClient
@Generated("software.amazon.awssdk:codegen") @ThreadSafe public interface GrafanaAsyncClient extends AwsClient
Service client for accessing Amazon Managed Grafana asynchronously. This can be created using the static builder() method.The asynchronous client performs non-blocking I/O when configured with any SdkAsyncHttpClient supported in the SDK. However, full non-blocking is not guaranteed as the async client may perform blocking calls in some cases such as credentials retrieval and endpoint discovery as part of the async API call.

Amazon Managed Grafana is a fully managed and secure data visualization service that you can use to instantly query, correlate, and visualize operational metrics, logs, and traces from multiple sources. Amazon Managed Grafana makes it easy to deploy, operate, and scale Grafana, a widely deployed data visualization tool that is popular for its extensible data support.

With Amazon Managed Grafana, you create logically isolated Grafana servers called workspaces. In a workspace, you can create Grafana dashboards and visualizations to analyze your metrics, logs, and traces without having to build, package, or deploy any hardware to run Grafana servers.

  • Field Details

  • Method Details

    • associateLicense

      default CompletableFuture<AssociateLicenseResponse> associateLicense(AssociateLicenseRequest associateLicenseRequest)

      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.

      Parameters:
      associateLicenseRequest -
      Returns:
      A Java Future containing the result of the AssociateLicense operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • associateLicense

      default CompletableFuture<AssociateLicenseResponse> associateLicense(Consumer<AssociateLicenseRequest.Builder> associateLicenseRequest)

      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.


      This is a convenience which creates an instance of the AssociateLicenseRequest.Builder avoiding the need to create one manually via AssociateLicenseRequest.builder()

      Parameters:
      associateLicenseRequest - A Consumer that will call methods on AssociateLicenseRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the AssociateLicense operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createWorkspace

      default CompletableFuture<CreateWorkspaceResponse> createWorkspace(CreateWorkspaceRequest createWorkspaceRequest)

      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.

      Parameters:
      createWorkspaceRequest -
      Returns:
      A Java Future containing the result of the CreateWorkspace operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • ServiceQuotaExceededException The request would cause a service quota to be exceeded.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createWorkspace

      default CompletableFuture<CreateWorkspaceResponse> createWorkspace(Consumer<CreateWorkspaceRequest.Builder> createWorkspaceRequest)

      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.


      This is a convenience which creates an instance of the CreateWorkspaceRequest.Builder avoiding the need to create one manually via CreateWorkspaceRequest.builder()

      Parameters:
      createWorkspaceRequest - A Consumer that will call methods on CreateWorkspaceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateWorkspace operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • ServiceQuotaExceededException The request would cause a service quota to be exceeded.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createWorkspaceApiKey

      default CompletableFuture<CreateWorkspaceApiKeyResponse> createWorkspaceApiKey(CreateWorkspaceApiKeyRequest createWorkspaceApiKeyRequest)

      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.

      Parameters:
      createWorkspaceApiKeyRequest -
      Returns:
      A Java Future containing the result of the CreateWorkspaceApiKey operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • ServiceQuotaExceededException The request would cause a service quota to be exceeded.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createWorkspaceApiKey

      default CompletableFuture<CreateWorkspaceApiKeyResponse> createWorkspaceApiKey(Consumer<CreateWorkspaceApiKeyRequest.Builder> createWorkspaceApiKeyRequest)

      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.


      This is a convenience which creates an instance of the CreateWorkspaceApiKeyRequest.Builder avoiding the need to create one manually via CreateWorkspaceApiKeyRequest.builder()

      Parameters:
      createWorkspaceApiKeyRequest - A Consumer that will call methods on CreateWorkspaceApiKeyRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateWorkspaceApiKey operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • ServiceQuotaExceededException The request would cause a service quota to be exceeded.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createWorkspaceServiceAccount

      default CompletableFuture<CreateWorkspaceServiceAccountResponse> createWorkspaceServiceAccount(CreateWorkspaceServiceAccountRequest createWorkspaceServiceAccountRequest)

      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.

      Parameters:
      createWorkspaceServiceAccountRequest -
      Returns:
      A Java Future containing the result of the CreateWorkspaceServiceAccount operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • ServiceQuotaExceededException The request would cause a service quota to be exceeded.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createWorkspaceServiceAccount

      default CompletableFuture<CreateWorkspaceServiceAccountResponse> createWorkspaceServiceAccount(Consumer<CreateWorkspaceServiceAccountRequest.Builder> createWorkspaceServiceAccountRequest)

      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.


      This is a convenience which creates an instance of the CreateWorkspaceServiceAccountRequest.Builder avoiding the need to create one manually via CreateWorkspaceServiceAccountRequest.builder()

      Parameters:
      createWorkspaceServiceAccountRequest - A Consumer that will call methods on CreateWorkspaceServiceAccountRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateWorkspaceServiceAccount operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • ServiceQuotaExceededException The request would cause a service quota to be exceeded.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createWorkspaceServiceAccountToken

      default CompletableFuture<CreateWorkspaceServiceAccountTokenResponse> createWorkspaceServiceAccountToken(CreateWorkspaceServiceAccountTokenRequest createWorkspaceServiceAccountTokenRequest)

      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.

      Parameters:
      createWorkspaceServiceAccountTokenRequest -
      Returns:
      A Java Future containing the result of the CreateWorkspaceServiceAccountToken operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • ServiceQuotaExceededException The request would cause a service quota to be exceeded.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • createWorkspaceServiceAccountToken

      default CompletableFuture<CreateWorkspaceServiceAccountTokenResponse> createWorkspaceServiceAccountToken(Consumer<CreateWorkspaceServiceAccountTokenRequest.Builder> createWorkspaceServiceAccountTokenRequest)

      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.


      This is a convenience which creates an instance of the CreateWorkspaceServiceAccountTokenRequest.Builder avoiding the need to create one manually via CreateWorkspaceServiceAccountTokenRequest.builder()

      Parameters:
      createWorkspaceServiceAccountTokenRequest - A Consumer that will call methods on CreateWorkspaceServiceAccountTokenRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the CreateWorkspaceServiceAccountToken operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • ServiceQuotaExceededException The request would cause a service quota to be exceeded.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteWorkspace

      default CompletableFuture<DeleteWorkspaceResponse> deleteWorkspace(DeleteWorkspaceRequest deleteWorkspaceRequest)

      Deletes an Amazon Managed Grafana workspace.

      Parameters:
      deleteWorkspaceRequest -
      Returns:
      A Java Future containing the result of the DeleteWorkspace operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteWorkspace

      default CompletableFuture<DeleteWorkspaceResponse> deleteWorkspace(Consumer<DeleteWorkspaceRequest.Builder> deleteWorkspaceRequest)

      Deletes an Amazon Managed Grafana workspace.


      This is a convenience which creates an instance of the DeleteWorkspaceRequest.Builder avoiding the need to create one manually via DeleteWorkspaceRequest.builder()

      Parameters:
      deleteWorkspaceRequest - A Consumer that will call methods on DeleteWorkspaceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteWorkspace operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteWorkspaceApiKey

      default CompletableFuture<DeleteWorkspaceApiKeyResponse> deleteWorkspaceApiKey(DeleteWorkspaceApiKeyRequest deleteWorkspaceApiKeyRequest)

      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.

      Parameters:
      deleteWorkspaceApiKeyRequest -
      Returns:
      A Java Future containing the result of the DeleteWorkspaceApiKey operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteWorkspaceApiKey

      default CompletableFuture<DeleteWorkspaceApiKeyResponse> deleteWorkspaceApiKey(Consumer<DeleteWorkspaceApiKeyRequest.Builder> deleteWorkspaceApiKeyRequest)

      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.


      This is a convenience which creates an instance of the DeleteWorkspaceApiKeyRequest.Builder avoiding the need to create one manually via DeleteWorkspaceApiKeyRequest.builder()

      Parameters:
      deleteWorkspaceApiKeyRequest - A Consumer that will call methods on DeleteWorkspaceApiKeyRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteWorkspaceApiKey operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteWorkspaceServiceAccount

      default CompletableFuture<DeleteWorkspaceServiceAccountResponse> deleteWorkspaceServiceAccount(DeleteWorkspaceServiceAccountRequest deleteWorkspaceServiceAccountRequest)

      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.

      Parameters:
      deleteWorkspaceServiceAccountRequest -
      Returns:
      A Java Future containing the result of the DeleteWorkspaceServiceAccount operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteWorkspaceServiceAccount

      default CompletableFuture<DeleteWorkspaceServiceAccountResponse> deleteWorkspaceServiceAccount(Consumer<DeleteWorkspaceServiceAccountRequest.Builder> deleteWorkspaceServiceAccountRequest)

      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.


      This is a convenience which creates an instance of the DeleteWorkspaceServiceAccountRequest.Builder avoiding the need to create one manually via DeleteWorkspaceServiceAccountRequest.builder()

      Parameters:
      deleteWorkspaceServiceAccountRequest - A Consumer that will call methods on DeleteWorkspaceServiceAccountRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteWorkspaceServiceAccount operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteWorkspaceServiceAccountToken

      default CompletableFuture<DeleteWorkspaceServiceAccountTokenResponse> deleteWorkspaceServiceAccountToken(DeleteWorkspaceServiceAccountTokenRequest deleteWorkspaceServiceAccountTokenRequest)

      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.

      Parameters:
      deleteWorkspaceServiceAccountTokenRequest -
      Returns:
      A Java Future containing the result of the DeleteWorkspaceServiceAccountToken operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • deleteWorkspaceServiceAccountToken

      default CompletableFuture<DeleteWorkspaceServiceAccountTokenResponse> deleteWorkspaceServiceAccountToken(Consumer<DeleteWorkspaceServiceAccountTokenRequest.Builder> deleteWorkspaceServiceAccountTokenRequest)

      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.


      This is a convenience which creates an instance of the DeleteWorkspaceServiceAccountTokenRequest.Builder avoiding the need to create one manually via DeleteWorkspaceServiceAccountTokenRequest.builder()

      Parameters:
      deleteWorkspaceServiceAccountTokenRequest - A Consumer that will call methods on DeleteWorkspaceServiceAccountTokenRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DeleteWorkspaceServiceAccountToken operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • describeWorkspace

      default CompletableFuture<DescribeWorkspaceResponse> describeWorkspace(DescribeWorkspaceRequest describeWorkspaceRequest)

      Displays information about one Amazon Managed Grafana workspace.

      Parameters:
      describeWorkspaceRequest -
      Returns:
      A Java Future containing the result of the DescribeWorkspace operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • describeWorkspace

      default CompletableFuture<DescribeWorkspaceResponse> describeWorkspace(Consumer<DescribeWorkspaceRequest.Builder> describeWorkspaceRequest)

      Displays information about one Amazon Managed Grafana workspace.


      This is a convenience which creates an instance of the DescribeWorkspaceRequest.Builder avoiding the need to create one manually via DescribeWorkspaceRequest.builder()

      Parameters:
      describeWorkspaceRequest - A Consumer that will call methods on DescribeWorkspaceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeWorkspace operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • describeWorkspaceAuthentication

      default CompletableFuture<DescribeWorkspaceAuthenticationResponse> describeWorkspaceAuthentication(DescribeWorkspaceAuthenticationRequest describeWorkspaceAuthenticationRequest)

      Displays information about the authentication methods used in one Amazon Managed Grafana workspace.

      Parameters:
      describeWorkspaceAuthenticationRequest -
      Returns:
      A Java Future containing the result of the DescribeWorkspaceAuthentication operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • describeWorkspaceAuthentication

      default CompletableFuture<DescribeWorkspaceAuthenticationResponse> describeWorkspaceAuthentication(Consumer<DescribeWorkspaceAuthenticationRequest.Builder> describeWorkspaceAuthenticationRequest)

      Displays information about the authentication methods used in one Amazon Managed Grafana workspace.


      This is a convenience which creates an instance of the DescribeWorkspaceAuthenticationRequest.Builder avoiding the need to create one manually via DescribeWorkspaceAuthenticationRequest.builder()

      Parameters:
      describeWorkspaceAuthenticationRequest - A Consumer that will call methods on DescribeWorkspaceAuthenticationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeWorkspaceAuthentication operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • describeWorkspaceConfiguration

      default CompletableFuture<DescribeWorkspaceConfigurationResponse> describeWorkspaceConfiguration(DescribeWorkspaceConfigurationRequest describeWorkspaceConfigurationRequest)

      Gets the current configuration string for the given workspace.

      Parameters:
      describeWorkspaceConfigurationRequest -
      Returns:
      A Java Future containing the result of the DescribeWorkspaceConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • describeWorkspaceConfiguration

      default CompletableFuture<DescribeWorkspaceConfigurationResponse> describeWorkspaceConfiguration(Consumer<DescribeWorkspaceConfigurationRequest.Builder> describeWorkspaceConfigurationRequest)

      Gets the current configuration string for the given workspace.


      This is a convenience which creates an instance of the DescribeWorkspaceConfigurationRequest.Builder avoiding the need to create one manually via DescribeWorkspaceConfigurationRequest.builder()

      Parameters:
      describeWorkspaceConfigurationRequest - A Consumer that will call methods on DescribeWorkspaceConfigurationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DescribeWorkspaceConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • disassociateLicense

      default CompletableFuture<DisassociateLicenseResponse> disassociateLicense(DisassociateLicenseRequest disassociateLicenseRequest)

      Removes the Grafana Enterprise license from a workspace.

      Parameters:
      disassociateLicenseRequest -
      Returns:
      A Java Future containing the result of the DisassociateLicense operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • disassociateLicense

      default CompletableFuture<DisassociateLicenseResponse> disassociateLicense(Consumer<DisassociateLicenseRequest.Builder> disassociateLicenseRequest)

      Removes the Grafana Enterprise license from a workspace.


      This is a convenience which creates an instance of the DisassociateLicenseRequest.Builder avoiding the need to create one manually via DisassociateLicenseRequest.builder()

      Parameters:
      disassociateLicenseRequest - A Consumer that will call methods on DisassociateLicenseRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the DisassociateLicense operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissions

      default CompletableFuture<ListPermissionsResponse> listPermissions(ListPermissionsRequest listPermissionsRequest)

      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.

      Parameters:
      listPermissionsRequest -
      Returns:
      A Java Future containing the result of the ListPermissions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissions

      default CompletableFuture<ListPermissionsResponse> listPermissions(Consumer<ListPermissionsRequest.Builder> listPermissionsRequest)

      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.


      This is a convenience which creates an instance of the ListPermissionsRequest.Builder avoiding the need to create one manually via ListPermissionsRequest.builder()

      Parameters:
      listPermissionsRequest - A Consumer that will call methods on ListPermissionsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListPermissions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissionsPaginator

      default ListPermissionsPublisher listPermissionsPaginator(ListPermissionsRequest listPermissionsRequest)

      This is a variant of listPermissions(software.amazon.awssdk.services.grafana.model.ListPermissionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.grafana.paginators.ListPermissionsPublisher publisher = client.listPermissionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.grafana.paginators.ListPermissionsPublisher publisher = client.listPermissionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.grafana.model.ListPermissionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.grafana.model.ListPermissionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listPermissions(software.amazon.awssdk.services.grafana.model.ListPermissionsRequest) operation.

      Parameters:
      listPermissionsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listPermissionsPaginator

      default ListPermissionsPublisher listPermissionsPaginator(Consumer<ListPermissionsRequest.Builder> listPermissionsRequest)

      This is a variant of listPermissions(software.amazon.awssdk.services.grafana.model.ListPermissionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.grafana.paginators.ListPermissionsPublisher publisher = client.listPermissionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.grafana.paginators.ListPermissionsPublisher publisher = client.listPermissionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.grafana.model.ListPermissionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.grafana.model.ListPermissionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listPermissions(software.amazon.awssdk.services.grafana.model.ListPermissionsRequest) operation.


      This is a convenience which creates an instance of the ListPermissionsRequest.Builder avoiding the need to create one manually via ListPermissionsRequest.builder()

      Parameters:
      listPermissionsRequest - A Consumer that will call methods on ListPermissionsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTagsForResource

      default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)

      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.

      Parameters:
      listTagsForResourceRequest -
      Returns:
      A Java Future containing the result of the ListTagsForResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listTagsForResource

      default CompletableFuture<ListTagsForResourceResponse> listTagsForResource(Consumer<ListTagsForResourceRequest.Builder> listTagsForResourceRequest)

      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.


      This is a convenience which creates an instance of the ListTagsForResourceRequest.Builder avoiding the need to create one manually via ListTagsForResourceRequest.builder()

      Parameters:
      listTagsForResourceRequest - A Consumer that will call methods on ListTagsForResourceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListTagsForResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listVersions

      default CompletableFuture<ListVersionsResponse> listVersions(ListVersionsRequest listVersionsRequest)

      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.

      Parameters:
      listVersionsRequest -
      Returns:
      A Java Future containing the result of the ListVersions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listVersions

      default CompletableFuture<ListVersionsResponse> listVersions(Consumer<ListVersionsRequest.Builder> listVersionsRequest)

      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.


      This is a convenience which creates an instance of the ListVersionsRequest.Builder avoiding the need to create one manually via ListVersionsRequest.builder()

      Parameters:
      listVersionsRequest - A Consumer that will call methods on ListVersionsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListVersions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listVersionsPaginator

      default ListVersionsPublisher listVersionsPaginator(ListVersionsRequest listVersionsRequest)

      This is a variant of listVersions(software.amazon.awssdk.services.grafana.model.ListVersionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.grafana.paginators.ListVersionsPublisher publisher = client.listVersionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.grafana.paginators.ListVersionsPublisher publisher = client.listVersionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.grafana.model.ListVersionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.grafana.model.ListVersionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listVersions(software.amazon.awssdk.services.grafana.model.ListVersionsRequest) operation.

      Parameters:
      listVersionsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listVersionsPaginator

      default ListVersionsPublisher listVersionsPaginator(Consumer<ListVersionsRequest.Builder> listVersionsRequest)

      This is a variant of listVersions(software.amazon.awssdk.services.grafana.model.ListVersionsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.grafana.paginators.ListVersionsPublisher publisher = client.listVersionsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.grafana.paginators.ListVersionsPublisher publisher = client.listVersionsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.grafana.model.ListVersionsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.grafana.model.ListVersionsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listVersions(software.amazon.awssdk.services.grafana.model.ListVersionsRequest) operation.


      This is a convenience which creates an instance of the ListVersionsRequest.Builder avoiding the need to create one manually via ListVersionsRequest.builder()

      Parameters:
      listVersionsRequest - A Consumer that will call methods on ListVersionsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listWorkspaceServiceAccountTokens

      default CompletableFuture<ListWorkspaceServiceAccountTokensResponse> listWorkspaceServiceAccountTokens(ListWorkspaceServiceAccountTokensRequest listWorkspaceServiceAccountTokensRequest)

      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.

      Parameters:
      listWorkspaceServiceAccountTokensRequest -
      Returns:
      A Java Future containing the result of the ListWorkspaceServiceAccountTokens operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listWorkspaceServiceAccountTokens

      default CompletableFuture<ListWorkspaceServiceAccountTokensResponse> listWorkspaceServiceAccountTokens(Consumer<ListWorkspaceServiceAccountTokensRequest.Builder> listWorkspaceServiceAccountTokensRequest)

      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.


      This is a convenience which creates an instance of the ListWorkspaceServiceAccountTokensRequest.Builder avoiding the need to create one manually via ListWorkspaceServiceAccountTokensRequest.builder()

      Parameters:
      listWorkspaceServiceAccountTokensRequest - A Consumer that will call methods on ListWorkspaceServiceAccountTokensRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListWorkspaceServiceAccountTokens operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listWorkspaceServiceAccountTokensPaginator

      default ListWorkspaceServiceAccountTokensPublisher listWorkspaceServiceAccountTokensPaginator(ListWorkspaceServiceAccountTokensRequest listWorkspaceServiceAccountTokensRequest)

      This is a variant of listWorkspaceServiceAccountTokens(software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountTokensRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.grafana.paginators.ListWorkspaceServiceAccountTokensPublisher publisher = client.listWorkspaceServiceAccountTokensPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.grafana.paginators.ListWorkspaceServiceAccountTokensPublisher publisher = client.listWorkspaceServiceAccountTokensPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountTokensResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountTokensResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listWorkspaceServiceAccountTokens(software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountTokensRequest) operation.

      Parameters:
      listWorkspaceServiceAccountTokensRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listWorkspaceServiceAccountTokensPaginator

      default ListWorkspaceServiceAccountTokensPublisher listWorkspaceServiceAccountTokensPaginator(Consumer<ListWorkspaceServiceAccountTokensRequest.Builder> listWorkspaceServiceAccountTokensRequest)

      This is a variant of listWorkspaceServiceAccountTokens(software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountTokensRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.grafana.paginators.ListWorkspaceServiceAccountTokensPublisher publisher = client.listWorkspaceServiceAccountTokensPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.grafana.paginators.ListWorkspaceServiceAccountTokensPublisher publisher = client.listWorkspaceServiceAccountTokensPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountTokensResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountTokensResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listWorkspaceServiceAccountTokens(software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountTokensRequest) operation.


      This is a convenience which creates an instance of the ListWorkspaceServiceAccountTokensRequest.Builder avoiding the need to create one manually via ListWorkspaceServiceAccountTokensRequest.builder()

      Parameters:
      listWorkspaceServiceAccountTokensRequest - A Consumer that will call methods on ListWorkspaceServiceAccountTokensRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listWorkspaceServiceAccounts

      default CompletableFuture<ListWorkspaceServiceAccountsResponse> listWorkspaceServiceAccounts(ListWorkspaceServiceAccountsRequest listWorkspaceServiceAccountsRequest)

      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.

      Parameters:
      listWorkspaceServiceAccountsRequest -
      Returns:
      A Java Future containing the result of the ListWorkspaceServiceAccounts operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listWorkspaceServiceAccounts

      default CompletableFuture<ListWorkspaceServiceAccountsResponse> listWorkspaceServiceAccounts(Consumer<ListWorkspaceServiceAccountsRequest.Builder> listWorkspaceServiceAccountsRequest)

      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.


      This is a convenience which creates an instance of the ListWorkspaceServiceAccountsRequest.Builder avoiding the need to create one manually via ListWorkspaceServiceAccountsRequest.builder()

      Parameters:
      listWorkspaceServiceAccountsRequest - A Consumer that will call methods on ListWorkspaceServiceAccountsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListWorkspaceServiceAccounts operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listWorkspaceServiceAccountsPaginator

      default ListWorkspaceServiceAccountsPublisher listWorkspaceServiceAccountsPaginator(ListWorkspaceServiceAccountsRequest listWorkspaceServiceAccountsRequest)

      This is a variant of listWorkspaceServiceAccounts(software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.grafana.paginators.ListWorkspaceServiceAccountsPublisher publisher = client.listWorkspaceServiceAccountsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.grafana.paginators.ListWorkspaceServiceAccountsPublisher publisher = client.listWorkspaceServiceAccountsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listWorkspaceServiceAccounts(software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountsRequest) operation.

      Parameters:
      listWorkspaceServiceAccountsRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listWorkspaceServiceAccountsPaginator

      default ListWorkspaceServiceAccountsPublisher listWorkspaceServiceAccountsPaginator(Consumer<ListWorkspaceServiceAccountsRequest.Builder> listWorkspaceServiceAccountsRequest)

      This is a variant of listWorkspaceServiceAccounts(software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountsRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.grafana.paginators.ListWorkspaceServiceAccountsPublisher publisher = client.listWorkspaceServiceAccountsPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.grafana.paginators.ListWorkspaceServiceAccountsPublisher publisher = client.listWorkspaceServiceAccountsPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountsResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountsResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listWorkspaceServiceAccounts(software.amazon.awssdk.services.grafana.model.ListWorkspaceServiceAccountsRequest) operation.


      This is a convenience which creates an instance of the ListWorkspaceServiceAccountsRequest.Builder avoiding the need to create one manually via ListWorkspaceServiceAccountsRequest.builder()

      Parameters:
      listWorkspaceServiceAccountsRequest - A Consumer that will call methods on ListWorkspaceServiceAccountsRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listWorkspaces

      default CompletableFuture<ListWorkspacesResponse> listWorkspaces(ListWorkspacesRequest listWorkspacesRequest)

      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.

      Parameters:
      listWorkspacesRequest -
      Returns:
      A Java Future containing the result of the ListWorkspaces operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listWorkspaces

      default CompletableFuture<ListWorkspacesResponse> listWorkspaces(Consumer<ListWorkspacesRequest.Builder> listWorkspacesRequest)

      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.


      This is a convenience which creates an instance of the ListWorkspacesRequest.Builder avoiding the need to create one manually via ListWorkspacesRequest.builder()

      Parameters:
      listWorkspacesRequest - A Consumer that will call methods on ListWorkspacesRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the ListWorkspaces operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listWorkspacesPaginator

      default ListWorkspacesPublisher listWorkspacesPaginator(ListWorkspacesRequest listWorkspacesRequest)

      This is a variant of listWorkspaces(software.amazon.awssdk.services.grafana.model.ListWorkspacesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.grafana.paginators.ListWorkspacesPublisher publisher = client.listWorkspacesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.grafana.paginators.ListWorkspacesPublisher publisher = client.listWorkspacesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.grafana.model.ListWorkspacesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.grafana.model.ListWorkspacesResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listWorkspaces(software.amazon.awssdk.services.grafana.model.ListWorkspacesRequest) operation.

      Parameters:
      listWorkspacesRequest -
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • listWorkspacesPaginator

      default ListWorkspacesPublisher listWorkspacesPaginator(Consumer<ListWorkspacesRequest.Builder> listWorkspacesRequest)

      This is a variant of listWorkspaces(software.amazon.awssdk.services.grafana.model.ListWorkspacesRequest) operation. The return type is a custom publisher that can be subscribed to request a stream of response pages. SDK will internally handle making service calls for you.

      When the operation is called, an instance of this class is returned. At this point, no service calls are made yet and so there is no guarantee that the request is valid. If there are errors in your request, you will see the failures only after you start streaming the data. The subscribe method should be called as a request to start streaming data. For more info, see Publisher.subscribe(org.reactivestreams.Subscriber). Each call to the subscribe method will result in a new Subscription i.e., a new contract to stream data from the starting request.

      The following are few ways to use the response class:

      1) Using the subscribe helper method 
       
 software.amazon.awssdk.services.grafana.paginators.ListWorkspacesPublisher publisher = client.listWorkspacesPaginator(request);
 CompletableFuture<Void> future = publisher.subscribe(res -> { // Do something with the response });
 future.get();
      2) Using a custom subscriber 
       
 software.amazon.awssdk.services.grafana.paginators.ListWorkspacesPublisher publisher = client.listWorkspacesPaginator(request);
 publisher.subscribe(new Subscriber<software.amazon.awssdk.services.grafana.model.ListWorkspacesResponse>() {
 
 public void onSubscribe(org.reactivestreams.Subscriber subscription) { //... };
 
 
 public void onNext(software.amazon.awssdk.services.grafana.model.ListWorkspacesResponse response) { //... };
 });
      As the response is a publisher, it can work well with third party reactive streams implementations like RxJava2.

      Please notice that the configuration of maxResults won't limit the number of results you get with the paginator. It only limits the number of results in each page.

      Note: If you prefer to have control on service calls, use the listWorkspaces(software.amazon.awssdk.services.grafana.model.ListWorkspacesRequest) operation.


      This is a convenience which creates an instance of the ListWorkspacesRequest.Builder avoiding the need to create one manually via ListWorkspacesRequest.builder()

      Parameters:
      listWorkspacesRequest - A Consumer that will call methods on ListWorkspacesRequest.Builder to create a request.
      Returns:
      A custom publisher that can be subscribed to request a stream of response pages.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • tagResource

      default CompletableFuture<TagResourceResponse> tagResource(TagResourceRequest tagResourceRequest)

      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.

      Parameters:
      tagResourceRequest -
      Returns:
      A Java Future containing the result of the TagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • tagResource

      default CompletableFuture<TagResourceResponse> tagResource(Consumer<TagResourceRequest.Builder> tagResourceRequest)

      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.


      This is a convenience which creates an instance of the TagResourceRequest.Builder avoiding the need to create one manually via TagResourceRequest.builder()

      Parameters:
      tagResourceRequest - A Consumer that will call methods on TagResourceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the TagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • untagResource

      default CompletableFuture<UntagResourceResponse> untagResource(UntagResourceRequest untagResourceRequest)

      The UntagResource operation removes the association of the tag with the Amazon Managed Grafana resource.

      Parameters:
      untagResourceRequest -
      Returns:
      A Java Future containing the result of the UntagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • untagResource

      default CompletableFuture<UntagResourceResponse> untagResource(Consumer<UntagResourceRequest.Builder> untagResourceRequest)

      The UntagResource operation removes the association of the tag with the Amazon Managed Grafana resource.


      This is a convenience which creates an instance of the UntagResourceRequest.Builder avoiding the need to create one manually via UntagResourceRequest.builder()

      Parameters:
      untagResourceRequest - A Consumer that will call methods on UntagResourceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UntagResource operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updatePermissions

      default CompletableFuture<UpdatePermissionsResponse> updatePermissions(UpdatePermissionsRequest updatePermissionsRequest)

      Updates which users in a workspace have the Grafana Admin or Editor roles.

      Parameters:
      updatePermissionsRequest -
      Returns:
      A Java Future containing the result of the UpdatePermissions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updatePermissions

      default CompletableFuture<UpdatePermissionsResponse> updatePermissions(Consumer<UpdatePermissionsRequest.Builder> updatePermissionsRequest)

      Updates which users in a workspace have the Grafana Admin or Editor roles.


      This is a convenience which creates an instance of the UpdatePermissionsRequest.Builder avoiding the need to create one manually via UpdatePermissionsRequest.builder()

      Parameters:
      updatePermissionsRequest - A Consumer that will call methods on UpdatePermissionsRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdatePermissions operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateWorkspace

      default CompletableFuture<UpdateWorkspaceResponse> updateWorkspace(UpdateWorkspaceRequest updateWorkspaceRequest)

      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.

      Parameters:
      updateWorkspaceRequest -
      Returns:
      A Java Future containing the result of the UpdateWorkspace operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateWorkspace

      default CompletableFuture<UpdateWorkspaceResponse> updateWorkspace(Consumer<UpdateWorkspaceRequest.Builder> updateWorkspaceRequest)

      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.


      This is a convenience which creates an instance of the UpdateWorkspaceRequest.Builder avoiding the need to create one manually via UpdateWorkspaceRequest.builder()

      Parameters:
      updateWorkspaceRequest - A Consumer that will call methods on UpdateWorkspaceRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateWorkspace operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateWorkspaceAuthentication

      default CompletableFuture<UpdateWorkspaceAuthenticationResponse> updateWorkspaceAuthentication(UpdateWorkspaceAuthenticationRequest updateWorkspaceAuthenticationRequest)

      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.

      Parameters:
      updateWorkspaceAuthenticationRequest -
      Returns:
      A Java Future containing the result of the UpdateWorkspaceAuthentication operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateWorkspaceAuthentication

      default CompletableFuture<UpdateWorkspaceAuthenticationResponse> updateWorkspaceAuthentication(Consumer<UpdateWorkspaceAuthenticationRequest.Builder> updateWorkspaceAuthenticationRequest)

      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.


      This is a convenience which creates an instance of the UpdateWorkspaceAuthenticationRequest.Builder avoiding the need to create one manually via UpdateWorkspaceAuthenticationRequest.builder()

      Parameters:
      updateWorkspaceAuthenticationRequest - A Consumer that will call methods on UpdateWorkspaceAuthenticationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateWorkspaceAuthentication operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateWorkspaceConfiguration

      default CompletableFuture<UpdateWorkspaceConfigurationResponse> updateWorkspaceConfiguration(UpdateWorkspaceConfigurationRequest updateWorkspaceConfigurationRequest)

      Updates the configuration string for the given workspace

      Parameters:
      updateWorkspaceConfigurationRequest -
      Returns:
      A Java Future containing the result of the UpdateWorkspaceConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • updateWorkspaceConfiguration

      default CompletableFuture<UpdateWorkspaceConfigurationResponse> updateWorkspaceConfiguration(Consumer<UpdateWorkspaceConfigurationRequest.Builder> updateWorkspaceConfigurationRequest)

      Updates the configuration string for the given workspace


      This is a convenience which creates an instance of the UpdateWorkspaceConfigurationRequest.Builder avoiding the need to create one manually via UpdateWorkspaceConfigurationRequest.builder()

      Parameters:
      updateWorkspaceConfigurationRequest - A Consumer that will call methods on UpdateWorkspaceConfigurationRequest.Builder to create a request.
      Returns:
      A Java Future containing the result of the UpdateWorkspaceConfiguration operation returned by the service.
      The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invoke Throwable.getCause() to retrieve the underlying exception.
      • ResourceNotFoundException The request references a resource that does not exist.
      • ThrottlingException The request was denied because of request throttling. Retry the request.
      • ConflictException A resource was in an inconsistent state during an update or a deletion.
      • ValidationException The value of a parameter in the request caused an error.
      • AccessDeniedException You do not have sufficient permissions to perform this action.
      • InternalServerException Unexpected error while processing the request. Retry the request.
      • SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
      • SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
      • GrafanaException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
      See Also:

    • serviceClientConfiguration

      default GrafanaServiceClientConfiguration serviceClientConfiguration()
      Description copied from interface: SdkClient
      The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration
      Specified by:
      serviceClientConfiguration in interface AwsClient
      Specified by:
      serviceClientConfiguration in interface SdkClient
      Returns:
      SdkServiceClientConfiguration

    • create

      static GrafanaAsyncClient create()
      Create a GrafanaAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

    • builder

      static GrafanaAsyncClientBuilder builder()
      Create a builder that can be used to configure and create a GrafanaAsyncClient.