Package software.amazon.awssdk.services.codecommit

Interface CodeCommitClient

All Superinterfaces:

AutoCloseable

@Generated("software.amazon.awssdk:codegen")
public interface CodeCommitClient
extends AutoCloseable

Service client for accessing CodeCommit. This can be created using the static builder() method. AWS CodeCommit

This is the AWS CodeCommit API Reference. This reference provides descriptions of the operations and data types for AWS CodeCommit API along with usage examples.

You can use the AWS CodeCommit API to work with the following objects:

Repositories, by calling the following:

• BatchGetRepositories, which returns information about one or more repositories associated with your AWS account

• CreateRepository, which creates an AWS CodeCommit repository

• DeleteRepository, which deletes an AWS CodeCommit repository

• GetRepository, which returns information about a specified repository

• ListRepositories, which lists all AWS CodeCommit repositories associated with your AWS account

• UpdateRepositoryDescription, which sets or updates the description of the repository

• UpdateRepositoryName, which changes the name of the repository. If you change the name of a repository, no other users of that repository will be able to access it until you send them the new HTTPS or SSH URL to use.

Branches, by calling the following:

• CreateBranch, which creates a new branch in a specified repository

• GetBranch, which returns information about a specified branch

• ListBranches, which lists all branches for a specified repository

• UpdateDefaultBranch, which changes the default branch for a repository

Information about committed code in a repository, by calling the following:

• GetBlob, which returns the base-64 encoded content of an individual Git blob object within a repository

• GetCommit, which returns information about a commit, including commit messages and author and committer information

• GetDifferences, which returns information about the differences in a valid commit specifier (such as a branch, tag, HEAD, commit ID or other fully qualified reference)

Triggers, by calling the following:

• GetRepositoryTriggers, which returns information about triggers configured for a repository

• PutRepositoryTriggers, which replaces all triggers for a repository and can be used to create or delete triggers

• TestRepositoryTriggers, which tests the functionality of a repository trigger by sending data to the trigger target

For information about how to use AWS CodeCommit, see the AWS CodeCommit User Guide.

Field Summary

Fields

Modifier and Type	Field	Description
static String	SERVICE_NAME

Method Summary

Modifier and Type	Method	Description
default BatchGetRepositoriesResponse	batchGetRepositories(BatchGetRepositoriesRequest batchGetRepositoriesRequest)	Returns information about one or more repositories.
static CodeCommitClientBuilder	builder()	Create a builder that can be used to configure and create a CodeCommitClient.
static CodeCommitClient	create()	Create a CodeCommitClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.
default CreateBranchResponse	createBranch(CreateBranchRequest createBranchRequest)	Creates a new branch in a repository and points the branch to a commit.
default CreateRepositoryResponse	createRepository(CreateRepositoryRequest createRepositoryRequest)	Creates a new, empty repository.
default DeleteRepositoryResponse	deleteRepository(DeleteRepositoryRequest deleteRepositoryRequest)	Deletes a repository.
default GetBlobResponse	getBlob(GetBlobRequest getBlobRequest)	Returns the base-64 encoded content of an individual blob within a repository.
default GetBranchResponse	getBranch(GetBranchRequest getBranchRequest)	Returns information about a repository branch, including its name and the last commit ID.
default GetCommitResponse	getCommit(GetCommitRequest getCommitRequest)	Returns information about a commit, including commit message and committer information.
default GetDifferencesResponse	getDifferences(GetDifferencesRequest getDifferencesRequest)	Returns information about the differences in a valid commit specifier (such as a branch, tag, HEAD, commit ID or other fully qualified reference).
default GetRepositoryResponse	getRepository(GetRepositoryRequest getRepositoryRequest)	Returns information about a repository.
default GetRepositoryTriggersResponse	getRepositoryTriggers(GetRepositoryTriggersRequest getRepositoryTriggersRequest)	Gets information about triggers configured for a repository.
default ListBranchesResponse	listBranches(ListBranchesRequest listBranchesRequest)	Gets information about one or more branches in a repository.
default ListRepositoriesResponse	listRepositories(ListRepositoriesRequest listRepositoriesRequest)	Gets information about one or more repositories.
default PutRepositoryTriggersResponse	putRepositoryTriggers(PutRepositoryTriggersRequest putRepositoryTriggersRequest)	Replaces all triggers for a repository.
static ServiceMetadata	serviceMetadata()
default TestRepositoryTriggersResponse	testRepositoryTriggers(TestRepositoryTriggersRequest testRepositoryTriggersRequest)	Tests the functionality of repository triggers by sending information to the trigger target.
default UpdateDefaultBranchResponse	updateDefaultBranch(UpdateDefaultBranchRequest updateDefaultBranchRequest)	Sets or changes the default branch name for the specified repository.
default UpdateRepositoryDescriptionResponse	updateRepositoryDescription(UpdateRepositoryDescriptionRequest updateRepositoryDescriptionRequest)	Sets or changes the comment or description for a repository.
default UpdateRepositoryNameResponse	updateRepositoryName(UpdateRepositoryNameRequest updateRepositoryNameRequest)	Renames a repository.

