Class: AWS.CodeCatalyst
- Inherits:
-
AWS.Service
- Object
- AWS.Service
- AWS.CodeCatalyst
- Identifier:
- codecatalyst
- API Version:
- 2022-09-28
- Defined in:
- (unknown)
Overview
Constructs a service interface object. Each API operation is exposed as a function on service.
Service Description
Welcome to the Amazon CodeCatalyst API reference. This reference provides descriptions of operations and data types for Amazon CodeCatalyst. You can use the Amazon CodeCatalyst API to work with the following objects.
Dev Environments and the Amazon Web Services Toolkits, by calling the following:
-
CreateAccessToken, which creates a personal access token (PAT) for the current user.
-
CreateDevEnvironment, which creates a Dev Environment, where you can quickly work on the code stored in the source repositories of your project.
-
CreateProject which creates a project in a specified space.
-
CreateSourceRepositoryBranch, which creates a branch in a specified repository where you can work on code.
-
DeleteDevEnvironment, which deletes a Dev Environment.
-
GetDevEnvironment, which returns information about a Dev Environment.
-
GetProject, which returns information about a project.
-
GetSourceRepositoryCloneUrls, which returns information about the URLs that can be used with a Git client to clone a source repository.
-
GetSpace, which returns information about a space.
-
GetSubscription, which returns information about the Amazon Web Services account used for billing purposes and the billing plan for the space.
-
GetUserDetails, which returns information about a user in Amazon CodeCatalyst.
-
ListDevEnvironments, which retrieves a list of Dev Environments in a project.
-
ListDevEnvironmentSessions, which retrieves a list of active Dev Environment sessions in a project.
-
ListProjects, which retrieves a list of projects in a space.
-
ListSourceRepositories, which retrieves a list of source repositories in a project.
-
ListSourceRepositoryBranches, which retrieves a list of branches in a source repository.
-
ListSpaces, which retrieves a list of spaces.
-
StartDevEnvironment, which starts a specified Dev Environment and puts it into an active state.
-
StartDevEnvironmentSession, which starts a session to a specified Dev Environment.
-
StopDevEnvironment, which stops a specified Dev Environment and puts it into an stopped state.
-
StopDevEnvironmentSession, which stops a session for a specified Dev Environment.
-
UpdateDevEnvironment, which changes one or more values for a Dev Environment.
-
VerifySession, which verifies whether the calling user has a valid Amazon CodeCatalyst login and session.
Security, activity, and resource management in Amazon CodeCatalyst, by calling the following:
-
DeleteAccessToken, which deletes a specified personal access token (PAT).
-
ListAccessTokens, which lists all personal access tokens (PATs) associated with a user.
-
ListEventLogs, which retrieves a list of events that occurred during a specified time period in a space.
Sending a Request Using CodeCatalyst
var codecatalyst = new AWS.CodeCatalyst();
codecatalyst.createAccessToken(params, function (err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Locking the API Version
In order to ensure that the CodeCatalyst object uses this specific API, you can
construct the object by passing the apiVersion
option to the constructor:
var codecatalyst = new AWS.CodeCatalyst({apiVersion: '2022-09-28'});
You can also set the API version globally in AWS.config.apiVersions
using
the codecatalyst service identifier:
AWS.config.apiVersions = {
codecatalyst: '2022-09-28',
// other service API versions
};
var codecatalyst = new AWS.CodeCatalyst();
Constructor Summary collapse
-
new AWS.CodeCatalyst(options = {}) ⇒ Object
constructor
Constructs a service object.
Property Summary collapse
-
endpoint ⇒ AWS.Endpoint
readwrite
An Endpoint object representing the endpoint URL for service requests.
Properties inherited from AWS.Service
Method Summary collapse
-
createAccessToken(params = {}, callback) ⇒ AWS.Request
Creates a personal access token (PAT) for the current user.
-
createDevEnvironment(params = {}, callback) ⇒ AWS.Request
Creates a Dev Environment in Amazon CodeCatalyst, a cloud-based development environment that you can use to quickly work on the code stored in the source repositories of your project.
-
createProject(params = {}, callback) ⇒ AWS.Request
Creates a project in a specified space.
.
-
createSourceRepositoryBranch(params = {}, callback) ⇒ AWS.Request
Creates a branch in a specified source repository in Amazon CodeCatalyst.
-
deleteAccessToken(params = {}, callback) ⇒ AWS.Request
Deletes a specified personal access token (PAT).
-
deleteDevEnvironment(params = {}, callback) ⇒ AWS.Request
Deletes a Dev Environment.
-
getDevEnvironment(params = {}, callback) ⇒ AWS.Request
Returns information about a Dev Environment for a source repository in a project.
-
getProject(params = {}, callback) ⇒ AWS.Request
Returns information about a project.
.
-
getSourceRepositoryCloneUrls(params = {}, callback) ⇒ AWS.Request
Returns information about the URLs that can be used with a Git client to clone a source repository.
.
-
getSpace(params = {}, callback) ⇒ AWS.Request
Returns information about an space.
.
-
getSubscription(params = {}, callback) ⇒ AWS.Request
Returns information about the Amazon Web Services account used for billing purposes and the billing plan for the space.
.
-
getUserDetails(params = {}, callback) ⇒ AWS.Request
Returns information about a user.
-
listAccessTokens(params = {}, callback) ⇒ AWS.Request
Lists all personal access tokens (PATs) associated with the user who calls the API.
-
listDevEnvironments(params = {}, callback) ⇒ AWS.Request
Retrieves a list of Dev Environments in a project.
.
-
listDevEnvironmentSessions(params = {}, callback) ⇒ AWS.Request
Retrieves a list of active sessions for a Dev Environment in a project.
.
-
listEventLogs(params = {}, callback) ⇒ AWS.Request
Retrieves a list of events that occurred during a specified time period in a space.
-
listProjects(params = {}, callback) ⇒ AWS.Request
Retrieves a list of projects.
.
-
listSourceRepositories(params = {}, callback) ⇒ AWS.Request
Retrieves a list of source repositories in a project.
.
-
listSourceRepositoryBranches(params = {}, callback) ⇒ AWS.Request
Retrieves a list of branches in a specified source repository.
.
-
listSpaces(params = {}, callback) ⇒ AWS.Request
Retrieves a list of spaces.
.
-
startDevEnvironment(params = {}, callback) ⇒ AWS.Request
Starts a specified Dev Environment and puts it into an active state.
-
startDevEnvironmentSession(params = {}, callback) ⇒ AWS.Request
Starts a session for a specified Dev Environment.
.
-
stopDevEnvironment(params = {}, callback) ⇒ AWS.Request
Pauses a specified Dev Environment and places it in a non-running state.
-
stopDevEnvironmentSession(params = {}, callback) ⇒ AWS.Request
Stops a session for a specified Dev Environment.
.
-
updateDevEnvironment(params = {}, callback) ⇒ AWS.Request
Changes one or more values for a Dev Environment.
-
verifySession(params = {}, callback) ⇒ AWS.Request
Verifies whether the calling user has a valid Amazon CodeCatalyst login and session.
-
waitFor(state, params = {}, callback) ⇒ AWS.Request
Waits for a given CodeCatalyst resource.
Methods inherited from AWS.Service
makeRequest, makeUnauthenticatedRequest, setupRequestListeners, defineService
Constructor Details
new AWS.CodeCatalyst(options = {}) ⇒ Object
Constructs a service object. This object has one method for each API operation.
Property Details
Method Details
createAccessToken(params = {}, callback) ⇒ AWS.Request
Creates a personal access token (PAT) for the current user. A personal access token (PAT) is similar to a password. It is associated with your user identity for use across all spaces and projects in Amazon CodeCatalyst. You use PATs to access CodeCatalyst from resources that include integrated development environments (IDEs) and Git-based source repositories. PATs represent you in Amazon CodeCatalyst and you can manage them in your user settings.For more information, see Managing personal access tokens in Amazon CodeCatalyst.
createDevEnvironment(params = {}, callback) ⇒ AWS.Request
Creates a Dev Environment in Amazon CodeCatalyst, a cloud-based development environment that you can use to quickly work on the code stored in the source repositories of your project.
createSourceRepositoryBranch(params = {}, callback) ⇒ AWS.Request
Creates a branch in a specified source repository in Amazon CodeCatalyst.
deleteAccessToken(params = {}, callback) ⇒ AWS.Request
Deletes a specified personal access token (PAT). A personal access token can only be deleted by the user who created it.
getDevEnvironment(params = {}, callback) ⇒ AWS.Request
Returns information about a Dev Environment for a source repository in a project. Dev Environments are specific to the user who creates them.
getSourceRepositoryCloneUrls(params = {}, callback) ⇒ AWS.Request
Returns information about the URLs that can be used with a Git client to clone a source repository.
getSubscription(params = {}, callback) ⇒ AWS.Request
Returns information about the Amazon Web Services account used for billing purposes and the billing plan for the space.
listAccessTokens(params = {}, callback) ⇒ AWS.Request
Lists all personal access tokens (PATs) associated with the user who calls the API. You can only list PATs associated with your Amazon Web Services Builder ID.
listDevEnvironments(params = {}, callback) ⇒ AWS.Request
Retrieves a list of Dev Environments in a project.
listDevEnvironmentSessions(params = {}, callback) ⇒ AWS.Request
Retrieves a list of active sessions for a Dev Environment in a project.
listEventLogs(params = {}, callback) ⇒ AWS.Request
Retrieves a list of events that occurred during a specified time period in a space. You can use these events to audit user and system activity in a space.
listSourceRepositories(params = {}, callback) ⇒ AWS.Request
Retrieves a list of source repositories in a project.
listSourceRepositoryBranches(params = {}, callback) ⇒ AWS.Request
Retrieves a list of branches in a specified source repository.
startDevEnvironment(params = {}, callback) ⇒ AWS.Request
Starts a specified Dev Environment and puts it into an active state.
startDevEnvironmentSession(params = {}, callback) ⇒ AWS.Request
Starts a session for a specified Dev Environment.
stopDevEnvironment(params = {}, callback) ⇒ AWS.Request
Pauses a specified Dev Environment and places it in a non-running state. Stopped Dev Environments do not consume compute minutes.
stopDevEnvironmentSession(params = {}, callback) ⇒ AWS.Request
Stops a session for a specified Dev Environment.
updateDevEnvironment(params = {}, callback) ⇒ AWS.Request
Changes one or more values for a Dev Environment. Updating certain values of the Dev Environment will cause a restart.
verifySession(params = {}, callback) ⇒ AWS.Request
Verifies whether the calling user has a valid Amazon CodeCatalyst login and session. If successful, this returns the ID of the user in Amazon CodeCatalyst.
waitFor(state, params = {}, callback) ⇒ AWS.Request
Waits for a given CodeCatalyst resource. The final callback or 'complete' event will be fired only when the resource is either in its final state or the waiter has timed out and stopped polling for the final state.