Skip to content

Commit 910c16d

Browse files
Update generated code (#1682)
update generated code
1 parent 98c8246 commit 910c16d

File tree

3 files changed

+17
-3
lines changed

3 files changed

+17
-3
lines changed

CHANGELOG.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,10 @@
22

33
## NOT RELEASED
44

5+
### Changed
6+
7+
- AWS enhancement: Documentation updates.
8+
59
## 2.3.0
610

711
### Added

src/CodeBuildClient.php

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,12 @@ public function batchGetBuilds($input): BatchGetBuildsOutput
5858
}
5959

6060
/**
61-
* Starts running a build.
61+
* Starts running a build with the settings defined in the project. These setting include: how to run a build, where to
62+
* get the source code, which build environment to use, which build commands to run, and where to store the build
63+
* output.
64+
*
65+
* You can also start a build run by overriding some of the build settings in the project. The overrides only apply for
66+
* that specific start build request. The settings in the project are unaltered.
6267
*
6368
* @see https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuild.html
6469
* @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-codebuild-2016-10-06.html#startbuild

src/Input/StartBuildInput.php

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -142,8 +142,8 @@ final class StartBuildInput extends Input
142142
private $gitSubmodulesConfigOverride;
143143

144144
/**
145-
* A buildspec file declaration that overrides, for this build only, the latest one already defined in the build
146-
* project.
145+
* A buildspec file declaration that overrides the latest one defined in the build project, for this build only. The
146+
* buildspec defined on the project is not changed.
147147
*
148148
* If this value is set, it can be either an inline buildspec definition, the path to an alternate buildspec file
149149
* relative to the value of the built-in `CODEBUILD_SRC_DIR` environment variable, or the path to an S3 bucket. The
@@ -152,6 +152,11 @@ final class StartBuildInput extends Input
152152
* string, the source code must contain a buildspec file in its root directory. For more information, see Buildspec File
153153
* Name and Storage Location [^1].
154154
*
155+
* > Since this property allows you to change the build commands that will run in the container, you should note that an
156+
* > IAM principal with the ability to call this API and set this parameter can override the default settings. Moreover,
157+
* > we encourage that you use a trustworthy buildspec location like a file in your source repository or a Amazon S3
158+
* > bucket.
159+
*
155160
* [^1]: https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html#build-spec-ref-name-storage
156161
*
157162
* @var string|null

0 commit comments

Comments
 (0)