aws-sdk-support 1.93.0 → 1.95.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -488,14 +488,21 @@ module Aws::Support
488
488
  # after it's created. The `expiryTime` returned in the response is when
489
489
  # the set expires.
490
490
  #
491
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
492
- # plan to use the Amazon Web Services Support API.
491
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
492
+ # Services Enterprise Support, or Amazon Web Services Unified
493
+ # Operations plan to use the Amazon Web Services Support API. If
494
+ # you're in an Amazon Web Services Region that doesn't offer one of
495
+ # these Amazon Web Services Support plans, or if you haven't
496
+ # transitioned to one of these plans, you can use the Amazon Web
497
+ # Services Support API with a Business, Enterprise On-Ramp, or
498
+ # Enterprise Support plan.
493
499
  #
494
500
  # * If you call the Amazon Web Services Support API from an account that
495
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
496
- # plan, the `SubscriptionRequiredException` error message appears. For
497
- # information about changing your support plan, see [Amazon Web
498
- # Services Support][1].
501
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
502
+ # Services Enterprise Support, or Amazon Web Services Unified
503
+ # Operations plan, the `SubscriptionRequiredException` error message
504
+ # appears. For information about changing your support plan, see
505
+ # [Amazon Web Services Support][1].
499
506
  #
500
507
  # </note>
501
508
  #
@@ -519,6 +526,13 @@ module Aws::Support
519
526
  # base64-encoded string. The value for `fileName` is the name of the
520
527
  # attachment, such as `troubleshoot-screenshot.png`.
521
528
  #
529
+ # @option params [Boolean] :dry_run
530
+ # Specifies whether to validate the request without actually adding the
531
+ # attachments. When set to `true`, the request is validated but no
532
+ # attachments are stored, and the operation returns a
533
+ # `DryRunOperationException`. When omitted or set to `false`, the
534
+ # request runs normally.
535
+ #
522
536
  # @return [Types::AddAttachmentsToSetResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
523
537
  #
524
538
  # * {Types::AddAttachmentsToSetResponse#attachment_set_id #attachment_set_id} => String
@@ -534,6 +548,7 @@ module Aws::Support
534
548
  # data: "data",
535
549
  # },
536
550
  # ],
551
+ # dry_run: false,
537
552
  # })
538
553
  #
539
554
  # @example Response structure
@@ -550,20 +565,47 @@ module Aws::Support
550
565
  req.send_request(options)
551
566
  end
552
567
 
553
- # Adds additional customer communication to an Amazon Web Services
568
+ # Adds additional customer communication to a Amazon Web Services
554
569
  # Support case. Use the `caseId` parameter to identify the case to which
555
- # to add communication. You can list a set of email addresses to copy on
556
- # the communication by using the `ccEmailAddresses` parameter. The
570
+ # to add communication. To list a set of email addresses to copy on the
571
+ # communication, use the `ccEmailAddresses` parameter. The
557
572
  # `communicationBody` value contains the text of the communication.
558
573
  #
559
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
560
- # plan to use the Amazon Web Services Support API.
574
+ # To attach files larger than 5 MB to the communication, use the
575
+ # `uploadIds` parameter.
576
+ #
577
+ # Amazon Web Services Support automatically redacts sensitive
578
+ # information from support cases to protect your data. The following
579
+ # information is replaced with `[REDACTED_BY_Amazon Web Services]` and
580
+ # is not stored:
581
+ #
582
+ # * Amazon Web Services secret keys - The complete key is replaced.
583
+ # Example: `[REDACTED_BY_Amazon Web Services]`
584
+ #
585
+ # * Private keys - The complete key is replaced. Example:
586
+ # `[REDACTED_BY_Amazon Web Services]`
587
+ #
588
+ # * Credit card numbers - The number is redacted, but the last 4 digits
589
+ # remain. Example: `[REDACTED_BY_Amazon Web Services]-7016`
590
+ #
591
+ # This sensitive information is never required by Amazon Web Services
592
+ # Support.
593
+ #
594
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
595
+ # Services Enterprise Support, or Amazon Web Services Unified
596
+ # Operations plan to use the Amazon Web Services Support API. If
597
+ # you're in an Amazon Web Services Region that doesn't offer one of
598
+ # these Amazon Web Services Support plans, or if you haven't
599
+ # transitioned to one of these plans, you can use the Amazon Web
600
+ # Services Support API with a Business, Enterprise On-Ramp, or
601
+ # Enterprise Support plan.
561
602
  #
562
603
  # * If you call the Amazon Web Services Support API from an account that
563
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
564
- # plan, the `SubscriptionRequiredException` error message appears. For
565
- # information about changing your support plan, see [Amazon Web
566
- # Services Support][1].
604
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
605
+ # Services Enterprise Support, or Amazon Web Services Unified
606
+ # Operations plan, the `SubscriptionRequiredException` error message
607
+ # appears. For information about changing your support plan, see
608
+ # [Amazon Web Services Support][1].
567
609
  #
568
610
  # </note>
569
611
  #
@@ -574,7 +616,7 @@ module Aws::Support
574
616
  # @option params [String] :case_id
575
617
  # The support case ID requested or returned in the call. The case ID is
576
618
  # an alphanumeric string formatted as shown in this example:
577
- # case-*12345678910-2013-c4c1d2bf33c5cf47*
619
+ # case-*12345678910-exen-2025-c4c1d2bf33c5cf47*
578
620
  #
579
621
  # @option params [required, String] :communication_body
580
622
  # The body of an email communication to add to the support case.
@@ -585,7 +627,24 @@ module Aws::Support
585
627
  #
586
628
  # @option params [String] :attachment_set_id
587
629
  # The ID of a set of one or more attachments for the communication to
588
- # add to the case. Create the set by calling AddAttachmentsToSet
630
+ # add to the case. Create the set by calling AddAttachmentsToSet. Each
631
+ # attachment in the set must be 5 MB or smaller. To attach files larger
632
+ # than 5 MB, use `uploadIds`.
633
+ #
634
+ # @option params [Array<String>] :upload_ids
635
+ # A list of upload IDs that identify attachments to add to the case.
636
+ # Each `uploadId` is returned by the GetAttachmentUploadLinks operation.
637
+ # The upload must reach the `attachment-ready` state by calling
638
+ # CompleteAttachmentUpload before it can be passed here. Use `uploadIds`
639
+ # to attach files of any supported size, including files larger than 5
640
+ # MB.
641
+ #
642
+ # @option params [Boolean] :dry_run
643
+ # Specifies whether to validate the request without actually adding the
644
+ # communication to the case. When set to `true`, the request is
645
+ # validated but the communication isn't added, and the operation
646
+ # returns a `DryRunOperationException`. When omitted or set to `false`,
647
+ # the request runs normally.
589
648
  #
590
649
  # @return [Types::AddCommunicationToCaseResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
591
650
  #
@@ -598,6 +657,8 @@ module Aws::Support
598
657
  # communication_body: "CommunicationBody", # required
599
658
  # cc_email_addresses: ["CcEmailAddress"],
600
659
  # attachment_set_id: "AttachmentSetId",
660
+ # upload_ids: ["UploadId"],
661
+ # dry_run: false,
601
662
  # })
602
663
  #
603
664
  # @example Response structure
@@ -613,6 +674,63 @@ module Aws::Support
613
674
  req.send_request(options)
614
675
  end
615
676
 