Methods inherited from interface java.lang.AutoCloseable

close

Field Detail

SERVICE_NAME

static final String SERVICE_NAME

See Also:

Constant Field Values

Method Detail

create

static CodeCommitClient create()

Create a CodeCommitClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.

builder

static CodeCommitClientBuilder builder()

Create a builder that can be used to configure and create a CodeCommitClient.

batchGetRepositories

default BatchGetRepositoriesResponse batchGetRepositories(BatchGetRepositoriesRequest batchGetRepositoriesRequest)
                                                   throws RepositoryNamesRequiredException,
                                                          MaximumRepositoryNamesExceededException,
                                                          InvalidRepositoryNameException,
                                                          EncryptionIntegrityChecksFailedException,
                                                          EncryptionKeyAccessDeniedException,
                                                          EncryptionKeyDisabledException,
                                                          EncryptionKeyNotFoundException,
                                                          EncryptionKeyUnavailableException,
                                                          SdkBaseException,
                                                          SdkClientException,
                                                          CodeCommitException

Returns information about one or more repositories.

The description field for a repository accepts all HTML characters and all valid Unicode characters. Applications that do not HTML-encode the description and display it in a web page could expose users to potentially malicious code. Make sure that you HTML-encode the description field in any application that uses this API to display the repository description on a web page.

Parameters:

batchGetRepositoriesRequest - Represents the input of a batch get repositories operation.

Returns:

Result of the BatchGetRepositories operation returned by the service.

Throws:

RepositoryNamesRequiredException - A repository names object is required but was not specified.

MaximumRepositoryNamesExceededException - The maximum number of allowed repository names was exceeded. Currently, this number is 25.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

createBranch

default CreateBranchResponse createBranch(CreateBranchRequest createBranchRequest)
                                   throws RepositoryNameRequiredException,
                                          InvalidRepositoryNameException,
                                          RepositoryDoesNotExistException,
                                          BranchNameRequiredException,
                                          BranchNameExistsException,
                                          InvalidBranchNameException,
                                          CommitIdRequiredException,
                                          CommitDoesNotExistException,
                                          InvalidCommitIdException,
                                          EncryptionIntegrityChecksFailedException,
                                          EncryptionKeyAccessDeniedException,
                                          EncryptionKeyDisabledException,
                                          EncryptionKeyNotFoundException,
                                          EncryptionKeyUnavailableException,
                                          SdkBaseException,
                                          SdkClientException,
                                          CodeCommitException

Creates a new branch in a repository and points the branch to a commit.

Calling the create branch operation does not set a repository's default branch. To do this, call the update default branch operation.

Parameters:

createBranchRequest - Represents the input of a create branch operation.

