aws-sdk-securityagent 1.0.0 → 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -476,19 +476,22 @@ module Aws::SecurityAgent
476
476
 
477
477
  # @!group API Operations
478
478
 
479
- # Adds an Artifact for the given agent space
479
+ # Uploads an artifact to an agent space. Artifacts provide additional
480
+ # context for security testing, such as architecture diagrams, API
481
+ # specifications, or configuration files.
480
482
  #
481
483
  # @option params [required, String] :agent_space_id
482
- # Unique identifier of the agent space
484
+ # The unique identifier of the agent space to add the artifact to.
483
485
  #
484
486
  # @option params [required, String, StringIO, File] :artifact_content
485
- # Binary content of the artifact
487
+ # The binary content of the artifact to upload.
486
488
  #
487
489
  # @option params [required, String] :artifact_type
488
- # Type of the artifact file
490
+ # The file type of the artifact. Valid values include TXT, PNG, JPEG,
491
+ # MD, PDF, DOCX, DOC, JSON, and YAML.
489
492
  #
490
493
  # @option params [required, String] :file_name
491
- # Name of the artifact file
494
+ # The file name of the artifact.
492
495
  #
493
496
  # @return [Types::AddArtifactOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
494
497
  #
@@ -516,13 +519,52 @@ module Aws::SecurityAgent
516
519
  req.send_request(options)
517
520
  end
518
521
 
519
- # Deletes multiple pentests in a single request
522
+ # Deletes one or more code reviews from an agent space.
523
+ #
524
+ # @option params [required, Array<String>] :code_review_ids
525
+ # The list of code review identifiers to delete.
526
+ #
527
+ # @option params [required, String] :agent_space_id
528
+ # The unique identifier of the agent space that contains the code
529
+ # reviews to delete.
530
+ #
531
+ # @return [Types::BatchDeleteCodeReviewsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
532
+ #
533
+ # * {Types::BatchDeleteCodeReviewsOutput#deleted #deleted} => Array&lt;String&gt;
534
+ # * {Types::BatchDeleteCodeReviewsOutput#failed #failed} => Array&lt;Types::DeleteCodeReviewFailure&gt;
535
+ #
536
+ # @example Request syntax with placeholder values
537
+ #
538
+ # resp = client.batch_delete_code_reviews({
539
+ # code_review_ids: ["String"], # required
540
+ # agent_space_id: "String", # required
541
+ # })
542
+ #
543
+ # @example Response structure
544
+ #
545
+ # resp.deleted #=> Array
546
+ # resp.deleted[0] #=> String
547
+ # resp.failed #=> Array
548
+ # resp.failed[0].code_review_id #=> String
549
+ # resp.failed[0].reason #=> String
550
+ #
551
+ # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/BatchDeleteCodeReviews AWS API Documentation
552
+ #
553
+ # @overload batch_delete_code_reviews(params = {})
554
+ # @param [Hash] params ({})
555
+ def batch_delete_code_reviews(params = {}, options = {})
556
+ req = build_request(:batch_delete_code_reviews, params)
557
+ req.send_request(options)
558
+ end
559
+
560
+ # Deletes one or more pentests from an agent space.
520
561
  #
521
562
  # @option params [required, Array<String>] :pentest_ids
522
- # List of pentest IDs to delete
563
+ # The list of pentest identifiers to delete.
523
564
  #
524
565
  # @option params [required, String] :agent_space_id
525
- # ID of the agent space where the pentests exist
566
+ # The unique identifier of the agent space that contains the pentests to
567
+ # delete.
526
568
  #
527
569
  # @return [Types::BatchDeletePentestsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
528
570
  #
@@ -592,10 +634,10 @@ module Aws::SecurityAgent
592
634
  req.send_request(options)
593
635
  end
594
636
 
595
- # Retrieves multiple agent spaces in a single request
637
+ # Retrieves information about one or more agent spaces.
596
638
  #
597
639
  # @option params [required, Array<String>] :agent_space_ids
598
- # List of agent space IDs to retrieve
640
+ # The list of agent space identifiers to retrieve.
599
641
  #
600
642
  # @return [Types::BatchGetAgentSpacesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
601
643
  #
@@ -649,13 +691,13 @@ module Aws::SecurityAgent
649
691
  req.send_request(options)
650
692
  end
651
693
 
652
- # Retrieve the list of artifact metadata for the given agent space
694
+ # Retrieves metadata for one or more artifacts in an agent space.
653
695
  #
654
696
  # @option params [required, String] :agent_space_id
655
- # Unique identifier of the agent space
697
+ # The unique identifier of the agent space that contains the artifacts.
656
698
  #
657
699
  # @option params [required, Array<String>] :artifact_ids
658
- # List of artifact identifiers
700
+ # The list of artifact identifiers to retrieve metadata for.
659
701
  #
660
702
  # @return [Types::BatchGetArtifactMetadataOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
661
703
  #
@@ -685,13 +727,196 @@ module Aws::SecurityAgent
685
727
  req.send_request(options)
686
728
  end
687
729
 
688
- # Retrieves multiple findings in a single request
730
+ # Retrieves information about one or more tasks within a code review
731
+ # job.
732
+ #
733
+ # @option params [required, String] :agent_space_id
734
+ # The unique identifier of the agent space that contains the tasks.
735
+ #
736
+ # @option params [required, Array<String>] :code_review_job_task_ids
737
+ # The list of task identifiers to retrieve.
738
+ #
739
+ # @return [Types::BatchGetCodeReviewJobTasksOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
740
+ #
741
+ # * {Types::BatchGetCodeReviewJobTasksOutput#code_review_job_tasks #code_review_job_tasks} => Array&lt;Types::CodeReviewJobTask&gt;
742
+ # * {Types::BatchGetCodeReviewJobTasksOutput#not_found #not_found} => Array&lt;String&gt;
743
+ #
744
+ # @example Request syntax with placeholder values
745
+ #
746
+ # resp = client.batch_get_code_review_job_tasks({
747
+ # agent_space_id: "String", # required
748
+ # code_review_job_task_ids: ["String"], # required
749
+ # })
750
+ #
751
+ # @example Response structure
752
+ #
753
+ # resp.code_review_job_tasks #=> Array
754
+ # resp.code_review_job_tasks[0].task_id #=> String
755
+ # resp.code_review_job_tasks[0].code_review_id #=> String
756
+ # resp.code_review_job_tasks[0].code_review_job_id #=> String
757
+ # resp.code_review_job_tasks[0].agent_space_id #=> String
758
+ # resp.code_review_job_tasks[0].title #=> String
759
+ # resp.code_review_job_tasks[0].description #=> String
760
+ # resp.code_review_job_tasks[0].categories #=> Array
761
+ # resp.code_review_job_tasks[0].categories[0].name #=> String
762
+ # resp.code_review_job_tasks[0].categories[0].is_primary #=> Boolean
763
+ # resp.code_review_job_tasks[0].risk_type #=> String, one of "CROSS_SITE_SCRIPTING", "DEFAULT_CREDENTIALS", "INSECURE_DIRECT_OBJECT_REFERENCE", "PRIVILEGE_ESCALATION", "SERVER_SIDE_TEMPLATE_INJECTION", "COMMAND_INJECTION", "CODE_INJECTION", "SQL_INJECTION", "ARBITRARY_FILE_UPLOAD", "INSECURE_DESERIALIZATION", "LOCAL_FILE_INCLUSION", "INFORMATION_DISCLOSURE", "PATH_TRAVERSAL", "SERVER_SIDE_REQUEST_FORGERY", "JSON_WEB_TOKEN_VULNERABILITIES", "XML_EXTERNAL_ENTITY", "FILE_DELETION", "OTHER", "GRAPHQL_VULNERABILITIES", "BUSINESS_LOGIC_VULNERABILITIES", "CRYPTOGRAPHIC_VULNERABILITIES", "DENIAL_OF_SERVICE", "FILE_ACCESS", "FILE_CREATION", "DATABASE_MODIFICATION", "DATABASE_ACCESS", "OUTBOUND_SERVICE_REQUEST", "UNKNOWN"
764
+ # resp.code_review_job_tasks[0].execution_status #=> String, one of "IN_PROGRESS", "ABORTED", "COMPLETED", "INTERNAL_ERROR", "FAILED"
765
+ # resp.code_review_job_tasks[0].logs_location.log_type #=> String, one of "CLOUDWATCH"
766
+ # resp.code_review_job_tasks[0].logs_location.cloud_watch_log.log_group #=> String
767
+ # resp.code_review_job_tasks[0].logs_location.cloud_watch_log.log_stream #=> String
768
+ # resp.code_review_job_tasks[0].created_at #=> Time
769
+ # resp.code_review_job_tasks[0].updated_at #=> Time
770
+ # resp.not_found #=> Array
771
+ # resp.not_found[0] #=> String
772
+ #
773
+ # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/BatchGetCodeReviewJobTasks AWS API Documentation
774
+ #
775
+ # @overload batch_get_code_review_job_tasks(params = {})
776
+ # @param [Hash] params ({})
777
+ def batch_get_code_review_job_tasks(params = {}, options = {})
778
+ req = build_request(:batch_get_code_review_job_tasks, params)
779
+ req.send_request(options)
780
+ end
781
+
782
+ # Retrieves information about one or more code review jobs in an agent
783
+ # space.
784
+ #
785
+ # @option params [required, Array<String>] :code_review_job_ids
786
+ # The list of code review job identifiers to retrieve.
787
+ #
788
+ # @option params [required, String] :agent_space_id
789
+ # The unique identifier of the agent space that contains the code review
790
+ # jobs.
791
+ #
792
+ # @return [Types::BatchGetCodeReviewJobsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
793
+ #
794
+ # * {Types::BatchGetCodeReviewJobsOutput#code_review_jobs #code_review_jobs} => Array&lt;Types::CodeReviewJob&gt;
795
+ # * {Types::BatchGetCodeReviewJobsOutput#not_found #not_found} => Array&lt;String&gt;
796
+ #
797
+ # @example Request syntax with placeholder values
798
+ #
799
+ # resp = client.batch_get_code_review_jobs({
800
+ # code_review_job_ids: ["String"], # required
801
+ # agent_space_id: "String", # required
802
+ # })
803
+ #
804
+ # @example Response structure
805
+ #
806
+ # resp.code_review_jobs #=> Array
807
+ # resp.code_review_jobs[0].code_review_job_id #=> String
808
+ # resp.code_review_jobs[0].code_review_id #=> String
809
+ # resp.code_review_jobs[0].title #=> String
810
+ # resp.code_review_jobs[0].overview #=> String
811
+ # resp.code_review_jobs[0].status #=> String, one of "IN_PROGRESS", "STOPPING", "STOPPED", "FAILED", "COMPLETED"
812
+ # resp.code_review_jobs[0].documents #=> Array
813
+ # resp.code_review_jobs[0].documents[0].s3_location #=> String
814
+ # resp.code_review_jobs[0].documents[0].artifact_id #=> String
815
+ # resp.code_review_jobs[0].source_code #=> Array
816
+ # resp.code_review_jobs[0].source_code[0].s3_location #=> String
817
+ # resp.code_review_jobs[0].steps #=> Array
818
+ # resp.code_review_jobs[0].steps[0].name #=> String, one of "PREFLIGHT", "STATIC_ANALYSIS", "PENTEST", "FINALIZING"
819
+ # resp.code_review_jobs[0].steps[0].status #=> String, one of "NOT_STARTED", "IN_PROGRESS", "COMPLETED", "FAILED", "STOPPED"
820
+ # resp.code_review_jobs[0].steps[0].created_at #=> Time
821
+ # resp.code_review_jobs[0].steps[0].updated_at #=> Time
822
+ # resp.code_review_jobs[0].execution_context #=> Array
823
+ # resp.code_review_jobs[0].execution_context[0].context_type #=> String, one of "ERROR", "CLIENT_ERROR", "WARNING", "INFO"
824
+ # resp.code_review_jobs[0].execution_context[0].context #=> String
825
+ # resp.code_review_jobs[0].execution_context[0].timestamp #=> Time
826
+ # resp.code_review_jobs[0].service_role #=> String
827
+ # resp.code_review_jobs[0].log_config.log_group #=> String
828
+ # resp.code_review_jobs[0].log_config.log_stream #=> String
829
+ # resp.code_review_jobs[0].error_information.code #=> String, one of "CLIENT_ERROR", "INTERNAL_ERROR", "STOPPED_BY_USER"
830
+ # resp.code_review_jobs[0].error_information.message #=> String
831
+ # resp.code_review_jobs[0].integrated_repositories #=> Array
832
+ # resp.code_review_jobs[0].integrated_repositories[0].integration_id #=> String
833
+ # resp.code_review_jobs[0].integrated_repositories[0].provider_resource_id #=> String
834
+ # resp.code_review_jobs[0].code_remediation_strategy #=> String, one of "AUTOMATIC", "DISABLED"
835
+ # resp.code_review_jobs[0].created_at #=> Time
836
+ # resp.code_review_jobs[0].updated_at #=> Time
837
+ # resp.not_found #=> Array
838
+ # resp.not_found[0] #=> String
839
+ #
840
+ # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/BatchGetCodeReviewJobs AWS API Documentation
841
+ #
842
+ # @overload batch_get_code_review_jobs(params = {})
843
+ # @param [Hash] params ({})
844
+ def batch_get_code_review_jobs(params = {}, options = {})
845
+ req = build_request(:batch_get_code_review_jobs, params)
846
+ req.send_request(options)
847
+ end
848
+
849
+ # Retrieves information about one or more code reviews in an agent
850
+ # space.
851
+ #
852
+ # @option params [required, Array<String>] :code_review_ids
853
+ # The list of code review identifiers to retrieve.
854
+ #
855
+ # @option params [required, String] :agent_space_id
856
+ # The unique identifier of the agent space that contains the code
857
+ # reviews.
858
+ #
859
+ # @return [Types::BatchGetCodeReviewsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
860
+ #
861
+ # * {Types::BatchGetCodeReviewsOutput#code_reviews #code_reviews} => Array&lt;Types::CodeReview&gt;
862
+ # * {Types::BatchGetCodeReviewsOutput#not_found #not_found} => Array&lt;String&gt;
863
+ #
864
+ # @example Request syntax with placeholder values
865
+ #
866
+ # resp = client.batch_get_code_reviews({
867
+ # code_review_ids: ["String"], # required
868
+ # agent_space_id: "String", # required
869
+ # })
870
+ #
871
+ # @example Response structure
872
+ #
873
+ # resp.code_reviews #=> Array
874
+ # resp.code_reviews[0].code_review_id #=> String
875
+ # resp.code_reviews[0].agent_space_id #=> String
876
+ # resp.code_reviews[0].title #=> String
877
+ # resp.code_reviews[0].assets.endpoints #=> Array
878
+ # resp.code_reviews[0].assets.endpoints[0].uri #=> String
879
+ # resp.code_reviews[0].assets.actors #=> Array
880
+ # resp.code_reviews[0].assets.actors[0].identifier #=> String
881
+ # resp.code_reviews[0].assets.actors[0].uris #=> Array
882
+ # resp.code_reviews[0].assets.actors[0].uris[0] #=> String
883
+ # resp.code_reviews[0].assets.actors[0].authentication.provider_type #=> String, one of "SECRETS_MANAGER", "AWS_LAMBDA", "AWS_IAM_ROLE", "AWS_INTERNAL"
884
+ # resp.code_reviews[0].assets.actors[0].authentication.value #=> String
885
+ # resp.code_reviews[0].assets.actors[0].description #=> String
886
+ # resp.code_reviews[0].assets.documents #=> Array
887
+ # resp.code_reviews[0].assets.documents[0].s3_location #=> String
888
+ # resp.code_reviews[0].assets.documents[0].artifact_id #=> String
889
+ # resp.code_reviews[0].assets.source_code #=> Array
890
+ # resp.code_reviews[0].assets.source_code[0].s3_location #=> String
891
+ # resp.code_reviews[0].assets.integrated_repositories #=> Array
892
+ # resp.code_reviews[0].assets.integrated_repositories[0].integration_id #=> String
893
+ # resp.code_reviews[0].assets.integrated_repositories[0].provider_resource_id #=> String
894
+ # resp.code_reviews[0].service_role #=> String
895
+ # resp.code_reviews[0].log_config.log_group #=> String
896
+ # resp.code_reviews[0].log_config.log_stream #=> String
897
+ # resp.code_reviews[0].code_remediation_strategy #=> String, one of "AUTOMATIC", "DISABLED"
898
+ # resp.code_reviews[0].created_at #=> Time
899
+ # resp.code_reviews[0].updated_at #=> Time
900
+ # resp.not_found #=> Array
901
+ # resp.not_found[0] #=> String
902
+ #
903
+ # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/BatchGetCodeReviews AWS API Documentation
904
+ #
905
+ # @overload batch_get_code_reviews(params = {})
906
+ # @param [Hash] params ({})
907
+ def batch_get_code_reviews(params = {}, options = {})
908
+ req = build_request(:batch_get_code_reviews, params)
909
+ req.send_request(options)
910
+ end
911
+
912
+ # Retrieves information about one or more security findings in an agent
913
+ # space.
689
914
  #
