aws-sdk-codebuild 1.55.0 → 1.60.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,167 +584,558 @@ 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(
519
- :id,
520
- :status_code)
521
- SENSITIVE = []
522
- include Aws::Structure
523
- end
524
-
525
- # Information about a stage for a build.
601
+ # @!attribute [rw] end_time
602
+ # The date and time that the batch build ended.
603
+ # @return [Time]
526
604
  #
527
- # @!attribute [rw] phase_type
528
- # The name of the build phase. Valid values include:
605
+ # @!attribute [rw] current_phase
606
+ # The current phase of the batch build.
607
+ # @return [String]
529
608
  #
530
- # * `BUILD`\: Core build activities typically occur in this build
531
- # phase.
609
+ # @!attribute [rw] build_batch_status
610
+ # The status of the batch build.
611
+ # @return [String]
532
612
  #
533
- # * `COMPLETED`\: The build has been completed.
613
+ # @!attribute [rw] source_version
614
+ # The identifier of the version of the source code to be built.
615
+ # @return [String]
534
616
  #
535
- # * `DOWNLOAD_SOURCE`\: Source code is being downloaded in this build
536
- # phase.
617
+ # @!attribute [rw] resolved_source_version
618
+ # The identifier of the resolved version of this batch build's source
619
+ # code.
537
620
  #
538
- # * `FINALIZING`\: The build process is completing in this build
539
- # phase.
621
+ # * For AWS CodeCommit, GitHub, GitHub Enterprise, and BitBucket, the
622
+ # commit ID.
540
623
  #
541
- # * `INSTALL`\: Installation activities typically occur in this build
542
- # phase.
624
+ # * For AWS CodePipeline, the source revision provided by AWS
625
+ # CodePipeline.
543
626
  #
544
- # * `POST_BUILD`\: Post-build activities typically occur in this build
545
- # phase.
627
+ # * For Amazon Simple Storage Service (Amazon S3), this does not
628
+ # apply.
629
+ # @return [String]
546
630
  #
547
- # * `PRE_BUILD`\: Pre-build activities typically occur in this build
548
- # phase.
631
+ # @!attribute [rw] project_name
632
+ # The name of the batch build project.
633
+ # @return [String]
549
634
  #
550
- # * `PROVISIONING`\: The build environment is being set up.
635
+ # @!attribute [rw] phases
636
+ # An array of `BuildBatchPhase` objects the specify the phases of the
637
+ # batch build.
638
+ # @return [Array<Types::BuildBatchPhase>]
551
639
  #
552
- # * `QUEUED`\: The build has been submitted and is queued behind other
553
- # submitted builds.
640
+ # @!attribute [rw] source
641
+ # Information about the build input source code for the build project.
642
+ # @return [Types::ProjectSource]
554
643
  #
555
- # * `SUBMITTED`\: The build has been submitted.
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>]
556
648
  #
557
- # * `UPLOAD_ARTIFACTS`\: Build output artifacts are being uploaded to
558
- # the output location.
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.
559
692
  # @return [String]
560
693
  #
561
- # @!attribute [rw] phase_status
562
- # The current status of the build phase. Valid values include:
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]
563
698
  #
564
- # * `FAILED`\: The build phase failed.
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]
565
703
  #
566
- # * `FAULT`\: The build phase faulted.
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]
567
708
  #
568
- # * `IN_PROGRESS`\: The build phase is still in progress.
709
+ # @!attribute [rw] complete
710
+ # Indicates if the batch build is complete.
711
+ # @return [Boolean]
569
712
  #
570
- # * `QUEUED`\: The build has been submitted and is queued behind other
571
- # submitted builds.
713
+ # @!attribute [rw] initiator
714
+ # The entity that started the batch build. Valid values include:
572
715
  #
573
- # * `STOPPED`\: The build phase stopped.
716
+ # * If AWS CodePipeline started the build, the pipeline's name (for
717
+ # example, `codepipeline/my-demo-pipeline`).
574
718
  #
575
- # * `SUCCEEDED`\: The build phase succeeded.
719
+ # * If an AWS Identity and Access Management (IAM) user started the
720
+ # build, the user's name.
576
721
  #
577
- # * `TIMED_OUT`\: The build phase timed out.
722
+ # * If the Jenkins plugin for AWS CodeBuild started the build, the
723
+ # string `CodeBuild-Jenkins-Plugin`.
578
724
  # @return [String]
579
725
  #
580
- # @!attribute [rw] start_time
581
- # When the build phase started, expressed in Unix time format.
582
- # @return [Time]
726
+ # @!attribute [rw] vpc_config
727
+ # Information about the VPC configuration that AWS CodeBuild accesses.
728
+ # @return [Types::VpcConfig]
583
729
  #
584
- # @!attribute [rw] end_time
585
- # When the build phase ended, expressed in Unix time format.
586
- # @return [Time]
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.
587
733
  #
588
- # @!attribute [rw] duration_in_seconds
589
- # How long, in seconds, between the starting and ending times of the
590
- # build's phase.
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.
591
750
  # @return [Integer]
592
751
  #
593
- # @!attribute [rw] contexts
594
- # Additional information about a build phase, especially to help
595
- # troubleshoot a failed build.
596
- # @return [Array<Types::PhaseContext>]
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>]
597
758
  #
