NAME
Paws::CodeBuild - Perl Interface to AWS AWS CodeBuild
SYNOPSIS
use Paws;
my $obj = Paws->service('CodeBuild');
my $res = $obj->Method(
Arg1 => $val1,
Arg2 => [ 'V1', 'V2' ],
# if Arg3 is an object, the HashRef will be used as arguments to the constructor
# of the arguments type
Arg3 => { Att1 => 'Val1' },
# if Arg4 is an array of objects, the HashRefs will be passed as arguments to
# the constructor of the arguments type
Arg4 => [ { Att1 => 'Val1' }, { Att1 => 'Val2' } ],
);
DESCRIPTION
AWS CodeBuild
AWS CodeBuild is a fully managed build service in the cloud. AWS CodeBuild compiles your source code, runs unit tests, and produces artifacts that are ready to deploy. AWS CodeBuild eliminates the need to provision, manage, and scale your own build servers. It provides prepackaged build environments for the most popular programming languages and build tools, such as Apache Maven, Gradle, and more. You can also fully customize build environments in AWS CodeBuild to use your own build tools. AWS CodeBuild scales automatically to meet peak build requests. You pay only for the build time you consume. For more information about AWS CodeBuild, see the AWS CodeBuild User Guide (https://docs.aws.amazon.com/codebuild/latest/userguide/welcome.html).
AWS CodeBuild supports these operations:
BatchDeleteBuilds: Deletes one or more builds.BatchGetBuilds: Gets information about one or more builds.BatchGetProjects: Gets information about one or more build projects. A build project defines how AWS CodeBuild runs a build. This includes information such as where to get the source code to build, the build environment to use, the build commands to run, and where to store the build output. A build environment is a representation of operating system, programming language runtime, and tools that AWS CodeBuild uses to run a build. You can add tags to build projects to help manage your resources and costs.BatchGetReportGroups: Returns an array of report groups.BatchGetReports: Returns an array of reports.CreateProject: Creates a build project.CreateReportGroup: Creates a report group. A report group contains a collection of reports.CreateWebhook: For an existing AWS CodeBuild build project that has its source code stored in a GitHub or Bitbucket repository, enables AWS CodeBuild to start rebuilding the source code every time a code change is pushed to the repository.DeleteProject: Deletes a build project.DeleteReport: Deletes a report.DeleteReportGroup: Deletes a report group.DeleteResourcePolicy: Deletes a resource policy that is identified by its resource ARN.DeleteSourceCredentials: Deletes a set of GitHub, GitHub Enterprise, or Bitbucket source credentials.DeleteWebhook: For an existing AWS CodeBuild build project that has its source code stored in a GitHub or Bitbucket repository, stops AWS CodeBuild from rebuilding the source code every time a code change is pushed to the repository.DescribeTestCases: Returns a list of details about test cases for a report.GetResourcePolicy: Gets a resource policy that is identified by its resource ARN.ImportSourceCredentials: Imports the source repository credentials for an AWS CodeBuild project that has its source code stored in a GitHub, GitHub Enterprise, or Bitbucket repository.InvalidateProjectCache: Resets the cache for a project.ListBuilds: Gets a list of build IDs, with each build ID representing a single build.ListBuildsForProject: Gets a list of build IDs for the specified build project, with each build ID representing a single build.ListCuratedEnvironmentImages: Gets information about Docker images that are managed by AWS CodeBuild.ListProjects: Gets a list of build project names, with each build project name representing a single build project.ListReportGroups: Gets a list ARNs for the report groups in the current AWS account.ListReports: Gets a list ARNs for the reports in the current AWS account.ListReportsForReportGroup: Returns a list of ARNs for the reports that belong to aReportGroup.ListSharedProjects: Gets a list of ARNs associated with projects shared with the current AWS account or user.ListSharedReportGroups: Gets a list of ARNs associated with report groups shared with the current AWS account or userListSourceCredentials: Returns a list ofSourceCredentialsInfoobjects. EachSourceCredentialsInfoobject includes the authentication type, token ARN, and type of source provider for one set of credentials.PutResourcePolicy: Stores a resource policy for the ARN of aProjectorReportGroupobject.StartBuild: Starts running a build.StopBuild: Attempts to stop running a build.UpdateProject: Changes the settings of an existing build project.UpdateReportGroup: Changes a report group.UpdateWebhook: Changes the settings of an existing webhook.
For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/codebuild-2016-10-06
METHODS
BatchDeleteBuilds
Each argument is described in detail in: Paws::CodeBuild::BatchDeleteBuilds
Returns: a Paws::CodeBuild::BatchDeleteBuildsOutput instance
Deletes one or more builds.
BatchGetBuilds
Each argument is described in detail in: Paws::CodeBuild::BatchGetBuilds
Returns: a Paws::CodeBuild::BatchGetBuildsOutput instance
Gets information about one or more builds.
BatchGetProjects
Each argument is described in detail in: Paws::CodeBuild::BatchGetProjects
Returns: a Paws::CodeBuild::BatchGetProjectsOutput instance
Gets information about one or more build projects.
BatchGetReportGroups
Each argument is described in detail in: Paws::CodeBuild::BatchGetReportGroups
Returns: a Paws::CodeBuild::BatchGetReportGroupsOutput instance
Returns an array of report groups.
BatchGetReports
Each argument is described in detail in: Paws::CodeBuild::BatchGetReports
Returns: a Paws::CodeBuild::BatchGetReportsOutput instance
Returns an array of reports.
CreateProject
- Artifacts => Paws::CodeBuild::ProjectArtifacts
- Environment => Paws::CodeBuild::ProjectEnvironment
- Name => Str
- ServiceRole => Str
- Source => Paws::CodeBuild::ProjectSource
- [BadgeEnabled => Bool]
- [Cache => Paws::CodeBuild::ProjectCache]
- [Description => Str]
- [EncryptionKey => Str]
- [FileSystemLocations => ArrayRef[Paws::CodeBuild::ProjectFileSystemLocation]]
- [LogsConfig => Paws::CodeBuild::LogsConfig]
- [QueuedTimeoutInMinutes => Int]
- [SecondaryArtifacts => ArrayRef[Paws::CodeBuild::ProjectArtifacts]]
- [SecondarySources => ArrayRef[Paws::CodeBuild::ProjectSource]]
- [SecondarySourceVersions => ArrayRef[Paws::CodeBuild::ProjectSourceVersion]]
- [SourceVersion => Str]
- [Tags => ArrayRef[Paws::CodeBuild::Tag]]
- [TimeoutInMinutes => Int]
- [VpcConfig => Paws::CodeBuild::VpcConfig]
Each argument is described in detail in: Paws::CodeBuild::CreateProject
Returns: a Paws::CodeBuild::CreateProjectOutput instance
Creates a build project.
CreateReportGroup
- ExportConfig => Paws::CodeBuild::ReportExportConfig
- Name => Str
- Type => Str
Each argument is described in detail in: Paws::CodeBuild::CreateReportGroup
Returns: a Paws::CodeBuild::CreateReportGroupOutput instance
Creates a report group. A report group contains a collection of reports.
CreateWebhook
- ProjectName => Str
- [BranchFilter => Str]
- [FilterGroups => ArrayRef[ArrayRef[Paws::CodeBuild::WebhookFilter]]]
Each argument is described in detail in: Paws::CodeBuild::CreateWebhook
Returns: a Paws::CodeBuild::CreateWebhookOutput instance
For an existing AWS CodeBuild build project that has its source code stored in a GitHub or Bitbucket repository, enables AWS CodeBuild to start rebuilding the source code every time a code change is pushed to the repository.
If you enable webhooks for an AWS CodeBuild project, and the project is used as a build step in AWS CodePipeline, then two identical builds are created for each commit. One build is triggered through webhooks, and one through AWS CodePipeline. Because billing is on a per-build basis, you are billed for both builds. Therefore, if you are using AWS CodePipeline, we recommend that you disable webhooks in AWS CodeBuild. In the AWS CodeBuild console, clear the Webhook box. For more information, see step 5 in Change a Build Project's Settings (https://docs.aws.amazon.com/codebuild/latest/userguide/change-project.html#change-project-console).
DeleteProject
Each argument is described in detail in: Paws::CodeBuild::DeleteProject
Returns: a Paws::CodeBuild::DeleteProjectOutput instance
Deletes a build project. When you delete a project, its builds are not deleted.
DeleteReport
Each argument is described in detail in: Paws::CodeBuild::DeleteReport
Returns: a Paws::CodeBuild::DeleteReportOutput instance
Deletes a report.
DeleteReportGroup
Each argument is described in detail in: Paws::CodeBuild::DeleteReportGroup
Returns: a Paws::CodeBuild::DeleteReportGroupOutput instance
DeleteReportGroup: Deletes a report group. Before you delete a report group, you must delete its reports. Use ListReportsForReportGroup (https://docs.aws.amazon.com/codebuild/latest/APIReference/API_ListReportsForReportGroup.html) to get the reports in a report group. Use DeleteReport (https://docs.aws.amazon.com/codebuild/latest/APIReference/API_DeleteReport.html) to delete the reports. If you call DeleteReportGroup for a report group that contains one or more reports, an exception is thrown.
DeleteResourcePolicy
Each argument is described in detail in: Paws::CodeBuild::DeleteResourcePolicy
Returns: a Paws::CodeBuild::DeleteResourcePolicyOutput instance
Deletes a resource policy that is identified by its resource ARN.
DeleteSourceCredentials
Each argument is described in detail in: Paws::CodeBuild::DeleteSourceCredentials
Returns: a Paws::CodeBuild::DeleteSourceCredentialsOutput instance
Deletes a set of GitHub, GitHub Enterprise, or Bitbucket source credentials.
DeleteWebhook
Each argument is described in detail in: Paws::CodeBuild::DeleteWebhook
Returns: a Paws::CodeBuild::DeleteWebhookOutput instance
For an existing AWS CodeBuild build project that has its source code stored in a GitHub or Bitbucket repository, stops AWS CodeBuild from rebuilding the source code every time a code change is pushed to the repository.
DescribeTestCases
- ReportArn => Str
- [Filter => Paws::CodeBuild::TestCaseFilter]
- [MaxResults => Int]
- [NextToken => Str]
Each argument is described in detail in: Paws::CodeBuild::DescribeTestCases
Returns: a Paws::CodeBuild::DescribeTestCasesOutput instance
Returns a list of details about test cases for a report.
GetResourcePolicy
Each argument is described in detail in: Paws::CodeBuild::GetResourcePolicy
Returns: a Paws::CodeBuild::GetResourcePolicyOutput instance
Gets a resource policy that is identified by its resource ARN.
ImportSourceCredentials
Each argument is described in detail in: Paws::CodeBuild::ImportSourceCredentials
Returns: a Paws::CodeBuild::ImportSourceCredentialsOutput instance
Imports the source repository credentials for an AWS CodeBuild project that has its source code stored in a GitHub, GitHub Enterprise, or Bitbucket repository.
InvalidateProjectCache
Each argument is described in detail in: Paws::CodeBuild::InvalidateProjectCache
Returns: a Paws::CodeBuild::InvalidateProjectCacheOutput instance
Resets the cache for a project.
ListBuilds
Each argument is described in detail in: Paws::CodeBuild::ListBuilds
Returns: a Paws::CodeBuild::ListBuildsOutput instance
Gets a list of build IDs, with each build ID representing a single build.
ListBuildsForProject
Each argument is described in detail in: Paws::CodeBuild::ListBuildsForProject
Returns: a Paws::CodeBuild::ListBuildsForProjectOutput instance
Gets a list of build IDs for the specified build project, with each build ID representing a single build.
ListCuratedEnvironmentImages
Each argument is described in detail in: Paws::CodeBuild::ListCuratedEnvironmentImages
Returns: a Paws::CodeBuild::ListCuratedEnvironmentImagesOutput instance
Gets information about Docker images that are managed by AWS CodeBuild.
ListProjects
Each argument is described in detail in: Paws::CodeBuild::ListProjects
Returns: a Paws::CodeBuild::ListProjectsOutput instance
Gets a list of build project names, with each build project name representing a single build project.
ListReportGroups
Each argument is described in detail in: Paws::CodeBuild::ListReportGroups
Returns: a Paws::CodeBuild::ListReportGroupsOutput instance
Gets a list ARNs for the report groups in the current AWS account.
ListReports
- [Filter => Paws::CodeBuild::ReportFilter]
- [MaxResults => Int]
- [NextToken => Str]
- [SortOrder => Str]
Each argument is described in detail in: Paws::CodeBuild::ListReports
Returns: a Paws::CodeBuild::ListReportsOutput instance
Returns a list of ARNs for the reports in the current AWS account.
ListReportsForReportGroup
- ReportGroupArn => Str
- [Filter => Paws::CodeBuild::ReportFilter]
- [MaxResults => Int]
- [NextToken => Str]
- [SortOrder => Str]
Each argument is described in detail in: Paws::CodeBuild::ListReportsForReportGroup
Returns: a Paws::CodeBuild::ListReportsForReportGroupOutput instance
Returns a list of ARNs for the reports that belong to a ReportGroup.
ListSharedProjects
Each argument is described in detail in: Paws::CodeBuild::ListSharedProjects
Returns: a Paws::CodeBuild::ListSharedProjectsOutput instance
Gets a list of projects that are shared with other AWS accounts or users.
ListSharedReportGroups
Each argument is described in detail in: Paws::CodeBuild::ListSharedReportGroups
Returns: a Paws::CodeBuild::ListSharedReportGroupsOutput instance
Gets a list of report groups that are shared with other AWS accounts or users.
ListSourceCredentials
Each argument is described in detail in: Paws::CodeBuild::ListSourceCredentials
Returns: a Paws::CodeBuild::ListSourceCredentialsOutput instance
Returns a list of SourceCredentialsInfo objects.
PutResourcePolicy
Each argument is described in detail in: Paws::CodeBuild::PutResourcePolicy
Returns: a Paws::CodeBuild::PutResourcePolicyOutput instance
Stores a resource policy for the ARN of a Project or ReportGroup object.
StartBuild
- ProjectName => Str
- [ArtifactsOverride => Paws::CodeBuild::ProjectArtifacts]
- [BuildspecOverride => Str]
- [CacheOverride => Paws::CodeBuild::ProjectCache]
- [CertificateOverride => Str]
- [ComputeTypeOverride => Str]
- [EncryptionKeyOverride => Str]
- [EnvironmentTypeOverride => Str]
- [EnvironmentVariablesOverride => ArrayRef[Paws::CodeBuild::EnvironmentVariable]]
- [GitCloneDepthOverride => Int]
- [GitSubmodulesConfigOverride => Paws::CodeBuild::GitSubmodulesConfig]
- [IdempotencyToken => Str]
- [ImageOverride => Str]
- [ImagePullCredentialsTypeOverride => Str]
- [InsecureSslOverride => Bool]
- [LogsConfigOverride => Paws::CodeBuild::LogsConfig]
- [PrivilegedModeOverride => Bool]
- [QueuedTimeoutInMinutesOverride => Int]
- [RegistryCredentialOverride => Paws::CodeBuild::RegistryCredential]
- [ReportBuildStatusOverride => Bool]
- [SecondaryArtifactsOverride => ArrayRef[Paws::CodeBuild::ProjectArtifacts]]
- [SecondarySourcesOverride => ArrayRef[Paws::CodeBuild::ProjectSource]]
- [SecondarySourcesVersionOverride => ArrayRef[Paws::CodeBuild::ProjectSourceVersion]]
- [ServiceRoleOverride => Str]
- [SourceAuthOverride => Paws::CodeBuild::SourceAuth]
- [SourceLocationOverride => Str]
- [SourceTypeOverride => Str]
- [SourceVersion => Str]
- [TimeoutInMinutesOverride => Int]
Each argument is described in detail in: Paws::CodeBuild::StartBuild
Returns: a Paws::CodeBuild::StartBuildOutput instance
Starts running a build.
StopBuild
Each argument is described in detail in: Paws::CodeBuild::StopBuild
Returns: a Paws::CodeBuild::StopBuildOutput instance
Attempts to stop running a build.
UpdateProject
- Name => Str
- [Artifacts => Paws::CodeBuild::ProjectArtifacts]
- [BadgeEnabled => Bool]
- [Cache => Paws::CodeBuild::ProjectCache]
- [Description => Str]
- [EncryptionKey => Str]
- [Environment => Paws::CodeBuild::ProjectEnvironment]
- [FileSystemLocations => ArrayRef[Paws::CodeBuild::ProjectFileSystemLocation]]
- [LogsConfig => Paws::CodeBuild::LogsConfig]
- [QueuedTimeoutInMinutes => Int]
- [SecondaryArtifacts => ArrayRef[Paws::CodeBuild::ProjectArtifacts]]
- [SecondarySources => ArrayRef[Paws::CodeBuild::ProjectSource]]
- [SecondarySourceVersions => ArrayRef[Paws::CodeBuild::ProjectSourceVersion]]
- [ServiceRole => Str]
- [Source => Paws::CodeBuild::ProjectSource]
- [SourceVersion => Str]
- [Tags => ArrayRef[Paws::CodeBuild::Tag]]
- [TimeoutInMinutes => Int]
- [VpcConfig => Paws::CodeBuild::VpcConfig]
Each argument is described in detail in: Paws::CodeBuild::UpdateProject
Returns: a Paws::CodeBuild::UpdateProjectOutput instance
Changes the settings of a build project.
UpdateReportGroup
- Arn => Str
- [ExportConfig => Paws::CodeBuild::ReportExportConfig]
Each argument is described in detail in: Paws::CodeBuild::UpdateReportGroup
Returns: a Paws::CodeBuild::UpdateReportGroupOutput instance
Updates a report group.
UpdateWebhook
- ProjectName => Str
- [BranchFilter => Str]
- [FilterGroups => ArrayRef[ArrayRef[Paws::CodeBuild::WebhookFilter]]]
- [RotateSecret => Bool]
Each argument is described in detail in: Paws::CodeBuild::UpdateWebhook
Returns: a Paws::CodeBuild::UpdateWebhookOutput instance
Updates the webhook associated with an AWS CodeBuild build project.
If you use Bitbucket for your repository, rotateSecret is ignored.
PAGINATORS
Paginator methods are helpers that repetively call methods that return partial results
ListAllBuilds(sub { },[NextToken => Str, SortOrder => Str])
ListAllBuilds([NextToken => Str, SortOrder => Str])
If passed a sub as first parameter, it will call the sub for each element found in :
- ids, passing the object as the first parameter, and the string 'ids' as the second parameter
If not, it will return a a Paws::CodeBuild::ListBuildsOutput instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
ListAllBuildsForProject(sub { },ProjectName => Str, [NextToken => Str, SortOrder => Str])
ListAllBuildsForProject(ProjectName => Str, [NextToken => Str, SortOrder => Str])
If passed a sub as first parameter, it will call the sub for each element found in :
- ids, passing the object as the first parameter, and the string 'ids' as the second parameter
If not, it will return a a Paws::CodeBuild::ListBuildsForProjectOutput instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
ListAllProjects(sub { },[NextToken => Str, SortBy => Str, SortOrder => Str])
ListAllProjects([NextToken => Str, SortBy => Str, SortOrder => Str])
If passed a sub as first parameter, it will call the sub for each element found in :
- projects, passing the object as the first parameter, and the string 'projects' as the second parameter
If not, it will return a a Paws::CodeBuild::ListProjectsOutput instance with all the params; from all the responses. Please take into account that this mode can potentially consume vasts ammounts of memory.
SEE ALSO
This service class forms part of Paws
BUGS and CONTRIBUTIONS
The source code is located here: https://github.com/pplu/aws-sdk-perl
Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues