aws-sdk-codebuild 1.54.0 → 1.59.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.
@@ -52,6 +52,44 @@ module Aws::CodeBuild
52
52
  include Aws::Structure
53
53
  end
54
54
 
55
+ # @note When making an API call, you may pass BatchGetBuildBatchesInput
56
+ # data as a hash:
57
+ #
58
+ # {
59
+ # ids: ["NonEmptyString"], # required
60
+ # }
61
+ #
62
+ # @!attribute [rw] ids
63
+ # An array that contains the batch build identifiers to retrieve.
64
+ # @return [Array<String>]
65
+ #
66
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BatchGetBuildBatchesInput AWS API Documentation
67
+ #
68
+ class BatchGetBuildBatchesInput < Struct.new(
69
+ :ids)
70
+ SENSITIVE = []
71
+ include Aws::Structure
72
+ end
73
+
74
+ # @!attribute [rw] build_batches
75
+ # An array of `BuildBatch` objects that represent the retrieved batch
76
+ # builds.
77
+ # @return [Array<Types::BuildBatch>]
78
+ #
79
+ # @!attribute [rw] build_batches_not_found
80
+ # An array that contains the identifiers of any batch builds that are
81
+ # not found.
82
+ # @return [Array<String>]
83
+ #
84
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BatchGetBuildBatchesOutput AWS API Documentation
85
+ #
86
+ class BatchGetBuildBatchesOutput < Struct.new(
87
+ :build_batches,
88
+ :build_batches_not_found)
89
+ SENSITIVE = []
90
+ include Aws::Structure
91
+ end
92
+
55
93
  # @note When making an API call, you may pass BatchGetBuildsInput
56
94
  # data as a hash:
57
95
  #
@@ -202,6 +240,39 @@ module Aws::CodeBuild
202
240
  include Aws::Structure
203
241
  end
204
242
 
243
+ # Specifies restrictions for the batch build.
244
+ #
245
+ # @note When making an API call, you may pass BatchRestrictions
246
+ # data as a hash:
247
+ #
248
+ # {
249
+ # maximum_builds_allowed: 1,
250
+ # compute_types_allowed: ["NonEmptyString"],
251
+ # }
252
+ #
253
+ # @!attribute [rw] maximum_builds_allowed
254
+ # Specifies the maximum number of builds allowed.
255
+ # @return [Integer]
256
+ #
257
+ # @!attribute [rw] compute_types_allowed
258
+ # An array of strings that specify the compute types that are allowed
259
+ # for the batch build. See [Build environment compute types][1] in the
260
+ # *AWS CodeBuild User Guide* for these values.
261
+ #
262
+ #
263
+ #
264
+ # [1]: https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-compute-types.html
265
+ # @return [Array<String>]
266
+ #
267
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BatchRestrictions AWS API Documentation
268
+ #
269
+ class BatchRestrictions < Struct.new(
270
+ :maximum_builds_allowed,
271
+ :compute_types_allowed)
272
+ SENSITIVE = []
273
+ include Aws::Structure
274
+ end
275
+
205
276
  # Information about a build.
206
277
  #
207
278
  # @!attribute [rw] id
@@ -386,8 +457,8 @@ module Aws::CodeBuild
386
457
  # </note>
387
458
  #
388
459
  # You can specify either the Amazon Resource Name (ARN) of the CMK or,
389
- # if available, the CMK's alias (using the format `alias/alias-name
390
- # `).
460
+ # if available, the CMK's alias (using the format
461
+ # `alias/<alias-name>`).
391
462
  # @return [String]
392
463
  #
393
464
  # @!attribute [rw] exported_environment_variables
@@ -405,6 +476,15 @@ module Aws::CodeBuild
405
476
  # of a file system created using Amazon Elastic File System.
406
477
  # @return [Array<Types::ProjectFileSystemLocation>]
407
478
  #
479
+ # @!attribute [rw] debug_session
480
+ # Contains information about the debug session for this build.
481
+ # @return [Types::DebugSession]
482
+ #
483
+ # @!attribute [rw] build_batch_arn
484
+ # The ARN of the batch build that this build is a member of, if
485
+ # applicable.
486
+ # @return [String]
487
+ #
408
488
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/Build AWS API Documentation
409
489
  #
410
490
  class Build < Struct.new(
@@ -437,7 +517,9 @@ module Aws::CodeBuild
437
517
  :encryption_key,
438
518
  :exported_environment_variables,
439
519
  :report_arns,
440
- :file_system_locations)
520
+ :file_system_locations,
521
+ :debug_session,
522
+ :build_batch_arn)
441
523
  SENSITIVE = []
442
524
  include Aws::Structure
443
525
  end
@@ -502,102 +584,334 @@ module Aws::CodeBuild
502
584
  include Aws::Structure
503
585
  end
504
586
 
505
- # Information about a build that could not be successfully deleted.
587
+ # Contains information about a batch build.
506
588
  #
507
589
  # @!attribute [rw] id
508
- # The ID of the build that could not be successfully deleted.
590
+ # The identifier of the batch build.
509
591
  # @return [String]
510
592
  #
511
- # @!attribute [rw] status_code
512
- # Additional information about the build that could not be
513
- # successfully deleted.
593
+ # @!attribute [rw] arn
594
+ # The ARN of the batch build.
514
595
  # @return [String]
515
596
  #
516
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BuildNotDeleted AWS API Documentation
597
+ # @!attribute [rw] start_time
598
+ # The date and time that the batch build started.
599
+ # @return [Time]
517
600
  #
518
- class BuildNotDeleted < Struct.new(
601
+ # @!attribute [rw] end_time
602
+ # The date and time that the batch build ended.
603
+ # @return [Time]
604
+ #
605
+ # @!attribute [rw] current_phase
606
+ # The current phase of the batch build.
607
+ # @return [String]
608
+ #
609
+ # @!attribute [rw] build_batch_status
610
+ # The status of the batch build.
611
+ # @return [String]
612
+ #
613
+ # @!attribute [rw] source_version
614
+ # The identifier of the version of the source code to be built.
615
+ # @return [String]
616
+ #
617
+ # @!attribute [rw] resolved_source_version
618
+ # The identifier of the resolved version of this batch build's source
619
+ # code.
620
+ #
621
+ # * For AWS CodeCommit, GitHub, GitHub Enterprise, and BitBucket, the
622
+ # commit ID.
623
+ #
624
+ # * For AWS CodePipeline, the source revision provided by AWS
625
+ # CodePipeline.
626
+ #
627
+ # * For Amazon Simple Storage Service (Amazon S3), this does not
628
+ # apply.
629
+ # @return [String]
630
+ #
631
+ # @!attribute [rw] project_name
632
+ # The name of the batch build project.
633
+ # @return [String]
634
+ #
635
+ # @!attribute [rw] phases
636
+ # An array of `BuildBatchPhase` objects the specify the phases of the
637
+ # batch build.
638
+ # @return [Array<Types::BuildBatchPhase>]
639
+ #
640
+ # @!attribute [rw] source
641
+ # Information about the build input source code for the build project.
642
+ # @return [Types::ProjectSource]
643
+ #
644
+ # @!attribute [rw] secondary_sources
645
+ # An array of `ProjectSource` objects that define the sources for the
646
+ # batch build.
647
+ # @return [Array<Types::ProjectSource>]
648
+ #
649
+ # @!attribute [rw] secondary_source_versions
650
+ # An array of `ProjectSourceVersion` objects. Each
651
+ # `ProjectSourceVersion` must be one of:
652
+ #
653
+ # * For AWS CodeCommit: the commit ID, branch, or Git tag to use.
654
+ #
655
+ # * For GitHub: the commit ID, pull request ID, branch name, or tag
656
+ # name that corresponds to the version of the source code you want
657
+ # to build. If a pull request ID is specified, it must use the
658
+ # format `pr/pull-request-ID` (for example, `pr/25`). If a branch
659
+ # name is specified, the branch's HEAD commit ID is used. If not
660
+ # specified, the default branch's HEAD commit ID is used.
661
+ #
662
+ # * For Bitbucket: the commit ID, branch name, or tag name that
663
+ # corresponds to the version of the source code you want to build.
664
+ # If a branch name is specified, the branch's HEAD commit ID is
665
+ # used. If not specified, the default branch's HEAD commit ID is
666
+ # used.
667
+ #
668
+ # * For Amazon Simple Storage Service (Amazon S3): the version ID of
669
+ # the object that represents the build input ZIP file to use.
670
+ # @return [Array<Types::ProjectSourceVersion>]
671
+ #
672
+ # @!attribute [rw] artifacts
673
+ # A `BuildArtifacts` object the defines the build artifacts for this
674
+ # batch build.
675
+ # @return [Types::BuildArtifacts]
676
+ #
677
+ # @!attribute [rw] secondary_artifacts
678
+ # An array of `BuildArtifacts` objects the define the build artifacts
679
+ # for this batch build.
680
+ # @return [Array<Types::BuildArtifacts>]
681
+ #
682
+ # @!attribute [rw] cache
683
+ # Information about the cache for the build project.
684
+ # @return [Types::ProjectCache]
685
+ #
686
+ # @!attribute [rw] environment
687
+ # Information about the build environment of the build project.
688
+ # @return [Types::ProjectEnvironment]
689
+ #
690
+ # @!attribute [rw] service_role
691
+ # The name of a service role used for builds in the batch.
692
+ # @return [String]
693
+ #
694
+ # @!attribute [rw] log_config
695
+ # Information about logs for a build project. These can be logs in
696
+ # Amazon CloudWatch Logs, built in a specified S3 bucket, or both.
697
+ # @return [Types::LogsConfig]
698
+ #
699
+ # @!attribute [rw] build_timeout_in_minutes
700
+ # Specifies the maximum amount of time, in minutes, that the build in
701
+ # a batch must be completed in.
702
+ # @return [Integer]
703
+ #
704
+ # @!attribute [rw] queued_timeout_in_minutes
705
+ # Specifies the amount of time, in minutes, that the batch build is
706
+ # allowed to be queued before it times out.
707
+ # @return [Integer]
708
+ #
709
+ # @!attribute [rw] complete
710
+ # Indicates if the batch build is complete.
711
+ # @return [Boolean]
712
+ #
713
+ # @!attribute [rw] initiator
714
+ # The entity that started the batch build. Valid values include:
715
+ #
716
+ # * If AWS CodePipeline started the build, the pipeline's name (for
717
+ # example, `codepipeline/my-demo-pipeline`).
718
+ #
719
+ # * If an AWS Identity and Access Management (IAM) user started the
720
+ # build, the user's name.
721
+ #
722
+ # * If the Jenkins plugin for AWS CodeBuild started the build, the
723
+ # string `CodeBuild-Jenkins-Plugin`.
724
+ # @return [String]
725
+ #
726
+ # @!attribute [rw] vpc_config
727
+ # Information about the VPC configuration that AWS CodeBuild accesses.
728
+ # @return [Types::VpcConfig]
729
+ #
730
+ # @!attribute [rw] encryption_key
731
+ # The AWS Key Management Service (AWS KMS) customer master key (CMK)
732
+ # to be used for encrypting the batch build output artifacts.
733
+ #
734
+ # <note markdown="1"> You can use a cross-account KMS key to encrypt the build output
735
+ # artifacts if your service role has permission to that key.
736
+ #
737
+ # </note>
738
+ #
739
+ # You can specify either the Amazon Resource Name (ARN) of the CMK or,
740
+ # if available, the CMK's alias (using the format
741
+ # `alias/<alias-name>`).
742
+ # @return [String]
743
+ #
744
+ # @!attribute [rw] build_batch_number
745
+ # The number of the batch build. For each project, the
746
+ # `buildBatchNumber` of its first batch build is `1`. The
747
+ # `buildBatchNumber` of each subsequent batch build is incremented by
748
+ # `1`. If a batch build is deleted, the `buildBatchNumber` of other
749
+ # batch builds does not change.
750
+ # @return [Integer]
751
+ #
752
+ # @!attribute [rw] file_system_locations
753
+ # An array of `ProjectFileSystemLocation` objects for the batch build
754
+ # project. A `ProjectFileSystemLocation` object specifies the
755
+ # `identifier`, `location`, `mountOptions`, `mountPoint`, and `type`
756
+ # of a file system created using Amazon Elastic File System.
757
+ # @return [Array<Types::ProjectFileSystemLocation>]
758
+ #
759
+ # @!attribute [rw] build_batch_config
760
+ # Contains configuration information about a batch build project.
761
+ # @return [Types::ProjectBuildBatchConfig]
762
+ #
763
+ # @!attribute [rw] build_groups
764
+ # An array of `BuildGroup` objects that define the build groups for
765
+ # the batch build.
766
+ # @return [Array<Types::BuildGroup>]
767
+ #
768
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BuildBatch AWS API Documentation
769
+ #
770
+ class BuildBatch < Struct.new(
519
771
  :id,
520
- :status_code)
772
+ :arn,
773
+ :start_time,
774
+ :end_time,
775
+ :current_phase,
776
+ :build_batch_status,
777
+ :source_version,
778
+ :resolved_source_version,
779
+ :project_name,
780
+ :phases,
781
+ :source,
782
+ :secondary_sources,
783
+ :secondary_source_versions,
784
+ :artifacts,
785
+ :secondary_artifacts,
786
+ :cache,
787
+ :environment,
788
+ :service_role,
789
+ :log_config,
790
+ :build_timeout_in_minutes,
791
+ :queued_timeout_in_minutes,
792
+ :complete,
793
+ :initiator,
794
+ :vpc_config,
795
+ :encryption_key,
796
+ :build_batch_number,
797
+ :file_system_locations,
798
+ :build_batch_config,
799
+ :build_groups)
521
800
  SENSITIVE = []
522
801
  include Aws::Structure
523
802
  end
524
803
 
525
- # Information about a stage for a build.
804
+ # Specifies filters when retrieving batch builds.
805
+ #
806
+ # @note When making an API call, you may pass BuildBatchFilter
807
+ # data as a hash:
808
+ #
809
+ # {
810
+ # status: "SUCCEEDED", # accepts SUCCEEDED, FAILED, FAULT, TIMED_OUT, IN_PROGRESS, STOPPED
811
+ # }
812
+ #
813
+ # @!attribute [rw] status
814
+ # The status of the batch builds to retrieve. Only batch builds that
815
+ # have this status will be retrieved.
816
+ # @return [String]
817
+ #
818
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BuildBatchFilter AWS API Documentation
819
+ #
820
+ class BuildBatchFilter < Struct.new(
821
+ :status)
822
+ SENSITIVE = []
823
+ include Aws::Structure
824
+ end
825
+
826
+ # Contains information about a stage for a batch build.
526
827
  #
527
828
  # @!attribute [rw] phase_type
528
- # The name of the build phase. Valid values include:
829
+ # The name of the batch build phase. Valid values include:
529
830
  #
530
- # * `BUILD`\: Core build activities typically occur in this build
531
- # phase.
831
+ # COMBINE\_ARTIFACTS
532
832
  #
533
- # * `COMPLETED`\: The build has been completed.
833
+ # : Build output artifacts are being combined and uploaded to the
834
+ # output location.
534
835
  #
535
- # * `DOWNLOAD_SOURCE`\: Source code is being downloaded in this build
536
- # phase.
836
+ # DOWNLOAD\_BATCHSPEC
537
837
  #
538
- # * `FINALIZING`\: The build process is completing in this build
539
- # phase.
838
+ # : The batch build specification is being downloaded.
540
839
  #
541
- # * `INSTALL`\: Installation activities typically occur in this build
542
- # phase.
840
+ # FAILED
543
841
  #
544
- # * `POST_BUILD`\: Post-build activities typically occur in this build
545
- # phase.
842
+ # : One or more of the builds failed.
546
843
  #
547
- # * `PRE_BUILD`\: Pre-build activities typically occur in this build
548
- # phase.
844
+ # IN\_PROGRESS
549
845
  #
550
- # * `PROVISIONING`\: The build environment is being set up.
846
+ # : The batch build is in progress.
551
847
  #
552
- # * `QUEUED`\: The build has been submitted and is queued behind other
553
- # submitted builds.
848
+ # STOPPED
554
849
  #
555
- # * `SUBMITTED`\: The build has been submitted.
850
+ # : The batch build was stopped.
556
851
  #
557
- # * `UPLOAD_ARTIFACTS`\: Build output artifacts are being uploaded to
558
- # the output location.
852
+ # SUBMITTED
853
+ #
854
+ # : The btach build has been submitted.
855
+ #
856
+ # SUCCEEDED
857
+ #
858
+ # : The batch build succeeded.
559
859
  # @return [String]
560
860
  #
561
861
  # @!attribute [rw] phase_status
562
- # The current status of the build phase. Valid values include:
862
+ # The current status of the batch build phase. Valid values include:
563
863
  #
564
- # * `FAILED`\: The build phase failed.
864
+ # FAILED
565
865
  #
566
- # * `FAULT`\: The build phase faulted.
866
+ # : The build phase failed.
567
867
  #
568
- # * `IN_PROGRESS`\: The build phase is still in progress.
868
+ # FAULT
569
869
  #
570
- # * `QUEUED`\: The build has been submitted and is queued behind other
571
- # submitted builds.
870
+ # : The build phase faulted.
871
+ #
872
+ # IN\_PROGRESS
873
+ #
874
+ # : The build phase is still in progress.
875
+ #
876
+ # QUEUED
877
+ #
878
+ # : The build has been submitted and is queued behind other submitted
879
+ # builds.
880
+ #
881
+ # STOPPED
882
+ #
883
+ # : The build phase stopped.
884
+ #
885
+ # SUCCEEDED
572
886
  #
573
- # * `STOPPED`\: The build phase stopped.
887
+ # : The build phase succeeded.
574
888
  #
575
- # * `SUCCEEDED`\: The build phase succeeded.
889
+ # TIMED\_OUT
576
890
  #
577
- # * `TIMED_OUT`\: The build phase timed out.
891
+ # : The build phase timed out.
578
892
  # @return [String]
579
893
  #
580
894
  # @!attribute [rw] start_time
581
- # When the build phase started, expressed in Unix time format.
895
+ # When the batch build phase started, expressed in Unix time format.
582
896
  # @return [Time]
583
897
  #
584
898
  # @!attribute [rw] end_time
585
- # When the build phase ended, expressed in Unix time format.
899
+ # When the batch build phase ended, expressed in Unix time format.
586
900
  # @return [Time]
587
901
  #
588
902
  # @!attribute [rw] duration_in_seconds
589
903
  # How long, in seconds, between the starting and ending times of the
590
- # build's phase.
904
+ # batch build's phase.
591
905
  # @return [Integer]
592
906
  #
593
907
  # @!attribute [rw] contexts
594
- # Additional information about a build phase, especially to help
595
- # troubleshoot a failed build.
908
+ # Additional information about the batch build phase. Especially to
909
+ # help troubleshoot a failed btach build.
596
910
  # @return [Array<Types::PhaseContext>]
597
911
  #
598
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BuildPhase AWS API Documentation
912
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BuildBatchPhase AWS API Documentation
599
913
  #
600
- class BuildPhase < Struct.new(
914
+ class BuildBatchPhase < Struct.new(
601
915
  :phase_type,
602
916
  :phase_status,
603
917
  :start_time,
@@ -608,10 +922,295 @@ module Aws::CodeBuild
608
922
  include Aws::Structure
609
923
  end
610
924
 
611
- # Information about Amazon CloudWatch Logs for a build project.
925
+ # Contains information about a batch build build group. Build groups are
926
+ # used to combine builds that can run in parallel, while still being
927
+ # able to set dependencies on other build groups.
612
928
  #
613
- # @note When making an API call, you may pass CloudWatchLogsConfig
614
- # data as a hash:
929
+ # @!attribute [rw] identifier
930
+ # Contains the identifier of the build group.
931
+ # @return [String]
932
+ #
933
+ # @!attribute [rw] depends_on
934
+ # An array of strings that contain the identifiers of the build groups
935
+ # that this build group depends on.
936
+ # @return [Array<String>]
937
+ #
938
+ # @!attribute [rw] ignore_failure
939
+ # Specifies if failures in this build group can be ignored.
940
+ # @return [Boolean]
941
+ #
942
+ # @!attribute [rw] current_build_summary
943
+ # A `BuildSummary` object that contains a summary of the current build
944
+ # group.
945
+ # @return [Types::BuildSummary]
946
+ #
947
+ # @!attribute [rw] prior_build_summary_list
948
+ # An array of `BuildSummary` objects that contain summaries of
949
+ # previous build groups.
950
+ # @return [Array<Types::BuildSummary>]
951
+ #
952
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BuildGroup AWS API Documentation
953
+ #
954
+ class BuildGroup < Struct.new(
955
+ :identifier,
956
+ :depends_on,
957
+ :ignore_failure,
958
+ :current_build_summary,
959
+ :prior_build_summary_list)
960
+ SENSITIVE = []
961
+ include Aws::Structure
962
+ end
963
+
964
+ # Information about a build that could not be successfully deleted.
965
+ #
966
+ # @!attribute [rw] id
967
+ # The ID of the build that could not be successfully deleted.
968
+ # @return [String]
969
+ #
970
+ # @!attribute [rw] status_code
971
+ # Additional information about the build that could not be
972
+ # successfully deleted.
973
+ # @return [String]
974
+ #
975
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BuildNotDeleted AWS API Documentation
976
+ #
977
+ class BuildNotDeleted < Struct.new(
978
+ :id,
979
+ :status_code)
980
+ SENSITIVE = []
981
+ include Aws::Structure
982
+ end
983
+
984
+ # Information about a stage for a build.
985
+ #
986
+ # @!attribute [rw] phase_type
987
+ # The name of the build phase. Valid values include:
988
+ #
989
+ # * `BUILD`\: Core build activities typically occur in this build
990
+ # phase.
991
+ #
992
+ # * `COMPLETED`\: The build has been completed.
993
+ #
994
+ # * `DOWNLOAD_SOURCE`\: Source code is being downloaded in this build
995
+ # phase.
996
+ #
997
+ # * `FINALIZING`\: The build process is completing in this build
998
+ # phase.
999
+ #
1000
+ # * `INSTALL`\: Installation activities typically occur in this build
1001
+ # phase.
1002
+ #
1003
+ # * `POST_BUILD`\: Post-build activities typically occur in this build
1004
+ # phase.
1005
+ #
1006
+ # * `PRE_BUILD`\: Pre-build activities typically occur in this build
1007
+ # phase.
1008
+ #
1009
+ # * `PROVISIONING`\: The build environment is being set up.
1010
+ #
1011
+ # * `QUEUED`\: The build has been submitted and is queued behind other
1012
+ # submitted builds.
1013
+ #
1014
+ # * `SUBMITTED`\: The build has been submitted.
1015
+ #
1016
+ # * `UPLOAD_ARTIFACTS`\: Build output artifacts are being uploaded to
1017
+ # the output location.
1018
+ # @return [String]
1019
+ #
1020
+ # @!attribute [rw] phase_status
1021
+ # The current status of the build phase. Valid values include:
1022
+ #
1023
+ # FAILED
1024
+ #
1025
+ # : The build phase failed.
1026
+ #
1027
+ # FAULT
1028
+ #
1029
+ # : The build phase faulted.
1030
+ #
1031
+ # IN\_PROGRESS
1032
+ #
1033
+ # : The build phase is still in progress.
1034
+ #
1035
+ # QUEUED
1036
+ #
1037
+ # : The build has been submitted and is queued behind other submitted
1038
+ # builds.
1039
+ #
1040
+ # STOPPED
1041
+ #
1042
+ # : The build phase stopped.
1043
+ #
1044
+ # SUCCEEDED
1045
+ #
1046
+ # : The build phase succeeded.
1047
+ #
1048
+ # TIMED\_OUT
1049
+ #
1050
+ # : The build phase timed out.
1051
+ # @return [String]
1052
+ #
1053
+ # @!attribute [rw] start_time
1054
+ # When the build phase started, expressed in Unix time format.
1055
+ # @return [Time]
1056
+ #
1057
+ # @!attribute [rw] end_time
1058
+ # When the build phase ended, expressed in Unix time format.
1059
+ # @return [Time]
1060
+ #
1061
+ # @!attribute [rw] duration_in_seconds
1062
+ # How long, in seconds, between the starting and ending times of the
1063
+ # build's phase.
1064
+ # @return [Integer]
1065
+ #
1066
+ # @!attribute [rw] contexts
1067
+ # Additional information about a build phase, especially to help
1068
+ # troubleshoot a failed build.
1069
+ # @return [Array<Types::PhaseContext>]
1070
+ #
1071
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BuildPhase AWS API Documentation
1072
+ #
1073
+ class BuildPhase < Struct.new(
1074
+ :phase_type,
1075
+ :phase_status,
1076
+ :start_time,
1077
+ :end_time,
1078
+ :duration_in_seconds,
1079
+ :contexts)
1080
+ SENSITIVE = []
1081
+ include Aws::Structure
1082
+ end
1083
+
1084
+ # Contains information that defines how the AWS CodeBuild build project
1085
+ # reports the build status to the source provider.
1086
+ #
1087
+ # @note When making an API call, you may pass BuildStatusConfig
1088
+ # data as a hash:
1089
+ #
1090
+ # {
1091
+ # context: "String",
1092
+ # target_url: "String",
1093
+ # }
1094
+ #
1095
+ # @!attribute [rw] context
1096
+ # Specifies the context of the build status CodeBuild sends to the
1097
+ # source provider. The usage of this parameter depends on the source
1098
+ # provider.
1099
+ #
1100
+ # Bitbucket
1101
+ #
1102
+ # : This parameter is used for the `name` parameter in the Bitbucket
1103
+ # commit status. For more information, see [build][1] in the
1104
+ # Bitbucket API documentation.
1105
+ #
1106
+ # GitHub/GitHub Enterprise Server
1107
+ #
1108
+ # : This parameter is used for the `context` parameter in the GitHub
1109
+ # commit status. For more information, see [Create a commit
1110
+ # status][2] in the GitHub developer guide.
1111
+ #
1112
+ #
1113
+ #
1114
+ # [1]: https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Bworkspace%7D/%7Brepo_slug%7D/commit/%7Bnode%7D/statuses/build
1115
+ # [2]: https://developer.github.com/v3/repos/statuses/#create-a-commit-status
1116
+ # @return [String]
1117
+ #
1118
+ # @!attribute [rw] target_url
1119
+ # Specifies the target url of the build status CodeBuild sends to the
1120
+ # source provider. The usage of this parameter depends on the source
1121
+ # provider.
1122
+ #
1123
+ # Bitbucket
1124
+ #
1125
+ # : This parameter is used for the `url` parameter in the Bitbucket
1126
+ # commit status. For more information, see [build][1] in the
1127
+ # Bitbucket API documentation.
1128
+ #
1129
+ # GitHub/GitHub Enterprise Server
1130
+ #
1131
+ # : This parameter is used for the `target_url` parameter in the
1132
+ # GitHub commit status. For more information, see [Create a commit
1133
+ # status][2] in the GitHub developer guide.
1134
+ #
1135
+ #
1136
+ #
1137
+ # [1]: https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Bworkspace%7D/%7Brepo_slug%7D/commit/%7Bnode%7D/statuses/build
1138
+ # [2]: https://developer.github.com/v3/repos/statuses/#create-a-commit-status
1139
+ # @return [String]
1140
+ #
1141
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BuildStatusConfig AWS API Documentation
1142
+ #
1143
+ class BuildStatusConfig < Struct.new(
1144
+ :context,
1145
+ :target_url)
1146
+ SENSITIVE = []
1147
+ include Aws::Structure
1148
+ end
1149
+
1150
+ # Contains summary information about a batch build group.
1151
+ #
1152
+ # @!attribute [rw] arn
1153
+ # The batch build ARN.
1154
+ # @return [String]
1155
+ #
1156
+ # @!attribute [rw] requested_on
1157
+ # When the build was started, expressed in Unix time format.
1158
+ # @return [Time]
1159
+ #
1160
+ # @!attribute [rw] build_status
1161
+ # The status of the build group.
1162
+ #
1163
+ # FAILED
1164
+ #
1165
+ # : The build group failed.
1166
+ #
1167
+ # FAULT
1168
+ #
1169
+ # : The build group faulted.
1170
+ #
1171
+ # IN\_PROGRESS
1172
+ #
1173
+ # : The build group is still in progress.
1174
+ #
1175
+ # STOPPED
1176
+ #
1177
+ # : The build group stopped.
1178
+ #
1179
+ # SUCCEEDED
1180
+ #
1181
+ # : The build group succeeded.
1182
+ #
1183
+ # TIMED\_OUT
1184
+ #
1185
+ # : The build group timed out.
1186
+ # @return [String]
1187
+ #
1188
+ # @!attribute [rw] primary_artifact
1189
+ # A `ResolvedArtifact` object that represents the primary build
1190
+ # artifacts for the build group.
1191
+ # @return [Types::ResolvedArtifact]
1192
+ #
1193
+ # @!attribute [rw] secondary_artifacts
1194
+ # An array of `ResolvedArtifact` objects that represents the secondary
1195
+ # build artifacts for the build group.
1196
+ # @return [Array<Types::ResolvedArtifact>]
1197
+ #
1198
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BuildSummary AWS API Documentation
1199
+ #
1200
+ class BuildSummary < Struct.new(
1201
+ :arn,
1202
+ :requested_on,
1203
+ :build_status,
1204
+ :primary_artifact,
1205
+ :secondary_artifacts)
1206
+ SENSITIVE = []
1207
+ include Aws::Structure
1208
+ end
1209
+
1210
+ # Information about Amazon CloudWatch Logs for a build project.
1211
+ #
1212
+ # @note When making an API call, you may pass CloudWatchLogsConfig
1213
+ # data as a hash:
615
1214
  #
616
1215
  # {
617
1216
  # status: "ENABLED", # required, accepts ENABLED, DISABLED
@@ -658,6 +1257,120 @@ module Aws::CodeBuild
658
1257
  include Aws::Structure
659
1258
  end
660
1259
 
1260
+ # Contains code coverage report information.
1261
+ #
1262
+ # Line coverage measures how many statements your tests cover. A
1263
+ # statement is a single instruction, not including comments,
1264
+ # conditionals, etc.
1265
+ #
1266
+ # Branch coverage determines if your tests cover every possible branch
1267
+ # of a control structure, such as an `if` or `case` statement.
1268
+ #
1269
+ # @!attribute [rw] id
1270
+ # The identifier of the code coverage report.
1271
+ # @return [String]
1272
+ #
1273
+ # @!attribute [rw] report_arn
1274
+ # The ARN of the report.
1275
+ # @return [String]
1276
+ #
1277
+ # @!attribute [rw] file_path
1278
+ # The path of the test report file.
1279
+ # @return [String]
1280
+ #
1281
+ # @!attribute [rw] line_coverage_percentage
1282
+ # The percentage of lines that are covered by your tests.
1283
+ # @return [Float]
1284
+ #
1285
+ # @!attribute [rw] lines_covered
1286
+ # The number of lines that are covered by your tests.
1287
+ # @return [Integer]
1288
+ #
1289
+ # @!attribute [rw] lines_missed
1290
+ # The number of lines that are not covered by your tests.
1291
+ # @return [Integer]
1292
+ #
1293
+ # @!attribute [rw] branch_coverage_percentage
1294
+ # The percentage of branches that are covered by your tests.
1295
+ # @return [Float]
1296
+ #
1297
+ # @!attribute [rw] branches_covered
1298
+ # The number of conditional branches that are covered by your tests.
1299
+ # @return [Integer]
1300
+ #
1301
+ # @!attribute [rw] branches_missed
1302
+ # The number of conditional branches that are not covered by your
1303
+ # tests.
1304
+ # @return [Integer]
1305
+ #
1306
+ # @!attribute [rw] expired
1307
+ # The date and time that the tests were run.
1308
+ # @return [Time]
1309
+ #
1310
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/CodeCoverage AWS API Documentation
1311
+ #
1312
+ class CodeCoverage < Struct.new(
1313
+ :id,
1314
+ :report_arn,
1315
+ :file_path,
1316
+ :line_coverage_percentage,
1317
+ :lines_covered,
1318
+ :lines_missed,
1319
+ :branch_coverage_percentage,
1320
+ :branches_covered,
1321
+ :branches_missed,
1322
+ :expired)
1323
+ SENSITIVE = []
1324
+ include Aws::Structure
1325
+ end
1326
+
1327
+ # Contains a summary of a code coverage report.
1328
+ #
1329
+ # Line coverage measures how many statements your tests cover. A
1330
+ # statement is a single instruction, not including comments,
1331
+ # conditionals, etc.
1332
+ #
1333
+ # Branch coverage determines if your tests cover every possible branch
1334
+ # of a control structure, such as an `if` or `case` statement.
1335
+ #
1336
+ # @!attribute [rw] line_coverage_percentage
1337
+ # The percentage of lines that are covered by your tests.
1338
+ # @return [Float]
1339
+ #
1340
+ # @!attribute [rw] lines_covered
1341
+ # The number of lines that are covered by your tests.
1342
+ # @return [Integer]
1343
+ #
1344
+ # @!attribute [rw] lines_missed
1345
+ # The number of lines that are not covered by your tests.
1346
+ # @return [Integer]
1347
+ #
1348
+ # @!attribute [rw] branch_coverage_percentage
1349
+ # The percentage of branches that are covered by your tests.
1350
+ # @return [Float]
1351
+ #
1352
+ # @!attribute [rw] branches_covered
1353
+ # The number of conditional branches that are covered by your tests.
1354
+ # @return [Integer]
1355
+ #
1356
+ # @!attribute [rw] branches_missed
1357
+ # The number of conditional branches that are not covered by your
1358
+ # tests.
1359
+ # @return [Integer]
1360
+ #
1361
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/CodeCoverageReportSummary AWS API Documentation
1362
+ #
1363
+ class CodeCoverageReportSummary < Struct.new(
1364
+ :line_coverage_percentage,
1365
+ :lines_covered,
1366
+ :lines_missed,
1367
+ :branch_coverage_percentage,
1368
+ :branches_covered,
1369
+ :branches_missed)
1370
+ SENSITIVE = []
1371
+ include Aws::Structure
1372
+ end
1373
+
661
1374
  # @note When making an API call, you may pass CreateProjectInput
662
1375
  # data as a hash:
663
1376
  #
@@ -677,6 +1390,10 @@ module Aws::CodeBuild
677
1390
  # resource: "String",
678
1391
  # },
679
1392
  # report_build_status: false,
1393
+ # build_status_config: {
1394
+ # context: "String",
1395
+ # target_url: "String",
1396
+ # },
680
1397
  # insecure_ssl: false,
681
1398
  # source_identifier: "String",
682
1399
  # },
@@ -694,6 +1411,10 @@ module Aws::CodeBuild
694
1411
  # resource: "String",
695
1412
  # },
696
1413
  # report_build_status: false,
1414
+ # build_status_config: {
1415
+ # context: "String",
1416
+ # target_url: "String",
1417
+ # },
697
1418
  # insecure_ssl: false,
698
1419
  # source_identifier: "String",
699
1420
  # },
@@ -735,7 +1456,7 @@ module Aws::CodeBuild
735
1456
  # modes: ["LOCAL_DOCKER_LAYER_CACHE"], # accepts LOCAL_DOCKER_LAYER_CACHE, LOCAL_SOURCE_CACHE, LOCAL_CUSTOM_CACHE
736
1457
  # },
737
1458
  # environment: { # required
738
- # type: "WINDOWS_CONTAINER", # required, accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER
1459
+ # type: "WINDOWS_CONTAINER", # required, accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER, WINDOWS_SERVER_2019_CONTAINER
739
1460
  # image: "NonEmptyString", # required
740
1461
  # compute_type: "BUILD_GENERAL1_SMALL", # required, accepts BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE, BUILD_GENERAL1_2XLARGE
741
1462
  # environment_variables: [
@@ -790,6 +1511,15 @@ module Aws::CodeBuild
790
1511
  # mount_options: "String",
791
1512
  # },
792
1513
  # ],
1514
+ # build_batch_config: {
1515
+ # service_role: "NonEmptyString",
1516
+ # combine_artifacts: false,
1517
+ # restrictions: {
1518
+ # maximum_builds_allowed: 1,
1519
+ # compute_types_allowed: ["NonEmptyString"],
1520
+ # },
1521
+ # timeout_in_mins: 1,
1522
+ # },
793
1523
  # }
794
1524
  #
795
1525
  # @!attribute [rw] name
@@ -894,8 +1624,8 @@ module Aws::CodeBuild
894
1624
  # </note>
895
1625
  #
896
1626
  # You can specify either the Amazon Resource Name (ARN) of the CMK or,
897
- # if available, the CMK's alias (using the format `alias/alias-name
898
- # `).
1627
+ # if available, the CMK's alias (using the format
1628
+ # `alias/<alias-name>`).
899
1629
  # @return [String]
900
1630
  #
901
1631
  # @!attribute [rw] tags
@@ -929,6 +1659,11 @@ module Aws::CodeBuild
929
1659
  # of a file system created using Amazon Elastic File System.
930
1660
  # @return [Array<Types::ProjectFileSystemLocation>]
931
1661
  #
1662
+ # @!attribute [rw] build_batch_config
1663
+ # A ProjectBuildBatchConfig object that defines the batch build
1664
+ # options for the project.
1665
+ # @return [Types::ProjectBuildBatchConfig]
1666
+ #
932
1667
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/CreateProjectInput AWS API Documentation
933
1668
  #
934
1669
  class CreateProjectInput < Struct.new(
@@ -950,7 +1685,8 @@ module Aws::CodeBuild
950
1685
  :vpc_config,
951
1686
  :badge_enabled,
952
1687
  :logs_config,
953
- :file_system_locations)
1688
+ :file_system_locations,
1689
+ :build_batch_config)
954
1690
  SENSITIVE = []
955
1691
  include Aws::Structure
956
1692
  end
@@ -972,7 +1708,7 @@ module Aws::CodeBuild
972
1708
  #
973
1709
  # {
974
1710
  # name: "ReportGroupName", # required
975
- # type: "TEST", # required, accepts TEST
1711
+ # type: "TEST", # required, accepts TEST, CODE_COVERAGE
976
1712
  # export_config: { # required
977
1713
  # export_config_type: "S3", # accepts S3, NO_EXPORT
978
1714
  # s3_destination: {
@@ -1049,6 +1785,7 @@ module Aws::CodeBuild
1049
1785
  # },
1050
1786
  # ],
1051
1787
  # ],
1788
+ # build_type: "BUILD", # accepts BUILD, BUILD_BATCH
1052
1789
  # }
1053
1790
  #
1054
1791
  # @!attribute [rw] project_name
@@ -1077,12 +1814,17 @@ module Aws::CodeBuild
1077
1814
  # its filters must pass.
1078
1815
  # @return [Array<Array<Types::WebhookFilter>>]
1079
1816
  #
1817
+ # @!attribute [rw] build_type
1818
+ # Specifies the type of build this webhook will trigger.
1819
+ # @return [String]
1820
+ #
1080
1821
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/CreateWebhookInput AWS API Documentation
1081
1822
  #
1082
1823
  class CreateWebhookInput < Struct.new(
1083
1824
  :project_name,
1084
1825
  :branch_filter,
1085
- :filter_groups)
1826
+ :filter_groups,
1827
+ :build_type)
1086
1828
  SENSITIVE = []
1087
1829
  include Aws::Structure
1088
1830
  end
@@ -1100,26 +1842,95 @@ module Aws::CodeBuild
1100
1842
  include Aws::Structure
1101
1843
  end
1102
1844
 
1103
- # @note When making an API call, you may pass DeleteProjectInput
1104
- # data as a hash:
1845
+ # Contains information about the debug session for a build. For more
1846
+ # information, see [Viewing a running build in Session Manager][1].
1105
1847
  #
1106
- # {
1107
- # name: "NonEmptyString", # required
1108
- # }
1109
1848
  #
1110
- # @!attribute [rw] name
1111
- # The name of the build project.
1849
+ #
1850
+ # [1]: https://docs.aws.amazon.com/codebuild/latest/userguide/session-manager.html
1851
+ #
1852
+ # @!attribute [rw] session_enabled
1853
+ # Specifies if session debugging is enabled for this build.
1854
+ # @return [Boolean]
1855
+ #
1856
+ # @!attribute [rw] session_target
1857
+ # Contains the identifier of the Session Manager session used for the
1858
+ # build. To work with the paused build, you open this session to
1859
+ # examine, control, and resume the build.
1112
1860
  # @return [String]
1113
1861
  #
1114
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/DeleteProjectInput AWS API Documentation
1862
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/DebugSession AWS API Documentation
1115
1863
  #
1116
- class DeleteProjectInput < Struct.new(
1117
- :name)
1864
+ class DebugSession < Struct.new(
1865
+ :session_enabled,
1866
+ :session_target)
1118
1867
  SENSITIVE = []
1119
1868
  include Aws::Structure
1120
1869
  end
1121
1870
 
1122
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/DeleteProjectOutput AWS API Documentation
1871
+ # @note When making an API call, you may pass DeleteBuildBatchInput
1872
+ # data as a hash:
1873
+ #
1874
+ # {
1875
+ # id: "NonEmptyString", # required
1876
+ # }
1877
+ #
1878
+ # @!attribute [rw] id
1879
+ # The identifier of the batch build to delete.
1880
+ # @return [String]
1881
+ #
1882
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/DeleteBuildBatchInput AWS API Documentation
1883
+ #
1884
+ class DeleteBuildBatchInput < Struct.new(
1885
+ :id)
1886
+ SENSITIVE = []
1887
+ include Aws::Structure
1888
+ end
1889
+
1890
+ # @!attribute [rw] status_code
1891
+ # The status code.
1892
+ # @return [String]
1893
+ #
1894
+ # @!attribute [rw] builds_deleted
1895
+ # An array of strings that contain the identifiers of the builds that
1896
+ # were deleted.
1897
+ # @return [Array<String>]
1898
+ #
1899
+ # @!attribute [rw] builds_not_deleted
1900
+ # An array of `BuildNotDeleted` objects that specify the builds that
1901
+ # could not be deleted.
1902
+ # @return [Array<Types::BuildNotDeleted>]
1903
+ #
1904
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/DeleteBuildBatchOutput AWS API Documentation
1905
+ #
1906
+ class DeleteBuildBatchOutput < Struct.new(
1907
+ :status_code,
1908
+ :builds_deleted,
1909
+ :builds_not_deleted)
1910
+ SENSITIVE = []
1911
+ include Aws::Structure
1912
+ end
1913
+
1914
+ # @note When making an API call, you may pass DeleteProjectInput
1915
+ # data as a hash:
1916
+ #
1917
+ # {
1918
+ # name: "NonEmptyString", # required
1919
+ # }
1920
+ #
1921
+ # @!attribute [rw] name
1922
+ # The name of the build project.
1923
+ # @return [String]
1924
+ #
1925
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/DeleteProjectInput AWS API Documentation
1926
+ #
1927
+ class DeleteProjectInput < Struct.new(
1928
+ :name)
1929
+ SENSITIVE = []
1930
+ include Aws::Structure
1931
+ end
1932
+
1933
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/DeleteProjectOutput AWS API Documentation
1123
1934
  #
1124
1935
  class DeleteProjectOutput < Aws::EmptyStructure; end
1125
1936
 
@@ -1246,6 +2057,92 @@ module Aws::CodeBuild
1246
2057
  #
