aws-sdk-quicksight 1.131.0 → 1.133.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0372511f866466b8478c48d9c636864914e476a65318353f4295d3a25d0d3f63
-  data.tar.gz: d42a9a1bd45bb61c293e5fbae3295c127cdbfe181c0b4db8c62c24acb14db8a3
+  metadata.gz: b877d5be38c464be1a4893997ef5074faca6cf270c79d4dae513e5b00aeeef5c
+  data.tar.gz: 960243baf521e5ab989bf06b0534457ef8ec079f45f552c22578c5f0e23c6d9b
 SHA512:
-  metadata.gz: 7141d82353c9f85ec4b97f1802a9de4a68be9a6bbeb9c58f1b830cf0d92c433e43f9d979a77cc9587d4719f46fa05687b53133e80026fa01dd532d13cb77ffe8
-  data.tar.gz: 15fde12d1b96d61f8019aba1b94133a130b416b429e82b5e695d2a0601c04da780bf12f16cd01aa397a3e7c1ed0da5c69c42e76717e84e78d60cf9016de8774b
+  metadata.gz: 21c52a7bb865ec2718291f8819f36d5a2262f29272430029636d7a3f3f985fe8f18d9c25cee1c0e07f3c467e7fcf600e9dda1c3b08f68db7ca714d0ebd0a9dd1
+  data.tar.gz: 1452ec78a49a11cdd94af6736835832bc173ac0c1a642f74f3236a9a55e574817622339f92afcadfb2686df28d85a22aba4979a916427024d8e7176ad2b07d89

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.133.0 (2024-10-18)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.132.0 (2024-10-17)
+------------------
+
+* Feature - Add StartDashboardSnapshotJobSchedule API. RestoreAnalysis now supports restoring analysis to folders.
+
 1.131.0 (2024-10-03)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.131.0
+1.133.0

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

@@ -11161,18 +11161,28 @@ module Aws::QuickSight
     # @option params [required, String] :analysis_id
     #   The ID of the analysis that you're restoring.
     #
+    # @option params [Boolean] :restore_to_folders
+    #   A boolean value that determines if the analysis will be restored to
+    #   folders that it previously resided in. A `True` value restores
+    #   analysis back to all folders that it previously resided in. A `False`
+    #   value restores the analysis but does not restore the analysis back to
+    #   all previously resided folders. Restoring a restricted analysis
+    #   requires this parameter to be set to `True`.
+    #
     # @return [Types::RestoreAnalysisResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::RestoreAnalysisResponse#status #status} => Integer
     #   * {Types::RestoreAnalysisResponse#arn #arn} => String
     #   * {Types::RestoreAnalysisResponse#analysis_id #analysis_id} => String
     #   * {Types::RestoreAnalysisResponse#request_id #request_id} => String