598
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BuildPhase AWS API Documentation
759
+ # @!attribute [rw] build_batch_config
760
+ # Contains configuration information about a batch build project.
761
+ # @return [Types::ProjectBuildBatchConfig]
599
762
  #
600
- class BuildPhase < Struct.new(
601
- :phase_type,
602
- :phase_status,
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(
771
+ :id,
772
+ :arn,
603
773
  :start_time,
604
774
  :end_time,
605
- :duration_in_seconds,
606
- :contexts)
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)
607
800
  SENSITIVE = []
608
801
  include Aws::Structure
609
802
  end
610
803
 
611
- # Contains information that defines how the AWS CodeBuild build project
612
- # reports the build status to the source provider.
804
+ # Specifies filters when retrieving batch builds.
613
805
  #
614
- # @note When making an API call, you may pass BuildStatusConfig
806
+ # @note When making an API call, you may pass BuildBatchFilter
615
807
  # data as a hash:
616
808
  #
617
809
  # {
618
- # context: "String",
619
- # target_url: "String",
810
+ # status: "SUCCEEDED", # accepts SUCCEEDED, FAILED, FAULT, TIMED_OUT, IN_PROGRESS, STOPPED
620
811
  # }
621
812
  #
622
- # @!attribute [rw] context
623
- # Specifies the context of the build status CodeBuild sends to the
624
- # source provider. The usage of this parameter depends on the source
625
- # provider.
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]
626
817
  #
627
- # Bitbucket
818
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BuildBatchFilter AWS API Documentation
628
819
  #
629
- # : This parameter is used for the `name` parameter in the Bitbucket
630
- # commit status. For more information, see [build][1] in the
631
- # Bitbucket API documentation.
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.
632
827
  #
633
- # GitHub/GitHub Enterprise Server
828
+ # @!attribute [rw] phase_type
829
+ # The name of the batch build phase. Valid values include:
634
830
  #
635
- # : This parameter is used for the `context` parameter in the GitHub
636
- # commit status. For more information, see [Create a commit
637
- # status][2] in the GitHub developer guide.
831
+ # COMBINE\_ARTIFACTS
638
832
  #
833
+ # : Build output artifacts are being combined and uploaded to the
834
+ # output location.
639
835
  #
836
+ # DOWNLOAD\_BATCHSPEC
640
837
  #
641
- # [1]: https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Bworkspace%7D/%7Brepo_slug%7D/commit/%7Bnode%7D/statuses/build
642
- # [2]: https://developer.github.com/v3/repos/statuses/#create-a-commit-status
643
- # @return [String]
838
+ # : The batch build specification is being downloaded.
644
839
  #
645
- # @!attribute [rw] target_url
646
- # Specifies the target url of the build status CodeBuild sends to the
647
- # source provider. The usage of this parameter depends on the source
648
- # provider.
840
+ # FAILED
649
841
  #
650
- # Bitbucket
842
+ # : One or more of the builds failed.
651
843
  #
652
- # : This parameter is used for the `url` parameter in the Bitbucket
653
- # commit status. For more information, see [build][1] in the
654
- # Bitbucket API documentation.
844
+ # IN\_PROGRESS
655
845
  #
656
- # GitHub/GitHub Enterprise Server
846
+ # : The batch build is in progress.
657
847
  #
658
- # : This parameter is used for the `target_url` parameter in the
659
- # GitHub commit status. For more information, see [Create a commit
660
- # status][2] in the GitHub developer guide.
848
+ # STOPPED
661
849
  #
850
+ # : The batch build was stopped.
662
851
  #
852
+ # SUBMITTED
663
853
  #
664
- # [1]: https://developer.atlassian.com/bitbucket/api/2/reference/resource/repositories/%7Bworkspace%7D/%7Brepo_slug%7D/commit/%7Bnode%7D/statuses/build
665
- # [2]: https://developer.github.com/v3/repos/statuses/#create-a-commit-status
854
+ # : The btach build has been submitted.
855
+ #
856
+ # SUCCEEDED
857
+ #
858
+ # : The batch build succeeded.
859
+ # @return [String]
860
+ #
861
+ # @!attribute [rw] phase_status
862
+ # The current status of the batch build phase. Valid values include:
863
+ #
864
+ # FAILED
865
+ #
866
+ # : The build phase failed.
867
+ #
868
+ # FAULT
869
+ #
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
886
+ #
887
+ # : The build phase succeeded.
888
+ #
889
+ # TIMED\_OUT
890
+ #
891
+ # : The build phase timed out.
892
+ # @return [String]
893
+ #
894
+ # @!attribute [rw] start_time
895
+ # When the batch build phase started, expressed in Unix time format.
896
+ # @return [Time]
897
+ #
898
+ # @!attribute [rw] end_time
899
+ # When the batch build phase ended, expressed in Unix time format.
900
+ # @return [Time]
901
+ #
902
+ # @!attribute [rw] duration_in_seconds
903
+ # How long, in seconds, between the starting and ending times of the
904
+ # batch build's phase.
905
+ # @return [Integer]
906
+ #
907
+ # @!attribute [rw] contexts
908
+ # Additional information about the batch build phase. Especially to
909
+ # help troubleshoot a failed btach build.
910
+ # @return [Array<Types::PhaseContext>]
911
+ #
912
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BuildBatchPhase AWS API Documentation
913
+ #
914
+ class BuildBatchPhase < Struct.new(
915
+ :phase_type,
916
+ :phase_status,
917
+ :start_time,
918
+ :end_time,
919
+ :duration_in_seconds,
920
+ :contexts)
921
+ SENSITIVE = []
922
+ include Aws::Structure
923
+ end
924
+
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.
928
+ #
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
666
1139
  # @return [String]