1247
2058
  class DeleteWebhookOutput < Aws::EmptyStructure; end
1248
2059
 
2060
+ # @note When making an API call, you may pass DescribeCodeCoveragesInput
2061
+ # data as a hash:
2062
+ #
2063
+ # {
2064
+ # report_arn: "NonEmptyString", # required
2065
+ # next_token: "String",
2066
+ # max_results: 1,
2067
+ # sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
2068
+ # sort_by: "LINE_COVERAGE_PERCENTAGE", # accepts LINE_COVERAGE_PERCENTAGE, FILE_PATH
2069
+ # min_line_coverage_percentage: 1.0,
2070
+ # max_line_coverage_percentage: 1.0,
2071
+ # }
2072
+ #
2073
+ # @!attribute [rw] report_arn
2074
+ # The ARN of the report for which test cases are returned.
2075
+ # @return [String]
2076
+ #
2077
+ # @!attribute [rw] next_token
2078
+ # The `nextToken` value returned from a previous call to
2079
+ # `DescribeCodeCoverages`. This specifies the next item to return. To
2080
+ # return the beginning of the list, exclude this parameter.
2081
+ # @return [String]
2082
+ #
2083
+ # @!attribute [rw] max_results
2084
+ # The maximum number of results to return.
2085
+ # @return [Integer]
2086
+ #
2087
+ # @!attribute [rw] sort_order
2088
+ # Specifies if the results are sorted in ascending or descending
2089
+ # order.
2090
+ # @return [String]
2091
+ #
2092
+ # @!attribute [rw] sort_by
2093
+ # Specifies how the results are sorted. Possible values are:
2094
+ #
2095
+ # FILE\_PATH
2096
+ #
2097
+ # : The results are sorted by file path.
2098
+ #
2099
+ # LINE\_COVERAGE\_PERCENTAGE
2100
+ #
2101
+ # : The results are sorted by the percentage of lines that are
2102
+ # covered.
2103
+ # @return [String]
2104
+ #
2105
+ # @!attribute [rw] min_line_coverage_percentage
2106
+ # The minimum line coverage percentage to report.
2107
+ # @return [Float]
2108
+ #
2109
+ # @!attribute [rw] max_line_coverage_percentage
2110
+ # The maximum line coverage percentage to report.
2111
+ # @return [Float]
2112
+ #
2113
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/DescribeCodeCoveragesInput AWS API Documentation
2114
+ #
2115
+ class DescribeCodeCoveragesInput < Struct.new(
2116
+ :report_arn,
2117
+ :next_token,
2118
+ :max_results,
2119
+ :sort_order,
2120
+ :sort_by,
2121
+ :min_line_coverage_percentage,
2122
+ :max_line_coverage_percentage)
2123
+ SENSITIVE = []
2124
+ include Aws::Structure
2125
+ end
2126
+
2127
+ # @!attribute [rw] next_token
2128
+ # If there are more items to return, this contains a token that is
2129
+ # passed to a subsequent call to `DescribeCodeCoverages` to retrieve
2130
+ # the next set of items.
2131
+ # @return [String]
2132
+ #
2133
+ # @!attribute [rw] code_coverages
2134
+ # An array of `CodeCoverage` objects that contain the results.
2135
+ # @return [Array<Types::CodeCoverage>]
2136
+ #
2137
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/DescribeCodeCoveragesOutput AWS API Documentation
2138
+ #
2139
+ class DescribeCodeCoveragesOutput < Struct.new(
2140
+ :next_token,
2141
+ :code_coverages)
2142
+ SENSITIVE = []
2143
+ include Aws::Structure
2144
+ end
2145
+
1249
2146
  # @note When making an API call, you may pass DescribeTestCasesInput
1250
2147
  # data as a hash:
1251
2148
  #
@@ -1616,6 +2513,148 @@ module Aws::CodeBuild
1616
2513
  #
1617
2514
  class InvalidateProjectCacheOutput < Aws::EmptyStructure; end
1618
2515
 
2516
+ # @note When making an API call, you may pass ListBuildBatchesForProjectInput
2517
+ # data as a hash:
2518
+ #
2519
+ # {
2520
+ # project_name: "NonEmptyString",
2521
+ # filter: {
2522
+ # status: "SUCCEEDED", # accepts SUCCEEDED, FAILED, FAULT, TIMED_OUT, IN_PROGRESS, STOPPED
2523
+ # },
2524
+ # max_results: 1,
2525
+ # sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
2526
+ # next_token: "String",
2527
+ # }
2528
+ #
2529
+ # @!attribute [rw] project_name
2530
+ # The name of the project.
2531
+ # @return [String]
2532
+ #
2533
+ # @!attribute [rw] filter
2534
+ # A `BuildBatchFilter` object that specifies the filters for the
2535
+ # search.
2536
+ # @return [Types::BuildBatchFilter]
2537
+ #
2538
+ # @!attribute [rw] max_results
2539
+ # The maximum number of results to return.
2540
+ # @return [Integer]
2541
+ #
2542
+ # @!attribute [rw] sort_order
2543
+ # Specifies the sort order of the returned items. Valid values
2544
+ # include:
2545
+ #
2546
+ # * `ASCENDING`\: List the batch build identifiers in ascending order
2547
+ # by identifier.
2548
+ #
2549
+ # * `DESCENDING`\: List the batch build identifiers in descending
2550
+ # order by identifier.
2551
+ # @return [String]
2552
+ #
2553
+ # @!attribute [rw] next_token
2554
+ # The `nextToken` value returned from a previous call to
2555
+ # `ListBuildBatchesForProject`. This specifies the next item to
2556
+ # return. To return the beginning of the list, exclude this parameter.
2557
+ # @return [String]
2558
+ #
2559
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ListBuildBatchesForProjectInput AWS API Documentation
2560
+ #
2561
+ class ListBuildBatchesForProjectInput < Struct.new(
2562
+ :project_name,
2563
+ :filter,
2564
+ :max_results,
2565
+ :sort_order,
2566
+ :next_token)
2567
+ SENSITIVE = []
2568
+ include Aws::Structure
2569
+ end
2570
+
2571
+ # @!attribute [rw] ids
2572
+ # An array of strings that contains the batch build identifiers.
2573
+ # @return [Array<String>]
2574
+ #
2575
+ # @!attribute [rw] next_token
2576
+ # If there are more items to return, this contains a token that is
2577
+ # passed to a subsequent call to `ListBuildBatchesForProject` to
2578
+ # retrieve the next set of items.
2579
+ # @return [String]
2580
+ #
2581
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ListBuildBatchesForProjectOutput AWS API Documentation
2582
+ #
2583
+ class ListBuildBatchesForProjectOutput < Struct.new(
2584
+ :ids,
2585
+ :next_token)
2586
+ SENSITIVE = []
2587
+ include Aws::Structure
2588
+ end
2589
+
2590
+ # @note When making an API call, you may pass ListBuildBatchesInput
2591
+ # data as a hash:
2592
+ #
2593
+ # {
2594
+ # filter: {
2595
+ # status: "SUCCEEDED", # accepts SUCCEEDED, FAILED, FAULT, TIMED_OUT, IN_PROGRESS, STOPPED
2596
+ # },
2597
+ # max_results: 1,
2598
+ # sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
2599
+ # next_token: "String",
2600
+ # }
2601
+ #
2602
+ # @!attribute [rw] filter
2603
+ # A `BuildBatchFilter` object that specifies the filters for the
2604
+ # search.
2605
+ # @return [Types::BuildBatchFilter]
2606
+ #
2607
+ # @!attribute [rw] max_results
2608
+ # The maximum number of results to return.
2609
+ # @return [Integer]
2610
+ #
2611
+ # @!attribute [rw] sort_order
2612
+ # Specifies the sort order of the returned items. Valid values
2613
+ # include:
2614
+ #
2615
+ # * `ASCENDING`\: List the batch build identifiers in ascending order
2616
+ # by identifier.
2617
+ #
2618
+ # * `DESCENDING`\: List the batch build identifiers in descending
2619
+ # order by identifier.
2620
+ # @return [String]
2621
+ #
2622
+ # @!attribute [rw] next_token
2623
+ # The `nextToken` value returned from a previous call to
2624
+ # `ListBuildBatches`. This specifies the next item to return. To
2625
+ # return the beginning of the list, exclude this parameter.
2626
+ # @return [String]
2627
+ #
2628
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ListBuildBatchesInput AWS API Documentation
2629
+ #
2630
+ class ListBuildBatchesInput < Struct.new(
2631
+ :filter,
2632
+ :max_results,
2633
+ :sort_order,
2634
+ :next_token)
2635
+ SENSITIVE = []
2636
+ include Aws::Structure
2637
+ end
2638
+
2639
+ # @!attribute [rw] ids
2640
+ # An array of strings that contains the batch build identifiers.
2641
+ # @return [Array<String>]
2642
+ #
2643
+ # @!attribute [rw] next_token
2644
+ # If there are more items to return, this contains a token that is
2645
+ # passed to a subsequent call to `ListBuildBatches` to retrieve the
2646
+ # next set of items.
2647
+ # @return [String]
2648
+ #
2649
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ListBuildBatchesOutput AWS API Documentation
2650
+ #
2651
+ class ListBuildBatchesOutput < Struct.new(
2652
+ :ids,
2653
+ :next_token)
2654
+ SENSITIVE = []
2655
+ include Aws::Structure
2656
+ end
2657
+
1619
2658
  # @note When making an API call, you may pass ListBuildsForProjectInput
1620
2659
  # data as a hash:
1621
2660
  #
@@ -1972,7 +3011,7 @@ module Aws::CodeBuild
1972
3011
  # @return [String]
1973
3012
  #
1974
3013
  # @!attribute [rw] reports
1975
- # The list of returned report group ARNs.
3014
+ # The list of report ARNs.
1976
3015
  # @return [Array<String>]
1977
3016
  #
1978
3017
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ListReportsForReportGroupOutput AWS API Documentation
@@ -2495,8 +3534,8 @@ module Aws::CodeBuild
2495
3534
  # </note>
2496
3535
  #
2497
3536
  # You can specify either the Amazon Resource Name (ARN) of the CMK or,
2498
- # if available, the CMK's alias (using the format `alias/alias-name
2499
- # `).
3537
+ # if available, the CMK's alias (using the format
3538
+ # `alias/<alias-name>`).
2500
3539
  # @return [String]
2501
3540
  #
2502
3541
  # @!attribute [rw] tags
@@ -2541,6 +3580,11 @@ module Aws::CodeBuild
2541
3580
  # of a file system created using Amazon Elastic File System.
2542
3581
  # @return [Array<Types::ProjectFileSystemLocation>]
2543
3582
  #
3583
+ # @!attribute [rw] build_batch_config
3584
+ # A ProjectBuildBatchConfig object that defines the batch build
3585
+ # options for the project.
3586
+ # @return [Types::ProjectBuildBatchConfig]
3587
+ #
2544
3588
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/Project AWS API Documentation
2545
3589
  #
2546
3590
  class Project < Struct.new(
@@ -2566,7 +3610,8 @@ module Aws::CodeBuild
2566
3610
  :vpc_config,
2567
3611
  :badge,
2568
3612
  :logs_config,
2569
- :file_system_locations)
3613
+ :file_system_locations,
3614
+ :build_batch_config)
2570
3615
  SENSITIVE = []
2571
3616
  include Aws::Structure
2572
3617
  end
@@ -2659,7 +3704,7 @@ module Aws::CodeBuild
2659
3704
  #
2660
3705
  # For example, if `path` is set to `MyArtifacts`, `namespaceType` is
2661
3706
  # set to `BUILD_ID`, and `name` is set to `MyArtifact.zip`, the output
2662
- # artifact is stored in `MyArtifacts/build-ID/MyArtifact.zip`.
3707
+ # artifact is stored in `MyArtifacts/<build-ID>/MyArtifact.zip`.
2663
3708
  # @return [String]
2664
3709
  #
2665
3710
  # @!attribute [rw] name
@@ -2681,7 +3726,7 @@ module Aws::CodeBuild
2681
3726
  #
2682
3727
  # * If `path` is set to `MyArtifacts`, `namespaceType` is set to
2683
3728
  # `BUILD_ID`, and `name` is set to `MyArtifact.zip`, then the output
2684
- # artifact is stored in `MyArtifacts/build-ID/MyArtifact.zip`.
3729
+ # artifact is stored in `MyArtifacts/<build-ID>/MyArtifact.zip`.
2685
3730
  #
2686
3731
  # * If `path` is empty, `namespaceType` is set to `NONE`, and `name`
2687
3732
  # is set to "`/`", the output artifact is stored in the root of
@@ -2689,7 +3734,7 @@ module Aws::CodeBuild
2689
3734
  #
2690
3735
  # * If `path` is set to `MyArtifacts`, `namespaceType` is set to
2691
3736
  # `BUILD_ID`, and `name` is set to "`/`", the output artifact is
2692
- # stored in `MyArtifacts/build-ID `.
3737
+ # stored in `MyArtifacts/<build-ID>`.
2693
3738
  # @return [String]
2694
3739
  #
2695
3740
  # @!attribute [rw] packaging
@@ -2771,6 +3816,51 @@ module Aws::CodeBuild
2771
3816
  include Aws::Structure
2772
3817
  end
2773
3818
 
3819
+ # Contains configuration information about a batch build project.
3820
+ #
3821
+ # @note When making an API call, you may pass ProjectBuildBatchConfig
3822
+ # data as a hash:
3823
+ #
3824
+ # {
3825
+ # service_role: "NonEmptyString",
3826
+ # combine_artifacts: false,
3827
+ # restrictions: {
3828
+ # maximum_builds_allowed: 1,
3829
+ # compute_types_allowed: ["NonEmptyString"],
3830
+ # },
3831
+ # timeout_in_mins: 1,
3832
+ # }
3833
+ #
3834
+ # @!attribute [rw] service_role
3835
+ # Specifies the service role ARN for the batch build project.
3836
+ # @return [String]
3837
+ #
3838
+ # @!attribute [rw] combine_artifacts
3839
+ # Specifies if the build artifacts for the batch build should be
3840
+ # combined into a single artifact location.
3841
+ # @return [Boolean]
3842
+ #
3843
+ # @!attribute [rw] restrictions
3844
+ # A `BatchRestrictions` object that specifies the restrictions for the
3845
+ # batch build.
3846
+ # @return [Types::BatchRestrictions]
3847
+ #
3848
+ # @!attribute [rw] timeout_in_mins
3849
+ # Specifies the maximum amount of time, in minutes, that the batch
3850
+ # build must be completed in.
3851
+ # @return [Integer]
3852
+ #
3853
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ProjectBuildBatchConfig AWS API Documentation
3854
+ #
3855
+ class ProjectBuildBatchConfig < Struct.new(
3856
+ :service_role,
3857
+ :combine_artifacts,
3858
+ :restrictions,
3859
+ :timeout_in_mins)
3860
+ SENSITIVE = []
3861
+ include Aws::Structure
3862
+ end
3863
+
2774
3864
  # Information about the cache for the build project.
