aws-sdk-managedgrafana 1.19.0 → 1.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 23941d2d01cd5294d062cb08db7afcb254d7c57e66c7eb509bbd6c55f5902f1f
-  data.tar.gz: 9987c8d45aa97edf458912552eabd090f4492bc1aaf2a305e9be107746c3d9a1
+  metadata.gz: 15235a52d01b3ec5c3d58908c4b024fb26d51e7472eecfccb3f1fef745570901
+  data.tar.gz: d5270ce74a1ad5451b5ea0a91447818f53fab0fb22db8ba9cf5018e3caa085bc
 SHA512:
-  metadata.gz: 23dab87fee1da659618f7c87f5d8a8111eb7d76a036c8731a016462e3a66136dd8988940d3b6d9b7580896c9961adc06d26b598188f472c48b41a0b6f3b3189b
-  data.tar.gz: b4e05b32c98408f6faf4f52a740e99a70e025e94846df7e49d3d9422fb3eb6eab93b8a2eed9741fc340e085828a7659096457cd446d7428b4a7fb78767859015
+  metadata.gz: 75543d14829e408a21e2dcbebb3756f62a0d384439a5e8901ba31cd1a52ad2f74e491db287f05772d4446eb040c6cb43521cd50e797710b46930505ad32ddb47
+  data.tar.gz: 2c8acc8c9b64e408f5e71744b60f2736557f4a42fcdb7bdcb01bc4d547ad4aa553596c67194a767d8622d77f99a8df13a4d8ca858fb962e0eb0c9e7ac24037cc

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.20.0 (2023-07-19)
+------------------
+
+* Feature - Amazon Managed Grafana now supports grafanaVersion update for existing workspaces with UpdateWorkspaceConfiguration API. DescribeWorkspaceConfiguration API additionally returns grafanaVersion. A new ListVersions API lists available versions or, if given a workspaceId, the versions it can upgrade to.
+
 1.19.0 (2023-07-11)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.19.0
+1.20.0

data/lib/aws-sdk-managedgrafana/client.rb

@@ -443,7 +443,7 @@ module Aws::ManagedGrafana
     #   resp.workspace.organizational_units[0] #=> String
     #   resp.workspace.permission_type #=> String, one of "CUSTOMER_MANAGED", "SERVICE_MANAGED"
     #   resp.workspace.stack_set_name #=> String
-    #   resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED"
+    #   resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED", "VERSION_UPDATING", "VERSION_UPDATE_FAILED"
     #   resp.workspace.tags #=> Hash
     #   resp.workspace.tags["TagKey"] #=> String
     #   resp.workspace.vpc_configuration.security_group_ids #=> Array
@@ -514,7 +514,7 @@ module Aws::ManagedGrafana
     # @option params [String] :grafana_version
     #   Specifies the version of Grafana to support in the new workspace.
     #
-    #   Supported values are `8.4` and `9.4`.
+    #   To get a list of supported version, use the `ListVersions` operation.
     #
     # @option params [Types::NetworkAccessConfiguration] :network_access_control
     #   Configuration for network access to your workspace.
@@ -570,6 +570,11 @@ module Aws::ManagedGrafana
     #   The configuration settings for an Amazon VPC that contains data
     #   sources for your Grafana workspace to connect to.
     #
+    #   <note markdown="1"> Connecting to a private VPC is not yet available in the Asia Pacific
+    #   (Seoul) Region (ap-northeast-2).
+    #
+    #    </note>
+    #
     # @option params [Array<String>] :workspace_data_sources
     #   This parameter is for internal use only, and should not be used.
     #
@@ -664,7 +669,7 @@ module Aws::ManagedGrafana
     #   resp.workspace.organizational_units[0] #=> String
     #   resp.workspace.permission_type #=> String, one of "CUSTOMER_MANAGED", "SERVICE_MANAGED"
     #   resp.workspace.stack_set_name #=> String
-    #   resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED"
+    #   resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED", "VERSION_UPDATING", "VERSION_UPDATE_FAILED"
     #   resp.workspace.tags #=> Hash
     #   resp.workspace.tags["TagKey"] #=> String
     #   resp.workspace.vpc_configuration.security_group_ids #=> Array