667
1140
  #
668
1141
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/BuildStatusConfig AWS API Documentation
@@ -674,6 +1147,66 @@ module Aws::CodeBuild
674
1147
  include Aws::Structure
675
1148
  end
676
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
+
677
1210
  # Information about Amazon CloudWatch Logs for a build project.
678
1211
  #
679
1212
  # @note When making an API call, you may pass CloudWatchLogsConfig
@@ -724,8 +1257,122 @@ module Aws::CodeBuild
724
1257
  include Aws::Structure
725
1258
  end
726
1259
 
727
- # @note When making an API call, you may pass CreateProjectInput
728
- # data as a hash:
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
+
1374
+ # @note When making an API call, you may pass CreateProjectInput
1375
+ # data as a hash:
729
1376
  #
730
1377
  # {
731
1378
  # name: "ProjectName", # required
@@ -809,7 +1456,7 @@ module Aws::CodeBuild
809
1456
  # modes: ["LOCAL_DOCKER_LAYER_CACHE"], # accepts LOCAL_DOCKER_LAYER_CACHE, LOCAL_SOURCE_CACHE, LOCAL_CUSTOM_CACHE
810
1457
  # },
811
1458
  # environment: { # required
812
- # 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
813
1460
  # image: "NonEmptyString", # required
814
1461
  # compute_type: "BUILD_GENERAL1_SMALL", # required, accepts BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE, BUILD_GENERAL1_2XLARGE
815
1462
  # environment_variables: [
@@ -864,6 +1511,15 @@ module Aws::CodeBuild
864
1511
  # mount_options: "String",
865
1512
  # },
866
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
+ # },
867
1523
  # }
868
1524
  #
869
1525
  # @!attribute [rw] name
@@ -968,8 +1624,8 @@ module Aws::CodeBuild
968
1624
  # </note>
969
1625
  #
970
1626
  # You can specify either the Amazon Resource Name (ARN) of the CMK or,
971
- # if available, the CMK's alias (using the format `alias/alias-name
972
- # `).
1627
+ # if available, the CMK's alias (using the format
1628
+ # `alias/<alias-name>`).
973
1629
  # @return [String]
974
1630
  #
975
1631
  # @!attribute [rw] tags
@@ -1003,6 +1659,11 @@ module Aws::CodeBuild
1003
1659
  # of a file system created using Amazon Elastic File System.
1004
1660
  # @return [Array<Types::ProjectFileSystemLocation>]
1005
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
+ #
1006
1667
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/CreateProjectInput AWS API Documentation
1007
1668
  #
1008
1669
  class CreateProjectInput < Struct.new(
@@ -1024,7 +1685,8 @@ module Aws::CodeBuild
1024
1685
  :vpc_config,
1025
1686
  :badge_enabled,
1026
1687
  :logs_config,
1027
- :file_system_locations)
1688
+ :file_system_locations,
1689
+ :build_batch_config)
1028
1690
  SENSITIVE = []
1029
1691
  include Aws::Structure
1030
1692
  end
@@ -1046,7 +1708,7 @@ module Aws::CodeBuild
1046
1708
  #
1047
1709
  # {
1048
1710
  # name: "ReportGroupName", # required
1049
- # type: "TEST", # required, accepts TEST
1711
+ # type: "TEST", # required, accepts TEST, CODE_COVERAGE
1050
1712
  # export_config: { # required
1051
1713
  # export_config_type: "S3", # accepts S3, NO_EXPORT
1052
1714
  # s3_destination: {
@@ -1123,6 +1785,7 @@ module Aws::CodeBuild
1123
1785
  # },
1124
1786
  # ],
1125
1787
  # ],
1788
+ # build_type: "BUILD", # accepts BUILD, BUILD_BATCH
1126
1789
  # }
1127
1790
  #
1128
1791
  # @!attribute [rw] project_name
@@ -1151,12 +1814,17 @@ module Aws::CodeBuild
1151
1814
  # its filters must pass.
1152
1815
  # @return [Array<Array<Types::WebhookFilter>>]
1153
1816
  #
1817
+ # @!attribute [rw] build_type
1818
+ # Specifies the type of build this webhook will trigger.
1819
+ # @return [String]
1820
+ #
1154
1821
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/CreateWebhookInput AWS API Documentation
1155
1822
  #
1156
1823
  class CreateWebhookInput < Struct.new(
1157
1824
  :project_name,
1158
1825
  :branch_filter,
1159
- :filter_groups)
1826
+ :filter_groups,
1827
+ :build_type)
1160
1828
  SENSITIVE = []
1161
1829
  include Aws::Structure
1162
1830
  end
@@ -1174,6 +1842,75 @@ module Aws::CodeBuild
1174
1842
  include Aws::Structure
1175
1843
  end
1176
1844
 
