aws-sdk-managedgrafana 1.8.0 → 1.10.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: fc8e6f4657047140c76d7e67e03d5e597c6f198c4eca53f6c836e8540f4e729c
4
- data.tar.gz: 4fba88dce5a57ebf73610fbd32076467149489e18f56f9843ea2c1cbf1e88c2e
3
+ metadata.gz: 98a3805f6f6c020f69a8681129b0ff5ebce892f8a0b4d2536cfa7abeca8f4cc5
4
+ data.tar.gz: 6c5f9dda87b536a675bf8e25613e79ca974371cdc30eb911eb58898624a6ffa4
5
5
  SHA512:
6
- metadata.gz: 8bbb7a0dd95cf6e0d5727475f10b7a5867e58b4a74c9ed79147fc58b974c1e62750c4a20ff38b7fb51f2343f04f220a2339473485ce2dd045a01d557bfbd0406
7
- data.tar.gz: 819600eb6c12c6325cc3b7b6eecac7f239a65a71d62b1a0baa1766b313cd4468d0ba90e0907f35fcc00b478c7efd040a82d110acd2d93ca40c405132eb416f88
6
+ metadata.gz: c878b1d4197f1c82ba977f416ba7891e6877f5bc9c92630b78f8e7cda676b1e4dfbec83adf97a252c83b3aeec715d392be3162b0e946724bb7c3b03b2a756232
7
+ data.tar.gz: 6c33ed2eb57ea1317c67c769e28c4a5d919a2cfbd564bd8f1813bf1d5edc80c65266bdd8497c707bef5b64c735b2604b745402955081fcab4bfd81991c3e28f0
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.10.0 (2022-11-23)
5
+ ------------------
6
+
7
+ * Feature - This release includes support for configuring a Grafana workspace to connect to a datasource within a VPC as well as new APIs for configuring Grafana settings.
8
+
9
+ 1.9.0 (2022-10-25)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
4
14
  1.8.0 (2022-05-13)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.8.0
1
+ 1.10.0
@@ -30,7 +30,7 @@ require 'aws-sdk-core/plugins/http_checksum.rb'
30
30
  require 'aws-sdk-core/plugins/checksum_algorithm.rb'
31
31
  require 'aws-sdk-core/plugins/defaults_mode.rb'
32
32
  require 'aws-sdk-core/plugins/recursion_detection.rb'
33
- require 'aws-sdk-core/plugins/signature_v4.rb'
33
+ require 'aws-sdk-core/plugins/sign.rb'
34
34
  require 'aws-sdk-core/plugins/protocols/rest_json.rb'
35
35
 
36
36
  Aws::Plugins::GlobalConfiguration.add_identifier(:managedgrafana)
@@ -79,8 +79,9 @@ module Aws::ManagedGrafana
79
79
  add_plugin(Aws::Plugins::ChecksumAlgorithm)
80
80
  add_plugin(Aws::Plugins::DefaultsMode)
81
81
  add_plugin(Aws::Plugins::RecursionDetection)
82
- add_plugin(Aws::Plugins::SignatureV4)
82
+ add_plugin(Aws::Plugins::Sign)
83
83
  add_plugin(Aws::Plugins::Protocols::RestJson)
84
+ add_plugin(Aws::ManagedGrafana::Plugins::Endpoints)
84
85
 
85
86
  # @overload initialize(options)
86
87
  # @param [Hash] options
@@ -287,6 +288,19 @@ module Aws::ManagedGrafana
287
288
  # ** Please note ** When response stubbing is enabled, no HTTP
288
289
  # requests are made, and retries are disabled.
289
290
  #
291
+ # @option options [Aws::TokenProvider] :token_provider
292
+ # A Bearer Token Provider. This can be an instance of any one of the
293
+ # following classes:
294
+ #
295
+ # * `Aws::StaticTokenProvider` - Used for configuring static, non-refreshing
296
+ # tokens.
297
+ #
298
+ # * `Aws::SSOTokenProvider` - Used for loading tokens from AWS SSO using an
299
+ # access token generated from `aws login`.
300
+ #
301
+ # When `:token_provider` is not configured directly, the `Aws::TokenProviderChain`
302
+ # will be used to search for tokens configured for your profile in shared configuration files.
303
+ #
290
304
  # @option options [Boolean] :use_dualstack_endpoint