@@ -782,7 +787,7 @@ module Aws::ManagedGrafana
     #   resp.workspace.organizational_units[0] #=> String
     #   resp.workspace.permission_type #=> String, one of "CUSTOMER_MANAGED", "SERVICE_MANAGED"
     #   resp.workspace.stack_set_name #=> String
-    #   resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED"
+    #   resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED", "VERSION_UPDATING", "VERSION_UPDATE_FAILED"
     #   resp.workspace.tags #=> Hash
     #   resp.workspace.tags["TagKey"] #=> String
     #   resp.workspace.vpc_configuration.security_group_ids #=> Array
@@ -879,7 +884,7 @@ module Aws::ManagedGrafana
     #   resp.workspace.organizational_units[0] #=> String
     #   resp.workspace.permission_type #=> String, one of "CUSTOMER_MANAGED", "SERVICE_MANAGED"
     #   resp.workspace.stack_set_name #=> String
-    #   resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED"
+    #   resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED", "VERSION_UPDATING", "VERSION_UPDATE_FAILED"
     #   resp.workspace.tags #=> Hash
     #   resp.workspace.tags["TagKey"] #=> String
     #   resp.workspace.vpc_configuration.security_group_ids #=> Array
@@ -952,6 +957,7 @@ module Aws::ManagedGrafana
     # @return [Types::DescribeWorkspaceConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DescribeWorkspaceConfigurationResponse#configuration #configuration} => String
+    #   * {Types::DescribeWorkspaceConfigurationResponse#grafana_version #grafana_version} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -962,6 +968,7 @@ module Aws::ManagedGrafana
     # @example Response structure
     #
     #   resp.configuration #=> String
+    #   resp.grafana_version #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/grafana-2020-08-18/DescribeWorkspaceConfiguration AWS API Documentation
     #
@@ -1021,7 +1028,7 @@ module Aws::ManagedGrafana
     #   resp.workspace.organizational_units[0] #=> String
     #   resp.workspace.permission_type #=> String, one of "CUSTOMER_MANAGED", "SERVICE_MANAGED"
     #   resp.workspace.stack_set_name #=> String
-    #   resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED"
+    #   resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED", "VERSION_UPDATING", "VERSION_UPDATE_FAILED"
     #   resp.workspace.tags #=> Hash
     #   resp.workspace.tags["TagKey"] #=> String
     #   resp.workspace.vpc_configuration.security_group_ids #=> Array
@@ -1135,6 +1142,52 @@ module Aws::ManagedGrafana
       req.send_request(options)
     end
 
+    # 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.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to include in the response.
+    #
+    # @option params [String] :next_token
+    #   The token to use when requesting the next set of results. You receive
+    #   this token from a previous `ListVersions` operation.
+    #
+    # @option params [String] :workspace_id
+    #   The ID of the workspace to list the available upgrade versions. If not
+    #   included, lists all versions of Grafana that are supported for
+    #   `CreateWorkspace`.
+    #
+    # @return [Types::ListVersionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListVersionsResponse#grafana_versions #grafana_versions} => Array&lt;String&gt;
+    #   * {Types::ListVersionsResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_versions({
+    #     max_results: 1,
+    #     next_token: "PaginationToken",
+    #     workspace_id: "WorkspaceId",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.grafana_versions #=> Array
+    #   resp.grafana_versions[0] #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/grafana-2020-08-18/ListVersions AWS API Documentation
+    #
+    # @overload list_versions(params = {})
+    # @param [Hash] params ({})
+    def list_versions(params = {}, options = {})
+      req = build_request(:list_versions, params)
+      req.send_request(options)
+    end
+
     # 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][1].
@@ -1180,7 +1233,7 @@ module Aws::ManagedGrafana
     #   resp.workspaces[0].name #=> String
     #   resp.workspaces[0].notification_destinations #=> Array
     #   resp.workspaces[0].notification_destinations[0] #=> String, one of "SNS"
-    #   resp.workspaces[0].status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED"
+    #   resp.workspaces[0].status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED", "VERSION_UPDATING", "VERSION_UPDATE_FAILED"
     #   resp.workspaces[0].tags #=> Hash
     #   resp.workspaces[0].tags["TagKey"] #=> String
     #
