aws-sdk-codebuild 1.56.0 → 1.61.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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
  #
@@ -1202,16 +1939,34 @@ module Aws::CodeBuild
1202
1939
  #
1203
1940
  # {
1204
1941
  # arn: "NonEmptyString", # required
1942
+ # delete_reports: false,
1205
1943
  # }
1206
1944
  #
1207
1945
  # @!attribute [rw] arn
1208
1946
  # The ARN of the report group to delete.
1209
1947
  # @return [String]
1210
1948
  #
1949
+ # @!attribute [rw] delete_reports
1950
+ # If `true`, deletes any reports that belong to a report group before
1951
+ # deleting the report group.
1952
+ #
1953
+ # If `false`, you must delete any reports in the report group. Use
1954
+ # [ListReportsForReportGroup][1] to get the reports in a report group.
1955
+ # Use [DeleteReport][2] to delete the reports. If you call
1956
+ # `DeleteReportGroup` for a report group that contains one or more
1957
+ # reports, an exception is thrown.
1958
+ #
1959
+ #
1960
+ #
1961
+ # [1]: https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ListReportsForReportGroup.html
1962
+ # [2]: https://docs.aws.amazon.com/codebuild/latest/APIReference/API_DeleteReport.html
1963
+ # @return [Boolean]
1964
+ #
1211
1965
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/DeleteReportGroupInput AWS API Documentation
1212
1966
  #
1213
1967
  class DeleteReportGroupInput < Struct.new(
1214
- :arn)
1968
+ :arn,
1969
+ :delete_reports)
1215
1970
  SENSITIVE = []
1216
1971
  include Aws::Structure
1217
1972
  end
@@ -1320,6 +2075,92 @@ module Aws::CodeBuild
1320
2075
  #
1321
2076
  class DeleteWebhookOutput < Aws::EmptyStructure; end
1322
2077
 
2078
+ # @note When making an API call, you may pass DescribeCodeCoveragesInput
2079
+ # data as a hash:
2080
+ #
2081
+ # {
2082
+ # report_arn: "NonEmptyString", # required
2083
+ # next_token: "String",
2084
+ # max_results: 1,
2085
+ # sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
2086
+ # sort_by: "LINE_COVERAGE_PERCENTAGE", # accepts LINE_COVERAGE_PERCENTAGE, FILE_PATH
2087
+ # min_line_coverage_percentage: 1.0,
2088
+ # max_line_coverage_percentage: 1.0,
2089
+ # }
2090
+ #
2091
+ # @!attribute [rw] report_arn
2092
+ # The ARN of the report for which test cases are returned.
2093
+ # @return [String]
2094
+ #
2095
+ # @!attribute [rw] next_token
2096
+ # The `nextToken` value returned from a previous call to
2097
+ # `DescribeCodeCoverages`. This specifies the next item to return. To
2098
+ # return the beginning of the list, exclude this parameter.
2099
+ # @return [String]
2100
+ #
2101
+ # @!attribute [rw] max_results
2102
+ # The maximum number of results to return.
2103
+ # @return [Integer]
2104
+ #
2105
+ # @!attribute [rw] sort_order
2106
+ # Specifies if the results are sorted in ascending or descending
2107
+ # order.
2108
+ # @return [String]
2109
+ #
2110
+ # @!attribute [rw] sort_by
2111
+ # Specifies how the results are sorted. Possible values are:
2112
+ #
2113
+ # FILE\_PATH
2114
+ #
2115
+ # : The results are sorted by file path.
2116
+ #
2117
+ # LINE\_COVERAGE\_PERCENTAGE
2118
+ #
2119
+ # : The results are sorted by the percentage of lines that are
2120
+ # covered.
2121
+ # @return [String]
2122
+ #
2123
+ # @!attribute [rw] min_line_coverage_percentage
2124
+ # The minimum line coverage percentage to report.
2125
+ # @return [Float]
2126
+ #
2127
+ # @!attribute [rw] max_line_coverage_percentage
2128
+ # The maximum line coverage percentage to report.
2129
+ # @return [Float]
2130
+ #
2131
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/DescribeCodeCoveragesInput AWS API Documentation
2132
+ #
2133
+ class DescribeCodeCoveragesInput < Struct.new(
2134
+ :report_arn,
2135
+ :next_token,
2136
+ :max_results,
2137
+ :sort_order,
2138
+ :sort_by,
2139
+ :min_line_coverage_percentage,
2140
+ :max_line_coverage_percentage)
2141
+ SENSITIVE = []
2142
+ include Aws::Structure
2143
+ end
2144
+
2145
+ # @!attribute [rw] next_token
2146
+ # If there are more items to return, this contains a token that is
2147
+ # passed to a subsequent call to `DescribeCodeCoverages` to retrieve
2148
+ # the next set of items.
2149
+ # @return [String]
2150
+ #
2151
+ # @!attribute [rw] code_coverages
2152
+ # An array of `CodeCoverage` objects that contain the results.
2153
+ # @return [Array<Types::CodeCoverage>]
2154
+ #
2155
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/DescribeCodeCoveragesOutput AWS API Documentation
2156
+ #
2157
+ class DescribeCodeCoveragesOutput < Struct.new(
2158
+ :next_token,
2159
+ :code_coverages)
2160
+ SENSITIVE = []
2161
+ include Aws::Structure
2162
+ end
2163
+
1323
2164
  # @note When making an API call, you may pass DescribeTestCasesInput
1324
2165
  # data as a hash:
1325
2166
  #
@@ -1329,6 +2170,7 @@ module Aws::CodeBuild
1329
2170
  # max_results: 1,
1330
2171
  # filter: {
1331
2172
  # status: "String",
2173
+ # keyword: "String",
1332
2174
  # },
1333
2175
  # }
1334
2176
  #
@@ -1488,21 +2330,21 @@ module Aws::CodeBuild
1488
2330
  #
1489
2331
  # * `PARAMETER_STORE`\: An environment variable stored in Amazon EC2
1490
2332
  # Systems Manager Parameter Store. To learn how to specify a
1491
- # parameter store environment variable, see [ parameter store
1492
- # reference-key in the buildspec file][1].
2333
+ # parameter store environment variable, see [env/parameter-store][1]
2334
+ # in the *AWS CodeBuild User Guide*.
1493
2335
  #
1494
2336
  # * `PLAINTEXT`\: An environment variable in plain text format. This
1495
2337
  # is the default value.
1496
2338
  #
1497
2339
  # * `SECRETS_MANAGER`\: An environment variable stored in AWS Secrets
1498
2340
  # Manager. To learn how to specify a secrets manager environment
1499
- # variable, see [ secrets manager reference-key in the buildspec
1500
- # file][2].
2341
+ # variable, see [env/secrets-manager][2] in the *AWS CodeBuild User
2342
+ # Guide*.
1501
2343
  #
1502
2344
  #
1503
2345
  #
1504
- # [1]: https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html#parameter-store-build-spec
1505
- # [2]: https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html#secrets-manager-build-spec
2346
+ # [1]: https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html#build-spec.env.parameter-store
2347
+ # [2]: https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html#build-spec.env.secrets-manager
1506
2348
  # @return [String]
1507
2349
  #
1508
2350
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/EnvironmentVariable AWS API Documentation
@@ -1690,6 +2532,148 @@ module Aws::CodeBuild
1690
2532
  #
1691
2533
  class InvalidateProjectCacheOutput < Aws::EmptyStructure; end
1692
2534
 