291
305
  # When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
292
306
  # will be used if available.
@@ -300,6 +314,9 @@ module Aws::ManagedGrafana
300
314
  # When `true`, request parameters are validated before
301
315
  # sending the request.
302
316
  #
317
+ # @option options [Aws::ManagedGrafana::EndpointProvider] :endpoint_provider
318
+ # The endpoint provider used to resolve endpoints. Any object that responds to `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::ManagedGrafana::EndpointParameters`
319
+ #
303
320
  # @option options [URI::HTTP,String] :http_proxy A proxy to send
304
321
  # requests through. Formatted like 'http://proxy.com:123'.
305
322
  #
@@ -384,7 +401,7 @@ module Aws::ManagedGrafana
384
401
  # resp.workspace.authentication.saml_configuration_status #=> String, one of "CONFIGURED", "NOT_CONFIGURED"
385
402
  # resp.workspace.created #=> Time
386
403
  # resp.workspace.data_sources #=> Array
387
- # resp.workspace.data_sources[0] #=> String, one of "AMAZON_OPENSEARCH_SERVICE", "CLOUDWATCH", "PROMETHEUS", "XRAY", "TIMESTREAM", "SITEWISE", "ATHENA", "REDSHIFT"
404
+ # resp.workspace.data_sources[0] #=> String, one of "AMAZON_OPENSEARCH_SERVICE", "CLOUDWATCH", "PROMETHEUS", "XRAY", "TIMESTREAM", "SITEWISE", "ATHENA", "REDSHIFT", "TWINMAKER"
388
405
  # resp.workspace.description #=> String
389
406
  # resp.workspace.endpoint #=> String
390
407
  # resp.workspace.free_trial_consumed #=> Boolean
@@ -405,6 +422,10 @@ module Aws::ManagedGrafana
405
422
  # resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED"
406
423
  # resp.workspace.tags #=> Hash
407
424
  # resp.workspace.tags["TagKey"] #=> String
425
+ # resp.workspace.vpc_configuration.security_group_ids #=> Array
426
+ # resp.workspace.vpc_configuration.security_group_ids[0] #=> String
427
+ # resp.workspace.vpc_configuration.subnet_ids #=> Array
428
+ # resp.workspace.vpc_configuration.subnet_ids[0] #=> String
408
429
  # resp.workspace.workspace_role_arn #=> String
409
430
  #
410
431
  # @see http://docs.aws.amazon.com/goto/WebAPI/grafana-2020-08-18/AssociateLicense AWS API Documentation
@@ -437,10 +458,10 @@ module Aws::ManagedGrafana
437
458
  # `workspaceOrganizationalUnits` parameter.
438
459
  #
439
460
  # @option params [required, Array<String>] :authentication_providers
440
- # Specifies whether this workspace uses SAML 2.0, Amazon Web Services
441
- # Single Sign On, or both to authenticate users for using the Grafana
442
- # console within a workspace. For more information, see [User
443
- # authentication in Amazon Managed Grafana][1].
461
+ # Specifies whether this workspace uses SAML 2.0, IAM Identity Center
462
+ # (successor to Single Sign-On), or both to authenticate users for using
463
+ # the Grafana console within a workspace. For more information, see
464
+ # [User authentication in Amazon Managed Grafana][1].
444
465
  #
445
466
  #
446
467
  #
@@ -453,6 +474,19 @@ module Aws::ManagedGrafana
453
474
  # **A suitable default value is auto-generated.** You should normally
454
475
  # not need to pass this option.**
455
476
  #
477
+ # @option params [String] :configuration
478
+ # The configuration string for the workspace that you create. For more
479
+ # information about the format and configuration options available, see
480
+ # [Working in your Grafana workspace][1].
481
+ #
482
+ # **SDK automatically handles json encoding and base64 encoding for you
483
+ # when the required value (Hash, Array, etc.) is provided according to
484
+ # the description.**
485
+ #
486
+ #
487
+ #
488
+ # [1]: https://docs.aws.amazon.com/grafana/latest/userguide/AMG-configure-workspace.html
489
+ #
456
490
  # @option params [String] :organization_role_name