@@ -1495,7 +1548,7 @@ module Aws::ManagedGrafana
     #   resp.workspace.organizational_units[0] #=> String
     #   resp.workspace.permission_type #=> String, one of "CUSTOMER_MANAGED", "SERVICE_MANAGED"
     #   resp.workspace.stack_set_name #=> String
-    #   resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED"
+    #   resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED", "VERSION_UPDATING", "VERSION_UPDATE_FAILED"
     #   resp.workspace.tags #=> Hash
     #   resp.workspace.tags["TagKey"] #=> String
     #   resp.workspace.vpc_configuration.security_group_ids #=> Array
@@ -1620,6 +1673,15 @@ module Aws::ManagedGrafana
     #
     #   [1]: https://docs.aws.amazon.com/grafana/latest/userguide/AMG-configure-workspace.html
     #
+    # @option params [String] :grafana_version
+    #   Specifies the version of Grafana to support in the new workspace.
+    #
+    #   Can only be used to upgrade (for example, from 8.4 to 9.4), not
+    #   downgrade (for example, from 9.4 to 8.4).
+    #
+    #   To know what versions are available to upgrade to for a specific
+    #   workspace, see the `ListVersions` operation.
+    #
     # @option params [required, String] :workspace_id
     #   The ID of the workspace to update.
     #
@@ -1629,6 +1691,7 @@ module Aws::ManagedGrafana
     #
     #   resp = client.update_workspace_configuration({
     #     configuration: "OverridableConfigurationJson", # required
+    #     grafana_version: "GrafanaVersion",
     #     workspace_id: "WorkspaceId", # required
     #   })
     #
@@ -1654,7 +1717,7 @@ module Aws::ManagedGrafana
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-managedgrafana'
-      context[:gem_version] = '1.19.0'
+      context[:gem_version] = '1.20.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-managedgrafana/client_api.rb

@@ -53,6 +53,7 @@ module Aws::ManagedGrafana
     DisassociateLicenseResponse = Shapes::StructureShape.new(name: 'DisassociateLicenseResponse')
     Endpoint = Shapes::StringShape.new(name: 'Endpoint')
     GrafanaVersion = Shapes::StringShape.new(name: 'GrafanaVersion')
+    GrafanaVersionList = Shapes::ListShape.new(name: 'GrafanaVersionList')
     IamRoleArn = Shapes::StringShape.new(name: 'IamRoleArn')
     IdpMetadata = Shapes::UnionShape.new(name: 'IdpMetadata')
     IdpMetadataUrl = Shapes::StringShape.new(name: 'IdpMetadataUrl')
@@ -64,6 +65,9 @@ module Aws::ManagedGrafana
     ListPermissionsResponse = Shapes::StructureShape.new(name: 'ListPermissionsResponse')
     ListTagsForResourceRequest = Shapes::StructureShape.new(name: 'ListTagsForResourceRequest')
     ListTagsForResourceResponse = Shapes::StructureShape.new(name: 'ListTagsForResourceResponse')
+    ListVersionsRequest = Shapes::StructureShape.new(name: 'ListVersionsRequest')
+    ListVersionsRequestMaxResultsInteger = Shapes::IntegerShape.new(name: 'ListVersionsRequestMaxResultsInteger')
+    ListVersionsResponse = Shapes::StructureShape.new(name: 'ListVersionsResponse')
     ListWorkspacesRequest = Shapes::StructureShape.new(name: 'ListWorkspacesRequest')
     ListWorkspacesRequestMaxResultsInteger = Shapes::IntegerShape.new(name: 'ListWorkspacesRequestMaxResultsInteger')
     ListWorkspacesResponse = Shapes::StructureShape.new(name: 'ListWorkspacesResponse')
@@ -237,6 +241,7 @@ module Aws::ManagedGrafana
     DescribeWorkspaceConfigurationRequest.struct_class = Types::DescribeWorkspaceConfigurationRequest
 
     DescribeWorkspaceConfigurationResponse.add_member(:configuration, Shapes::ShapeRef.new(shape: OverridableConfigurationJson, required: true, location_name: "configuration", metadata: {"jsonvalue"=>true}))