690
915
  # @option params [required, Array<String>] :finding_ids
691
- # List of finding IDs to retrieve
916
+ # The list of finding identifiers to retrieve.
692
917
  #
693
918
  # @option params [required, String] :agent_space_id
694
- # ID of the agent space where the findings exist
919
+ # The unique identifier of the agent space that contains the findings.
695
920
  #
696
921
  # @return [Types::BatchGetFindingsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
697
922
  #
@@ -712,6 +937,8 @@ module Aws::SecurityAgent
712
937
  # resp.findings[0].agent_space_id #=> String
713
938
  # resp.findings[0].pentest_id #=> String
714
939
  # resp.findings[0].pentest_job_id #=> String
940
+ # resp.findings[0].code_review_id #=> String
941
+ # resp.findings[0].code_review_job_id #=> String
715
942
  # resp.findings[0].task_id #=> String
716
943
  # resp.findings[0].name #=> String
717
944
  # resp.findings[0].description #=> String
@@ -729,6 +956,11 @@ module Aws::SecurityAgent
729
956
  # resp.findings[0].code_remediation_task.task_details[0].code_diff_link #=> String
730
957
  # resp.findings[0].code_remediation_task.task_details[0].pull_request_link #=> String
731
958
  # resp.findings[0].last_updated_by #=> String
959
+ # resp.findings[0].code_locations #=> Array
960
+ # resp.findings[0].code_locations[0].file_path #=> String
961
+ # resp.findings[0].code_locations[0].line_start #=> Integer
962
+ # resp.findings[0].code_locations[0].line_end #=> Integer
963
+ # resp.findings[0].code_locations[0].label #=> String
732
964
  # resp.findings[0].created_at #=> Time
733
965
  # resp.findings[0].updated_at #=> Time
734
966
  # resp.not_found #=> Array
@@ -743,13 +975,13 @@ module Aws::SecurityAgent
743
975
  req.send_request(options)
744
976
  end
745
977
 
746
- # Retrieves multiple tasks for a pentest job in a single request
978
+ # Retrieves information about one or more tasks within a pentest job.
747
979
  #
748
980
  # @option params [required, String] :agent_space_id
749
- # ID of the agent space where the pentest exists
981
+ # The unique identifier of the agent space that contains the tasks.
750
982
  #
751
983
  # @option params [required, Array<String>] :task_ids
752
- # List of task IDs to retrieve
984
+ # The list of task identifiers to retrieve.
753
985
  #
754
986
  # @return [Types::BatchGetPentestJobTasksOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
755
987
  #
@@ -795,13 +1027,15 @@ module Aws::SecurityAgent
795
1027
  req.send_request(options)
796
1028
  end
797
1029
 
798
- # Retrieves multiple pentest jobs in a single request
1030
+ # Retrieves information about one or more pentest jobs in an agent
1031
+ # space.
799
1032
  #
800
1033
  # @option params [required, Array<String>] :pentest_job_ids
801
- # List of pentest job IDs to retrieve
1034
+ # The list of pentest job identifiers to retrieve.
802
1035
  #
803
1036
  # @option params [required, String] :agent_space_id
804
- # ID of the agent space where the pentest exists
1037
+ # The unique identifier of the agent space that contains the pentest
1038
+ # jobs.
805
1039
  #
806
1040
  # @return [Types::BatchGetPentestJobsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
807
1041
  #
@@ -887,13 +1121,13 @@ module Aws::SecurityAgent
887
1121
  req.send_request(options)
888
1122
  end
889
1123
 
890
- # Retrieves multiple pentests in a single request
1124
+ # Retrieves information about one or more pentests in an agent space.
891
1125
  #
892
1126
  # @option params [required, Array<String>] :pentest_ids
893
- # List of pentest IDs to retrieve
1127
+ # The list of pentest identifiers to retrieve.
894
1128
  #
895
1129
  # @option params [required, String] :agent_space_id
896
- # ID of the agent space where the pentest exists
1130
+ # The unique identifier of the agent space that contains the pentests.
897
1131
  #
898
1132
  # @return [Types::BatchGetPentestsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
899
1133
  #
@@ -962,10 +1196,10 @@ module Aws::SecurityAgent
962
1196
  req.send_request(options)
963
1197
  end
964
1198
 
965
- # Retrieves multiple target domains in a single request
1199
+ # Retrieves information about one or more target domains.
966
1200
  #
967
1201
  # @option params [required, Array<String>] :target_domain_ids
968
- # List of target domain IDs to retrieve
1202
+ # The list of target domain identifiers to retrieve.
969
1203
  #
970
1204
  # @return [Types::BatchGetTargetDomainsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
971
1205
  #
@@ -984,7 +1218,8 @@ module Aws::SecurityAgent
984
1218
  # resp.target_domains[0].target_domain_id #=> String
985
1219
  # resp.target_domains[0].domain_name #=> String
986
1220
  # resp.target_domains[0].verification_status #=> String, one of "PENDING", "VERIFIED", "FAILED", "UNREACHABLE"
987
- # resp.target_domains[0].verification_details.method #=> String, one of "DNS_TXT", "HTTP_ROUTE"
1221
+ # resp.target_domains[0].verification_status_reason #=> String
1222
+ # resp.target_domains[0].verification_details.method #=> String, one of "DNS_TXT", "HTTP_ROUTE", "PRIVATE_VPC"
988
1223
  # resp.target_domains[0].verification_details.dns_txt.token #=> String
989
1224
  # resp.target_domains[0].verification_details.dns_txt.dns_record_name #=> String
990
1225
  # resp.target_domains[0].verification_details.dns_txt.dns_record_type #=> String, one of "TXT"
@@ -1004,31 +1239,31 @@ module Aws::SecurityAgent
1004
1239
  req.send_request(options)
1005
1240
  end
1006
1241
 
1007
- # Creates an agent space record
1242
+ # Creates a new agent space. An agent space is a dedicated workspace for
1243
+ # securing a specific application.
1008
1244
  #
1009
1245
  # @option params [required, String] :name
1010
- # Name of the agent space
1246
+ # The name of the agent space.
1011
1247
  #
1012
1248
  # @option params [String] :description
1013
- # Description of the agent space
1249
+ # A description of the agent space.
1014
1250
  #
1015
1251
  # @option params [Types::AWSResources] :aws_resources
1016
- # AWS resource configurations associated with the agent space
1252
+ # The AWS resources to associate with the agent space.
1017
1253
  #
1018
1254
  # @option params [Array<String>] :target_domain_ids
1019
- # Target domain IDs to associate with the agent space
1255
+ # The list of target domain identifiers to associate with the agent
1256
+ # space.
1020
1257
  #
1021
1258
  # @option params [Types::CodeReviewSettings] :code_review_settings
1022
- # Configuration for code review analysis, including controls scanning
1023
- # and general purpose scanning settings
1259
+ # The code review settings for the agent space.
1024
1260
  #
1025
1261
  # @option params [String] :kms_key_id
1026
- # Identifier of the KMS key used to encrypt data. Can be a key ID, key
1027
- # ARN, alias name, or alias ARN. If not specified, an AWS managed key is
1028
- # used.
1262
+ # The identifier of the AWS KMS key to use for encrypting data in the
1263
+ # agent space.
1029
1264
  #
1030
1265
  # @option params [Hash<String,String>] :tags