2535
+ # @note When making an API call, you may pass ListBuildBatchesForProjectInput
2536
+ # data as a hash:
2537
+ #
2538
+ # {
2539
+ # project_name: "NonEmptyString",
2540
+ # filter: {
2541
+ # status: "SUCCEEDED", # accepts SUCCEEDED, FAILED, FAULT, TIMED_OUT, IN_PROGRESS, STOPPED
2542
+ # },
2543
+ # max_results: 1,
2544
+ # sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
2545
+ # next_token: "String",
2546
+ # }
2547
+ #
2548
+ # @!attribute [rw] project_name
2549
+ # The name of the project.
2550
+ # @return [String]
2551
+ #
2552
+ # @!attribute [rw] filter
2553
+ # A `BuildBatchFilter` object that specifies the filters for the
2554
+ # search.
2555
+ # @return [Types::BuildBatchFilter]
2556
+ #
2557
+ # @!attribute [rw] max_results
2558
+ # The maximum number of results to return.
2559
+ # @return [Integer]
2560
+ #
2561
+ # @!attribute [rw] sort_order
2562
+ # Specifies the sort order of the returned items. Valid values
2563
+ # include:
2564
+ #
2565
+ # * `ASCENDING`\: List the batch build identifiers in ascending order
2566
+ # by identifier.
2567
+ #
2568
+ # * `DESCENDING`\: List the batch build identifiers in descending
2569
+ # order by identifier.
2570
+ # @return [String]
2571
+ #
2572
+ # @!attribute [rw] next_token
2573
+ # The `nextToken` value returned from a previous call to
2574
+ # `ListBuildBatchesForProject`. This specifies the next item to
2575
+ # return. To return the beginning of the list, exclude this parameter.
2576
+ # @return [String]
2577
+ #
2578
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ListBuildBatchesForProjectInput AWS API Documentation
2579
+ #
2580
+ class ListBuildBatchesForProjectInput < Struct.new(
2581
+ :project_name,
2582
+ :filter,
2583
+ :max_results,
2584
+ :sort_order,
2585
+ :next_token)
2586
+ SENSITIVE = []
2587
+ include Aws::Structure
2588
+ end
2589
+
2590
+ # @!attribute [rw] ids
2591
+ # An array of strings that contains the batch build identifiers.
2592
+ # @return [Array<String>]
2593
+ #
2594
+ # @!attribute [rw] next_token
2595
+ # If there are more items to return, this contains a token that is
2596
+ # passed to a subsequent call to `ListBuildBatchesForProject` to
2597
+ # retrieve the next set of items.
2598
+ # @return [String]
2599
+ #
2600
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ListBuildBatchesForProjectOutput AWS API Documentation
2601
+ #
2602
+ class ListBuildBatchesForProjectOutput < Struct.new(
2603
+ :ids,
2604
+ :next_token)
2605
+ SENSITIVE = []
2606
+ include Aws::Structure
2607
+ end
2608
+
2609
+ # @note When making an API call, you may pass ListBuildBatchesInput
2610
+ # data as a hash:
2611
+ #
2612
+ # {
2613
+ # filter: {
2614
+ # status: "SUCCEEDED", # accepts SUCCEEDED, FAILED, FAULT, TIMED_OUT, IN_PROGRESS, STOPPED
2615
+ # },
2616
+ # max_results: 1,
2617
+ # sort_order: "ASCENDING", # accepts ASCENDING, DESCENDING
2618
+ # next_token: "String",
2619
+ # }
2620
+ #
2621
+ # @!attribute [rw] filter
2622
+ # A `BuildBatchFilter` object that specifies the filters for the
2623
+ # search.
2624
+ # @return [Types::BuildBatchFilter]
2625
+ #
2626
+ # @!attribute [rw] max_results
2627
+ # The maximum number of results to return.
2628
+ # @return [Integer]
2629
+ #
2630
+ # @!attribute [rw] sort_order
2631
+ # Specifies the sort order of the returned items. Valid values
2632
+ # include:
2633
+ #
2634
+ # * `ASCENDING`\: List the batch build identifiers in ascending order
2635
+ # by identifier.
2636
+ #
2637
+ # * `DESCENDING`\: List the batch build identifiers in descending
2638
+ # order by identifier.
2639
+ # @return [String]
2640
+ #
2641
+ # @!attribute [rw] next_token
2642
+ # The `nextToken` value returned from a previous call to
2643
+ # `ListBuildBatches`. This specifies the next item to return. To
2644
+ # return the beginning of the list, exclude this parameter.
2645
+ # @return [String]
2646
+ #
2647
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ListBuildBatchesInput AWS API Documentation
2648
+ #
2649
+ class ListBuildBatchesInput < Struct.new(
2650
+ :filter,
2651
+ :max_results,
2652
+ :sort_order,
2653
+ :next_token)
2654
+ SENSITIVE = []
2655
+ include Aws::Structure
2656
+ end
2657
+
2658
+ # @!attribute [rw] ids
2659
+ # An array of strings that contains the batch build identifiers.
2660
+ # @return [Array<String>]
2661
+ #
2662
+ # @!attribute [rw] next_token
2663
+ # If there are more items to return, this contains a token that is
2664
+ # passed to a subsequent call to `ListBuildBatches` to retrieve the
2665
+ # next set of items.
2666
+ # @return [String]
2667
+ #
2668
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ListBuildBatchesOutput AWS API Documentation
2669
+ #
2670
+ class ListBuildBatchesOutput < Struct.new(
2671
+ :ids,
2672
+ :next_token)
2673
+ SENSITIVE = []
2674
+ include Aws::Structure
2675
+ end
2676
+
1693
2677
  # @note When making an API call, you may pass ListBuildsForProjectInput
1694
2678
  # data as a hash:
1695
2679
  #
@@ -2046,7 +3030,7 @@ module Aws::CodeBuild
2046
3030
  # @return [String]
2047
3031
  #
2048
3032
  # @!attribute [rw] reports
2049
- # The list of returned report group ARNs.
3033
+ # The list of report ARNs.
2050
3034
  # @return [Array<String>]
2051
3035
  #
2052
3036
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ListReportsForReportGroupOutput AWS API Documentation
@@ -2569,8 +3553,8 @@ module Aws::CodeBuild
2569
3553
  # </note>
2570
3554
  #
2571
3555
  # 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
- # `).
3556
+ # if available, the CMK's alias (using the format
3557
+ # `alias/<alias-name>`).
2574
3558
  # @return [String]
2575
3559
  #
2576
3560
  # @!attribute [rw] tags
@@ -2615,6 +3599,11 @@ module Aws::CodeBuild
2615
3599
  # of a file system created using Amazon Elastic File System.
2616
3600
  # @return [Array<Types::ProjectFileSystemLocation>]
2617
3601
  #
3602
+ # @!attribute [rw] build_batch_config
3603
+ # A ProjectBuildBatchConfig object that defines the batch build
3604
+ # options for the project.
3605
+ # @return [Types::ProjectBuildBatchConfig]
3606
+ #
2618
3607
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/Project AWS API Documentation
2619
3608
  #
2620
3609
  class Project < Struct.new(
@@ -2640,7 +3629,8 @@ module Aws::CodeBuild
2640
3629
  :vpc_config,
2641
3630
  :badge,
2642
3631
  :logs_config,
2643
- :file_system_locations)
3632
+ :file_system_locations,
3633
+ :build_batch_config)
2644
3634
  SENSITIVE = []
2645
3635
  include Aws::Structure
2646
3636
  end
@@ -2733,7 +3723,7 @@ module Aws::CodeBuild
2733
3723
  #
2734
3724
  # For example, if `path` is set to `MyArtifacts`, `namespaceType` is
2735
3725
  # set to `BUILD_ID`, and `name` is set to `MyArtifact.zip`, the output
2736
- # artifact is stored in `MyArtifacts/build-ID/MyArtifact.zip`.
3726
+ # artifact is stored in `MyArtifacts/<build-ID>/MyArtifact.zip`.
2737
3727
  # @return [String]
2738
3728
  #
2739
3729
  # @!attribute [rw] name
@@ -2755,7 +3745,7 @@ module Aws::CodeBuild
2755
3745
  #
2756
3746
  # * If `path` is set to `MyArtifacts`, `namespaceType` is set to
2757
3747
  # `BUILD_ID`, and `name` is set to `MyArtifact.zip`, then the output
2758
- # artifact is stored in `MyArtifacts/build-ID/MyArtifact.zip`.
3748
+ # artifact is stored in `MyArtifacts/<build-ID>/MyArtifact.zip`.
2759
3749
  #
2760
3750
  # * If `path` is empty, `namespaceType` is set to `NONE`, and `name`
2761
3751
  # is set to "`/`", the output artifact is stored in the root of
@@ -2763,7 +3753,7 @@ module Aws::CodeBuild
2763
3753
  #
2764
3754
  # * If `path` is set to `MyArtifacts`, `namespaceType` is set to
2765
3755
  # `BUILD_ID`, and `name` is set to "`/`", the output artifact is
2766
- # stored in `MyArtifacts/build-ID `.
3756
+ # stored in `MyArtifacts/<build-ID>`.
2767
3757
  # @return [String]
2768
3758
  #
2769
3759
  # @!attribute [rw] packaging
@@ -2845,6 +3835,51 @@ module Aws::CodeBuild
2845
3835
  include Aws::Structure
2846
3836
  end
2847
3837
 