2775
3865
  #
2776
3866
  # @note When making an API call, you may pass ProjectCache
@@ -2861,7 +3951,7 @@ module Aws::CodeBuild
2861
3951
  # data as a hash:
2862
3952
  #
2863
3953
  # {
2864
- # type: "WINDOWS_CONTAINER", # required, accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER
3954
+ # type: "WINDOWS_CONTAINER", # required, accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER, WINDOWS_SERVER_2019_CONTAINER
2865
3955
  # image: "NonEmptyString", # required
2866
3956
  # compute_type: "BUILD_GENERAL1_SMALL", # required, accepts BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE, BUILD_GENERAL1_2XLARGE
2867
3957
  # environment_variables: [
@@ -3117,6 +4207,10 @@ module Aws::CodeBuild
3117
4207
  # resource: "String",
3118
4208
  # },
3119
4209
  # report_build_status: false,
4210
+ # build_status_config: {
4211
+ # context: "String",
4212
+ # target_url: "String",
4213
+ # },
3120
4214
  # insecure_ssl: false,
3121
4215
  # source_identifier: "String",
3122
4216
  # }
@@ -3132,10 +4226,11 @@ module Aws::CodeBuild
3132
4226
  # * `CODEPIPELINE`\: The source code settings are specified in the
3133
4227
  # source action of a pipeline in AWS CodePipeline.
3134
4228
  #
3135
- # * `GITHUB`\: The source code is in a GitHub repository.
4229
+ # * `GITHUB`\: The source code is in a GitHub or GitHub Enterprise
4230
+ # Cloud repository.
3136
4231
  #
3137
4232
  # * `GITHUB_ENTERPRISE`\: The source code is in a GitHub Enterprise
3138
- # repository.
4233
+ # Server repository.
3139
4234
  #
3140
4235
  # * `NO_SOURCE`\: The project does not have input source code.
3141
4236
  #
@@ -3156,17 +4251,16 @@ module Aws::CodeBuild
3156
4251
  # * For source code in an AWS CodeCommit repository, the HTTPS clone
3157
4252
  # URL to the repository that contains the source code and the
3158
4253
  # buildspec file (for example,
3159
- # `https://git-codecommit.region-ID.amazonaws.com/v1/repos/repo-name
3160
- # `).
4254
+ # `https://git-codecommit.<region-ID>.amazonaws.com/v1/repos/<repo-name>`).
3161
4255
  #
3162
4256
  # * For source code in an Amazon Simple Storage Service (Amazon S3)
3163
4257
  # input bucket, one of the following.
3164
4258
  #
3165
4259
  # * The path to the ZIP file that contains the source code (for
3166
- # example, ` bucket-name/path/to/object-name.zip`).
4260
+ # example, `<bucket-name>/<path>/<object-name>.zip`).
3167
4261
  #
3168
4262
  # * The path to the folder that contains the source code (for
3169
- # example, ` bucket-name/path/to/source-code/folder/`).
4263
+ # example, `<bucket-name>/<path-to-source-code>/<folder>/`).
3170
4264
  #
3171
4265
  # * For source code in a GitHub repository, the HTTPS clone URL to the
3172
4266
  # repository that contains the source and the buildspec file. You
@@ -3244,6 +4338,13 @@ module Aws::CodeBuild
3244
4338
  # </note>
3245
4339
  # @return [Boolean]
3246
4340
  #
4341
+ # @!attribute [rw] build_status_config
4342
+ # Contains information that defines how the build project reports the
4343
+ # build status to the source provider. This option is only used when
4344
+ # the source provider is `GITHUB`, `GITHUB_ENTERPRISE`, or
4345
+ # `BITBUCKET`.
4346
+ # @return [Types::BuildStatusConfig]
4347
+ #
3247
4348
  # @!attribute [rw] insecure_ssl
3248
4349
  # Enable this flag to ignore SSL warnings while connecting to the
3249
4350
  # project source code.
@@ -3263,6 +4364,7 @@ module Aws::CodeBuild
3263
4364
  :buildspec,
3264
4365
  :auth,
3265
4366
  :report_build_status,
4367
+ :build_status_config,
3266
4368
  :insecure_ssl,
3267
4369
  :source_identifier)
3268
4370
  SENSITIVE = []
@@ -3427,6 +4529,14 @@ module Aws::CodeBuild
3427
4529
  #
3428
4530
  # @!attribute [rw] type
3429
4531
  # The type of the report that was run.
4532
+ #
4533
+ # CODE\_COVERAGE
4534
+ #
4535
+ # : A code coverage report.
4536
+ #
4537
+ # TEST
4538
+ #
4539
+ # : A test report.
3430
4540
  # @return [String]
3431
4541
  #
3432
4542
  # @!attribute [rw] name
@@ -3471,6 +4581,11 @@ module Aws::CodeBuild
3471
4581
  # test report.
3472
4582
  # @return [Types::TestReportSummary]
3473
4583
  #
4584
+ # @!attribute [rw] code_coverage_summary
4585
+ # A `CodeCoverageReportSummary` object that contains a code coverage
4586
+ # summary for this report.
4587
+ # @return [Types::CodeCoverageReportSummary]
4588
+ #
3474
4589
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/Report AWS API Documentation
3475
4590
  #
3476
4591
  class Report < Struct.new(
@@ -3484,7 +4599,8 @@ module Aws::CodeBuild
3484
4599
  :expired,
3485
4600
  :export_config,
3486
4601
  :truncated,
3487
- :test_summary)
4602
+ :test_summary,
4603
+ :code_coverage_summary)
3488
4604
  SENSITIVE = []
3489
4605
  include Aws::Structure
3490
4606
  end
@@ -3601,6 +4717,32 @@ module Aws::CodeBuild
3601
4717
  include Aws::Structure
3602
4718
  end
3603
4719
 
4720
+ # Represents a resolved build artifact. A resolve artifact is an
4721
+ # artifact that is built and deployed to the destination, such as Amazon
4722
+ # Simple Storage Service (Amazon S3).
4723
+ #
4724
+ # @!attribute [rw] type
4725
+ # Specifies the type of artifact.
4726
+ # @return [String]
4727
+ #
4728
+ # @!attribute [rw] location
4729
+ # The location of the artifact.
4730
+ # @return [String]
4731
+ #
4732
+ # @!attribute [rw] identifier
4733
+ # The identifier of the artifact.
4734
+ # @return [String]
4735
+ #
4736
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ResolvedArtifact AWS API Documentation
4737
+ #
4738
+ class ResolvedArtifact < Struct.new(
4739
+ :type,
4740
+ :location,
4741
+ :identifier)
4742
+ SENSITIVE = []
4743
+ include Aws::Structure
4744
+ end
4745
+
3604
4746
  # The specified AWS resource cannot be created, because an AWS resource
3605
4747
  # with the same settings already exists.
3606
4748
  #
@@ -3610,164 +4752,662 @@ module Aws::CodeBuild
3610
4752
 
3611
4753
  # The specified AWS resource cannot be found.
3612
4754
  #