1031
- # Tags to associate with the agent space
1266
+ # The tags to associate with the agent space.
1032
1267
  #
1033
1268
  # @return [Types::CreateAgentSpaceOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1034
1269
  #
@@ -1110,21 +1345,23 @@ module Aws::SecurityAgent
1110
1345
  req.send_request(options)
1111
1346
  end
1112
1347
 
1113
- # Creates a new application
1348
+ # Creates a new application. An application is the top-level
1349
+ # organizational unit that supports IAM Identity Center integration.
1114
1350
  #
1115
1351
  # @option params [String] :idc_instance_arn
1116
- # ARN of the IAM Identity Center instance used for user authentication.
1117
- # Optional for non-IdC applications
1352
+ # The Amazon Resource Name (ARN) of the IAM Identity Center instance to
1353
+ # associate with the application.
1118
1354
  #
1119
1355
  # @option params [String] :role_arn
1120
- # ARN of the IAM role that the application uses to access AWS resources
1121
- # on your behalf
1356
+ # The Amazon Resource Name (ARN) of the IAM role to associate with the
1357
+ # application.
1122
1358
  #
1123
1359
  # @option params [String] :default_kms_key_id
1124
- # Default KMS key identifier used to encrypt application data
1360
+ # The identifier of the default AWS KMS key to use for encrypting data
1361
+ # in the application.
1125
1362
  #
1126
1363
  # @option params [Hash<String,String>] :tags
1127
- # Tags to associate with the application
1364
+ # The tags to associate with the application.
1128
1365
  #
1129
1366
  # @return [Types::CreateApplicationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1130
1367
  #
@@ -1154,23 +1391,146 @@ module Aws::SecurityAgent
1154
1391
  req.send_request(options)
1155
1392
  end
1156
1393
 
1157
- # Creates the Integration of the Security Agent App with an external
1158
- # Provider
1394
+ # Creates a new code review configuration in an agent space. A code
1395
+ # review defines the parameters for automated security-focused code
1396
+ # analysis.
1397
+ #
1398
+ # @option params [required, String] :title
1399
+ # The title of the code review.
1400
+ #
1401
+ # @option params [required, String] :agent_space_id
1402
+ # The unique identifier of the agent space to create the code review in.
1403
+ #
1404
+ # @option params [required, Types::Assets] :assets
1405
+ # The assets to include in the code review, such as documents and source
1406
+ # code.
1407
+ #
1408
+ # @option params [String] :service_role
1409
+ # The IAM service role to use for the code review.
1410
+ #
1411
+ # @option params [Types::CloudWatchLog] :log_config
1412
+ # The CloudWatch Logs configuration for the code review.
1413
+ #
1414
+ # @option params [String] :code_remediation_strategy
1415
+ # The code remediation strategy for the code review. Valid values are
1416
+ # AUTOMATIC and DISABLED.
1417
+ #
1418
+ # @return [Types::CreateCodeReviewOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1419
+ #
1420
+ # * {Types::CreateCodeReviewOutput#code_review_id #code_review_id} => String
1421
+ # * {Types::CreateCodeReviewOutput#title #title} => String
1422
+ # * {Types::CreateCodeReviewOutput#created_at #created_at} => Time
1423
+ # * {Types::CreateCodeReviewOutput#updated_at #updated_at} => Time
1424
+ # * {Types::CreateCodeReviewOutput#assets #assets} => Types::Assets
1425
+ # * {Types::CreateCodeReviewOutput#service_role #service_role} => String
1426
+ # * {Types::CreateCodeReviewOutput#log_config #log_config} => Types::CloudWatchLog
1427
+ # * {Types::CreateCodeReviewOutput#agent_space_id #agent_space_id} => String
1428
+ # * {Types::CreateCodeReviewOutput#code_remediation_strategy #code_remediation_strategy} => String
1429
+ #
1430
+ # @example Request syntax with placeholder values
1431
+ #
1432
+ # resp = client.create_code_review({
1433
+ # title: "String", # required
1434
+ # agent_space_id: "String", # required
1435
+ # assets: { # required
1436
+ # endpoints: [
1437
+ # {
1438
+ # uri: "String",
1439
+ # },
1440
+ # ],
1441
+ # actors: [
1442
+ # {
1443
+ # identifier: "String",
1444
+ # uris: ["String"],
1445
+ # authentication: {
1446
+ # provider_type: "SECRETS_MANAGER", # accepts SECRETS_MANAGER, AWS_LAMBDA, AWS_IAM_ROLE, AWS_INTERNAL
1447
+ # value: "String",
1448
+ # },
1449
+ # description: "String",
1450
+ # },
1451
+ # ],
1452
+ # documents: [
1453
+ # {
1454
+ # s3_location: "String",
1455
+ # artifact_id: "String",
1456
+ # },
1457
+ # ],
1458
+ # source_code: [
1459
+ # {
1460
+ # s3_location: "String",
1461
+ # },
1462
+ # ],
1463
+ # integrated_repositories: [
1464
+ # {
1465
+ # integration_id: "String", # required
1466
+ # provider_resource_id: "String", # required
1467
+ # },
1468
+ # ],
1469
+ # },
1470
+ # service_role: "ServiceRole",
1471
+ # log_config: {
1472
+ # log_group: "String",
1473
+ # log_stream: "String",
1474
+ # },
1475
+ # code_remediation_strategy: "AUTOMATIC", # accepts AUTOMATIC, DISABLED
1476
+ # })
1477
+ #
1478
+ # @example Response structure
1479
+ #
1480
+ # resp.code_review_id #=> String
1481
+ # resp.title #=> String
1482
+ # resp.created_at #=> Time
1483
+ # resp.updated_at #=> Time
1484
+ # resp.assets.endpoints #=> Array
1485
+ # resp.assets.endpoints[0].uri #=> String
1486
+ # resp.assets.actors #=> Array
1487
+ # resp.assets.actors[0].identifier #=> String
1488
+ # resp.assets.actors[0].uris #=> Array
1489
+ # resp.assets.actors[0].uris[0] #=> String
1490
+ # resp.assets.actors[0].authentication.provider_type #=> String, one of "SECRETS_MANAGER", "AWS_LAMBDA", "AWS_IAM_ROLE", "AWS_INTERNAL"
1491
+ # resp.assets.actors[0].authentication.value #=> String
1492
+ # resp.assets.actors[0].description #=> String
1493
+ # resp.assets.documents #=> Array
1494
+ # resp.assets.documents[0].s3_location #=> String
1495
+ # resp.assets.documents[0].artifact_id #=> String
1496
+ # resp.assets.source_code #=> Array
1497
+ # resp.assets.source_code[0].s3_location #=> String
1498
+ # resp.assets.integrated_repositories #=> Array
1499
+ # resp.assets.integrated_repositories[0].integration_id #=> String
1500
+ # resp.assets.integrated_repositories[0].provider_resource_id #=> String
1501
+ # resp.service_role #=> String
1502
+ # resp.log_config.log_group #=> String
1503
+ # resp.log_config.log_stream #=> String
1504
+ # resp.agent_space_id #=> String
1505
+ # resp.code_remediation_strategy #=> String, one of "AUTOMATIC", "DISABLED"
1506
+ #
1507
+ # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/CreateCodeReview AWS API Documentation
1508
+ #
1509
+ # @overload create_code_review(params = {})
1510
+ # @param [Hash] params ({})
1511
+ def create_code_review(params = {}, options = {})
1512
+ req = build_request(:create_code_review, params)
1513
+ req.send_request(options)
1514
+ end
1515
+
1516
+ # Creates a new integration with a third-party provider, such as GitHub,
1517
+ # for code review and remediation.
1159
1518
  #
1160
1519
  # @option params [required, String] :provider
1161
- # Provider to integrate with
1520
+ # The integration provider. Currently, only GITHUB is supported.
1162
1521
  #
1163
1522
  # @option params [required, Types::ProviderInput] :input
1164
- # Provider-specific input parameters
1523
+ # The provider-specific input required to create the integration.
1165
1524
  #
1166
1525
  # @option params [required, String] :integration_display_name
1167
- # Display name for the integration
1526
+ # The display name for the integration.
1168
1527
  #
1169
1528
  # @option params [String] :kms_key_id
1170
- # KMS key ID for encrypting integration details
1529
+ # The identifier of the AWS KMS key to use for encrypting data
1530
+ # associated with the integration.
1171
1531
  #
1172
1532
  # @option params [Hash<String,String>] :tags
1173
- # Tags to associate with the integration
1533
+ # The tags to associate with the integration.
1174
1534
  #
1175
1535
  # @return [Types::CreateIntegrationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1176
1536
  #
@@ -1207,22 +1567,24 @@ module Aws::SecurityAgent
1207
1567
  req.send_request(options)
1208
1568
  end
1209
1569
 
1210
- # Adds a single member to an agent space with specified role
1570
+ # Creates a new membership, granting a user access to an agent space
1571
+ # within an application.
1211
1572
  #
1212
1573
  # @option params [required, String] :application_id
1213
- # Application identifier
1574
+ # The unique identifier of the application that contains the agent
1575
+ # space.
1214
1576
  #
1215
1577
  # @option params [required, String] :agent_space_id
1216
- # Agent space identifier
1578
+ # The unique identifier of the agent space to grant access to.
1217
1579
  #
1218
1580
  # @option params [required, String] :membership_id
1219
- # Member identifier (userId or agentSpaceId)
1581
+ # The unique identifier for the membership.
1220
1582
  #
1221
1583
  # @option params [required, String] :member_type
1222
- # Type of member (USER or AGENT\_SPACE)
1584
+ # The type of member. Currently, only USER is supported.
1223
1585
  #
1224
1586
  # @option params [Types::MembershipConfig] :config
1225
- # Membership details (user or agent specific)
1587
+ # The configuration for the membership, such as the user role.
1226
1588
  #
1227
1589
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1228
1590
  #
@@ -1249,35 +1611,39 @@ module Aws::SecurityAgent
1249
1611
  req.send_request(options)
1250
1612
  end
1251
1613
 
1252
- # Creates a new pentest configuration
1614
+ # Creates a new pentest configuration in an agent space. A pentest
1615
+ # defines the security test parameters, including target assets, risk
1616
+ # type exclusions, and logging configuration.
1253
1617
  #
1254
1618
  # @option params [required, String] :title
1255
- # Title of the pentest
1619
+ # The title of the pentest.
1256
1620
  #
1257
1621
  # @option params [required, String] :agent_space_id
1258
- # ID of the agent space where the pentest should be created
1622
+ # The unique identifier of the agent space to create the pentest in.
1259
1623
  #
1260
1624
  # @option params [Types::Assets] :assets
1261
- # Assets to be tested during the pentest
1625
+ # The assets to include in the pentest, such as endpoints, actors,
1626
+ # documents, and source code.
1262
1627
  #
1263
1628
  # @option params [Array<String>] :exclude_risk_types
1264
- # A list of risk types excluded from the pentest execution
1629
+ # The list of risk types to exclude from the pentest.
1265
1630
  #
1266
1631
  # @option params [String] :service_role
1267
- # Service role ARN for accessing customer resources
1632
+ # The IAM service role to use for the pentest.
1268
1633
  #
1269
1634
  # @option params [Types::CloudWatchLog] :log_config
1270
- # CloudWatch log group and stream prefix where pentest execution logs
1271
- # are stored
1635
+ # The CloudWatch Logs configuration for the pentest.
1272
1636
  #
1273
1637
  # @option params [Types::VpcConfig] :vpc_config
1274
- # VPC configuration that the Security Agent accesses
1638
+ # The VPC configuration for the pentest.
1275
1639
  #
1276
1640
  # @option params [Types::NetworkTrafficConfig] :network_traffic_config
1277
- # Configuration for network traffic filtering
1641
+ # The network traffic configuration for the pentest, including custom
1642
+ # headers and traffic rules.
1278
1643
  #
1279
1644
  # @option params [String] :code_remediation_strategy
1280
- # Strategy for code remediation on findings
1645
+ # The code remediation strategy for the pentest. Valid values are
1646
+ # AUTOMATIC and DISABLED.
1281
1647
  #
1282
1648
  # @return [Types::CreatePentestOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1283
1649
  #
@@ -1399,22 +1765,26 @@ module Aws::SecurityAgent
1399
1765
  req.send_request(options)
