Struct aws_sdk_codebuild::types::builders::ProjectArtifactsBuilder

#[non_exhaustive]
pub struct ProjectArtifactsBuilder { /* private fields */ }

A builder for ProjectArtifacts.

Implementations

impl ProjectArtifactsBuilder

pub fn type(self, input: ArtifactsType) -> Self

The type of build output artifact. Valid values include:

• CODEPIPELINE: The build project has build output generated through CodePipeline.

  The CODEPIPELINE type is not supported for secondaryArtifacts.

• NO_ARTIFACTS: The build project does not produce any build output.

• S3: The build project stores build output in Amazon S3.

This field is required.

pub fn set_type(self, input: Option<ArtifactsType>) -> Self

The type of build output artifact. Valid values include:

• CODEPIPELINE: The build project has build output generated through CodePipeline.

  The CODEPIPELINE type is not supported for secondaryArtifacts.

• NO_ARTIFACTS: The build project does not produce any build output.

• S3: The build project stores build output in Amazon S3.

pub fn get_type(&self) -> &Option<ArtifactsType>

The type of build output artifact. Valid values include:

• CODEPIPELINE: The build project has build output generated through CodePipeline.

  The CODEPIPELINE type is not supported for secondaryArtifacts.

• NO_ARTIFACTS: The build project does not produce any build output.

• S3: The build project stores build output in Amazon S3.

pub fn location(self, input: impl Into<String>) -> Self

Information about the build output artifact location:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output locations instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, this is the name of the output bucket.

pub fn set_location(self, input: Option<String>) -> Self

Information about the build output artifact location:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output locations instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, this is the name of the output bucket.

pub fn get_location(&self) -> &Option<String>

Information about the build output artifact location:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output locations instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, this is the name of the output bucket.

pub fn path(self, input: impl Into<String>) -> Self

Along with namespaceType and name, the pattern that CodeBuild uses to name and store the output artifact:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output names instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, this is the path to the output artifact. If path is not specified, path is not used.

For example, if path is set to MyArtifacts, namespaceType is set to NONE, and name is set to MyArtifact.zip, the output artifact is stored in the output bucket at MyArtifacts/MyArtifact.zip.

pub fn set_path(self, input: Option<String>) -> Self

Along with namespaceType and name, the pattern that CodeBuild uses to name and store the output artifact:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output names instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, this is the path to the output artifact. If path is not specified, path is not used.

For example, if path is set to MyArtifacts, namespaceType is set to NONE, and name is set to MyArtifact.zip, the output artifact is stored in the output bucket at MyArtifacts/MyArtifact.zip.

pub fn get_path(&self) -> &Option<String>

Along with namespaceType and name, the pattern that CodeBuild uses to name and store the output artifact:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output names instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, this is the path to the output artifact. If path is not specified, path is not used.

For example, if path is set to MyArtifacts, namespaceType is set to NONE, and name is set to MyArtifact.zip, the output artifact is stored in the output bucket at MyArtifacts/MyArtifact.zip.

pub fn namespace_type(self, input: ArtifactNamespace) -> Self

Along with path and name, the pattern that CodeBuild uses to determine the name and location to store the output artifact:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output names instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, valid values include:

  • BUILD_ID: Include the build ID in the location of the build output artifact.

  • NONE: Do not include the build ID. This is the default if namespaceType is not specified.

For example, if path is set to MyArtifacts, namespaceType is set to BUILD_ID, and name is set to MyArtifact.zip, the output artifact is stored in MyArtifacts/ /MyArtifact.zip .

pub fn set_namespace_type(self, input: Option<ArtifactNamespace>) -> Self

Along with path and name, the pattern that CodeBuild uses to determine the name and location to store the output artifact:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output names instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, valid values include:

  • BUILD_ID: Include the build ID in the location of the build output artifact.

  • NONE: Do not include the build ID. This is the default if namespaceType is not specified.

For example, if path is set to MyArtifacts, namespaceType is set to BUILD_ID, and name is set to MyArtifact.zip, the output artifact is stored in MyArtifacts/ /MyArtifact.zip .

pub fn get_namespace_type(&self) -> &Option<ArtifactNamespace>

Along with path and name, the pattern that CodeBuild uses to determine the name and location to store the output artifact:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output names instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, valid values include:

  • BUILD_ID: Include the build ID in the location of the build output artifact.

  • NONE: Do not include the build ID. This is the default if namespaceType is not specified.

For example, if path is set to MyArtifacts, namespaceType is set to BUILD_ID, and name is set to MyArtifact.zip, the output artifact is stored in MyArtifacts/ /MyArtifact.zip .