3838
+ # Contains configuration information about a batch build project.
3839
+ #
3840
+ # @note When making an API call, you may pass ProjectBuildBatchConfig
3841
+ # data as a hash:
3842
+ #
3843
+ # {
3844
+ # service_role: "NonEmptyString",
3845
+ # combine_artifacts: false,
3846
+ # restrictions: {
3847
+ # maximum_builds_allowed: 1,
3848
+ # compute_types_allowed: ["NonEmptyString"],
3849
+ # },
3850
+ # timeout_in_mins: 1,
3851
+ # }
3852
+ #
3853
+ # @!attribute [rw] service_role
3854
+ # Specifies the service role ARN for the batch build project.
3855
+ # @return [String]
3856
+ #
3857
+ # @!attribute [rw] combine_artifacts
3858
+ # Specifies if the build artifacts for the batch build should be
3859
+ # combined into a single artifact location.
3860
+ # @return [Boolean]
3861
+ #
3862
+ # @!attribute [rw] restrictions
3863
+ # A `BatchRestrictions` object that specifies the restrictions for the
3864
+ # batch build.
3865
+ # @return [Types::BatchRestrictions]
3866
+ #
3867
+ # @!attribute [rw] timeout_in_mins
3868
+ # Specifies the maximum amount of time, in minutes, that the batch
3869
+ # build must be completed in.
3870
+ # @return [Integer]
3871
+ #
3872
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ProjectBuildBatchConfig AWS API Documentation
3873
+ #
3874
+ class ProjectBuildBatchConfig < Struct.new(
3875
+ :service_role,
3876
+ :combine_artifacts,
3877
+ :restrictions,
3878
+ :timeout_in_mins)
3879
+ SENSITIVE = []
3880
+ include Aws::Structure
3881
+ end
3882
+
2848
3883
  # Information about the cache for the build project.
2849
3884
  #
2850
3885
  # @note When making an API call, you may pass ProjectCache
@@ -2935,7 +3970,7 @@ module Aws::CodeBuild
2935
3970
  # data as a hash:
2936
3971
  #
2937
3972
  # {
2938
- # type: "WINDOWS_CONTAINER", # required, accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER
3973
+ # type: "WINDOWS_CONTAINER", # required, accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER, WINDOWS_SERVER_2019_CONTAINER
2939
3974
  # image: "NonEmptyString", # required
2940
3975
  # compute_type: "BUILD_GENERAL1_SMALL", # required, accepts BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE, BUILD_GENERAL1_2XLARGE
2941
3976
  # environment_variables: [
@@ -2980,15 +4015,17 @@ module Aws::CodeBuild
2980
4015
  # The image tag or image digest that identifies the Docker image to
2981
4016
  # use for this build project. Use the following formats:
2982
4017
  #
2983
- # * For an image tag: `registry/repository:tag`. For example, to
2984
- # specify an image with the tag "latest," use
2985
- # `registry/repository:latest`.
4018
+ # * For an image tag: `<registry>/<repository>:<tag>`. For example, in
4019
+ # the Docker repository that CodeBuild uses to manage its Docker
4020
+ # images, this would be `aws/codebuild/standard:4.0`. To specify the
4021
+ # latest version of this image, this would be
4022
+ # `aws/codebuild/standard:latest`.
2986
4023
  #
2987
- # * For an image digest: `registry/repository@digest`. For example, to
2988
- # specify an image with the digest
4024
+ # * For an image digest: `<registry>/<repository>@<digest>`. For
4025
+ # example, to specify an image with the digest
2989
4026
  # "sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf,"
2990
4027
  # use
2991
- # `registry/repository@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf`.
4028
+ # `<registry>/<repository>@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf`.
2992
4029
  # @return [String]
2993
4030
  #
2994
4031
  # @!attribute [rw] compute_type
@@ -3235,17 +4272,16 @@ module Aws::CodeBuild
3235
4272
  # * For source code in an AWS CodeCommit repository, the HTTPS clone
3236
4273
  # URL to the repository that contains the source code and the
3237
4274
  # buildspec file (for example,
3238
- # `https://git-codecommit.region-ID.amazonaws.com/v1/repos/repo-name
3239
- # `).
4275
+ # `https://git-codecommit.<region-ID>.amazonaws.com/v1/repos/<repo-name>`).
3240
4276
  #
3241
4277
  # * For source code in an Amazon Simple Storage Service (Amazon S3)
3242
4278
  # input bucket, one of the following.
3243
4279
  #
3244
4280
  # * The path to the ZIP file that contains the source code (for
3245
- # example, ` bucket-name/path/to/object-name.zip`).
4281
+ # example, `<bucket-name>/<path>/<object-name>.zip`).
3246
4282
  #
3247
4283
  # * The path to the folder that contains the source code (for
3248
- # example, ` bucket-name/path/to/source-code/folder/`).
4284
+ # example, `<bucket-name>/<path-to-source-code>/<folder>/`).
3249
4285
  #
3250
4286
  # * For source code in a GitHub repository, the HTTPS clone URL to the
3251
4287
  # repository that contains the source and the buildspec file. You
@@ -3514,6 +4550,14 @@ module Aws::CodeBuild
3514
4550
  #
3515
4551
  # @!attribute [rw] type
3516
4552
  # The type of the report that was run.
4553
+ #
4554
+ # CODE\_COVERAGE
4555
+ #
4556
+ # : A code coverage report.
4557
+ #
4558
+ # TEST
4559
+ #
4560
+ # : A test report.
3517
4561
  # @return [String]
3518
4562
  #
3519
4563
  # @!attribute [rw] name
@@ -3558,6 +4602,11 @@ module Aws::CodeBuild
3558
4602
  # test report.
3559
4603
  # @return [Types::TestReportSummary]
3560
4604
  #
4605
+ # @!attribute [rw] code_coverage_summary
4606
+ # A `CodeCoverageReportSummary` object that contains a code coverage
4607
+ # summary for this report.
4608
+ # @return [Types::CodeCoverageReportSummary]
4609
+ #
3561
4610
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/Report AWS API Documentation
3562
4611
  #
3563
4612
  class Report < Struct.new(
@@ -3571,7 +4620,8 @@ module Aws::CodeBuild
3571
4620
  :expired,
3572
4621
  :export_config,
3573
4622
  :truncated,
3574
- :test_summary)
4623
+ :test_summary,
4624
+ :code_coverage_summary)
3575
4625
  SENSITIVE = []
3576
4626
  include Aws::Structure
3577
4627
  end
@@ -3688,6 +4738,32 @@ module Aws::CodeBuild
3688
4738
  include Aws::Structure
3689
4739
  end
3690
4740
 
4741
+ # Represents a resolved build artifact. A resolve artifact is an
4742
+ # artifact that is built and deployed to the destination, such as Amazon
4743
+ # Simple Storage Service (Amazon S3).
4744
+ #
4745
+ # @!attribute [rw] type
4746
+ # Specifies the type of artifact.
4747
+ # @return [String]
4748
+ #
4749
+ # @!attribute [rw] location
4750
+ # The location of the artifact.
4751
+ # @return [String]
4752
+ #
4753
+ # @!attribute [rw] identifier
4754
+ # The identifier of the artifact.
4755
+ # @return [String]
4756
+ #
4757
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ResolvedArtifact AWS API Documentation
4758
+ #
4759
+ class ResolvedArtifact < Struct.new(
4760
+ :type,
4761
+ :location,
4762
+ :identifier)
4763
+ SENSITIVE = []
4764
+ include Aws::Structure
4765
+ end
4766
+
3691
4767
  # The specified AWS resource cannot be created, because an AWS resource
3692
4768
  # with the same settings already exists.
3693
4769
  #
@@ -3697,164 +4773,662 @@ module Aws::CodeBuild
3697
4773
 
3698
4774
  # The specified AWS resource cannot be found.
3699
4775
  #
3700
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ResourceNotFoundException AWS API Documentation
4776
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/ResourceNotFoundException AWS API Documentation
4777
+ #
4778
+ class ResourceNotFoundException < Aws::EmptyStructure; end
4779
+
4780
+ # @note When making an API call, you may pass RetryBuildBatchInput
4781
+ # data as a hash:
4782
+ #
4783
+ # {
4784
+ # id: "NonEmptyString",
4785
+ # idempotency_token: "String",
4786
+ # retry_type: "RETRY_ALL_BUILDS", # accepts RETRY_ALL_BUILDS, RETRY_FAILED_BUILDS
4787
+ # }
4788
+ #
4789
+ # @!attribute [rw] id
4790
+ # Specifies the identifier of the batch build to restart.
4791
+ # @return [String]
4792
+ #
4793
+ # @!attribute [rw] idempotency_token
4794
+ # A unique, case sensitive identifier you provide to ensure the
4795
+ # idempotency of the `RetryBuildBatch` request. The token is included
4796
+ # in the `RetryBuildBatch` request and is valid for five minutes. If
4797
+ # you repeat the `RetryBuildBatch` request with the same token, but
4798
+ # change a parameter, AWS CodeBuild returns a parameter mismatch
4799
+ # error.
4800
+ # @return [String]
4801
+ #
4802
+ # @!attribute [rw] retry_type
4803
+ # Specifies the type of retry to perform.
4804
+ # @return [String]
4805
+ #
4806
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/RetryBuildBatchInput AWS API Documentation
4807
+ #
4808
+ class RetryBuildBatchInput < Struct.new(
4809
+ :id,
4810
+ :idempotency_token,
4811
+ :retry_type)
4812
+ SENSITIVE = []
4813
+ include Aws::Structure
4814
+ end
4815
+
4816
+ # @!attribute [rw] build_batch
4817
+ # Contains information about a batch build.
4818
+ # @return [Types::BuildBatch]
4819
+ #
4820
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/RetryBuildBatchOutput AWS API Documentation
4821
+ #
4822
+ class RetryBuildBatchOutput < Struct.new(
4823
+ :build_batch)
4824
+ SENSITIVE = []
4825
+ include Aws::Structure
4826
+ end
4827
+
4828
+ # @note When making an API call, you may pass RetryBuildInput
4829
+ # data as a hash:
4830
+ #
4831
+ # {
4832
+ # id: "NonEmptyString",
4833
+ # idempotency_token: "String",
4834
+ # }
4835
+ #
4836
+ # @!attribute [rw] id
4837
+ # Specifies the identifier of the build to restart.
4838
+ # @return [String]
4839
+ #
4840
+ # @!attribute [rw] idempotency_token
4841
+ # A unique, case sensitive identifier you provide to ensure the
4842
+ # idempotency of the `RetryBuild` request. The token is included in
4843
+ # the `RetryBuild` request and is valid for five minutes. If you
4844
+ # repeat the `RetryBuild` request with the same token, but change a
4845
+ # parameter, AWS CodeBuild returns a parameter mismatch error.
4846
+ # @return [String]
4847
+ #
4848
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/RetryBuildInput AWS API Documentation
4849
+ #
4850
+ class RetryBuildInput < Struct.new(
4851
+ :id,
4852
+ :idempotency_token)
4853
+ SENSITIVE = []
4854
+ include Aws::Structure
4855
+ end
4856
+
4857
+ # @!attribute [rw] build
4858
+ # Information about a build.
4859
+ # @return [Types::Build]
4860
+ #
4861
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/RetryBuildOutput AWS API Documentation
4862
+ #
4863
+ class RetryBuildOutput < Struct.new(
4864
+ :build)
4865
+ SENSITIVE = []
4866
+ include Aws::Structure
4867
+ end
4868
+
4869
+ # Information about S3 logs for a build project.
4870
+ #
4871
+ # @note When making an API call, you may pass S3LogsConfig
4872
+ # data as a hash:
4873
+ #
4874
+ # {
4875
+ # status: "ENABLED", # required, accepts ENABLED, DISABLED
4876
+ # location: "String",
4877
+ # encryption_disabled: false,
4878
+ # }
4879
+ #
4880
+ # @!attribute [rw] status
4881
+ # The current status of the S3 build logs. Valid values are:
4882
+ #
4883
+ # * `ENABLED`\: S3 build logs are enabled for this build project.
4884
+ #
4885
+ # * `DISABLED`\: S3 build logs are not enabled for this build project.
4886
+ # @return [String]
4887
+ #
4888
+ # @!attribute [rw] location
4889
+ # The ARN of an S3 bucket and the path prefix for S3 logs. If your
4890
+ # Amazon S3 bucket name is `my-bucket`, and your path prefix is
4891
+ # `build-log`, then acceptable formats are `my-bucket/build-log` or
4892
+ # `arn:aws:s3:::my-bucket/build-log`.
4893
+ # @return [String]
4894
+ #
4895
+ # @!attribute [rw] encryption_disabled
4896
+ # Set to true if you do not want your S3 build log output encrypted.
4897
+ # By default S3 build logs are encrypted.
4898
+ # @return [Boolean]
4899
+ #
4900
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/S3LogsConfig AWS API Documentation
4901
+ #
4902
+ class S3LogsConfig < Struct.new(
4903
+ :status,
4904
+ :location,
4905
+ :encryption_disabled)
4906
+ SENSITIVE = []
4907
+ include Aws::Structure
4908
+ end
4909
+
4910
+ # Information about the S3 bucket where the raw data of a report are
4911
+ # exported.
4912
+ #
4913
+ # @note When making an API call, you may pass S3ReportExportConfig
4914
+ # data as a hash:
4915
+ #
4916
+ # {
4917
+ # bucket: "NonEmptyString",
4918
+ # path: "String",
4919
+ # packaging: "ZIP", # accepts ZIP, NONE
4920
+ # encryption_key: "NonEmptyString",
4921
+ # encryption_disabled: false,
4922
+ # }
4923
+ #
4924
+ # @!attribute [rw] bucket
4925
+ # The name of the S3 bucket where the raw data of a report are
4926
+ # exported.
4927
+ # @return [String]
4928
+ #
4929
+ # @!attribute [rw] path
4930
+ # The path to the exported report's raw data results.
4931
+ # @return [String]
4932
+ #
4933
+ # @!attribute [rw] packaging
4934
+ # The type of build output artifact to create. Valid values include:
4935
+ #
4936
+ # * `NONE`\: AWS CodeBuild creates the raw data in the output bucket.
4937
+ # This is the default if packaging is not specified.
4938
+ #
4939
+ # * `ZIP`\: AWS CodeBuild creates a ZIP file with the raw data in the
4940
+ # output bucket.
4941
+ # @return [String]
4942
+ #
4943
+ # @!attribute [rw] encryption_key
4944
+ # The encryption key for the report's encrypted raw data.
4945
+ # @return [String]
4946
+ #
4947
+ # @!attribute [rw] encryption_disabled
4948
+ # A boolean value that specifies if the results of a report are
4949
+ # encrypted.
4950
+ # @return [Boolean]
4951
+ #
4952
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/S3ReportExportConfig AWS API Documentation
4953
+ #
4954
+ class S3ReportExportConfig < Struct.new(
4955
+ :bucket,
4956
+ :path,
4957
+ :packaging,
4958
+ :encryption_key,
4959
+ :encryption_disabled)
4960
+ SENSITIVE = []
4961
+ include Aws::Structure
4962
+ end
4963
+
4964
+ # Information about the authorization settings for AWS CodeBuild to
4965
+ # access the source code to be built.
4966
+ #
4967
+ # This information is for the AWS CodeBuild console's use only. Your
4968
+ # code should not get or set this information directly.
4969
+ #
4970
+ # @note When making an API call, you may pass SourceAuth
4971
+ # data as a hash:
4972
+ #
4973
+ # {
4974
+ # type: "OAUTH", # required, accepts OAUTH
4975
+ # resource: "String",
4976
+ # }
4977
+ #
4978
+ # @!attribute [rw] type
4979
+ # <note markdown="1"> This data type is deprecated and is no longer accurate or used.
4980
+ #
4981
+ # </note>
4982
+ #
4983
+ # The authorization type to use. The only valid value is `OAUTH`,
4984
+ # which represents the OAuth authorization type.
4985
+ # @return [String]
4986
+ #
4987
+ # @!attribute [rw] resource
4988
+ # The resource value that applies to the specified authorization type.
4989
+ # @return [String]
4990
+ #
4991
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/SourceAuth AWS API Documentation
4992
+ #
4993
+ class SourceAuth < Struct.new(
4994
+ :type,
4995
+ :resource)
4996
+ SENSITIVE = []
4997
+ include Aws::Structure
4998
+ end
4999
+
5000
+ # Information about the credentials for a GitHub, GitHub Enterprise, or
5001
+ # Bitbucket repository.
5002
+ #
5003
+ # @!attribute [rw] arn
5004
+ # The Amazon Resource Name (ARN) of the token.
5005
+ # @return [String]
5006
+ #
5007
+ # @!attribute [rw] server_type
5008
+ # The type of source provider. The valid options are GITHUB,
5009
+ # GITHUB\_ENTERPRISE, or BITBUCKET.
5010
+ # @return [String]
5011
+ #
5012
+ # @!attribute [rw] auth_type
5013
+ # The type of authentication used by the credentials. Valid options
5014
+ # are OAUTH, BASIC\_AUTH, or PERSONAL\_ACCESS\_TOKEN.
5015
+ # @return [String]
5016
+ #
5017
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/SourceCredentialsInfo AWS API Documentation
5018
+ #
5019
+ class SourceCredentialsInfo < Struct.new(
5020
+ :arn,
5021
+ :server_type,
5022
+ :auth_type)
5023
+ SENSITIVE = []
5024
+ include Aws::Structure
5025
+ end
5026
+
5027
+ # @note When making an API call, you may pass StartBuildBatchInput
5028
+ # data as a hash:
5029
+ #
5030
+ # {
5031
+ # project_name: "NonEmptyString", # required
5032
+ # secondary_sources_override: [
5033
+ # {
5034
+ # type: "CODECOMMIT", # required, accepts CODECOMMIT, CODEPIPELINE, GITHUB, S3, BITBUCKET, GITHUB_ENTERPRISE, NO_SOURCE
5035
+ # location: "String",
5036
+ # git_clone_depth: 1,
5037
+ # git_submodules_config: {
5038
+ # fetch_submodules: false, # required
5039
+ # },
5040
+ # buildspec: "String",
5041
+ # auth: {
5042
+ # type: "OAUTH", # required, accepts OAUTH
5043
+ # resource: "String",
5044
+ # },
5045
+ # report_build_status: false,
5046
+ # build_status_config: {
5047
+ # context: "String",
5048
+ # target_url: "String",
5049
+ # },
5050
+ # insecure_ssl: false,
5051
+ # source_identifier: "String",
5052
+ # },
5053
+ # ],
5054
+ # secondary_sources_version_override: [
5055
+ # {
5056
+ # source_identifier: "String", # required
5057
+ # source_version: "String", # required
5058
+ # },
5059
+ # ],
5060
+ # source_version: "String",
5061
+ # artifacts_override: {
5062
+ # type: "CODEPIPELINE", # required, accepts CODEPIPELINE, S3, NO_ARTIFACTS
5063
+ # location: "String",
5064
+ # path: "String",
5065
+ # namespace_type: "NONE", # accepts NONE, BUILD_ID
5066
+ # name: "String",
5067
+ # packaging: "NONE", # accepts NONE, ZIP
5068
+ # override_artifact_name: false,
5069
+ # encryption_disabled: false,
5070
+ # artifact_identifier: "String",
5071
+ # },
5072
+ # secondary_artifacts_override: [
5073
+ # {
5074
+ # type: "CODEPIPELINE", # required, accepts CODEPIPELINE, S3, NO_ARTIFACTS
5075
+ # location: "String",
5076
+ # path: "String",
5077
+ # namespace_type: "NONE", # accepts NONE, BUILD_ID
5078
+ # name: "String",
5079
+ # packaging: "NONE", # accepts NONE, ZIP
5080
+ # override_artifact_name: false,
5081
+ # encryption_disabled: false,
5082
+ # artifact_identifier: "String",
5083
+ # },
5084
+ # ],
5085
+ # environment_variables_override: [
5086
+ # {
5087
+ # name: "NonEmptyString", # required
5088
+ # value: "String", # required
5089
+ # type: "PLAINTEXT", # accepts PLAINTEXT, PARAMETER_STORE, SECRETS_MANAGER
5090
+ # },
5091
+ # ],
5092
+ # source_type_override: "CODECOMMIT", # accepts CODECOMMIT, CODEPIPELINE, GITHUB, S3, BITBUCKET, GITHUB_ENTERPRISE, NO_SOURCE
5093
+ # source_location_override: "String",
5094
+ # source_auth_override: {
5095
+ # type: "OAUTH", # required, accepts OAUTH
5096
+ # resource: "String",
5097
+ # },
5098
+ # git_clone_depth_override: 1,
5099
+ # git_submodules_config_override: {
5100
+ # fetch_submodules: false, # required
5101
+ # },
5102
+ # buildspec_override: "String",
5103
+ # insecure_ssl_override: false,
5104
+ # report_build_batch_status_override: false,
5105
+ # environment_type_override: "WINDOWS_CONTAINER", # accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER, WINDOWS_SERVER_2019_CONTAINER
5106
+ # image_override: "NonEmptyString",
5107
+ # compute_type_override: "BUILD_GENERAL1_SMALL", # accepts BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE, BUILD_GENERAL1_2XLARGE
5108
+ # certificate_override: "String",
5109
+ # cache_override: {
5110
+ # type: "NO_CACHE", # required, accepts NO_CACHE, S3, LOCAL
5111
+ # location: "String",
5112
+ # modes: ["LOCAL_DOCKER_LAYER_CACHE"], # accepts LOCAL_DOCKER_LAYER_CACHE, LOCAL_SOURCE_CACHE, LOCAL_CUSTOM_CACHE
5113
+ # },
5114
+ # service_role_override: "NonEmptyString",
5115
+ # privileged_mode_override: false,
5116
+ # build_timeout_in_minutes_override: 1,
5117
+ # queued_timeout_in_minutes_override: 1,
5118
+ # encryption_key_override: "NonEmptyString",
5119
+ # idempotency_token: "String",
5120
+ # logs_config_override: {
5121
+ # cloud_watch_logs: {
5122
+ # status: "ENABLED", # required, accepts ENABLED, DISABLED
5123
+ # group_name: "String",
5124
+ # stream_name: "String",
5125
+ # },
5126
+ # s3_logs: {
5127
+ # status: "ENABLED", # required, accepts ENABLED, DISABLED
5128
+ # location: "String",
5129
+ # encryption_disabled: false,
5130
+ # },
5131
+ # },
5132
+ # registry_credential_override: {
5133
+ # credential: "NonEmptyString", # required
5134
+ # credential_provider: "SECRETS_MANAGER", # required, accepts SECRETS_MANAGER
5135
+ # },
5136
+ # image_pull_credentials_type_override: "CODEBUILD", # accepts CODEBUILD, SERVICE_ROLE
5137
+ # build_batch_config_override: {
5138
+ # service_role: "NonEmptyString",
5139
+ # combine_artifacts: false,
5140
+ # restrictions: {
5141
+ # maximum_builds_allowed: 1,
5142
+ # compute_types_allowed: ["NonEmptyString"],
5143
+ # },
5144
+ # timeout_in_mins: 1,
5145
+ # },
5146
+ # }
5147
+ #
5148
+ # @!attribute [rw] project_name
5149
+ # The name of the project.
5150
+ # @return [String]
5151
+ #
5152
+ # @!attribute [rw] secondary_sources_override
5153
+ # An array of `ProjectSource` objects that override the secondary
5154
+ # sources defined in the batch build project.
5155
+ # @return [Array<Types::ProjectSource>]
5156
+ #
5157
+ # @!attribute [rw] secondary_sources_version_override
5158
+ # An array of `ProjectSourceVersion` objects that override the
5159
+ # secondary source versions in the batch build project.
5160
+ # @return [Array<Types::ProjectSourceVersion>]
5161
+ #
5162
+ # @!attribute [rw] source_version
5163
+ # The version of the batch build input to be built, for this build
5164
+ # only. If not specified, the latest version is used. If specified,
5165
+ # the contents depends on the source provider:
5166
+ #
5167
+ # AWS CodeCommit
5168
+ #
5169
+ # : The commit ID, branch, or Git tag to use.
5170
+ #
5171
+ # GitHub
5172
+ #
5173
+ # : The commit ID, pull request ID, branch name, or tag name that
5174
+ # corresponds to the version of the source code you want to build.
5175
+ # If a pull request ID is specified, it must use the format
5176
+ # `pr/pull-request-ID` (for example `pr/25`). If a branch name is
5177
+ # specified, the branch's HEAD commit ID is used. If not specified,
5178
+ # the default branch's HEAD commit ID is used.
5179
+ #
5180
+ # Bitbucket
5181
+ #
5182
+ # : The commit ID, branch name, or tag name that corresponds to the
5183
+ # version of the source code you want to build. If a branch name is
5184
+ # specified, the branch's HEAD commit ID is used. If not specified,
5185
+ # the default branch's HEAD commit ID is used.
5186
+ #
5187
+ # Amazon Simple Storage Service (Amazon S3)
5188
+ #
5189
+ # : The version ID of the object that represents the build input ZIP
5190
+ # file to use.
5191
+ #
5192
+ # If `sourceVersion` is specified at the project level, then this
5193
+ # `sourceVersion` (at the build level) takes precedence.
5194
+ #
5195
+ # For more information, see [Source Version Sample with CodeBuild][1]
5196
+ # in the *AWS CodeBuild User Guide*.
5197
+ #
5198
+ #
5199
+ #
5200
+ # [1]: https://docs.aws.amazon.com/codebuild/latest/userguide/sample-source-version.html
5201
+ # @return [String]
5202
+ #
5203
+ # @!attribute [rw] artifacts_override
5204
+ # An array of `ProjectArtifacts` objects that contains information
5205
+ # about the build output artifact overrides for the build project.
5206
+ # @return [Types::ProjectArtifacts]
5207
+ #
5208
+ # @!attribute [rw] secondary_artifacts_override
5209
+ # An array of `ProjectArtifacts` objects that override the secondary
5210
+ # artifacts defined in the batch build project.
5211
+ # @return [Array<Types::ProjectArtifacts>]
5212
+ #
5213
+ # @!attribute [rw] environment_variables_override
5214
+ # An array of `EnvironmentVariable` objects that override, or add to,
5215
+ # the environment variables defined in the batch build project.
5216
+ # @return [Array<Types::EnvironmentVariable>]
5217
+ #
5218
+ # @!attribute [rw] source_type_override
5219
+ # The source input type that overrides the source input defined in the
5220
+ # batch build project.
5221
+ # @return [String]
5222
+ #
5223
+ # @!attribute [rw] source_location_override
5224
+ # A location that overrides, for this batch build, the source location
5225
+ # defined in the batch build project.
5226
+ # @return [String]
5227
+ #
5228
+ # @!attribute [rw] source_auth_override
5229
+ # A `SourceAuth` object that overrides the one defined in the batch
5230
+ # build project. This override applies only if the build project's
5231
+ # source is BitBucket or GitHub.
5232
+ # @return [Types::SourceAuth]
5233
+ #
5234
+ # @!attribute [rw] git_clone_depth_override
5235
+ # The user-defined depth of history, with a minimum value of 0, that
5236
+ # overrides, for this batch build only, any previous depth of history
5237
+ # defined in the batch build project.
5238
+ # @return [Integer]
5239
+ #
5240
+ # @!attribute [rw] git_submodules_config_override
5241
+ # A `GitSubmodulesConfig` object that overrides the Git submodules
5242
+ # configuration for this batch build.
5243
+ # @return [Types::GitSubmodulesConfig]
5244
+ #
5245
+ # @!attribute [rw] buildspec_override
5246
+ # A buildspec file declaration that overrides, for this build only,
5247
+ # the latest one already defined in the build project.
5248
+ #
5249
+ # If this value is set, it can be either an inline buildspec
5250
+ # definition, the path to an alternate buildspec file relative to the
5251
+ # value of the built-in `CODEBUILD_SRC_DIR` environment variable, or
5252
+ # the path to an S3 bucket. The bucket must be in the same AWS Region
5253
+ # as the build project. Specify the buildspec file using its ARN (for
5254
+ # example, `arn:aws:s3:::my-codebuild-sample2/buildspec.yml`). If this
5255
+ # value is not provided or is set to an empty string, the source code
5256
+ # must contain a buildspec file in its root directory. For more
5257
+ # information, see [Buildspec File Name and Storage Location][1].
5258
+ #
5259
+ #
3701
5260
  #