3613
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ResourceNotFoundException AWS API Documentation
4755
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ResourceNotFoundException AWS API Documentation
4756
+ #
4757
+ class ResourceNotFoundException < Aws::EmptyStructure; end
4758
+
4759
+ # @note When making an API call, you may pass RetryBuildBatchInput
4760
+ # data as a hash:
4761
+ #
4762
+ # {
4763
+ # id: "NonEmptyString",
4764
+ # idempotency_token: "String",
4765
+ # retry_type: "RETRY_ALL_BUILDS", # accepts RETRY_ALL_BUILDS, RETRY_FAILED_BUILDS
4766
+ # }
4767
+ #
4768
+ # @!attribute [rw] id
4769
+ # Specifies the identifier of the batch build to restart.
4770
+ # @return [String]
4771
+ #
4772
+ # @!attribute [rw] idempotency_token
4773
+ # A unique, case sensitive identifier you provide to ensure the
4774
+ # idempotency of the `RetryBuildBatch` request. The token is included
4775
+ # in the `RetryBuildBatch` request and is valid for five minutes. If
4776
+ # you repeat the `RetryBuildBatch` request with the same token, but
4777
+ # change a parameter, AWS CodeBuild returns a parameter mismatch
4778
+ # error.
4779
+ # @return [String]
4780
+ #
4781
+ # @!attribute [rw] retry_type
4782
+ # Specifies the type of retry to perform.
4783
+ # @return [String]
4784
+ #
4785
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/RetryBuildBatchInput AWS API Documentation
4786
+ #
4787
+ class RetryBuildBatchInput < Struct.new(
4788
+ :id,
4789
+ :idempotency_token,
4790
+ :retry_type)
4791
+ SENSITIVE = []
4792
+ include Aws::Structure
4793
+ end
4794
+
4795
+ # @!attribute [rw] build_batch
4796
+ # Contains information about a batch build.
4797
+ # @return [Types::BuildBatch]
4798
+ #
4799
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/RetryBuildBatchOutput AWS API Documentation
4800
+ #
4801
+ class RetryBuildBatchOutput < Struct.new(
4802
+ :build_batch)
4803
+ SENSITIVE = []
4804
+ include Aws::Structure
4805
+ end
4806
+
4807
+ # @note When making an API call, you may pass RetryBuildInput
4808
+ # data as a hash:
4809
+ #
4810
+ # {
4811
+ # id: "NonEmptyString",
4812
+ # idempotency_token: "String",
4813
+ # }
4814
+ #
4815
+ # @!attribute [rw] id
4816
+ # Specifies the identifier of the build to restart.
4817
+ # @return [String]
4818
+ #
4819
+ # @!attribute [rw] idempotency_token
4820
+ # A unique, case sensitive identifier you provide to ensure the
4821
+ # idempotency of the `RetryBuild` request. The token is included in
4822
+ # the `RetryBuild` request and is valid for five minutes. If you
4823
+ # repeat the `RetryBuild` request with the same token, but change a
4824
+ # parameter, AWS CodeBuild returns a parameter mismatch error.
4825
+ # @return [String]
4826
+ #
4827
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/RetryBuildInput AWS API Documentation
4828
+ #
4829
+ class RetryBuildInput < Struct.new(
4830
+ :id,
4831
+ :idempotency_token)
4832
+ SENSITIVE = []
4833
+ include Aws::Structure
4834
+ end
4835
+
4836
+ # @!attribute [rw] build
4837
+ # Information about a build.
4838
+ # @return [Types::Build]
4839
+ #
4840
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/RetryBuildOutput AWS API Documentation
4841
+ #
4842
+ class RetryBuildOutput < Struct.new(
4843
+ :build)
4844
+ SENSITIVE = []
4845
+ include Aws::Structure
4846
+ end
4847
+
4848
+ # Information about S3 logs for a build project.
4849
+ #
4850
+ # @note When making an API call, you may pass S3LogsConfig
4851
+ # data as a hash:
4852
+ #
4853
+ # {
4854
+ # status: "ENABLED", # required, accepts ENABLED, DISABLED
4855
+ # location: "String",
4856
+ # encryption_disabled: false,
4857
+ # }
4858
+ #
4859
+ # @!attribute [rw] status
4860
+ # The current status of the S3 build logs. Valid values are:
4861
+ #
4862
+ # * `ENABLED`\: S3 build logs are enabled for this build project.
4863
+ #
4864
+ # * `DISABLED`\: S3 build logs are not enabled for this build project.
4865
+ # @return [String]
4866
+ #
4867
+ # @!attribute [rw] location
4868
+ # The ARN of an S3 bucket and the path prefix for S3 logs. If your
4869
+ # Amazon S3 bucket name is `my-bucket`, and your path prefix is
4870
+ # `build-log`, then acceptable formats are `my-bucket/build-log` or
4871
+ # `arn:aws:s3:::my-bucket/build-log`.
4872
+ # @return [String]
4873
+ #
4874
+ # @!attribute [rw] encryption_disabled
4875
+ # Set to true if you do not want your S3 build log output encrypted.
4876
+ # By default S3 build logs are encrypted.
4877
+ # @return [Boolean]
4878
+ #
4879
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/S3LogsConfig AWS API Documentation
4880
+ #
4881
+ class S3LogsConfig < Struct.new(
4882
+ :status,
4883
+ :location,
4884
+ :encryption_disabled)
4885
+ SENSITIVE = []
4886
+ include Aws::Structure
4887
+ end
4888
+
4889
+ # Information about the S3 bucket where the raw data of a report are
4890
+ # exported.
4891
+ #
4892
+ # @note When making an API call, you may pass S3ReportExportConfig
4893
+ # data as a hash:
4894
+ #
4895
+ # {
4896
+ # bucket: "NonEmptyString",
4897
+ # path: "String",
4898
+ # packaging: "ZIP", # accepts ZIP, NONE
4899
+ # encryption_key: "NonEmptyString",
4900
+ # encryption_disabled: false,
4901
+ # }
4902
+ #
4903
+ # @!attribute [rw] bucket
4904
+ # The name of the S3 bucket where the raw data of a report are
4905
+ # exported.
4906
+ # @return [String]
4907
+ #
4908
+ # @!attribute [rw] path
4909
+ # The path to the exported report's raw data results.
4910
+ # @return [String]
4911
+ #
4912
+ # @!attribute [rw] packaging
4913
+ # The type of build output artifact to create. Valid values include:
4914
+ #
4915
+ # * `NONE`\: AWS CodeBuild creates the raw data in the output bucket.
4916
+ # This is the default if packaging is not specified.
4917
+ #
4918
+ # * `ZIP`\: AWS CodeBuild creates a ZIP file with the raw data in the
4919
+ # output bucket.
4920
+ # @return [String]
4921
+ #
4922
+ # @!attribute [rw] encryption_key
4923
+ # The encryption key for the report's encrypted raw data.
4924
+ # @return [String]
4925
+ #
4926
+ # @!attribute [rw] encryption_disabled
4927
+ # A boolean value that specifies if the results of a report are
4928
+ # encrypted.
4929
+ # @return [Boolean]
4930
+ #
4931
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/S3ReportExportConfig AWS API Documentation
4932
+ #
4933
+ class S3ReportExportConfig < Struct.new(
4934
+ :bucket,
4935
+ :path,
4936
+ :packaging,
4937
+ :encryption_key,
4938
+ :encryption_disabled)
4939
+ SENSITIVE = []
4940
+ include Aws::Structure
4941
+ end
4942
+
4943
+ # Information about the authorization settings for AWS CodeBuild to
4944
+ # access the source code to be built.
4945
+ #
4946
+ # This information is for the AWS CodeBuild console's use only. Your
4947
+ # code should not get or set this information directly.
4948
+ #
4949
+ # @note When making an API call, you may pass SourceAuth
4950
+ # data as a hash:
4951
+ #
4952
+ # {
4953
+ # type: "OAUTH", # required, accepts OAUTH
4954
+ # resource: "String",
4955
+ # }
4956
+ #
4957
+ # @!attribute [rw] type
4958
+ # <note markdown="1"> This data type is deprecated and is no longer accurate or used.
4959
+ #
4960
+ # </note>
4961
+ #
4962
+ # The authorization type to use. The only valid value is `OAUTH`,
4963
+ # which represents the OAuth authorization type.
4964
+ # @return [String]
4965
+ #
4966
+ # @!attribute [rw] resource
4967
+ # The resource value that applies to the specified authorization type.
4968
+ # @return [String]
4969
+ #
4970
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/SourceAuth AWS API Documentation
4971
+ #
4972
+ class SourceAuth < Struct.new(
4973
+ :type,
4974
+ :resource)
4975
+ SENSITIVE = []
4976
+ include Aws::Structure
4977
+ end
4978
+
4979
+ # Information about the credentials for a GitHub, GitHub Enterprise, or
4980
+ # Bitbucket repository.
4981
+ #
4982
+ # @!attribute [rw] arn
4983
+ # The Amazon Resource Name (ARN) of the token.
4984
+ # @return [String]
4985
+ #
4986
+ # @!attribute [rw] server_type
4987
+ # The type of source provider. The valid options are GITHUB,
4988
+ # GITHUB\_ENTERPRISE, or BITBUCKET.
4989
+ # @return [String]
4990
+ #
4991
+ # @!attribute [rw] auth_type
4992
+ # The type of authentication used by the credentials. Valid options
4993
+ # are OAUTH, BASIC\_AUTH, or PERSONAL\_ACCESS\_TOKEN.
4994
+ # @return [String]
4995
+ #
4996
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/SourceCredentialsInfo AWS API Documentation
4997
+ #
4998
+ class SourceCredentialsInfo < Struct.new(
4999
+ :arn,
5000
+ :server_type,
5001
+ :auth_type)
5002
+ SENSITIVE = []
5003
+ include Aws::Structure
5004
+ end
5005
+
5006
+ # @note When making an API call, you may pass StartBuildBatchInput
5007
+ # data as a hash:
5008
+ #
5009
+ # {
5010
+ # project_name: "NonEmptyString", # required
5011
+ # secondary_sources_override: [
5012
+ # {
5013
+ # type: "CODECOMMIT", # required, accepts CODECOMMIT, CODEPIPELINE, GITHUB, S3, BITBUCKET, GITHUB_ENTERPRISE, NO_SOURCE
5014
+ # location: "String",
5015
+ # git_clone_depth: 1,
5016
+ # git_submodules_config: {
5017
+ # fetch_submodules: false, # required
5018
+ # },
5019
+ # buildspec: "String",
5020
+ # auth: {
5021
+ # type: "OAUTH", # required, accepts OAUTH
5022
+ # resource: "String",
5023
+ # },
5024
+ # report_build_status: false,
5025
+ # build_status_config: {
5026
+ # context: "String",
5027
+ # target_url: "String",
5028
+ # },
5029
+ # insecure_ssl: false,
5030
+ # source_identifier: "String",
5031
+ # },
5032
+ # ],
5033
+ # secondary_sources_version_override: [
5034
+ # {
5035
+ # source_identifier: "String", # required
5036
+ # source_version: "String", # required
5037
+ # },
5038
+ # ],
5039
+ # source_version: "String",
5040
+ # artifacts_override: {
5041
+ # type: "CODEPIPELINE", # required, accepts CODEPIPELINE, S3, NO_ARTIFACTS
5042
+ # location: "String",
5043
+ # path: "String",
5044
+ # namespace_type: "NONE", # accepts NONE, BUILD_ID
5045
+ # name: "String",
5046
+ # packaging: "NONE", # accepts NONE, ZIP
5047
+ # override_artifact_name: false,
5048
+ # encryption_disabled: false,
5049
+ # artifact_identifier: "String",
5050
+ # },
5051
+ # secondary_artifacts_override: [
5052
+ # {
5053
+ # type: "CODEPIPELINE", # required, accepts CODEPIPELINE, S3, NO_ARTIFACTS
5054
+ # location: "String",
5055
+ # path: "String",
5056
+ # namespace_type: "NONE", # accepts NONE, BUILD_ID
5057
+ # name: "String",
5058
+ # packaging: "NONE", # accepts NONE, ZIP
5059
+ # override_artifact_name: false,
5060
+ # encryption_disabled: false,
5061
+ # artifact_identifier: "String",
5062
+ # },
5063
+ # ],
5064
+ # environment_variables_override: [
5065
+ # {
5066
+ # name: "NonEmptyString", # required
5067
+ # value: "String", # required
5068
+ # type: "PLAINTEXT", # accepts PLAINTEXT, PARAMETER_STORE, SECRETS_MANAGER
5069
+ # },
5070
+ # ],
5071
+ # source_type_override: "CODECOMMIT", # accepts CODECOMMIT, CODEPIPELINE, GITHUB, S3, BITBUCKET, GITHUB_ENTERPRISE, NO_SOURCE
5072
+ # source_location_override: "String",
5073
+ # source_auth_override: {
5074
+ # type: "OAUTH", # required, accepts OAUTH
5075
+ # resource: "String",
5076
+ # },
5077
+ # git_clone_depth_override: 1,
5078
+ # git_submodules_config_override: {
5079
+ # fetch_submodules: false, # required
5080
+ # },
5081
+ # buildspec_override: "String",
5082
+ # insecure_ssl_override: false,
5083
+ # report_build_batch_status_override: false,
5084
+ # environment_type_override: "WINDOWS_CONTAINER", # accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER, WINDOWS_SERVER_2019_CONTAINER
5085
+ # image_override: "NonEmptyString",
5086
+ # compute_type_override: "BUILD_GENERAL1_SMALL", # accepts BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE, BUILD_GENERAL1_2XLARGE
5087
+ # certificate_override: "String",
5088
+ # cache_override: {
5089
+ # type: "NO_CACHE", # required, accepts NO_CACHE, S3, LOCAL
5090
+ # location: "String",
5091
+ # modes: ["LOCAL_DOCKER_LAYER_CACHE"], # accepts LOCAL_DOCKER_LAYER_CACHE, LOCAL_SOURCE_CACHE, LOCAL_CUSTOM_CACHE
5092
+ # },
5093
+ # service_role_override: "NonEmptyString",
5094
+ # privileged_mode_override: false,
5095
+ # build_timeout_in_minutes_override: 1,
5096
+ # queued_timeout_in_minutes_override: 1,
5097
+ # encryption_key_override: "NonEmptyString",
5098
+ # idempotency_token: "String",
5099
+ # logs_config_override: {
5100
+ # cloud_watch_logs: {
5101
+ # status: "ENABLED", # required, accepts ENABLED, DISABLED
5102
+ # group_name: "String",
5103
+ # stream_name: "String",
5104
+ # },
5105
+ # s3_logs: {
5106
+ # status: "ENABLED", # required, accepts ENABLED, DISABLED
5107
+ # location: "String",
5108
+ # encryption_disabled: false,
5109
+ # },
5110
+ # },
5111
+ # registry_credential_override: {
5112
+ # credential: "NonEmptyString", # required
5113
+ # credential_provider: "SECRETS_MANAGER", # required, accepts SECRETS_MANAGER
5114
+ # },
5115
+ # image_pull_credentials_type_override: "CODEBUILD", # accepts CODEBUILD, SERVICE_ROLE
5116
+ # build_batch_config_override: {
5117
+ # service_role: "NonEmptyString",
5118
+ # combine_artifacts: false,
5119
+ # restrictions: {
5120
+ # maximum_builds_allowed: 1,
5121
+ # compute_types_allowed: ["NonEmptyString"],
5122
+ # },
5123
+ # timeout_in_mins: 1,
5124
+ # },
5125
+ # }
5126
+ #
5127
+ # @!attribute [rw] project_name
5128
+ # The name of the project.
5129
+ # @return [String]
5130
+ #
5131
+ # @!attribute [rw] secondary_sources_override
5132
+ # An array of `ProjectSource` objects that override the secondary
5133
+ # sources defined in the batch build project.
5134
+ # @return [Array<Types::ProjectSource>]
5135
+ #
5136
+ # @!attribute [rw] secondary_sources_version_override
5137
+ # An array of `ProjectSourceVersion` objects that override the
5138
+ # secondary source versions in the batch build project.
5139
+ # @return [Array<Types::ProjectSourceVersion>]
5140
+ #
5141
+ # @!attribute [rw] source_version
5142
+ # The version of the batch build input to be built, for this build
5143
+ # only. If not specified, the latest version is used. If specified,
5144
+ # the contents depends on the source provider:
5145
+ #
5146
+ # AWS CodeCommit
5147
+ #
5148
+ # : The commit ID, branch, or Git tag to use.
5149
+ #
5150
+ # GitHub
5151
+ #
5152
+ # : The commit ID, pull request ID, branch name, or tag name that
5153
+ # corresponds to the version of the source code you want to build.
5154
+ # If a pull request ID is specified, it must use the format
5155
+ # `pr/pull-request-ID` (for example `pr/25`). If a branch name is
5156
+ # specified, the branch's HEAD commit ID is used. If not specified,
5157
+ # the default branch's HEAD commit ID is used.
5158
+ #
5159
+ # Bitbucket
5160
+ #
5161
+ # : The commit ID, branch name, or tag name that corresponds to the
5162
+ # version of the source code you want to build. If a branch name is
5163
+ # specified, the branch's HEAD commit ID is used. If not specified,
5164
+ # the default branch's HEAD commit ID is used.
5165
+ #
5166
+ # Amazon Simple Storage Service (Amazon S3)
5167
+ #
5168
+ # : The version ID of the object that represents the build input ZIP
5169
+ # file to use.
5170
+ #
5171
+ # If `sourceVersion` is specified at the project level, then this
5172
+ # `sourceVersion` (at the build level) takes precedence.
5173
+ #
5174
+ # For more information, see [Source Version Sample with CodeBuild][1]
5175
+ # in the *AWS CodeBuild User Guide*.
5176
+ #
5177
+ #
5178
+ #
5179
+ # [1]: https://docs.aws.amazon.com/codebuild/latest/userguide/sample-source-version.html
5180
+ # @return [String]
5181
+ #
5182
+ # @!attribute [rw] artifacts_override
5183
+ # An array of `ProjectArtifacts` objects that contains information
5184
+ # about the build output artifact overrides for the build project.
5185
+ # @return [Types::ProjectArtifacts]
5186
+ #
5187
+ # @!attribute [rw] secondary_artifacts_override
5188
+ # An array of `ProjectArtifacts` objects that override the secondary
5189
+ # artifacts defined in the batch build project.
5190
+ # @return [Array<Types::ProjectArtifacts>]
5191
+ #
5192
+ # @!attribute [rw] environment_variables_override
5193
+ # An array of `EnvironmentVariable` objects that override, or add to,
5194
+ # the environment variables defined in the batch build project.
5195
+ # @return [Array<Types::EnvironmentVariable>]
5196
+ #
5197
+ # @!attribute [rw] source_type_override
5198
+ # The source input type that overrides the source input defined in the
5199
+ # batch build project.
5200
+ # @return [String]
5201
+ #
5202
+ # @!attribute [rw] source_location_override
5203
+ # A location that overrides, for this batch build, the source location
5204
+ # defined in the batch build project.
5205
+ # @return [String]
5206
+ #
5207
+ # @!attribute [rw] source_auth_override
5208
+ # A `SourceAuth` object that overrides the one defined in the batch
5209
+ # build project. This override applies only if the build project's
5210
+ # source is BitBucket or GitHub.
5211
+ # @return [Types::SourceAuth]
5212
+ #
5213
+ # @!attribute [rw] git_clone_depth_override
5214
+ # The user-defined depth of history, with a minimum value of 0, that
5215
+ # overrides, for this batch build only, any previous depth of history
5216
+ # defined in the batch build project.
5217
+ # @return [Integer]
5218
+ #
5219
+ # @!attribute [rw] git_submodules_config_override
5220
+ # A `GitSubmodulesConfig` object that overrides the Git submodules
5221
+ # configuration for this batch build.
5222
+ # @return [Types::GitSubmodulesConfig]
5223
+ #
5224
+ # @!attribute [rw] buildspec_override
5225
+ # A buildspec file declaration that overrides, for this build only,
5226
+ # the latest one already defined in the build project.
5227
+ #
5228
+ # If this value is set, it can be either an inline buildspec
5229
+ # definition, the path to an alternate buildspec file relative to the
5230
+ # value of the built-in `CODEBUILD_SRC_DIR` environment variable, or
5231
+ # the path to an S3 bucket. The bucket must be in the same AWS Region
5232
+ # as the build project. Specify the buildspec file using its ARN (for
5233
+ # example, `arn:aws:s3:::my-codebuild-sample2/buildspec.yml`). If this
5234
+ # value is not provided or is set to an empty string, the source code
5235
+ # must contain a buildspec file in its root directory. For more
5236
+ # information, see [Buildspec File Name and Storage Location][1].
5237
+ #
5238
+ #
5239
+ #
5240
+ # [1]: https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html#build-spec-ref-name-storage
5241
+ # @return [String]
3614
5242
  #
3615
- class ResourceNotFoundException < Aws::EmptyStructure; end
3616
-
3617
- # Information about S3 logs for a build project.
5243
+ # @!attribute [rw] insecure_ssl_override
5244
+ # Enable this flag to override the insecure SSL setting that is
5245
+ # specified in the batch build project. The insecure SSL setting
5246
+ # determines whether to ignore SSL warnings while connecting to the
5247
+ # project source code. This override applies only if the build's
5248
+ # source is GitHub Enterprise.
5249
+ # @return [Boolean]
3618
5250
  #
3619
- # @note When making an API call, you may pass S3LogsConfig
3620
- # data as a hash:
5251
+ # @!attribute [rw] report_build_batch_status_override
5252
+ # Set to `true` to report to your source provider the status of a
5253
+ # batch build's start and completion. If you use this option with a
5254
+ # source provider other than GitHub, GitHub Enterprise, or Bitbucket,
5255
+ # an `invalidInputException` is thrown.
3621
5256
  #