Returns:

Result of the CreateBranch operation returned by the service.

Throws:

RepositoryNameRequiredException - A repository name is required but was not specified.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

RepositoryDoesNotExistException - The specified repository does not exist.

BranchNameRequiredException - A branch name is required but was not specified.

BranchNameExistsException - The specified branch name already exists.

InvalidBranchNameException - The specified branch name is not valid.

CommitIdRequiredException - A commit ID was not specified.

CommitDoesNotExistException - The specified commit does not exist or no commit was specified, and the specified repository has no default branch.

InvalidCommitIdException - The specified commit ID is not valid.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

createRepository

default CreateRepositoryResponse createRepository(CreateRepositoryRequest createRepositoryRequest)
                                           throws RepositoryNameExistsException,
                                                  RepositoryNameRequiredException,
                                                  InvalidRepositoryNameException,
                                                  InvalidRepositoryDescriptionException,
                                                  RepositoryLimitExceededException,
                                                  EncryptionIntegrityChecksFailedException,
                                                  EncryptionKeyAccessDeniedException,
                                                  EncryptionKeyDisabledException,
                                                  EncryptionKeyNotFoundException,
                                                  EncryptionKeyUnavailableException,
                                                  SdkBaseException,
                                                  SdkClientException,
                                                  CodeCommitException

Creates a new, empty repository.

Parameters:

createRepositoryRequest - Represents the input of a create repository operation.

Returns:

Result of the CreateRepository operation returned by the service.

Throws:

RepositoryNameExistsException - The specified repository name already exists.

RepositoryNameRequiredException - A repository name is required but was not specified.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

InvalidRepositoryDescriptionException - The specified repository description is not valid.

RepositoryLimitExceededException - A repository resource limit was exceeded.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

deleteRepository

default DeleteRepositoryResponse deleteRepository(DeleteRepositoryRequest deleteRepositoryRequest)
                                           throws RepositoryNameRequiredException,
                                                  InvalidRepositoryNameException,
                                                  EncryptionIntegrityChecksFailedException,
                                                  EncryptionKeyAccessDeniedException,
                                                  EncryptionKeyDisabledException,
                                                  EncryptionKeyNotFoundException,
                                                  EncryptionKeyUnavailableException,
                                                  SdkBaseException,
                                                  SdkClientException,
                                                  CodeCommitException

Deletes a repository. If a specified repository was already deleted, a null repository ID will be returned.

Deleting a repository also deletes all associated objects and metadata. After a repository is deleted, all future push calls to the deleted repository will fail.

Parameters:

deleteRepositoryRequest - Represents the input of a delete repository operation.

Returns:

Result of the DeleteRepository operation returned by the service.

Throws:

RepositoryNameRequiredException - A repository name is required but was not specified.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

getBlob

default GetBlobResponse getBlob(GetBlobRequest getBlobRequest)
                         throws RepositoryNameRequiredException,
                                InvalidRepositoryNameException,
                                RepositoryDoesNotExistException,
                                BlobIdRequiredException,
                                InvalidBlobIdException,
                                BlobIdDoesNotExistException,
                                EncryptionIntegrityChecksFailedException,
                                EncryptionKeyAccessDeniedException,
                                EncryptionKeyDisabledException,
                                EncryptionKeyNotFoundException,
                                EncryptionKeyUnavailableException,
                                FileTooLargeException,
                                SdkBaseException,
                                SdkClientException,
                                CodeCommitException

Returns the base-64 encoded content of an individual blob within a repository.

Parameters:

getBlobRequest - Represents the input of a get blob operation.

Returns:

Result of the GetBlob operation returned by the service.

Throws:

RepositoryNameRequiredException - A repository name is required but was not specified.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

RepositoryDoesNotExistException - The specified repository does not exist.

BlobIdRequiredException - A blob ID is required but was not specified.

InvalidBlobIdException - The specified blob is not valid.