+    DescribeWorkspaceConfigurationResponse.add_member(:grafana_version, Shapes::ShapeRef.new(shape: GrafanaVersion, location_name: "grafanaVersion"))
     DescribeWorkspaceConfigurationResponse.struct_class = Types::DescribeWorkspaceConfigurationResponse
 
     DescribeWorkspaceRequest.add_member(:workspace_id, Shapes::ShapeRef.new(shape: WorkspaceId, required: true, location: "uri", location_name: "workspaceId"))
@@ -252,6 +257,8 @@ module Aws::ManagedGrafana
     DisassociateLicenseResponse.add_member(:workspace, Shapes::ShapeRef.new(shape: WorkspaceDescription, required: true, location_name: "workspace"))
     DisassociateLicenseResponse.struct_class = Types::DisassociateLicenseResponse
 
+    GrafanaVersionList.member = Shapes::ShapeRef.new(shape: GrafanaVersion)
+
     IdpMetadata.add_member(:url, Shapes::ShapeRef.new(shape: IdpMetadataUrl, location_name: "url"))
     IdpMetadata.add_member(:xml, Shapes::ShapeRef.new(shape: String, location_name: "xml"))
     IdpMetadata.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
@@ -282,6 +289,15 @@ module Aws::ManagedGrafana
     ListTagsForResourceResponse.add_member(:tags, Shapes::ShapeRef.new(shape: TagMap, location_name: "tags"))
     ListTagsForResourceResponse.struct_class = Types::ListTagsForResourceResponse
 
+    ListVersionsRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: ListVersionsRequestMaxResultsInteger, location: "querystring", location_name: "maxResults"))
+    ListVersionsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location: "querystring", location_name: "nextToken"))
+    ListVersionsRequest.add_member(:workspace_id, Shapes::ShapeRef.new(shape: WorkspaceId, location: "querystring", location_name: "workspace-id"))
+    ListVersionsRequest.struct_class = Types::ListVersionsRequest
+
+    ListVersionsResponse.add_member(:grafana_versions, Shapes::ShapeRef.new(shape: GrafanaVersionList, location_name: "grafanaVersions"))
+    ListVersionsResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location_name: "nextToken"))
+    ListVersionsResponse.struct_class = Types::ListVersionsResponse
+
     ListWorkspacesRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: ListWorkspacesRequestMaxResultsInteger, location: "querystring", location_name: "maxResults"))
     ListWorkspacesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: PaginationToken, location: "querystring", location_name: "nextToken"))
     ListWorkspacesRequest.struct_class = Types::ListWorkspacesRequest
@@ -392,6 +408,7 @@ module Aws::ManagedGrafana
     UpdateWorkspaceAuthenticationResponse.struct_class = Types::UpdateWorkspaceAuthenticationResponse
 
     UpdateWorkspaceConfigurationRequest.add_member(:configuration, Shapes::ShapeRef.new(shape: OverridableConfigurationJson, required: true, location_name: "configuration", metadata: {"jsonvalue"=>true}))
+    UpdateWorkspaceConfigurationRequest.add_member(:grafana_version, Shapes::ShapeRef.new(shape: GrafanaVersion, location_name: "grafanaVersion"))
     UpdateWorkspaceConfigurationRequest.add_member(:workspace_id, Shapes::ShapeRef.new(shape: WorkspaceId, required: true, location: "uri", location_name: "workspaceId"))
     UpdateWorkspaceConfigurationRequest.struct_class = Types::UpdateWorkspaceConfigurationRequest
 
@@ -652,6 +669,25 @@ module Aws::ManagedGrafana
         o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
       end)
 