3702
- class ResourceNotFoundException < Aws::EmptyStructure; end
3703
-
3704
- # Information about S3 logs for a build project.
5261
+ # [1]: https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html#build-spec-ref-name-storage
5262
+ # @return [String]
3705
5263
  #
3706
- # @note When making an API call, you may pass S3LogsConfig
3707
- # data as a hash:
5264
+ # @!attribute [rw] insecure_ssl_override
5265
+ # Enable this flag to override the insecure SSL setting that is
5266
+ # specified in the batch build project. The insecure SSL setting
5267
+ # determines whether to ignore SSL warnings while connecting to the
5268
+ # project source code. This override applies only if the build's
5269
+ # source is GitHub Enterprise.
5270
+ # @return [Boolean]
3708
5271
  #
3709
- # {
3710
- # status: "ENABLED", # required, accepts ENABLED, DISABLED
3711
- # location: "String",
3712
- # encryption_disabled: false,
3713
- # }
5272
+ # @!attribute [rw] report_build_batch_status_override
5273
+ # Set to `true` to report to your source provider the status of a
5274
+ # batch build's start and completion. If you use this option with a
5275
+ # source provider other than GitHub, GitHub Enterprise, or Bitbucket,
5276
+ # an `invalidInputException` is thrown.
3714
5277
  #