3622
- # {
3623
- # status: "ENABLED", # required, accepts ENABLED, DISABLED
3624
- # location: "String",
3625
- # encryption_disabled: false,
3626
- # }
5257
+ # <note markdown="1"> The status of a build triggered by a webhook is always reported to
5258
+ # your source provider.
3627
5259
  #
3628
- # @!attribute [rw] status
3629
- # The current status of the S3 build logs. Valid values are:
5260
+ # </note>
5261
+ # @return [Boolean]
3630
5262
  #
3631
- # * `ENABLED`\: S3 build logs are enabled for this build project.
5263
+ # @!attribute [rw] environment_type_override
5264
+ # A container type for this batch build that overrides the one
5265
+ # specified in the batch build project.
5266
+ # @return [String]
3632
5267
  #
3633
- # * `DISABLED`\: S3 build logs are not enabled for this build project.
5268
+ # @!attribute [rw] image_override
5269
+ # The name of an image for this batch build that overrides the one
5270
+ # specified in the batch build project.
3634
5271
  # @return [String]
3635
5272
  #
3636
- # @!attribute [rw] location
3637
- # The ARN of an S3 bucket and the path prefix for S3 logs. If your
3638
- # Amazon S3 bucket name is `my-bucket`, and your path prefix is
3639
- # `build-log`, then acceptable formats are `my-bucket/build-log` or
3640
- # `arn:aws:s3:::my-bucket/build-log`.
5273
+ # @!attribute [rw] compute_type_override
5274
+ # The name of a compute type for this batch build that overrides the
5275
+ # one specified in the batch build project.
3641
5276
  # @return [String]
3642
5277
  #
3643
- # @!attribute [rw] encryption_disabled
3644
- # Set to true if you do not want your S3 build log output encrypted.
3645
- # By default S3 build logs are encrypted.
3646
- # @return [Boolean]
5278
+ # @!attribute [rw] certificate_override
5279
+ # The name of a certificate for this batch build that overrides the
5280
+ # one specified in the batch build project.
5281
+ # @return [String]
3647
5282
  #
3648
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/S3LogsConfig AWS API Documentation
5283
+ # @!attribute [rw] cache_override
5284
+ # A `ProjectCache` object that specifies cache overrides.
5285
+ # @return [Types::ProjectCache]
3649
5286
  #
3650
- class S3LogsConfig < Struct.new(
3651
- :status,
3652
- :location,
3653
- :encryption_disabled)
3654
- SENSITIVE = []
3655
- include Aws::Structure
3656
- end
3657
-
3658
- # Information about the S3 bucket where the raw data of a report are
3659
- # exported.
5287
+ # @!attribute [rw] service_role_override
5288
+ # The name of a service role for this batch build that overrides the
5289
+ # one specified in the batch build project.
5290
+ # @return [String]
3660
5291
  #
3661
- # @note When making an API call, you may pass S3ReportExportConfig
3662
- # data as a hash:
5292
+ # @!attribute [rw] privileged_mode_override
5293
+ # Enable this flag to override privileged mode in the batch build
5294
+ # project.
5295
+ # @return [Boolean]
3663
5296
  #
3664
- # {
3665
- # bucket: "NonEmptyString",
3666
- # path: "String",
3667
- # packaging: "ZIP", # accepts ZIP, NONE
3668
- # encryption_key: "NonEmptyString",
3669
- # encryption_disabled: false,
3670
- # }
5297
+ # @!attribute [rw] build_timeout_in_minutes_override
5298
+ # Overrides the build timeout specified in the batch build project.
5299
+ # @return [Integer]
3671
5300
  #
3672
- # @!attribute [rw] bucket
3673
- # The name of the S3 bucket where the raw data of a report are
3674
- # exported.
3675
- # @return [String]
5301
+ # @!attribute [rw] queued_timeout_in_minutes_override
5302
+ # The number of minutes a batch build is allowed to be queued before
5303
+ # it times out.
5304
+ # @return [Integer]
3676
5305
  #
3677
- # @!attribute [rw] path
3678
- # The path to the exported report's raw data results.
3679
- # @return [String]
5306
+ # @!attribute [rw] encryption_key_override
5307
+ # The AWS Key Management Service (AWS KMS) customer master key (CMK)
5308
+ # that overrides the one specified in the batch build project. The CMK
5309
+ # key encrypts the build output artifacts.
3680
5310
  #
3681
- # @!attribute [rw] packaging
3682
- # The type of build output artifact to create. Valid values include:
5311
+ # <note markdown="1"> You can use a cross-account KMS key to encrypt the build output
5312
+ # artifacts if your service role has permission to that key.
3683
5313
  #
3684
- # * `NONE`\: AWS CodeBuild creates the raw data in the output bucket.
3685
- # This is the default if packaging is not specified.
5314
+ # </note>
3686
5315
  #
3687
- # * `ZIP`\: AWS CodeBuild creates a ZIP file with the raw data in the
3688
- # output bucket.
5316
+ # You can specify either the Amazon Resource Name (ARN) of the CMK or,
5317
+ # if available, the CMK's alias (using the format
5318
+ # `alias/<alias-name>`).
3689
5319
  # @return [String]
3690
5320
  #
3691
- # @!attribute [rw] encryption_key
3692
- # The encryption key for the report's encrypted raw data.
5321
+ # @!attribute [rw] idempotency_token
5322
+ # A unique, case sensitive identifier you provide to ensure the
5323
+ # idempotency of the `StartBuildBatch` request. The token is included
5324
+ # in the `StartBuildBatch` request and is valid for five minutes. If
5325
+ # you repeat the `StartBuildBatch` request with the same token, but
5326
+ # change a parameter, AWS CodeBuild returns a parameter mismatch
5327
+ # error.
3693
5328
  # @return [String]
3694
5329
  #
3695
- # @!attribute [rw] encryption_disabled
3696
- # A boolean value that specifies if the results of a report are
3697
- # encrypted.
3698
- # @return [Boolean]
3699
- #
3700
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/S3ReportExportConfig AWS API Documentation
5330
+ # @!attribute [rw] logs_config_override
5331
+ # A `LogsConfig` object that override the log settings defined in the
5332
+ # batch build project.
5333
+ # @return [Types::LogsConfig]
3701
5334
  #
3702
- class S3ReportExportConfig < Struct.new(
3703
- :bucket,
3704
- :path,
3705
- :packaging,
3706
- :encryption_key,
3707
- :encryption_disabled)
3708
- SENSITIVE = []
3709
- include Aws::Structure
3710
- end
3711
-
3712
- # Information about the authorization settings for AWS CodeBuild to
3713
- # access the source code to be built.
5335
+ # @!attribute [rw] registry_credential_override
5336
+ # A `RegistryCredential` object that overrides credentials for access
5337
+ # to a private registry.
5338
+ # @return [Types::RegistryCredential]
3714
5339
  #
3715
- # This information is for the AWS CodeBuild console's use only. Your
3716
- # code should not get or set this information directly.
5340
+ # @!attribute [rw] image_pull_credentials_type_override
5341
+ # The type of credentials AWS CodeBuild uses to pull images in your
5342
+ # batch build. There are two valid values:
3717
5343
  #
3718
- # @note When making an API call, you may pass SourceAuth
3719
- # data as a hash:
5344
+ # CODEBUILD
3720
5345
  #
3721
- # {
3722
- # type: "OAUTH", # required, accepts OAUTH
3723
- # resource: "String",
3724
- # }
5346
+ # : Specifies that AWS CodeBuild uses its own credentials. This
5347
+ # requires that you modify your ECR repository policy to trust AWS
5348
+ # CodeBuild's service principal.
3725
5349
  #
3726
- # @!attribute [rw] type
3727
- # <note markdown="1"> This data type is deprecated and is no longer accurate or used.
5350
+ # SERVICE\_ROLE
3728
5351
  #
3729
- # </note>
5352
+ # : Specifies that AWS CodeBuild uses your build project's service
5353
+ # role.
3730
5354
  #
3731
- # The authorization type to use. The only valid value is `OAUTH`,
3732
- # which represents the OAuth authorization type.
5355
+ # When using a cross-account or private registry image, you must use
5356
+ # `SERVICE_ROLE` credentials. When using an AWS CodeBuild curated
5357
+ # image, you must use `CODEBUILD` credentials.
3733
5358
  # @return [String]
3734
5359
  #
3735
- # @!attribute [rw] resource
3736
- # The resource value that applies to the specified authorization type.
3737
- # @return [String]
5360
+ # @!attribute [rw] build_batch_config_override
5361
+ # A `BuildBatchConfigOverride` object that contains batch build
5362
+ # configuration overrides.
5363
+ # @return [Types::ProjectBuildBatchConfig]
3738
5364
  #
3739
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/SourceAuth AWS API Documentation
5365
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/StartBuildBatchInput AWS API Documentation
3740
5366
  #
3741
- class SourceAuth < Struct.new(
3742
- :type,
3743
- :resource)
5367
+ class StartBuildBatchInput < Struct.new(
5368
+ :project_name,
5369
+ :secondary_sources_override,
5370
+ :secondary_sources_version_override,
5371
+ :source_version,
5372
+ :artifacts_override,
5373
+ :secondary_artifacts_override,
5374
+ :environment_variables_override,
5375
+ :source_type_override,
5376
+ :source_location_override,
5377
+ :source_auth_override,
5378
+ :git_clone_depth_override,
5379
+ :git_submodules_config_override,
5380
+ :buildspec_override,
5381
+ :insecure_ssl_override,
5382
+ :report_build_batch_status_override,
5383
+ :environment_type_override,
5384
+ :image_override,
5385
+ :compute_type_override,
5386
+ :certificate_override,
5387
+ :cache_override,
5388
+ :service_role_override,
5389
+ :privileged_mode_override,
5390
+ :build_timeout_in_minutes_override,
5391
+ :queued_timeout_in_minutes_override,
5392
+ :encryption_key_override,
5393
+ :idempotency_token,
5394
+ :logs_config_override,
5395
+ :registry_credential_override,
5396
+ :image_pull_credentials_type_override,
5397
+ :build_batch_config_override)
3744
5398
  SENSITIVE = []
3745
5399
  include Aws::Structure
3746
5400
  end
3747
5401
 
3748
- # Information about the credentials for a GitHub, GitHub Enterprise, or
3749
- # Bitbucket repository.
3750
- #
3751
- # @!attribute [rw] arn
3752
- # The Amazon Resource Name (ARN) of the token.
3753
- # @return [String]
3754
- #
3755
- # @!attribute [rw] server_type
3756
- # The type of source provider. The valid options are GITHUB,
3757
- # GITHUB\_ENTERPRISE, or BITBUCKET.
3758
- # @return [String]
3759
- #
3760
- # @!attribute [rw] auth_type
3761
- # The type of authentication used by the credentials. Valid options
3762
- # are OAUTH, BASIC\_AUTH, or PERSONAL\_ACCESS\_TOKEN.
3763
- # @return [String]
5402
+ # @!attribute [rw] build_batch
5403
+ # A `BuildBatch` object that contains information about the batch
5404
+ # build.
5405
+ # @return [Types::BuildBatch]
3764
5406
  #
3765
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/SourceCredentialsInfo AWS API Documentation
5407
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/StartBuildBatchOutput AWS API Documentation
3766
5408
  #
3767
- class SourceCredentialsInfo < Struct.new(
3768
- :arn,
3769
- :server_type,
3770
- :auth_type)
5409
+ class StartBuildBatchOutput < Struct.new(
5410
+ :build_batch)
3771
5411
  SENSITIVE = []
3772
5412
  include Aws::Structure
3773
5413
  end
@@ -3791,6 +5431,10 @@ module Aws::CodeBuild
3791
5431
  # resource: "String",
3792
5432
  # },
3793
5433
  # report_build_status: false,
5434
+ # build_status_config: {
5435
+ # context: "String",
5436
+ # target_url: "String",
5437
+ # },
3794
5438
  # insecure_ssl: false,
3795
5439
  # source_identifier: "String",
3796
5440
  # },
@@ -3846,7 +5490,11 @@ module Aws::CodeBuild
3846
5490
  # buildspec_override: "String",
3847
5491
  # insecure_ssl_override: false,
3848
5492
  # report_build_status_override: false,
3849
- # environment_type_override: "WINDOWS_CONTAINER", # accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER
5493
+ # build_status_config_override: {
5494
+ # context: "String",
5495
+ # target_url: "String",
5496
+ # },
5497
+ # environment_type_override: "WINDOWS_CONTAINER", # accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER, WINDOWS_SERVER_2019_CONTAINER
3850
5498
  # image_override: "NonEmptyString",
3851
5499
  # compute_type_override: "BUILD_GENERAL1_SMALL", # accepts BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE, BUILD_GENERAL1_2XLARGE
3852
5500
  # certificate_override: "String",
@@ -3878,6 +5526,7 @@ module Aws::CodeBuild
3878
5526
  # credential_provider: "SECRETS_MANAGER", # required, accepts SECRETS_MANAGER
3879
5527
  # },
3880
5528
  # image_pull_credentials_type_override: "CODEBUILD", # accepts CODEBUILD, SERVICE_ROLE
5529
+ # debug_session_enabled: false,
3881
5530
  # }
3882
5531
  #
3883
5532
  # @!attribute [rw] project_name
@@ -3896,27 +5545,34 @@ module Aws::CodeBuild
3896
5545
  # @return [Array<Types::ProjectSourceVersion>]
3897
5546
  #
3898
5547
  # @!attribute [rw] source_version
3899
- # A version of the build input to be built, for this build only. If
3900
- # not specified, the latest version is used. If specified, must be one
3901
- # of:
5548
+ # The version of the build input to be built, for this build only. If
5549
+ # not specified, the latest version is used. If specified, the
5550
+ # contents depends on the source provider:
3902
5551
  #
3903
- # * For AWS CodeCommit: the commit ID, branch, or Git tag to use.
5552
+ # AWS CodeCommit
3904
5553
  #
3905
- # * For GitHub: the commit ID, pull request ID, branch name, or tag
3906
- # name that corresponds to the version of the source code you want
3907
- # to build. If a pull request ID is specified, it must use the
3908
- # format `pr/pull-request-ID` (for example `pr/25`). If a branch
3909
- # name is specified, the branch's HEAD commit ID is used. If not
3910
- # specified, the default branch's HEAD commit ID is used.
5554
+ # : The commit ID, branch, or Git tag to use.
3911
5555
  #