457
491
  # The name of an IAM role that already exists to use with Organizations
458
492
  # to access Amazon Web Services data sources and notification channels
@@ -462,8 +496,12 @@ module Aws::ManagedGrafana
462
496
  # If you specify `SERVICE_MANAGED` on AWS Grafana console, Amazon
463
497
  # Managed Grafana automatically creates the IAM roles and provisions the
464
498
  # permissions that the workspace needs to use Amazon Web Services data
465
- # sources and notification channels. In CLI mode, the permissionType
466
- # `SERVICE_MANAGED` will not create the IAM role for you.
499
+ # sources and notification channels. In the CLI mode, the permissionType
500
+ # `SERVICE_MANAGED` will not create the IAM role for you. The ability
501
+ # for the Amazon Managed Grafana to create the IAM role on behalf of the
502
+ # user is supported only in the Amazon Managed Grafana AWS console. Use
503
+ # only the `CUSTOMER_MANAGED` permission type when creating a workspace
504
+ # in the CLI.
467
505
  #
468
506
  # If you specify `CUSTOMER_MANAGED`, you will manage those roles and
469
507
  # permissions yourself. If you are creating this workspace in a member
@@ -487,6 +525,10 @@ module Aws::ManagedGrafana
487
525
  # @option params [Hash<String,String>] :tags
488
526
  # The list of tags associated with the workspace.
489
527
  #
528
+ # @option params [Types::VpcConfiguration] :vpc_configuration
529
+ # The configuration settings for an Amazon VPC that contains data
530
+ # sources for your Grafana workspace to connect to.
531
+ #
490
532
  # @option params [Array<String>] :workspace_data_sources
491
533
  # Specify the Amazon Web Services data sources that you want to be
492
534
  # queried in this workspace. Specifying these data sources here enables
@@ -534,13 +576,18 @@ module Aws::ManagedGrafana
534
576
  # account_access_type: "CURRENT_ACCOUNT", # required, accepts CURRENT_ACCOUNT, ORGANIZATION
535
577
  # authentication_providers: ["AWS_SSO"], # required, accepts AWS_SSO, SAML
536
578
  # client_token: "ClientToken",
579
+ # configuration: "OverridableConfigurationJson",
537
580
  # organization_role_name: "OrganizationRoleName",
538
581
  # permission_type: "CUSTOMER_MANAGED", # required, accepts CUSTOMER_MANAGED, SERVICE_MANAGED
539
582
  # stack_set_name: "StackSetName",
540
583
  # tags: {
541
584
  # "TagKey" => "TagValue",
542
585
  # },
543
- # workspace_data_sources: ["AMAZON_OPENSEARCH_SERVICE"], # accepts AMAZON_OPENSEARCH_SERVICE, CLOUDWATCH, PROMETHEUS, XRAY, TIMESTREAM, SITEWISE, ATHENA, REDSHIFT
586
+ # vpc_configuration: {
587
+ # security_group_ids: ["SecurityGroupId"], # required
588
+ # subnet_ids: ["SubnetId"], # required
589
+ # },
590
+ # workspace_data_sources: ["AMAZON_OPENSEARCH_SERVICE"], # accepts AMAZON_OPENSEARCH_SERVICE, CLOUDWATCH, PROMETHEUS, XRAY, TIMESTREAM, SITEWISE, ATHENA, REDSHIFT, TWINMAKER
544
591
  # workspace_description: "Description",
545
592
  # workspace_name: "WorkspaceName",
546
593
  # workspace_notification_destinations: ["SNS"], # accepts SNS
@@ -556,7 +603,7 @@ module Aws::ManagedGrafana
556
603
  # resp.workspace.authentication.saml_configuration_status #=> String, one of "CONFIGURED", "NOT_CONFIGURED"
557
604
  # resp.workspace.created #=> Time