677
+ # Completes an attachment upload that was started with
678
+ # GetAttachmentUploadLinks. After you upload a part of the file to its
679
+ # presigned Amazon S3 URL, call `CompleteAttachmentUpload` with the
680
+ # `partIndex` and `eTag` of that part. You can include one part per
681
+ # call, or multiple parts in a single call. After
682
+ # `CompleteAttachmentUpload` has been called for every part of the file,
683
+ # the service processes the upload asynchronously. The
684
+ # `attachment-ready` status might not be reflected immediately. Use
685
+ # DescribeAttachmentUploadStatus to poll for the `uploadStatus` to
686
+ # become `attachment-ready` before passing the `uploadId` to CreateCase
687
+ # or AddCommunicationToCase.
688
+ #
689
+ # @option params [required, String] :upload_id
690
+ # The identifier associated with the upload to complete.
691
+ #
692
+ # @option params [required, Array<Types::CompletedUpload>] :completed_uploads
693
+ # The list of parts being reported as completed in this call. Each entry
694
+ # must contain the `partIndex` of an uploaded part and the `ETag`
695
+ # returned by Amazon S3 when that part was uploaded.
696
+ #
697
+ # @option params [Boolean] :dry_run
698
+ # Specifies whether to validate the request without actually completing
699
+ # the upload. When set to `true`, the request is validated but the
700
+ # upload isn't finalized, and the operation returns a
701
+ # `DryRunOperationException`. When omitted or set to `false`, the
702
+ # request runs normally.
703
+ #
704
+ # @return [Types::CompleteAttachmentUploadResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
705
+ #
706
+ # * {Types::CompleteAttachmentUploadResponse#upload_status #upload_status} => String
707
+ #
708
+ # @example Request syntax with placeholder values
709
+ #
710
+ # resp = client.complete_attachment_upload({
711
+ # upload_id: "UploadId", # required
712
+ # completed_uploads: [ # required
713
+ # {
714
+ # part_index: 1, # required
715
+ # e_tag: "ETag", # required
716
+ # },
717
+ # ],
718
+ # dry_run: false,
719
+ # })
720
+ #
721
+ # @example Response structure
722
+ #
723
+ # resp.upload_status #=> String, one of "attachment-ready", "attachment-not-ready", "failed"
724
+ #
725
+ # @see http://docs.aws.amazon.com/goto/WebAPI/support-2013-04-15/CompleteAttachmentUpload AWS API Documentation
726
+ #
727
+ # @overload complete_attachment_upload(params = {})
728
+ # @param [Hash] params ({})
729
+ def complete_attachment_upload(params = {}, options = {})
730
+ req = build_request(:complete_attachment_upload, params)
731
+ req.send_request(options)
732
+ end
733
+
616
734
  # Creates a case in the Amazon Web Services Support Center. This
617
735
  # operation is similar to how you create a case in the Amazon Web
618
736
  # Services Support Center [Create Case][1] page.
@@ -626,7 +744,24 @@ module Aws::Support
626
744
  #
627
745
  # * Use the Service Quotas [RequestServiceQuotaIncrease][2] operation.
628
746
  #
629
- # A successful `CreateCase` request returns an Amazon Web Services
747
+ # Amazon Web Services Support automatically redacts sensitive
748
+ # information from support cases to protect your data. The following
749
+ # information is replaced with `[REDACTED_BY_Amazon Web Services]` and
750
+ # is not stored:
751
+ #
752
+ # * Amazon Web Services secret keys - The complete key is replaced.
753
+ # Example: `[REDACTED_BY_Amazon Web Services]`
754
+ #
755
+ # * Private keys - The complete key is replaced. Example:
756
+ # `[REDACTED_BY_Amazon Web Services]`
757
+ #
758
+ # * Credit card numbers - The number is redacted, but the last 4 digits
759
+ # remain. Example: `[REDACTED_BY_Amazon Web Services]-7016`
760
+ #
761
+ # This sensitive information is never required by Amazon Web Services
762
+ # Support.
763
+ #
764
+ # A successful `CreateCase` request returns a Amazon Web Services
630
765
  # Support case number. You can use the DescribeCases operation and
631
766
  # specify the case number to get existing Amazon Web Services Support
632
767
  # cases. After you create a case, use the AddCommunicationToCase
@@ -637,14 +772,21 @@ module Aws::Support
637
772
  # [Amazon Web Services Support Center][3]. Use the DescribeCases
638
773
  # operation to get the `displayId`.
639
774
  #
640
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
641
- # plan to use the Amazon Web Services Support API.
775
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
776
+ # Services Enterprise Support, or Amazon Web Services Unified
777
+ # Operations plan to use the Amazon Web Services Support API. If
778
+ # you're in an Amazon Web Services Region that doesn't offer one of
779
+ # these Amazon Web Services Support plans, or if you haven't
780
+ # transitioned to one of these plans, you can use the Amazon Web
781
+ # Services Support API with a Business, Enterprise On-Ramp, or
782
+ # Enterprise Support plan.
642
783
  #
643
784
  # * If you call the Amazon Web Services Support API from an account that
644
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
645
- # plan, the `SubscriptionRequiredException` error message appears. For
646
- # information about changing your support plan, see [Amazon Web
647
- # Services Support][4].
785
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
786
+ # Services Enterprise Support, or Amazon Web Services Unified
787
+ # Operations plan, the `SubscriptionRequiredException` error message
788
+ # appears. For information about changing your support plan, see
789
+ # [Amazon Web Services Support][4].
648
790
  #
649
791
  # </note>
650
792
  #
@@ -714,9 +856,10 @@ module Aws::Support
714
856
  # @option params [String] :language
715
857
  # The language in which Amazon Web Services Support handles the case.
716
858
  # Amazon Web Services Support currently supports Chinese (“zh”), English
717
- # ("en"), Japanese ("ja") and Korean (“ko”). You must specify the
718
- # ISO 639-1 code for the `language` parameter if you want support in
719
- # that language.
859
+ # ("en"), Japanese ("ja") , Chinese ("zh"), Spanish ("es"),
860
+ # Portuguese ("pt"), French ("fr"), Korean (“ko”), and Turkish
861
+ # ("tr"). You must specify the ISO 639-1 code for the `language`
862
+ # parameter if you want support in that language.
720
863
  #
721
864
  # @option params [String] :issue_type
722
865
  # The type of issue for the case. You can specify `customer-service` or
@@ -725,7 +868,23 @@ module Aws::Support
725
868
  #
726
869
  # @option params [String] :attachment_set_id
727
870
  # The ID of a set of one or more attachments for the case. Create the
728
- # set by using the AddAttachmentsToSet operation.
871
+ # set by using the AddAttachmentsToSet operation. Each attachment in the
872
+ # set must be 5 MB or smaller. To attach files larger than 5 MB, use
873
+ # `uploadIds`.
874
+ #
875
+ # @option params [Array<String>] :upload_ids
876
+ # A list of upload IDs that identify attachments to add to the case.
877
+ # Each `uploadId` is returned by the GetAttachmentUploadLinks operation.
878
+ # The upload must reach the `attachment-ready` state by calling
879
+ # CompleteAttachmentUpload before it can be passed here. Use `uploadIds`
880
+ # to attach files of any supported size, including files larger than 5
881
+ # MB.
882
+ #
883
+ # @option params [Boolean] :dry_run
884
+ # Specifies whether to validate the request without actually creating
885
+ # the case. When set to `true`, the request is validated but no case is
886
+ # created, and the operation returns a `DryRunOperationException`. When
887
+ # omitted or set to `false`, the request runs normally.
729
888
  #
730
889
  # @return [Types::CreateCaseResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
731
890
  #
@@ -743,6 +902,8 @@ module Aws::Support
743
902
  # language: "Language",
744
903
  # issue_type: "IssueType",
745
904
  # attachment_set_id: "AttachmentSetId",
905
+ # upload_ids: ["UploadId"],
906
+ # dry_run: false,
746
907
  # })
747
908
  #
748
909
  # @example Response structure
@@ -765,17 +926,33 @@ module Aws::Support
765
926
  # are returned in the AttachmentDetails objects that are returned by the
766
927
  # DescribeCommunications operation.
767
928
  #
768
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
769
- # plan to use the Amazon Web Services Support API.
929
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
930
+ # Services Enterprise Support, or Amazon Web Services Unified
931
+ # Operations plan to use the Amazon Web Services Support API. If
932
+ # you're in an Amazon Web Services Region that doesn't offer one of
933
+ # these Amazon Web Services Support plans, or if you haven't
934
+ # transitioned to one of these plans, you can use the Amazon Web
935
+ # Services Support API with a Business, Enterprise On-Ramp, or
936
+ # Enterprise Support plan.
770
937
  #
771
938
  # * If you call the Amazon Web Services Support API from an account that
772
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
773
- # plan, the `SubscriptionRequiredException` error message appears. For
774
- # information about changing your support plan, see [Amazon Web
775
- # Services Support][1].
939
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
940
+ # Services Enterprise Support, or Amazon Web Services Unified
941
+ # Operations plan, the `SubscriptionRequiredException` error message
942
+ # appears. For information about changing your support plan, see
943
+ # [Amazon Web Services Support][1].
776
944
  #
777
945
  # </note>
778
946
  #