3715
- # @!attribute [rw] status
3716
- # The current status of the S3 build logs. Valid values are:
5278
+ # <note markdown="1"> The status of a build triggered by a webhook is always reported to
5279
+ # your source provider.
3717
5280
  #
3718
- # * `ENABLED`\: S3 build logs are enabled for this build project.
5281
+ # </note>
5282
+ # @return [Boolean]
3719
5283
  #
3720
- # * `DISABLED`\: S3 build logs are not enabled for this build project.
5284
+ # @!attribute [rw] environment_type_override
5285
+ # A container type for this batch build that overrides the one
5286
+ # specified in the batch build project.
3721
5287
  # @return [String]
3722
5288
  #
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`.
5289
+ # @!attribute [rw] image_override
5290
+ # The name of an image for this batch build that overrides the one
5291
+ # specified in the batch build project.
3728
5292
  # @return [String]
3729
5293
  #
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]
5294
+ # @!attribute [rw] compute_type_override
5295
+ # The name of a compute type for this batch build that overrides the
5296
+ # one specified in the batch build project.
5297
+ # @return [String]
3734
5298
  #
3735
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/S3LogsConfig AWS API Documentation
5299
+ # @!attribute [rw] certificate_override
5300
+ # The name of a certificate for this batch build that overrides the
5301
+ # one specified in the batch build project.
5302
+ # @return [String]
3736
5303
  #
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.
5304
+ # @!attribute [rw] cache_override
5305
+ # A `ProjectCache` object that specifies cache overrides.
5306
+ # @return [Types::ProjectCache]
3747
5307
  #
3748
- # @note When making an API call, you may pass S3ReportExportConfig
3749
- # data as a hash:
5308
+ # @!attribute [rw] service_role_override
5309
+ # The name of a service role for this batch build that overrides the
5310
+ # one specified in the batch build project.
5311
+ # @return [String]
3750
5312
  #
3751
- # {
3752
- # bucket: "NonEmptyString",
3753
- # path: "String",
3754
- # packaging: "ZIP", # accepts ZIP, NONE
3755
- # encryption_key: "NonEmptyString",
3756
- # encryption_disabled: false,
3757
- # }
5313
+ # @!attribute [rw] privileged_mode_override
5314
+ # Enable this flag to override privileged mode in the batch build
5315
+ # project.
5316
+ # @return [Boolean]
3758
5317
  #
3759
- # @!attribute [rw] bucket
3760
- # The name of the S3 bucket where the raw data of a report are
3761
- # exported.
3762
- # @return [String]
5318
+ # @!attribute [rw] build_timeout_in_minutes_override
5319
+ # Overrides the build timeout specified in the batch build project.
5320
+ # @return [Integer]
3763
5321
  #
3764
- # @!attribute [rw] path
3765
- # The path to the exported report's raw data results.
3766
- # @return [String]
5322
+ # @!attribute [rw] queued_timeout_in_minutes_override
5323
+ # The number of minutes a batch build is allowed to be queued before
5324
+ # it times out.
5325
+ # @return [Integer]
3767
5326
  #
3768
- # @!attribute [rw] packaging
3769
- # The type of build output artifact to create. Valid values include:
5327
+ # @!attribute [rw] encryption_key_override
5328
+ # The AWS Key Management Service (AWS KMS) customer master key (CMK)
5329
+ # that overrides the one specified in the batch build project. The CMK
5330
+ # key encrypts the build output artifacts.
3770
5331
  #
3771
- # * `NONE`\: AWS CodeBuild creates the raw data in the output bucket.
3772
- # This is the default if packaging is not specified.
5332
+ # <note markdown="1"> You can use a cross-account KMS key to encrypt the build output
5333
+ # artifacts if your service role has permission to that key.
3773
5334
  #
3774
- # * `ZIP`\: AWS CodeBuild creates a ZIP file with the raw data in the
3775
- # output bucket.
3776
- # @return [String]
5335
+ # </note>
3777
5336
  #
3778
- # @!attribute [rw] encryption_key
3779
- # The encryption key for the report's encrypted raw data.
5337
+ # You can specify either the Amazon Resource Name (ARN) of the CMK or,
5338
+ # if available, the CMK's alias (using the format
5339
+ # `alias/<alias-name>`).
3780
5340
  # @return [String]
3781
5341
  #
3782
- # @!attribute [rw] encryption_disabled
3783
- # A boolean value that specifies if the results of a report are
3784
- # encrypted.
3785
- # @return [Boolean]
5342
+ # @!attribute [rw] idempotency_token
5343
+ # A unique, case sensitive identifier you provide to ensure the
5344
+ # idempotency of the `StartBuildBatch` request. The token is included
5345
+ # in the `StartBuildBatch` request and is valid for five minutes. If
5346
+ # you repeat the `StartBuildBatch` request with the same token, but
5347
+ # change a parameter, AWS CodeBuild returns a parameter mismatch
5348
+ # error.
5349
+ # @return [String]
3786
5350
  #
3787
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/S3ReportExportConfig AWS API Documentation
5351
+ # @!attribute [rw] logs_config_override
5352
+ # A `LogsConfig` object that override the log settings defined in the
5353
+ # batch build project.
5354
+ # @return [Types::LogsConfig]
3788
5355
  #
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.
5356
+ # @!attribute [rw] registry_credential_override
5357
+ # A `RegistryCredential` object that overrides credentials for access
5358
+ # to a private registry.
5359
+ # @return [Types::RegistryCredential]
3801
5360
  #
3802
- # This information is for the AWS CodeBuild console's use only. Your
3803
- # code should not get or set this information directly.
5361
+ # @!attribute [rw] image_pull_credentials_type_override
5362
+ # The type of credentials AWS CodeBuild uses to pull images in your
5363
+ # batch build. There are two valid values:
3804
5364
  #
3805
- # @note When making an API call, you may pass SourceAuth
3806
- # data as a hash:
5365
+ # CODEBUILD
3807
5366
  #
3808
- # {
3809
- # type: "OAUTH", # required, accepts OAUTH
3810
- # resource: "String",
3811
- # }
5367
+ # : Specifies that AWS CodeBuild uses its own credentials. This
5368
+ # requires that you modify your ECR repository policy to trust AWS
5369
+ # CodeBuild's service principal.
3812
5370
  #
3813
- # @!attribute [rw] type
3814
- # <note markdown="1"> This data type is deprecated and is no longer accurate or used.
5371
+ # SERVICE\_ROLE
3815
5372
  #
3816
- # </note>
5373
+ # : Specifies that AWS CodeBuild uses your build project's service
5374
+ # role.
3817
5375
  #
3818
- # The authorization type to use. The only valid value is `OAUTH`,
3819
- # which represents the OAuth authorization type.
5376
+ # When using a cross-account or private registry image, you must use
5377
+ # `SERVICE_ROLE` credentials. When using an AWS CodeBuild curated
5378
+ # image, you must use `CODEBUILD` credentials.
3820
5379
  # @return [String]
3821
5380
  #
3822
- # @!attribute [rw] resource
3823
- # The resource value that applies to the specified authorization type.
3824
- # @return [String]
5381
+ # @!attribute [rw] build_batch_config_override
5382
+ # A `BuildBatchConfigOverride` object that contains batch build
5383
+ # configuration overrides.
5384
+ # @return [Types::ProjectBuildBatchConfig]
3825
5385
  #
3826
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/SourceAuth AWS API Documentation
5386
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/StartBuildBatchInput AWS API Documentation
3827
5387
  #
3828
- class SourceAuth < Struct.new(
3829
- :type,
3830
- :resource)
5388
+ class StartBuildBatchInput < Struct.new(
5389
+ :project_name,
5390
+ :secondary_sources_override,
5391
+ :secondary_sources_version_override,
5392
+ :source_version,
5393
+ :artifacts_override,
5394
+ :secondary_artifacts_override,
5395
+ :environment_variables_override,
5396
+ :source_type_override,
5397
+ :source_location_override,
5398
+ :source_auth_override,
5399
+ :git_clone_depth_override,
5400
+ :git_submodules_config_override,
5401
+ :buildspec_override,
5402
+ :insecure_ssl_override,
5403
+ :report_build_batch_status_override,
5404
+ :environment_type_override,
5405
+ :image_override,
5406
+ :compute_type_override,
5407
+ :certificate_override,
5408
+ :cache_override,
5409
+ :service_role_override,
5410
+ :privileged_mode_override,
5411
+ :build_timeout_in_minutes_override,
5412
+ :queued_timeout_in_minutes_override,
5413
+ :encryption_key_override,
5414
+ :idempotency_token,
5415
+ :logs_config_override,
5416
+ :registry_credential_override,
5417
+ :image_pull_credentials_type_override,
5418
+ :build_batch_config_override)
3831
5419
  SENSITIVE = []
3832
5420
  include Aws::Structure
3833
5421
  end
3834
5422
 
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]
5423
+ # @!attribute [rw] build_batch
5424
+ # A `BuildBatch` object that contains information about the batch
5425
+ # build.
5426
+ # @return [Types::BuildBatch]
3851
5427
  #
3852
- # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/SourceCredentialsInfo AWS API Documentation
5428
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/StartBuildBatchOutput AWS API Documentation
3853
5429
  #
3854
- class SourceCredentialsInfo < Struct.new(
3855
- :arn,
3856
- :server_type,
3857
- :auth_type)
5430
+ class StartBuildBatchOutput < Struct.new(
5431
+ :build_batch)
3858
5432
  SENSITIVE = []
3859
5433
  include Aws::Structure
3860
5434
  end
@@ -3941,7 +5515,7 @@ module Aws::CodeBuild
3941
5515
  # context: "String",
3942
5516
  # target_url: "String",
3943
5517
  # },
3944
- # environment_type_override: "WINDOWS_CONTAINER", # accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER
5518
+ # environment_type_override: "WINDOWS_CONTAINER", # accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER, WINDOWS_SERVER_2019_CONTAINER
3945
5519
  # image_override: "NonEmptyString",
3946
5520
  # compute_type_override: "BUILD_GENERAL1_SMALL", # accepts BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE, BUILD_GENERAL1_2XLARGE
3947
5521
  # certificate_override: "String",
@@ -3973,6 +5547,7 @@ module Aws::CodeBuild
3973
5547
  # credential_provider: "SECRETS_MANAGER", # required, accepts SECRETS_MANAGER
3974
5548
  # },
3975
5549
  # image_pull_credentials_type_override: "CODEBUILD", # accepts CODEBUILD, SERVICE_ROLE
5550
+ # debug_session_enabled: false,
3976
5551
  # }
3977
5552
  #
3978
5553
  # @!attribute [rw] project_name
@@ -3991,27 +5566,34 @@ module Aws::CodeBuild
3991
5566
  # @return [Array<Types::ProjectSourceVersion>]
3992
5567
  #
3993
5568
  # @!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:
5569
+ # The version of the build input to be built, for this build only. If
5570
+ # not specified, the latest version is used. If specified, the
5571
+ # contents depends on the source provider:
3997
5572
  #
3998
- # * For AWS CodeCommit: the commit ID, branch, or Git tag to use.
5573
+ # AWS CodeCommit
3999
5574
  #
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.
5575
+ # : The commit ID, branch, or Git tag to use.
4006
5576
  #
4007
- # * For Bitbucket: the commit ID, branch name, or tag name that
5577
+ # GitHub
5578
+ #
5579
+ # : The commit ID, pull request ID, branch name, or tag name that
4008
5580
  # 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.
5581
+ # If a pull request ID is specified, it must use the format
5582
+ # `pr/pull-request-ID` (for example `pr/25`). If a branch name is
5583
+ # specified, the branch's HEAD commit ID is used. If not specified,
5584
+ # the default branch's HEAD commit ID is used.
4012
5585
  #
4013
- # * For Amazon Simple Storage Service (Amazon S3): the version ID of
4014
- # the object that represents the build input ZIP file to use.
5586
+ # Bitbucket
5587
+ #
5588
+ # : The commit ID, branch name, or tag name that corresponds to the
5589
+ # version of the source code you want to build. If a branch name is
5590
+ # specified, the branch's HEAD commit ID is used. If not specified,
5591
+ # the default branch's HEAD commit ID is used.
5592
+ #
5593
+ # Amazon Simple Storage Service (Amazon S3)
5594
+ #
5595
+ # : The version ID of the object that represents the build input ZIP
5596
+ # file to use.
4015
5597
  #
4016
5598
  # If `sourceVersion` is specified at the project level, then this
4017
5599
  # `sourceVersion` (at the build level) takes precedence.
@@ -4167,8 +5749,8 @@ module Aws::CodeBuild
4167
5749
  # </note>
4168
5750
  #
4169
5751
  # 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
- # `).
5752
+ # if available, the CMK's alias (using the format
5753
+ # `alias/<alias-name>`).
4172
5754
  # @return [String]
