aws-sdk-partnercentralselling 1.2.0 → 1.4.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -10,6 +10,29 @@
10
10
  module Aws::PartnerCentralSelling
11
11
  module Types
12
12
 
13
+ # @!attribute [rw] catalog
14
+ # The `CatalogType` parameter specifies the catalog associated with
15
+ # the engagement invitation. Accepted values are `AWS` and `Sandbox`,
16
+ # which determine the environment in which the engagement invitation
17
+ # is managed.
18
+ # @return [String]
19
+ #
20
+ # @!attribute [rw] identifier
21
+ # The `Identifier` parameter in the
22
+ # `AcceptEngagementInvitationRequest` specifies the unique identifier
23
+ # of the `EngagementInvitation` to be accepted. Providing the correct
24
+ # identifier ensures that the intended invitation is accepted.
25
+ # @return [String]
26
+ #
27
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/AcceptEngagementInvitationRequest AWS API Documentation
28
+ #
29
+ class AcceptEngagementInvitationRequest < Struct.new(
30
+ :catalog,
31
+ :identifier)
32
+ SENSITIVE = []
33
+ include Aws::Structure
34
+ end
35
+
13
36
  # This error occurs when you don't have permission to perform the
14
37
  # requested action.
15
38
  #
@@ -619,6 +642,138 @@ module Aws::PartnerCentralSelling
619
642
  include Aws::Structure
620
643
  end
621
644
 
645
+ # @!attribute [rw] catalog
646
+ # Specifies the catalog related to the engagement. Accepted values are
647
+ # `AWS` and `Sandbox`, which determine the environment in which the
648
+ # engagement is managed.
649
+ # @return [String]
650
+ #
651
+ # @!attribute [rw] client_token
652
+ # Specifies a unique, client-generated UUID to ensure that the request
653
+ # is handled exactly once. This token helps prevent duplicate
654
+ # invitation creations.
655
+ #
656
+ # **A suitable default value is auto-generated.** You should normally
657
+ # not need to pass this option.
658
+ # @return [String]
659
+ #
660
+ # @!attribute [rw] engagement_identifier
661
+ # The unique identifier of the `Engagement` associated with the
662
+ # invitation. This parameter ensures the invitation is created within
663
+ # the correct `Engagement` context.
664
+ # @return [String]
665
+ #
666
+ # @!attribute [rw] invitation
667
+ # The `Invitation` object all information necessary to initiate an
668
+ # engagement invitation to a partner. It contains a personalized
669
+ # message from the sender, the invitation's receiver, and a payload.
670
+ # The `Payload` can be the `OpportunityInvitation`, which includes
671
+ # detailed structures for sender contacts, partner responsibilities,
672
+ # customer information, and project details.
673
+ # @return [Types::Invitation]
674
+ #
675
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/CreateEngagementInvitationRequest AWS API Documentation
676
+ #
677
+ class CreateEngagementInvitationRequest < Struct.new(
678
+ :catalog,
679
+ :client_token,
680
+ :engagement_identifier,
681
+ :invitation)
682
+ SENSITIVE = []
683
+ include Aws::Structure
684
+ end
685
+
686
+ # @!attribute [rw] arn
687
+ # The Amazon Resource Name (ARN) that uniquely identifies the
688
+ # engagement invitation.
689
+ # @return [String]
690
+ #
691
+ # @!attribute [rw] id
692
+ # Unique identifier assigned to the newly created engagement
693
+ # invitation.
694
+ # @return [String]
695
+ #
696
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/CreateEngagementInvitationResponse AWS API Documentation
697
+ #
698
+ class CreateEngagementInvitationResponse < Struct.new(
699
+ :arn,
700
+ :id)
701
+ SENSITIVE = []
702
+ include Aws::Structure
703
+ end
704
+
705
+ # @!attribute [rw] catalog
706
+ # The `CreateEngagementRequest$Catalog` parameter specifies the
707
+ # catalog related to the engagement. Accepted values are `AWS` and
708
+ # `Sandbox`, which determine the environment in which the engagement
709
+ # is managed.
710
+ # @return [String]
711
+ #
712
+ # @!attribute [rw] client_token
713
+ # The `CreateEngagementRequest$ClientToken` parameter specifies a
714
+ # unique, case-sensitive identifier to ensure that the request is
715
+ # handled exactly once. The value must not exceed sixty-four
716
+ # alphanumeric characters.
717
+ #
718
+ # **A suitable default value is auto-generated.** You should normally
719
+ # not need to pass this option.
720
+ # @return [String]
721
+ #
722
+ # @!attribute [rw] contexts
723
+ # The `Contexts` field is a required array of objects, with a maximum
724
+ # of 5 contexts allowed, specifying detailed information about
725
+ # customer projects associated with the Engagement. Each context
726
+ # object contains a `Type` field indicating the context type, which
727
+ # must be `CustomerProject` in this version, and a `Payload` field
728
+ # containing the `CustomerProject` details. The `CustomerProject`
729
+ # object is composed of two main components: `Customer` and `Project`.
730
+ # The `Customer` object includes information such as `CompanyName`,
731
+ # `WebsiteUrl`, `Industry`, and `CountryCode`, providing essential
732
+ # details about the customer. The `Project` object contains `Title`,
733
+ # `BusinessProblem`, and `TargetCompletionDate`, offering insights
734
+ # into the specific project associated with the customer. This
735
+ # structure allows comprehensive context to be included within the
736
+ # Engagement, facilitating effective collaboration between parties by
737
+ # providing relevant customer and project information.
738
+ # @return [Array<Types::EngagementContextDetails>]
739
+ #
740
+ # @!attribute [rw] description
741
+ # Provides a description of the `Engagement`.
742
+ # @return [String]
743
+ #
744
+ # @!attribute [rw] title
745
+ # Specifies the title of the `Engagement`.
746
+ # @return [String]
747
+ #
748
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/CreateEngagementRequest AWS API Documentation
749
+ #
750
+ class CreateEngagementRequest < Struct.new(
751
+ :catalog,
752
+ :client_token,
753
+ :contexts,
754
+ :description,
755
+ :title)
756
+ SENSITIVE = []
757
+ include Aws::Structure
758
+ end
759
+
760
+ # @!attribute [rw] arn
761
+ # The Amazon Resource Name (ARN) that identifies the engagement.
762
+ # @return [String]
763
+ #
764
+ # @!attribute [rw] id
765
+ # Unique identifier assigned to the newly created engagement.
766
+ # @return [String]
767
+ #
768
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/CreateEngagementResponse AWS API Documentation
769
+ #
770
+ class CreateEngagementResponse < Struct.new(
771
+ :arn,
772
+ :id)
773
+ SENSITIVE = []
774
+ include Aws::Structure
775
+ end
776
+
622
777
  # @!attribute [rw] catalog
623
778
  # Specifies the catalog associated with the request. This field takes
624
779
  # a string value from a predefined list: `AWS` or `Sandbox`. The
@@ -748,13 +903,6 @@ module Aws::PartnerCentralSelling
748
903
  # * Cosell—Support for Public Tender/RFx: Opportunity related to the
749
904
  # public sector where the partner needs Amazon Web Services RFx
750
905
  # support.
751
- #
752
- # * Do Not Need Support from AWS Sales Rep: Indicates that a partner
753
- # doesn't need support from an Amazon Web Services sales
754
- # representative, and the partner solely manages the opportunity.
755
- # It's possible to request coselling support on these opportunities
756
- # at any stage during their lifecycles. This is also known as a
757
- # for-visibility-only (FVO) opportunity.
758
906
  # @return [Array<String>]
759
907
  #
760
908
  # @!attribute [rw] project
@@ -815,6 +963,148 @@ module Aws::PartnerCentralSelling
815
963
  include Aws::Structure
816
964
  end
817
965
 
966
+ # @!attribute [rw] catalog
967
+ # Specifies the catalog in which to create the snapshot job. Valid
968
+ # values are `AWS` and ` Sandbox`.
969
+ # @return [String]
970
+ #
971
+ # @!attribute [rw] client_token
972
+ # A client-generated UUID used for idempotency check. The token helps
973
+ # prevent duplicate job creations.
974
+ #
975
+ # **A suitable default value is auto-generated.** You should normally
976
+ # not need to pass this option.
977
+ # @return [String]
978
+ #
979
+ # @!attribute [rw] engagement_identifier
980
+ # Specifies the identifier of the engagement associated with the
981
+ # resource to be snapshotted.
982
+ # @return [String]
983
+ #
984
+ # @!attribute [rw] resource_identifier
985
+ # Specifies the identifier of the specific resource to be snapshotted.
986
+ # The format depends on the ` ResourceType`.
987
+ # @return [String]
988
+ #
989
+ # @!attribute [rw] resource_snapshot_template_identifier
990
+ # Specifies the name of the template that defines the schema for the
991
+ # snapshot.
992
+ # @return [String]
993
+ #
994
+ # @!attribute [rw] resource_type
995
+ # The type of resource for which the snapshot job is being created.
996
+ # Must be one of the supported resource types i.e. `Opportunity`
997
+ # @return [String]
998
+ #
999
+ # @!attribute [rw] tags
1000
+ # A list of objects specifying each tag name and value.
1001
+ # @return [Array<Types::Tag>]
1002
+ #
1003
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/CreateResourceSnapshotJobRequest AWS API Documentation
1004
+ #
1005
+ class CreateResourceSnapshotJobRequest < Struct.new(
1006
+ :catalog,
1007
+ :client_token,
1008
+ :engagement_identifier,
1009
+ :resource_identifier,
1010
+ :resource_snapshot_template_identifier,
1011
+ :resource_type,
1012
+ :tags)
1013
+ SENSITIVE = []
1014
+ include Aws::Structure
1015
+ end
1016
+
1017
+ # @!attribute [rw] arn
1018
+ # The Amazon Resource Name (ARN) of the created snapshot job.
1019
+ # @return [String]
1020
+ #
1021
+ # @!attribute [rw] id
1022
+ # The unique identifier for the created snapshot job.
1023
+ # @return [String]
1024
+ #
1025
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/CreateResourceSnapshotJobResponse AWS API Documentation
1026
+ #
1027
+ class CreateResourceSnapshotJobResponse < Struct.new(
1028
+ :arn,
1029
+ :id)
1030
+ SENSITIVE = []
1031
+ include Aws::Structure
1032
+ end
1033
+
1034
+ # @!attribute [rw] catalog
1035
+ # Specifies the catalog where the snapshot is created. Valid values
1036
+ # are `AWS` and `Sandbox`.
1037
+ # @return [String]
1038
+ #
1039
+ # @!attribute [rw] client_token
1040
+ # Specifies a unique, client-generated UUID to ensure that the request
1041
+ # is handled exactly once. This token helps prevent duplicate snapshot
1042
+ # creations.
1043
+ #
1044
+ # **A suitable default value is auto-generated.** You should normally
1045
+ # not need to pass this option.
1046
+ # @return [String]
1047
+ #
1048
+ # @!attribute [rw] engagement_identifier
1049
+ # The unique identifier of the engagement associated with this
1050
+ # snapshot. This field links the snapshot to a specific engagement
1051
+ # context.
1052
+ # @return [String]
1053
+ #
1054
+ # @!attribute [rw] resource_identifier
1055
+ # The unique identifier of the specific resource to be snapshotted.
1056
+ # The format and constraints of this identifier depend on the
1057
+ # `ResourceType` specified. For example: For `Opportunity` type, it
1058
+ # will be an opportunity ID.
1059
+ # @return [String]
1060
+ #
1061
+ # @!attribute [rw] resource_snapshot_template_identifier
1062
+ # The name of the template that defines the schema for the snapshot.
1063
+ # This template determines which subset of the resource data will be
1064
+ # included in the snapshot. Must correspond to an existing and valid
1065
+ # template for the specified `ResourceType`.
1066
+ # @return [String]
1067
+ #
1068
+ # @!attribute [rw] resource_type
1069
+ # Specifies the type of resource for which the snapshot is being
1070
+ # created. This field determines the structure and content of the
1071
+ # snapshot. Must be one of the supported resource types, such as:
1072
+ # `Opportunity`.
1073
+ # @return [String]
1074
+ #
1075
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/CreateResourceSnapshotRequest AWS API Documentation
1076
+ #
1077
+ class CreateResourceSnapshotRequest < Struct.new(
1078
+ :catalog,
1079
+ :client_token,
1080
+ :engagement_identifier,
1081
+ :resource_identifier,
1082
+ :resource_snapshot_template_identifier,
1083
+ :resource_type)
1084
+ SENSITIVE = []
1085
+ include Aws::Structure
1086
+ end
1087
+
1088
+ # @!attribute [rw] arn
1089
+ # Specifies the Amazon Resource Name (ARN) that uniquely identifies
1090
+ # the snapshot created.
1091
+ # @return [String]
1092
+ #
1093
+ # @!attribute [rw] revision
1094
+ # Specifies the revision number of the created snapshot. This field
1095
+ # provides important information about the snapshot's place in the
1096
+ # sequence of snapshots for the given resource.
1097
+ # @return [Integer]
1098
+ #
1099
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/CreateResourceSnapshotResponse AWS API Documentation
1100
+ #
1101
+ class CreateResourceSnapshotResponse < Struct.new(
1102
+ :arn,
1103
+ :revision)
1104
+ SENSITIVE = []
1105
+ include Aws::Structure
1106
+ end
1107
+
818
1108
  # An object that contains the customer's `Account` and `Contact`.
819
1109
  #
820
1110
  # @!attribute [rw] account
@@ -838,6 +1128,38 @@ module Aws::PartnerCentralSelling
838
1128
  include Aws::Structure
839
1129
  end
840
1130
 
