Class CreateAppRequest

    • Method Detail

      • name

        public final String name()

        The name of the Amplify app.

        Returns:
        The name of the Amplify app.
      • description

        public final String description()

        The description of the Amplify app.

        Returns:
        The description of the Amplify app.
      • repository

        public final String repository()

        The Git repository for the Amplify app.

        Returns:
        The Git repository for the Amplify app.
      • platform

        public final Platform platform()

        The platform for the Amplify app. For a static app, set the platform type to WEB. For a dynamic server-side rendered (SSR) app, set the platform type to WEB_COMPUTE. For an app requiring Amplify Hosting's original SSR support only, set the platform type to WEB_DYNAMIC.

        If the service returns an enum value that is not available in the current SDK version, platform will return Platform.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from platformAsString().

        Returns:
        The platform for the Amplify app. For a static app, set the platform type to WEB. For a dynamic server-side rendered (SSR) app, set the platform type to WEB_COMPUTE. For an app requiring Amplify Hosting's original SSR support only, set the platform type to WEB_DYNAMIC.
        See Also:
        Platform
      • platformAsString

        public final String platformAsString()

        The platform for the Amplify app. For a static app, set the platform type to WEB. For a dynamic server-side rendered (SSR) app, set the platform type to WEB_COMPUTE. For an app requiring Amplify Hosting's original SSR support only, set the platform type to WEB_DYNAMIC.

        If the service returns an enum value that is not available in the current SDK version, platform will return Platform.UNKNOWN_TO_SDK_VERSION. The raw value returned by the service is available from platformAsString().

        Returns:
        The platform for the Amplify app. For a static app, set the platform type to WEB. For a dynamic server-side rendered (SSR) app, set the platform type to WEB_COMPUTE. For an app requiring Amplify Hosting's original SSR support only, set the platform type to WEB_DYNAMIC.
        See Also:
        Platform
      • iamServiceRoleArn

        public final String iamServiceRoleArn()

        The AWS Identity and Access Management (IAM) service role for an Amplify app.

        Returns:
        The AWS Identity and Access Management (IAM) service role for an Amplify app.
      • oauthToken

        public final String oauthToken()

        The OAuth token for a third-party source control system for an Amplify app. The OAuth token is used to create a webhook and a read-only deploy key using SSH cloning. The OAuth token is not stored.

        Use oauthToken for repository providers other than GitHub, such as Bitbucket or CodeCommit. To authorize access to GitHub as your repository provider, use accessToken.

        You must specify either oauthToken or accessToken when you create a new app.

        Existing Amplify apps deployed from a GitHub repository using OAuth continue to work with CI/CD. However, we strongly recommend that you migrate these apps to use the GitHub App. For more information, see Migrating an existing OAuth app to the Amplify GitHub App in the Amplify User Guide .

        Returns:
        The OAuth token for a third-party source control system for an Amplify app. The OAuth token is used to create a webhook and a read-only deploy key using SSH cloning. The OAuth token is not stored.

        Use oauthToken for repository providers other than GitHub, such as Bitbucket or CodeCommit. To authorize access to GitHub as your repository provider, use accessToken.

        You must specify either oauthToken or accessToken when you create a new app.

        Existing Amplify apps deployed from a GitHub repository using OAuth continue to work with CI/CD. However, we strongly recommend that you migrate these apps to use the GitHub App. For more information, see Migrating an existing OAuth app to the Amplify GitHub App in the Amplify User Guide .

      • accessToken

        public final String accessToken()

        The personal access token for a GitHub repository for an Amplify app. The personal access token is used to authorize access to a GitHub repository using the Amplify GitHub App. The token is not stored.

        Use accessToken for GitHub repositories only. To authorize access to a repository provider such as Bitbucket or CodeCommit, use oauthToken.

        You must specify either accessToken or oauthToken when you create a new app.

        Existing Amplify apps deployed from a GitHub repository using OAuth continue to work with CI/CD. However, we strongly recommend that you migrate these apps to use the GitHub App. For more information, see Migrating an existing OAuth app to the Amplify GitHub App in the Amplify User Guide .

        Returns:
        The personal access token for a GitHub repository for an Amplify app. The personal access token is used to authorize access to a GitHub repository using the Amplify GitHub App. The token is not stored.

        Use accessToken for GitHub repositories only. To authorize access to a repository provider such as Bitbucket or CodeCommit, use oauthToken.

        You must specify either accessToken or oauthToken when you create a new app.

        Existing Amplify apps deployed from a GitHub repository using OAuth continue to work with CI/CD. However, we strongly recommend that you migrate these apps to use the GitHub App. For more information, see Migrating an existing OAuth app to the Amplify GitHub App in the Amplify User Guide .

      • hasEnvironmentVariables

        public final boolean hasEnvironmentVariables()
        For responses, this returns true if the service returned a value for the EnvironmentVariables property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
      • environmentVariables

        public final Map<String,​String> environmentVariables()

        The environment variables map for an Amplify app.

        For a list of the environment variables that are accessible to Amplify by default, see Amplify Environment variables in the Amplify Hosting User Guide.

        Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

        This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasEnvironmentVariables() method.

        Returns:
        The environment variables map for an Amplify app.

        For a list of the environment variables that are accessible to Amplify by default, see Amplify Environment variables in the Amplify Hosting User Guide.

      • enableBranchAutoBuild

        public final Boolean enableBranchAutoBuild()

        Enables the auto building of branches for an Amplify app.

        Returns:
        Enables the auto building of branches for an Amplify app.
      • enableBranchAutoDeletion

        public final Boolean enableBranchAutoDeletion()

        Automatically disconnects a branch in the Amplify console when you delete a branch from your Git repository.

        Returns:
        Automatically disconnects a branch in the Amplify console when you delete a branch from your Git repository.
      • enableBasicAuth

        public final Boolean enableBasicAuth()

        Enables basic authorization for an Amplify app. This will apply to all branches that are part of this app.

        Returns:
        Enables basic authorization for an Amplify app. This will apply to all branches that are part of this app.
      • basicAuthCredentials

        public final String basicAuthCredentials()

        The credentials for basic authorization for an Amplify app. You must base64-encode the authorization credentials and provide them in the format user:password.

        Returns:
        The credentials for basic authorization for an Amplify app. You must base64-encode the authorization credentials and provide them in the format user:password.
      • hasCustomRules

        public final boolean hasCustomRules()
        For responses, this returns true if the service returned a value for the CustomRules property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
      • customRules

        public final List<CustomRule> customRules()

        The custom rewrite and redirect rules for an Amplify app.

        Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

        This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasCustomRules() method.

        Returns:
        The custom rewrite and redirect rules for an Amplify app.
      • hasTags

        public final boolean hasTags()
        For responses, this returns true if the service returned a value for the Tags property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
      • tags

        public final Map<String,​String> tags()

        The tag for an Amplify app.

        Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

        This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasTags() method.

        Returns:
        The tag for an Amplify app.
      • buildSpec

        public final String buildSpec()

        The build specification (build spec) for an Amplify app.

        Returns:
        The build specification (build spec) for an Amplify app.
      • customHeaders

        public final String customHeaders()

        The custom HTTP headers for an Amplify app.

        Returns:
        The custom HTTP headers for an Amplify app.
      • enableAutoBranchCreation

        public final Boolean enableAutoBranchCreation()

        Enables automated branch creation for an Amplify app.

        Returns:
        Enables automated branch creation for an Amplify app.
      • hasAutoBranchCreationPatterns

        public final boolean hasAutoBranchCreationPatterns()
        For responses, this returns true if the service returned a value for the AutoBranchCreationPatterns property. This DOES NOT check that the value is non-empty (for which, you should check the isEmpty() method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified.
      • autoBranchCreationPatterns

        public final List<String> autoBranchCreationPatterns()

        The automated branch creation glob patterns for an Amplify app.

        Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.

        This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the hasAutoBranchCreationPatterns() method.

        Returns:
        The automated branch creation glob patterns for an Amplify app.
      • autoBranchCreationConfig

        public final AutoBranchCreationConfig autoBranchCreationConfig()

        The automated branch creation configuration for an Amplify app.

        Returns:
        The automated branch creation configuration for an Amplify app.
      • toString

        public final String toString()
        Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
        Overrides:
        toString in class Object