1845
+ # Contains information about the debug session for a build. For more
1846
+ # information, see [Viewing a running build in Session Manager][1].
1847
+ #
1848
+ #
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.
1860
+ # @return [String]
1861
+ #
1862
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/DebugSession AWS API Documentation
1863
+ #
1864
+ class DebugSession < Struct.new(
1865
+ :session_enabled,
1866
+ :session_target)
1867
+ SENSITIVE = []
1868
+ include Aws::Structure
1869
+ end
1870
+
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
+
1177
1914
  # @note When making an API call, you may pass DeleteProjectInput
1178
1915
  # data as a hash:
1179
1916
  #
@@ -1320,6 +2057,92 @@ module Aws::CodeBuild
1320
2057
  #
1321
2058
  class DeleteWebhookOutput < Aws::EmptyStructure; end
1322
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
+
1323
2146
  # @note When making an API call, you may pass DescribeTestCasesInput
1324
2147
  # data as a hash:
1325
2148
  #
@@ -1690,6 +2513,148 @@ module Aws::CodeBuild
1690
2513
  #
1691
2514
  class InvalidateProjectCacheOutput < Aws::EmptyStructure; end
1692
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
+
1693
2658
  # @note When making an API call, you may pass ListBuildsForProjectInput
1694
2659
  # data as a hash:
1695
2660
  #
@@ -2046,7 +3011,7 @@ module Aws::CodeBuild
2046
3011
  # @return [String]
2047
3012
  #
2048
3013
  # @!attribute [rw] reports
2049
- # The list of returned report group ARNs.
3014
+ # The list of report ARNs.
2050
3015
  # @return [Array<String>]
2051
3016
  #
2052
3017
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ListReportsForReportGroupOutput AWS API Documentation
@@ -2569,8 +3534,8 @@ module Aws::CodeBuild
2569
3534
  # </note>
2570
3535
  #
2571
3536
  # You can specify either the Amazon Resource Name (ARN) of the CMK or,
2572
- # if available, the CMK's alias (using the format `alias/alias-name
2573
- # `).
3537
+ # if available, the CMK's alias (using the format
3538
+ # `alias/<alias-name>`).
2574
3539
  # @return [String]
2575
3540
  #
2576
3541
  # @!attribute [rw] tags
@@ -2615,6 +3580,11 @@ module Aws::CodeBuild
2615
3580
  # of a file system created using Amazon Elastic File System.
2616
3581
  # @return [Array<Types::ProjectFileSystemLocation>]
2617
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
+ #
2618
3588
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/Project AWS API Documentation
2619
3589
  #
2620
3590
  class Project < Struct.new(
@@ -2640,7 +3610,8 @@ module Aws::CodeBuild
2640
3610
  :vpc_config,
2641
3611
  :badge,
2642
3612
  :logs_config,
2643
- :file_system_locations)
3613
+ :file_system_locations,
3614
+ :build_batch_config)
2644
3615
  SENSITIVE = []
2645
3616
  include Aws::Structure
2646
3617
  end
@@ -2733,7 +3704,7 @@ module Aws::CodeBuild
2733
3704
  #
2734
3705
  # For example, if `path` is set to `MyArtifacts`, `namespaceType` is
2735
3706
  # set to `BUILD_ID`, and `name` is set to `MyArtifact.zip`, the output
2736
- # artifact is stored in `MyArtifacts/build-ID/MyArtifact.zip`.
3707
+ # artifact is stored in `MyArtifacts/<build-ID>/MyArtifact.zip`.
2737
3708
  # @return [String]
2738
3709
  #
2739
3710
  # @!attribute [rw] name
@@ -2755,7 +3726,7 @@ module Aws::CodeBuild
2755
3726
  #
2756
3727
  # * If `path` is set to `MyArtifacts`, `namespaceType` is set to
2757
3728
  # `BUILD_ID`, and `name` is set to `MyArtifact.zip`, then the output
2758
- # artifact is stored in `MyArtifacts/build-ID/MyArtifact.zip`.
3729
+ # artifact is stored in `MyArtifacts/<build-ID>/MyArtifact.zip`.
2759
3730
  #
2760
3731
  # * If `path` is empty, `namespaceType` is set to `NONE`, and `name`
2761
3732
  # is set to "`/`", the output artifact is stored in the root of
@@ -2763,7 +3734,7 @@ module Aws::CodeBuild
2763
3734
  #
2764
3735
  # * If `path` is set to `MyArtifacts`, `namespaceType` is set to
2765
3736
  # `BUILD_ID`, and `name` is set to "`/`", the output artifact is
2766
- # stored in `MyArtifacts/build-ID `.
3737
+ # stored in `MyArtifacts/<build-ID>`.
2767
3738
  # @return [String]
2768
3739
  #
2769
3740
  # @!attribute [rw] packaging
@@ -2845,15 +3816,60 @@ module Aws::CodeBuild
2845
3816
  include Aws::Structure
2846
3817
  end
2847
3818
 
2848
- # Information about the cache for the build project.
3819
+ # Contains configuration information about a batch build project.
2849
3820
  #
2850
- # @note When making an API call, you may pass ProjectCache
3821
+ # @note When making an API call, you may pass ProjectBuildBatchConfig
2851
3822
  # data as a hash:
2852
3823
  #
2853
3824
  # {