558
605
  # resp.workspace.data_sources #=> Array
559
- # resp.workspace.data_sources[0] #=> String, one of "AMAZON_OPENSEARCH_SERVICE", "CLOUDWATCH", "PROMETHEUS", "XRAY", "TIMESTREAM", "SITEWISE", "ATHENA", "REDSHIFT"
606
+ # resp.workspace.data_sources[0] #=> String, one of "AMAZON_OPENSEARCH_SERVICE", "CLOUDWATCH", "PROMETHEUS", "XRAY", "TIMESTREAM", "SITEWISE", "ATHENA", "REDSHIFT", "TWINMAKER"
560
607
  # resp.workspace.description #=> String
561
608
  # resp.workspace.endpoint #=> String
562
609
  # resp.workspace.free_trial_consumed #=> Boolean
@@ -577,6 +624,10 @@ module Aws::ManagedGrafana
577
624
  # resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED"
578
625
  # resp.workspace.tags #=> Hash
579
626
  # resp.workspace.tags["TagKey"] #=> String
627
+ # resp.workspace.vpc_configuration.security_group_ids #=> Array
628
+ # resp.workspace.vpc_configuration.security_group_ids[0] #=> String
629
+ # resp.workspace.vpc_configuration.subnet_ids #=> Array
630
+ # resp.workspace.vpc_configuration.subnet_ids[0] #=> String
580
631
  # resp.workspace.workspace_role_arn #=> String
581
632
  #
582
633
  # @see http://docs.aws.amazon.com/goto/WebAPI/grafana-2020-08-18/CreateWorkspace AWS API Documentation
@@ -588,27 +639,30 @@ module Aws::ManagedGrafana
588
639
  req.send_request(options)
589
640
  end
590
641
 
591
- # Creates an API key for the workspace. This key can be used to
592
- # authenticate requests sent to the workspace's HTTP API. See [
593
- # https://docs.aws.amazon.com/grafana/latest/userguide/Using-Grafana-APIs.html](
594
- # https://docs.aws.amazon.com/grafana/latest/userguide/Using-Grafana-APIs.html)
642
+ # Creates a Grafana API key for the workspace. This key can be used to
643
+ # authenticate requests sent to the workspace's HTTP API. See
644
+ # [https://docs.aws.amazon.com/grafana/latest/userguide/Using-Grafana-APIs.html][1]
595
645
  # for available APIs and example requests.
596
646
  #
647
+ #
648
+ #
649
+ # [1]: https://docs.aws.amazon.com/grafana/latest/userguide/Using-Grafana-APIs.html
650
+ #
597
651
  # @option params [required, String] :key_name
598
- # Specifies the name of the key to create. Key names must be unique to
599
- # the workspace.
652
+ # Specifies the name of the key. Keynames must be unique to the
653
+ # workspace.
600
654
  #
601
655
  # @option params [required, String] :key_role
602
656
  # Specifies the permission level of the key.
603
657
  #
604
- # Valid Values: `VIEWER` \| `EDITOR` \| `ADMIN`
658
+ # Valid values: `VIEWER`\|`EDITOR`\|`ADMIN`
605
659
  #
606
660
  # @option params [required, Integer] :seconds_to_live
607
661
  # Specifies the time in seconds until the key expires. Keys can be valid
608
662
  # for up to 30 days.
609
663
  #
610
664
  # @option params [required, String] :workspace_id
611
- # The ID of the workspace in which to create an API key.
665
+ # The ID of the workspace to create an API key.
612
666
  #
613
667
  # @return [Types::CreateWorkspaceApiKeyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
614
668
  #
@@ -663,7 +717,7 @@ module Aws::ManagedGrafana
663
717
  # resp.workspace.authentication.saml_configuration_status #=> String, one of "CONFIGURED", "NOT_CONFIGURED"
664
718
  # resp.workspace.created #=> Time
665
719
  # resp.workspace.data_sources #=> Array