+    #   * {Types::RestoreAnalysisResponse#restoration_failed_folder_arns #restoration_failed_folder_arns} => Array<String>
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.restore_analysis({
     #     aws_account_id: "AwsAccountId", # required
     #     analysis_id: "ShortRestrictiveResourceId", # required
+    #     restore_to_folders: false,
     #   })
     #
     # @example Response structure
@@ -11181,6 +11191,8 @@ module Aws::QuickSight
     #   resp.arn #=> String
     #   resp.analysis_id #=> String
     #   resp.request_id #=> String
+    #   resp.restoration_failed_folder_arns #=> Array
+    #   resp.restoration_failed_folder_arns[0] #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/quicksight-2018-04-01/RestoreAnalysis AWS API Documentation
     #
@@ -12414,6 +12426,62 @@ module Aws::QuickSight
       req.send_request(options)
     end
 
+    # Starts an asynchronous job that runs an existing dashboard schedule
+    # and sends the dashboard snapshot through email.
+    #
+    # Only one job can run simultaneously in a given schedule. Repeated
+    # requests are skipped with a `202` HTTP status code.
+    #
+    # For more information, see [Scheduling and sending Amazon QuickSight
+    # reports by email][1] and [Configuring email report settings for a
+    # Amazon QuickSight dashboard][2] in the *Amazon QuickSight User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/quicksight/latest/user/sending-reports.html
+    # [2]: https://docs.aws.amazon.com/quicksight/latest/user/email-reports-from-dashboard.html
+    #
+    # @option params [required, String] :aws_account_id
+    #   The ID of the Amazon Web Services account that the dashboard snapshot
+    #   job is executed in.
+    #
+    # @option params [required, String] :dashboard_id
+    #   The ID of the dashboard that you want to start a snapshot job schedule
+    #   for.
+    #
+    # @option params [required, String] :schedule_id
+    #   The ID of the schedule that you want to start a snapshot job schedule
+    #   for. The schedule ID can be found in the Amazon QuickSight console in
+    #   the **Schedules** pane of the dashboard that the schedule is
+    #   configured for.
+    #
+    # @return [Types::StartDashboardSnapshotJobScheduleResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::StartDashboardSnapshotJobScheduleResponse#request_id #request_id} => String
+    #   * {Types::StartDashboardSnapshotJobScheduleResponse#status #status} => Integer
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.start_dashboard_snapshot_job_schedule({
+    #     aws_account_id: "AwsAccountId", # required
+    #     dashboard_id: "ShortRestrictiveResourceId", # required
+    #     schedule_id: "ShortRestrictiveResourceId", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.request_id #=> String
+    #   resp.status #=> Integer
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/quicksight-2018-04-01/StartDashboardSnapshotJobSchedule AWS API Documentation
+    #
+    # @overload start_dashboard_snapshot_job_schedule(params = {})
+    # @param [Hash] params ({})
+    def start_dashboard_snapshot_job_schedule(params = {}, options = {})
+      req = build_request(:start_dashboard_snapshot_job_schedule, params)
+      req.send_request(options)
+    end
+
     # Assigns one or more tags (key-value pairs) to the specified Amazon
     # QuickSight resource.
     #
@@ -15481,7 +15549,7 @@ module Aws::QuickSight
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-quicksight'
-      context[:gem_version] = '1.131.0'
+      context[:gem_version] = '1.133.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1565,6 +1565,8 @@ module Aws::QuickSight
     StartAssetBundleImportJobResponse = Shapes::StructureShape.new(name: 'StartAssetBundleImportJobResponse')
     StartDashboardSnapshotJobRequest = Shapes::StructureShape.new(name: 'StartDashboardSnapshotJobRequest')
     StartDashboardSnapshotJobResponse = Shapes::StructureShape.new(name: 'StartDashboardSnapshotJobResponse')
+    StartDashboardSnapshotJobScheduleRequest = Shapes::StructureShape.new(name: 'StartDashboardSnapshotJobScheduleRequest')
+    StartDashboardSnapshotJobScheduleResponse = Shapes::StructureShape.new(name: 'StartDashboardSnapshotJobScheduleResponse')
     StatePersistenceConfigurations = Shapes::StructureShape.new(name: 'StatePersistenceConfigurations')
     Status = Shapes::StringShape.new(name: 'Status')
     StatusCode = Shapes::IntegerShape.new(name: 'StatusCode')
@@ -4315,7 +4317,7 @@ module Aws::QuickSight
 
     DescribeAnalysisPermissionsResponse.add_member(:analysis_id, Shapes::ShapeRef.new(shape: ShortRestrictiveResourceId, location_name: "AnalysisId"))
     DescribeAnalysisPermissionsResponse.add_member(:analysis_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "AnalysisArn"))
-    DescribeAnalysisPermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: ResourcePermissionList, location_name: "Permissions"))
+    DescribeAnalysisPermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: UpdateResourcePermissionList, location_name: "Permissions"))
     DescribeAnalysisPermissionsResponse.add_member(:status, Shapes::ShapeRef.new(shape: StatusCode, location: "statusCode", location_name: "Status"))
     DescribeAnalysisPermissionsResponse.add_member(:request_id, Shapes::ShapeRef.new(shape: String, location_name: "RequestId"))
     DescribeAnalysisPermissionsResponse.struct_class = Types::DescribeAnalysisPermissionsResponse
@@ -4399,7 +4401,7 @@ module Aws::QuickSight
 
     DescribeDashboardPermissionsResponse.add_member(:dashboard_id, Shapes::ShapeRef.new(shape: ShortRestrictiveResourceId, location_name: "DashboardId"))
     DescribeDashboardPermissionsResponse.add_member(:dashboard_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "DashboardArn"))