1400
1766
  end
1401
1767
 
1402
- # Creates a target domain record
1768
+ # Creates a new target domain for penetration testing. A target domain
1769
+ # is a web domain that must be registered and verified before it can be
1770
+ # tested.
1403
1771
  #
1404
1772
  # @option params [required, String] :target_domain_name
1405
- # Domain name of the target domain
1773
+ # The domain name to register as a target domain.
1406
1774
  #
1407
1775
  # @option params [required, String] :verification_method
1408
- # Verification method for the target domain
1776
+ # The method to use for verifying domain ownership. Valid values are
1777
+ # DNS\_TXT, HTTP\_ROUTE, and PRIVATE\_VPC.
1409
1778
  #
1410
1779
  # @option params [Hash<String,String>] :tags
1411
- # Tags to associate with the target domain
1780
+ # The tags to associate with the target domain.
1412
1781
  #
1413
1782
  # @return [Types::CreateTargetDomainOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1414
1783
  #
1415
1784
  # * {Types::CreateTargetDomainOutput#target_domain_id #target_domain_id} => String
1416
1785
  # * {Types::CreateTargetDomainOutput#domain_name #domain_name} => String
1417
1786
  # * {Types::CreateTargetDomainOutput#verification_status #verification_status} => String
1787
+ # * {Types::CreateTargetDomainOutput#verification_status_reason #verification_status_reason} => String
1418
1788
  # * {Types::CreateTargetDomainOutput#verification_details #verification_details} => Types::VerificationDetails
1419
1789
  # * {Types::CreateTargetDomainOutput#created_at #created_at} => Time
1420
1790
  # * {Types::CreateTargetDomainOutput#verified_at #verified_at} => Time
@@ -1423,7 +1793,7 @@ module Aws::SecurityAgent
1423
1793
  #
1424
1794
  # resp = client.create_target_domain({
1425
1795
  # target_domain_name: "String", # required
1426
- # verification_method: "DNS_TXT", # required, accepts DNS_TXT, HTTP_ROUTE
1796
+ # verification_method: "DNS_TXT", # required, accepts DNS_TXT, HTTP_ROUTE, PRIVATE_VPC
1427
1797
  # tags: {
1428
1798
  # "TagKey" => "TagValue",
1429
1799
  # },
@@ -1434,7 +1804,8 @@ module Aws::SecurityAgent
1434
1804
  # resp.target_domain_id #=> String
1435
1805
  # resp.domain_name #=> String
1436
1806
  # resp.verification_status #=> String, one of "PENDING", "VERIFIED", "FAILED", "UNREACHABLE"
1437
- # resp.verification_details.method #=> String, one of "DNS_TXT", "HTTP_ROUTE"
1807
+ # resp.verification_status_reason #=> String
1808
+ # resp.verification_details.method #=> String, one of "DNS_TXT", "HTTP_ROUTE", "PRIVATE_VPC"
1438
1809
  # resp.verification_details.dns_txt.token #=> String
1439
1810
  # resp.verification_details.dns_txt.dns_record_name #=> String
1440
1811
  # resp.verification_details.dns_txt.dns_record_type #=> String, one of "TXT"
@@ -1452,10 +1823,11 @@ module Aws::SecurityAgent
1452
1823
  req.send_request(options)
1453
1824
  end
1454
1825
 
1455
- # Deletes an agent space record
1826
+ # Deletes an agent space and all of its associated resources, including
1827
+ # pentests, findings, and artifacts.
1456
1828
  #
1457
1829
  # @option params [required, String] :agent_space_id
1458
- # Unique identifier of the agent space to delete
1830
+ # The unique identifier of the agent space to delete.
1459
1831
  #
1460
1832
  # @return [Types::DeleteAgentSpaceOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1461
1833
  #
@@ -1480,10 +1852,11 @@ module Aws::SecurityAgent
1480
1852
  req.send_request(options)
1481
1853
  end
1482
1854
 
1483
- # Deletes an application
1855
+ # Deletes an application and its associated configuration, including IAM
1856
+ # Identity Center settings.
1484
1857
  #
1485
1858
  # @option params [required, String] :application_id
1486
- # Application ID
1859
+ # The unique identifier of the application to delete.
1487
1860
  #
1488
1861
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1489
1862
  #
@@ -1502,13 +1875,13 @@ module Aws::SecurityAgent
1502
1875
  req.send_request(options)
1503
1876
  end
1504
1877
 
1505
- # Delete an Artifact from the given agent space
1878
+ # Deletes an artifact from an agent space.
1506
1879
  #
1507
1880
  # @option params [required, String] :agent_space_id
1508
- # Unique identifier of the agent space
1881
+ # The unique identifier of the agent space that contains the artifact.
1509
1882
  #
1510
1883
  # @option params [required, String] :artifact_id
1511
- # Unique identifier of the artifact
1884
+ # The unique identifier of the artifact to delete.
1512
1885
  #
1513
1886
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1514
1887
  #
@@ -1528,11 +1901,10 @@ module Aws::SecurityAgent
1528
1901
  req.send_request(options)
1529
1902
  end
1530
1903
 
1531
- # Deletes the Integration of the Security Agent App with an external
1532
- # Provider
1904
+ # Deletes an integration with a third-party provider.
1533
1905
  #
1534
1906
  # @option params [required, String] :integration_id
1535
- # Unique identifier of the integration
1907
+ # The unique identifier of the integration to delete.
1536
1908
  #
1537
1909
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1538
1910
  #
@@ -1551,19 +1923,20 @@ module Aws::SecurityAgent
1551
1923
  req.send_request(options)
1552
1924
  end
1553
1925
 
1554
- # Removes a single member associated to an agent space
1926
+ # Deletes a membership, revoking a user's access to an agent space.
1555
1927
  #
1556
1928
  # @option params [required, String] :application_id
1557
- # Application identifier
1929
+ # The unique identifier of the application that contains the agent
1930
+ # space.
1558
1931
  #
1559
1932
  # @option params [required, String] :agent_space_id
1560
- # Agent space identifier
1933
+ # The unique identifier of the agent space to revoke access from.
1561
1934
  #
1562
1935
  # @option params [required, String] :membership_id
1563
- # Member identifier (userId or agentSpaceId)
1936
+ # The unique identifier of the membership to delete.
1564
1937
  #
1565
1938
  # @option params [String] :member_type
1566
- # Type of member (USER or AGENT\_SPACE)
1939
+ # The type of member to remove.
1567
1940
  #
1568
1941
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1569
1942
  #
@@ -1585,10 +1958,11 @@ module Aws::SecurityAgent
1585
1958
  req.send_request(options)
1586
1959
  end
1587
1960
 
1588
- # Deletes a target domain record
1961
+ # Deletes a target domain registration. After deletion, the domain can
1962
+ # no longer be used for penetration testing.
1589
1963
  #
1590
1964
  # @option params [required, String] :target_domain_id
1591
- # Unique identifier of the target domain to delete
1965
+ # The unique identifier of the target domain to delete.
1592
1966
  #
1593
1967
  # @return [Types::DeleteTargetDomainOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1594
1968
  #
@@ -1613,10 +1987,10 @@ module Aws::SecurityAgent
1613
1987
  req.send_request(options)
1614
1988
  end
1615
1989
 
1616
- # Retrieves application details by application ID
1990
+ # Retrieves information about an application.
1617
1991
  #
1618
1992
  # @option params [required, String] :application_id
1619
- # Application ID
1993
+ # The unique identifier of the application to retrieve.
1620
1994
  #
1621
1995
  # @return [Types::GetApplicationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1622
1996
  #
@@ -1652,13 +2026,13 @@ module Aws::SecurityAgent
1652
2026
  req.send_request(options)
1653
2027
  end
1654
2028
 
1655
- # Retrieve an Artifact for the given agent space
2029
+ # Retrieves an artifact from an agent space.
1656
2030
  #
1657
2031
  # @option params [required, String] :agent_space_id
1658
- # Unique identifier of the agent space
2032
+ # The unique identifier of the agent space that contains the artifact.
1659
2033
  #
1660
2034
  # @option params [required, String] :artifact_id
1661
- # Unique identifier of the artifact
2035
+ # The unique identifier of the artifact to retrieve.
1662
2036
  #
1663
2037
  # @return [Types::GetArtifactOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1664
2038
  #
@@ -1693,10 +2067,10 @@ module Aws::SecurityAgent
1693
2067
  req.send_request(options)
1694
2068
  end
1695
2069
 
1696
- # Gets Integration metadata from the provided id
2070
+ # Retrieves information about an integration.
1697
2071
  #
1698
2072
  # @option params [required, String] :integration_id
1699
- # Unique identifier of the integration
2073
+ # The unique identifier of the integration to retrieve.
1700
2074
  #
1701
2075
  # @return [Types::GetIntegrationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1702
2076
  #
@@ -1731,11 +2105,13 @@ module Aws::SecurityAgent
1731
2105
  req.send_request(options)
1732
2106
  end
1733
2107
 
1734
- # Initiates the registration of Security Agent App for an external
1735
- # Provider
2108
+ # Initiates the OAuth registration flow with a third-party provider.
2109
+ # Returns a redirect URL and CSRF state token for completing the
2110
+ # authorization.
1736
2111
  #
1737
2112
  # @option params [required, String] :provider
1738
- # Provider to register with
2113
+ # The provider to initiate registration with. Currently, only GITHUB is
2114
+ # supported.
1739
2115
  #
1740
2116
  # @return [Types::InitiateProviderRegistrationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1741
2117
  #
@@ -1762,13 +2138,16 @@ module Aws::SecurityAgent
1762
2138
  req.send_request(options)
1763
2139
  end
1764
2140
 
1765
- # Lists agent spaces
2141
+ # Returns a paginated list of agent space summaries in your account.
1766
2142
  #
1767
2143
  # @option params [String] :next_token
1768
- # Token for pagination
2144
+ # A token to use for paginating results that are returned in the
2145
+ # response. Set the value of this parameter to null for the first
2146
+ # request. For subsequent calls, use the nextToken value returned from
2147
+ # the previous request.
1769
2148
  #
1770
2149
  # @option params [Integer] :max_results
1771
- # Maximum number of agent spaces to return
2150
+ # The maximum number of results to return in a single call.
1772
2151
  #
1773
2152
  # @return [Types::ListAgentSpacesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1774
2153
  #
@@ -1802,13 +2181,16 @@ module Aws::SecurityAgent
1802
2181
  req.send_request(options)
1803
2182
  end
1804
2183
 
1805
- # Lists all applications in the account
2184
+ # Returns a paginated list of application summaries in your account.
1806
2185
  #
1807
2186
  # @option params [String] :next_token
1808
- # Token for pagination
2187
+ # A token to use for paginating results that are returned in the
2188
+ # response. Set the value of this parameter to null for the first
2189
+ # request. For subsequent calls, use the nextToken value returned from
2190
+ # the previous request.
1809
2191
  #
1810
2192
  # @option params [Integer] :max_results
1811
- # Maximum number of results to return
2193
+ # The maximum number of results to return in a single call.
1812
2194
  #
1813
2195
  # @return [Types::ListApplicationsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1814
2196
  #
@@ -1842,16 +2224,20 @@ module Aws::SecurityAgent
1842
2224
  req.send_request(options)
1843
2225
  end
1844
2226
 
1845
- # Lists the artifacts for the associated agent space
2227
+ # Returns a paginated list of artifact summaries for the specified agent
2228
+ # space.
1846
2229
  #
1847
2230
  # @option params [required, String] :agent_space_id
1848
- # Unique identifier of the agent space
2231
+ # The unique identifier of the agent space to list artifacts for.
1849
2232
  #
1850
2233
  # @option params [String] :next_token
1851
- # Token for pagination
2234
+ # A token to use for paginating results that are returned in the
2235
+ # response. Set the value of this parameter to null for the first
2236
+ # request. For subsequent calls, use the nextToken value returned from
2237
+ # the previous request.
1852
2238
  #
1853
2239
  # @option params [Integer] :max_results
1854
- # Maximum number of results to return
2240
+ # The maximum number of results to return in a single call.
1855
2241
  #
1856
2242
  # @return [Types::ListArtifactsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1857
2243
  #