2854
- # type: "NO_CACHE", # required, accepts NO_CACHE, S3, LOCAL
2855
- # location: "String",
2856
- # modes: ["LOCAL_DOCKER_LAYER_CACHE"], # accepts LOCAL_DOCKER_LAYER_CACHE, LOCAL_SOURCE_CACHE, LOCAL_CUSTOM_CACHE
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
+
3864
+ # Information about the cache for the build project.
3865
+ #
3866
+ # @note When making an API call, you may pass ProjectCache
3867
+ # data as a hash:
3868
+ #
3869
+ # {
3870
+ # type: "NO_CACHE", # required, accepts NO_CACHE, S3, LOCAL
3871
+ # location: "String",
3872
+ # modes: ["LOCAL_DOCKER_LAYER_CACHE"], # accepts LOCAL_DOCKER_LAYER_CACHE, LOCAL_SOURCE_CACHE, LOCAL_CUSTOM_CACHE
2857
3873
  # }
2858
3874
  #
2859
3875
  # @!attribute [rw] type
@@ -2935,7 +3951,7 @@ module Aws::CodeBuild
2935
3951
  # data as a hash:
2936
3952
  #
2937
3953
  # {
2938
- # 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
2939
3955
  # image: "NonEmptyString", # required
2940
3956
  # compute_type: "BUILD_GENERAL1_SMALL", # required, accepts BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE, BUILD_GENERAL1_2XLARGE
2941
3957
  # environment_variables: [
@@ -3235,17 +4251,16 @@ module Aws::CodeBuild
3235
4251
  # * For source code in an AWS CodeCommit repository, the HTTPS clone
3236
4252
  # URL to the repository that contains the source code and the
3237
4253
  # buildspec file (for example,
3238
- # `https://git-codecommit.region-ID.amazonaws.com/v1/repos/repo-name
3239
- # `).
4254
+ # `https://git-codecommit.<region-ID>.amazonaws.com/v1/repos/<repo-name>`).
3240
4255
  #
3241
4256
  # * For source code in an Amazon Simple Storage Service (Amazon S3)
3242
4257
  # input bucket, one of the following.
3243
4258
  #
3244
4259
  # * The path to the ZIP file that contains the source code (for
3245
- # example, ` bucket-name/path/to/object-name.zip`).
4260
+ # example, `<bucket-name>/<path>/<object-name>.zip`).
3246
4261
  #
3247
4262
  # * The path to the folder that contains the source code (for
3248
- # example, ` bucket-name/path/to/source-code/folder/`).
4263
+ # example, `<bucket-name>/<path-to-source-code>/<folder>/`).
3249
4264
  #
3250
4265
  # * For source code in a GitHub repository, the HTTPS clone URL to the
3251
4266
  # repository that contains the source and the buildspec file. You
@@ -3514,6 +4529,14 @@ module Aws::CodeBuild
3514
4529
  #
3515
4530
  # @!attribute [rw] type
3516
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.
3517
4540
  # @return [String]
3518
4541
  #
3519
4542
  # @!attribute [rw] name
@@ -3558,6 +4581,11 @@ module Aws::CodeBuild
3558
4581
  # test report.
3559
4582
  # @return [Types::TestReportSummary]
3560
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
+ #
3561
4589
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/Report AWS API Documentation
3562
4590
  #
3563
4591
  class Report < Struct.new(
@@ -3571,7 +4599,8 @@ module Aws::CodeBuild
3571
4599
  :expired,
3572
4600
  :export_config,
3573
4601
  :truncated,
3574
- :test_summary)
4602
+ :test_summary,
4603
+ :code_coverage_summary)
3575
4604
  SENSITIVE = []
3576
4605
  include Aws::Structure
3577
4606
  end
@@ -3688,173 +4717,697 @@ module Aws::CodeBuild
3688
4717
  include Aws::Structure
3689
4718
  end
3690
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
+
3691
4746
  # The specified AWS resource cannot be created, because an AWS resource
3692
4747
  # with the same settings already exists.
3693
4748
  #
3694
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ResourceAlreadyExistsException AWS API Documentation
4749
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ResourceAlreadyExistsException AWS API Documentation
4750
+ #
4751
+ class ResourceAlreadyExistsException < Aws::EmptyStructure; end
4752
+
4753
+ # The specified AWS resource cannot be found.
4754
+ #
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
+ #
3695
5238
  #
3696
- class ResourceAlreadyExistsException < Aws::EmptyStructure; end
3697
-
3698
- # The specified AWS resource cannot be found.
3699
5239
  #
3700
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ResourceNotFoundException AWS API Documentation
5240
+ # [1]: https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html#build-spec-ref-name-storage
5241
+ # @return [String]
3701
5242
  #
3702
- class ResourceNotFoundException < Aws::EmptyStructure; end
3703
-
3704
- # 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]
3705
5250
  #
3706
- # @note When making an API call, you may pass S3LogsConfig
3707
- # 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.
3708
5256
  #
3709
- # {
3710
- # status: "ENABLED", # required, accepts ENABLED, DISABLED
3711
- # location: "String",
3712
- # encryption_disabled: false,
3713
- # }
5257
+ # <note markdown="1"> The status of a build triggered by a webhook is always reported to
5258
+ # your source provider.
3714
5259
  #
