@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public interface AWSAmplify
Note: Do not directly implement this interface, new methods are added to it regularly. Extend from
AbstractAWSAmplify
instead.
Amplify enables developers to develop and deploy cloud-powered mobile and web apps. Amplify Hosting provides a continuous delivery and hosting service for web applications. For more information, see the Amplify Hosting User Guide. The Amplify Framework is a comprehensive set of SDKs, libraries, tools, and documentation for client app development. For more information, see the Amplify Framework.
Modifier and Type | Field and Description |
---|---|
static String |
ENDPOINT_PREFIX
The region metadata service name for computing region endpoints.
|
Modifier and Type | Method and Description |
---|---|
CreateAppResult |
createApp(CreateAppRequest createAppRequest)
Creates a new Amplify app.
|
CreateBackendEnvironmentResult |
createBackendEnvironment(CreateBackendEnvironmentRequest createBackendEnvironmentRequest)
Creates a new backend environment for an Amplify app.
|
CreateBranchResult |
createBranch(CreateBranchRequest createBranchRequest)
Creates a new branch for an Amplify app.
|
CreateDeploymentResult |
createDeployment(CreateDeploymentRequest createDeploymentRequest)
Creates a deployment for a manually deployed Amplify app.
|
CreateDomainAssociationResult |
createDomainAssociation(CreateDomainAssociationRequest createDomainAssociationRequest)
Creates a new domain association for an Amplify app.
|
CreateWebhookResult |
createWebhook(CreateWebhookRequest createWebhookRequest)
Creates a new webhook on an Amplify app.
|
DeleteAppResult |
deleteApp(DeleteAppRequest deleteAppRequest)
Deletes an existing Amplify app specified by an app ID.
|
DeleteBackendEnvironmentResult |
deleteBackendEnvironment(DeleteBackendEnvironmentRequest deleteBackendEnvironmentRequest)
Deletes a backend environment for an Amplify app.
|
DeleteBranchResult |
deleteBranch(DeleteBranchRequest deleteBranchRequest)
Deletes a branch for an Amplify app.
|
DeleteDomainAssociationResult |
deleteDomainAssociation(DeleteDomainAssociationRequest deleteDomainAssociationRequest)
Deletes a domain association for an Amplify app.
|
DeleteJobResult |
deleteJob(DeleteJobRequest deleteJobRequest)
Deletes a job for a branch of an Amplify app.
|
DeleteWebhookResult |
deleteWebhook(DeleteWebhookRequest deleteWebhookRequest)
Deletes a webhook.
|
GenerateAccessLogsResult |
generateAccessLogs(GenerateAccessLogsRequest generateAccessLogsRequest)
Returns the website access logs for a specific time range using a presigned URL.
|
GetAppResult |
getApp(GetAppRequest getAppRequest)
Returns an existing Amplify app specified by an app ID.
|
GetArtifactUrlResult |
getArtifactUrl(GetArtifactUrlRequest getArtifactUrlRequest)
Returns the artifact info that corresponds to an artifact id.
|
GetBackendEnvironmentResult |
getBackendEnvironment(GetBackendEnvironmentRequest getBackendEnvironmentRequest)
Returns a backend environment for an Amplify app.
|
GetBranchResult |
getBranch(GetBranchRequest getBranchRequest)
Returns a branch for an Amplify app.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
GetDomainAssociationResult |
getDomainAssociation(GetDomainAssociationRequest getDomainAssociationRequest)
Returns the domain information for an Amplify app.
|
GetJobResult |
getJob(GetJobRequest getJobRequest)
Returns a job for a branch of an Amplify app.
|
GetWebhookResult |
getWebhook(GetWebhookRequest getWebhookRequest)
Returns the webhook information that corresponds to a specified webhook ID.
|
ListAppsResult |
listApps(ListAppsRequest listAppsRequest)
Returns a list of the existing Amplify apps.
|
ListArtifactsResult |
listArtifacts(ListArtifactsRequest listArtifactsRequest)
Returns a list of artifacts for a specified app, branch, and job.
|
ListBackendEnvironmentsResult |
listBackendEnvironments(ListBackendEnvironmentsRequest listBackendEnvironmentsRequest)
Lists the backend environments for an Amplify app.
|
ListBranchesResult |
listBranches(ListBranchesRequest listBranchesRequest)
Lists the branches of an Amplify app.
|
ListDomainAssociationsResult |
listDomainAssociations(ListDomainAssociationsRequest listDomainAssociationsRequest)
Returns the domain associations for an Amplify app.
|
ListJobsResult |
listJobs(ListJobsRequest listJobsRequest)
Lists the jobs for a branch of an Amplify app.
|
ListTagsForResourceResult |
listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Returns a list of tags for a specified Amazon Resource Name (ARN).
|
ListWebhooksResult |
listWebhooks(ListWebhooksRequest listWebhooksRequest)
Returns a list of webhooks for an Amplify app.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
StartDeploymentResult |
startDeployment(StartDeploymentRequest startDeploymentRequest)
Starts a deployment for a manually deployed app.
|
StartJobResult |
startJob(StartJobRequest startJobRequest)
Starts a new job for a branch of an Amplify app.
|
StopJobResult |
stopJob(StopJobRequest stopJobRequest)
Stops a job that is in progress for a branch of an Amplify app.
|
TagResourceResult |
tagResource(TagResourceRequest tagResourceRequest)
Tags the resource with a tag key and value.
|
UntagResourceResult |
untagResource(UntagResourceRequest untagResourceRequest)
Untags a resource with a specified Amazon Resource Name (ARN).
|
UpdateAppResult |
updateApp(UpdateAppRequest updateAppRequest)
Updates an existing Amplify app.
|
UpdateBranchResult |
updateBranch(UpdateBranchRequest updateBranchRequest)
Updates a branch for an Amplify app.
|
UpdateDomainAssociationResult |
updateDomainAssociation(UpdateDomainAssociationRequest updateDomainAssociationRequest)
Creates a new domain association for an Amplify app.
|
UpdateWebhookResult |
updateWebhook(UpdateWebhookRequest updateWebhookRequest)
Updates a webhook.
|
static final String ENDPOINT_PREFIX
CreateAppResult createApp(CreateAppRequest createAppRequest)
Creates a new Amplify app.
createAppRequest
- The request structure used to create apps in Amplify.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.LimitExceededException
- A resource could not be created because service quotas were exceeded.DependentServiceFailureException
- An operation failed because a dependent service threw an exception.CreateBackendEnvironmentResult createBackendEnvironment(CreateBackendEnvironmentRequest createBackendEnvironmentRequest)
Creates a new backend environment for an Amplify app.
This API is available only to Amplify Gen 1 applications where the backend is created using Amplify Studio or the Amplify command line interface (CLI). This API isn’t available to Amplify Gen 2 applications. When you deploy an application with Amplify Gen 2, you provision the app's backend infrastructure using Typescript code.
createBackendEnvironmentRequest
- The request structure for the backend environment create request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.NotFoundException
- An entity was not found during an operation.InternalFailureException
- The service failed to perform an operation due to an internal issue.LimitExceededException
- A resource could not be created because service quotas were exceeded.CreateBranchResult createBranch(CreateBranchRequest createBranchRequest)
Creates a new branch for an Amplify app.
createBranchRequest
- The request structure for the create branch request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.NotFoundException
- An entity was not found during an operation.InternalFailureException
- The service failed to perform an operation due to an internal issue.LimitExceededException
- A resource could not be created because service quotas were exceeded.DependentServiceFailureException
- An operation failed because a dependent service threw an exception.CreateDeploymentResult createDeployment(CreateDeploymentRequest createDeploymentRequest)
Creates a deployment for a manually deployed Amplify app. Manually deployed apps are not connected to a repository.
The maximum duration between the CreateDeployment
call and the StartDeployment
call
cannot exceed 8 hours. If the duration exceeds 8 hours, the StartDeployment
call and the associated
Job
will fail.
createDeploymentRequest
- The request structure for the create a new deployment request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.LimitExceededException
- A resource could not be created because service quotas were exceeded.CreateDomainAssociationResult createDomainAssociation(CreateDomainAssociationRequest createDomainAssociationRequest)
Creates a new domain association for an Amplify app. This action associates a custom domain with the Amplify app
createDomainAssociationRequest
- The request structure for the create domain association request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.NotFoundException
- An entity was not found during an operation.InternalFailureException
- The service failed to perform an operation due to an internal issue.LimitExceededException
- A resource could not be created because service quotas were exceeded.DependentServiceFailureException
- An operation failed because a dependent service threw an exception.CreateWebhookResult createWebhook(CreateWebhookRequest createWebhookRequest)
Creates a new webhook on an Amplify app.
createWebhookRequest
- The request structure for the create webhook request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.NotFoundException
- An entity was not found during an operation.InternalFailureException
- The service failed to perform an operation due to an internal issue.LimitExceededException
- A resource could not be created because service quotas were exceeded.DependentServiceFailureException
- An operation failed because a dependent service threw an exception.DeleteAppResult deleteApp(DeleteAppRequest deleteAppRequest)
Deletes an existing Amplify app specified by an app ID.
deleteAppRequest
- Describes the request structure for the delete app request.BadRequestException
- A request contains unexpected data.NotFoundException
- An entity was not found during an operation.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.DependentServiceFailureException
- An operation failed because a dependent service threw an exception.DeleteBackendEnvironmentResult deleteBackendEnvironment(DeleteBackendEnvironmentRequest deleteBackendEnvironmentRequest)
Deletes a backend environment for an Amplify app.
This API is available only to Amplify Gen 1 applications where the backend is created using Amplify Studio or the Amplify command line interface (CLI). This API isn’t available to Amplify Gen 2 applications. When you deploy an application with Amplify Gen 2, you provision the app's backend infrastructure using Typescript code.
deleteBackendEnvironmentRequest
- The request structure for the delete backend environment request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.NotFoundException
- An entity was not found during an operation.InternalFailureException
- The service failed to perform an operation due to an internal issue.DependentServiceFailureException
- An operation failed because a dependent service threw an exception.DeleteBranchResult deleteBranch(DeleteBranchRequest deleteBranchRequest)
Deletes a branch for an Amplify app.
deleteBranchRequest
- The request structure for the delete branch request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.NotFoundException
- An entity was not found during an operation.InternalFailureException
- The service failed to perform an operation due to an internal issue.DependentServiceFailureException
- An operation failed because a dependent service threw an exception.DeleteDomainAssociationResult deleteDomainAssociation(DeleteDomainAssociationRequest deleteDomainAssociationRequest)
Deletes a domain association for an Amplify app.
deleteDomainAssociationRequest
- The request structure for the delete domain association request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.NotFoundException
- An entity was not found during an operation.InternalFailureException
- The service failed to perform an operation due to an internal issue.DependentServiceFailureException
- An operation failed because a dependent service threw an exception.DeleteJobResult deleteJob(DeleteJobRequest deleteJobRequest)
Deletes a job for a branch of an Amplify app.
deleteJobRequest
- The request structure for the delete job request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.NotFoundException
- An entity was not found during an operation.LimitExceededException
- A resource could not be created because service quotas were exceeded.DeleteWebhookResult deleteWebhook(DeleteWebhookRequest deleteWebhookRequest)
Deletes a webhook.
deleteWebhookRequest
- The request structure for the delete webhook request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.NotFoundException
- An entity was not found during an operation.LimitExceededException
- A resource could not be created because service quotas were exceeded.GenerateAccessLogsResult generateAccessLogs(GenerateAccessLogsRequest generateAccessLogsRequest)
Returns the website access logs for a specific time range using a presigned URL.
generateAccessLogsRequest
- The request structure for the generate access logs request.NotFoundException
- An entity was not found during an operation.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.GetAppResult getApp(GetAppRequest getAppRequest)
Returns an existing Amplify app specified by an app ID.
getAppRequest
- The request structure for the get app request.BadRequestException
- A request contains unexpected data.NotFoundException
- An entity was not found during an operation.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.GetArtifactUrlResult getArtifactUrl(GetArtifactUrlRequest getArtifactUrlRequest)
Returns the artifact info that corresponds to an artifact id.
getArtifactUrlRequest
- Returns the request structure for the get artifact request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.NotFoundException
- An entity was not found during an operation.LimitExceededException
- A resource could not be created because service quotas were exceeded.GetBackendEnvironmentResult getBackendEnvironment(GetBackendEnvironmentRequest getBackendEnvironmentRequest)
Returns a backend environment for an Amplify app.
This API is available only to Amplify Gen 1 applications where the backend is created using Amplify Studio or the Amplify command line interface (CLI). This API isn’t available to Amplify Gen 2 applications. When you deploy an application with Amplify Gen 2, you provision the app's backend infrastructure using Typescript code.
getBackendEnvironmentRequest
- The request structure for the get backend environment request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.NotFoundException
- An entity was not found during an operation.InternalFailureException
- The service failed to perform an operation due to an internal issue.GetBranchResult getBranch(GetBranchRequest getBranchRequest)
Returns a branch for an Amplify app.
getBranchRequest
- The request structure for the get branch request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.NotFoundException
- An entity was not found during an operation.InternalFailureException
- The service failed to perform an operation due to an internal issue.GetDomainAssociationResult getDomainAssociation(GetDomainAssociationRequest getDomainAssociationRequest)
Returns the domain information for an Amplify app.
getDomainAssociationRequest
- The request structure for the get domain association request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.NotFoundException
- An entity was not found during an operation.InternalFailureException
- The service failed to perform an operation due to an internal issue.GetJobResult getJob(GetJobRequest getJobRequest)
Returns a job for a branch of an Amplify app.
getJobRequest
- The request structure for the get job request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.NotFoundException
- An entity was not found during an operation.LimitExceededException
- A resource could not be created because service quotas were exceeded.GetWebhookResult getWebhook(GetWebhookRequest getWebhookRequest)
Returns the webhook information that corresponds to a specified webhook ID.
getWebhookRequest
- The request structure for the get webhook request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.NotFoundException
- An entity was not found during an operation.LimitExceededException
- A resource could not be created because service quotas were exceeded.ListAppsResult listApps(ListAppsRequest listAppsRequest)
Returns a list of the existing Amplify apps.
listAppsRequest
- The request structure for the list apps request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.ListArtifactsResult listArtifacts(ListArtifactsRequest listArtifactsRequest)
Returns a list of artifacts for a specified app, branch, and job.
listArtifactsRequest
- Describes the request structure for the list artifacts request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.LimitExceededException
- A resource could not be created because service quotas were exceeded.ListBackendEnvironmentsResult listBackendEnvironments(ListBackendEnvironmentsRequest listBackendEnvironmentsRequest)
Lists the backend environments for an Amplify app.
This API is available only to Amplify Gen 1 applications where the backend is created using Amplify Studio or the Amplify command line interface (CLI). This API isn’t available to Amplify Gen 2 applications. When you deploy an application with Amplify Gen 2, you provision the app's backend infrastructure using Typescript code.
listBackendEnvironmentsRequest
- The request structure for the list backend environments request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.ListBranchesResult listBranches(ListBranchesRequest listBranchesRequest)
Lists the branches of an Amplify app.
listBranchesRequest
- The request structure for the list branches request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.ListDomainAssociationsResult listDomainAssociations(ListDomainAssociationsRequest listDomainAssociationsRequest)
Returns the domain associations for an Amplify app.
listDomainAssociationsRequest
- The request structure for the list domain associations request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.ListJobsResult listJobs(ListJobsRequest listJobsRequest)
Lists the jobs for a branch of an Amplify app.
listJobsRequest
- The request structure for the list jobs request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.LimitExceededException
- A resource could not be created because service quotas were exceeded.ListTagsForResourceResult listTagsForResource(ListTagsForResourceRequest listTagsForResourceRequest)
Returns a list of tags for a specified Amazon Resource Name (ARN).
listTagsForResourceRequest
- The request structure to use to list tags for a resource.InternalFailureException
- The service failed to perform an operation due to an internal issue.BadRequestException
- A request contains unexpected data.ResourceNotFoundException
- An operation failed due to a non-existent resource.ListWebhooksResult listWebhooks(ListWebhooksRequest listWebhooksRequest)
Returns a list of webhooks for an Amplify app.
listWebhooksRequest
- The request structure for the list webhooks request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.LimitExceededException
- A resource could not be created because service quotas were exceeded.StartDeploymentResult startDeployment(StartDeploymentRequest startDeploymentRequest)
Starts a deployment for a manually deployed app. Manually deployed apps are not connected to a repository.
The maximum duration between the CreateDeployment
call and the StartDeployment
call
cannot exceed 8 hours. If the duration exceeds 8 hours, the StartDeployment
call and the associated
Job
will fail.
startDeploymentRequest
- The request structure for the start a deployment request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.NotFoundException
- An entity was not found during an operation.LimitExceededException
- A resource could not be created because service quotas were exceeded.StartJobResult startJob(StartJobRequest startJobRequest)
Starts a new job for a branch of an Amplify app.
startJobRequest
- The request structure for the start job request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.NotFoundException
- An entity was not found during an operation.LimitExceededException
- A resource could not be created because service quotas were exceeded.StopJobResult stopJob(StopJobRequest stopJobRequest)
Stops a job that is in progress for a branch of an Amplify app.
stopJobRequest
- The request structure for the stop job request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.NotFoundException
- An entity was not found during an operation.LimitExceededException
- A resource could not be created because service quotas were exceeded.TagResourceResult tagResource(TagResourceRequest tagResourceRequest)
Tags the resource with a tag key and value.
tagResourceRequest
- The request structure to tag a resource with a tag key and value.InternalFailureException
- The service failed to perform an operation due to an internal issue.BadRequestException
- A request contains unexpected data.ResourceNotFoundException
- An operation failed due to a non-existent resource.UntagResourceResult untagResource(UntagResourceRequest untagResourceRequest)
Untags a resource with a specified Amazon Resource Name (ARN).
untagResourceRequest
- The request structure for the untag resource request.InternalFailureException
- The service failed to perform an operation due to an internal issue.BadRequestException
- A request contains unexpected data.ResourceNotFoundException
- An operation failed due to a non-existent resource.UpdateAppResult updateApp(UpdateAppRequest updateAppRequest)
Updates an existing Amplify app.
updateAppRequest
- The request structure for the update app request.BadRequestException
- A request contains unexpected data.NotFoundException
- An entity was not found during an operation.UnauthorizedException
- An operation failed due to a lack of access.InternalFailureException
- The service failed to perform an operation due to an internal issue.UpdateBranchResult updateBranch(UpdateBranchRequest updateBranchRequest)
Updates a branch for an Amplify app.
updateBranchRequest
- The request structure for the update branch request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.NotFoundException
- An entity was not found during an operation.InternalFailureException
- The service failed to perform an operation due to an internal issue.DependentServiceFailureException
- An operation failed because a dependent service threw an exception.UpdateDomainAssociationResult updateDomainAssociation(UpdateDomainAssociationRequest updateDomainAssociationRequest)
Creates a new domain association for an Amplify app.
updateDomainAssociationRequest
- The request structure for the update domain association request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.NotFoundException
- An entity was not found during an operation.InternalFailureException
- The service failed to perform an operation due to an internal issue.DependentServiceFailureException
- An operation failed because a dependent service threw an exception.UpdateWebhookResult updateWebhook(UpdateWebhookRequest updateWebhookRequest)
Updates a webhook.
updateWebhookRequest
- The request structure for the update webhook request.BadRequestException
- A request contains unexpected data.UnauthorizedException
- An operation failed due to a lack of access.NotFoundException
- An entity was not found during an operation.InternalFailureException
- The service failed to perform an operation due to an internal issue.DependentServiceFailureException
- An operation failed because a dependent service threw an exception.void shutdown()
ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
request
- The originally executed request.