@@ -1885,25 +2271,195 @@ module Aws::SecurityAgent
1885
2271
  req.send_request(options)
1886
2272
  end
1887
2273
 
1888
- # Lists discovered endpoints associated with a pentest job with optional
1889
- # URI prefix filtering
2274
+ # Returns a paginated list of task summaries for the specified code
2275
+ # review job, optionally filtered by step name or category.
2276
+ #
2277
+ # @option params [required, String] :agent_space_id
2278
+ # The unique identifier of the agent space.
2279
+ #
2280
+ # @option params [Integer] :max_results
2281
+ # The maximum number of results to return in a single call.
2282
+ #
2283
+ # @option params [String] :code_review_job_id
2284
+ # The unique identifier of the code review job to list tasks for.
2285
+ #
2286
+ # @option params [String] :step_name
2287
+ # Filter tasks by step name.
2288
+ #
2289
+ # @option params [String] :category_name
2290
+ # Filter tasks by category name.
2291
+ #
2292
+ # @option params [String] :next_token
2293
+ # A token to use for paginating results that are returned in the
2294
+ # response. Set the value of this parameter to null for the first
2295
+ # request. For subsequent calls, use the nextToken value returned from
2296
+ # the previous request.
2297
+ #
2298
+ # @return [Types::ListCodeReviewJobTasksOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2299
+ #
2300
+ # * {Types::ListCodeReviewJobTasksOutput#code_review_job_task_summaries #code_review_job_task_summaries} => Array&lt;Types::CodeReviewJobTaskSummary&gt;
2301
+ # * {Types::ListCodeReviewJobTasksOutput#next_token #next_token} => String
2302
+ #
2303
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2304
+ #
2305
+ # @example Request syntax with placeholder values
2306
+ #
2307
+ # resp = client.list_code_review_job_tasks({
2308
+ # agent_space_id: "String", # required
2309
+ # max_results: 1,
2310
+ # code_review_job_id: "String",
2311
+ # step_name: "PREFLIGHT", # accepts PREFLIGHT, STATIC_ANALYSIS, PENTEST, FINALIZING
2312
+ # category_name: "String",
2313
+ # next_token: "NextToken",
2314
+ # })
2315
+ #
2316
+ # @example Response structure
2317
+ #
2318
+ # resp.code_review_job_task_summaries #=> Array
2319
+ # resp.code_review_job_task_summaries[0].task_id #=> String
2320
+ # resp.code_review_job_task_summaries[0].code_review_id #=> String
2321
+ # resp.code_review_job_task_summaries[0].code_review_job_id #=> String
2322
+ # resp.code_review_job_task_summaries[0].agent_space_id #=> String
2323
+ # resp.code_review_job_task_summaries[0].title #=> String
2324
+ # resp.code_review_job_task_summaries[0].risk_type #=> String, one of "CROSS_SITE_SCRIPTING", "DEFAULT_CREDENTIALS", "INSECURE_DIRECT_OBJECT_REFERENCE", "PRIVILEGE_ESCALATION", "SERVER_SIDE_TEMPLATE_INJECTION", "COMMAND_INJECTION", "CODE_INJECTION", "SQL_INJECTION", "ARBITRARY_FILE_UPLOAD", "INSECURE_DESERIALIZATION", "LOCAL_FILE_INCLUSION", "INFORMATION_DISCLOSURE", "PATH_TRAVERSAL", "SERVER_SIDE_REQUEST_FORGERY", "JSON_WEB_TOKEN_VULNERABILITIES", "XML_EXTERNAL_ENTITY", "FILE_DELETION", "OTHER", "GRAPHQL_VULNERABILITIES", "BUSINESS_LOGIC_VULNERABILITIES", "CRYPTOGRAPHIC_VULNERABILITIES", "DENIAL_OF_SERVICE", "FILE_ACCESS", "FILE_CREATION", "DATABASE_MODIFICATION", "DATABASE_ACCESS", "OUTBOUND_SERVICE_REQUEST", "UNKNOWN"
2325
+ # resp.code_review_job_task_summaries[0].execution_status #=> String, one of "IN_PROGRESS", "ABORTED", "COMPLETED", "INTERNAL_ERROR", "FAILED"
2326
+ # resp.code_review_job_task_summaries[0].created_at #=> Time
2327
+ # resp.code_review_job_task_summaries[0].updated_at #=> Time
2328
+ # resp.next_token #=> String
2329
+ #
2330
+ # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/ListCodeReviewJobTasks AWS API Documentation
2331
+ #
2332
+ # @overload list_code_review_job_tasks(params = {})
2333
+ # @param [Hash] params ({})
2334
+ def list_code_review_job_tasks(params = {}, options = {})
2335
+ req = build_request(:list_code_review_job_tasks, params)
2336
+ req.send_request(options)
2337
+ end
2338
+
2339
+ # Returns a paginated list of code review job summaries for the
2340
+ # specified code review configuration.
2341
+ #
2342
+ # @option params [Integer] :max_results
2343
+ # The maximum number of results to return in a single call.
2344
+ #
2345
+ # @option params [required, String] :code_review_id
2346
+ # The unique identifier of the code review to list jobs for.
2347
+ #
2348
+ # @option params [required, String] :agent_space_id
2349
+ # The unique identifier of the agent space.
2350
+ #
2351
+ # @option params [String] :next_token
2352
+ # A token to use for paginating results that are returned in the
2353
+ # response. Set the value of this parameter to null for the first
2354
+ # request. For subsequent calls, use the nextToken value returned from
2355
+ # the previous request.
2356
+ #
2357
+ # @return [Types::ListCodeReviewJobsForCodeReviewOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2358
+ #
2359
+ # * {Types::ListCodeReviewJobsForCodeReviewOutput#code_review_job_summaries #code_review_job_summaries} => Array&lt;Types::CodeReviewJobSummary&gt;
2360
+ # * {Types::ListCodeReviewJobsForCodeReviewOutput#next_token #next_token} => String
2361
+ #
2362
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2363
+ #
2364
+ # @example Request syntax with placeholder values
2365
+ #
2366
+ # resp = client.list_code_review_jobs_for_code_review({
2367
+ # max_results: 1,
2368
+ # code_review_id: "String", # required
2369
+ # agent_space_id: "String", # required
2370
+ # next_token: "NextToken",
2371
+ # })
2372
+ #
2373
+ # @example Response structure
2374
+ #
2375
+ # resp.code_review_job_summaries #=> Array
2376
+ # resp.code_review_job_summaries[0].code_review_job_id #=> String
2377
+ # resp.code_review_job_summaries[0].code_review_id #=> String
2378
+ # resp.code_review_job_summaries[0].title #=> String
2379
+ # resp.code_review_job_summaries[0].status #=> String, one of "IN_PROGRESS", "STOPPING", "STOPPED", "FAILED", "COMPLETED"
2380
+ # resp.code_review_job_summaries[0].created_at #=> Time
2381
+ # resp.code_review_job_summaries[0].updated_at #=> Time
2382
+ # resp.next_token #=> String
2383
+ #
2384
+ # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/ListCodeReviewJobsForCodeReview AWS API Documentation
2385
+ #
2386
+ # @overload list_code_review_jobs_for_code_review(params = {})
2387
+ # @param [Hash] params ({})
2388
+ def list_code_review_jobs_for_code_review(params = {}, options = {})
2389
+ req = build_request(:list_code_review_jobs_for_code_review, params)
2390
+ req.send_request(options)
2391
+ end
2392
+
2393
+ # Returns a paginated list of code review summaries for the specified
2394
+ # agent space.
1890
2395
  #
1891
2396
  # @option params [Integer] :max_results
1892
- # Maximum number of discovered endpoints to return in a single request
1893
- # (default: 50)
2397
+ # The maximum number of results to return in a single call.
2398
+ #
2399
+ # @option params [String] :next_token
2400
+ # A token to use for paginating results that are returned in the
2401
+ # response. Set the value of this parameter to null for the first
2402
+ # request. For subsequent calls, use the nextToken value returned from
2403
+ # the previous request.
2404
+ #
2405
+ # @option params [required, String] :agent_space_id
2406
+ # The unique identifier of the agent space to list code reviews for.
2407
+ #
2408
+ # @return [Types::ListCodeReviewsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2409
+ #
2410
+ # * {Types::ListCodeReviewsOutput#code_review_summaries #code_review_summaries} => Array&lt;Types::CodeReviewSummary&gt;
2411
+ # * {Types::ListCodeReviewsOutput#next_token #next_token} => String
2412
+ #
2413
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2414
+ #
2415
+ # @example Request syntax with placeholder values
2416
+ #
2417
+ # resp = client.list_code_reviews({
2418
+ # max_results: 1,
2419
+ # next_token: "NextToken",
2420
+ # agent_space_id: "String", # required
2421
+ # })
2422
+ #
2423
+ # @example Response structure
2424
+ #
2425
+ # resp.code_review_summaries #=> Array
2426
+ # resp.code_review_summaries[0].code_review_id #=> String
2427
+ # resp.code_review_summaries[0].agent_space_id #=> String
2428
+ # resp.code_review_summaries[0].title #=> String
2429
+ # resp.code_review_summaries[0].created_at #=> Time
2430
+ # resp.code_review_summaries[0].updated_at #=> Time
2431
+ # resp.next_token #=> String
2432
+ #
2433
+ # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/ListCodeReviews AWS API Documentation
2434
+ #
2435
+ # @overload list_code_reviews(params = {})
2436
+ # @param [Hash] params ({})
2437
+ def list_code_reviews(params = {}, options = {})
2438
+ req = build_request(:list_code_reviews, params)
2439
+ req.send_request(options)
2440
+ end
2441
+
2442
+ # Returns a paginated list of endpoints discovered during a pentest job
2443
+ # execution.
2444
+ #
2445
+ # @option params [Integer] :max_results
2446
+ # The maximum number of results to return in a single call.
1894
2447
  #
1895
2448
  # @option params [required, String] :pentest_job_id
1896
- # Identifier of the pentest job for which to retrieve discovered
1897
- # endpoints
2449
+ # The unique identifier of the pentest job to list discovered endpoints
2450
+ # for.
1898
2451
  #
1899
2452
  # @option params [required, String] :agent_space_id
1900
- # ID of the agent space where the pentest job exists
2453
+ # The unique identifier of the agent space.
1901
2454
  #
1902
2455
  # @option params [String] :prefix
1903
- # Optional URI prefix filter to narrow down results
2456
+ # A prefix to filter discovered endpoints by URI.
1904
2457
  #
1905
2458
  # @option params [String] :next_token
1906
- # Token for pagination
2459
+ # A token to use for paginating results that are returned in the
2460
+ # response. Set the value of this parameter to null for the first
2461
+ # request. For subsequent calls, use the nextToken value returned from
2462
+ # the previous request.
1907
2463
  #
1908
2464
  # @return [Types::ListDiscoveredEndpointsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1909
2465
  #
@@ -1943,37 +2499,41 @@ module Aws::SecurityAgent
1943
2499
  req.send_request(options)
1944
2500
  end
1945
2501
 
1946
- # Lists findings with filtering and pagination support. When filters are
1947
- # applied, the actual number of results returned may be less than the
1948
- # specified limit
2502
+ # Lists the security findings for a pentest job.
1949
2503
  #
1950
2504
  # @option params [Integer] :max_results
1951
- # Maximum number of findings to return in a single request (default: 50)
2505
+ # The maximum number of results to return in a single call.
1952
2506
  #
1953
- # @option params [required, String] :pentest_job_id
1954
- # Identifier of the pentest job for which to retrieve associated
1955
- # findings
2507
+ # @option params [String] :pentest_job_id
2508
+ # The unique identifier of the pentest job to list findings for.
2509
+ #
2510
+ # @option params [String] :code_review_job_id
2511
+ # The unique identifier of the code review job to list findings for.
2512
+ # Mutually exclusive with pentestJobId.
1956
2513
  #
1957
2514
  # @option params [required, String] :agent_space_id
1958
- # ID of the agent space where the pentest job exists
2515
+ # The unique identifier of the agent space.
1959
2516
  #
1960
2517
  # @option params [String] :next_token
1961
- # Token for pagination
2518
+ # A token to use for paginating results that are returned in the
2519
+ # response. Set the value of this parameter to null for the first
2520
+ # request. For subsequent calls, use the nextToken value returned from
2521
+ # the previous request.
1962
2522
  #