947
+ # `DescribeAttachment` can't return attachments larger than 5 MB. If
948
+ # the specified `attachmentId` refers to an attachment larger than 5 MB,
949
+ # the request fails with `InvalidParameterValueException`.
950
+ #
951
+ # To download an attachment of any size, including attachments larger
952
+ # than 5 MB, use GetAttachmentDownloadLink. `GetAttachmentDownloadLink`
953
+ # returns an Amazon S3 presigned URL that you can use to download the
954
+ # attachment directly.
955
+ #
779
956
  #
780
957
  #
781
958
  # [1]: http://aws.amazon.com/premiumsupport/
@@ -784,6 +961,17 @@ module Aws::Support
784
961
  # The ID of the attachment to return. Attachment IDs are returned by the
785
962
  # DescribeCommunications operation.
786
963
  #
964
+ # If the specified attachment is larger than 5 MB, this operation
965
+ # returns `InvalidParameterValueException`. To download attachments
966
+ # larger than 5 MB, use GetAttachmentDownloadLink.
967
+ #
968
+ # @option params [Boolean] :dry_run
969
+ # Specifies whether to validate the request without actually retrieving
970
+ # the attachment. When set to `true`, the request is validated but no
971
+ # attachment content is returned, and the operation returns a
972
+ # `DryRunOperationException`. When omitted or set to `false`, the
973
+ # request runs normally.
974
+ #
787
975
  # @return [Types::DescribeAttachmentResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
788
976
  #
789
977
  # * {Types::DescribeAttachmentResponse#attachment #attachment} => Types::Attachment
@@ -792,6 +980,7 @@ module Aws::Support
792
980
  #
793
981
  # resp = client.describe_attachment({
794
982
  # attachment_id: "AttachmentId", # required
983
+ # dry_run: false,
795
984
  # })
796
985
  #
797
986
  # @example Response structure
@@ -808,6 +997,79 @@ module Aws::Support
808
997
  req.send_request(options)
809
998
  end
810
999
 
1000
+ # Returns the current status, file name, and progress of a multipart
1001
+ # attachment upload that was started with GetAttachmentUploadLinks. Use
1002
+ # this operation to track where an upload is in the workflow. While
1003
+ # parts are still being uploaded and reported through
1004
+ # CompleteAttachmentUpload, the `uploadStatus` is `attachment-not-ready`
1005
+ # and `uploadProgress` reports the total number of parts and how many
1006
+ # have been completed so far. After every part has been reported and the
1007
+ # service finishes processing the upload asynchronously, the
1008
+ # `uploadStatus` becomes `attachment-ready` and the `uploadId` can be
1009
+ # attached to a case through CreateCase or AddCommunicationToCase.
1010
+ #
1011
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
1012
+ # Services Enterprise Support, or Amazon Web Services Unified
1013
+ # Operations plan to use the Amazon Web Services Support API. If
1014
+ # you're in an Amazon Web Services Region that doesn't offer one of
1015
+ # these Amazon Web Services Support plans, or if you haven't
1016
+ # transitioned to one of these plans, you can use the Amazon Web
1017
+ # Services Support API with a Business, Enterprise On-Ramp, or
1018
+ # Enterprise Support plan.
1019
+ #
1020
+ # * If you call the Amazon Web Services Support API from an account that
1021
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
1022
+ # Services Enterprise Support, or Amazon Web Services Unified
1023
+ # Operations plan, the `SubscriptionRequiredException` error message
1024
+ # appears. For information about changing your support plan, see
1025
+ # [Amazon Web Services Support][1].
1026
+ #
1027
+ # </note>
1028
+ #
1029
+ #
1030
+ #
1031
+ # [1]: http://aws.amazon.com/premiumsupport/
1032
+ #
1033
+ # @option params [required, String] :upload_id
1034
+ # The unique identifier for the upload. The `uploadId` is returned by
1035
+ # GetAttachmentUploadLinks when you initiate the upload.
1036
+ #
1037
+ # @option params [Boolean] :dry_run
1038
+ # Specifies whether to validate the request without actually returning
1039
+ # upload status. When set to `true`, the request is validated but no
1040
+ # status is returned, and the operation returns a
1041
+ # `DryRunOperationException`. When omitted or set to `false`, the
1042
+ # request runs normally.
1043
+ #
1044
+ # @return [Types::DescribeAttachmentUploadStatusResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1045
+ #
1046
+ # * {Types::DescribeAttachmentUploadStatusResponse#upload_status #upload_status} => String
1047
+ # * {Types::DescribeAttachmentUploadStatusResponse#file_name #file_name} => String
1048
+ # * {Types::DescribeAttachmentUploadStatusResponse#upload_progress #upload_progress} => Types::UploadProgress
1049
+ #
1050
+ # @example Request syntax with placeholder values
1051
+ #
1052
+ # resp = client.describe_attachment_upload_status({
1053
+ # upload_id: "UploadId", # required
1054
+ # dry_run: false,
1055
+ # })
1056
+ #
1057
+ # @example Response structure
1058
+ #
1059
+ # resp.upload_status #=> String, one of "attachment-ready", "attachment-not-ready", "failed"
1060
+ # resp.file_name #=> String
1061
+ # resp.upload_progress.total_parts #=> Integer
1062
+ # resp.upload_progress.completed_parts_count #=> Integer
1063
+ #
1064
+ # @see http://docs.aws.amazon.com/goto/WebAPI/support-2013-04-15/DescribeAttachmentUploadStatus AWS API Documentation
1065
+ #
1066
+ # @overload describe_attachment_upload_status(params = {})
1067
+ # @param [Hash] params ({})
1068
+ def describe_attachment_upload_status(params = {}, options = {})
1069
+ req = build_request(:describe_attachment_upload_status, params)
1070
+ req.send_request(options)
1071
+ end
1072
+
811
1073
  # Returns a list of cases that you specify by passing one or more case
812
1074
  # IDs. You can use the `afterTime` and `beforeTime` parameters to filter
813
1075
  # the cases by date. You can set values for the `includeResolvedCases`
@@ -821,20 +1083,40 @@ module Aws::Support
821
1083
  # * One or more `nextToken` values, which specify where to paginate the
822
1084
  # returned records represented by the `CaseDetails` objects.
823
1085
  #
824
- # Case data is available for 12 months after creation. If a case was
825
- # created more than 12 months ago, a request might return an error.
1086
+ # Case data is available for 24 months after creation. If a case was
1087
+ # created more than 24 months ago, a request might return an error.
826
1088
  #
827
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
828
- # plan to use the Amazon Web Services Support API.
1089
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
1090
+ # Services Enterprise Support, or Amazon Web Services Unified
1091
+ # Operations plan to use the Amazon Web Services Support API. If
1092
+ # you're in an Amazon Web Services Region that doesn't offer one of
1093
+ # these Amazon Web Services Support plans, or if you haven't
1094
+ # transitioned to one of these plans, you can use the Amazon Web
1095
+ # Services Support API with a Business, Enterprise On-Ramp, or
1096
+ # Enterprise Support plan.
829
1097
  #
830
1098
  # * If you call the Amazon Web Services Support API from an account that
831
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
832
- # plan, the `SubscriptionRequiredException` error message appears. For
833
- # information about changing your support plan, see [Amazon Web
834
- # Services Support][2].
1099
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
1100
+ # Services Enterprise Support, or Amazon Web Services Unified
1101
+ # Operations plan, the `SubscriptionRequiredException` error message
1102
+ # appears. For information about changing your support plan, see
1103
+ # [Amazon Web Services Support][2].
835
1104
  #
836
1105
  # </note>
837
1106
  #
1107
+ # Each Communication returned by this operation includes attachment
1108
+ # information in two fields:
1109
+ #
1110
+ # * `attachmentSet`: returns only attachments that are 5 MB or smaller.
1111
+ # Attachments larger than 5 MB are not included in this field.
1112
+ #
1113
+ # * `attachments`: returns all attachments regardless of size.
1114
+ #
1115
+ # Amazon Web Services recommends that you use the `attachments` field
1116
+ # and download each attachment with GetAttachmentDownloadLink, which
1117
+ # supports attachments of any size. The `attachmentSet` field and
1118
+ # DescribeAttachment return only attachments that are 5 MB or smaller.
1119
+ #
838
1120
  #
839
1121
  #
840
1122
  # [1]: https://docs.aws.amazon.com/awssupport/latest/APIReference/API_CaseDetails.html
@@ -850,12 +1132,12 @@ module Aws::Support
850
1132
  #