3912
- # * For Bitbucket: the commit ID, branch name, or tag name that
5556
+ # GitHub
5557
+ #
5558
+ # : The commit ID, pull request ID, branch name, or tag name that
3913
5559
  # corresponds to the version of the source code you want to build.
3914
- # If a branch name is specified, the branch's HEAD commit ID is
3915
- # used. If not specified, the default branch's HEAD commit ID is
3916
- # used.
5560
+ # If a pull request ID is specified, it must use the format
5561
+ # `pr/pull-request-ID` (for example `pr/25`). If a branch name is
5562
+ # specified, the branch's HEAD commit ID is used. If not specified,
5563
+ # the default branch's HEAD commit ID is used.
3917
5564
  #
3918
- # * For Amazon Simple Storage Service (Amazon S3): the version ID of
3919
- # the object that represents the build input ZIP file to use.
5565
+ # Bitbucket
5566
+ #
5567
+ # : The commit ID, branch name, or tag name that corresponds to the
5568
+ # version of the source code you want to build. If a branch name is
5569
+ # specified, the branch's HEAD commit ID is used. If not specified,
5570
+ # the default branch's HEAD commit ID is used.
5571
+ #
5572
+ # Amazon Simple Storage Service (Amazon S3)
5573
+ #
5574
+ # : The version ID of the object that represents the build input ZIP
5575
+ # file to use.
3920
5576
  #
3921
5577
  # If `sourceVersion` is specified at the project level, then this
3922
5578
  # `sourceVersion` (at the build level) takes precedence.
@@ -4009,6 +5665,13 @@ module Aws::CodeBuild
4009
5665
  # </note>
4010
5666
  # @return [Boolean]
4011
5667
  #
5668
+ # @!attribute [rw] build_status_config_override
5669
+ # Contains information that defines how the build project reports the
5670
+ # build status to the source provider. This option is only used when
5671
+ # the source provider is `GITHUB`, `GITHUB_ENTERPRISE`, or
5672
+ # `BITBUCKET`.
5673
+ # @return [Types::BuildStatusConfig]
5674
+ #
4012
5675
  # @!attribute [rw] environment_type_override
4013
5676
  # A container type for this build that overrides the one specified in
4014
5677
  # the build project.
@@ -4065,14 +5728,14 @@ module Aws::CodeBuild
4065
5728
  # </note>
4066
5729
  #
4067
5730
  # You can specify either the Amazon Resource Name (ARN) of the CMK or,
4068
- # if available, the CMK's alias (using the format `alias/alias-name
4069
- # `).
5731
+ # if available, the CMK's alias (using the format
5732
+ # `alias/<alias-name>`).
4070
5733
  # @return [String]
4071
5734
  #
4072
5735
  # @!attribute [rw] idempotency_token
4073
5736
  # A unique, case sensitive identifier you provide to ensure the
4074
5737
  # idempotency of the StartBuild request. The token is included in the
4075
- # StartBuild request and is valid for 12 hours. If you repeat the
5738
+ # StartBuild request and is valid for 5 minutes. If you repeat the
4076
5739
  # StartBuild request with the same token, but change a parameter, AWS
4077
5740
  # CodeBuild returns a parameter mismatch error.
4078
5741
  # @return [String]
@@ -4090,18 +5753,31 @@ module Aws::CodeBuild
4090
5753
  # The type of credentials AWS CodeBuild uses to pull images in your
4091
5754
  # build. There are two valid values:
4092
5755
  #
4093
- # * `CODEBUILD` specifies that AWS CodeBuild uses its own credentials.
4094
- # This requires that you modify your ECR repository policy to trust
4095
- # AWS CodeBuild's service principal.
5756
+ # CODEBUILD
4096
5757
  #
4097
- # * `SERVICE_ROLE` specifies that AWS CodeBuild uses your build
4098
- # project's service role.
5758
+ # : Specifies that AWS CodeBuild uses its own credentials. This
5759
+ # requires that you modify your ECR repository policy to trust AWS
5760
+ # CodeBuild's service principal.
5761
+ #
5762
+ # SERVICE\_ROLE
5763
+ #
5764
+ # : Specifies that AWS CodeBuild uses your build project's service
5765
+ # role.
4099
5766
  #
4100
5767
  # When using a cross-account or private registry image, you must use
4101
- # SERVICE\_ROLE credentials. When using an AWS CodeBuild curated
4102
- # image, you must use CODEBUILD credentials.
5768
+ # `SERVICE_ROLE` credentials. When using an AWS CodeBuild curated
5769
+ # image, you must use `CODEBUILD` credentials.
4103
5770
  # @return [String]
4104
5771
  #
5772
+ # @!attribute [rw] debug_session_enabled
5773
+ # Specifies if session debugging is enabled for this build. For more
5774
+ # information, see [Viewing a running build in Session Manager][1].
5775
+ #
5776
+ #
5777
+ #
5778
+ # [1]: https://docs.aws.amazon.com/codebuild/latest/userguide/session-manager.html
5779
+ # @return [Boolean]
5780
+ #
4105
5781
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/StartBuildInput AWS API Documentation
4106
5782
  #
4107
5783
  class StartBuildInput < Struct.new(
@@ -4120,6 +5796,7 @@ module Aws::CodeBuild
4120
5796
  :buildspec_override,
4121
5797
  :insecure_ssl_override,
4122
5798
  :report_build_status_override,
5799
+ :build_status_config_override,
4123
5800
  :environment_type_override,
4124
5801
  :image_override,
4125
5802
  :compute_type_override,
@@ -4133,7 +5810,8 @@ module Aws::CodeBuild
4133
5810
  :idempotency_token,
4134
5811
  :logs_config_override,
4135
5812
  :registry_credential_override,
4136
- :image_pull_credentials_type_override)
5813
+ :image_pull_credentials_type_override,
5814
+ :debug_session_enabled)
4137
5815
  SENSITIVE = []
4138
5816
  include Aws::Structure
4139
5817
  end
@@ -4150,6 +5828,37 @@ module Aws::CodeBuild
4150
5828
  include Aws::Structure
4151
5829
  end
4152
5830
 
5831
+ # @note When making an API call, you may pass StopBuildBatchInput
5832
+ # data as a hash:
5833
+ #
5834
+ # {
5835
+ # id: "NonEmptyString", # required
5836
+ # }
5837
+ #
5838
+ # @!attribute [rw] id
5839
+ # The identifier of the batch build to stop.
5840
+ # @return [String]
5841
+ #
5842
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/StopBuildBatchInput AWS API Documentation
5843
+ #
5844
+ class StopBuildBatchInput < Struct.new(
5845
+ :id)
5846
+ SENSITIVE = []
5847
+ include Aws::Structure
5848
+ end
5849
+
5850
+ # @!attribute [rw] build_batch
5851
+ # Contains information about a batch build.
5852
+ # @return [Types::BuildBatch]
5853
+ #
5854
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/StopBuildBatchOutput AWS API Documentation
5855
+ #
5856
+ class StopBuildBatchOutput < Struct.new(
5857
+ :build_batch)
5858
+ SENSITIVE = []
5859
+ include Aws::Structure
5860
+ end
5861
+
4153
5862
  # @note When making an API call, you may pass StopBuildInput
4154
5863
  # data as a hash:
4155
5864
  #
@@ -4337,6 +6046,10 @@ module Aws::CodeBuild
4337
6046
  # resource: "String",
4338
6047
  # },
4339
6048
  # report_build_status: false,
6049
+ # build_status_config: {
6050
+ # context: "String",
6051
+ # target_url: "String",
6052
+ # },
4340
6053
  # insecure_ssl: false,
4341
6054
  # source_identifier: "String",
4342
6055
  # },
@@ -4354,6 +6067,10 @@ module Aws::CodeBuild
4354
6067
  # resource: "String",
4355
6068
  # },
4356
6069
  # report_build_status: false,
6070
+ # build_status_config: {
6071
+ # context: "String",
6072
+ # target_url: "String",
6073
+ # },
4357
6074
  # insecure_ssl: false,
4358
6075
  # source_identifier: "String",
4359
6076
  # },
@@ -4395,7 +6112,7 @@ module Aws::CodeBuild
4395
6112
  # modes: ["LOCAL_DOCKER_LAYER_CACHE"], # accepts LOCAL_DOCKER_LAYER_CACHE, LOCAL_SOURCE_CACHE, LOCAL_CUSTOM_CACHE
4396
6113
  # },
4397
6114
  # environment: {
4398
- # type: "WINDOWS_CONTAINER", # required, accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER
6115
+ # type: "WINDOWS_CONTAINER", # required, accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER, WINDOWS_SERVER_2019_CONTAINER
4399
6116
  # image: "NonEmptyString", # required
4400
6117
  # compute_type: "BUILD_GENERAL1_SMALL", # required, accepts BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE, BUILD_GENERAL1_2XLARGE
4401
6118
  # environment_variables: [
@@ -4450,6 +6167,15 @@ module Aws::CodeBuild
4450
6167
  # mount_options: "String",
4451
6168
  # },
4452
6169
  # ],
6170
+ # build_batch_config: {
6171
+ # service_role: "NonEmptyString",
6172
+ # combine_artifacts: false,
6173
+ # restrictions: {
6174
+ # maximum_builds_allowed: 1,
6175
+ # compute_types_allowed: ["NonEmptyString"],
6176
+ # },
6177
+ # timeout_in_mins: 1,
6178
+ # },
4453
6179
  # }
4454
6180
  #
4455
6181
  # @!attribute [rw] name
@@ -4560,8 +6286,8 @@ module Aws::CodeBuild
4560
6286
  # </note>
4561
6287
  #
4562
6288
  # You can specify either the Amazon Resource Name (ARN) of the CMK or,
4563
- # if available, the CMK's alias (using the format `alias/alias-name
4564
- # `).
6289
+ # if available, the CMK's alias (using the format
6290
+ # `alias/<alias-name>`).
4565
6291
  # @return [String]
4566
6292
  #
4567
6293
  # @!attribute [rw] tags
@@ -4594,6 +6320,10 @@ module Aws::CodeBuild
4594
6320
  # of a file system created using Amazon Elastic File System.
4595
6321
  # @return [Array<Types::ProjectFileSystemLocation>]
4596
6322
  #
6323
+ # @!attribute [rw] build_batch_config
6324
+ # Contains configuration information about a batch build project.
6325
+ # @return [Types::ProjectBuildBatchConfig]
6326
+ #
4597
6327
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/UpdateProjectInput AWS API Documentation
4598
6328
  #
4599
6329
  class UpdateProjectInput < Struct.new(
@@ -4615,7 +6345,8 @@ module Aws::CodeBuild
4615
6345
  :vpc_config,
4616
6346
  :badge_enabled,
4617
6347
  :logs_config,
4618
- :file_system_locations)
6348
+ :file_system_locations,
6349
+ :build_batch_config)
4619
6350
  SENSITIVE = []
4620
6351
  include Aws::Structure
4621
6352
  end
@@ -4713,6 +6444,7 @@ module Aws::CodeBuild
4713
6444
  # },
4714
6445
  # ],
4715
6446
  # ],
6447
+ # build_type: "BUILD", # accepts BUILD, BUILD_BATCH
4716
6448
  # }
4717
6449
  #
4718
6450
  # @!attribute [rw] project_name
@@ -4743,13 +6475,18 @@ module Aws::CodeBuild
4743
6475
  # least one `EVENT` `WebhookFilter`.
4744
6476
  # @return [Array<Array<Types::WebhookFilter>>]
4745
6477
  #
6478
+ # @!attribute [rw] build_type
6479
+ # Specifies the type of build this webhook will trigger.
6480
+ # @return [String]
6481
+ #
4746
6482
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/UpdateWebhookInput AWS API Documentation
4747
6483
  #
4748
6484
  class UpdateWebhookInput < Struct.new(
4749
6485
  :project_name,
4750
6486
  :branch_filter,
4751
6487
  :rotate_secret,
4752
- :filter_groups)
6488
+ :filter_groups,
6489
+ :build_type)
4753
6490
  SENSITIVE = []
4754
6491
  include Aws::Structure
4755
6492
  end
@@ -4841,6 +6578,10 @@ module Aws::CodeBuild
4841
6578
  # its filters must pass.
4842
6579
  # @return [Array<Array<Types::WebhookFilter>>]
4843
6580
  #
6581
+ # @!attribute [rw] build_type
6582
+ # Specifies the type of build this webhook will trigger.
6583
+ # @return [String]
6584
+ #
4844
6585
  # @!attribute [rw] last_modified_secret
4845
6586
  # A timestamp that indicates the last time a repository's secret
4846
6587
  # token was modified.
@@ -4854,6 +6595,7 @@ module Aws::CodeBuild
4854
6595
  :secret,
4855
6596
  :branch_filter,
4856
6597
  :filter_groups,
6598
+ :build_type,
4857
6599
  :last_modified_secret)
4858
6600
  SENSITIVE = []
4859
6601
  include Aws::Structure
@@ -4871,9 +6613,9 @@ module Aws::CodeBuild
4871
6613
  # }
4872
6614
  #
4873
6615
  # @!attribute [rw] type
4874
- # The type of webhook filter. There are five webhook filter types:
4875
- # `EVENT`, `ACTOR_ACCOUNT_ID`, `HEAD_REF`, `BASE_REF`, and
4876
- # `FILE_PATH`.
6616
+ # The type of webhook filter. There are six webhook filter types:
6617
+ # `EVENT`, `ACTOR_ACCOUNT_ID`, `HEAD_REF`, `BASE_REF`, `FILE_PATH`,
6618
+ # and `COMMIT_MESSAGE`.
4877
6619
  #
4878
6620
  # EVENT
4879
6621
  #
@@ -4920,7 +6662,20 @@ module Aws::CodeBuild
4920
6662
  # : A webhook triggers a build when the path of a changed file matches
4921
6663
  # the regular expression `pattern`.
4922
6664
  #
4923
- # <note markdown="1"> Works with GitHub and GitHub Enterprise push events only.
6665
+ # <note markdown="1"> Works with GitHub and Bitbucket events push and pull requests
6666
+ # events. Also works with GitHub Enterprise push events, but does
6667
+ # not work with GitHub Enterprise pull request events.
6668
+ #
6669
+ # </note>
6670
+ #
6671
+ # COMMIT\_MESSAGE
6672
+ #
6673
+ # : A webhook triggers a build when the head commit message matches
6674
+ # the regular expression `pattern`.
6675
+ #
6676
+ # <note markdown="1"> Works with GitHub and Bitbucket events push and pull requests
6677
+ # events. Also works with GitHub Enterprise push events, but does
6678
+ # not work with GitHub Enterprise pull request events.
4924
6679
  #
4925
6680
  # </note>
4926
6681
  # @return [String]