-    DescribeDashboardPermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: ResourcePermissionList, location_name: "Permissions"))
+    DescribeDashboardPermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: UpdateResourcePermissionList, location_name: "Permissions"))
     DescribeDashboardPermissionsResponse.add_member(:status, Shapes::ShapeRef.new(shape: StatusCode, location: "statusCode", location_name: "Status"))
     DescribeDashboardPermissionsResponse.add_member(:request_id, Shapes::ShapeRef.new(shape: String, location_name: "RequestId"))
     DescribeDashboardPermissionsResponse.add_member(:link_sharing_configuration, Shapes::ShapeRef.new(shape: LinkSharingConfiguration, location_name: "LinkSharingConfiguration"))
@@ -4670,7 +4672,7 @@ module Aws::QuickSight
 
     DescribeTemplatePermissionsResponse.add_member(:template_id, Shapes::ShapeRef.new(shape: ShortRestrictiveResourceId, location_name: "TemplateId"))
     DescribeTemplatePermissionsResponse.add_member(:template_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "TemplateArn"))
-    DescribeTemplatePermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: ResourcePermissionList, location_name: "Permissions"))
+    DescribeTemplatePermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: UpdateResourcePermissionList, location_name: "Permissions"))
     DescribeTemplatePermissionsResponse.add_member(:request_id, Shapes::ShapeRef.new(shape: String, location_name: "RequestId"))
     DescribeTemplatePermissionsResponse.add_member(:status, Shapes::ShapeRef.new(shape: StatusCode, location: "statusCode", location_name: "Status"))
     DescribeTemplatePermissionsResponse.struct_class = Types::DescribeTemplatePermissionsResponse
@@ -4702,7 +4704,7 @@ module Aws::QuickSight
 
     DescribeThemePermissionsResponse.add_member(:theme_id, Shapes::ShapeRef.new(shape: ShortRestrictiveResourceId, location_name: "ThemeId"))
     DescribeThemePermissionsResponse.add_member(:theme_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "ThemeArn"))
-    DescribeThemePermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: ResourcePermissionList, location_name: "Permissions"))
+    DescribeThemePermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: UpdateResourcePermissionList, location_name: "Permissions"))
     DescribeThemePermissionsResponse.add_member(:request_id, Shapes::ShapeRef.new(shape: String, location_name: "RequestId"))
     DescribeThemePermissionsResponse.add_member(:status, Shapes::ShapeRef.new(shape: StatusCode, location: "statusCode", location_name: "Status"))
     DescribeThemePermissionsResponse.struct_class = Types::DescribeThemePermissionsResponse
@@ -7120,12 +7122,14 @@ module Aws::QuickSight
 
     RestoreAnalysisRequest.add_member(:aws_account_id, Shapes::ShapeRef.new(shape: AwsAccountId, required: true, location: "uri", location_name: "AwsAccountId"))
     RestoreAnalysisRequest.add_member(:analysis_id, Shapes::ShapeRef.new(shape: ShortRestrictiveResourceId, required: true, location: "uri", location_name: "AnalysisId"))
+    RestoreAnalysisRequest.add_member(:restore_to_folders, Shapes::ShapeRef.new(shape: Boolean, location: "querystring", location_name: "restore-to-folders"))
     RestoreAnalysisRequest.struct_class = Types::RestoreAnalysisRequest
 
     RestoreAnalysisResponse.add_member(:status, Shapes::ShapeRef.new(shape: StatusCode, location: "statusCode", location_name: "Status"))
     RestoreAnalysisResponse.add_member(:arn, Shapes::ShapeRef.new(shape: Arn, location_name: "Arn"))
     RestoreAnalysisResponse.add_member(:analysis_id, Shapes::ShapeRef.new(shape: ShortRestrictiveResourceId, location_name: "AnalysisId"))
     RestoreAnalysisResponse.add_member(:request_id, Shapes::ShapeRef.new(shape: String, location_name: "RequestId"))
+    RestoreAnalysisResponse.add_member(:restoration_failed_folder_arns, Shapes::ShapeRef.new(shape: FolderArnList, location_name: "RestorationFailedFolderArns"))
     RestoreAnalysisResponse.struct_class = Types::RestoreAnalysisResponse
 
     RollingDateConfiguration.add_member(:data_set_identifier, Shapes::ShapeRef.new(shape: DataSetIdentifier, location_name: "DataSetIdentifier"))