+      api.add_operation(:list_versions, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListVersions"
+        o.http_method = "GET"
+        o.http_request_uri = "/versions"
+        o.input = Shapes::ShapeRef.new(shape: ListVersionsRequest)
+        o.output = Shapes::ShapeRef.new(shape: ListVersionsResponse)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: ValidationException)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o[:pager] = Aws::Pager.new(
+          limit_key: "max_results",
+          tokens: {
+            "next_token" => "next_token"
+          }
+        )
+      end)
+
       api.add_operation(:list_workspaces, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListWorkspaces"
         o.http_method = "GET"

data/lib/aws-sdk-managedgrafana/endpoints.rb

@@ -166,6 +166,20 @@ module Aws::ManagedGrafana
       end
     end
 
+    class ListVersions
+      def self.build(context)
+        unless context.config.regional_endpoint
+          endpoint = context.config.endpoint.to_s
+        end
+        Aws::ManagedGrafana::EndpointParameters.new(
+          region: context.config.region,
+          use_dual_stack: context.config.use_dualstack_endpoint,
+          use_fips: context.config.use_fips_endpoint,
+          endpoint: endpoint,
+        )
+      end
+    end
+
     class ListWorkspaces
       def self.build(context)
         unless context.config.regional_endpoint

data/lib/aws-sdk-managedgrafana/plugins/endpoints.rb

@@ -78,6 +78,8 @@ module Aws::ManagedGrafana
             Aws::ManagedGrafana::Endpoints::ListPermissions.build(context)
           when :list_tags_for_resource
             Aws::ManagedGrafana::Endpoints::ListTagsForResource.build(context)
+          when :list_versions
+            Aws::ManagedGrafana::Endpoints::ListVersions.build(context)
           when :list_workspaces
             Aws::ManagedGrafana::Endpoints::ListWorkspaces.build(context)
           when :tag_resource

data/lib/aws-sdk-managedgrafana/types.rb

@@ -288,7 +288,8 @@ module Aws::ManagedGrafana
     # @!attribute [rw] grafana_version
     #   Specifies the version of Grafana to support in the new workspace.
     #
-    #   Supported values are `8.4` and `9.4`.
+    #   To get a list of supported version, use the `ListVersions`
+    #   operation.
     #   @return [String]
     #
     # @!attribute [rw] network_access_control
@@ -349,6 +350,11 @@ module Aws::ManagedGrafana
     # @!attribute [rw] vpc_configuration
     #   The configuration settings for an Amazon VPC that contains data
     #   sources for your Grafana workspace to connect to.
+    #
+    #   <note markdown="1"> Connecting to a private VPC is not yet available in the Asia Pacific
+    #   (Seoul) Region (ap-northeast-2).
+    #
+    #    </note>
     #   @return [Types::VpcConfiguration]
     #
     # @!attribute [rw] workspace_data_sources
@@ -529,10 +535,15 @@ module Aws::ManagedGrafana
     #   [1]: https://docs.aws.amazon.com/grafana/latest/userguide/AMG-configure-workspace.html
     #   @return [String]
     #
+    # @!attribute [rw] grafana_version
+    #   The supported Grafana version for the workspace.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/grafana-2020-08-18/DescribeWorkspaceConfigurationResponse AWS API Documentation
     #
     class DescribeWorkspaceConfigurationResponse < Struct.new(
-      :configuration)
+      :configuration,
+      :grafana_version)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -727,6 +738,51 @@ module Aws::ManagedGrafana
       include Aws::Structure
     end
 