851
1133
  # @option params [String] :after_time
852
1134
  # The start date for a filtered date search on support case
853
- # communications. Case communications are available for 12 months after
1135
+ # communications. Case communications are available for 24 months after
854
1136
  # creation.
855
1137
  #
856
1138
  # @option params [String] :before_time
857
1139
  # The end date for a filtered date search on support case
858
- # communications. Case communications are available for 12 months after
1140
+ # communications. Case communications are available for 24 months after
859
1141
  # creation.
860
1142
  #
861
1143
  # @option params [Boolean] :include_resolved_cases
@@ -871,14 +1153,21 @@ module Aws::Support
871
1153
  # @option params [String] :language
872
1154
  # The language in which Amazon Web Services Support handles the case.
873
1155
  # Amazon Web Services Support currently supports Chinese (“zh”), English
874
- # ("en"), Japanese ("ja") and Korean (“ko”). You must specify the
875
- # ISO 639-1 code for the `language` parameter if you want support in
876
- # that language.
1156
+ # ("en"), Japanese ("ja") , Chinese ("zh"), Spanish ("es"),
1157
+ # Portuguese ("pt"), French ("fr"), Korean (“ko”), and Turkish
1158
+ # ("tr"). You must specify the ISO 639-1 code for the `language`
1159
+ # parameter if you want support in that language.
877
1160
  #
878
1161
  # @option params [Boolean] :include_communications
879
1162
  # Specifies whether to include communications in the `DescribeCases`
880
1163
  # response. By default, communications are included.
881
1164
  #
1165
+ # @option params [Boolean] :dry_run
1166
+ # Specifies whether to validate the request without actually returning
1167
+ # case data. When set to `true`, the request is validated but no cases
1168
+ # are returned, and the operation returns a `DryRunOperationException`.
1169
+ # When omitted or set to `false`, the request runs normally.
1170
+ #
882
1171
  # @return [Types::DescribeCasesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
883
1172
  #
884
1173
  # * {Types::DescribeCasesResponse#cases #cases} => Array&lt;Types::CaseDetails&gt;
@@ -898,6 +1187,7 @@ module Aws::Support
898
1187
  # max_results: 1,
899
1188
  # language: "Language",
900
1189
  # include_communications: false,
1190
+ # dry_run: false,
901
1191
  # })
902
1192
  #
903
1193
  # @example Response structure
@@ -917,6 +1207,9 @@ module Aws::Support
917
1207
  # resp.cases[0].recent_communications.communications[0].body #=> String
918
1208
  # resp.cases[0].recent_communications.communications[0].submitted_by #=> String
919
1209
  # resp.cases[0].recent_communications.communications[0].time_created #=> String
1210
+ # resp.cases[0].recent_communications.communications[0].attachments #=> Array
1211
+ # resp.cases[0].recent_communications.communications[0].attachments[0].attachment_id #=> String
1212
+ # resp.cases[0].recent_communications.communications[0].attachments[0].file_name #=> String
920
1213
  # resp.cases[0].recent_communications.communications[0].attachment_set #=> Array
921
1214
  # resp.cases[0].recent_communications.communications[0].attachment_set[0].attachment_id #=> String
922
1215
  # resp.cases[0].recent_communications.communications[0].attachment_set[0].file_name #=> String
@@ -940,8 +1233,8 @@ module Aws::Support
940
1233
  # can use the `caseId` parameter to restrict the results to a specific
941
1234
  # case.
942
1235
  #
943
- # Case data is available for 12 months after creation. If a case was
944
- # created more than 12 months ago, a request for data might cause an
1236
+ # Case data is available for 24 months after creation. If a case was
1237
+ # created more than 24 months ago, a request for data might cause an
945
1238
  # error.
946
1239
  #
947
1240
  # You can use the `maxResults` and `nextToken` parameters to control the
@@ -949,17 +1242,37 @@ module Aws::Support
949
1242
  # that you want to display on each page, and use `nextToken` to specify
950
1243
  # the resumption of pagination.
951
1244
  #
952
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
953
- # plan to use the Amazon Web Services Support API.
1245
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
1246
+ # Services Enterprise Support, or Amazon Web Services Unified
1247
+ # Operations plan to use the Amazon Web Services Support API. If
1248
+ # you're in an Amazon Web Services Region that doesn't offer one of
1249
+ # these Amazon Web Services Support plans, or if you haven't
1250
+ # transitioned to one of these plans, you can use the Amazon Web
1251
+ # Services Support API with a Business, Enterprise On-Ramp, or
1252
+ # Enterprise Support plan.
954
1253
  #
955
1254
  # * If you call the Amazon Web Services Support API from an account that
956
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
957
- # plan, the `SubscriptionRequiredException` error message appears. For
958
- # information about changing your support plan, see [Amazon Web
959
- # Services Support][1].
1255
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
1256
+ # Services Enterprise Support, or Amazon Web Services Unified
1257
+ # Operations plan, the `SubscriptionRequiredException` error message
1258
+ # appears. For information about changing your support plan, see
1259
+ # [Amazon Web Services Support][1].
960
1260
  #
961
1261
  # </note>
962
1262
  #
1263
+ # Each Communication returned by this operation includes attachment
1264
+ # information in two fields:
1265
+ #
1266
+ # * `attachmentSet`: returns only attachments that are 5 MB or smaller.
1267
+ # Attachments larger than 5 MB are not included in this field.
1268
+ #
1269
+ # * `attachments`: returns all attachments regardless of size.
1270
+ #
1271
+ # Amazon Web Services recommends that you use the `attachments` field
1272
+ # and download each attachment with GetAttachmentDownloadLink, which
1273
+ # supports attachments of any size. The `attachmentSet` field and
1274
+ # DescribeAttachment return only attachments that are 5 MB or smaller.
1275
+ #
963
1276
  #
964
1277
  #
965
1278
  # [1]: http://aws.amazon.com/premiumsupport/
@@ -967,16 +1280,16 @@ module Aws::Support
967
1280
  # @option params [required, String] :case_id
968
1281
  # The support case ID requested or returned in the call. The case ID is
969
1282
  # an alphanumeric string formatted as shown in this example:
970
- # case-*12345678910-2013-c4c1d2bf33c5cf47*
1283
+ # case-*12345678910-exen-2025-c4c1d2bf33c5cf47*
971
1284
  #
972
1285
  # @option params [String] :before_time
973
1286
  # The end date for a filtered date search on support case
974
- # communications. Case communications are available for 12 months after
1287
+ # communications. Case communications are available for 24 months after
975
1288
  # creation.
976
1289
  #
977
1290
  # @option params [String] :after_time
978
1291
  # The start date for a filtered date search on support case
979
- # communications. Case communications are available for 12 months after
1292
+ # communications. Case communications are available for 24 months after
980
1293
  # creation.
981
1294
  #
982
1295
  # @option params [String] :next_token
@@ -985,6 +1298,13 @@ module Aws::Support
985
1298
  # @option params [Integer] :max_results
986
1299
  # The maximum number of results to return before paginating.
987
1300
  #
1301
+ # @option params [Boolean] :dry_run
1302
+ # Specifies whether to validate the request without actually returning
1303
+ # communications. When set to `true`, the request is validated but no
1304
+ # communications are returned, and the operation returns a
1305
+ # `DryRunOperationException`. When omitted or set to `false`, the
1306
+ # request runs normally.
1307
+ #
988
1308
  # @return [Types::DescribeCommunicationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
989
1309
  #
990
1310
  # * {Types::DescribeCommunicationsResponse#communications #communications} => Array&lt;Types::Communication&gt;
@@ -1000,6 +1320,7 @@ module Aws::Support
1000
1320
  # after_time: "AfterTime",
1001
1321
  # next_token: "NextToken",
1002
1322
  # max_results: 1,
1323
+ # dry_run: false,
1003
1324
  # })
1004
1325
  #
1005
1326
  # @example Response structure
@@ -1009,6 +1330,9 @@ module Aws::Support
1009
1330
  # resp.communications[0].body #=> String
1010
1331
  # resp.communications[0].submitted_by #=> String
1011
1332
  # resp.communications[0].time_created #=> String
1333
+ # resp.communications[0].attachments #=> Array
1334
+ # resp.communications[0].attachments[0].attachment_id #=> String
1335
+ # resp.communications[0].attachments[0].file_name #=> String
1012
1336
  # resp.communications[0].attachment_set #=> Array