@@ -7685,6 +7689,15 @@ module Aws::QuickSight
     StartDashboardSnapshotJobResponse.add_member(:status, Shapes::ShapeRef.new(shape: StatusCode, location: "statusCode", location_name: "Status"))
     StartDashboardSnapshotJobResponse.struct_class = Types::StartDashboardSnapshotJobResponse
 
+    StartDashboardSnapshotJobScheduleRequest.add_member(:aws_account_id, Shapes::ShapeRef.new(shape: AwsAccountId, required: true, location: "uri", location_name: "AwsAccountId"))
+    StartDashboardSnapshotJobScheduleRequest.add_member(:dashboard_id, Shapes::ShapeRef.new(shape: ShortRestrictiveResourceId, required: true, location: "uri", location_name: "DashboardId"))
+    StartDashboardSnapshotJobScheduleRequest.add_member(:schedule_id, Shapes::ShapeRef.new(shape: ShortRestrictiveResourceId, required: true, location: "uri", location_name: "ScheduleId"))
+    StartDashboardSnapshotJobScheduleRequest.struct_class = Types::StartDashboardSnapshotJobScheduleRequest
+
+    StartDashboardSnapshotJobScheduleResponse.add_member(:request_id, Shapes::ShapeRef.new(shape: NonEmptyString, location_name: "RequestId"))
+    StartDashboardSnapshotJobScheduleResponse.add_member(:status, Shapes::ShapeRef.new(shape: StatusCode, location: "statusCode", location_name: "Status"))
+    StartDashboardSnapshotJobScheduleResponse.struct_class = Types::StartDashboardSnapshotJobScheduleResponse
+
     StatePersistenceConfigurations.add_member(:enabled, Shapes::ShapeRef.new(shape: Boolean, required: true, location_name: "Enabled"))
     StatePersistenceConfigurations.struct_class = Types::StatePersistenceConfigurations
 
@@ -8570,7 +8583,7 @@ module Aws::QuickSight
 
     UpdateAnalysisPermissionsResponse.add_member(:analysis_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "AnalysisArn"))
     UpdateAnalysisPermissionsResponse.add_member(:analysis_id, Shapes::ShapeRef.new(shape: ShortRestrictiveResourceId, location_name: "AnalysisId"))
-    UpdateAnalysisPermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: ResourcePermissionList, location_name: "Permissions"))
+    UpdateAnalysisPermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: UpdateResourcePermissionList, location_name: "Permissions"))
     UpdateAnalysisPermissionsResponse.add_member(:request_id, Shapes::ShapeRef.new(shape: String, location_name: "RequestId"))
     UpdateAnalysisPermissionsResponse.add_member(:status, Shapes::ShapeRef.new(shape: StatusCode, location: "statusCode", location_name: "Status"))
     UpdateAnalysisPermissionsResponse.struct_class = Types::UpdateAnalysisPermissionsResponse
@@ -8613,7 +8626,7 @@ module Aws::QuickSight
 
     UpdateDashboardPermissionsResponse.add_member(:dashboard_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "DashboardArn"))
     UpdateDashboardPermissionsResponse.add_member(:dashboard_id, Shapes::ShapeRef.new(shape: ShortRestrictiveResourceId, location_name: "DashboardId"))
-    UpdateDashboardPermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: ResourcePermissionList, location_name: "Permissions"))
+    UpdateDashboardPermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: UpdateResourcePermissionList, location_name: "Permissions"))
     UpdateDashboardPermissionsResponse.add_member(:request_id, Shapes::ShapeRef.new(shape: String, location_name: "RequestId"))
     UpdateDashboardPermissionsResponse.add_member(:status, Shapes::ShapeRef.new(shape: StatusCode, location: "statusCode", location_name: "Status"))
     UpdateDashboardPermissionsResponse.add_member(:link_sharing_configuration, Shapes::ShapeRef.new(shape: LinkSharingConfiguration, location_name: "LinkSharingConfiguration"))
@@ -8864,7 +8877,7 @@ module Aws::QuickSight
 
     UpdateTemplatePermissionsResponse.add_member(:template_id, Shapes::ShapeRef.new(shape: ShortRestrictiveResourceId, location_name: "TemplateId"))
     UpdateTemplatePermissionsResponse.add_member(:template_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "TemplateArn"))