1963
2523
  # @option params [String] :risk_type
1964
- # Filter findings by risk type
2524
+ # Filter findings by risk type.
1965
2525
  #
1966
2526
  # @option params [String] :risk_level
1967
- # Filter findings by risk level
2527
+ # Filter findings by risk level.
1968
2528
  #
1969
2529
  # @option params [String] :status
1970
- # Filter findings by status
2530
+ # Filter findings by status.
1971
2531
  #
1972
2532
  # @option params [String] :confidence
1973
- # Filter findings by confidence level
2533
+ # Filter findings by confidence level.
1974
2534
  #
1975
2535
  # @option params [String] :name
1976
- # Filter findings by name (case-insensitive substring search)
2536
+ # Filter findings by name.
1977
2537
  #
1978
2538
  # @return [Types::ListFindingsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1979
2539
  #
@@ -1986,7 +2546,8 @@ module Aws::SecurityAgent
1986
2546
  #
1987
2547
  # resp = client.list_findings({
1988
2548
  # max_results: 1,
1989
- # pentest_job_id: "String", # required
2549
+ # pentest_job_id: "String",
2550
+ # code_review_job_id: "String",
1990
2551
  # agent_space_id: "String", # required
1991
2552
  # next_token: "NextToken",
1992
2553
  # risk_type: "String",
@@ -2003,6 +2564,8 @@ module Aws::SecurityAgent
2003
2564
  # resp.findings_summaries[0].agent_space_id #=> String
2004
2565
  # resp.findings_summaries[0].pentest_id #=> String
2005
2566
  # resp.findings_summaries[0].pentest_job_id #=> String
2567
+ # resp.findings_summaries[0].code_review_id #=> String
2568
+ # resp.findings_summaries[0].code_review_job_id #=> String
2006
2569
  # resp.findings_summaries[0].name #=> String
2007
2570
  # resp.findings_summaries[0].status #=> String, one of "ACTIVE", "RESOLVED", "ACCEPTED", "FALSE_POSITIVE"
2008
2571
  # resp.findings_summaries[0].risk_type #=> String
@@ -2021,22 +2584,27 @@ module Aws::SecurityAgent
2021
2584
  req.send_request(options)
2022
2585
  end
2023
2586
 
2024
- # Lists the integrated resources for an agent space
2587
+ # Lists the integrated resources for an agent space, optionally filtered
2588
+ # by integration or resource type.
2025
2589
  #
2026
2590
  # @option params [required, String] :agent_space_id
2027
- # Unique identifier of the agent space
2591
+ # The unique identifier of the agent space to list integrated resources
2592
+ # for.
2028
2593
  #
2029
2594
  # @option params [String] :integration_id
2030
- # Filter integrated resources by a specific integration
2595
+ # The unique identifier of the integration to filter by.
2031
2596
  #
2032
2597
  # @option params [String] :resource_type
2033
- # Filter integrated resources by resource type
2598
+ # The type of resource to filter by.
2034
2599
  #
2035
2600
  # @option params [String] :next_token
2036
- # Token for pagination
2601
+ # A token to use for paginating results that are returned in the
2602
+ # response. Set the value of this parameter to null for the first
2603
+ # request. For subsequent calls, use the nextToken value returned from
2604
+ # the previous request.
2037
2605
  #
2038
2606
  # @option params [Integer] :max_results
2039
- # Maximum number of results to return
2607
+ # The maximum number of results to return in a single call.
2040
2608
  #
2041
2609
  # @return [Types::ListIntegratedResourcesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2042
2610
  #
@@ -2076,16 +2644,20 @@ module Aws::SecurityAgent
2076
2644
  req.send_request(options)
2077
2645
  end
2078
2646
 
2079
- # Retrieves the Integrations associated with the user's account
2647
+ # Lists the integrations in your account, optionally filtered by
2648
+ # provider or provider type.
2080
2649
  #
2081
2650
  # @option params [Types::IntegrationFilter] :filter
2082
- # Filter criteria for integrations
2651
+ # A filter to apply to the list of integrations.
2083
2652
  #
2084
2653
  # @option params [String] :next_token
2085
- # Token for pagination
2654
+ # A token to use for paginating results that are returned in the
2655
+ # response. Set the value of this parameter to null for the first
2656
+ # request. For subsequent calls, use the nextToken value returned from
2657
+ # the previous request.
2086
2658
  #
2087
2659
  # @option params [Integer] :max_results
2088
- # Maximum number of results to return
2660
+ # The maximum number of results to return in a single call.
2089
2661
  #
2090
2662
  # @return [Types::ListIntegrationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2091
2663
  #
@@ -2124,22 +2696,27 @@ module Aws::SecurityAgent
2124
2696
  req.send_request(options)
2125
2697
  end
2126
2698
 
2127
- # Lists all members associated to an agent space with pagination support
2699
+ # Returns a paginated list of membership summaries for the specified
2700
+ # agent space within an application.
2128
2701
  #
2129
2702
  # @option params [required, String] :application_id
2130
- # Application identifier
2703
+ # The unique identifier of the application that contains the agent
2704
+ # space.
2131
2705
  #
2132
2706
  # @option params [required, String] :agent_space_id
2133
- # Agent space identifier
2707
+ # The unique identifier of the agent space to list memberships for.
2134
2708
  #
2135
2709
  # @option params [String] :member_type
2136
- # Filter by member type
2710
+ # Filter memberships by member type.
2137
2711
  #
2138
2712
  # @option params [Integer] :max_results
2139
- # Maximum number of results to return
2713
+ # The maximum number of results to return in a single call.
2140
2714
  #
2141
2715
  # @option params [String] :next_token
2142
- # Token for pagination
2716
+ # A token to use for paginating results that are returned in the
2717
+ # response. Set the value of this parameter to null for the first
2718
+ # request. For subsequent calls, use the nextToken value returned from
2719
+ # the previous request.
2143
2720
  #
2144
2721
  # @return [Types::ListMembershipsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2145
2722
  #
@@ -2183,25 +2760,30 @@ module Aws::SecurityAgent
2183
2760
  req.send_request(options)
2184
2761
  end
2185
2762
 
2186
- # Lists tasks associated with a specific pentest job
2763
+ # Returns a paginated list of task summaries for the specified pentest
2764
+ # job, optionally filtered by step name or category.
2187
2765
  #
2188
2766
  # @option params [required, String] :agent_space_id
2189
- # ID of the agent space where the pentest exists
2767
+ # The unique identifier of the agent space.
2190
2768
  #
2191
2769
  # @option params [Integer] :max_results
2192
- # Maximum number of tasks to return in a single request
2770
+ # The maximum number of results to return in a single call.
2193
2771
  #
2194
2772
  # @option params [String] :pentest_job_id
2195
- # Identifier of the pentest job whose tasks to list
2773
+ # The unique identifier of the pentest job to list tasks for.
2196
2774
  #
2197
2775
  # @option params [String] :step_name
2198
- # Filter tasks by step name
2776
+ # Filter tasks by step name. Valid values include PREFLIGHT,
2777
+ # STATIC\_ANALYSIS, PENTEST, and FINALIZING.
2199
2778
  #
2200
2779
  # @option params [String] :category_name
2201
2780
  # Filter tasks by category name.
2202
2781
  #
2203
2782
  # @option params [String] :next_token
2204
- # Token for pagination to retrieve the next set of results
2783
+ # A token to use for paginating results that are returned in the
2784
+ # response. Set the value of this parameter to null for the first
2785
+ # request. For subsequent calls, use the nextToken value returned from
2786
+ # the previous request.
2205
2787
  #
2206
2788
  # @return [Types::ListPentestJobTasksOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2207
2789
  #
@@ -2244,19 +2826,23 @@ module Aws::SecurityAgent
2244
2826
  req.send_request(options)
2245
2827
  end
2246
2828
 
2247
- # Lists pentest jobs associated with a pentest
2829
+ # Returns a paginated list of pentest job summaries for the specified
2830
+ # pentest configuration.
2248
2831
  #
2249
2832
  # @option params [Integer] :max_results
2250
- # Maximum number of pentest jobs to return in a single request
2833
+ # The maximum number of results to return in a single call.
2251
2834
  #
2252
2835
  # @option params [required, String] :pentest_id
2253
- # Identifier of the pentest for which to retrieve associated jobs
2836
+ # The unique identifier of the pentest to list jobs for.
2254
2837
  #
2255
2838
  # @option params [required, String] :agent_space_id
2256
- # ID of the agent space where the pentest exists
2839
+ # The unique identifier of the agent space.
2257
2840
  #
2258
2841
  # @option params [String] :next_token
2259
- # Token for pagination
2842
+ # A token to use for paginating results that are returned in the
2843
+ # response. Set the value of this parameter to null for the first
2844
+ # request. For subsequent calls, use the nextToken value returned from
2845
+ # the previous request.
2260
2846
  #
2261
2847
  # @return [Types::ListPentestJobsForPentestOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2262
2848
  #
@@ -2294,16 +2880,20 @@ module Aws::SecurityAgent
2294
2880
  req.send_request(options)
2295
2881
  end
2296
2882
 
2297
- # Lists pentests with optional filtering by status
2883
+ # Returns a paginated list of pentest summaries for the specified agent
2884
+ # space.
2298
2885
  #
2299
2886
  # @option params [Integer] :max_results
2300
- # Maximum number of pentests to return in a single request
2887
+ # The maximum number of results to return in a single call.
2301
2888
  #
2302
2889
  # @option params [String] :next_token
2303
- # Token for pagination
2890
+ # A token to use for paginating results that are returned in the
2891
+ # response. Set the value of this parameter to null for the first
2892
+ # request. For subsequent calls, use the nextToken value returned from
2893
+ # the previous request.
2304
2894
  #
2305
2895
  # @option params [required, String] :agent_space_id
2306
- # ID of the agent space where the pentest exists
2896
+ # The unique identifier of the agent space to list pentests for.
2307
2897
  #
2308
2898
  # @return [Types::ListPentestsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2309
2899
  #
@@ -2339,10 +2929,10 @@ module Aws::SecurityAgent
2339
2929
  req.send_request(options)
2340
2930
  end
2341
2931
 
2342
- # Lists tags for a Security Agent resource
2932
+ # Returns the tags associated with the specified resource.
2343
2933
  #
2344
2934
  # @option params [required, String] :resource_arn
2345
- # ARN of the resource to list tags for
2935
+ # The Amazon Resource Name (ARN) of the resource to list tags for.
2346
2936
  #
2347
2937
  # @return [Types::ListTagsForResourceOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2348
2938
  #
@@ -2368,13 +2958,16 @@ module Aws::SecurityAgent
2368
2958
  req.send_request(options)
2369
2959
  end
2370
2960
 
2371
- # Lists target domains
2961
+ # Returns a paginated list of target domain summaries in your account.
2372
2962
  #
2373
2963
  # @option params [String] :next_token
2374
- # Token for pagination
2964
+ # A token to use for paginating results that are returned in the
2965
+ # response. Set the value of this parameter to null for the first
2966
+ # request. For subsequent calls, use the nextToken value returned from
2967
+ # the previous request.
2375
2968
  #
2376
2969
  # @option params [Integer] :max_results
2377
- # Maximum number of target domains to return
2970
+ # The maximum number of results to return in a single call.
2378
2971
  #
2379
2972
  # @return [Types::ListTargetDomainsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2380
2973
  #
@@ -2407,16 +3000,23 @@ module Aws::SecurityAgent
2407
3000
  req.send_request(options)
2408
3001
  end
2409
3002
 
2410
- # Starts code remediation for the specified findings
3003
+ # Initiates code remediation for one or more security findings. This
3004
+ # creates pull requests in integrated repositories to fix the identified
3005
+ # vulnerabilities.
2411
3006
  #
2412
3007
  # @option params [required, String] :agent_space_id
2413
- # ID of the agent space where the pentest job exists
3008
+ # The unique identifier of the agent space.
2414
3009
  #