BlobIdDoesNotExistException - The specified blob does not exist.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

FileTooLargeException - The specified file exceeds the file size limit for AWS CodeCommit. For more information about limits in AWS CodeCommit, see AWS CodeCommit User Guide.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

getBranch

default GetBranchResponse getBranch(GetBranchRequest getBranchRequest)
                             throws RepositoryNameRequiredException,
                                    RepositoryDoesNotExistException,
                                    InvalidRepositoryNameException,
                                    BranchNameRequiredException,
                                    InvalidBranchNameException,
                                    BranchDoesNotExistException,
                                    EncryptionIntegrityChecksFailedException,
                                    EncryptionKeyAccessDeniedException,
                                    EncryptionKeyDisabledException,
                                    EncryptionKeyNotFoundException,
                                    EncryptionKeyUnavailableException,
                                    SdkBaseException,
                                    SdkClientException,
                                    CodeCommitException

Returns information about a repository branch, including its name and the last commit ID.

Parameters:

getBranchRequest - Represents the input of a get branch operation.

Returns:

Result of the GetBranch operation returned by the service.

Throws:

RepositoryNameRequiredException - A repository name is required but was not specified.

RepositoryDoesNotExistException - The specified repository does not exist.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

BranchNameRequiredException - A branch name is required but was not specified.

InvalidBranchNameException - The specified branch name is not valid.

BranchDoesNotExistException - The specified branch does not exist.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

getCommit

default GetCommitResponse getCommit(GetCommitRequest getCommitRequest)
                             throws RepositoryNameRequiredException,
                                    InvalidRepositoryNameException,
                                    RepositoryDoesNotExistException,
                                    CommitIdRequiredException,
                                    InvalidCommitIdException,
                                    CommitIdDoesNotExistException,
                                    EncryptionIntegrityChecksFailedException,
                                    EncryptionKeyAccessDeniedException,
                                    EncryptionKeyDisabledException,
                                    EncryptionKeyNotFoundException,
                                    EncryptionKeyUnavailableException,
                                    SdkBaseException,
                                    SdkClientException,
                                    CodeCommitException

Returns information about a commit, including commit message and committer information.

Parameters:

getCommitRequest - Represents the input of a get commit operation.

Returns:

Result of the GetCommit operation returned by the service.

Throws:

RepositoryNameRequiredException - A repository name is required but was not specified.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

RepositoryDoesNotExistException - The specified repository does not exist.

CommitIdRequiredException - A commit ID was not specified.

InvalidCommitIdException - The specified commit ID is not valid.

CommitIdDoesNotExistException - The specified commit ID does not exist.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

getDifferences

default GetDifferencesResponse getDifferences(GetDifferencesRequest getDifferencesRequest)
                                       throws RepositoryNameRequiredException,
                                              RepositoryDoesNotExistException,
                                              InvalidRepositoryNameException,
                                              InvalidContinuationTokenException,
                                              InvalidMaxResultsException,
                                              InvalidCommitIdException,
                                              CommitRequiredException,
                                              InvalidCommitException,
                                              CommitDoesNotExistException,
                                              InvalidPathException,
                                              PathDoesNotExistException,
                                              EncryptionIntegrityChecksFailedException,
                                              EncryptionKeyAccessDeniedException,
                                              EncryptionKeyDisabledException,
                                              EncryptionKeyNotFoundException,
                                              EncryptionKeyUnavailableException,
                                              SdkBaseException,
                                              SdkClientException,
                                              CodeCommitException

Returns information about the differences in a valid commit specifier (such as a branch, tag, HEAD, commit ID or other fully qualified reference). Results can be limited to a specified path.

Parameters:

getDifferencesRequest -

Returns:

Result of the GetDifferences operation returned by the service.

Throws:

RepositoryNameRequiredException - A repository name is required but was not specified.

RepositoryDoesNotExistException - The specified repository does not exist.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

InvalidContinuationTokenException - The specified continuation token is not valid.