4173
5755
  #
4174
5756
  # @!attribute [rw] idempotency_token
@@ -4192,18 +5774,31 @@ module Aws::CodeBuild
4192
5774
  # The type of credentials AWS CodeBuild uses to pull images in your
4193
5775
  # build. There are two valid values:
4194
5776
  #
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.
5777
+ # CODEBUILD
4198
5778
  #
4199
- # * `SERVICE_ROLE` specifies that AWS CodeBuild uses your build
4200
- # project's service role.
5779
+ # : Specifies that AWS CodeBuild uses its own credentials. This
5780
+ # requires that you modify your ECR repository policy to trust AWS
5781
+ # CodeBuild's service principal.
5782
+ #
5783
+ # SERVICE\_ROLE
5784
+ #
5785
+ # : Specifies that AWS CodeBuild uses your build project's service
5786
+ # role.
4201
5787
  #
4202
5788
  # 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.
5789
+ # `SERVICE_ROLE` credentials. When using an AWS CodeBuild curated
5790
+ # image, you must use `CODEBUILD` credentials.
4205
5791
  # @return [String]
4206
5792
  #
5793
+ # @!attribute [rw] debug_session_enabled
5794
+ # Specifies if session debugging is enabled for this build. For more
5795
+ # information, see [Viewing a running build in Session Manager][1].
5796
+ #
5797
+ #
5798
+ #
5799
+ # [1]: https://docs.aws.amazon.com/codebuild/latest/userguide/session-manager.html
5800
+ # @return [Boolean]
5801
+ #
4207
5802
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/StartBuildInput AWS API Documentation
4208
5803
  #