pub fn name(self, input: impl Into<String>) -> Self

Along with path and namespaceType, the pattern that CodeBuild uses to name and store the output artifact:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output names instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, this is the name of the output artifact object. If you set the name to be a forward slash ("/"), the artifact is stored in the root of the output bucket.

For example:

• If path is set to MyArtifacts, namespaceType is set to BUILD_ID, and name is set to MyArtifact.zip, then the output artifact is stored in MyArtifacts/ /MyArtifact.zip .

• If path is empty, namespaceType is set to NONE, and name is set to "/", the output artifact is stored in the root of the output bucket.

• If path is set to MyArtifacts, namespaceType is set to BUILD_ID, and name is set to "/", the output artifact is stored in MyArtifacts/.

pub fn set_name(self, input: Option<String>) -> Self

Along with path and namespaceType, the pattern that CodeBuild uses to name and store the output artifact:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output names instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, this is the name of the output artifact object. If you set the name to be a forward slash ("/"), the artifact is stored in the root of the output bucket.

For example:

• If path is set to MyArtifacts, namespaceType is set to BUILD_ID, and name is set to MyArtifact.zip, then the output artifact is stored in MyArtifacts/ /MyArtifact.zip .

• If path is empty, namespaceType is set to NONE, and name is set to "/", the output artifact is stored in the root of the output bucket.

• If path is set to MyArtifacts, namespaceType is set to BUILD_ID, and name is set to "/", the output artifact is stored in MyArtifacts/.

pub fn get_name(&self) -> &Option<String>

Along with path and namespaceType, the pattern that CodeBuild uses to name and store the output artifact:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output names instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, this is the name of the output artifact object. If you set the name to be a forward slash ("/"), the artifact is stored in the root of the output bucket.

For example:

• If path is set to MyArtifacts, namespaceType is set to BUILD_ID, and name is set to MyArtifact.zip, then the output artifact is stored in MyArtifacts/ /MyArtifact.zip .

• If path is empty, namespaceType is set to NONE, and name is set to "/", the output artifact is stored in the root of the output bucket.

• If path is set to MyArtifacts, namespaceType is set to BUILD_ID, and name is set to "/", the output artifact is stored in MyArtifacts/.

pub fn packaging(self, input: ArtifactPackaging) -> Self

The type of build output artifact to create:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output artifacts instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, valid values include:

  • NONE: CodeBuild creates in the output bucket a folder that contains the build output. This is the default if packaging is not specified.

  • ZIP: CodeBuild creates in the output bucket a ZIP file that contains the build output.

pub fn set_packaging(self, input: Option<ArtifactPackaging>) -> Self

The type of build output artifact to create:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output artifacts instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, valid values include:

  • NONE: CodeBuild creates in the output bucket a folder that contains the build output. This is the default if packaging is not specified.

  • ZIP: CodeBuild creates in the output bucket a ZIP file that contains the build output.

pub fn get_packaging(&self) -> &Option<ArtifactPackaging>

The type of build output artifact to create:

• If type is set to CODEPIPELINE, CodePipeline ignores this value if specified. This is because CodePipeline manages its build output artifacts instead of CodeBuild.

• If type is set to NO_ARTIFACTS, this value is ignored if specified, because no build output is produced.

• If type is set to S3, valid values include:

  • NONE: CodeBuild creates in the output bucket a folder that contains the build output. This is the default if packaging is not specified.

  • ZIP: CodeBuild creates in the output bucket a ZIP file that contains the build output.

pub fn override_artifact_name(self, input: bool) -> Self

If this flag is set, a name specified in the buildspec file overrides the artifact name. The name specified in a buildspec file is calculated at build time and uses the Shell Command Language. For example, you can append a date and time to your artifact name so that it is always unique.

pub fn set_override_artifact_name(self, input: Option<bool>) -> Self

If this flag is set, a name specified in the buildspec file overrides the artifact name. The name specified in a buildspec file is calculated at build time and uses the Shell Command Language. For example, you can append a date and time to your artifact name so that it is always unique.

pub fn get_override_artifact_name(&self) -> &Option<bool>

If this flag is set, a name specified in the buildspec file overrides the artifact name. The name specified in a buildspec file is calculated at build time and uses the Shell Command Language. For example, you can append a date and time to your artifact name so that it is always unique.

pub fn encryption_disabled(self, input: bool) -> Self

Set to true if you do not want your output artifacts encrypted. This option is valid only if your artifacts type is Amazon S3. If this is set with another artifacts type, an invalidInputException is thrown.