InvalidMaxResultsException - The specified number of maximum results is not valid.

InvalidCommitIdException - The specified commit ID is not valid.

CommitRequiredException - A commit was not specified.

InvalidCommitException - The specified commit is not valid.

CommitDoesNotExistException - The specified commit does not exist or no commit was specified, and the specified repository has no default branch.

InvalidPathException - The specified path is not valid.

PathDoesNotExistException - The specified path does not exist.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

getRepository

default GetRepositoryResponse getRepository(GetRepositoryRequest getRepositoryRequest)
                                     throws RepositoryNameRequiredException,
                                            RepositoryDoesNotExistException,
                                            InvalidRepositoryNameException,
                                            EncryptionIntegrityChecksFailedException,
                                            EncryptionKeyAccessDeniedException,
                                            EncryptionKeyDisabledException,
                                            EncryptionKeyNotFoundException,
                                            EncryptionKeyUnavailableException,
                                            SdkBaseException,
                                            SdkClientException,
                                            CodeCommitException

Returns information about a repository.

The description field for a repository accepts all HTML characters and all valid Unicode characters. Applications that do not HTML-encode the description and display it in a web page could expose users to potentially malicious code. Make sure that you HTML-encode the description field in any application that uses this API to display the repository description on a web page.

Parameters:

getRepositoryRequest - Represents the input of a get repository operation.

Returns:

Result of the GetRepository operation returned by the service.

Throws:

RepositoryNameRequiredException - A repository name is required but was not specified.

RepositoryDoesNotExistException - The specified repository does not exist.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

getRepositoryTriggers

default GetRepositoryTriggersResponse getRepositoryTriggers(GetRepositoryTriggersRequest getRepositoryTriggersRequest)
                                                     throws RepositoryNameRequiredException,
                                                            InvalidRepositoryNameException,
                                                            RepositoryDoesNotExistException,
                                                            EncryptionIntegrityChecksFailedException,
                                                            EncryptionKeyAccessDeniedException,
                                                            EncryptionKeyDisabledException,
                                                            EncryptionKeyNotFoundException,
                                                            EncryptionKeyUnavailableException,
                                                            SdkBaseException,
                                                            SdkClientException,
                                                            CodeCommitException

Gets information about triggers configured for a repository.

Parameters:

getRepositoryTriggersRequest - Represents the input of a get repository triggers operation.

Returns:

Result of the GetRepositoryTriggers operation returned by the service.

Throws:

RepositoryNameRequiredException - A repository name is required but was not specified.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

RepositoryDoesNotExistException - The specified repository does not exist.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

listBranches

default ListBranchesResponse listBranches(ListBranchesRequest listBranchesRequest)
                                   throws RepositoryNameRequiredException,
                                          RepositoryDoesNotExistException,
                                          InvalidRepositoryNameException,
                                          EncryptionIntegrityChecksFailedException,
                                          EncryptionKeyAccessDeniedException,
                                          EncryptionKeyDisabledException,
                                          EncryptionKeyNotFoundException,
                                          EncryptionKeyUnavailableException,
                                          InvalidContinuationTokenException,
                                          SdkBaseException,
                                          SdkClientException,
                                          CodeCommitException

Gets information about one or more branches in a repository.

Parameters:

listBranchesRequest - Represents the input of a list branches operation.

Returns:

Result of the ListBranches operation returned by the service.

Throws:

RepositoryNameRequiredException - A repository name is required but was not specified.

RepositoryDoesNotExistException - The specified repository does not exist.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

InvalidContinuationTokenException - The specified continuation token is not valid.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

listRepositories

default ListRepositoriesResponse listRepositories(ListRepositoriesRequest listRepositoriesRequest)
                                           throws InvalidSortByException,
                                                  InvalidOrderException,
                                                  InvalidContinuationTokenException,
                                                  SdkBaseException,
                                                  SdkClientException,
                                                  CodeCommitException