3715
- # @!attribute [rw] status
3716
- # The current status of the S3 build logs. Valid values are:
5260
+ # </note>
5261
+ # @return [Boolean]
3717
5262
  #
3718
- # * `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]
3719
5267
  #
3720
- # * `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.
3721
5271
  # @return [String]
3722
5272
  #
3723
- # @!attribute [rw] location
3724
- # The ARN of an S3 bucket and the path prefix for S3 logs. If your
3725
- # Amazon S3 bucket name is `my-bucket`, and your path prefix is
3726
- # `build-log`, then acceptable formats are `my-bucket/build-log` or
3727
- # `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.
3728
5276
  # @return [String]
3729
5277
  #
3730
- # @!attribute [rw] encryption_disabled
3731
- # Set to true if you do not want your S3 build log output encrypted.
3732
- # By default S3 build logs are encrypted.
3733
- # @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]
3734
5282
  #
3735
- # @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]
3736
5286
  #
3737
- class S3LogsConfig < Struct.new(
3738
- :status,
3739
- :location,
3740
- :encryption_disabled)
3741
- SENSITIVE = []
3742
- include Aws::Structure
3743
- end
3744
-
3745
- # Information about the S3 bucket where the raw data of a report are
3746
- # 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]
3747
5291
  #
3748
- # @note When making an API call, you may pass S3ReportExportConfig
3749
- # 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]
3750
5296
  #
3751
- # {
3752
- # bucket: "NonEmptyString",
3753
- # path: "String",
3754
- # packaging: "ZIP", # accepts ZIP, NONE
3755
- # encryption_key: "NonEmptyString",
3756
- # encryption_disabled: false,
3757
- # }
5297
+ # @!attribute [rw] build_timeout_in_minutes_override
5298
+ # Overrides the build timeout specified in the batch build project.
5299
+ # @return [Integer]
3758
5300
  #
3759
- # @!attribute [rw] bucket
3760
- # The name of the S3 bucket where the raw data of a report are
3761
- # exported.
3762
- # @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]
3763
5305
  #
3764
- # @!attribute [rw] path
3765
- # The path to the exported report's raw data results.
3766
- # @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.
3767
5310
  #
3768
- # @!attribute [rw] packaging
3769
- # 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.
3770
5313
  #
3771
- # * `NONE`\: AWS CodeBuild creates the raw data in the output bucket.
3772
- # This is the default if packaging is not specified.
5314
+ # </note>
3773
5315
  #
3774
- # * `ZIP`\: AWS CodeBuild creates a ZIP file with the raw data in the
3775
- # 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>`).
3776
5319
  # @return [String]
3777
5320
  #
3778
- # @!attribute [rw] encryption_key
3779
- # 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.
3780
5328
  # @return [String]
3781
5329
  #
3782
- # @!attribute [rw] encryption_disabled
3783
- # A boolean value that specifies if the results of a report are
3784
- # encrypted.
3785
- # @return [Boolean]
3786
- #
3787
- # @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]
3788
5334
  #
3789
- class S3ReportExportConfig < Struct.new(
3790
- :bucket,
3791
- :path,
3792
- :packaging,
3793
- :encryption_key,
3794
- :encryption_disabled)
3795
- SENSITIVE = []
3796
- include Aws::Structure
3797
- end
3798
-
3799
- # Information about the authorization settings for AWS CodeBuild to
3800
- # 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]
3801
5339
  #
3802
- # This information is for the AWS CodeBuild console's use only. Your
3803
- # 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:
3804
5343
  #
3805
- # @note When making an API call, you may pass SourceAuth
3806
- # data as a hash:
5344
+ # CODEBUILD
3807
5345
  #
3808
- # {
3809
- # type: "OAUTH", # required, accepts OAUTH
3810
- # resource: "String",
3811
- # }
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.
3812
5349
  #
3813
- # @!attribute [rw] type
3814
- # <note markdown="1"> This data type is deprecated and is no longer accurate or used.
5350
+ # SERVICE\_ROLE
3815
5351
  #
3816
- # </note>
5352
+ # : Specifies that AWS CodeBuild uses your build project's service
5353
+ # role.
3817
5354
  #
3818
- # The authorization type to use. The only valid value is `OAUTH`,
3819
- # 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.
3820
5358
  # @return [String]
3821
5359
  #
3822
- # @!attribute [rw] resource
3823
- # The resource value that applies to the specified authorization type.
3824
- # @return [String]
5360
+ # @!attribute [rw] build_batch_config_override
5361
+ # A `BuildBatchConfigOverride` object that contains batch build
5362
+ # configuration overrides.
5363
+ # @return [Types::ProjectBuildBatchConfig]
3825
5364
  #
3826
- # @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
3827
5366
  #
3828
- class SourceAuth < Struct.new(
3829
- :type,
3830
- :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)
3831
5398
  SENSITIVE = []
3832
5399
  include Aws::Structure
3833
5400
  end
3834
5401
 