pub fn set_encryption_disabled(self, input: Option<bool>) -> Self

Set to true if you do not want your output artifacts encrypted. This option is valid only if your artifacts type is Amazon S3. If this is set with another artifacts type, an invalidInputException is thrown.

pub fn get_encryption_disabled(&self) -> &Option<bool>

Set to true if you do not want your output artifacts encrypted. This option is valid only if your artifacts type is Amazon S3. If this is set with another artifacts type, an invalidInputException is thrown.

pub fn artifact_identifier(self, input: impl Into<String>) -> Self

An identifier for this artifact definition.

pub fn set_artifact_identifier(self, input: Option<String>) -> Self

An identifier for this artifact definition.

pub fn get_artifact_identifier(&self) -> &Option<String>

An identifier for this artifact definition.

pub fn bucket_owner_access(self, input: BucketOwnerAccess) -> Self

Specifies the bucket owner's access for objects that another account uploads to their Amazon S3 bucket. By default, only the account that uploads the objects to the bucket has access to these objects. This property allows you to give the bucket owner access to these objects.

To use this property, your CodeBuild service role must have the s3:PutBucketAcl permission. This permission allows CodeBuild to modify the access control list for the bucket.

This property can be one of the following values:

NONE

The bucket owner does not have access to the objects. This is the default.

READ_ONLY

The bucket owner has read-only access to the objects. The uploading account retains ownership of the objects.

FULL

The bucket owner has full access to the objects. Object ownership is determined by the following criteria:

• If the bucket is configured with the Bucket owner preferred setting, the bucket owner owns the objects. The uploading account will have object access as specified by the bucket's policy.

• Otherwise, the uploading account retains ownership of the objects.

For more information about Amazon S3 object ownership, see Controlling ownership of uploaded objects using S3 Object Ownership in the Amazon Simple Storage Service User Guide.

pub fn set_bucket_owner_access(self, input: Option<BucketOwnerAccess>) -> Self

Specifies the bucket owner's access for objects that another account uploads to their Amazon S3 bucket. By default, only the account that uploads the objects to the bucket has access to these objects. This property allows you to give the bucket owner access to these objects.

To use this property, your CodeBuild service role must have the s3:PutBucketAcl permission. This permission allows CodeBuild to modify the access control list for the bucket.

This property can be one of the following values:

NONE

The bucket owner does not have access to the objects. This is the default.

READ_ONLY

The bucket owner has read-only access to the objects. The uploading account retains ownership of the objects.

FULL

The bucket owner has full access to the objects. Object ownership is determined by the following criteria:

• If the bucket is configured with the Bucket owner preferred setting, the bucket owner owns the objects. The uploading account will have object access as specified by the bucket's policy.

• Otherwise, the uploading account retains ownership of the objects.

For more information about Amazon S3 object ownership, see Controlling ownership of uploaded objects using S3 Object Ownership in the Amazon Simple Storage Service User Guide.

pub fn get_bucket_owner_access(&self) -> &Option<BucketOwnerAccess>

Specifies the bucket owner's access for objects that another account uploads to their Amazon S3 bucket. By default, only the account that uploads the objects to the bucket has access to these objects. This property allows you to give the bucket owner access to these objects.

To use this property, your CodeBuild service role must have the s3:PutBucketAcl permission. This permission allows CodeBuild to modify the access control list for the bucket.

This property can be one of the following values:

NONE

The bucket owner does not have access to the objects. This is the default.

READ_ONLY

The bucket owner has read-only access to the objects. The uploading account retains ownership of the objects.

FULL

The bucket owner has full access to the objects. Object ownership is determined by the following criteria:

• If the bucket is configured with the Bucket owner preferred setting, the bucket owner owns the objects. The uploading account will have object access as specified by the bucket's policy.

• Otherwise, the uploading account retains ownership of the objects.

For more information about Amazon S3 object ownership, see Controlling ownership of uploaded objects using S3 Object Ownership in the Amazon Simple Storage Service User Guide.

pub fn build(self) -> Result<ProjectArtifacts, BuildError>

Consumes the builder and constructs a ProjectArtifacts. This method will fail if any of the following fields are not set:

• r#type

Trait Implementations

impl Clone for ProjectArtifactsBuilder

fn clone(&self) -> ProjectArtifactsBuilder

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ProjectArtifactsBuilder

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ProjectArtifactsBuilder

fn default() -> ProjectArtifactsBuilder

Returns the “default value” for a type.

impl PartialEq for ProjectArtifactsBuilder

fn eq(&self, other: &ProjectArtifactsBuilder) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ProjectArtifactsBuilder