666
- # resp.workspace.data_sources[0] #=> String, one of "AMAZON_OPENSEARCH_SERVICE", "CLOUDWATCH", "PROMETHEUS", "XRAY", "TIMESTREAM", "SITEWISE", "ATHENA", "REDSHIFT"
720
+ # resp.workspace.data_sources[0] #=> String, one of "AMAZON_OPENSEARCH_SERVICE", "CLOUDWATCH", "PROMETHEUS", "XRAY", "TIMESTREAM", "SITEWISE", "ATHENA", "REDSHIFT", "TWINMAKER"
667
721
  # resp.workspace.description #=> String
668
722
  # resp.workspace.endpoint #=> String
669
723
  # resp.workspace.free_trial_consumed #=> Boolean
@@ -684,6 +738,10 @@ module Aws::ManagedGrafana
684
738
  # resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED"
685
739
  # resp.workspace.tags #=> Hash
686
740
  # resp.workspace.tags["TagKey"] #=> String
741
+ # resp.workspace.vpc_configuration.security_group_ids #=> Array
742
+ # resp.workspace.vpc_configuration.security_group_ids[0] #=> String
743
+ # resp.workspace.vpc_configuration.subnet_ids #=> Array
744
+ # resp.workspace.vpc_configuration.subnet_ids[0] #=> String
687
745
  # resp.workspace.workspace_role_arn #=> String
688
746
  #
689
747
  # @see http://docs.aws.amazon.com/goto/WebAPI/grafana-2020-08-18/DeleteWorkspace AWS API Documentation
@@ -695,7 +753,7 @@ module Aws::ManagedGrafana
695
753
  req.send_request(options)
696
754
  end
697
755
 
698
- # Deletes an API key for a workspace.
756
+ # Deletes a Grafana API key for the workspace.
699
757
  #
700
758
  # @option params [required, String] :key_name
701
759
  # The name of the API key to delete.
@@ -752,7 +810,7 @@ module Aws::ManagedGrafana
752
810
  # resp.workspace.authentication.saml_configuration_status #=> String, one of "CONFIGURED", "NOT_CONFIGURED"
753
811
  # resp.workspace.created #=> Time
754
812
  # resp.workspace.data_sources #=> Array
755
- # resp.workspace.data_sources[0] #=> String, one of "AMAZON_OPENSEARCH_SERVICE", "CLOUDWATCH", "PROMETHEUS", "XRAY", "TIMESTREAM", "SITEWISE", "ATHENA", "REDSHIFT"
813
+ # resp.workspace.data_sources[0] #=> String, one of "AMAZON_OPENSEARCH_SERVICE", "CLOUDWATCH", "PROMETHEUS", "XRAY", "TIMESTREAM", "SITEWISE", "ATHENA", "REDSHIFT", "TWINMAKER"
756
814
  # resp.workspace.description #=> String
757
815
  # resp.workspace.endpoint #=> String
758
816
  # resp.workspace.free_trial_consumed #=> Boolean
@@ -773,6 +831,10 @@ module Aws::ManagedGrafana
773
831
  # resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED"
774
832
  # resp.workspace.tags #=> Hash
775
833
  # resp.workspace.tags["TagKey"] #=> String
834
+ # resp.workspace.vpc_configuration.security_group_ids #=> Array
835
+ # resp.workspace.vpc_configuration.security_group_ids[0] #=> String
836
+ # resp.workspace.vpc_configuration.subnet_ids #=> Array
837
+ # resp.workspace.vpc_configuration.subnet_ids[0] #=> String
776
838
  # resp.workspace.workspace_role_arn #=> String
777
839
  #
778
840
  # @see http://docs.aws.amazon.com/goto/WebAPI/grafana-2020-08-18/DescribeWorkspace AWS API Documentation
@@ -831,6 +893,34 @@ module Aws::ManagedGrafana
831
893
  req.send_request(options)
832
894
  end
833
895
 