4209
5804
  class StartBuildInput < Struct.new(
@@ -4236,7 +5831,8 @@ module Aws::CodeBuild
4236
5831
  :idempotency_token,
4237
5832
  :logs_config_override,
4238
5833
  :registry_credential_override,
4239
- :image_pull_credentials_type_override)
5834
+ :image_pull_credentials_type_override,
5835
+ :debug_session_enabled)
4240
5836
  SENSITIVE = []
4241
5837
  include Aws::Structure
4242
5838
  end
@@ -4253,6 +5849,37 @@ module Aws::CodeBuild
4253
5849
  include Aws::Structure
4254
5850
  end
4255
5851
 
5852
+ # @note When making an API call, you may pass StopBuildBatchInput
5853
+ # data as a hash:
5854
+ #
5855
+ # {
5856
+ # id: "NonEmptyString", # required
5857
+ # }
5858
+ #
5859
+ # @!attribute [rw] id
5860
+ # The identifier of the batch build to stop.
5861
+ # @return [String]
5862
+ #
5863
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/StopBuildBatchInput AWS API Documentation
5864
+ #
5865
+ class StopBuildBatchInput < Struct.new(
5866
+ :id)
5867
+ SENSITIVE = []
5868
+ include Aws::Structure
5869
+ end
5870
+
5871
+ # @!attribute [rw] build_batch
5872
+ # Contains information about a batch build.
5873
+ # @return [Types::BuildBatch]
5874
+ #
5875
+ # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/StopBuildBatchOutput AWS API Documentation
5876
+ #
5877
+ class StopBuildBatchOutput < Struct.new(
5878
+ :build_batch)
5879
+ SENSITIVE = []
5880
+ include Aws::Structure
5881
+ end
5882
+
4256
5883
  # @note When making an API call, you may pass StopBuildInput
4257
5884
  # data as a hash:
4258
5885
  #
@@ -4371,25 +5998,43 @@ module Aws::CodeBuild
4371
5998
  include Aws::Structure
4372
5999
  end
4373
6000
 
4374
- # A filter used to return specific types of test cases.
6001
+ # A filter used to return specific types of test cases. In order to pass
6002
+ # the filter, the report must meet all of the filter properties.
4375
6003
  #
4376
6004
  # @note When making an API call, you may pass TestCaseFilter
4377
6005
  # data as a hash:
4378
6006
  #
4379
6007
  # {
4380
6008
  # status: "String",
6009
+ # keyword: "String",
4381
6010
  # }
4382
6011
  #
4383
6012
  # @!attribute [rw] status
4384
- # The status used to filter test cases. Valid statuses are
4385
- # `SUCCEEDED`, `FAILED`, `ERROR`, `SKIPPED`, and `UNKNOWN`. A
4386
- # `TestCaseFilter` can have one status.
6013
+ # The status used to filter test cases. A `TestCaseFilter` can have
6014
+ # one status. Valid values are:
6015
+ #
6016
+ # * `SUCCEEDED`
6017
+ #
6018
+ # * `FAILED`
6019
+ #
6020
+ # * `ERROR`
6021
+ #
6022
+ # * `SKIPPED`
6023
+ #
6024
+ # * `UNKNOWN`
6025
+ # @return [String]
6026
+ #
6027
+ # @!attribute [rw] keyword
6028
+ # A keyword that is used to filter on the `name` or the `prefix` of
6029
+ # the test cases. Only test cases where the keyword is a substring of
6030
+ # the `name` or the `prefix` will be returned.
4387
6031
  # @return [String]
4388
6032
  #
4389
6033
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/TestCaseFilter AWS API Documentation
4390
6034
  #
4391
6035
  class TestCaseFilter < Struct.new(
4392
- :status)
6036
+ :status,
6037
+ :keyword)
4393
6038
  SENSITIVE = []
4394
6039
  include Aws::Structure
4395
6040
  end
@@ -4506,7 +6151,7 @@ module Aws::CodeBuild
4506
6151
  # modes: ["LOCAL_DOCKER_LAYER_CACHE"], # accepts LOCAL_DOCKER_LAYER_CACHE, LOCAL_SOURCE_CACHE, LOCAL_CUSTOM_CACHE
4507
6152
  # },
4508
6153
  # environment: {
4509
- # type: "WINDOWS_CONTAINER", # required, accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER
6154
+ # type: "WINDOWS_CONTAINER", # required, accepts WINDOWS_CONTAINER, LINUX_CONTAINER, LINUX_GPU_CONTAINER, ARM_CONTAINER, WINDOWS_SERVER_2019_CONTAINER
4510
6155
  # image: "NonEmptyString", # required
4511
6156
  # compute_type: "BUILD_GENERAL1_SMALL", # required, accepts BUILD_GENERAL1_SMALL, BUILD_GENERAL1_MEDIUM, BUILD_GENERAL1_LARGE, BUILD_GENERAL1_2XLARGE
4512
6157
  # environment_variables: [
@@ -4561,6 +6206,15 @@ module Aws::CodeBuild
4561
6206
  # mount_options: "String",
4562
6207
  # },
4563
6208
  # ],
6209
+ # build_batch_config: {
6210
+ # service_role: "NonEmptyString",
6211
+ # combine_artifacts: false,
6212
+ # restrictions: {
6213
+ # maximum_builds_allowed: 1,
6214
+ # compute_types_allowed: ["NonEmptyString"],
6215
+ # },
6216
+ # timeout_in_mins: 1,
6217
+ # },
4564
6218
  # }
4565
6219
  #
4566
6220
  # @!attribute [rw] name
@@ -4671,8 +6325,8 @@ module Aws::CodeBuild
4671
6325
  # </note>
4672
6326
  #
4673
6327
  # 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
- # `).
6328
+ # if available, the CMK's alias (using the format
6329
+ # `alias/<alias-name>`).
4676
6330
  # @return [String]
4677
6331
  #
4678
6332
  # @!attribute [rw] tags
@@ -4705,6 +6359,10 @@ module Aws::CodeBuild
4705
6359
  # of a file system created using Amazon Elastic File System.
4706
6360
  # @return [Array<Types::ProjectFileSystemLocation>]
4707
6361
  #
6362
+ # @!attribute [rw] build_batch_config
6363
+ # Contains configuration information about a batch build project.
6364
+ # @return [Types::ProjectBuildBatchConfig]
6365
+ #
4708
6366
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/UpdateProjectInput AWS API Documentation
4709
6367
  #
4710
6368
  class UpdateProjectInput < Struct.new(
@@ -4726,7 +6384,8 @@ module Aws::CodeBuild
4726
6384
  :vpc_config,
4727
6385
  :badge_enabled,
4728
6386
  :logs_config,
4729
- :file_system_locations)
6387
+ :file_system_locations,
6388
+ :build_batch_config)
4730
6389
  SENSITIVE = []
4731
6390
  include Aws::Structure
4732
6391
  end
@@ -4824,6 +6483,7 @@ module Aws::CodeBuild
4824
6483
  # },
4825
6484
  # ],
4826
6485
  # ],
6486
+ # build_type: "BUILD", # accepts BUILD, BUILD_BATCH
4827
6487
  # }
4828
6488
  #
4829
6489
  # @!attribute [rw] project_name
@@ -4854,13 +6514,18 @@ module Aws::CodeBuild
4854
6514
  # least one `EVENT` `WebhookFilter`.
4855
6515
  # @return [Array<Array<Types::WebhookFilter>>]
4856
6516
  #
6517
+ # @!attribute [rw] build_type
6518
+ # Specifies the type of build this webhook will trigger.
6519
+ # @return [String]
6520
+ #
4857
6521
  # @see http://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06/UpdateWebhookInput AWS API Documentation
4858
6522
  #
4859
6523
  class UpdateWebhookInput < Struct.new(
4860
6524
  :project_name,
4861
6525
  :branch_filter,
4862
6526
  :rotate_secret,
4863
- :filter_groups)
6527
+ :filter_groups,
6528
+ :build_type)
4864
6529
  SENSITIVE = []
4865
6530
  include Aws::Structure
4866
6531
  end
@@ -4952,6 +6617,10 @@ module Aws::CodeBuild
4952
6617
  # its filters must pass.
4953
6618
  # @return [Array<Array<Types::WebhookFilter>>]
4954
6619
  #
6620
+ # @!attribute [rw] build_type
6621
+ # Specifies the type of build this webhook will trigger.
6622
+ # @return [String]
6623
+ #
4955
6624
  # @!attribute [rw] last_modified_secret
4956
6625
  # A timestamp that indicates the last time a repository's secret
4957
6626
  # token was modified.
@@ -4965,6 +6634,7 @@ module Aws::CodeBuild
4965
6634
  :secret,
4966
6635
  :branch_filter,
4967
6636
  :filter_groups,
6637
+ :build_type,
4968
6638
  :last_modified_secret)
4969
6639
  SENSITIVE = []
4970
6640
  include Aws::Structure