3835
- # Information about the credentials for a GitHub, GitHub Enterprise, or
3836
- # Bitbucket repository.
3837
- #
3838
- # @!attribute [rw] arn
3839
- # The Amazon Resource Name (ARN) of the token.
3840
- # @return [String]
3841
- #
3842
- # @!attribute [rw] server_type
3843
- # The type of source provider. The valid options are GITHUB,
3844
- # GITHUB\_ENTERPRISE, or BITBUCKET.
3845
- # @return [String]
3846
- #
3847
- # @!attribute [rw] auth_type
3848
- # The type of authentication used by the credentials. Valid options
3849
- # are OAUTH, BASIC\_AUTH, or PERSONAL\_ACCESS\_TOKEN.
3850
- # @return [String]
5402
+ # @!attribute [rw] build_batch
5403
+ # A `BuildBatch` object that contains information about the batch
5404
+ # build.
5405
+ # @return [Types::BuildBatch]
3851
5406
  #
3852
- # @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
3853
5408
  #
3854
- class SourceCredentialsInfo < Struct.new(
3855
- :arn,
3856
- :server_type,
3857
- :auth_type)
5409
+ class StartBuildBatchOutput < Struct.new(
5410
+ :build_batch)
3858
5411
  SENSITIVE = []
3859
5412
  include Aws::Structure
3860
5413
  end
@@ -3941,7 +5494,7 @@ module Aws::CodeBuild
3941
5494
  # context: "String",
3942
5495
  # target_url: "String",
3943
5496
  # },
3944
- # environment_type_override: "WINDOWS_CONTAINER", # accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER
5497
+ # environment_type_override: "WINDOWS_CONTAINER", # accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER, WINDOWS_SERVER_2019_CONTAINER
3945
5498
  # image_override: "NonEmptyString",
3946
5499
  # compute_type_override: "BUILD_GENERAL1_SMALL", # accepts BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE, BUILD_GENERAL1_2XLARGE
3947
5500
  # certificate_override: "String",
@@ -3973,6 +5526,7 @@ module Aws::CodeBuild
3973
5526
  # credential_provider: "SECRETS_MANAGER", # required, accepts SECRETS_MANAGER
3974
5527
  # },
3975
5528
  # image_pull_credentials_type_override: "CODEBUILD", # accepts CODEBUILD, SERVICE_ROLE
5529
+ # debug_session_enabled: false,
3976
5530
  # }
3977
5531
  #
3978
5532
  # @!attribute [rw] project_name
@@ -3991,27 +5545,34 @@ module Aws::CodeBuild
3991
5545
  # @return [Array<Types::ProjectSourceVersion>]
3992
5546
  #
3993
5547
  # @!attribute [rw] source_version
3994
- # A version of the build input to be built, for this build only. If
3995
- # not specified, the latest version is used. If specified, must be one
3996
- # 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:
3997
5551
  #
3998
- # * For AWS CodeCommit: the commit ID, branch, or Git tag to use.
5552
+ # AWS CodeCommit
3999
5553
  #
4000
- # * For GitHub: the commit ID, pull request ID, branch name, or tag
4001
- # name that corresponds to the version of the source code you want
4002
- # to build. If a pull request ID is specified, it must use the
4003
- # format `pr/pull-request-ID` (for example `pr/25`). If a branch
4004
- # name is specified, the branch's HEAD commit ID is used. If not
4005
- # specified, the default branch's HEAD commit ID is used.
5554
+ # : The commit ID, branch, or Git tag to use.
4006
5555
  #
4007
- # * 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
4008
5559
  # corresponds to the version of the source code you want to build.
4009
- # If a branch name is specified, the branch's HEAD commit ID is
4010
- # used. If not specified, the default branch's HEAD commit ID is
4011
- # 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.
4012
5564
  #
4013
- # * For Amazon Simple Storage Service (Amazon S3): the version ID of
4014
- # 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.
4015
5576
  #
4016
5577
  # If `sourceVersion` is specified at the project level, then this
4017
5578
  # `sourceVersion` (at the build level) takes precedence.
@@ -4167,8 +5728,8 @@ module Aws::CodeBuild
4167
5728
  # </note>
4168
5729
  #
4169
5730
  # You can specify either the Amazon Resource Name (ARN) of the CMK or,
4170
- # if available, the CMK's alias (using the format `alias/alias-name
4171
- # `).
5731
+ # if available, the CMK's alias (using the format
5732
+ # `alias/<alias-name>`).
4172
5733
  # @return [String]
4173
5734
  #
4174
5735
  # @!attribute [rw] idempotency_token
@@ -4192,18 +5753,31 @@ module Aws::CodeBuild
4192
5753
  # The type of credentials AWS CodeBuild uses to pull images in your
4193
5754
  # build. There are two valid values:
4194
5755
  #
4195
- # * `CODEBUILD` specifies that AWS CodeBuild uses its own credentials.
4196
- # This requires that you modify your ECR repository policy to trust
4197
- # AWS CodeBuild's service principal.
5756
+ # CODEBUILD
4198
5757
  #
4199
- # * `SERVICE_ROLE` specifies that AWS CodeBuild uses your build
4200
- # 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.
4201
5766
  #
4202
5767
  # When using a cross-account or private registry image, you must use
4203
- # SERVICE\_ROLE credentials. When using an AWS CodeBuild curated
4204
- # image, you must use CODEBUILD credentials.
5768
+ # `SERVICE_ROLE` credentials. When using an AWS CodeBuild curated
5769
+ # image, you must use `CODEBUILD` credentials.
4205
5770
  # @return [String]
4206
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
+ #
4207
5781
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/StartBuildInput AWS API Documentation
4208
5782
  #