896
+ # Gets the current configuration string for the given workspace.
897
+ #
898
+ # @option params [required, String] :workspace_id
899
+ # The ID of the workspace to get configuration information for.
900
+ #
901
+ # @return [Types::DescribeWorkspaceConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
902
+ #
903
+ # * {Types::DescribeWorkspaceConfigurationResponse#configuration #configuration} => String
904
+ #
905
+ # @example Request syntax with placeholder values
906
+ #
907
+ # resp = client.describe_workspace_configuration({
908
+ # workspace_id: "WorkspaceId", # required
909
+ # })
910
+ #
911
+ # @example Response structure
912
+ #
913
+ # resp.configuration #=> String
914
+ #
915
+ # @see http://docs.aws.amazon.com/goto/WebAPI/grafana-2020-08-18/DescribeWorkspaceConfiguration AWS API Documentation
916
+ #
917
+ # @overload describe_workspace_configuration(params = {})
918
+ # @param [Hash] params ({})
919
+ def describe_workspace_configuration(params = {}, options = {})
920
+ req = build_request(:describe_workspace_configuration, params)
921
+ req.send_request(options)
922
+ end
923
+
834
924
  # Removes the Grafana Enterprise license from a workspace.
835
925
  #
836
926
  # @option params [required, String] :license_type
@@ -858,7 +948,7 @@ module Aws::ManagedGrafana
858
948
  # resp.workspace.authentication.saml_configuration_status #=> String, one of "CONFIGURED", "NOT_CONFIGURED"
859
949
  # resp.workspace.created #=> Time
860
950
  # resp.workspace.data_sources #=> Array
861
- # resp.workspace.data_sources[0] #=> String, one of "AMAZON_OPENSEARCH_SERVICE", "CLOUDWATCH", "PROMETHEUS", "XRAY", "TIMESTREAM", "SITEWISE", "ATHENA", "REDSHIFT"
951
+ # resp.workspace.data_sources[0] #=> String, one of "AMAZON_OPENSEARCH_SERVICE", "CLOUDWATCH", "PROMETHEUS", "XRAY", "TIMESTREAM", "SITEWISE", "ATHENA", "REDSHIFT", "TWINMAKER"
862
952
  # resp.workspace.description #=> String
863
953
  # resp.workspace.endpoint #=> String
864
954
  # resp.workspace.free_trial_consumed #=> Boolean
@@ -879,6 +969,10 @@ module Aws::ManagedGrafana
879
969
  # resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED"
880
970
  # resp.workspace.tags #=> Hash
881
971
  # resp.workspace.tags["TagKey"] #=> String
972
+ # resp.workspace.vpc_configuration.security_group_ids #=> Array
973
+ # resp.workspace.vpc_configuration.security_group_ids[0] #=> String
974
+ # resp.workspace.vpc_configuration.subnet_ids #=> Array
975
+ # resp.workspace.vpc_configuration.subnet_ids[0] #=> String
882
976
  # resp.workspace.workspace_role_arn #=> String
883
977
  #
884
978
  # @see http://docs.aws.amazon.com/goto/WebAPI/grafana-2020-08-18/DisassociateLicense AWS API Documentation
@@ -911,10 +1005,9 @@ module Aws::ManagedGrafana
911
1005
  # (Optional) Limits the results to only the user that matches this ID.
912
1006
  #
913
1007
  # @option params [String] :user_type
914
- # (Optional) If you specify `SSO_USER`, then only the permissions of
915
- # Amazon Web Services SSO users are returned. If you specify
916
- # `SSO_GROUP`, only the permissions of Amazon Web Services SSO groups
917
- # are returned.
1008
+ # (Optional) If you specify `SSO_USER`, then only the permissions of IAM
1009
+ # Identity Center users are returned. If you specify `SSO_GROUP`, only
1010
+ # the permissions of IAM Identity Center groups are returned.
918
1011
  #
919
1012
  # @option params [required, String] :workspace_id
920
1013
  # The ID of the workspace to list permissions for. This parameter is
@@ -1165,7 +1258,7 @@ module Aws::ManagedGrafana
1165
1258
  # those parameters are not changed.
1166
1259
  #
1167
1260
  # To modify the user authentication methods that the workspace uses,
1168
- # such as SAML or Amazon Web Services SSO, use
1261
+ # such as SAML or IAM Identity Center, use
1169
1262
  # [UpdateWorkspaceAuthentication][1].