Gets information about one or more repositories.

Parameters:

listRepositoriesRequest - Represents the input of a list repositories operation.

Returns:

Result of the ListRepositories operation returned by the service.

Throws:

InvalidSortByException - The specified sort by value is not valid.

InvalidOrderException - The specified sort order is not valid.

InvalidContinuationTokenException - The specified continuation token is not valid.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

putRepositoryTriggers

default PutRepositoryTriggersResponse putRepositoryTriggers(PutRepositoryTriggersRequest putRepositoryTriggersRequest)
                                                     throws RepositoryDoesNotExistException,
                                                            RepositoryNameRequiredException,
                                                            InvalidRepositoryNameException,
                                                            RepositoryTriggersListRequiredException,
                                                            MaximumRepositoryTriggersExceededException,
                                                            InvalidRepositoryTriggerNameException,
                                                            InvalidRepositoryTriggerDestinationArnException,
                                                            InvalidRepositoryTriggerRegionException,
                                                            InvalidRepositoryTriggerCustomDataException,
                                                            MaximumBranchesExceededException,
                                                            InvalidRepositoryTriggerBranchNameException,
                                                            InvalidRepositoryTriggerEventsException,
                                                            RepositoryTriggerNameRequiredException,
                                                            RepositoryTriggerDestinationArnRequiredException,
                                                            RepositoryTriggerBranchNameListRequiredException,
                                                            RepositoryTriggerEventsListRequiredException,
                                                            EncryptionIntegrityChecksFailedException,
                                                            EncryptionKeyAccessDeniedException,
                                                            EncryptionKeyDisabledException,
                                                            EncryptionKeyNotFoundException,
                                                            EncryptionKeyUnavailableException,
                                                            SdkBaseException,
                                                            SdkClientException,
                                                            CodeCommitException

Replaces all triggers for a repository. This can be used to create or delete triggers.

Parameters:

putRepositoryTriggersRequest - Represents the input ofa put repository triggers operation.

Returns:

Result of the PutRepositoryTriggers operation returned by the service.

Throws:

RepositoryDoesNotExistException - The specified repository does not exist.

RepositoryNameRequiredException - A repository name is required but was not specified.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

RepositoryTriggersListRequiredException - The list of triggers for the repository is required but was not specified.

MaximumRepositoryTriggersExceededException - The number of triggers allowed for the repository was exceeded.

InvalidRepositoryTriggerNameException - The name of the trigger is not valid.

InvalidRepositoryTriggerDestinationArnException - The Amazon Resource Name (ARN) for the trigger is not valid for the specified destination. The most common reason for this error is that the ARN does not meet the requirements for the service type.

InvalidRepositoryTriggerRegionException - The region for the trigger target does not match the region for the repository. Triggers must be created in the same region as the target for the trigger.

InvalidRepositoryTriggerCustomDataException - The custom data provided for the trigger is not valid.

MaximumBranchesExceededException - The number of branches for the trigger was exceeded.

InvalidRepositoryTriggerBranchNameException - One or more branch names specified for the trigger is not valid.

InvalidRepositoryTriggerEventsException - One or more events specified for the trigger is not valid. Check to make sure that all events specified match the requirements for allowed events.

RepositoryTriggerNameRequiredException - A name for the trigger is required but was not specified.

RepositoryTriggerDestinationArnRequiredException - A destination ARN for the target service for the trigger is required but was not specified.

RepositoryTriggerBranchNameListRequiredException - At least one branch name is required but was not specified in the trigger configuration.

RepositoryTriggerEventsListRequiredException - At least one event for the trigger is required but was not specified.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

testRepositoryTriggers