2415
- # @option params [required, String] :pentest_job_id
2416
- # Identifier of the pentest job to start code remediation for
3010
+ # @option params [String] :pentest_job_id
3011
+ # The unique identifier of the pentest job that produced the findings.
3012
+ # Mutually exclusive with `codeReviewJobId`.
3013
+ #
3014
+ # @option params [String] :code_review_job_id
3015
+ # The unique identifier of the code review job that produced the
3016
+ # findings. Mutually exclusive with `pentestJobId`.
2417
3017
  #
2418
3018
  # @option params [required, Array<String>] :finding_ids
2419
- # Identifiers of the findings to start code remediation for
3019
+ # The list of finding identifiers to initiate code remediation for.
2420
3020
  #
2421
3021
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2422
3022
  #
@@ -2424,7 +3024,8 @@ module Aws::SecurityAgent
2424
3024
  #
2425
3025
  # resp = client.start_code_remediation({
2426
3026
  # agent_space_id: "String", # required
2427
- # pentest_job_id: "String", # required
3027
+ # pentest_job_id: "String",
3028
+ # code_review_job_id: "String",
2428
3029
  # finding_ids: ["String"], # required
2429
3030
  # })
2430
3031
  #
@@ -2437,13 +3038,60 @@ module Aws::SecurityAgent
2437
3038
  req.send_request(options)
2438
3039
  end
2439
3040
 
2440
- # Initiates the execution of a pentest
3041
+ # Starts a new code review job for a code review configuration. The job
3042
+ # executes the security-focused code analysis defined in the code
3043
+ # review.
2441
3044
  #
2442
3045
  # @option params [required, String] :agent_space_id
2443
- # ID of the agent space where the pentest exists
3046
+ # The unique identifier of the agent space.
3047
+ #
3048
+ # @option params [required, String] :code_review_id
3049
+ # The unique identifier of the code review to start a job for.
3050
+ #
3051
+ # @return [Types::StartCodeReviewJobOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3052
+ #
3053
+ # * {Types::StartCodeReviewJobOutput#title #title} => String
3054
+ # * {Types::StartCodeReviewJobOutput#status #status} => String
3055
+ # * {Types::StartCodeReviewJobOutput#created_at #created_at} => Time
3056
+ # * {Types::StartCodeReviewJobOutput#updated_at #updated_at} => Time
3057
+ # * {Types::StartCodeReviewJobOutput#code_review_id #code_review_id} => String
3058
+ # * {Types::StartCodeReviewJobOutput#code_review_job_id #code_review_job_id} => String
3059
+ # * {Types::StartCodeReviewJobOutput#agent_space_id #agent_space_id} => String
3060
+ #
3061
+ # @example Request syntax with placeholder values
3062
+ #
3063
+ # resp = client.start_code_review_job({
3064
+ # agent_space_id: "String", # required
3065
+ # code_review_id: "String", # required
3066
+ # })
3067
+ #
3068
+ # @example Response structure
3069
+ #
3070
+ # resp.title #=> String
3071
+ # resp.status #=> String, one of "IN_PROGRESS", "STOPPING", "STOPPED", "FAILED", "COMPLETED"
3072
+ # resp.created_at #=> Time
3073
+ # resp.updated_at #=> Time
3074
+ # resp.code_review_id #=> String
3075
+ # resp.code_review_job_id #=> String
3076
+ # resp.agent_space_id #=> String
3077
+ #
3078
+ # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/StartCodeReviewJob AWS API Documentation
3079
+ #
3080
+ # @overload start_code_review_job(params = {})
3081
+ # @param [Hash] params ({})
3082
+ def start_code_review_job(params = {}, options = {})
3083
+ req = build_request(:start_code_review_job, params)
3084
+ req.send_request(options)
3085
+ end
3086
+
3087
+ # Starts a new pentest job for a pentest configuration. The job executes
3088
+ # the security tests defined in the pentest.
3089
+ #
3090
+ # @option params [required, String] :agent_space_id
3091
+ # The unique identifier of the agent space.
2444
3092
  #
2445
3093
  # @option params [required, String] :pentest_id
2446
- # Identifier of the pentest to execute
3094
+ # The unique identifier of the pentest to start a job for.
2447
3095
  #
2448
3096
  # @return [Types::StartPentestJobOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2449
3097
  #
@@ -2481,13 +3129,41 @@ module Aws::SecurityAgent
2481
3129
  req.send_request(options)
2482
3130
  end
2483
3131
 
2484
- # Stops the execution of a running pentest
3132
+ # Stops a running code review job. The job transitions to a stopping
3133
+ # state and then to stopped after cleanup completes.
3134
+ #
3135
+ # @option params [required, String] :agent_space_id
3136
+ # The unique identifier of the agent space.
3137
+ #
3138
+ # @option params [required, String] :code_review_job_id
3139
+ # The unique identifier of the code review job to stop.
3140
+ #
3141
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
3142
+ #
3143
+ # @example Request syntax with placeholder values
3144
+ #
3145
+ # resp = client.stop_code_review_job({
3146
+ # agent_space_id: "String", # required
3147
+ # code_review_job_id: "String", # required
3148
+ # })
3149
+ #
3150
+ # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/StopCodeReviewJob AWS API Documentation
3151
+ #
3152
+ # @overload stop_code_review_job(params = {})
3153
+ # @param [Hash] params ({})
3154
+ def stop_code_review_job(params = {}, options = {})
3155
+ req = build_request(:stop_code_review_job, params)
3156
+ req.send_request(options)
3157
+ end
3158
+
3159
+ # Stops a running pentest job. The job transitions to a stopping state
3160
+ # and then to stopped after cleanup completes.
2485
3161
  #
2486
3162
  # @option params [required, String] :agent_space_id
2487
- # ID of the agent space where the pentest exists
3163
+ # The unique identifier of the agent space.
2488
3164
  #
2489
3165
  # @option params [required, String] :pentest_job_id
2490
- # Identifier of the pentest job to stop
3166
+ # The unique identifier of the pentest job to stop.
2491
3167
  #
2492
3168
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2493
3169
  #
@@ -2507,13 +3183,13 @@ module Aws::SecurityAgent
2507
3183
  req.send_request(options)
2508
3184
  end
2509
3185
 
2510
- # Adds tags to a Security Agent resource
3186
+ # Adds tags to a resource.
2511
3187
  #
2512
3188
  # @option params [required, String] :resource_arn
2513
- # ARN of the resource to tag
3189
+ # The Amazon Resource Name (ARN) of the resource to tag.
2514
3190
  #
2515
3191
  # @option params [required, Hash<String,String>] :tags
2516
- # Tags to add to the resource
3192
+ # The tags to add to the resource.
2517
3193
  #
2518
3194
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2519
3195
  #
@@ -2535,13 +3211,13 @@ module Aws::SecurityAgent
2535
3211
  req.send_request(options)
2536
3212
  end
2537
3213
 
2538
- # Removes tags from a Security Agent resource
3214
+ # Removes tags from a resource.
2539
3215
  #
2540
3216
  # @option params [required, String] :resource_arn
2541
- # ARN of the resource to untag
3217
+ # The Amazon Resource Name (ARN) of the resource to remove tags from.
2542
3218
  #
2543
3219
  # @option params [required, Array<String>] :tag_keys
2544
- # List of tag keys to remove from the resource
3220
+ # The list of tag keys to remove from the resource.
2545
3221
  #
2546
3222
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2547
3223
  #
@@ -2561,26 +3237,28 @@ module Aws::SecurityAgent
2561
3237
  req.send_request(options)
2562
3238
  end
2563
3239
 
2564
- # Updates an agent space record
3240
+ # Updates the configuration of an existing agent space, including its
3241
+ # name, description, AWS resources, target domains, and code review
3242
+ # settings.
2565
3243
  #
2566
3244
  # @option params [required, String] :agent_space_id
2567
- # ID of the agent space to update
3245
+ # The unique identifier of the agent space to update.
2568
3246
  #
2569
3247
  # @option params [String] :name
2570
- # Name of the agent space
3248
+ # The updated name of the agent space.
2571
3249
  #
2572
3250
  # @option params [String] :description
2573
- # Description of the agent space
3251
+ # The updated description of the agent space.
2574
3252
  #
2575
3253
  # @option params [Types::AWSResources] :aws_resources
2576
- # AWS resource configurations associated with the agent space
3254
+ # The updated AWS resources to associate with the agent space.
2577
3255
  #
2578
3256
  # @option params [Array<String>] :target_domain_ids
2579
- # Target domain IDs to associate with the agent space
3257
+ # The updated list of target domain identifiers to associate with the
3258
+ # agent space.
2580
3259
  #
2581
3260
  # @option params [Types::CodeReviewSettings] :code_review_settings
2582
- # Configuration for code review analysis, including controls scanning
2583
- # and general purpose scanning settings
3261
+ # The updated code review settings for the agent space.
2584
3262
  #
2585
3263
  # @return [Types::UpdateAgentSpaceOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2586
3264
  #
@@ -2657,18 +3335,18 @@ module Aws::SecurityAgent
2657
3335
  req.send_request(options)
2658
3336
  end
2659
3337
 
2660
- # Updates application configuration
3338
+ # Updates the configuration of an existing application, including the
3339
+ # IAM role and default KMS key.
2661
3340
  #
2662
3341
  # @option params [required, String] :application_id
2663
- # Application ID
3342
+ # The unique identifier of the application to update.
2664
3343
  #
2665
3344
  # @option params [String] :role_arn
2666
- # ARN of the IAM role that the application uses to access AWS resources
2667
- # on your behalf
3345
+ # The updated Amazon Resource Name (ARN) of the IAM role for the
3346
+ # application.
2668
3347
  #
2669
3348
  # @option params [String] :default_kms_key_id
2670
- # Default KMS key identifier. Use an empty string to remove the default
2671
- # KMS key.
3349
+ # The updated identifier of the default AWS KMS key for the application.
2672
3350
  #
2673
3351
  # @return [Types::UpdateApplicationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2674
3352
  #
@@ -2695,19 +3373,142 @@ module Aws::SecurityAgent
2695
3373
  req.send_request(options)
2696
3374
  end
2697
3375
 