1170
1263
  #
1171
1264
  # To modify which users in the workspace have the `Admin` and `Editor`
@@ -1209,10 +1302,20 @@ module Aws::ManagedGrafana
1209
1302
  #
1210
1303
  # [1]: https://docs.aws.amazon.com/grafana/latest/userguide/AMG-manage-permissions.html
1211
1304
  #
1305
+ # @option params [Boolean] :remove_vpc_configuration
1306
+ # Whether to remove the VPC configuration from the workspace.
1307
+ #
1308
+ # Setting this to `true` and providing a `vpcConfiguration` to set will
1309
+ # return an error.
1310
+ #
1212
1311
  # @option params [String] :stack_set_name
1213
1312
  # The name of the CloudFormation stack set to use to generate IAM roles
1214
1313
  # to be used for this workspace.
1215
1314
  #
1315
+ # @option params [Types::VpcConfiguration] :vpc_configuration
1316
+ # The configuration settings for an Amazon VPC that contains data
1317
+ # sources for your Grafana workspace to connect to.
1318
+ #
1216
1319
  # @option params [Array<String>] :workspace_data_sources
1217
1320
  # Specify the Amazon Web Services data sources that you want to be
1218
1321
  # queried in this workspace. Specifying these data sources here enables
@@ -1263,8 +1366,13 @@ module Aws::ManagedGrafana
1263
1366
  # account_access_type: "CURRENT_ACCOUNT", # accepts CURRENT_ACCOUNT, ORGANIZATION
1264
1367
  # organization_role_name: "OrganizationRoleName",
1265
1368
  # permission_type: "CUSTOMER_MANAGED", # accepts CUSTOMER_MANAGED, SERVICE_MANAGED
1369
+ # remove_vpc_configuration: false,
1266
1370
  # stack_set_name: "StackSetName",
1267
- # workspace_data_sources: ["AMAZON_OPENSEARCH_SERVICE"], # accepts AMAZON_OPENSEARCH_SERVICE, CLOUDWATCH, PROMETHEUS, XRAY, TIMESTREAM, SITEWISE, ATHENA, REDSHIFT
1371
+ # vpc_configuration: {
1372
+ # security_group_ids: ["SecurityGroupId"], # required
1373
+ # subnet_ids: ["SubnetId"], # required
1374
+ # },
1375
+ # workspace_data_sources: ["AMAZON_OPENSEARCH_SERVICE"], # accepts AMAZON_OPENSEARCH_SERVICE, CLOUDWATCH, PROMETHEUS, XRAY, TIMESTREAM, SITEWISE, ATHENA, REDSHIFT, TWINMAKER
1268
1376
  # workspace_description: "Description",
1269
1377
  # workspace_id: "WorkspaceId", # required
1270
1378
  # workspace_name: "WorkspaceName",
@@ -1281,7 +1389,7 @@ module Aws::ManagedGrafana
1281
1389
  # resp.workspace.authentication.saml_configuration_status #=> String, one of "CONFIGURED", "NOT_CONFIGURED"
1282
1390
  # resp.workspace.created #=> Time
1283
1391
  # resp.workspace.data_sources #=> Array
1284
- # resp.workspace.data_sources[0] #=> String, one of "AMAZON_OPENSEARCH_SERVICE", "CLOUDWATCH", "PROMETHEUS", "XRAY", "TIMESTREAM", "SITEWISE", "ATHENA", "REDSHIFT"
1392
+ # resp.workspace.data_sources[0] #=> String, one of "AMAZON_OPENSEARCH_SERVICE", "CLOUDWATCH", "PROMETHEUS", "XRAY", "TIMESTREAM", "SITEWISE", "ATHENA", "REDSHIFT", "TWINMAKER"
1285
1393
  # resp.workspace.description #=> String
1286
1394
  # resp.workspace.endpoint #=> String
1287
1395
  # resp.workspace.free_trial_consumed #=> Boolean
@@ -1302,6 +1410,10 @@ module Aws::ManagedGrafana
1302
1410
  # resp.workspace.status #=> String, one of "ACTIVE", "CREATING", "DELETING", "FAILED", "UPDATING", "UPGRADING", "DELETION_FAILED", "CREATION_FAILED", "UPDATE_FAILED", "UPGRADE_FAILED", "LICENSE_REMOVAL_FAILED"
1303
1411
  # resp.workspace.tags #=> Hash
1304
1412
  # resp.workspace.tags["TagKey"] #=> String
1413
+ # resp.workspace.vpc_configuration.security_group_ids #=> Array
1414
+ # resp.workspace.vpc_configuration.security_group_ids[0] #=> String
1415
+ # resp.workspace.vpc_configuration.subnet_ids #=> Array
1416
+ # resp.workspace.vpc_configuration.subnet_ids[0] #=> String
1305
1417
  # resp.workspace.workspace_role_arn #=> String
1306
1418
  #
1307
1419
  # @see http://docs.aws.amazon.com/goto/WebAPI/grafana-2020-08-18/UpdateWorkspace AWS API Documentation
@@ -1320,10 +1432,10 @@ module Aws::ManagedGrafana
1320
1432
  # roles in the workspace.
1321
1433
  #
1322
1434
  # @option params [required, Array<String>] :authentication_providers
1323
- # Specifies whether this workspace uses SAML 2.0, Amazon Web Services
1324
- # Single Sign On, or both to authenticate users for using the Grafana
1325
- # console within a workspace. For more information, see [User
1326
- # authentication in Amazon Managed Grafana][1].
1435
+ # Specifies whether this workspace uses SAML 2.0, IAM Identity Center
1436
+ # (successor to Single Sign-On), or both to authenticate users for using
1437
+ # the Grafana console within a workspace. For more information, see
1438
+ # [User authentication in Amazon Managed Grafana][1].
1327
1439
  #
1328
1440
  #
1329
1441
  #
@@ -1400,6 +1512,42 @@ module Aws::ManagedGrafana
1400
1512
  req.send_request(options)
1401
1513
  end
1402
1514
 
1515
+ # Updates the configuration string for the given workspace
1516
+ #
1517
+ # @option params [required, String] :configuration
1518
+ # The new configuration string for the workspace. For more information
1519
+ # about the format and configuration options available, see [Working in
1520
+ # your Grafana workspace][1].
1521
+ #
1522
+ # **SDK automatically handles json encoding and base64 encoding for you
1523
+ # when the required value (Hash, Array, etc.) is provided according to
1524
+ # the description.**
1525
+ #
1526
+ #
1527
+ #
1528
+ # [1]: https://docs.aws.amazon.com/grafana/latest/userguide/AMG-configure-workspace.html
1529
+ #
1530
+ # @option params [required, String] :workspace_id
1531
+ # The ID of the workspace to update.
1532
+ #
1533
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1534
+ #
1535
+ # @example Request syntax with placeholder values
1536
+ #
1537
+ # resp = client.update_workspace_configuration({
1538
+ # configuration: "OverridableConfigurationJson", # required
1539
+ # workspace_id: "WorkspaceId", # required
1540
+ # })
1541
+ #
1542
+ # @see http://docs.aws.amazon.com/goto/WebAPI/grafana-2020-08-18/UpdateWorkspaceConfiguration AWS API Documentation
1543
+ #
1544
+ # @overload update_workspace_configuration(params = {})
1545
+ # @param [Hash] params ({})
1546
+ def update_workspace_configuration(params = {}, options = {})
1547
+ req = build_request(:update_workspace_configuration, params)
1548
+ req.send_request(options)
1549
+ end
1550
+
1403
1551
  # @!endgroup
1404
1552
 
1405
1553
  # @param params ({})
@@ -1413,7 +1561,7 @@ module Aws::ManagedGrafana
1413
1561
  params: params,
1414
1562
  config: config)
1415
1563
  context[:gem_name] = 'aws-sdk-managedgrafana'
1416
- context[:gem_version] = '1.8.0'
1564
+ context[:gem_version] = '1.10.0'
1417
1565
  Seahorse::Client::Request.new(handlers, context)
1418
1566
  end
1419
1567