default TestRepositoryTriggersResponse testRepositoryTriggers(TestRepositoryTriggersRequest testRepositoryTriggersRequest)
                                                       throws RepositoryDoesNotExistException,
                                                              RepositoryNameRequiredException,
                                                              InvalidRepositoryNameException,
                                                              RepositoryTriggersListRequiredException,
                                                              MaximumRepositoryTriggersExceededException,
                                                              InvalidRepositoryTriggerNameException,
                                                              InvalidRepositoryTriggerDestinationArnException,
                                                              InvalidRepositoryTriggerRegionException,
                                                              InvalidRepositoryTriggerCustomDataException,
                                                              MaximumBranchesExceededException,
                                                              InvalidRepositoryTriggerBranchNameException,
                                                              InvalidRepositoryTriggerEventsException,
                                                              RepositoryTriggerNameRequiredException,
                                                              RepositoryTriggerDestinationArnRequiredException,
                                                              RepositoryTriggerBranchNameListRequiredException,
                                                              RepositoryTriggerEventsListRequiredException,
                                                              EncryptionIntegrityChecksFailedException,
                                                              EncryptionKeyAccessDeniedException,
                                                              EncryptionKeyDisabledException,
                                                              EncryptionKeyNotFoundException,
                                                              EncryptionKeyUnavailableException,
                                                              SdkBaseException,
                                                              SdkClientException,
                                                              CodeCommitException

Tests the functionality of repository triggers by sending information to the trigger target. If real data is available in the repository, the test will send data from the last commit. If no data is available, sample data will be generated.

Parameters:

testRepositoryTriggersRequest - Represents the input of a test repository triggers operation.

Returns:

Result of the TestRepositoryTriggers operation returned by the service.

Throws:

RepositoryDoesNotExistException - The specified repository does not exist.

RepositoryNameRequiredException - A repository name is required but was not specified.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

RepositoryTriggersListRequiredException - The list of triggers for the repository is required but was not specified.

MaximumRepositoryTriggersExceededException - The number of triggers allowed for the repository was exceeded.

InvalidRepositoryTriggerNameException - The name of the trigger is not valid.

InvalidRepositoryTriggerDestinationArnException - The Amazon Resource Name (ARN) for the trigger is not valid for the specified destination. The most common reason for this error is that the ARN does not meet the requirements for the service type.

InvalidRepositoryTriggerRegionException - The region for the trigger target does not match the region for the repository. Triggers must be created in the same region as the target for the trigger.

InvalidRepositoryTriggerCustomDataException - The custom data provided for the trigger is not valid.

MaximumBranchesExceededException - The number of branches for the trigger was exceeded.

InvalidRepositoryTriggerBranchNameException - One or more branch names specified for the trigger is not valid.

InvalidRepositoryTriggerEventsException - One or more events specified for the trigger is not valid. Check to make sure that all events specified match the requirements for allowed events.

RepositoryTriggerNameRequiredException - A name for the trigger is required but was not specified.

RepositoryTriggerDestinationArnRequiredException - A destination ARN for the target service for the trigger is required but was not specified.

RepositoryTriggerBranchNameListRequiredException - At least one branch name is required but was not specified in the trigger configuration.

RepositoryTriggerEventsListRequiredException - At least one event for the trigger is required but was not specified.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

updateDefaultBranch

default UpdateDefaultBranchResponse updateDefaultBranch(UpdateDefaultBranchRequest updateDefaultBranchRequest)
                                                 throws RepositoryNameRequiredException,
                                                        RepositoryDoesNotExistException,
                                                        InvalidRepositoryNameException,
                                                        BranchNameRequiredException,
                                                        InvalidBranchNameException,
                                                        BranchDoesNotExistException,
                                                        EncryptionIntegrityChecksFailedException,
                                                        EncryptionKeyAccessDeniedException,
                                                        EncryptionKeyDisabledException,
                                                        EncryptionKeyNotFoundException,
                                                        EncryptionKeyUnavailableException,
                                                        SdkBaseException,
                                                        SdkClientException,
                                                        CodeCommitException

Sets or changes the default branch name for the specified repository.