-    UpdateTemplatePermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: ResourcePermissionList, location_name: "Permissions"))
+    UpdateTemplatePermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: UpdateResourcePermissionList, location_name: "Permissions"))
     UpdateTemplatePermissionsResponse.add_member(:request_id, Shapes::ShapeRef.new(shape: String, location_name: "RequestId"))
     UpdateTemplatePermissionsResponse.add_member(:status, Shapes::ShapeRef.new(shape: StatusCode, location: "statusCode", location_name: "Status"))
     UpdateTemplatePermissionsResponse.struct_class = Types::UpdateTemplatePermissionsResponse
@@ -8905,7 +8918,7 @@ module Aws::QuickSight
 
     UpdateThemePermissionsResponse.add_member(:theme_id, Shapes::ShapeRef.new(shape: ShortRestrictiveResourceId, location_name: "ThemeId"))
     UpdateThemePermissionsResponse.add_member(:theme_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "ThemeArn"))
-    UpdateThemePermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: ResourcePermissionList, location_name: "Permissions"))
+    UpdateThemePermissionsResponse.add_member(:permissions, Shapes::ShapeRef.new(shape: UpdateResourcePermissionList, location_name: "Permissions"))
     UpdateThemePermissionsResponse.add_member(:request_id, Shapes::ShapeRef.new(shape: String, location_name: "RequestId"))
     UpdateThemePermissionsResponse.add_member(:status, Shapes::ShapeRef.new(shape: StatusCode, location: "statusCode", location_name: "Status"))
     UpdateThemePermissionsResponse.struct_class = Types::UpdateThemePermissionsResponse
@@ -11378,6 +11391,8 @@ module Aws::QuickSight
         o.errors << Shapes::ShapeRef.new(shape: ConflictException)
         o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
         o.errors << Shapes::ShapeRef.new(shape: UnsupportedUserEditionException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: PreconditionNotMetException)
         o.errors << Shapes::ShapeRef.new(shape: InternalFailureException)
       end)
 
@@ -11552,6 +11567,21 @@ module Aws::QuickSight
         o.errors << Shapes::ShapeRef.new(shape: InternalFailureException)
       end)
 
+      api.add_operation(:start_dashboard_snapshot_job_schedule, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "StartDashboardSnapshotJobSchedule"
+        o.http_method = "POST"
+        o.http_request_uri = "/accounts/{AwsAccountId}/dashboards/{DashboardId}/schedules/{ScheduleId}"
+        o.input = Shapes::ShapeRef.new(shape: StartDashboardSnapshotJobScheduleRequest)
+        o.output = Shapes::ShapeRef.new(shape: StartDashboardSnapshotJobScheduleResponse)
+        o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidParameterValueException)
+        o.errors << Shapes::ShapeRef.new(shape: LimitExceededException)
+        o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
+        o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
+        o.errors << Shapes::ShapeRef.new(shape: UnsupportedUserEditionException)
+        o.errors << Shapes::ShapeRef.new(shape: InternalFailureException)
+      end)
+
       api.add_operation(:tag_resource, Seahorse::Model::Operation.new.tap do |o|
         o.name = "TagResource"
         o.http_method = "POST"

data/lib/aws-sdk-quicksight/endpoint_parameters.rb

@@ -52,15 +52,18 @@ module Aws::QuickSight
       self[:region] = options[:region]
       self[:use_dual_stack] = options[:use_dual_stack]
       self[:use_dual_stack] = false if self[:use_dual_stack].nil?
-      if self[:use_dual_stack].nil?
-        raise ArgumentError, "Missing required EndpointParameter: :use_dual_stack"
-      end
       self[:use_fips] = options[:use_fips]
       self[:use_fips] = false if self[:use_fips].nil?
-      if self[:use_fips].nil?
-        raise ArgumentError, "Missing required EndpointParameter: :use_fips"
-      end
       self[:endpoint] = options[:endpoint]
     end
+
+    def self.create(config, options={})
+      new({
+        region: config.region,
+        use_dual_stack: config.use_dualstack_endpoint,
+        use_fips: config.use_fips_endpoint,
+        endpoint: (config.endpoint.to_s unless config.regional_endpoint),
+      }.merge(options))
+    end
   end
 end