Package software.amazon.awssdk.services.codecommit

Interface CodeCommitAsyncClient

All Superinterfaces:

AutoCloseable

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

Service client for accessing CodeCommit asynchronously. 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.

Method Summary

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

Methods inherited from interface java.lang.AutoCloseable

close

Method Detail

create

static CodeCommitAsyncClient create()

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

builder

static CodeCommitAsyncClientBuilder builder()

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

batchGetRepositories

default CompletableFuture<BatchGetRepositoriesResponse> batchGetRepositories(BatchGetRepositoriesRequest batchGetRepositoriesRequest)

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:

A Java Future containing the result of the BatchGetRepositories operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

createBranch

default CompletableFuture<CreateBranchResponse> createBranch(CreateBranchRequest createBranchRequest)

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:

A Java Future containing the result of the CreateBranch operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

createRepository

default CompletableFuture<CreateRepositoryResponse> createRepository(CreateRepositoryRequest createRepositoryRequest)

Creates a new, empty repository.

Parameters:

createRepositoryRequest - Represents the input of a create repository operation.

Returns:

A Java Future containing the result of the CreateRepository operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

deleteRepository

default CompletableFuture<DeleteRepositoryResponse> deleteRepository(DeleteRepositoryRequest deleteRepositoryRequest)

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:

A Java Future containing the result of the DeleteRepository operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

getBlob

default CompletableFuture<GetBlobResponse> getBlob(GetBlobRequest getBlobRequest)

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

Parameters:

getBlobRequest - Represents the input of a get blob operation.

Returns:

A Java Future containing the result of the GetBlob operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

getBranch

default CompletableFuture<GetBranchResponse> getBranch(GetBranchRequest getBranchRequest)

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:

A Java Future containing the result of the GetBranch operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

getCommit

default CompletableFuture<GetCommitResponse> getCommit(GetCommitRequest getCommitRequest)

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

Parameters:

getCommitRequest - Represents the input of a get commit operation.

Returns:

A Java Future containing the result of the GetCommit operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

getDifferences

default CompletableFuture<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). Results can be limited to a specified path.

Parameters:

getDifferencesRequest -

Returns:

A Java Future containing the result of the GetDifferences operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

getRepository

default CompletableFuture<GetRepositoryResponse> getRepository(GetRepositoryRequest getRepositoryRequest)

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:

A Java Future containing the result of the GetRepository operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

getRepositoryTriggers

default CompletableFuture<GetRepositoryTriggersResponse> getRepositoryTriggers(GetRepositoryTriggersRequest getRepositoryTriggersRequest)

Gets information about triggers configured for a repository.

Parameters:

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

Returns:

A Java Future containing the result of the GetRepositoryTriggers operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

listBranches

default CompletableFuture<ListBranchesResponse> listBranches(ListBranchesRequest listBranchesRequest)

Gets information about one or more branches in a repository.

Parameters:

listBranchesRequest - Represents the input of a list branches operation.

Returns:

A Java Future containing the result of the ListBranches operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

listRepositories

default CompletableFuture<ListRepositoriesResponse> listRepositories(ListRepositoriesRequest listRepositoriesRequest)

Gets information about one or more repositories.

Parameters:

listRepositoriesRequest - Represents the input of a list repositories operation.

Returns:

A Java Future containing the result of the ListRepositories operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

putRepositoryTriggers

default CompletableFuture<PutRepositoryTriggersResponse> putRepositoryTriggers(PutRepositoryTriggersRequest putRepositoryTriggersRequest)

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:

A Java Future containing the result of the PutRepositoryTriggers operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

testRepositoryTriggers

default CompletableFuture<TestRepositoryTriggersResponse> testRepositoryTriggers(TestRepositoryTriggersRequest testRepositoryTriggersRequest)

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:

A Java Future containing the result of the TestRepositoryTriggers operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

updateDefaultBranch

default CompletableFuture<UpdateDefaultBranchResponse> updateDefaultBranch(UpdateDefaultBranchRequest updateDefaultBranchRequest)

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:

A Java Future containing the result of the UpdateDefaultBranch operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

updateRepositoryDescription

default CompletableFuture<UpdateRepositoryDescriptionResponse> updateRepositoryDescription(UpdateRepositoryDescriptionRequest updateRepositoryDescriptionRequest)

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:

A Java Future containing the result of the UpdateRepositoryDescription operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation

updateRepositoryName

default CompletableFuture<UpdateRepositoryNameResponse> updateRepositoryName(UpdateRepositoryNameRequest updateRepositoryNameRequest)

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:

A Java Future containing the result of the UpdateRepositoryName operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions.

• 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 class for all service exceptions. Unknown exceptions will be thrown as an instance of this

See Also:

AWS API Documentation