1013
1337
  # resp.communications[0].attachment_set[0].attachment_id #=> String
1014
1338
  # resp.communications[0].attachment_set[0].file_name #=> String
@@ -1028,14 +1352,21 @@ module Aws::Support
1028
1352
  # `language` `categoryCode`, `issueType` and `serviceCode` used to
1029
1353
  # retrieve the CreateCaseOptions.
1030
1354
  #
1031
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
1032
- # plan to use the Amazon Web Services Support API.
1355
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
1356
+ # Services Enterprise Support, or Amazon Web Services Unified
1357
+ # Operations plan to use the Amazon Web Services Support API. If
1358
+ # you're in an Amazon Web Services Region that doesn't offer one of
1359
+ # these Amazon Web Services Support plans, or if you haven't
1360
+ # transitioned to one of these plans, you can use the Amazon Web
1361
+ # Services Support API with a Business, Enterprise On-Ramp, or
1362
+ # Enterprise Support plan.
1033
1363
  #
1034
1364
  # * If you call the Amazon Web Services Support API from an account that
1035
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
1036
- # plan, the `SubscriptionRequiredException` error message appears. For
1037
- # information about changing your support plan, see [Amazon Web
1038
- # Services Support][1].
1365
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
1366
+ # Services Enterprise Support, or Amazon Web Services Unified
1367
+ # Operations plan, the `SubscriptionRequiredException` error message
1368
+ # appears. For information about changing your support plan, see
1369
+ # [Amazon Web Services Support][1].
1039
1370
  #
1040
1371
  # </note>
1041
1372
  #
@@ -1055,9 +1386,10 @@ module Aws::Support
1055
1386
  # @option params [required, String] :language
1056
1387
  # The language in which Amazon Web Services Support handles the case.
1057
1388
  # Amazon Web Services Support currently supports Chinese (“zh”), English
1058
- # ("en"), Japanese ("ja") and Korean (“ko”). You must specify the
1059
- # ISO 639-1 code for the `language` parameter if you want support in
1060
- # that language.
1389
+ # ("en"), Japanese ("ja") , Chinese ("zh"), Spanish ("es"),
1390
+ # Portuguese ("pt"), French ("fr"), Korean (“ko”), and Turkish
1391
+ # ("tr"). You must specify the ISO 639-1 code for the `language`
1392
+ # parameter if you want support in that language.
1061
1393
  #
1062
1394
  # @option params [required, String] :category_code
1063
1395
  # The category of problem for the support case. You also use the
@@ -1065,6 +1397,13 @@ module Aws::Support
1065
1397
  # Each Amazon Web Services service defines its own set of category
1066
1398
  # codes.
1067
1399
  #
1400
+ # @option params [Boolean] :dry_run
1401
+ # Specifies whether to validate the request without actually returning
1402
+ # case option data. When set to `true`, the request is validated but no
1403
+ # options are returned, and the operation returns a
1404
+ # `DryRunOperationException`. When omitted or set to `false`, the
1405
+ # request runs normally.
1406
+ #
1068
1407
  # @return [Types::DescribeCreateCaseOptionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1069
1408
  #
1070
1409
  # * {Types::DescribeCreateCaseOptionsResponse#language_availability #language_availability} => String
@@ -1077,6 +1416,7 @@ module Aws::Support
1077
1416
  # service_code: "ServiceCode", # required
1078
1417
  # language: "Language", # required
1079
1418
  # category_code: "CategoryCode", # required
1419
+ # dry_run: false,
1080
1420
  # })
1081
1421
  #
1082
1422
  # @example Response structure
@@ -1113,14 +1453,21 @@ module Aws::Support
1113
1453
  # codes and categories that the `DescribeServices` operation returns, so
1114
1454
  # that you have the most recent set of service and category codes.
1115
1455
  #
1116
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
1117
- # plan to use the Amazon Web Services Support API.
1456
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
1457
+ # Services Enterprise Support, or Amazon Web Services Unified
1458
+ # Operations plan to use the Amazon Web Services Support API. If
1459
+ # you're in an Amazon Web Services Region that doesn't offer one of
1460
+ # these Amazon Web Services Support plans, or if you haven't
1461
+ # transitioned to one of these plans, you can use the Amazon Web
1462
+ # Services Support API with a Business, Enterprise On-Ramp, or
1463
+ # Enterprise Support plan.
1118
1464
  #
1119
1465
  # * If you call the Amazon Web Services Support API from an account that
1120
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
1121
- # plan, the `SubscriptionRequiredException` error message appears. For
1122
- # information about changing your support plan, see [Amazon Web
1123
- # Services Support][2].
1466
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
1467
+ # Services Enterprise Support, or Amazon Web Services Unified
1468
+ # Operations plan, the `SubscriptionRequiredException` error message
1469
+ # appears. For information about changing your support plan, see
1470
+ # [Amazon Web Services Support][2].
1124
1471
  #
1125
1472
  # </note>
1126
1473
  #
@@ -1136,9 +1483,17 @@ module Aws::Support
1136
1483
  # @option params [String] :language
1137
1484
  # The language in which Amazon Web Services Support handles the case.
1138
1485
  # Amazon Web Services Support currently supports Chinese (“zh”), English
1139
- # ("en"), Japanese ("ja") and Korean (“ko”). You must specify the
1140
- # ISO 639-1 code for the `language` parameter if you want support in
1141
- # that language.
1486
+ # ("en"), Japanese ("ja") , Chinese ("zh"), Spanish ("es"),
1487
+ # Portuguese ("pt"), French ("fr"), Korean (“ko”), and Turkish
1488
+ # ("tr"). You must specify the ISO 639-1 code for the `language`
1489
+ # parameter if you want support in that language.
1490
+ #
1491
+ # @option params [Boolean] :dry_run
1492
+ # Specifies whether to validate the request without actually returning
1493
+ # the list of services. When set to `true`, the request is validated but
1494
+ # no services are returned, and the operation returns a
1495
+ # `DryRunOperationException`. When omitted or set to `false`, the
1496
+ # request runs normally.
1142
1497
  #
1143
1498
  # @return [Types::DescribeServicesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1144
1499
  #
@@ -1149,6 +1504,7 @@ module Aws::Support
1149
1504
  # resp = client.describe_services({
1150
1505
  # service_code_list: ["ServiceCode"],
1151
1506
  # language: "Language",
1507
+ # dry_run: false,
1152
1508
  # })
1153
1509
  #
1154
1510
  # @example Response structure
@@ -1173,14 +1529,21 @@ module Aws::Support
1173
1529
  # case. The severity level for a case is also a field in the CaseDetails
1174
1530
  # data type that you include for a CreateCase request.
1175
1531
  #
1176
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
1177
- # plan to use the Amazon Web Services Support API.
1532
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
1533
+ # Services Enterprise Support, or Amazon Web Services Unified
1534
+ # Operations plan to use the Amazon Web Services Support API. If
1535
+ # you're in an Amazon Web Services Region that doesn't offer one of
1536
+ # these Amazon Web Services Support plans, or if you haven't
1537
+ # transitioned to one of these plans, you can use the Amazon Web
1538
+ # Services Support API with a Business, Enterprise On-Ramp, or
1539
+ # Enterprise Support plan.
1178
1540
  #
1179
1541
  # * If you call the Amazon Web Services Support API from an account that
1180
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
1181
- # plan, the `SubscriptionRequiredException` error message appears. For
1182
- # information about changing your support plan, see [Amazon Web
1183
- # Services Support][1].
1542
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
1543
+ # Services Enterprise Support, or Amazon Web Services Unified
1544
+ # Operations plan, the `SubscriptionRequiredException` error message
1545
+ # appears. For information about changing your support plan, see
1546
+ # [Amazon Web Services Support][1].
1184
1547
  #
1185
1548
  # </note>
1186
1549
  #
@@ -1191,9 +1554,17 @@ module Aws::Support
1191
1554
  # @option params [String] :language
1192
1555
  # The language in which Amazon Web Services Support handles the case.
1193
1556
  # Amazon Web Services Support currently supports Chinese (“zh”), English