+    # @!attribute [rw] max_results
+    #   The maximum number of results to include in the response.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] next_token
+    #   The token to use when requesting the next set of results. You
+    #   receive this token from a previous `ListVersions` operation.
+    #   @return [String]
+    #
+    # @!attribute [rw] workspace_id
+    #   The ID of the workspace to list the available upgrade versions. If
+    #   not included, lists all versions of Grafana that are supported for
+    #   `CreateWorkspace`.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/grafana-2020-08-18/ListVersionsRequest AWS API Documentation
+    #
+    class ListVersionsRequest < Struct.new(
+      :max_results,
+      :next_token,
+      :workspace_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] grafana_versions
+    #   The Grafana versions available to create. If a workspace ID is
+    #   included in the request, the Grafana versions to which this
+    #   workspace can be upgraded.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] next_token
+    #   The token to use in a subsequent `ListVersions` operation to return
+    #   the next set of results.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/grafana-2020-08-18/ListVersionsResponse AWS API Documentation
+    #
+    class ListVersionsResponse < Struct.new(
+      :grafana_versions,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @!attribute [rw] max_results
     #   The maximum number of workspaces to include in the results.
     #   @return [Integer]
@@ -768,18 +824,31 @@ module Aws::ManagedGrafana
     #
     # When this is configured, only listed IP addresses and VPC endpoints
     # will be able to access your workspace. Standard Grafana authentication
-    # and authorization will still be required.
+    # and authorization are still required.
+    #
+    # Access is granted to a caller that is in either the IP address list or
+    # the VPC endpoint list - they do not need to be in both.
     #
     # If this is not configured, or is removed, then all IP addresses and
-    # VPC endpoints will be allowed. Standard Grafana authentication and
-    # authorization will still be required.
+    # VPC endpoints are allowed. Standard Grafana authentication and
+    # authorization are still required.
+    #
+    # <note markdown="1"> While both `prefixListIds` and `vpceIds` are required, you can pass in
+    # an empty array of strings for either parameter if you do not want to
+    # allow any of that type.
+    #
+    #  If both are passed as empty arrays, no traffic is allowed to the
+    # workspace, because only *explicitly* allowed connections are accepted.
+    #
+    #  </note>
     #
     # @!attribute [rw] prefix_list_ids
     #   An array of prefix list IDs. A prefix list is a list of CIDR ranges
     #   of IP addresses. The IP addresses specified are allowed to access
     #   your workspace. If the list is not included in the configuration
-    #   then no IP addresses will be allowed to access the workspace. You
-    #   create a prefix list using the Amazon VPC console.
+    #   (passed an empty array) then no IP addresses are allowed to access
+    #   the workspace. You create a prefix list using the Amazon VPC
+    #   console.
     #
     #   Prefix list IDs have the format `pl-1a2b3c4d `.
     #
@@ -796,8 +865,9 @@ module Aws::ManagedGrafana
     #   An array of Amazon VPC endpoint IDs for the workspace. You can
     #   create VPC endpoints to your Amazon Managed Grafana workspace for
     #   access from within a VPC. If a `NetworkAccessConfiguration` is
-    #   specified then only VPC endpoints specified here will be allowed to
-    #   access the workspace.
+    #   specified then only VPC endpoints specified here are allowed to
+    #   access the workspace. If you pass in an empty array of strings, then
+    #   no VPCs are allowed to access the workspace.
     #
     #   VPC endpoint IDs have the format `vpce-1a2b3c4d `.
     #
@@ -808,7 +878,7 @@ module Aws::ManagedGrafana
     #   <note markdown="1"> The only VPC endpoints that can be specified here are interface VPC
     #   endpoints for Grafana workspaces (using the
     #   `com.amazonaws.[region].grafana-workspace` service endpoint). Other
-    #   VPC endpoints will be ignored.
+    #   VPC endpoints are ignored.
     #
     #    </note>
     #
@@ -1212,6 +1282,16 @@ module Aws::ManagedGrafana
     #   [1]: https://docs.aws.amazon.com/grafana/latest/userguide/AMG-configure-workspace.html
     #   @return [String]
     #
+    # @!attribute [rw] grafana_version
+    #   Specifies the version of Grafana to support in the new workspace.
+    #
+    #   Can only be used to upgrade (for example, from 8.4 to 9.4), not
+    #   downgrade (for example, from 9.4 to 8.4).
+    #
+    #   To know what versions are available to upgrade to for a specific
+    #   workspace, see the `ListVersions` operation.
+    #   @return [String]
+    #
     # @!attribute [rw] workspace_id
     #   The ID of the workspace to update.
     #   @return [String]
@@ -1220,6 +1300,7 @@ module Aws::ManagedGrafana
     #
     class UpdateWorkspaceConfigurationRequest < Struct.new(
       :configuration,
+      :grafana_version,
       :workspace_id)
       SENSITIVE = []
       include Aws::Structure
@@ -1463,6 +1544,9 @@ module Aws::ManagedGrafana
     # <note markdown="1"> Provided `securityGroupIds` and `subnetIds` must be part of the same
     # VPC.
     #
+    #  Connecting to a private VPC is not yet available in the Asia Pacific
+    # (Seoul) Region (ap-northeast-2).
+    #
     #  </note>
     #
     # @!attribute [rw] security_group_ids

data/lib/aws-sdk-managedgrafana.rb

@@ -52,6 +52,6 @@ require_relative 'aws-sdk-managedgrafana/customizations'
 # @!group service
 module Aws::ManagedGrafana
 
-  GEM_VERSION = '1.19.0'
+  GEM_VERSION = '1.20.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-managedgrafana
 version: !ruby/object:Gem::Version
-  version: 1.19.0
+  version: 1.20.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-07-11 00:00:00.000000000 Z
+date: 2023-07-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core