4209
5783
  class StartBuildInput < Struct.new(
@@ -4236,7 +5810,8 @@ module Aws::CodeBuild
4236
5810
  :idempotency_token,
4237
5811
  :logs_config_override,
4238
5812
  :registry_credential_override,
4239
- :image_pull_credentials_type_override)
5813
+ :image_pull_credentials_type_override,
5814
+ :debug_session_enabled)
4240
5815
  SENSITIVE = []
4241
5816
  include Aws::Structure
4242
5817
  end
@@ -4253,6 +5828,37 @@ module Aws::CodeBuild
4253
5828
  include Aws::Structure
4254
5829
  end
4255
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
+
4256
5862
  # @note When making an API call, you may pass StopBuildInput
4257
5863
  # data as a hash:
4258
5864
  #
@@ -4506,7 +6112,7 @@ module Aws::CodeBuild
4506
6112
  # modes: ["LOCAL_DOCKER_LAYER_CACHE"], # accepts LOCAL_DOCKER_LAYER_CACHE, LOCAL_SOURCE_CACHE, LOCAL_CUSTOM_CACHE
4507
6113
  # },
4508
6114
  # environment: {
4509
- # 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
4510
6116
  # image: "NonEmptyString", # required
4511
6117
  # compute_type: "BUILD_GENERAL1_SMALL", # required, accepts BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE, BUILD_GENERAL1_2XLARGE
4512
6118
  # environment_variables: [
@@ -4561,6 +6167,15 @@ module Aws::CodeBuild
4561
6167
  # mount_options: "String",
4562
6168
  # },
4563
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
+ # },
4564
6179
  # }
4565
6180
  #
4566
6181
  # @!attribute [rw] name
@@ -4671,8 +6286,8 @@ module Aws::CodeBuild
4671
6286
  # </note>
4672
6287
  #
4673
6288
  # You can specify either the Amazon Resource Name (ARN) of the CMK or,
4674
- # if available, the CMK's alias (using the format `alias/alias-name
4675
- # `).
6289
+ # if available, the CMK's alias (using the format
6290
+ # `alias/<alias-name>`).
4676
6291
  # @return [String]
4677
6292
  #
4678
6293
  # @!attribute [rw] tags
@@ -4705,6 +6320,10 @@ module Aws::CodeBuild
4705
6320
  # of a file system created using Amazon Elastic File System.
4706
6321
  # @return [Array<Types::ProjectFileSystemLocation>]
4707
6322
  #
6323
+ # @!attribute [rw] build_batch_config
6324
+ # Contains configuration information about a batch build project.
6325
+ # @return [Types::ProjectBuildBatchConfig]
6326
+ #
4708
6327
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/UpdateProjectInput AWS API Documentation
4709
6328
  #
4710
6329
  class UpdateProjectInput < Struct.new(
@@ -4726,7 +6345,8 @@ module Aws::CodeBuild
4726
6345
  :vpc_config,
4727
6346
  :badge_enabled,
4728
6347
  :logs_config,
4729
- :file_system_locations)
6348
+ :file_system_locations,
6349
+ :build_batch_config)
4730
6350
  SENSITIVE = []
4731
6351
  include Aws::Structure
4732
6352
  end
@@ -4824,6 +6444,7 @@ module Aws::CodeBuild
4824
6444
  # },
4825
6445
  # ],
4826
6446
  # ],
6447
+ # build_type: "BUILD", # accepts BUILD, BUILD_BATCH
4827
6448
  # }
4828
6449
  #
4829
6450
  # @!attribute [rw] project_name
@@ -4854,13 +6475,18 @@ module Aws::CodeBuild
4854
6475
  # least one `EVENT` `WebhookFilter`.
4855
6476
  # @return [Array<Array<Types::WebhookFilter>>]
4856
6477
  #
6478
+ # @!attribute [rw] build_type
6479
+ # Specifies the type of build this webhook will trigger.
6480
+ # @return [String]
6481
+ #
4857
6482
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/UpdateWebhookInput AWS API Documentation
4858
6483
  #
4859
6484
  class UpdateWebhookInput < Struct.new(
4860
6485
  :project_name,
4861
6486
  :branch_filter,
4862
6487
  :rotate_secret,
4863
- :filter_groups)
6488
+ :filter_groups,
6489
+ :build_type)
4864
6490
  SENSITIVE = []
4865
6491
  include Aws::Structure
4866
6492
  end
@@ -4952,6 +6578,10 @@ module Aws::CodeBuild
4952
6578
  # its filters must pass.
4953
6579
  # @return [Array<Array<Types::WebhookFilter>>]
4954
6580
  #
6581
+ # @!attribute [rw] build_type
6582
+ # Specifies the type of build this webhook will trigger.
6583
+ # @return [String]
6584
+ #
4955
6585
  # @!attribute [rw] last_modified_secret
4956
6586
  # A timestamp that indicates the last time a repository's secret
4957
6587
  # token was modified.
@@ -4965,6 +6595,7 @@ module Aws::CodeBuild
4965
6595
  :secret,
4966
6596
  :branch_filter,
4967
6597
  :filter_groups,
6598
+ :build_type,
4968
6599
  :last_modified_secret)
4969
6600
  SENSITIVE = []
4970
6601
  include Aws::Structure