1194
- # ("en"), Japanese ("ja") and Korean (“ko”). You must specify the
1195
- # ISO 639-1 code for the `language` parameter if you want support in
1196
- # that language.
1557
+ # ("en"), Japanese ("ja") , Chinese ("zh"), Spanish ("es"),
1558
+ # Portuguese ("pt"), French ("fr"), Korean (“ko”), and Turkish
1559
+ # ("tr"). You must specify the ISO 639-1 code for the `language`
1560
+ # parameter if you want support in that language.
1561
+ #
1562
+ # @option params [Boolean] :dry_run
1563
+ # Specifies whether to validate the request without actually returning
1564
+ # severity levels. When set to `true`, the request is validated but no
1565
+ # severity levels are returned, and the operation returns a
1566
+ # `DryRunOperationException`. When omitted or set to `false`, the
1567
+ # request runs normally.
1197
1568
  #
1198
1569
  # @return [Types::DescribeSeverityLevelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1199
1570
  #
@@ -1203,6 +1574,7 @@ module Aws::Support
1203
1574
  #
1204
1575
  # resp = client.describe_severity_levels({
1205
1576
  # language: "Language",
1577
+ # dry_run: false,
1206
1578
  # })
1207
1579
  #
1208
1580
  # @example Response structure
@@ -1225,14 +1597,21 @@ module Aws::Support
1225
1597
  # include a ISO 639-1 code for the `language`, and the language display
1226
1598
  # name.
1227
1599
  #
1228
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
1229
- # plan to use the Amazon Web Services Support API.
1600
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
1601
+ # Services Enterprise Support, or Amazon Web Services Unified
1602
+ # Operations plan to use the Amazon Web Services Support API. If
1603
+ # you're in an Amazon Web Services Region that doesn't offer one of
1604
+ # these Amazon Web Services Support plans, or if you haven't
1605
+ # transitioned to one of these plans, you can use the Amazon Web
1606
+ # Services Support API with a Business, Enterprise On-Ramp, or
1607
+ # Enterprise Support plan.
1230
1608
  #
1231
1609
  # * If you call the Amazon Web Services Support API from an account that
1232
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
1233
- # plan, the `SubscriptionRequiredException` error message appears. For
1234
- # information about changing your support plan, see [Amazon Web
1235
- # Services Support][1].
1610
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
1611
+ # Services Enterprise Support, or Amazon Web Services Unified
1612
+ # Operations plan, the `SubscriptionRequiredException` error message
1613
+ # appears. For information about changing your support plan, see
1614
+ # [Amazon Web Services Support][1].
1236
1615
  #
1237
1616
  # </note>
1238
1617
  #
@@ -1254,6 +1633,13 @@ module Aws::Support
1254
1633
  # Each Amazon Web Services service defines its own set of category
1255
1634
  # codes.
1256
1635
  #
1636
+ # @option params [Boolean] :dry_run
1637
+ # Specifies whether to validate the request without actually returning
1638
+ # supported languages. When set to `true`, the request is validated but
1639
+ # no languages are returned, and the operation returns a
1640
+ # `DryRunOperationException`. When omitted or set to `false`, the
1641
+ # request runs normally.
1642
+ #
1257
1643
  # @return [Types::DescribeSupportedLanguagesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1258
1644
  #
1259
1645
  # * {Types::DescribeSupportedLanguagesResponse#supported_languages #supported_languages} => Array&lt;Types::SupportedLanguage&gt;
@@ -1264,6 +1650,7 @@ module Aws::Support
1264
1650
  # issue_type: "ValidatedIssueTypeString", # required
1265
1651
  # service_code: "ValidatedServiceCode", # required
1266
1652
  # category_code: "ValidatedCategoryCode", # required
1653
+ # dry_run: false,
1267
1654
  # })
1268
1655
  #
1269
1656
  # @example Response structure
@@ -1292,14 +1679,21 @@ module Aws::Support
1292
1679
  # this operation for these checks, you might see an
1293
1680
  # `InvalidParameterValue` error.
1294
1681
  #
1295
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
1296
- # plan to use the Amazon Web Services Support API.
1682
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
1683
+ # Services Enterprise Support, or Amazon Web Services Unified
1684
+ # Operations plan to use the Amazon Web Services Support API. If
1685
+ # you're in an Amazon Web Services Region that doesn't offer one of
1686
+ # these Amazon Web Services Support plans, or if you haven't
1687
+ # transitioned to one of these plans, you can use the Amazon Web
1688
+ # Services Support API with a Business, Enterprise On-Ramp, or
1689
+ # Enterprise Support plan.
1297
1690
  #
1298
1691
  # * If you call the Amazon Web Services Support API from an account that
1299
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
1300
- # plan, the `SubscriptionRequiredException` error message appears. For
1301
- # information about changing your support plan, see [Amazon Web
1302
- # Services Support][1].
1692
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
1693
+ # Services Enterprise Support, or Amazon Web Services Unified
1694
+ # Operations plan, the `SubscriptionRequiredException` error message
1695
+ # appears. For information about changing your support plan, see
1696
+ # [Amazon Web Services Support][1].
1303
1697
  #
1304
1698
  # </note>
1305
1699
  #
@@ -1371,14 +1765,21 @@ module Aws::Support
1371
1765
  #
1372
1766
  # * **checkId** - The unique identifier for the check.
1373
1767
  #
1374
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
1375
- # plan to use the Amazon Web Services Support API.
1768
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
1769
+ # Services Enterprise Support, or Amazon Web Services Unified
1770
+ # Operations plan to use the Amazon Web Services Support API. If
1771
+ # you're in an Amazon Web Services Region that doesn't offer one of
1772
+ # these Amazon Web Services Support plans, or if you haven't
1773
+ # transitioned to one of these plans, you can use the Amazon Web
1774
+ # Services Support API with a Business, Enterprise On-Ramp, or
1775
+ # Enterprise Support plan.
1376
1776
  #
1377
1777
  # * If you call the Amazon Web Services Support API from an account that
1378
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
1379
- # plan, the `SubscriptionRequiredException` error message appears. For
1380
- # information about changing your support plan, see [Amazon Web
1381
- # Services Support][1].
1778
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
1779
+ # Services Enterprise Support, or Amazon Web Services Unified
1780
+ # Operations plan, the `SubscriptionRequiredException` error message
1781
+ # appears. For information about changing your support plan, see
1782
+ # [Amazon Web Services Support][1].
1382
1783
  #
1383
1784
  # </note>
1384
1785
  #
@@ -1471,14 +1872,21 @@ module Aws::Support
1471
1872
  #
1472
1873
  # The response contains an array of TrustedAdvisorCheckSummary objects.
1473
1874
  #
1474
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
1475
- # plan to use the Amazon Web Services Support API.
1875
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
1876
+ # Services Enterprise Support, or Amazon Web Services Unified
1877
+ # Operations plan to use the Amazon Web Services Support API. If
1878
+ # you're in an Amazon Web Services Region that doesn't offer one of
1879
+ # these Amazon Web Services Support plans, or if you haven't
1880
+ # transitioned to one of these plans, you can use the Amazon Web
1881
+ # Services Support API with a Business, Enterprise On-Ramp, or
1882
+ # Enterprise Support plan.
1476
1883
  #
1477
1884
  # * If you call the Amazon Web Services Support API from an account that
1478
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
1479
- # plan, the `SubscriptionRequiredException` error message appears. For
1480
- # information about changing your support plan, see [Amazon Web
1481
- # Services Support][1].
1885
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
1886
+ # Services Enterprise Support, or Amazon Web Services Unified
1887
+ # Operations plan, the `SubscriptionRequiredException` error message
1888
+ # appears. For information about changing your support plan, see
1889
+ # [Amazon Web Services Support][1].
1482
1890
  #
1483
1891
  # </note>
1484
1892
  #
@@ -1489,10 +1897,27 @@ module Aws::Support
1489
1897
  # [About the Amazon Web Services Support API][2] in the *Amazon Web
1490
1898
  # Services Support User Guide*.
1491
1899
  #
1900
+ # **Understanding the Trusted Advisor Resources processed value**
1901
+ #
1902
+ # The **Resources processed** value, `resourcesProcessed`, usually shows
1903
+ # both flagged resources (those with warnings or errors) and resources
1904
+ # in good standing (ok status resources). However, some checks report
1905
+ # flagged resources only. To understand what a specific check reports,
1906
+ # review the detailed check information in the [Trusted Advisor check
1907
+ # reference][3]. If you see a **Green** criterion listed in the **Alert
1908
+ # criteria**, then the check reports all resources. If there's no
1909
+ # **Green** criterion listed in the **Alert criteria**, then the check
1910
+ # reports only flagged resources. For example, the [Amazon EC2 Reserved
1911
+ # Instance optimization check (cX3c2R1chu)][4] doesn't list a **Green**
1912
+ # criterion in the **Alert criteria**. So, this check only reports
1913
+ # flagged resources.
1914
+ #
1492
1915
  #