1131
+ # The CustomerProjects structure in Engagements offers a flexible
1132
+ # framework for managing customer-project relationships. It supports
1133
+ # multiple customers per Engagement and multiple projects per customer,
1134
+ # while also allowing for customers without projects and projects
1135
+ # without specific customers.
1136
+ #
1137
+ # All Engagement members have full visibility of customers and their
1138
+ # associated projects, enabling the capture of relevant context even
1139
+ # when project details are not fully defined. This structure also
1140
+ # facilitates targeted invitations, allowing partners to focus on
1141
+ # specific customers and their business problems when sending Engagement
1142
+ # invitations.
1143
+ #
1144
+ # @!attribute [rw] customer
1145
+ # Contains details about the customer associated with the Engagement
1146
+ # Invitation, including company information and industry.
1147
+ # @return [Types::EngagementCustomer]
1148
+ #
1149
+ # @!attribute [rw] project
1150
+ # Information about the customer project associated with the
1151
+ # Engagement.
1152
+ # @return [Types::EngagementCustomerProjectDetails]
1153
+ #
1154
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/CustomerProjectsContext AWS API Documentation
1155
+ #
1156
+ class CustomerProjectsContext < Struct.new(
1157
+ :customer,
1158
+ :project)
1159
+ SENSITIVE = []
1160
+ include Aws::Structure
1161
+ end
1162
+
841
1163
  # An object that contains a `Customer` object's subset of fields.
842
1164
  #
843
1165
  # @!attribute [rw] account
@@ -852,6 +1174,24 @@ module Aws::PartnerCentralSelling
852
1174
  include Aws::Structure
853
1175
  end
854
1176
 
1177
+ # @!attribute [rw] catalog
1178
+ # Specifies the catalog from which to delete the snapshot job. Valid
1179
+ # values are `AWS` and `Sandbox`.
1180
+ # @return [String]
1181
+ #
1182
+ # @!attribute [rw] resource_snapshot_job_identifier
1183
+ # The unique identifier of the resource snapshot job to be deleted.
1184
+ # @return [String]
1185
+ #
1186
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/DeleteResourceSnapshotJobRequest AWS API Documentation
1187
+ #
1188
+ class DeleteResourceSnapshotJobRequest < Struct.new(
1189
+ :catalog,
1190
+ :resource_snapshot_job_identifier)
1191
+ SENSITIVE = []
1192
+ include Aws::Structure
1193
+ end
1194
+
855
1195
  # @!attribute [rw] catalog
856
1196
  # Specifies the catalog associated with the request. This field takes
857
1197
  # a string value from a predefined list: `AWS` or `Sandbox`. The
@@ -917,6 +1257,57 @@ module Aws::PartnerCentralSelling
917
1257
  include Aws::Structure
918
1258
  end
919
1259
 
1260
+ # Provides detailed context information for an Engagement. This
1261
+ # structure allows for specifying the type of context and its associated
1262
+ # payload.
1263
+ #
1264
+ # @!attribute [rw] payload
1265
+ # Contains the specific details of the Engagement context. The
1266
+ # structure of this payload varies depending on the Type field.
1267
+ # @return [Types::EngagementContextPayload]
1268
+ #
1269
+ # @!attribute [rw] type
1270
+ # Specifies the type of Engagement context. Valid values are
1271
+ # "CustomerProject" or "Document", indicating whether the context
1272
+ # relates to a customer project or a document respectively.
1273
+ # @return [String]
1274
+ #
1275
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/EngagementContextDetails AWS API Documentation
1276
+ #
1277
+ class EngagementContextDetails < Struct.new(
1278
+ :payload,
1279
+ :type)
1280
+ SENSITIVE = []
1281
+ include Aws::Structure
1282
+ end
1283
+
1284
+ # Represents the payload of an Engagement context. The structure of this
1285
+ # payload varies based on the context type specified in the
1286
+ # EngagementContextDetails.
1287
+ #
1288
+ # @note EngagementContextPayload is a union - when making an API calls you must set exactly one of the members.
1289
+ #
1290
+ # @note EngagementContextPayload is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of EngagementContextPayload corresponding to the set member.
1291
+ #
1292
+ # @!attribute [rw] customer_project
1293
+ # Contains detailed information about a customer project when the
1294
+ # context type is "CustomerProject". This field is present only when
1295
+ # the Type in EngagementContextDetails is set to "CustomerProject".
1296
+ # @return [Types::CustomerProjectsContext]
1297
+ #
1298
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/EngagementContextPayload AWS API Documentation
1299
+ #
1300
+ class EngagementContextPayload < Struct.new(
1301
+ :customer_project,
1302
+ :unknown)
1303
+ SENSITIVE = []
1304
+ include Aws::Structure
1305
+ include Aws::Structure::Union
1306
+
1307
+ class CustomerProject < EngagementContextPayload; end
1308
+ class Unknown < EngagementContextPayload; end
1309
+ end
1310
+
920
1311
  # Contains details about the customer associated with the Engagement
921
1312
  # Invitation, including company information and industry.
922
1313
  #
@@ -954,6 +1345,32 @@ module Aws::PartnerCentralSelling
954
1345
  include Aws::Structure
955
1346
  end
956
1347
 
1348
+ # Provides comprehensive details about a customer project associated
1349
+ # with an Engagement. This may include information such as project
1350
+ # goals, timelines, and specific customer requirements.
1351
+ #
1352
+ # @!attribute [rw] business_problem
1353
+ # A description of the business problem the project aims to solve.
1354
+ # @return [String]
1355
+ #
1356
+ # @!attribute [rw] target_completion_date
1357
+ # The target completion date for the customer's project.
1358
+ # @return [String]
1359
+ #
1360
+ # @!attribute [rw] title
1361
+ # The title of the project.
1362
+ # @return [String]
1363
+ #
1364
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/EngagementCustomerProjectDetails AWS API Documentation
1365
+ #
1366
+ class EngagementCustomerProjectDetails < Struct.new(
1367
+ :business_problem,
1368
+ :target_completion_date,
1369
+ :title)
1370
+ SENSITIVE = [:business_problem]
1371
+ include Aws::Structure
1372
+ end
1373
+
957
1374
  # Provides a summarized view of the Engagement Invitation, including
958
1375
  # details like the identifier, status, and sender. This summary helps
959
1376
  # partners track and manage AWS originated opportunities.
@@ -970,6 +1387,11 @@ module Aws::PartnerCentralSelling
970
1387
  # whether the opportunity is live or being tested.
971
1388
  # @return [String]
972
1389
  #
1390
+ # @!attribute [rw] engagement_id
1391
+ # The identifier of the Engagement associated with this invitation.
1392
+ # This links the invitation to its parent Engagement.
1393
+ # @return [String]
1394
+ #
973
1395
  # @!attribute [rw] engagement_title
974
1396
  # Provides a short title or description of the Engagement Invitation.
975
1397
  # This title helps partners quickly identify and differentiate between
@@ -994,6 +1416,10 @@ module Aws::PartnerCentralSelling
994
1416
  # and helps in tracking the timeline for engagement.
995
1417
  # @return [Time]
996
1418
  #
1419
+ # @!attribute [rw] participant_type
1420
+ # Identifies the role of the caller in the engagement invitation.
1421
+ # @return [String]
1422
+ #
997
1423
  # @!attribute [rw] payload_type
998
1424
  # Describes the type of payload associated with the Engagement
999
1425
  # Invitation, such as `Opportunity` or `MarketplaceOffer`. This helps