2698
- # Updates an existing security finding with new details or status
3376
+ # Updates an existing code review configuration.
3377
+ #
3378
+ # @option params [required, String] :code_review_id
3379
+ # The unique identifier of the code review to update.
3380
+ #
3381
+ # @option params [required, String] :agent_space_id
3382
+ # The unique identifier of the agent space that contains the code
3383
+ # review.
3384
+ #
3385
+ # @option params [String] :title
3386
+ # The updated title of the code review.
3387
+ #
3388
+ # @option params [Types::Assets] :assets
3389
+ # The updated assets for the code review.
3390
+ #
3391
+ # @option params [String] :service_role
3392
+ # The updated IAM service role for the code review.
3393
+ #
3394
+ # @option params [Types::CloudWatchLog] :log_config
3395
+ # The updated CloudWatch Logs configuration for the code review.
3396
+ #
3397
+ # @option params [String] :code_remediation_strategy
3398
+ # The updated code remediation strategy for the code review.
3399
+ #
3400
+ # @return [Types::UpdateCodeReviewOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3401
+ #
3402
+ # * {Types::UpdateCodeReviewOutput#code_review_id #code_review_id} => String
3403
+ # * {Types::UpdateCodeReviewOutput#title #title} => String
3404
+ # * {Types::UpdateCodeReviewOutput#created_at #created_at} => Time
3405
+ # * {Types::UpdateCodeReviewOutput#updated_at #updated_at} => Time
3406
+ # * {Types::UpdateCodeReviewOutput#assets #assets} => Types::Assets
3407
+ # * {Types::UpdateCodeReviewOutput#service_role #service_role} => String
3408
+ # * {Types::UpdateCodeReviewOutput#log_config #log_config} => Types::CloudWatchLog
3409
+ # * {Types::UpdateCodeReviewOutput#agent_space_id #agent_space_id} => String
3410
+ # * {Types::UpdateCodeReviewOutput#code_remediation_strategy #code_remediation_strategy} => String
3411
+ #
3412
+ # @example Request syntax with placeholder values
3413
+ #
3414
+ # resp = client.update_code_review({
3415
+ # code_review_id: "String", # required
3416
+ # agent_space_id: "String", # required
3417
+ # title: "String",
3418
+ # assets: {
3419
+ # endpoints: [
3420
+ # {
3421
+ # uri: "String",
3422
+ # },
3423
+ # ],
3424
+ # actors: [
3425
+ # {
3426
+ # identifier: "String",
3427
+ # uris: ["String"],
3428
+ # authentication: {
3429
+ # provider_type: "SECRETS_MANAGER", # accepts SECRETS_MANAGER, AWS_LAMBDA, AWS_IAM_ROLE, AWS_INTERNAL
3430
+ # value: "String",
3431
+ # },
3432
+ # description: "String",
3433
+ # },
3434
+ # ],
3435
+ # documents: [
3436
+ # {
3437
+ # s3_location: "String",
3438
+ # artifact_id: "String",
3439
+ # },
3440
+ # ],
3441
+ # source_code: [
3442
+ # {
3443
+ # s3_location: "String",
3444
+ # },
3445
+ # ],
3446
+ # integrated_repositories: [
3447
+ # {
3448
+ # integration_id: "String", # required
3449
+ # provider_resource_id: "String", # required
3450
+ # },
3451
+ # ],
3452
+ # },
3453
+ # service_role: "ServiceRole",
3454
+ # log_config: {
3455
+ # log_group: "String",
3456
+ # log_stream: "String",
3457
+ # },
3458
+ # code_remediation_strategy: "AUTOMATIC", # accepts AUTOMATIC, DISABLED
3459
+ # })
3460
+ #
3461
+ # @example Response structure
3462
+ #
3463
+ # resp.code_review_id #=> String
3464
+ # resp.title #=> String
3465
+ # resp.created_at #=> Time
3466
+ # resp.updated_at #=> Time
3467
+ # resp.assets.endpoints #=> Array
3468
+ # resp.assets.endpoints[0].uri #=> String
3469
+ # resp.assets.actors #=> Array
3470
+ # resp.assets.actors[0].identifier #=> String
3471
+ # resp.assets.actors[0].uris #=> Array
3472
+ # resp.assets.actors[0].uris[0] #=> String
3473
+ # resp.assets.actors[0].authentication.provider_type #=> String, one of "SECRETS_MANAGER", "AWS_LAMBDA", "AWS_IAM_ROLE", "AWS_INTERNAL"
3474
+ # resp.assets.actors[0].authentication.value #=> String
3475
+ # resp.assets.actors[0].description #=> String
3476
+ # resp.assets.documents #=> Array
3477
+ # resp.assets.documents[0].s3_location #=> String
3478
+ # resp.assets.documents[0].artifact_id #=> String
3479
+ # resp.assets.source_code #=> Array
3480
+ # resp.assets.source_code[0].s3_location #=> String
3481
+ # resp.assets.integrated_repositories #=> Array
3482
+ # resp.assets.integrated_repositories[0].integration_id #=> String
3483
+ # resp.assets.integrated_repositories[0].provider_resource_id #=> String
3484
+ # resp.service_role #=> String
3485
+ # resp.log_config.log_group #=> String
3486
+ # resp.log_config.log_stream #=> String
3487
+ # resp.agent_space_id #=> String
3488
+ # resp.code_remediation_strategy #=> String, one of "AUTOMATIC", "DISABLED"
3489
+ #
3490
+ # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/UpdateCodeReview AWS API Documentation
3491
+ #
3492
+ # @overload update_code_review(params = {})
3493
+ # @param [Hash] params ({})
3494
+ def update_code_review(params = {}, options = {})
3495
+ req = build_request(:update_code_review, params)
3496
+ req.send_request(options)
3497
+ end
3498
+
3499
+ # Updates the status or risk level of a security finding.
2699
3500
  #
2700
3501
  # @option params [required, String] :finding_id
2701
- # Identifier of the finding to update
3502
+ # The unique identifier of the finding to update.
2702
3503
  #
2703
3504
  # @option params [required, String] :agent_space_id
2704
- # ID of the agent space where the finding exists
3505
+ # The unique identifier of the agent space that contains the finding.
2705
3506
  #
2706
3507
  # @option params [String] :risk_level
2707
- # Updated severity level of the identified risk
3508
+ # The updated risk level for the finding.
2708
3509
  #
2709
3510
  # @option params [String] :status
2710
- # Updated status of the finding
3511
+ # The updated status for the finding.
2711
3512
  #
2712
3513
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2713
3514
  #
@@ -2729,16 +3530,17 @@ module Aws::SecurityAgent
2729
3530
  req.send_request(options)
2730
3531
  end
2731
3532
 
2732
- # Updates the integrated resources for an agent space
3533
+ # Updates the integrated resources for an agent space, including their
3534
+ # capabilities.
2733
3535
  #
2734
3536
  # @option params [required, String] :agent_space_id
2735
- # Unique identifier of the agent space
3537
+ # The unique identifier of the agent space.
2736
3538
  #
2737
3539
  # @option params [required, String] :integration_id
2738
- # Unique identifier of the integration
3540
+ # The unique identifier of the integration.
2739
3541
  #
2740
3542
  # @option params [required, Array<Types::IntegratedResourceInputItem>] :items
2741
- # List of integrated resources to update
3543
+ # The list of integrated resource items to update.
2742
3544
  #
2743
3545
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
2744
3546
  #
@@ -2774,38 +3576,37 @@ module Aws::SecurityAgent
2774
3576
  req.send_request(options)
2775
3577
  end
2776
3578
 
2777
- # Updates an existing pentest with new configuration or settings
3579
+ # Updates an existing pentest configuration.
2778
3580
  #
2779
3581
  # @option params [required, String] :pentest_id
2780
- # Identifier of the pentest to update
3582
+ # The unique identifier of the pentest to update.
2781
3583
  #
2782
3584
  # @option params [required, String] :agent_space_id
2783
- # ID of the agent space where the pentest exists
3585
+ # The unique identifier of the agent space that contains the pentest.
2784
3586
  #
2785
3587
  # @option params [String] :title
2786
- # New title for the pentest
3588
+ # The updated title of the pentest.
2787
3589
  #
2788
3590
  # @option params [Types::Assets] :assets
2789
- # Updated assets to be tested
3591
+ # The updated assets for the pentest.
2790
3592
  #
2791
3593
  # @option params [Array<String>] :exclude_risk_types
2792
- # A list of risk types excluded from the pentest execution
3594
+ # The updated list of risk types to exclude from the pentest.
2793
3595
  #
2794
3596
  # @option params [String] :service_role
2795
- # Updated service role ARN for accessing customer resources
3597
+ # The updated IAM service role for the pentest.
2796
3598
  #
2797
3599
  # @option params [Types::CloudWatchLog] :log_config
2798
- # CloudWatch log group and stream prefix where pentest execution logs
2799
- # are stored
3600
+ # The updated CloudWatch Logs configuration for the pentest.
2800
3601
  #
2801
3602
  # @option params [Types::VpcConfig] :vpc_config
2802
- # VPC configuration that the Security Agent accesses
3603
+ # The updated VPC configuration for the pentest.
2803
3604
  #
2804
3605
  # @option params [Types::NetworkTrafficConfig] :network_traffic_config
2805
- # Configuration for network traffic filtering
3606
+ # The updated network traffic configuration for the pentest.
2806
3607
  #
2807
3608
  # @option params [String] :code_remediation_strategy
2808
- # Strategy for code remediation on findings
3609
+ # The updated code remediation strategy for the pentest.
2809
3610
  #
2810
3611
  # @return [Types::UpdatePentestOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2811
3612
  #
@@ -2928,19 +3729,20 @@ module Aws::SecurityAgent
2928
3729
  req.send_request(options)
2929
3730
  end
2930
3731
 
2931
- # Updates a target domain record
3732
+ # Updates the verification method for a target domain.
2932
3733
  #
2933
3734
  # @option params [required, String] :target_domain_id
2934
- # Unique identifier of the target domain to update
3735
+ # The unique identifier of the target domain to update.
2935
3736
  #
2936
3737
  # @option params [required, String] :verification_method
2937
- # Verification method for the target domain
3738
+ # The updated verification method for the target domain.
2938
3739
  #
2939
3740
  # @return [Types::UpdateTargetDomainOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2940
3741
  #
2941
3742
  # * {Types::UpdateTargetDomainOutput#target_domain_id #target_domain_id} => String
2942
3743
  # * {Types::UpdateTargetDomainOutput#domain_name #domain_name} => String
2943
3744
  # * {Types::UpdateTargetDomainOutput#verification_status #verification_status} => String
3745
+ # * {Types::UpdateTargetDomainOutput#verification_status_reason #verification_status_reason} => String
2944
3746
  # * {Types::UpdateTargetDomainOutput#verification_details #verification_details} => Types::VerificationDetails
2945
3747
  # * {Types::UpdateTargetDomainOutput#created_at #created_at} => Time
2946
3748
  # * {Types::UpdateTargetDomainOutput#verified_at #verified_at} => Time
@@ -2949,7 +3751,7 @@ module Aws::SecurityAgent
2949
3751
  #
2950
3752
  # resp = client.update_target_domain({
2951
3753
  # target_domain_id: "TargetDomainId", # required
2952
- # verification_method: "DNS_TXT", # required, accepts DNS_TXT, HTTP_ROUTE
3754
+ # verification_method: "DNS_TXT", # required, accepts DNS_TXT, HTTP_ROUTE, PRIVATE_VPC
2953
3755
  # })
2954
3756
  #
2955
3757
  # @example Response structure
@@ -2957,7 +3759,8 @@ module Aws::SecurityAgent
2957
3759
  # resp.target_domain_id #=> String
2958
3760
  # resp.domain_name #=> String
2959
3761
  # resp.verification_status #=> String, one of "PENDING", "VERIFIED", "FAILED", "UNREACHABLE"
2960
- # resp.verification_details.method #=> String, one of "DNS_TXT", "HTTP_ROUTE"
3762
+ # resp.verification_status_reason #=> String
3763
+ # resp.verification_details.method #=> String, one of "DNS_TXT", "HTTP_ROUTE", "PRIVATE_VPC"
2961
3764
  # resp.verification_details.dns_txt.token #=> String
2962
3765
  # resp.verification_details.dns_txt.dns_record_name #=> String
2963
3766
  # resp.verification_details.dns_txt.dns_record_type #=> String, one of "TXT"
@@ -2975,10 +3778,11 @@ module Aws::SecurityAgent
2975
3778
  req.send_request(options)
2976
3779
  end
2977
3780
 
2978
- # Verifies ownership for a registered target domain
3781
+ # Initiates verification of a target domain. This checks whether the
3782
+ # domain ownership verification token has been properly configured.
2979
3783
  #
2980
3784
  # @option params [required, String] :target_domain_id
2981
- # Unique identifier of the target domain
3785
+ # The unique identifier of the target domain to verify.
2982
3786
  #
2983
3787
  # @return [Types::VerifyTargetDomainOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2984
3788
  #
@@ -2988,6 +3792,7 @@ module Aws::SecurityAgent
2988
3792
  # * {Types::VerifyTargetDomainOutput#updated_at #updated_at} => Time
2989
3793
  # * {Types::VerifyTargetDomainOutput#verified_at #verified_at} => Time
2990
3794
  # * {Types::VerifyTargetDomainOutput#status #status} => String
3795
+ # * {Types::VerifyTargetDomainOutput#verification_status_reason #verification_status_reason} => String
2991
3796
  #
2992
3797
  # @example Request syntax with placeholder values
2993
3798
  #
@@ -3003,6 +3808,7 @@ module Aws::SecurityAgent
3003
3808
  # resp.updated_at #=> Time
3004
3809
  # resp.verified_at #=> Time
3005
3810
  # resp.status #=> String, one of "PENDING", "VERIFIED", "FAILED", "UNREACHABLE"
3811
+ # resp.verification_status_reason #=> String
3006
3812
  #
3007
3813
  # @see http://docs.aws.amazon.com/goto/WebAPI/securityagent-2025-09-06/VerifyTargetDomain AWS API Documentation
3008
3814
  #
@@ -3031,7 +3837,7 @@ module Aws::SecurityAgent
3031
3837
  tracer: tracer
3032
3838
  )
3033
3839
  context[:gem_name] = 'aws-sdk-securityagent'
3034
- context[:gem_version] = '1.0.0'
3840
+ context[:gem_version] = '1.2.0'
3035
3841
  Seahorse::Client::Request.new(handlers, context)
3036
3842
  end
3037
3843