1493
1916
  #
1494
1917
  # [1]: http://aws.amazon.com/premiumsupport/
1495
1918
  # [2]: https://docs.aws.amazon.com/awssupport/latest/user/about-support-api.html#endpoint
1919
+ # [3]: https://docs.aws.amazon.com/awssupport/latest/user/trusted-advisor-check-reference.html
1920
+ # [4]: https://docs.aws.amazon.com/awssupport/latest/user/cost-optimization-checks.html#amazon-ec2-reserved-instances-optimization
1496
1921
  #
1497
1922
  # @option params [required, Array<String>] :check_ids
1498
1923
  # The IDs of the Trusted Advisor checks.
@@ -1537,14 +1962,16 @@ module Aws::Support
1537
1962
  # The response contains a TrustedAdvisorCheckDescription object for each
1538
1963
  # check. You must set the Amazon Web Services Region to us-east-1.
1539
1964
  #
1540
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
1541
- # plan to use the Amazon Web Services Support API.
1965
+ # <note markdown="1"> * You must have a Amazon Web Services Business Support+, Amazon Web
1966
+ # Services Enterprise Support, or Amazon Web Services Unified
1967
+ # Operations plan to use the Amazon Web Services Support API.
1542
1968
  #
1543
1969
  # * If you call the Amazon Web Services Support API from an account that
1544
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
1545
- # plan, the `SubscriptionRequiredException` error message appears. For
1546
- # information about changing your support plan, see [Amazon Web
1547
- # Services Support][1].
1970
+ # doesn't have a Amazon Web Services Business Support+, Amazon Web
1971
+ # Services Enterprise Support, or Amazon Web Services Unified
1972
+ # Operations plan, the `SubscriptionRequiredException` error message
1973
+ # appears. For information about changing your support plan, see
1974
+ # [Amazon Web Services Support][1].
1548
1975
  #
1549
1976
  # * The names and descriptions for Trusted Advisor checks are subject to
1550
1977
  # change. We recommend that you specify the check ID in your code to
@@ -1622,6 +2049,186 @@ module Aws::Support
1622
2049
  req.send_request(options)
1623
2050
  end
1624
2051
 
2052
+ # Returns a presigned download URL for an attachment that is associated
2053
+ # with a case communication. The download link works for an attachment
2054
+ # of any size, including attachments added through `AddAttachmentsToSet`
2055
+ # and attachments uploaded through GetAttachmentUploadLinks. The
2056
+ # download URL is time-limited and expires at the date and time
2057
+ # indicated in the `downloadUrl` response field. Download the attachment
2058
+ # from the URL before it expires.
2059
+ #
2060
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
2061
+ # Services Enterprise Support, or Amazon Web Services Unified
2062
+ # Operations plan to use the Amazon Web Services Support API. If
2063
+ # you're in an Amazon Web Services Region that doesn't offer one of
2064
+ # these Amazon Web Services Support plans, or if you haven't
2065
+ # transitioned to one of these plans, you can use the Amazon Web
2066
+ # Services Support API with a Business, Enterprise On-Ramp, or
2067
+ # Enterprise Support plan.
2068
+ #
2069
+ # * If you call the Amazon Web Services Support API from an account that
2070
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
2071
+ # Services Enterprise Support, or Amazon Web Services Unified
2072
+ # Operations plan, the `SubscriptionRequiredException` error message
2073
+ # appears. For information about changing your support plan, see
2074
+ # [Amazon Web Services Support][1].
2075
+ #
2076
+ # </note>
2077
+ #
2078
+ #
2079
+ #
2080
+ # [1]: http://aws.amazon.com/premiumsupport/
2081
+ #
2082
+ # @option params [required, String] :attachment_id
2083
+ # The unique identifier of the attachment for which to retrieve a
2084
+ # download link. Attachment IDs are returned in the `AttachmentDetails`
2085
+ # objects in the `attachments` field of a Communication returned by
2086
+ # DescribeCommunications or DescribeCases.
2087
+ #
2088
+ # @option params [Boolean] :dry_run
2089
+ # Specifies whether to validate the request without actually returning a
2090
+ # download link. When set to `true`, the request is validated but no URL
2091
+ # is returned, and the operation returns a `DryRunOperationException`.
2092
+ # When omitted or set to `false`, the request runs normally.
2093
+ #
2094
+ # @return [Types::GetAttachmentDownloadLinkResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2095
+ #
2096
+ # * {Types::GetAttachmentDownloadLinkResponse#file_name #file_name} => String
2097
+ # * {Types::GetAttachmentDownloadLinkResponse#download_url #download_url} => Types::DownloadUrl
2098
+ #
2099
+ # @example Request syntax with placeholder values
2100
+ #
2101
+ # resp = client.get_attachment_download_link({
2102
+ # attachment_id: "AttachmentId", # required
2103
+ # dry_run: false,
2104
+ # })
2105
+ #
2106
+ # @example Response structure
2107
+ #
2108
+ # resp.file_name #=> String
2109
+ # resp.download_url.url #=> String
2110
+ # resp.download_url.expiry_date #=> String
2111
+ #
2112
+ # @see http://docs.aws.amazon.com/goto/WebAPI/support-2013-04-15/GetAttachmentDownloadLink AWS API Documentation
2113
+ #
2114
+ # @overload get_attachment_download_link(params = {})
2115
+ # @param [Hash] params ({})
2116
+ def get_attachment_download_link(params = {}, options = {})
2117
+ req = build_request(:get_attachment_download_link, params)
2118
+ req.send_request(options)
2119
+ end
2120
+
2121
+ # Returns one or more presigned upload URLs for uploading a large file
2122
+ # attachment to a support case by using a multipart upload workflow. The
2123
+ # maximum file size that you can upload with this workflow is 150 MB,
2124
+ # and parts can be up to 100 MB each. Initiate a new upload by providing
2125
+ # `fileName` and `fileSizeBytes`; the response returns a unique
2126
+ # `uploadId`, the part size, the total number of parts, and a list of
2127
+ # presigned upload URLs for the requested range of parts. A maximum of
2128
+ # 10 upload URLs are returned per call. To retrieve more upload URLs for
2129
+ # an upload that's already in progress, call `GetAttachmentUploadLinks`
2130
+ # again with the existing `uploadId` and a new `uploadRange`.
2131
+ #
2132
+ # Upload each part to its presigned URL by using HTTP `PUT` and capture
2133
+ # the ETag from the response. After you upload all parts, call
2134
+ # CompleteAttachmentUpload with the `uploadId` and the list of part
2135
+ # indexes and ETags to finalize the upload. You can then attach the
2136
+ # upload to a case by passing the `uploadId` in the `uploadIds`
2137
+ # parameter of CreateCase or AddCommunicationToCase. To monitor progress
2138
+ # before completion, call DescribeAttachmentUploadStatus.
2139
+ #
2140
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
2141
+ # Services Enterprise Support, or Amazon Web Services Unified
2142
+ # Operations plan to use the Amazon Web Services Support API. If
2143
+ # you're in an Amazon Web Services Region that doesn't offer one of
2144
+ # these Amazon Web Services Support plans, or if you haven't
2145
+ # transitioned to one of these plans, you can use the Amazon Web
2146
+ # Services Support API with a Business, Enterprise On-Ramp, or
2147
+ # Enterprise Support plan.
2148
+ #
2149
+ # * If you call the Amazon Web Services Support API from an account that
2150
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
2151
+ # Services Enterprise Support, or Amazon Web Services Unified
2152
+ # Operations plan, the `SubscriptionRequiredException` error message
2153
+ # appears. For information about changing your support plan, see
2154
+ # [Amazon Web Services Support][1].
2155
+ #
2156
+ # </note>
2157
+ #
2158
+ #
2159
+ #
2160
+ # [1]: http://aws.amazon.com/premiumsupport/
2161
+ #
2162
+ # @option params [required, String] :file_name
2163
+ # The name of the file to upload, including the file extension. This
2164
+ # value is required when you initiate a new upload.
2165
+ #
2166
+ # @option params [Integer] :file_size_bytes
2167
+ # The total size of the file in bytes. The service uses this value to
2168
+ # calculate the total number of parts and the size of each part.
2169
+ # Required when you initiate a new upload (when `uploadId` isn't
2170
+ # provided). Valid range: 1 to 157,286,400 bytes (approximately 150 MB).
2171
+ #
2172
+ # @option params [String] :upload_id
2173
+ # The unique identifier of an in-progress multipart upload, returned by
2174
+ # a previous call to `GetAttachmentUploadLinks`. Specify `uploadId` to
2175
+ # retrieve additional presigned upload URLs for an upload that has
2176
+ # already been initiated. Required when `fileSizeBytes` isn't provided.
2177
+ # Length: 1 to 2,048 characters.
2178
+ #
2179
+ # @option params [Types::UploadRange] :upload_range
2180
+ # The range of part indexes for which to return presigned upload URLs.
2181
+ # Use this parameter to page through the upload URLs for a large file
2182
+ # across multiple calls. If you omit this parameter, the service
2183
+ # determines the range to return.
2184
+ #
2185
+ # @option params [Boolean] :dry_run
2186
+ # Specifies whether to validate the request without actually generating
2187
+ # upload URLs. When set to `true`, the request is validated but no URLs
2188
+ # are returned, and the operation returns a `DryRunOperationException`.
2189
+ # When omitted or set to `false`, the request runs normally.
2190
+ #
2191
+ # @return [Types::GetAttachmentUploadLinksResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2192
+ #
2193
+ # * {Types::GetAttachmentUploadLinksResponse#upload_id #upload_id} => String
2194
+ # * {Types::GetAttachmentUploadLinksResponse#part_size_bytes #part_size_bytes} => Integer
2195
+ # * {Types::GetAttachmentUploadLinksResponse#total_parts #total_parts} => Integer
2196
+ # * {Types::GetAttachmentUploadLinksResponse#next_index #next_index} => Integer
2197
+ # * {Types::GetAttachmentUploadLinksResponse#upload_urls #upload_urls} => Array&lt;Types::UploadUrl&gt;
2198
+ #
2199
+ # @example Request syntax with placeholder values
2200
+ #
2201
+ # resp = client.get_attachment_upload_links({
2202
+ # file_name: "FileName", # required
2203
+ # file_size_bytes: 1,
2204
+ # upload_id: "UploadId",
2205
+ # upload_range: {
2206
+ # start_index: 1, # required
2207
+ # end_index: 1,
2208
+ # },
2209
+ # dry_run: false,
2210
+ # })
2211
+ #
2212
+ # @example Response structure
2213
+ #
2214
+ # resp.upload_id #=> String
2215
+ # resp.part_size_bytes #=> Integer
2216
+ # resp.total_parts #=> Integer
2217
+ # resp.next_index #=> Integer
2218
+ # resp.upload_urls #=> Array
2219
+ # resp.upload_urls[0].url #=> String
2220
+ # resp.upload_urls[0].part_index #=> Integer
2221
+ # resp.upload_urls[0].expiry_date #=> String
2222
+ #
2223
+ # @see http://docs.aws.amazon.com/goto/WebAPI/support-2013-04-15/GetAttachmentUploadLinks AWS API Documentation
2224
+ #
2225
+ # @overload get_attachment_upload_links(params = {})
2226
+ # @param [Hash] params ({})
2227
+ def get_attachment_upload_links(params = {}, options = {})
2228
+ req = build_request(:get_attachment_upload_links, params)
2229
+ req.send_request(options)
2230
+ end
2231
+
1625
2232
  # Refreshes the Trusted Advisor check that you specify using the check