@@ -1029,10 +1455,12 @@ module Aws::PartnerCentralSelling
1029
1455
  class EngagementInvitationSummary < Struct.new(
1030
1456
  :arn,
1031
1457
  :catalog,
1458
+ :engagement_id,
1032
1459
  :engagement_title,
1033
1460
  :expiration_date,
1034
1461
  :id,
1035
1462
  :invitation_date,
1463
+ :participant_type,
1036
1464
  :payload_type,
1037
1465
  :receiver,
1038
1466
  :sender_aws_account_id,
@@ -1042,43 +1470,215 @@ module Aws::PartnerCentralSelling
1042
1470
  include Aws::Structure
1043
1471
  end
1044
1472
 
1045
- # Provides an estimate of the revenue that the partner is expected to
1046
- # generate from the opportunity. This information helps partners assess
1047
- # the financial value of the project.
1473
+ # Engagement members are the participants in an Engagement, which is
1474
+ # likely a collaborative project or business opportunity within the AWS
1475
+ # partner network. Members can be different partner organizations or AWS
1476
+ # accounts that are working together on a specific engagement.
1048
1477
  #
1049
- # @!attribute [rw] amount
1050
- # Represents the estimated monthly revenue that the partner expects to
1051
- # earn from the opportunity. This helps in forecasting financial
1052
- # returns.
1053
- # @return [String]
1478
+ # Each member is represented by their AWS Account ID, Company Name, and
1479
+ # associated details. Members have a status within the Engagement
1480
+ # (PENDING, ACCEPTED, REJECTED, or WITHDRAWN), indicating their current
1481
+ # state of participation. Only existing members of an Engagement can
1482
+ # view the list of other members. This implies a level of privacy and
1483
+ # access control within the Engagement structure.
1054
1484
  #
1055
- # @!attribute [rw] currency_code
1056
- # Indicates the currency in which the revenue estimate is provided.
1057
- # This helps in understanding the financial impact across different
1058
- # markets.
1485
+ # @!attribute [rw] account_id
1486
+ # This is the unique identifier for the AWS account associated with
1487
+ # the member organization. It's used for AWS-related operations and
1488
+ # identity verification.
1059
1489
  # @return [String]
1060
1490
  #
1061
- # @!attribute [rw] frequency
1062
- # Indicates how frequently the customer is expected to spend the
1063
- # projected amount. This can include values such as `Monthly`,
1064
- # `Quarterly`, or `Annually`. The default value is `Monthly`,
1065
- # representing recurring monthly spend.
1491
+ # @!attribute [rw] company_name
1492
+ # The official name of the member's company or organization.
1066
1493
  # @return [String]
1067
1494
  #
1068
- # @!attribute [rw] target_company
1069
- # Specifies the name of the partner company that is expected to
1070
- # generate revenue from the opportunity. This field helps track the
1071
- # partner’s involvement in the opportunity.
1495
+ # @!attribute [rw] website_url
1496
+ # The URL of the member company's website. This offers a way to find
1497
+ # more information about the member organization and serves as an
1498
+ # additional identifier.
1072
1499
  # @return [String]
1073
1500
  #
1074
- # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ExpectedCustomerSpend AWS API Documentation
1501
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/EngagementMember AWS API Documentation
1075
1502
  #
1076
- class ExpectedCustomerSpend < Struct.new(
1077
- :amount,
1078
- :currency_code,
1079
- :frequency,
1080
- :target_company)
1081
- SENSITIVE = [:currency_code]
1503
+ class EngagementMember < Struct.new(
1504
+ :account_id,
1505
+ :company_name,
1506
+ :website_url)
1507
+ SENSITIVE = [:account_id]
1508
+ include Aws::Structure
1509
+ end
1510
+
1511
+ # The EngagementMemberSummary provides a snapshot of essential
1512
+ # information about participants in an AWS Partner Central Engagement.
1513
+ # This compact data structure encapsulates key details of each member,
1514
+ # facilitating efficient collaboration and management within the
1515
+ # Engagement.
1516
+ #
1517
+ # @!attribute [rw] company_name
1518
+ # The official name of the member's company or organization.
1519
+ # @return [String]
1520
+ #
1521
+ # @!attribute [rw] website_url
1522
+ # The URL of the member company's website. This offers a way to find
1523
+ # more information about the member organization and serves as an
1524
+ # additional identifier.
1525
+ # @return [String]
1526
+ #
1527
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/EngagementMemberSummary AWS API Documentation
1528
+ #
1529
+ class EngagementMemberSummary < Struct.new(
1530
+ :company_name,
1531
+ :website_url)
1532
+ SENSITIVE = []
1533
+ include Aws::Structure
1534
+ end
1535
+
1536
+ # This provide a streamlined view of the relationships between
1537
+ # engagements and resources. These summaries offer a crucial link
1538
+ # between collaborative engagements and the specific resources involved,
1539
+ # such as opportunities.These summaries are particularly valuable for
1540
+ # partners navigating complex engagements with multiple resources. They
1541
+ # enable quick insights into resource distribution across engagements,
1542
+ # support efficient resource management, and help maintain a clear
1543
+ # overview of collaborative activities.
1544
+ #
1545
+ # @!attribute [rw] catalog
1546
+ # Indicates the environment in which the resource and engagement
1547
+ # exist.
1548
+ # @return [String]
1549
+ #
1550
+ # @!attribute [rw] created_by
1551
+ # The AWS account ID of the entity that owns the resource. Identifies
1552
+ # the account responsible for or having primary control over the
1553
+ # resource.
1554
+ # @return [String]
1555
+ #
1556
+ # @!attribute [rw] engagement_id
1557
+ # A unique identifier for the engagement associated with the resource.
1558
+ # @return [String]
1559
+ #
1560
+ # @!attribute [rw] resource_id
1561
+ # A unique identifier for the specific resource. Varies depending on
1562
+ # the resource type.
1563
+ # @return [String]
1564
+ #
1565
+ # @!attribute [rw] resource_type
1566
+ # Categorizes the type of resource associated with the engagement.
1567
+ # @return [String]
1568
+ #
1569
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/EngagementResourceAssociationSummary AWS API Documentation
1570
+ #
1571
+ class EngagementResourceAssociationSummary < Struct.new(
1572
+ :catalog,
1573
+ :created_by,
1574
+ :engagement_id,
1575
+ :resource_id,
1576
+ :resource_type)
1577
+ SENSITIVE = [:created_by]
1578
+ include Aws::Structure
1579
+ end
1580
+
1581
+ # Specifies the sorting parameters for listing Engagements.
1582
+ #
1583
+ # @!attribute [rw] sort_by
1584
+ # The field by which to sort the results.
1585
+ # @return [String]
1586
+ #
1587
+ # @!attribute [rw] sort_order
1588
+ # The order in which to sort the results.
1589
+ # @return [String]
1590
+ #
1591
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/EngagementSort AWS API Documentation
1592
+ #
1593
+ class EngagementSort < Struct.new(
1594
+ :sort_by,
1595
+ :sort_order)
1596
+ SENSITIVE = []
1597
+ include Aws::Structure
1598
+ end
1599
+
1600
+ # An object that contains an `Engagement`'s subset of fields.
1601
+ #
1602
+ # @!attribute [rw] arn
1603
+ # The Amazon Resource Name (ARN) of the created Engagement.
1604
+ # @return [String]
1605
+ #
1606
+ # @!attribute [rw] created_at
1607
+ # The date and time when the Engagement was created.
1608
+ # @return [Time]
1609
+ #
1610
+ # @!attribute [rw] created_by
1611
+ # The AWS Account ID of the Engagement creator.
1612
+ # @return [String]
1613
+ #
1614
+ # @!attribute [rw] id
1615
+ # The unique identifier for the Engagement.
1616
+ # @return [String]
1617
+ #
1618
+ # @!attribute [rw] member_count
1619
+ # The number of members in the Engagement.
1620
+ # @return [Integer]
1621
+ #
1622
+ # @!attribute [rw] title
1623
+ # The title of the Engagement.
1624
+ # @return [String]
1625
+ #
1626
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/EngagementSummary AWS API Documentation
1627
+ #
1628
+ class EngagementSummary < Struct.new(
1629
+ :arn,
1630
+ :created_at,
1631
+ :created_by,
1632
+ :id,
1633
+ :member_count,
1634
+ :title)
1635
+ SENSITIVE = [:created_by]
1636
+ include Aws::Structure
1637
+ end
1638
+
1639
+ # Provides an estimate of the revenue that the partner is expected to
1640
+ # generate from the opportunity. This information helps partners assess
1641
+ # the financial value of the project.
1642
+ #
1643
+ # @!attribute [rw] amount
1644
+ # Represents the estimated monthly revenue that the partner expects to
1645
+ # earn from the opportunity. This helps in forecasting financial
1646
+ # returns.
1647
+ # @return [String]
1648
+ #
1649
+ # @!attribute [rw] currency_code
1650
+ # Indicates the currency in which the revenue estimate is provided.
1651
+ # This helps in understanding the financial impact across different
1652
+ # markets.
1653
+ # @return [String]
1654
+ #
1655
+ # @!attribute [rw] estimation_url
1656
+ # A URL providing additional information or context about the spend
1657
+ # estimation.
1658
+ # @return [String]
1659
+ #
1660
+ # @!attribute [rw] frequency
1661
+ # Indicates how frequently the customer is expected to spend the
1662
+ # projected amount. This can include values such as `Monthly`,
1663
+ # `Quarterly`, or `Annually`. The default value is `Monthly`,
1664
+ # representing recurring monthly spend.
1665
+ # @return [String]
1666
+ #
1667
+ # @!attribute [rw] target_company
1668
+ # Specifies the name of the partner company that is expected to
1669
+ # generate revenue from the opportunity. This field helps track the
1670
+ # partner’s involvement in the opportunity.
1671
+ # @return [String]
1672
+ #
1673
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ExpectedCustomerSpend AWS API Documentation
1674
+ #
1675
+ class ExpectedCustomerSpend < Struct.new(
1676
+ :amount,
1677
+ :currency_code,
1678
+ :estimation_url,
1679
+ :frequency,
1680
+ :target_company)
1681
+ SENSITIVE = [:currency_code, :estimation_url]
1082
1682
  include Aws::Structure
1083
1683
  end
1084
1684
 
@@ -1229,11 +1829,31 @@ module Aws::PartnerCentralSelling
1229
1829
  # catalog (e.g., `AWS` or `Sandbox`) used in the request.
1230
1830
  # @return [String]
1231
1831
  #
1832
+ # @!attribute [rw] engagement_description
1833
+ # The description of the engagement associated with this invitation.
1834
+ # @return [String]
1835
+ #
1836
+ # @!attribute [rw] engagement_id
1837
+ # The identifier of the engagement associated with this
1838
+ # invitation.This ID links the invitation to its corresponding
1839
+ # engagement.
1840
+ # @return [String]
1841
+ #
1232
1842
  # @!attribute [rw] engagement_title
1233
1843
  # The title of the engagement invitation, summarizing the purpose or
1234
1844
  # objectives of the opportunity shared by AWS.
1235
1845
  # @return [String]
1236
1846
  #
1847
+ # @!attribute [rw] existing_members
1848
+ # A list of active members currently part of the Engagement. This
1849
+ # array contains a maximum of 10 members, each represented by an
1850
+ # object with the following properties.
1851
+ #
1852
+ # * CompanyName: The name of the member's company.
1853
+ #
1854
+ # * WebsiteUrl: The website URL of the member's company.
1855
+ # @return [Array<Types::EngagementMemberSummary>]
1856
+ #
1237
1857
  # @!attribute [rw] expiration_date
1238
1858
  # Indicates the date on which the engagement invitation will expire if
1239
1859
  # not accepted by the partner.
@@ -1248,6 +1868,11 @@ module Aws::PartnerCentralSelling
1248
1868
  # The date when the engagement invitation was sent to the partner.
1249
1869
  # @return [Time]
1250
1870
  #
1871
+ # @!attribute [rw] invitation_message
1872
+ # The message sent to the invited partner when the invitation was
1873
+ # created.
1874
+ # @return [String]
1875
+ #
1251
1876
  # @!attribute [rw] payload
1252
1877
  # Details of the engagement invitation payload, including specific
1253
1878
  # data relevant to the invitation's contents, such as customer
@@ -1288,10 +1913,14 @@ module Aws::PartnerCentralSelling
1288
1913
  class GetEngagementInvitationResponse < Struct.new(
1289
1914
  :arn,
1290
1915
  :catalog,
1916
+ :engagement_description,
1917
+ :engagement_id,
1291
1918
  :engagement_title,
1919
+ :existing_members,
1292
1920
  :expiration_date,
1293
1921
  :id,
1294
1922
  :invitation_date,
1923
+ :invitation_message,
1295
1924
  :payload,
1296
1925
  :payload_type,
1297
1926
  :receiver,
@@ -1303,6 +1932,82 @@ module Aws::PartnerCentralSelling
1303
1932
  include Aws::Structure
1304
1933
  end
1305
1934
 
1935
+ # @!attribute [rw] catalog
1936
+ # Specifies the catalog related to the engagement request. Valid
1937
+ # values are `AWS` and `Sandbox`.
1938
+ # @return [String]
1939
+ #
1940
+ # @!attribute [rw] identifier
1941
+ # Specifies the identifier of the Engagement record to retrieve.
1942
+ # @return [String]
1943
+ #
1944
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/GetEngagementRequest AWS API Documentation
1945
+ #
1946
+ class GetEngagementRequest < Struct.new(
1947
+ :catalog,
1948
+ :identifier)
1949
+ SENSITIVE = []
1950
+ include Aws::Structure
1951
+ end
1952
+
1953
+ # @!attribute [rw] arn
1954
+ # The Amazon Resource Name (ARN) of the engagement retrieved.
1955
+ # @return [String]
1956
+ #
1957
+ # @!attribute [rw] contexts
1958
+ # A list of context objects associated with the engagement. Each
1959
+ # context provides additional information related to the Engagement,
1960
+ # such as customer projects or documents.
1961
+ # @return [Array<Types::EngagementContextDetails>]
1962
+ #
1963
+ # @!attribute [rw] created_at
1964
+ # The date and time when the Engagement was created, presented in ISO
1965
+ # 8601 format (UTC). For example: "2023-05-01T20:37:46Z". This
1966
+ # timestamp helps track the lifecycle of the Engagement.
1967
+ # @return [Time]
1968
+ #
1969
+ # @!attribute [rw] created_by
1970
+ # The AWS account ID of the user who originally created the
1971
+ # engagement. This field helps in tracking the origin of the
1972
+ # engagement.
1973
+ # @return [String]
1974
+ #
1975
+ # @!attribute [rw] description
1976
+ # A more detailed description of the engagement. This provides
1977
+ # additional context or information about the engagement's purpose or
1978
+ # scope.
1979
+ # @return [String]
1980
+ #
1981
+ # @!attribute [rw] id
1982
+ # The unique resource identifier of the engagement retrieved.
1983
+ # @return [String]
1984
+ #
1985
+ # @!attribute [rw] member_count
1986
+ # Specifies the current count of members participating in the
1987
+ # Engagement. This count includes all active members regardless of
1988
+ # their roles or permissions within the Engagement.
1989
+ # @return [Integer]
1990
+ #
1991
+ # @!attribute [rw] title
1992
+ # The title of the engagement. It provides a brief, descriptive name
1993
+ # for the engagement that is meaningful and easily recognizable.
1994
+ # @return [String]
1995
+ #
1996
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/GetEngagementResponse AWS API Documentation
1997
+ #
1998
+ class GetEngagementResponse < Struct.new(
1999
+ :arn,
2000
+ :contexts,
2001
+ :created_at,
2002
+ :created_by,
2003
+ :description,
2004
+ :id,
2005
+ :member_count,
2006
+ :title)
2007
+ SENSITIVE = [:created_by]
2008
+ include Aws::Structure
2009
+ end
2010
+
1306
2011
  # @!attribute [rw] catalog
1307
2012
  # Specifies the catalog associated with the request. This field takes
1308
2013
  # a string value from a predefined list: `AWS` or `Sandbox`. The
@@ -1325,6 +2030,11 @@ module Aws::PartnerCentralSelling
1325
2030
  include Aws::Structure
1326
2031
  end
1327
2032
 
2033
+ # @!attribute [rw] arn
2034
+ # The Amazon Resource Name (ARN) that uniquely identifies the
2035
+ # opportunity.
2036
+ # @return [String]
2037
+ #
1328
2038
  # @!attribute [rw] catalog
1329
2039
  # Specifies the catalog associated with the request. This field takes
1330
2040
  # a string value from a predefined list: `AWS` or `Sandbox`. The
@@ -1433,13 +2143,6 @@ module Aws::PartnerCentralSelling
1433
2143
  # * Cosell—Support for Public Tender/RFx: Opportunity related to the
1434
2144
  # public sector where the partner needs Amazon Web Services RFx
1435
2145
  # support.
1436
- #
1437
- # * Do Not Need Support from Amazon Web Services Sales Rep: Indicates
1438
- # that a partner doesn't need support from an Amazon Web Services
1439
- # sales representative, and the partner solely manages the
1440
- # opportunity. It's possible to request coselling support on these
1441
- # opportunities at any stage during their lifecycle. Also known as,
1442
- # for-visibility-only (FVO) opportunity.
1443
2146
  # @return [Array<String>]
1444
2147
  #
1445
2148
  # @!attribute [rw] project
@@ -1461,6 +2164,7 @@ module Aws::PartnerCentralSelling
1461
2164
  # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/GetOpportunityResponse AWS API Documentation
1462
2165
  #
1463
2166
  class GetOpportunityResponse < Struct.new(
2167
+ :arn,
1464
2168
  :catalog,
1465
2169
  :created_date,
1466
2170
  :customer,
@@ -1480,6 +2184,274 @@ module Aws::PartnerCentralSelling
1480
2184
  include Aws::Structure
1481
2185
  end
1482
2186
 
2187
+ # @!attribute [rw] catalog
2188
+ # Specifies the catalog related to the request. Valid values are:
2189
+ #
2190
+ # * AWS: Retrieves the snapshot job from the production AWS
2191
+ # environment.
2192
+ #
2193
+ # * Sandbox: Retrieves the snapshot job from a sandbox environment
2194
+ # used for testing or development purposes.
2195
+ # @return [String]
2196
+ #
2197
+ # @!attribute [rw] resource_snapshot_job_identifier
2198
+ # The unique identifier of the resource snapshot job to be retrieved.
2199
+ # This identifier is crucial for pinpointing the specific job you want
2200
+ # to query.
2201
+ # @return [String]
2202
+ #
2203
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/GetResourceSnapshotJobRequest AWS API Documentation
2204
+ #
2205
+ class GetResourceSnapshotJobRequest < Struct.new(
2206
+ :catalog,
2207
+ :resource_snapshot_job_identifier)
2208
+ SENSITIVE = []
2209
+ include Aws::Structure
2210
+ end
2211
+
2212
+ # @!attribute [rw] arn
2213
+ # The Amazon Resource Name (ARN) of the snapshot job. This globally
2214
+ # unique identifier can be used for resource-specific operations
2215
+ # across AWS services.
2216
+ # @return [String]
2217
+ #
2218
+ # @!attribute [rw] catalog
2219
+ # The catalog in which the snapshot job was created. This will match
2220
+ # the Catalog specified in the request.
2221
+ # @return [String]
2222
+ #
2223
+ # @!attribute [rw] created_at
2224
+ # The date and time when the snapshot job was created in ISO 8601
2225
+ # format (UTC). Example: "2023-05-01T20:37:46Z"
2226
+ # @return [Time]
2227
+ #
2228
+ # @!attribute [rw] engagement_id
2229
+ # The identifier of the engagement associated with this snapshot job.
2230
+ # This links the job to a specific engagement context.
2231
+ # @return [String]
2232
+ #
2233
+ # @!attribute [rw] id
2234
+ # The unique identifier of the snapshot job. This matches the
2235
+ # ResourceSnapshotJobIdentifier provided in the request.
2236
+ # @return [String]
2237
+ #
2238
+ # @!attribute [rw] last_failure
2239
+ # If the job has encountered any failures, this field contains the
2240
+ # error message from the most recent failure. This can be useful for
2241
+ # troubleshooting issues with the job.
2242
+ # @return [String]
2243
+ #
2244
+ # @!attribute [rw] last_successful_execution_date
2245
+ # The date and time of the last successful execution of the job, in
2246
+ # ISO 8601 format (UTC). Example: "2023-05-01T20:37:46Z"
2247
+ # @return [Time]
2248
+ #
2249
+ # @!attribute [rw] resource_arn
2250
+ # The Amazon Resource Name (ARN) of the resource being snapshotted.
2251
+ # This provides a globally unique identifier for the resource across
2252
+ # AWS.
2253
+ # @return [String]
2254
+ #
2255
+ # @!attribute [rw] resource_id
2256
+ # The identifier of the specific resource being snapshotted. The
2257
+ # format might vary depending on the ResourceType.
2258
+ # @return [String]
2259
+ #
2260
+ # @!attribute [rw] resource_snapshot_template_name
2261
+ # The name of the template used for creating the snapshot. This is the
2262
+ # same as the template name. It defines the structure and content of
2263
+ # the snapshot.
2264
+ # @return [String]
2265
+ #
2266
+ # @!attribute [rw] resource_type
2267
+ # The type of resource being snapshotted. This would have
2268
+ # "Opportunity" as a value as it is dependent on the supported
2269
+ # resource type.
2270
+ # @return [String]
2271
+ #
2272
+ # @!attribute [rw] status
2273
+ # The current status of the snapshot job. Valid values:
2274
+ #
2275
+ # * STOPPED: The job is not currently running.
2276
+ #
2277
+ # * RUNNING: The job is actively executing.
2278
+ # @return [String]
2279
+ #
2280
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/GetResourceSnapshotJobResponse AWS API Documentation
2281
+ #
2282
+ class GetResourceSnapshotJobResponse < Struct.new(
2283
+ :arn,
2284
+ :catalog,
2285
+ :created_at,
2286
+ :engagement_id,
2287
+ :id,
2288
+ :last_failure,
2289
+ :last_successful_execution_date,
2290
+ :resource_arn,
2291
+ :resource_id,
2292
+ :resource_snapshot_template_name,
2293
+ :resource_type,
2294
+ :status)
2295
+ SENSITIVE = []
2296
+ include Aws::Structure
2297
+ end
2298
+
2299
+ # @!attribute [rw] catalog
2300
+ # Specifies the catalog related to the request. Valid values are:
2301
+ #
2302
+ # * AWS: Retrieves the snapshot from the production AWS environment.
2303
+ #
2304
+ # * Sandbox: Retrieves the snapshot from a sandbox environment used
2305
+ # for testing or development purposes.
2306
+ # @return [String]
2307
+ #
2308
+ # @!attribute [rw] engagement_identifier
2309
+ # The unique identifier of the engagement associated with the
2310
+ # snapshot. This field links the snapshot to a specific engagement
2311
+ # context.
2312
+ # @return [String]
2313
+ #
2314
+ # @!attribute [rw] resource_identifier
2315
+ # The unique identifier of the specific resource that was snapshotted.
2316
+ # The format and constraints of this identifier depend on the
2317
+ # ResourceType specified. For `Opportunity` type, it will be an
2318
+ # `opportunity ID`
2319
+ # @return [String]
2320
+ #
2321
+ # @!attribute [rw] resource_snapshot_template_identifier
2322
+ # he name of the template that defines the schema for the snapshot.
2323
+ # This template determines which subset of the resource data is
2324
+ # included in the snapshot and must correspond to an existing and
2325
+ # valid template for the specified `ResourceType`.
2326
+ # @return [String]
2327
+ #
2328
+ # @!attribute [rw] resource_type
2329
+ # Specifies the type of resource that was snapshotted. This field
2330
+ # determines the structure and content of the snapshot payload. Valid
2331
+ # value includes:`Opportunity`: For opportunity-related data.
2332
+ # @return [String]
2333
+ #
2334
+ # @!attribute [rw] revision
2335
+ # Specifies which revision of the snapshot to retrieve. If omitted
2336
+ # returns the latest revision.
2337
+ # @return [Integer]
2338
+ #
2339
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/GetResourceSnapshotRequest AWS API Documentation
2340
+ #
2341
+ class GetResourceSnapshotRequest < Struct.new(
2342
+ :catalog,
2343
+ :engagement_identifier,
2344
+ :resource_identifier,
2345
+ :resource_snapshot_template_identifier,
2346
+ :resource_type,
2347
+ :revision)
2348
+ SENSITIVE = []
2349
+ include Aws::Structure
2350
+ end
2351
+
2352
+ # @!attribute [rw] arn
2353
+ # The Amazon Resource Name (ARN) that uniquely identifies the resource
2354
+ # snapshot.
2355
+ # @return [String]
2356
+ #
2357
+ # @!attribute [rw] catalog
2358
+ # The catalog in which the snapshot was created. Matches the Catalog
2359
+ # specified in the request.
2360
+ # @return [String]
2361
+ #
2362
+ # @!attribute [rw] created_at
2363
+ # The timestamp when the snapshot was created, in ISO 8601 format
2364
+ # (e.g., "2023-06-01T14:30:00Z"). This allows for precise tracking
2365
+ # of when the snapshot was taken.
2366
+ # @return [Time]
2367
+ #
2368
+ # @!attribute [rw] created_by
2369
+ # The AWS account ID of the principal (user or role) who created the
2370
+ # snapshot. This helps in tracking the origin of the snapshot.
2371
+ # @return [String]
2372
+ #
2373
+ # @!attribute [rw] engagement_id
2374
+ # The identifier of the engagement associated with this snapshot.
2375
+ # Matches the EngagementIdentifier specified in the request.
2376
+ # @return [String]
2377
+ #
2378
+ # @!attribute [rw] payload
2379
+ # Represents the payload of a resource snapshot. This structure is
2380
+ # designed to accommodate different types of resource snapshots,
2381
+ # currently supporting opportunity summaries.
2382
+ # @return [Types::ResourceSnapshotPayload]
2383
+ #
2384
+ # @!attribute [rw] resource_id
2385
+ # The identifier of the specific resource that was snapshotted.
2386
+ # Matches the ResourceIdentifier specified in the request.
2387
+ # @return [String]
2388
+ #
2389
+ # @!attribute [rw] resource_snapshot_template_name
2390
+ # The name of the view used for this snapshot. This is the same as the
2391
+ # template name.
2392
+ # @return [String]
2393
+ #
2394
+ # @!attribute [rw] resource_type
2395
+ # The type of the resource that was snapshotted. Matches the
2396
+ # ResourceType specified in the request.
2397
+ # @return [String]
2398
+ #
2399
+ # @!attribute [rw] revision
2400
+ # The revision number of this snapshot. This is a positive integer
2401
+ # that is sequential and unique within the context of a resource view.
2402
+ # @return [Integer]
2403
+ #
2404
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/GetResourceSnapshotResponse AWS API Documentation
2405
+ #
2406
+ class GetResourceSnapshotResponse < Struct.new(
2407
+ :arn,
2408
+ :catalog,
2409
+ :created_at,
2410
+ :created_by,
2411
+ :engagement_id,
2412
+ :payload,
2413
+ :resource_id,
2414
+ :resource_snapshot_template_name,
2415
+ :resource_type,
2416
+ :revision)
2417
+ SENSITIVE = [:created_by]
2418
+ include Aws::Structure
2419
+ end
2420
+
2421
+ # @!attribute [rw] catalog
2422
+ # Specifies the catalog in which the settings are defined. Acceptable
2423
+ # values include `AWS` for production and `Sandbox` for testing
2424
+ # environments.
2425
+ # @return [String]
2426
+ #
2427
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/GetSellingSystemSettingsRequest AWS API Documentation
2428
+ #
2429
+ class GetSellingSystemSettingsRequest < Struct.new(
2430
+ :catalog)
2431
+ SENSITIVE = []
2432
+ include Aws::Structure
2433
+ end
2434
+
2435
+ # @!attribute [rw] catalog
2436
+ # Specifies the catalog in which the settings are defined. Acceptable
2437
+ # values include `AWS` for production and `Sandbox` for testing
2438
+ # environments.
2439
+ # @return [String]
2440
+ #
2441
+ # @!attribute [rw] resource_snapshot_job_role_arn
2442
+ # Specifies the ARN of the IAM Role used for resource snapshot job
2443
+ # executions.
2444
+ # @return [String]
2445
+ #
2446
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/GetSellingSystemSettingsResponse AWS API Documentation
2447
+ #
2448
+ class GetSellingSystemSettingsResponse < Struct.new(
2449
+ :catalog,
2450
+ :resource_snapshot_job_role_arn)
2451
+ SENSITIVE = []
2452
+ include Aws::Structure
2453
+ end
2454
+
1483
2455
  # This error occurs when the specified resource can’t be found or
1484
2456
  # doesn't exist. Resource ID and type might be incorrect.
1485
2457
  #
@@ -1498,6 +2470,37 @@ module Aws::PartnerCentralSelling
1498
2470
  include Aws::Structure
1499
2471
  end
1500
2472
 
2473
+ # The Invitation structure represents an invitation exchanged between
2474
+ # partners and AWS. It includes a message, receiver information, and a
2475
+ # payload providing context for the invitation.
2476
+ #
2477
+ # @!attribute [rw] message
2478
+ # A message accompanying the invitation.
2479
+ # @return [String]
2480
+ #
2481
+ # @!attribute [rw] payload
2482
+ # Contains the data payload associated with the Engagement Invitation.
2483
+ # This payload includes essential details related to the AWS
2484
+ # opportunity and is used by partners to evaluate whether to accept or
2485
+ # reject the engagement.
2486
+ # @return [Types::Payload]
2487
+ #
2488
+ # @!attribute [rw] receiver
2489
+ # Represents the entity that received the Engagement Invitation,
2490
+ # including account and company details. This field is essential for
2491
+ # tracking the partner who is being invited to collaborate.
2492
+ # @return [Types::Receiver]
2493
+ #
2494
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/Invitation AWS API Documentation
2495
+ #
2496
+ class Invitation < Struct.new(
2497
+ :message,
2498
+ :payload,
2499
+ :receiver)
2500
+ SENSITIVE = []
2501
+ include Aws::Structure
2502
+ end
2503
+
1501
2504
  # Defines a filter to retrieve opportunities based on the last modified
1502
2505
  # date. This filter is useful for tracking changes or updates to
1503
2506
  # opportunities over time.
@@ -1723,6 +2726,40 @@ module Aws::PartnerCentralSelling
1723
2726
  include Aws::Structure
1724
2727
  end
1725
2728
 
2729
+ # Provides the lifecycle view of an opportunity resource shared through
2730
+ # a snapshot.
2731
+ #
2732
+ # @!attribute [rw] next_steps
2733
+ # Describes the next steps for the opportunity shared through a
2734
+ # snapshot.
2735
+ # @return [String]
2736
+ #
2737
+ # @!attribute [rw] review_status
2738
+ # Defines the approval status of the opportunity shared through a
2739
+ # snapshot.
2740
+ # @return [String]
2741
+ #
2742
+ # @!attribute [rw] stage
2743
+ # Defines the current stage of the opportunity shared through a
2744
+ # snapshot.
2745
+ # @return [String]
2746
+ #
2747
+ # @!attribute [rw] target_close_date
2748
+ # The projected launch date of the opportunity shared through a
2749
+ # snapshot.
2750
+ # @return [String]
2751
+ #
2752
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/LifeCycleForView AWS API Documentation
2753
+ #
2754
+ class LifeCycleForView < Struct.new(
2755
+ :next_steps,
2756
+ :review_status,
2757
+ :stage,
2758
+ :target_close_date)
2759
+ SENSITIVE = [:next_steps]
2760
+ include Aws::Structure
2761
+ end
2762
+
1726
2763
  # An object that contains a `LifeCycle` object's subset of fields.
1727
2764
  #
1728
2765
  # @!attribute [rw] closed_lost_reason
@@ -1865,12 +2902,320 @@ module Aws::PartnerCentralSelling
1865
2902
  include Aws::Structure
1866
2903
  end
1867
2904
 
2905
+ # Specifies a subset of fields associated with tasks related to
2906
+ # accepting an engagement invitation.
2907
+ #
2908
+ # @!attribute [rw] engagement_invitation_id
2909
+ # The unique identifier of the engagement invitation that was
2910
+ # accepted.
2911
+ # @return [String]
2912
+ #
2913
+ # @!attribute [rw] message
2914
+ # Detailed message describing the failure and possible recovery steps.
2915
+ # @return [String]
2916
+ #
2917
+ # @!attribute [rw] opportunity_id
2918
+ # Unique identifier of opportunity that was created.
2919
+ # @return [String]
2920
+ #
2921
+ # @!attribute [rw] reason_code
2922
+ # A code pointing to the specific reason for the failure.
2923
+ # @return [String]
2924
+ #
2925
+ # @!attribute [rw] resource_snapshot_job_id
2926
+ # Unique identifier of the resource snapshot job that was created.
2927
+ # @return [String]
2928
+ #
2929
+ # @!attribute [rw] start_time
2930
+ # Task start timestamp.
2931
+ # @return [Time]
2932
+ #
2933
+ # @!attribute [rw] task_arn
2934
+ # The Amazon Resource Name (ARN) that uniquely identifies the task.
2935
+ # @return [String]
2936
+ #
2937
+ # @!attribute [rw] task_id
2938
+ # Unique identifier of the task.
2939
+ # @return [String]
2940
+ #
2941
+ # @!attribute [rw] task_status
2942
+ # Status of the task.
2943
+ # @return [String]
2944
+ #
2945
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListEngagementByAcceptingInvitationTaskSummary AWS API Documentation
2946
+ #
2947
+ class ListEngagementByAcceptingInvitationTaskSummary < Struct.new(
2948
+ :engagement_invitation_id,
2949
+ :message,
2950
+ :opportunity_id,
2951
+ :reason_code,
2952
+ :resource_snapshot_job_id,
2953
+ :start_time,
2954
+ :task_arn,
2955
+ :task_id,
2956
+ :task_status)
2957
+ SENSITIVE = []
2958
+ include Aws::Structure
2959
+ end
2960
+
2961
+ # @!attribute [rw] catalog
2962
+ # Specifies the catalog related to the request. Valid values are:
2963
+ #
2964
+ # * AWS: Retrieves the request from the production AWS environment.
2965
+ #
2966
+ # * Sandbox: Retrieves the request from a sandbox environment used for
2967
+ # testing or development purposes.
2968
+ # @return [String]
2969
+ #
2970
+ # @!attribute [rw] engagement_invitation_identifier
2971
+ # Filters tasks by the identifiers of the engagement invitations they
2972
+ # are processing.
2973
+ # @return [Array<String>]
2974
+ #
2975
+ # @!attribute [rw] max_results
2976
+ # Use this parameter to control the number of items returned in each
2977
+ # request, which can be useful for performance tuning and managing
2978
+ # large result sets.
2979
+ # @return [Integer]
2980
+ #
2981
+ # @!attribute [rw] next_token
2982
+ # Use this parameter for pagination when the result set spans multiple
2983
+ # pages. This value is obtained from the NextToken field in the
2984
+ # response of a previous call to this API.
2985
+ # @return [String]
2986
+ #
2987
+ # @!attribute [rw] opportunity_identifier
2988
+ # Filters tasks by the identifiers of the opportunities they created
2989
+ # or are associated with.
2990
+ # @return [Array<String>]
2991
+ #
2992
+ # @!attribute [rw] sort
2993
+ # Specifies the sorting criteria for the returned results. This allows
2994
+ # you to order the tasks based on specific attributes.
2995
+ # @return [Types::ListTasksSortBase]
2996
+ #
2997
+ # @!attribute [rw] task_identifier
2998
+ # Filters tasks by their unique identifiers. Use this when you want to
2999
+ # retrieve information about specific tasks.
3000
+ # @return [Array<String>]
3001
+ #
3002
+ # @!attribute [rw] task_status
3003
+ # Filters the tasks based on their current status. This allows you to
3004
+ # focus on tasks in specific states.
3005
+ # @return [Array<String>]
3006
+ #
3007
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListEngagementByAcceptingInvitationTasksRequest AWS API Documentation
3008
+ #
3009
+ class ListEngagementByAcceptingInvitationTasksRequest < Struct.new(
3010
+ :catalog,
3011
+ :engagement_invitation_identifier,
3012
+ :max_results,
3013
+ :next_token,
3014
+ :opportunity_identifier,
3015
+ :sort,
3016
+ :task_identifier,
3017
+ :task_status)
3018
+ SENSITIVE = []
3019
+ include Aws::Structure
3020
+ end
3021
+
3022
+ # @!attribute [rw] next_token
3023
+ # A token used for pagination to retrieve the next page of results.If
3024
+ # there are more results available, this field will contain a token
3025
+ # that can be used in a subsequent API call to retrieve the next page.
3026
+ # If there are no more results, this field will be null or an empty
3027
+ # string.
3028
+ # @return [String]
3029
+ #
3030
+ # @!attribute [rw] task_summaries
3031
+ # An array of `EngagementByAcceptingInvitationTaskSummary` objects,
3032
+ # each representing a task that matches the specified filters. The
3033
+ # array may be empty if no tasks match the criteria.
3034
+ # @return [Array<Types::ListEngagementByAcceptingInvitationTaskSummary>]
3035
+ #
3036
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListEngagementByAcceptingInvitationTasksResponse AWS API Documentation
3037
+ #
3038
+ class ListEngagementByAcceptingInvitationTasksResponse < Struct.new(
3039
+ :next_token,
3040
+ :task_summaries)
3041
+ SENSITIVE = []
3042
+ include Aws::Structure
3043
+ end
3044
+
3045
+ # Provides a summary of a task related to creating an engagement from an
3046
+ # opportunity. This structure contains key information about the task's
3047
+ # status, associated identifiers, and any failure details.
3048
+ #
3049
+ # @!attribute [rw] engagement_id
3050
+ # The unique identifier of the engagement created as a result of the
3051
+ # task. This field is populated when the task is completed
3052
+ # successfully.
3053
+ # @return [String]
3054
+ #
3055
+ # @!attribute [rw] engagement_invitation_id
3056
+ # The unique identifier of the Engagement Invitation.
3057
+ # @return [String]
3058
+ #
3059
+ # @!attribute [rw] message
3060
+ # A detailed message providing additional information about the task,
3061
+ # especially useful in case of failures. This field may contain error
3062
+ # details or other relevant information about the task's execution
3063
+ # @return [String]
3064
+ #
3065
+ # @!attribute [rw] opportunity_id
3066
+ # The unique identifier of the original Opportunity from which the
3067
+ # Engagement is being created. This field helps track the source of
3068
+ # the Engagement creation task.
3069
+ # @return [String]
3070
+ #
3071
+ # @!attribute [rw] reason_code
3072
+ # A code indicating the specific reason for a task failure. This field
3073
+ # is populated when the task status is FAILED and provides a
3074
+ # categorized reason for the failure.
3075
+ # @return [String]
3076
+ #
3077
+ # @!attribute [rw] resource_snapshot_job_id
3078
+ # The identifier of the resource snapshot job associated with this
3079
+ # task, if a snapshot was created as part of the Engagement creation
3080
+ # process.
3081
+ # @return [String]
3082
+ #
3083
+ # @!attribute [rw] start_time
3084
+ # The timestamp indicating when the task was initiated, in RFC 3339
3085
+ # 5.6 date-time format.
3086
+ # @return [Time]
3087
+ #
3088
+ # @!attribute [rw] task_arn
3089
+ # The Amazon Resource Name (ARN) uniquely identifying this task within
3090
+ # AWS. This ARN can be used for referencing the task in other AWS
3091
+ # services or APIs.
3092
+ # @return [String]
3093
+ #
3094
+ # @!attribute [rw] task_id
3095
+ # A unique identifier for a specific task.
3096
+ # @return [String]
3097
+ #
3098
+ # @!attribute [rw] task_status
3099
+ # The current status of the task.
3100
+ # @return [String]
3101
+ #
3102
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListEngagementFromOpportunityTaskSummary AWS API Documentation
3103
+ #
3104
+ class ListEngagementFromOpportunityTaskSummary < Struct.new(
3105
+ :engagement_id,
3106
+ :engagement_invitation_id,
3107
+ :message,
3108
+ :opportunity_id,
3109
+ :reason_code,
3110
+ :resource_snapshot_job_id,
3111
+ :start_time,
3112
+ :task_arn,
3113
+ :task_id,
3114
+ :task_status)
3115
+ SENSITIVE = []
3116
+ include Aws::Structure
3117
+ end
3118
+
3119
+ # @!attribute [rw] catalog
3120
+ # Specifies the catalog related to the request. Valid values are:
3121
+ #
3122
+ # * AWS: Retrieves the request from the production AWS environment.
3123
+ #
3124
+ # * Sandbox: Retrieves the request from a sandbox environment used for
3125
+ # testing or development purposes.
3126
+ # @return [String]
3127
+ #
3128
+ # @!attribute [rw] engagement_identifier
3129
+ # Filters tasks by the identifiers of the engagements they created or
3130
+ # are associated with.
3131
+ # @return [Array<String>]
3132
+ #
3133
+ # @!attribute [rw] max_results
3134
+ # Specifies the maximum number of results to return in a single page
3135
+ # of the response.Use this parameter to control the number of items
3136
+ # returned in each request, which can be useful for performance tuning
3137
+ # and managing large result sets.
3138
+ # @return [Integer]
3139
+ #
3140
+ # @!attribute [rw] next_token
3141
+ # The token for requesting the next page of results. This value is
3142
+ # obtained from the NextToken field in the response of a previous call
3143
+ # to this API. Use this parameter for pagination when the result set
3144
+ # spans multiple pages.
3145
+ # @return [String]
3146
+ #
3147
+ # @!attribute [rw] opportunity_identifier
3148
+ # The identifier of the original opportunity associated with this
3149
+ # task.
3150
+ # @return [Array<String>]
3151
+ #
3152
+ # @!attribute [rw] sort
3153
+ # Specifies the sorting criteria for the returned results. This allows
3154
+ # you to order the tasks based on specific attributes.
3155
+ # @return [Types::ListTasksSortBase]
3156
+ #
3157
+ # @!attribute [rw] task_identifier
3158
+ # Filters tasks by their unique identifiers. Use this when you want to
3159
+ # retrieve information about specific tasks.
3160
+ # @return [Array<String>]
3161
+ #
3162
+ # @!attribute [rw] task_status
3163
+ # Filters the tasks based on their current status. This allows you to
3164
+ # focus on tasks in specific states.
3165
+ # @return [Array<String>]
3166
+ #
3167
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListEngagementFromOpportunityTasksRequest AWS API Documentation
3168
+ #
3169
+ class ListEngagementFromOpportunityTasksRequest < Struct.new(
3170
+ :catalog,
3171
+ :engagement_identifier,
3172
+ :max_results,
3173
+ :next_token,
3174
+ :opportunity_identifier,
3175
+ :sort,
3176
+ :task_identifier,
3177
+ :task_status)
3178
+ SENSITIVE = []
3179
+ include Aws::Structure
3180
+ end
3181
+
3182
+ # @!attribute [rw] next_token
3183
+ # A token used for pagination to retrieve the next page of results. If
3184
+ # there are more results available, this field will contain a token
3185
+ # that can be used in a subsequent API call to retrieve the next page.
3186
+ # If there are no more results, this field will be null or an empty
3187
+ # string.
3188
+ # @return [String]
3189
+ #
3190
+ # @!attribute [rw] task_summaries
3191
+ # TaskSummaries An array of TaskSummary objects containing details
3192
+ # about each task.
3193
+ # @return [Array<Types::ListEngagementFromOpportunityTaskSummary>]
3194
+ #
3195
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListEngagementFromOpportunityTasksResponse AWS API Documentation
3196
+ #
3197
+ class ListEngagementFromOpportunityTasksResponse < Struct.new(
3198
+ :next_token,
3199
+ :task_summaries)
3200
+ SENSITIVE = []
3201
+ include Aws::Structure
3202
+ end
3203
+
1868
3204
  # @!attribute [rw] catalog
1869
3205
  # Specifies the catalog from which to list the engagement invitations.
1870
3206
  # Use `AWS` for production invitations or `Sandbox` for testing
1871
3207
  # environments.
1872
3208
  # @return [String]
1873
3209
  #
3210
+ # @!attribute [rw] engagement_identifier
3211
+ # Retrieves a list of engagement invitation summaries based on
3212
+ # specified filters. The ListEngagementInvitations operation allows
3213
+ # you to view all invitations that you have sent or received. You must
3214
+ # specify the ParticipantType to filter invitations where you are
3215
+ # either the SENDER or the RECEIVER. Invitations will automatically
3216
+ # expire if not accepted within 15 days.
3217
+ # @return [Array<String>]
3218
+ #
1874
3219
  # @!attribute [rw] max_results
1875
3220
  # Specifies the maximum number of engagement invitations to return in
1876
3221
  # the response. If more results are available, a pagination token will
@@ -1894,22 +3239,33 @@ module Aws::PartnerCentralSelling
1894
3239
  # on acceptance or rejection of the invitation.
1895
3240
  # @return [Array<String>]
1896
3241
  #
3242
+ # @!attribute [rw] sender_aws_account_id
3243
+ # List of sender AWS account IDs to filter the invitations.
3244
+ # @return [Array<String>]
3245
+ #
1897
3246
  # @!attribute [rw] sort
1898
3247
  # Specifies the sorting options for listing engagement invitations.
1899
3248
  # Invitations can be sorted by fields such as `InvitationDate` or
1900
3249
  # `Status` to help partners view results in their preferred order.
1901
3250
  # @return [Types::OpportunityEngagementInvitationSort]
1902
3251
  #
3252
+ # @!attribute [rw] status
3253
+ # Status values to filter the invitations.
3254
+ # @return [Array<String>]
3255
+ #
1903
3256
  # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListEngagementInvitationsRequest AWS API Documentation
1904
3257
  #
1905
3258
  class ListEngagementInvitationsRequest < Struct.new(
1906
3259
  :catalog,
3260
+ :engagement_identifier,
1907
3261
  :max_results,
1908
3262
  :next_token,
1909
3263
  :participant_type,
1910
3264
  :payload_type,
1911
- :sort)
1912
- SENSITIVE = []
3265
+ :sender_aws_account_id,
3266
+ :sort,
3267
+ :status)
3268
+ SENSITIVE = [:sender_aws_account_id]
1913
3269
  include Aws::Structure
1914
3270
  end
1915
3271
 
@@ -1934,6 +3290,194 @@ module Aws::PartnerCentralSelling
1934
3290
  include Aws::Structure
1935
3291
  end
1936
3292
 
3293
+ # @!attribute [rw] catalog
3294
+ # The catalog related to the request.
3295
+ # @return [String]
3296
+ #
3297
+ # @!attribute [rw] identifier
3298
+ # Identifier of the Engagement record to retrieve members from.
3299
+ # @return [String]
3300
+ #
3301
+ # @!attribute [rw] max_results
3302
+ # The maximum number of results to return in a single call.
3303
+ # @return [Integer]
3304
+ #
3305
+ # @!attribute [rw] next_token
3306
+ # The token for the next set of results.
3307
+ # @return [String]
3308
+ #
3309
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListEngagementMembersRequest AWS API Documentation
3310
+ #
3311
+ class ListEngagementMembersRequest < Struct.new(
3312
+ :catalog,
3313
+ :identifier,
3314
+ :max_results,
3315
+ :next_token)
3316
+ SENSITIVE = []
3317
+ include Aws::Structure
3318
+ end
3319
+
3320
+ # @!attribute [rw] engagement_member_list
3321
+ # Provides a list of engagement members.
3322
+ # @return [Array<Types::EngagementMember>]
3323
+ #
3324
+ # @!attribute [rw] next_token
3325
+ # A pagination token used to retrieve the next set of results. If
3326
+ # there are more results available than can be returned in a single
3327
+ # response, this token will be present. Use this token in a subsequent
3328
+ # request to retrieve the next page of results. If there are no more
3329
+ # results, this value will be null.
3330
+ # @return [String]
3331
+ #
3332
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListEngagementMembersResponse AWS API Documentation
3333
+ #
3334
+ class ListEngagementMembersResponse < Struct.new(
3335
+ :engagement_member_list,
3336
+ :next_token)
3337
+ SENSITIVE = []
3338
+ include Aws::Structure
3339
+ end
3340
+
3341
+ # @!attribute [rw] catalog
3342
+ # Specifies the catalog in which to search for engagement-resource
3343
+ # associations. Valid Values: "AWS" or "Sandbox"
3344
+ #
3345
+ # * `AWS` for production environments.
3346
+ #
3347
+ # * `Sandbox` for testing and development purposes.
3348
+ # @return [String]
3349
+ #
3350
+ # @!attribute [rw] created_by
3351
+ # Filters the response to include only snapshots of resources owned by
3352
+ # the specified AWS account ID. Use this when you want to find
3353
+ # associations related to resources owned by a particular account.
3354
+ # @return [String]
3355
+ #
3356
+ # @!attribute [rw] engagement_identifier
3357
+ # Filters the results to include only associations related to the
3358
+ # specified engagement. Use this when you want to find all resources
3359
+ # associated with a specific engagement.
3360
+ # @return [String]
3361
+ #
3362
+ # @!attribute [rw] max_results
3363
+ # Limits the number of results returned in a single call. Use this to
3364
+ # control the number of results returned, especially useful for
3365
+ # pagination.
3366
+ # @return [Integer]
3367
+ #
3368
+ # @!attribute [rw] next_token
3369
+ # A token used for pagination of results. Include this token in
3370
+ # subsequent requests to retrieve the next set of results.
3371
+ # @return [String]
3372
+ #
3373
+ # @!attribute [rw] resource_identifier
3374
+ # Filters the results to include only associations with the specified
3375
+ # resource. Varies depending on the resource type. Use this when you
3376
+ # want to find all engagements associated with a specific resource.
3377
+ # @return [String]
3378
+ #
3379
+ # @!attribute [rw] resource_type
3380
+ # Filters the results to include only associations with resources of
3381
+ # the specified type.
3382
+ # @return [String]
3383
+ #
3384
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListEngagementResourceAssociationsRequest AWS API Documentation
3385
+ #
3386
+ class ListEngagementResourceAssociationsRequest < Struct.new(
3387
+ :catalog,
3388
+ :created_by,
3389
+ :engagement_identifier,
3390
+ :max_results,
3391
+ :next_token,
3392
+ :resource_identifier,
3393
+ :resource_type)
3394
+ SENSITIVE = [:created_by]
3395
+ include Aws::Structure
3396
+ end
3397
+
3398
+ # @!attribute [rw] engagement_resource_association_summaries
3399
+ # A list of engagement-resource association summaries.
3400
+ # @return [Array<Types::EngagementResourceAssociationSummary>]
3401
+ #
3402
+ # @!attribute [rw] next_token
3403
+ # A token to retrieve the next set of results. Use this token in a
3404
+ # subsequent request to retrieve additional results if the response
3405
+ # was truncated.
3406
+ # @return [String]
3407
+ #
3408
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListEngagementResourceAssociationsResponse AWS API Documentation
3409
+ #
3410
+ class ListEngagementResourceAssociationsResponse < Struct.new(
3411
+ :engagement_resource_association_summaries,
3412
+ :next_token)
3413
+ SENSITIVE = []
3414
+ include Aws::Structure
3415
+ end
3416
+
3417
+ # @!attribute [rw] catalog
3418
+ # Specifies the catalog related to the request.
3419
+ # @return [String]
3420
+ #
3421
+ # @!attribute [rw] created_by
3422
+ # A list of AWS account IDs. When specified, the response includes
3423
+ # engagements created by these accounts. This filter is useful for
3424
+ # finding engagements created by specific team members.
3425
+ # @return [Array<String>]
3426
+ #
3427
+ # @!attribute [rw] engagement_identifier
3428
+ # An array of strings representing engagement identifiers to retrieve.
3429
+ # @return [Array<String>]
3430
+ #
3431
+ # @!attribute [rw] exclude_created_by
3432
+ # An array of strings representing AWS Account IDs. Use this to
3433
+ # exclude engagements created by specific users.
3434
+ # @return [Array<String>]
3435
+ #
3436
+ # @!attribute [rw] max_results
3437
+ # The maximum number of results to return in a single call.
3438
+ # @return [Integer]
3439
+ #
3440
+ # @!attribute [rw] next_token
3441
+ # The token for the next set of results. This value is returned from a
3442
+ # previous call.
3443
+ # @return [String]
3444
+ #
3445
+ # @!attribute [rw] sort
3446
+ # An object that specifies the sort order of the results.
3447
+ # @return [Types::EngagementSort]
3448
+ #
3449
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListEngagementsRequest AWS API Documentation
3450
+ #
3451
+ class ListEngagementsRequest < Struct.new(
3452
+ :catalog,
3453
+ :created_by,
3454
+ :engagement_identifier,
3455
+ :exclude_created_by,
3456
+ :max_results,
3457
+ :next_token,
3458
+ :sort)
3459
+ SENSITIVE = [:created_by, :exclude_created_by]
3460
+ include Aws::Structure
3461
+ end
3462
+
3463
+ # @!attribute [rw] engagement_summary_list
3464
+ # An array of engagement summary objects.
3465
+ # @return [Array<Types::EngagementSummary>]
3466
+ #
3467
+ # @!attribute [rw] next_token
3468
+ # The token to retrieve the next set of results. This field will be
3469
+ # null if there are no more results.
3470
+ # @return [String]
3471
+ #
3472
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListEngagementsResponse AWS API Documentation
3473
+ #
3474
+ class ListEngagementsResponse < Struct.new(
3475
+ :engagement_summary_list,
3476
+ :next_token)
3477
+ SENSITIVE = []
3478
+ include Aws::Structure
3479
+ end
3480
+
1937
3481
  # @!attribute [rw] catalog
1938
3482
  # Specifies the catalog associated with the request. This field takes
1939
3483
  # a string value from a predefined list: `AWS` or `Sandbox`. The
@@ -2032,6 +3576,133 @@ module Aws::PartnerCentralSelling
2032
3576
  include Aws::Structure
2033
3577
  end
2034
3578
 
3579
+ # @!attribute [rw] catalog
3580
+ # Specifies the catalog related to the request.
3581
+ # @return [String]
3582
+ #
3583
+ # @!attribute [rw] engagement_identifier
3584
+ # The identifier of the engagement to filter the response.
3585
+ # @return [String]
3586
+ #
3587
+ # @!attribute [rw] max_results
3588
+ # The maximum number of results to return in a single call. If
3589
+ # omitted, defaults to 50.
3590
+ # @return [Integer]
3591
+ #
3592
+ # @!attribute [rw] next_token
3593
+ # The token for the next set of results.
3594
+ # @return [String]
3595
+ #
3596
+ # @!attribute [rw] sort
3597
+ # Configures the sorting of the response. If omitted, results are
3598
+ # sorted by `CreatedDate` in descending order.
3599
+ # @return [Types::SortObject]
3600
+ #
3601
+ # @!attribute [rw] status
3602
+ # The status of the jobs to filter the response.
3603
+ # @return [String]
3604
+ #
3605
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListResourceSnapshotJobsRequest AWS API Documentation
3606
+ #
3607
+ class ListResourceSnapshotJobsRequest < Struct.new(
3608
+ :catalog,
3609
+ :engagement_identifier,
3610
+ :max_results,
3611
+ :next_token,
3612
+ :sort,
3613
+ :status)
3614
+ SENSITIVE = []
3615
+ include Aws::Structure
3616
+ end
3617
+
3618
+ # @!attribute [rw] next_token
3619
+ # The token to retrieve the next set of results. If there are no
3620
+ # additional results, this value is null.
3621
+ # @return [String]
3622
+ #
3623
+ # @!attribute [rw] resource_snapshot_job_summaries
3624
+ # An array of resource snapshot job summary objects.
3625
+ # @return [Array<Types::ResourceSnapshotJobSummary>]
3626
+ #
3627
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListResourceSnapshotJobsResponse AWS API Documentation
3628
+ #
3629
+ class ListResourceSnapshotJobsResponse < Struct.new(
3630
+ :next_token,
3631
+ :resource_snapshot_job_summaries)
3632
+ SENSITIVE = []
3633
+ include Aws::Structure
3634
+ end
3635
+
3636
+ # @!attribute [rw] catalog
3637
+ # Specifies the catalog related to the request.
3638
+ # @return [String]
3639
+ #
3640
+ # @!attribute [rw] created_by
3641
+ # Filters the response to include only snapshots of resources owned by
3642
+ # the specified AWS account.
3643
+ # @return [String]
3644
+ #
3645
+ # @!attribute [rw] engagement_identifier
3646
+ # The unique identifier of the engagement associated with the
3647
+ # snapshots.
3648
+ # @return [String]
3649
+ #
3650
+ # @!attribute [rw] max_results
3651
+ # The maximum number of results to return in a single call.
3652
+ # @return [Integer]
3653
+ #
3654
+ # @!attribute [rw] next_token
3655
+ # The token for the next set of results.
3656
+ # @return [String]
3657
+ #
3658
+ # @!attribute [rw] resource_identifier
3659
+ # Filters the response to include only snapshots of the specified
3660
+ # resource.
3661
+ # @return [String]
3662
+ #
3663
+ # @!attribute [rw] resource_snapshot_template_identifier
3664
+ # Filters the response to include only snapshots created using the
3665
+ # specified template.
3666
+ # @return [String]
3667
+ #
3668
+ # @!attribute [rw] resource_type
3669
+ # Filters the response to include only snapshots of the specified
3670
+ # resource type.
3671
+ # @return [String]
3672
+ #
3673
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListResourceSnapshotsRequest AWS API Documentation
3674
+ #
3675
+ class ListResourceSnapshotsRequest < Struct.new(
3676
+ :catalog,
3677
+ :created_by,
3678
+ :engagement_identifier,
3679
+ :max_results,
3680
+ :next_token,
3681
+ :resource_identifier,
3682
+ :resource_snapshot_template_identifier,
3683
+ :resource_type)
3684
+ SENSITIVE = [:created_by]
3685
+ include Aws::Structure
3686
+ end
3687
+
3688
+ # @!attribute [rw] next_token
3689
+ # The token to retrieve the next set of results. If there are no
3690
+ # additional results, this value is null.
3691
+ # @return [String]
3692
+ #
3693
+ # @!attribute [rw] resource_snapshot_summaries
3694
+ # An array of resource snapshot summary objects.
3695
+ # @return [Array<Types::ResourceSnapshotSummary>]
3696
+ #
3697
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListResourceSnapshotsResponse AWS API Documentation
3698
+ #
3699
+ class ListResourceSnapshotsResponse < Struct.new(
3700
+ :next_token,
3701
+ :resource_snapshot_summaries)
3702
+ SENSITIVE = []
3703
+ include Aws::Structure
3704
+ end
3705
+
2035
3706
  # @!attribute [rw] catalog
2036
3707
  # Specifies the catalog associated with the request. This field takes
2037
3708
  # a string value from a predefined list: `AWS` or `Sandbox`. The
@@ -2111,6 +3782,52 @@ module Aws::PartnerCentralSelling
2111
3782
  include Aws::Structure
2112
3783
  end
2113
3784
 
3785
+ # @!attribute [rw] resource_arn
3786
+ # The Amazon Resource Name (ARN) of the resource for which you want to
3787
+ # retrieve tags.
3788
+ # @return [String]
3789
+ #
3790
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListTagsForResourceRequest AWS API Documentation
3791
+ #
3792
+ class ListTagsForResourceRequest < Struct.new(
3793
+ :resource_arn)
3794
+ SENSITIVE = []
3795
+ include Aws::Structure
3796
+ end
3797
+
3798
+ # @!attribute [rw] tags
3799
+ # A map of the key-value pairs for the tag or tags assigned to the
3800
+ # specified resource.
3801
+ # @return [Array<Types::Tag>]
3802
+ #
3803
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListTagsForResourceResponse AWS API Documentation
3804
+ #
3805
+ class ListTagsForResourceResponse < Struct.new(
3806
+ :tags)
3807
+ SENSITIVE = []
3808
+ include Aws::Structure
3809
+ end
3810
+
3811
+ # Defines the sorting parameters for listing tasks. This structure
3812
+ # allows for specifying the field to sort by and the order of sorting.
3813
+ #
3814
+ # @!attribute [rw] sort_by
3815
+ # Specifies the field by which the task list should be sorted.
3816
+ # @return [String]
3817
+ #
3818
+ # @!attribute [rw] sort_order
3819
+ # Determines the order in which the sorted results are presented.
3820
+ # @return [String]
3821
+ #
3822
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ListTasksSortBase AWS API Documentation
3823
+ #
3824
+ class ListTasksSortBase < Struct.new(
3825
+ :sort_by,
3826
+ :sort_order)
3827
+ SENSITIVE = []
3828
+ include Aws::Structure
3829
+ end
3830
+
2114
3831
  # An object that contains marketing details for the `Opportunity`.
2115
3832
  #
2116
3833
  # @!attribute [rw] aws_funding_used
@@ -2294,6 +4011,12 @@ module Aws::PartnerCentralSelling
2294
4011
 
2295
4012
  # An object that contains an `Opportunity`'s subset of fields.
2296
4013
  #
4014
+ # @!attribute [rw] arn
4015
+ # The Amazon Resource Name (ARN) for the opportunity. This globally
4016
+ # unique identifier can be used for IAM policies and cross-service
4017
+ # references.
4018
+ # @return [String]
4019
+ #
2297
4020
  # @!attribute [rw] catalog
2298
4021
  # Specifies the catalog associated with the opportunity, either `AWS`
2299
4022
  # or `Sandbox`. This indicates the environment in which the
@@ -2339,30 +4062,85 @@ module Aws::PartnerCentralSelling
2339
4062
  # current customer.
2340
4063
  # @return [String]
2341
4064
  #
2342
- # @!attribute [rw] partner_opportunity_identifier
2343
- # Specifies the `Opportunity`'s unique identifier in the partner's
2344
- # CRM system. This value is essential to track and reconcile because
2345
- # it's included in the outbound payload sent back to the partner. It
2346
- # allows partners to link an opportunity to their CRM.
4065
+ # @!attribute [rw] partner_opportunity_identifier
4066
+ # Specifies the `Opportunity`'s unique identifier in the partner's
4067
+ # CRM system. This value is essential to track and reconcile because
4068
+ # it's included in the outbound payload sent back to the partner. It
4069
+ # allows partners to link an opportunity to their CRM.
4070
+ # @return [String]
4071
+ #
4072
+ # @!attribute [rw] project
4073
+ # An object that contains the `Opportunity`'s project details
4074
+ # summary.
4075
+ # @return [Types::ProjectSummary]
4076
+ #
4077
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/OpportunitySummary AWS API Documentation
4078
+ #
4079
+ class OpportunitySummary < Struct.new(
4080
+ :arn,
4081
+ :catalog,
4082
+ :created_date,
4083
+ :customer,
4084
+ :id,
4085
+ :last_modified_date,
4086
+ :life_cycle,
4087
+ :opportunity_type,
4088
+ :partner_opportunity_identifier,
4089
+ :project)
4090
+ SENSITIVE = []
4091
+ include Aws::Structure
4092
+ end
4093
+
4094
+ # Provides a comprehensive view of an opportunity summary, including
4095
+ # lifecycle information, team details, opportunity type, primary needs
4096
+ # from AWS, and associated project information.
4097
+ #
4098
+ # @!attribute [rw] customer
4099
+ # An object that contains the customer's `Account` and `Contact`.
4100
+ # @return [Types::Customer]
4101
+ #
4102
+ # @!attribute [rw] lifecycle
4103
+ # Contains information about the opportunity's lifecycle, including
4104
+ # its current stage, status, and important dates such as creation and
4105
+ # last modification times.
4106
+ # @return [Types::LifeCycleForView]
4107
+ #
4108
+ # @!attribute [rw] opportunity_team
4109
+ # Represents the internal team handling the opportunity. Specify the
4110
+ # members involved in collaborating on an opportunity within the
4111
+ # partner's organization.
4112
+ # @return [Array<Types::Contact>]
4113
+ #
4114
+ # @!attribute [rw] opportunity_type
4115
+ # Specifies the opportunity type.
2347
4116
  # @return [String]
2348
4117
  #
4118
+ # @!attribute [rw] primary_needs_from_aws
4119
+ # Identifies the type of support the partner needs from AWS.
4120
+ # @return [Array<String>]
4121
+ #
2349
4122
  # @!attribute [rw] project
2350
- # An object that contains the `Opportunity`'s project details
2351
- # summary.
2352
- # @return [Types::ProjectSummary]
4123
+ # Contains summary information about the project associated with the
4124
+ # opportunity, including project name, description, timeline, and
4125
+ # other relevant details.
4126
+ # @return [Types::ProjectView]
2353
4127
  #
2354
- # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/OpportunitySummary AWS API Documentation
4128
+ # @!attribute [rw] related_entity_identifiers
4129
+ # This field provides the associations' information for other
4130
+ # entities with the opportunity. These entities include identifiers
4131
+ # for `AWSProducts`, `Partner Solutions`, and `AWSMarketplaceOffers`.
4132
+ # @return [Types::RelatedEntityIdentifiers]
2355
4133
  #
2356
- class OpportunitySummary < Struct.new(
2357
- :catalog,
2358
- :created_date,
4134
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/OpportunitySummaryView AWS API Documentation
4135
+ #
4136
+ class OpportunitySummaryView < Struct.new(
2359
4137
  :customer,
2360
- :id,
2361
- :last_modified_date,
2362
- :life_cycle,
4138
+ :lifecycle,
4139
+ :opportunity_team,
2363
4140
  :opportunity_type,
2364
- :partner_opportunity_identifier,
2365
- :project)
4141
+ :primary_needs_from_aws,
4142
+ :project,
4143
+ :related_entity_identifiers)
2366
4144
  SENSITIVE = []
2367
4145
  include Aws::Structure
2368
4146
  end
@@ -2372,6 +4150,8 @@ module Aws::PartnerCentralSelling
2372
4150
  # and is used by partners to evaluate whether to accept or reject the
2373
4151
  # engagement.
2374
4152
  #
4153
+ # @note Payload is a union - when making an API calls you must set exactly one of the members.
4154
+ #
2375
4155
  # @note Payload is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of Payload corresponding to the set member.
2376
4156
  #
2377
4157
  # @!attribute [rw] opportunity_invitation
@@ -2668,10 +4448,97 @@ module Aws::PartnerCentralSelling
2668
4448
  include Aws::Structure
2669
4449
  end
2670
4450
 
4451
+ # Provides the project view of an opportunity resource shared through a
4452
+ # snapshot.
4453
+ #
4454
+ # @!attribute [rw] customer_use_case
4455
+ # Specifies the proposed solution focus or type of workload for the
4456
+ # project.
4457
+ # @return [String]
4458
+ #
4459
+ # @!attribute [rw] delivery_models
4460
+ # Describes the deployment or consumption model for the partner
4461
+ # solution or offering. This field indicates how the project's
4462
+ # solution will be delivered or implemented for the customer.
4463
+ # @return [Array<String>]
4464
+ #
4465
+ # @!attribute [rw] expected_customer_spend
4466
+ # Provides information about the anticipated customer spend related to
4467
+ # this project. This may include details such as amount, frequency,
4468
+ # and currency of expected expenditure.
4469
+ # @return [Array<Types::ExpectedCustomerSpend>]
4470
+ #
4471
+ # @!attribute [rw] other_solution_description
4472
+ # Offers a description of other solutions if the standard solutions do
4473
+ # not adequately cover the project's scope.
4474
+ # @return [String]
4475
+ #
4476
+ # @!attribute [rw] sales_activities
4477
+ # Lists the pre-sales activities that have occurred with the
4478
+ # end-customer related to the opportunity. This field is conditionally
4479
+ # mandatory when the project is qualified for Co-Sell and helps drive
4480
+ # assignment priority on the AWS side. It provides insight into the
4481
+ # engagement level with the customer.
4482
+ # @return [Array<String>]
4483
+ #
4484
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ProjectView AWS API Documentation
4485
+ #
4486
+ class ProjectView < Struct.new(
4487
+ :customer_use_case,
4488
+ :delivery_models,
4489
+ :expected_customer_spend,
4490
+ :other_solution_description,
4491
+ :sales_activities)
4492
+ SENSITIVE = [:other_solution_description]
4493
+ include Aws::Structure
4494
+ end
4495
+
4496
+ # @!attribute [rw] catalog
4497
+ # Specifies the catalog in which the settings will be updated.
4498
+ # Acceptable values include `AWS` for production and `Sandbox` for
4499
+ # testing environments.
4500
+ # @return [String]
4501
+ #
4502
+ # @!attribute [rw] resource_snapshot_job_role_identifier
4503
+ # Specifies the ARN of the IAM Role used for resource snapshot job
4504
+ # executions.
4505
+ # @return [String]
4506
+ #
4507
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/PutSellingSystemSettingsRequest AWS API Documentation
4508
+ #
4509
+ class PutSellingSystemSettingsRequest < Struct.new(
4510
+ :catalog,
4511
+ :resource_snapshot_job_role_identifier)
4512
+ SENSITIVE = []
4513
+ include Aws::Structure
4514
+ end
4515
+
4516
+ # @!attribute [rw] catalog
4517
+ # Specifies the catalog in which the settings are defined. Acceptable
4518
+ # values include `AWS` for production and `Sandbox` for testing
4519
+ # environments.
4520
+ # @return [String]
4521
+ #
4522
+ # @!attribute [rw] resource_snapshot_job_role_arn
4523
+ # Specifies the ARN of the IAM Role used for resource snapshot job
4524
+ # executions.
4525
+ # @return [String]
4526
+ #
4527
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/PutSellingSystemSettingsResponse AWS API Documentation
4528
+ #
4529
+ class PutSellingSystemSettingsResponse < Struct.new(
4530
+ :catalog,
4531
+ :resource_snapshot_job_role_arn)
4532
+ SENSITIVE = []
4533
+ include Aws::Structure
4534
+ end
4535
+
2671
4536
  # Represents the entity that received the Engagement Invitation,
2672
4537
  # including account and company details. This field is essential for
2673
4538
  # tracking the partner who is being invited to collaborate.
2674
4539
  #
4540
+ # @note Receiver is a union - when making an API calls you must set exactly one of the members.
4541
+ #
2675
4542
  # @note Receiver is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of Receiver corresponding to the set member.
2676
4543
  #
2677
4544
  # @!attribute [rw] account
@@ -2814,6 +4681,114 @@ module Aws::PartnerCentralSelling
2814
4681
  include Aws::Structure
2815
4682
  end
2816
4683
 
4684
+ # An object that contains a `Resource Snapshot Job`'s subset of fields.
4685
+ #
4686
+ # @!attribute [rw] arn
4687
+ # The Amazon Resource Name (ARN) for the resource snapshot job.
4688
+ # @return [String]
4689
+ #
4690
+ # @!attribute [rw] engagement_id
4691
+ # The unique identifier of the Engagement.
4692
+ # @return [String]
4693
+ #
4694
+ # @!attribute [rw] id
4695
+ # The unique identifier for the resource snapshot job within the AWS
4696
+ # Partner Central system. This ID is used for direct references to the
4697
+ # job within the service.
4698
+ # @return [String]
4699
+ #
4700
+ # @!attribute [rw] status
4701
+ # The current status of the snapshot job.
4702
+ #
4703
+ # Valid values:
4704
+ #
4705
+ # * STOPPED: The job is not currently running.
4706
+ #
4707
+ # * RUNNING: The job is actively executing.
4708
+ # @return [String]
4709
+ #
4710
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ResourceSnapshotJobSummary AWS API Documentation
4711
+ #
4712
+ class ResourceSnapshotJobSummary < Struct.new(
4713
+ :arn,
4714
+ :engagement_id,
4715
+ :id,
4716
+ :status)
4717
+ SENSITIVE = []
4718
+ include Aws::Structure
4719
+ end
4720
+
4721
+ # Represents the payload of a resource snapshot. This structure is
4722
+ # designed to accommodate different types of resource snapshots,
4723
+ # currently supporting opportunity summaries.
4724
+ #
4725
+ # @note ResourceSnapshotPayload is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of ResourceSnapshotPayload corresponding to the set member.
4726
+ #
4727
+ # @!attribute [rw] opportunity_summary
4728
+ # An object that contains an `opportunity`'s subset of fields.
4729
+ # @return [Types::OpportunitySummaryView]
4730
+ #
4731
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ResourceSnapshotPayload AWS API Documentation
4732
+ #
4733
+ class ResourceSnapshotPayload < Struct.new(
4734
+ :opportunity_summary,
4735
+ :unknown)
4736
+ SENSITIVE = []
4737
+ include Aws::Structure
4738
+ include Aws::Structure::Union
4739
+
4740
+ class OpportunitySummary < ResourceSnapshotPayload; end
4741
+ class Unknown < ResourceSnapshotPayload; end
4742
+ end
4743
+
4744
+ # Provides a concise summary of a resource snapshot, including its
4745
+ # unique identifier and version information. This structure is used to
4746
+ # quickly reference and identify specific versions of resource
4747
+ # snapshots.
4748
+ #
4749
+ # @!attribute [rw] arn
4750
+ # The Amazon Resource Name (ARN) of the snapshot. This globally unique
4751
+ # identifier can be used for cross-service references and in IAM
4752
+ # policies.
4753
+ # @return [String]
4754
+ #
4755
+ # @!attribute [rw] created_by
4756
+ # The AWS account ID of the entity that owns the resource from which
4757
+ # the snapshot was created.
4758
+ # @return [String]
4759
+ #
4760
+ # @!attribute [rw] resource_id
4761
+ # The identifier of the specific resource snapshotted. The format
4762
+ # might vary depending on the ResourceType.
4763
+ # @return [String]
4764
+ #
4765
+ # @!attribute [rw] resource_snapshot_template_name
4766
+ # The name of the template used to create the snapshot.
4767
+ # @return [String]
4768
+ #
4769
+ # @!attribute [rw] resource_type
4770
+ # The type of resource snapshotted.
4771
+ # @return [String]
4772
+ #
4773
+ # @!attribute [rw] revision
4774
+ # The revision number of the snapshot. This integer value is
4775
+ # incremented each time the snapshot is updated, allowing for version
4776
+ # tracking of the resource snapshot.
4777
+ # @return [Integer]
4778
+ #
4779
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/ResourceSnapshotSummary AWS API Documentation
4780
+ #
4781
+ class ResourceSnapshotSummary < Struct.new(
4782
+ :arn,
4783
+ :created_by,
4784
+ :resource_id,
4785
+ :resource_snapshot_template_name,
4786
+ :resource_type,
4787
+ :revision)
4788
+ SENSITIVE = [:created_by]
4789
+ include Aws::Structure
4790
+ end
4791
+
2817
4792
  # An object that contains the details of the sender-provided contact
2818
4793
  # person for the `EngagementInvitation`.
2819
4794
  #
@@ -2915,6 +4890,11 @@ module Aws::PartnerCentralSelling
2915
4890
  # Specifies minimal information for the solution offered to solve the
2916
4891
  # customer's business problem.
2917
4892
  #
4893
+ # @!attribute [rw] arn
4894
+ # The SolutionBase structure provides essential information about a
4895
+ # solution.
4896
+ # @return [String]
4897
+ #
2918
4898
  # @!attribute [rw] catalog
2919
4899
  # Specifies the catalog in which the solution is hosted, either `AWS`
2920
4900
  # or `Sandbox`. This helps partners differentiate between live
@@ -2955,6 +4935,7 @@ module Aws::PartnerCentralSelling
2955
4935
  # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/SolutionBase AWS API Documentation
2956
4936
  #
2957
4937
  class SolutionBase < Struct.new(
4938
+ :arn,
2958
4939
  :catalog,
2959
4940
  :category,
2960
4941
  :created_date,
@@ -2987,6 +4968,27 @@ module Aws::PartnerCentralSelling
2987
4968
  include Aws::Structure
2988
4969
  end
2989
4970
 
4971
+ # Defines the sorting parameters for listing resource snapshot jobs.
4972
+ # This structure allows you to specify the field to sort by and the
4973
+ # order of sorting.
4974
+ #
4975
+ # @!attribute [rw] sort_by
4976
+ # Specifies the field by which to sort the resource snapshot jobs.
4977
+ # @return [String]
4978
+ #
4979
+ # @!attribute [rw] sort_order
4980
+ # Determines the order in which the sorted results are presented.
4981
+ # @return [String]
4982
+ #
4983
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/SortObject AWS API Documentation
4984
+ #
4985
+ class SortObject < Struct.new(
4986
+ :sort_by,
4987
+ :sort_order)
4988
+ SENSITIVE = []
4989
+ include Aws::Structure
4990
+ end
4991
+
2990
4992
  # @!attribute [rw] catalog
2991
4993
  # Specifies the catalog related to the task. Use `AWS` for production
2992
4994
  # engagements and `Sandbox` for testing scenarios.
@@ -3007,12 +5009,17 @@ module Aws::PartnerCentralSelling
3007
5009
  # correct engagement is processed.
3008
5010
  # @return [String]
3009
5011
  #
5012
+ # @!attribute [rw] tags
5013
+ # A list of objects specifying each tag name and value.
5014
+ # @return [Array<Types::Tag>]
5015
+ #
3010
5016
  # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/StartEngagementByAcceptingInvitationTaskRequest AWS API Documentation
3011
5017
  #
3012
5018
  class StartEngagementByAcceptingInvitationTaskRequest < Struct.new(
3013
5019
  :catalog,
3014
5020
  :client_token,
3015
- :identifier)
5021
+ :identifier,
5022
+ :tags)
3016
5023
  SENSITIVE = []
3017
5024
  include Aws::Structure
3018
5025
  end
@@ -3036,6 +5043,11 @@ module Aws::PartnerCentralSelling
3036
5043
  # Indicates the reason for task failure using an enumerated code.
3037
5044
  # @return [String]
3038
5045
  #
5046
+ # @!attribute [rw] resource_snapshot_job_id
5047
+ # The identifier of the Resource Snapshot Job created as part of this
5048
+ # task.
5049
+ # @return [String]
5050
+ #
3039
5051
  # @!attribute [rw] start_time
3040
5052
  # The timestamp indicating when the task was initiated. The format
3041
5053
  # follows RFC 3339 section 5.6.
@@ -3062,6 +5074,7 @@ module Aws::PartnerCentralSelling
3062
5074
  :message,
3063
5075
  :opportunity_id,
3064
5076
  :reason_code,
5077
+ :resource_snapshot_job_id,
3065
5078
  :start_time,
3066
5079
  :task_arn,
3067
5080
  :task_id,
@@ -3097,17 +5110,32 @@ module Aws::PartnerCentralSelling
3097
5110
  # to the correct opportunity.
3098
5111
  # @return [String]
3099
5112
  #
5113
+ # @!attribute [rw] tags
5114
+ # A list of objects specifying each tag name and value.
5115
+ # @return [Array<Types::Tag>]
5116
+ #
3100
5117
  # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/StartEngagementFromOpportunityTaskRequest AWS API Documentation
3101
5118
  #
3102
5119
  class StartEngagementFromOpportunityTaskRequest < Struct.new(
3103
5120
  :aws_submission,
3104
5121
  :catalog,
3105
5122
  :client_token,
3106
- :identifier)
5123
+ :identifier,
5124
+ :tags)
3107
5125
  SENSITIVE = []
3108
5126
  include Aws::Structure
3109
5127
  end
3110
5128
 
5129
+ # @!attribute [rw] engagement_id
5130
+ # The identifier of the newly created Engagement. Only populated if
5131
+ # TaskStatus is COMPLETE.
5132
+ # @return [String]
5133
+ #
5134
+ # @!attribute [rw] engagement_invitation_id
5135
+ # The identifier of the new Engagement invitation. Only populated if
5136
+ # TaskStatus is COMPLETE.
5137
+ # @return [String]
5138
+ #
3111
5139
  # @!attribute [rw] message
3112
5140
  # If the task fails, this field contains a detailed message describing
3113
5141
  # the failure and possible recovery steps.
@@ -3123,6 +5151,12 @@ module Aws::PartnerCentralSelling
3123
5151
  # Indicates the reason for task failure using an enumerated code.
3124
5152
  # @return [String]
3125
5153
  #
5154
+ # @!attribute [rw] resource_snapshot_job_id
5155
+ # The identifier of the resource snapshot job created to add the
5156
+ # opportunity resource snapshot to the Engagement. Only populated if
5157
+ # TaskStatus is COMPLETE
5158
+ # @return [String]
5159
+ #
3126
5160
  # @!attribute [rw] start_time
3127
5161
  # The timestamp indicating when the task was initiated. The format
3128
5162
  # follows RFC 3339 section 5.6.
@@ -3147,9 +5181,12 @@ module Aws::PartnerCentralSelling
3147
5181
  # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/StartEngagementFromOpportunityTaskResponse AWS API Documentation
3148
5182
  #
3149
5183
  class StartEngagementFromOpportunityTaskResponse < Struct.new(
5184
+ :engagement_id,
5185
+ :engagement_invitation_id,
3150
5186
  :message,
3151
5187
  :opportunity_id,
3152
5188
  :reason_code,
5189
+ :resource_snapshot_job_id,
3153
5190
  :start_time,
3154
5191
  :task_arn,
3155
5192
  :task_id,
@@ -3158,6 +5195,138 @@ module Aws::PartnerCentralSelling
3158
5195
  include Aws::Structure
3159
5196
  end
3160
5197
 
5198
+ # @!attribute [rw] catalog
5199
+ # Specifies the catalog related to the request. Valid values are:
5200
+ #
5201
+ # * AWS: Starts the request from the production AWS environment.
5202
+ #
5203
+ # * Sandbox: Starts the request from a sandbox environment used for
5204
+ # testing or development purposes.
5205
+ # @return [String]
5206
+ #
5207
+ # @!attribute [rw] resource_snapshot_job_identifier
5208
+ # The identifier of the resource snapshot job to start.
5209
+ # @return [String]
5210
+ #
5211
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/StartResourceSnapshotJobRequest AWS API Documentation
5212
+ #
5213
+ class StartResourceSnapshotJobRequest < Struct.new(
5214
+ :catalog,
5215
+ :resource_snapshot_job_identifier)
5216
+ SENSITIVE = []
5217
+ include Aws::Structure
5218
+ end
5219
+
5220
+ # @!attribute [rw] catalog
5221
+ # Specifies the catalog related to the request. Valid values are:
5222
+ #
5223
+ # * AWS: Stops the request from the production AWS environment.
5224
+ #
5225
+ # * Sandbox: Stops the request from a sandbox environment used for
5226
+ # testing or development purposes.
5227
+ # @return [String]
5228
+ #
5229
+ # @!attribute [rw] resource_snapshot_job_identifier
5230
+ # The identifier of the job to stop.
5231
+ # @return [String]
5232
+ #
5233
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/StopResourceSnapshotJobRequest AWS API Documentation
5234
+ #
5235
+ class StopResourceSnapshotJobRequest < Struct.new(
5236
+ :catalog,
5237
+ :resource_snapshot_job_identifier)
5238
+ SENSITIVE = []
5239
+ include Aws::Structure
5240
+ end
5241
+
5242
+ # @!attribute [rw] catalog
5243
+ # Specifies the catalog related to the request. Valid values are:
5244
+ #
5245
+ # * AWS: Submits the opportunity request from the production AWS
5246
+ # environment.
5247
+ #
5248
+ # * Sandbox: Submits the opportunity request from a sandbox
5249
+ # environment used for testing or development purposes.
5250
+ # @return [String]
5251
+ #
5252
+ # @!attribute [rw] identifier
5253
+ # The identifier of the Opportunity previously created by partner and
5254
+ # needs to be submitted.
5255
+ # @return [String]
5256
+ #
5257
+ # @!attribute [rw] involvement_type
5258
+ # Specifies the level of AWS sellers' involvement on the opportunity.
5259
+ # Valid values:
5260
+ #
5261
+ # * `Co-sell`: Indicates the user wants to co-sell with AWS. Share the
5262
+ # opportunity with AWS to receive deal assistance and support.
5263
+ #
5264
+ # * `For Visibility Only`: Indicates that the user does not need
5265
+ # support from AWS Sales Rep. Share this opportunity with AWS for
5266
+ # visibility only, you will not receive deal assistance and support.
5267
+ # @return [String]
5268
+ #
5269
+ # @!attribute [rw] visibility
5270
+ # Determines whether to restrict visibility of the opportunity from
5271
+ # AWS sales. Default value is Full. Valid values:
5272
+ #
5273
+ # * `Full`: The opportunity is fully visible to AWS sales.
5274
+ #
5275
+ # * `Limited`: The opportunity has restricted visibility to AWS sales.
5276
+ # @return [String]
5277
+ #
5278
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/SubmitOpportunityRequest AWS API Documentation
5279
+ #
5280
+ class SubmitOpportunityRequest < Struct.new(
5281
+ :catalog,
5282
+ :identifier,
5283
+ :involvement_type,
5284
+ :visibility)
5285
+ SENSITIVE = []
5286
+ include Aws::Structure
5287
+ end
5288
+
5289
+ # The key-value pair assigned to a specified resource.
5290
+ #
5291
+ # @!attribute [rw] key
5292
+ # The key in the tag.
5293
+ # @return [String]
5294
+ #
5295
+ # @!attribute [rw] value
5296
+ # The value in the tag.
5297
+ # @return [String]
5298
+ #
5299
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/Tag AWS API Documentation
5300
+ #
5301
+ class Tag < Struct.new(
5302
+ :key,
5303
+ :value)
5304
+ SENSITIVE = []
5305
+ include Aws::Structure
5306
+ end
5307
+
5308
+ # @!attribute [rw] resource_arn
5309
+ # The Amazon Resource Name (ARN) of the resource that you want to tag.
5310
+ # @return [String]
5311
+ #
5312
+ # @!attribute [rw] tags
5313
+ # A map of the key-value pairs of the tag or tags to assign to the
5314
+ # resource.
5315
+ # @return [Array<Types::Tag>]
5316
+ #
5317
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/TagResourceRequest AWS API Documentation
5318
+ #
5319
+ class TagResourceRequest < Struct.new(
5320
+ :resource_arn,
5321
+ :tags)
5322
+ SENSITIVE = []
5323
+ include Aws::Structure
5324
+ end
5325
+
5326
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/TagResourceResponse AWS API Documentation
5327
+ #
5328
+ class TagResourceResponse < Aws::EmptyStructure; end
5329
+
3161
5330
  # This error occurs when there are too many requests sent. Review the
3162
5331
  # provided quotas and adapt your usage to avoid throttling.
3163
5332
  #
@@ -3179,6 +5348,29 @@ module Aws::PartnerCentralSelling
3179
5348
  include Aws::Structure
3180
5349
  end
3181
5350
 
5351
+ # @!attribute [rw] resource_arn
5352
+ # The Amazon Resource Name (ARN) of the resource that you want to
5353
+ # untag.
5354
+ # @return [String]
5355
+ #
5356
+ # @!attribute [rw] tag_keys
5357
+ # The keys of the key-value pairs for the tag or tags you want to
5358
+ # remove from the specified resource.
5359
+ # @return [Array<String>]
5360
+ #
5361
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/UntagResourceRequest AWS API Documentation
5362
+ #
5363
+ class UntagResourceRequest < Struct.new(
5364
+ :resource_arn,
5365
+ :tag_keys)
5366
+ SENSITIVE = []
5367
+ include Aws::Structure
5368
+ end
5369
+
5370
+ # @see http://docs.aws.amazon.com/goto/WebAPI/partnercentral-selling-2022-07-26/UntagResourceResponse AWS API Documentation
5371
+ #
5372
+ class UntagResourceResponse < Aws::EmptyStructure; end
5373
+
3182
5374
  # @!attribute [rw] catalog
3183
5375
  # Specifies the catalog associated with the request. This field takes
3184
5376
  # a string value from a predefined list: `AWS` or `Sandbox`. The
@@ -3280,13 +5472,6 @@ module Aws::PartnerCentralSelling
3280
5472
  # * Cosell—Support for Public Tender/RFx: Opportunity related to the
3281
5473
  # public sector where the partner needs RFx support from Amazon Web
3282
5474
  # Services.
3283
- #
3284
- # * Do Not Need Support from AWS Sales Rep: Indicates that a partner
3285
- # doesn't need support from an Amazon Web Services Sales
3286
- # representative. The opportunity is managed solely by the partner.
3287
- # It's possible to request coselling support on these opportunities
3288
- # at any stage during their lifecycle. Also known as,
3289
- # for-visibility-only (FVO) opportunity.
3290
5475
  # @return [Array<String>]
3291
5476
  #
3292
5477
  # @!attribute [rw] project