If you use this operation to change the default branch name to the current default branch name, a success message is returned even though the default branch did not change.

Parameters:

updateDefaultBranchRequest - Represents the input of an update default branch operation.

Returns:

Result of the UpdateDefaultBranch operation returned by the service.

Throws:

RepositoryNameRequiredException - A repository name is required but was not specified.

RepositoryDoesNotExistException - The specified repository does not exist.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

BranchNameRequiredException - A branch name is required but was not specified.

InvalidBranchNameException - The specified branch name is not valid.

BranchDoesNotExistException - The specified branch does not exist.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

updateRepositoryDescription

default UpdateRepositoryDescriptionResponse updateRepositoryDescription(UpdateRepositoryDescriptionRequest updateRepositoryDescriptionRequest)
                                                                 throws RepositoryNameRequiredException,
                                                                        RepositoryDoesNotExistException,
                                                                        InvalidRepositoryNameException,
                                                                        InvalidRepositoryDescriptionException,
                                                                        EncryptionIntegrityChecksFailedException,
                                                                        EncryptionKeyAccessDeniedException,
                                                                        EncryptionKeyDisabledException,
                                                                        EncryptionKeyNotFoundException,
                                                                        EncryptionKeyUnavailableException,
                                                                        SdkBaseException,
                                                                        SdkClientException,
                                                                        CodeCommitException

Sets or changes the comment or description for a repository.

The description field for a repository accepts all HTML characters and all valid Unicode characters. Applications that do not HTML-encode the description and display it in a web page could expose users to potentially malicious code. Make sure that you HTML-encode the description field in any application that uses this API to display the repository description on a web page.

Parameters:

updateRepositoryDescriptionRequest - Represents the input of an update repository description operation.

Returns:

Result of the UpdateRepositoryDescription operation returned by the service.

Throws:

RepositoryNameRequiredException - A repository name is required but was not specified.

RepositoryDoesNotExistException - The specified repository does not exist.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

InvalidRepositoryDescriptionException - The specified repository description is not valid.

EncryptionIntegrityChecksFailedException - An encryption integrity check failed.

EncryptionKeyAccessDeniedException - An encryption key could not be accessed.

EncryptionKeyDisabledException - The encryption key is disabled.

EncryptionKeyNotFoundException - No encryption key was found.

EncryptionKeyUnavailableException - The encryption key is not available.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

updateRepositoryName

default UpdateRepositoryNameResponse updateRepositoryName(UpdateRepositoryNameRequest updateRepositoryNameRequest)
                                                   throws RepositoryDoesNotExistException,
                                                          RepositoryNameExistsException,
                                                          RepositoryNameRequiredException,
                                                          InvalidRepositoryNameException,
                                                          SdkBaseException,
                                                          SdkClientException,
                                                          CodeCommitException

Renames a repository. The repository name must be unique across the calling AWS account. In addition, repository names are limited to 100 alphanumeric, dash, and underscore characters, and cannot include certain characters. The suffix ".git" is prohibited. For a full description of the limits on repository names, see Limits in the AWS CodeCommit User Guide.

Parameters:

updateRepositoryNameRequest - Represents the input of an update repository description operation.

Returns:

Result of the UpdateRepositoryName operation returned by the service.

Throws:

RepositoryDoesNotExistException - The specified repository does not exist.

RepositoryNameExistsException - The specified repository name already exists.

RepositoryNameRequiredException - A repository name is required but was not specified.

InvalidRepositoryNameException - At least one specified repository name is not valid.

This exception only occurs when a specified repository name is not valid. Other exceptions occur when a required repository parameter is missing, or when a specified repository does not exist.

SdkBaseException - Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.

SdkClientException - If any client side error occurs such as an IO related failure, failure to get credentials, etc)

CodeCommitException - Base exception for all service exceptions. Unknown exceptions will be thrown as an instance of this type

See Also:

AWS API Documentation

serviceMetadata

static ServiceMetadata serviceMetadata()