1626
2233
  # ID. You can get the check IDs by calling the
1627
2234
  # DescribeTrustedAdvisorChecks operation.
@@ -1632,14 +2239,21 @@ module Aws::Support
1632
2239
  #
1633
2240
  # The response contains a TrustedAdvisorCheckRefreshStatus object.
1634
2241
  #
1635
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
1636
- # plan to use the Amazon Web Services Support API.
2242
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
2243
+ # Services Enterprise Support, or Amazon Web Services Unified
2244
+ # Operations plan to use the Amazon Web Services Support API. If
2245
+ # you're in an Amazon Web Services Region that doesn't offer one of
2246
+ # these Amazon Web Services Support plans, or if you haven't
2247
+ # transitioned to one of these plans, you can use the Amazon Web
2248
+ # Services Support API with a Business, Enterprise On-Ramp, or
2249
+ # Enterprise Support plan.
1637
2250
  #
1638
2251
  # * If you call the Amazon Web Services Support API from an account that
1639
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
1640
- # plan, the `SubscriptionRequiredException` error message appears. For
1641
- # information about changing your support plan, see [Amazon Web
1642
- # Services Support][1].
2252
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
2253
+ # Services Enterprise Support, or Amazon Web Services Unified
2254
+ # Operations plan, the `SubscriptionRequiredException` error message
2255
+ # appears. For information about changing your support plan, see
2256
+ # [Amazon Web Services Support][1].
1643
2257
  #
1644
2258
  # </note>
1645
2259
  #
@@ -1691,14 +2305,21 @@ module Aws::Support
1691
2305
  # Resolves a support case. This operation takes a `caseId` and returns
1692
2306
  # the initial and final state of the case.
1693
2307
  #
1694
- # <note markdown="1"> * You must have a Business, Enterprise On-Ramp, or Enterprise Support
1695
- # plan to use the Amazon Web Services Support API.
2308
+ # <note markdown="1"> * You must have an Amazon Web Services Business Support+, Amazon Web
2309
+ # Services Enterprise Support, or Amazon Web Services Unified
2310
+ # Operations plan to use the Amazon Web Services Support API. If
2311
+ # you're in an Amazon Web Services Region that doesn't offer one of
2312
+ # these Amazon Web Services Support plans, or if you haven't
2313
+ # transitioned to one of these plans, you can use the Amazon Web
2314
+ # Services Support API with a Business, Enterprise On-Ramp, or
2315
+ # Enterprise Support plan.
1696
2316
  #
1697
2317
  # * If you call the Amazon Web Services Support API from an account that
1698
- # doesn't have a Business, Enterprise On-Ramp, or Enterprise Support
1699
- # plan, the `SubscriptionRequiredException` error message appears. For
1700
- # information about changing your support plan, see [Amazon Web
1701
- # Services Support][1].
2318
+ # doesn't have an Amazon Web Services Business Support+, Amazon Web
2319
+ # Services Enterprise Support, or Amazon Web Services Unified
2320
+ # Operations plan, the `SubscriptionRequiredException` error message
2321
+ # appears. For information about changing your support plan, see
2322
+ # [Amazon Web Services Support][1].
1702
2323
  #
1703
2324
  # </note>
1704
2325
  #
@@ -1709,7 +2330,14 @@ module Aws::Support
1709
2330
  # @option params [String] :case_id
1710
2331
  # The support case ID requested or returned in the call. The case ID is
1711
2332
  # an alphanumeric string formatted as shown in this example:
1712
- # case-*12345678910-2013-c4c1d2bf33c5cf47*
2333
+ # case-*12345678910-exen-2025-c4c1d2bf33c5cf47*
2334
+ #
2335
+ # @option params [Boolean] :dry_run
2336
+ # Specifies whether to validate the request without actually resolving
2337
+ # the case. When set to `true`, the request is validated but the case
2338
+ # isn't resolved, and the operation returns a
2339
+ # `DryRunOperationException`. When omitted or set to `false`, the
2340
+ # request runs normally.
1713
2341
  #
1714
2342
  # @return [Types::ResolveCaseResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1715
2343
  #
@@ -1720,6 +2348,7 @@ module Aws::Support
1720
2348
  #
1721
2349
  # resp = client.resolve_case({
1722
2350
  # case_id: "CaseId",
2351
+ # dry_run: false,
1723
2352
  # })
1724
2353
  #
1725
2354
  # @example Response structure
@@ -1754,7 +2383,7 @@ module Aws::Support
1754
2383
  tracer: tracer
1755
2384
  )
1756
2385
  context[:gem_name] = 'aws-sdk-support'
1757
- context[:gem_version] = '1.93.0'
2386
+ context[:gem_version] = '1.95.0'
1758
2387
  Seahorse::Client::Request.new(handlers, context)
1759
2388
  end
1760
2389